IBM Tivoli Storage Manager, Version 7.1

QUERY NODEDATA (Query client data in volumes)

Use this command to display information about the data for one or more nodes in a sequential access storage pool. QUERY NODEDATA displays the name of the volume on which a node's data is written and the amount of space that is occupied by the data on that volume. This information is useful when you determine how to group nodes into collocated storage pools.

Privilege class

Any administrator can issue this command.

Syntax


                     .-,---------.                    
                     V           |                    
>>-Query NODEData--+---node_name-+----------------+------------->
                   '-COLLOCGroup--=--colloc_group-'   

>--+-----------------------+--+---------------------+----------><
   '-STGpool--=--pool_name-'  '-VOLume--=--vol_name-'

Parameters

node_name: Specifies the name of the client node for which you want to locate data. You can specify one or more names. If you specify multiple names, separate the names with commas; do not use intervening spaces. You can also use wildcard characters when you specify multiple names. You must specify either a node name or collocation group name, but not both.
COLLOCGroup: Specifies the name of the collocation group for which you want to locate data. You must specify either a node name or collocation group name, but not both.
Important: If the amount of space that is needed to complete the query about a collocation group exceeds the SQL buffer limit, the QUERY NODEDATA command can fail. If the command fails for this reason, issue the QUERY COLLOCGROUP command to display a list of nodes in the group. Then, issue the QUERY NODEDATA command for each node in the group.
STGpool: Specifies the name of the sequential storage pool to query. This parameter is optional. You can use wildcard characters to specify the names. If a wildcard matches the name of a disk storage pool, the name of the disk storage pool is ignored. If you do not specify a value for this parameter, all sequential storage pools are queried.
VOLume: Specifies the volume that contains the data. This parameter is optional. You can use wildcard characters to specify multiple names. If you do not specify a value for this parameter, all volumes in the storage pool are queried.

Use wildcards to display node data for a sequential access storage pool

Display information about where node data is stored in a sequential storage pool. Use a wildcard character to indicate node names. See Field descriptions for field descriptions.

query nodedata e*

   Node Name   Volume Name                      Storage Pool  Physical
                                                Name          Space
                                                              Occupied
                                                              (MB)
   ---------   ------------------------------   ------------  --------
   EDU_J2      E:\tsm\server\00000117.BFS       EDU512        0.01
   EDU_J2      E:\tsm\server\00000122.BFS       EDU319        0.01
   EDU_J3      E:\tsm\server\00000116.BFS       EDU512        0.01
   EDU_J3      E:\tsm\server\00000120.BFS       EDU319        0.01
   EDU_J7      E:\tsm\server\00000118.BFS       EDU512        0.04
   EDU_J7      E:\tsm\server\00000123.BFS       EDU319        0.04
   EDU_JJ1     E:\tsm\server\00000116.BFS       EDU512        0.01
   EDU_JJ1     E:\tsm\server\00000121.BFS       EDU512        0.01

Display node data information for a specific collocation group

Display information about the location of node data in a sequential storage pool for a particular collocation group. In this example, nodes EDU_J3 and EDU_JJ1 are the only members that belong to collocation group, grp1, and have data in a sequential access storage pool.

query nodedata collocgroup=grp1

   Node Name   Volume Name                      Storage Pool  Physical
                                                Name          Space
                                                              Occupied
                                                              (MB)
   ---------   ------------------------------   ------------  --------
   EDU_J3      E:\tsm\server\00000116.BFS       EDU512        0.01
   EDU_J3      E:\tsm\server\00000120.BFS       EDU319        0.01
   EDU_JJ1     E:\tsm\server\00000116.BFS       EDU512        0.01
   EDU_JJ1     E:\tsm\server\00000121.BFS       EDU512        0.01

If you specify a file space collocation group, only the volumes of the file spaces that belong to the collocation group are displayed. If you specify a file space collocation group and a volume, the file space volumes within the collocation group that are also in the specified volume are displayed.

Field descriptions

Node Name: Specifies the name of the node.
Volume Name: Specifies the name of the volume that contains the node data.
Storage Pool Name: Specifies the name of the storage pool in which the volume is located.
Physical Space Occupied (MB): Specifies the amount of physical space that is occupied by the node's data. Physical space includes empty space within aggregates, from which files might be deleted or expired.

Related commands

Table 1. Commands related to QUERY NODEDATA
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 COLLOCGROUP	Displays information about collocation groups.
QUERY NODE	Displays partial or complete information about one or more clients.
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