IBM Tivoli Storage Manager, Version 7.1

QUERY COLLOCGROUP (Query a collocation group)

Use this command to display the collocation groups defined on the server.

Privilege class

Any administrator can issue this command.

Syntax


                      .-*----------.   
>>-Query COLLOCGroup--+------------+---------------------------->
                      '-group_name-'   

   .-Format--=--Standard-----.   
>--+-------------------------+---------------------------------><
   '-Format--=--+-Standard-+-'   
                '-Detailed-'

Parameters

group_name

Specifies the name of the collocation group to display. To specify multiple names, use a wildcard character. This parameter is optional. The default is to display all collocation groups.

Format

Specifies how the information is displayed. This parameter is optional. The default value is STANDARD. Possible values are:

Standard: Specifies that partial information is displayed.
Detailed: Specifies that complete information is displayed. To display the members of the collocation group, you must specify FORMAT=DETAILED.

Display defined collocation groups

Display the collocation groups defined on the server. Issue the following command:

query collocgroup

Collocation Group Name         Collocation Group Description
--------------------------     ------------------------------
DEPT_ED                        Education department
GROUP1                         Low cap client nodes.

See Field descriptions for field descriptions.

Display detailed information for collocation groups

Display complete information about all collocation groups and determine which client nodes belong to which collocation groups. Issue the following command:

query collocgroup format=detailed

        Collocation Group Name: DEPT_ED
 Collocation Group Description: Education department
Last Update by (administrator): SERVER_CONSOLE
         Last Update Date/Time: 04/21/2013 10:59:03
   Collocation Group Member(s): EDU_1 EDU_7
           Filespace Member(s): 
        
        Collocation Group Name: GROUP1
 Collocation Group Description: Low cap client nodes.
Last Update by (administrator): SERVER_CONSOLE
         Last Update Date/Time: 04/21/2013 10:59:16
   Collocation Group Member(s): CHESTER
           Filespace Member(s): alpha

        Collocation Group Name: GROUP1
 Collocation Group Description: Low cap client nodes.
Last Update by (administrator): SERVER_CONSOLE
         Last Update Date/Time: 04/21/2013 10:59:16
   Collocation Group Member(s): CHESTER
           Filespace Member(s): beta

        Collocation Group Name: GROUP1
 Collocation Group Description: Low cap client nodes.
Last Update by (administrator): SERVER_CONSOLE
         Last Update Date/Time: 04/21/2013 10:59:16
   Collocation Group Member(s): CHESTER
           Filespace Member(s): gamma

See Field descriptions for field descriptions.

Field descriptions

Collocation Group Name: The name of the collocation group.
Collocation Group Description: The description for the collocation group.
Last Update by (administrator): The name of the administrator that defined or most recently updated the collocation group.
Last Update Date/Time: The date and time that an administrator defined or most recently updated the collocation group.
Collocation Group Member(s): The members of the collocation group.
Filespace Member(s): The file space or file spaces that are members of the collocation group. If there is more than one file space, each file space is displayed in a separate entry.

Related commands

Table 1. Commands related to QUERY COLLOCGROUP
Command	Description
DEFINE COLLOCGROUP	Defines a collocation group.
DEFINE COLLOCMEMBER	Adds a client node or file space to a collocation group.
DEFINE STGPOOL	Defines a storage pool as a named collection of server storage media.
DELETE COLLOCGROUP	Deletes a collocation group.
DELETE COLLOCMEMBER	Deletes a client node or file space from a collocation group.
MOVE NODEDATA	Moves data for one or more nodes, or a single node with selected file spaces.
QUERY NODE	Displays partial or complete information about one or more clients.
QUERY NODEDATA	Displays information about the location and size of data for a client node.
QUERY STGPOOL	Displays information about storage pools.
REMOVE NODE	Removes a client from the list of registered nodes for a specific policy domain.
UPDATE COLLOCGROUP	Updates the description of a collocation group.
UPDATE STGPOOL	Changes the attributes of a storage pool.

Feedback