This groupClientsbyAttributes utility enables you to organize clients within a host group, based on client attributes. This utility will create host groups named for each attribute value, underneath a parent host group, as shown in the following example.

Create a host group named Geography. This will be the destination group that will be used to organize the clients by location.

Then, create an attribute named Geography.

For a subset of a host group’s clients, set their Geography attribute value to London and for another subset of clients, set their Geography attribute to New York.

Use the following groupClientsbyAttributes utility to organize the clients that have a Geography attribute configured.

execute server_mgmt_pkg.groupClientsbyAttributes(300000, 302398, 1, StringObjectListType(stringObjectType('Geography')));

Where 300000 is the group ID of the root group, Global; 302398 is the ID of the Geography group you just created.

 

Additional References:

See Identifying a Host Group ID.

Where:

source_Group_ID is the numeric identifier of the host group for which you want to group the clients. See Identifying a Host Group ID for the steps for finding a group ID.

destination_group_ID is the numeric identifier of the group under which you want to group the clients.

cascade_Source_Group is a numeric flag that indicates if you want this utility to process the source host group’s sub-groups and organize those clients in the destination group.

attribute_List is a comma-separated list of attribute names, each enclosed in straight single quotes. These names are used to create the sub-groups that organize the clients underneath the source group.