This utility enables you to automatically organize clients by the IBM Tivoli Storage Manager 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.

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 Tivoli Storage Manager 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.