Automating Host Group Management > IBM Spectrum Protect (TSM) Utilities
  
Version 10.2.01P10
IBM Spectrum Protect (TSM) Utilities
The utilities contained in this section apply only to IBM Spectrum Protect (TSM) environments and clients that have been backed up by IBM Spectrum Protect (TSM).
Set Up Clients by Policy Domain
Set Up Clients by IBM Spectrum Protect (TSM) Instance
Set Up Clients by Policy Domain
Description
This utility enables you to automatically organize clients by the IBM Spectrum Protect (TSM) policy domain(s) to which they belong. The utility automatically creates host groups for each policy domain and links clients that are members of these Policy domain(s) to the host group(s) accordingly.
Usage
execute tsm_common_pkg.TSMsetupClientsByPolicyDomain ( '<source_host_group>', '<destination_host_group>');
Example: exec tsm_common_pkg.TSMsetupClientsByPolicyDomain('/Global', NULL);
Where:
source_host_group is the full pathname to the server group hierarchy to traverse for clients, for example /Aptare/hostgroup1. The default value for this parameter is NULL (which should not be within quotes). If set to NULL, the utility automatically locates the highest level host group to traverse.
destination_host_group is the full pathname to the host group under which the new groups by policy domain name will be automatically created. The default value for this parameter is NULL (which should not be within quotes). If set to NULL the utility automatically creates a host group called Policy Domains within source_host_group.
 
If a client is removed from a IBM Spectrum Protect (TSM) policy domain, added to a new policy domain and the utility is subsequently run again, the client will appear in the new policy group but will not be deleted from the old policy group. To remove the client from the old policy group and completely re-synchronize the grouping structure, simply delete the Policy domain grouping hierarchy via the deleteEntireGroupContents utility, referenced in Delete Host Group, and then run the TSMsetupClientsByPolicyDomain utility again.
Set Up Clients by IBM Spectrum Protect (TSM) Instance
Description
This utility enables you to automatically organize clients by the IBM Spectrum Protect (TSM) instance to which they belong. The utility automatically create host groups for each instance, then links clients that are members of the instance into the host group(s) accordingly.
Usage
execute tsm_common_pkg.TSMsetupClientsByInstance ('<source_host_group>', '<destination_host_group>', <move_or_copy_flag>);
Example: exec tsm_common_pkg.TSMsetupClientsByInstance('/Global', NULL, 1);
Where
source_host_group is the full pathname to the host group hierarchy to traverse for clients, for example /Aptare/hostgroup1. The default value for this parameter is NULL (which should not be within quotes). If set to NULL, the utility automatically locates the highest level host group to traverse.
destination_host_group is the full pathname to the host group under which new groups by instance name will be automatically created. The default value for this parameter is NULL (which should not be within quotes). If set to NULL the utility automatically creates a host group called IBM Spectrum Protect (TSM) instances within source_host_group.
move_or_copy_flag can be set to 0=Link (copy) clients or 1=Move clients. If set to 0, the utility links the clients to their respective host groups and keeps the clients in their original host group location. If set to 1, the utility moves all clients from the source host group and to their respective host groups.