Query Group

Use the query group command to display information about a group backup and its members.

Note:
  1. Use the showmembers option to display and select individual group members that you want to query. The showmembers option is not valid with the inactive option. If you want to display members of a group that are not currently active, use the pitdate and pittime options to specify the backup date and time of the member you want to query.
  2. AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsWindows operating systemsUse the query filespace command to display virtual file space names for your node that are stored on the Tivoli® Storage Manager server.
  3. If you perform a full and differential group backup, a query of this group using the -inactive option displays two active backups of the same name, one of type FULL and one of type DIFF.

    Windows operating systemsThese backups inactivate any previous full and differential backups:

    Windows operating systems
    tsm> q group {\fs}\v1 -inactive

Size Backup Date          Mgmt Class A/I Group
—––– –––––––––––          –––––––––– ––– ––––––
 978 B 06/02/2007 11:57:04  DEFAULT   A  FULL \fs\v1
  32 B 06/05/2007 13:52:04  DEFAULT   A  DIFF \fs\v1
    AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systems
    tsm> q group {/fs}/v1 -inactive

Size Backup Date          Mgmt Class A/I Group
—––– –––––––––––          –––––––––– ––– ––––––
 978 B 06/02/2007 11:57:04  DEFAULT   A  FULL /fs/v1
  32 B 06/05/2007 13:52:04  DEFAULT   A  DIFF /fs/v1

    If you query a group backup without the -inactive option, the query displays only the latest group backup, whether it is type FULL or type DIFF:

    Windows operating systems
    tsm> q group {\fs}\v1

Size Backup Date          Mgmt Class A/I Group
—––– –––––––––––          –––––––––– ––– ––––––
  32 B 06/05/2007 13:52:04  DEFAULT   A  DIFF \fs\v1
    AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systems
    tsm> q group {/fs}/v1

Size Backup Date          Mgmt Class A/I Group
—––– –––––––––––          –––––––––– ––– ––––––
  32 B 06/05/2007 13:52:04  DEFAULT   A  DIFF /fs/v1
Mac OS X operating systemsAIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsWindows operating systems

Supported Clients

Mac OS X operating systemsAIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsThis option is valid for all clients, except for Mac OS X.

Windows operating systemsThis option is valid for all clients.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-Query GRoup-- --filespec--+------------+--------------------><
                             '- --options-'   

Parameters

Windows operating systemsfilespec
Windows operating systemsSpecifies the virtual file space name (enclosed in braces) and the group name on the server that you want to query.
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsfilespec
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsSpecifies the virtual file space name and the group name on the server that you want to query.
Table 1. Query Group command: Related options
Option Where to use
fromnode Command line only.
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsfromowner AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsCommand line only.
inactive Command line only.
pitdate Command line only.
pittime Command line only.
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsWindows operating systemsshowmembers (does not apply to Mac OS X) AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsWindows operating systemsCommand line only.

Examples

AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsTask
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsDisplay all the groups in the /virtfs file space.
Command: 
query group /virtfs/*
Windows operating systemsTask
Windows operating systemsDisplay all the groups in the virtfs file space.
Command: 
query group {virtfs}\*
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsTask
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsDisplay active and inactive versions of the /virtfs/group1 file space.
Command: 
query group /virtfs/group1 -inactive
Windows operating systemsTask
Windows operating systemsDisplay active and inactive versions of the virtfs\group1 file space.
Command: 
query group {virtfs}\group1 -inactive
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsTask
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsDisplay the /virtfs/group1 file space. Use the showmembers option to display a list of group members from which you can select one or more to query.
Command: 
query group /virtfs/group1 -showmembers
Windows operating systemsTask
Windows operating systemsDisplay the virtfs\group1 file space. Use the showmembers option to display a list of group members from which you can select one or more to query.
Command: 
query group {virtfs}\group1 -showmembers