Obtaining information about the DFSMShsm address space

You can use the DFSMShsm QUERY command to display the status of DFSMShsm parameters, statistics, and pending requests. The output of the QUERY command is messages returned to your terminal and written in the DFSMShsm log.

To obtain a list of parameters that apply to aggregate backup and recovery, issue the following command:

QUERY ABARS

To obtain a list about what functions are running in DFSMShsm, issue the following command:

QUERY ACTIVE

This list includes the following types of information:

The status of the data set backup function
The status of variables that affect the placement and selection of requests on the common recall queue
The processing status of FRBACKUP and FRRECOV COPYPOOL commands

To obtain the Task Control Block addresses of active DFSMShsm data movement tasks, issue the following command:

QUERY ACTIVE(TCBADDRESS)

TCBADDRESS is an optional subparameter of ACTIVE requesting only messages directly related to data movement activities be listed, along with extra information allowing cancellation of the active task. For ABARS the Secondary Address Space Index is returned when QUERY ACTIVE(TCBADDRESS) is issued.

To obtain a list of volumes that are defined for aggregate recovery, issue the following command:

QUERY ARPOOL

To display the progress of DFSMShsm automatic functions, issue the following command:

QUERY AUTOPROGRESS

To obtain a list of backup and dump parameters, including new data set backup parameters, issue the following command:

QUERY BACKUP

To obtain a list of all backup and dump parameters and all backup volumes, issue the following command:

QUERY BACKUP(ALL)

To obtain a list of all backup parameters and all daily backup volumes, issue the following command:

QUERY BACKUP(DAILY)

To obtain a list of all backup parameters and daily backup volumes assigned to a particular day in the backup cycle, issue the following command:

QUERY BACKUP(DAILY(day))

To obtain a list of all spill parameters and all spill backup volumes, issue the following command:

QUERY BACKUP(SPILL)

To obtain a list of backup parameters and all unassigned backup volumes, issue the following command:

QUERY BACKUP(UNASSIGNED)

To obtain a list of parameters from the SETSYS command that are governing the backup of the control data sets, issue the following command:

QUERY CDSVERSIONBACKUP

To determine how full the DFSMShsm coupling facility structures are, issue the following command:

QUERY COMMONQUEUE

To determine all outstanding recall requests in the CRQ, issue the following command:

QUERY COMMONQUEUE(RECALL)

To display space-allocated-and-used statistics for the control data sets, issue the following command:

QUERY CONTROLDATASETS

To determine if any of the volumes defined to a copy pool are in an active FlashCopy® relationship, issue the following command:

QUERY COPYPOOL(cpname)

For FlashCopy version 2, the source volume may be in more than one relationship. This command can also be used to determine if another backup version can be created when using FlashCopy version 1, or if a recover can be performed. This command works only on FlashCopy relationships.

To display the common service area limits that were specified with the SETSYS command, issue the following command:

QUERY CSALIMITS

To display a list of requests associated with a specific data set, issue the following command:

QUERY DATASETNAME(dsname)

Note: This command returns information only for those requests that were initiated by the host on which the QUERY DATASETNAME command is issued.

To display information for active DFSMShsm address spaces in a single z/OS® image, issue the following command:

QUERY IMAGE

To display the key ranges and the associated ML2 volumes, issue the following command:

QUERY MIGRATIONLEVEL2

Note: This command also displays the volume serial numbers of the tape ML2 volumes that are currently selected as the target volumes for data set and volume migration and secondary space management.

To display a list of the recall pools, issue the following command:

QUERY POOL

To display a list of requests associated with a specific request number, issue the following command:

QUERY REQUEST(reqnum)

Note: This command returns information only for those requests that were initiated by the host on which the QUERY REQUEST command is issued.

To display a list of data set levels that are prevented from migrating by the SETMIG command, issue the following command:

QUERY RETAIN

To display the parameters that you set with the SETSYS command, issue the following command.

QUERY SETSYS

To display the space statistics on specified primary and ML1 volumes, issue the following command:

QUERY SPACE(volser1,volser2,...,volsern)

Note: The QUERY SPACE command is not valid for SMS-managed volumes.

To display the parameters you specified in the PROC statement of the DFSMShsm startup procedure, issue the following command:

QUERY STARTUP

To display selected DFSMShsm statistics that have accumulated during the day, issue the following command:

QUERY STATISTICS

To display the TRAP requests you have established, issue the following command:

QUERY TRAPS

To display a list of requests associated with a specific user ID, issue the following command:

QUERY USER(userid)

Note: This command returns information only for those requests that were initiated by the host on which the QUERY USER command is issued.

To display the current volume pools, issue the following command:

QUERY VOLUMEPOOL

To display requests for DFSMShsm services that are waiting to be processed, including information on the number of requests waiting in the common recall queue, issue the following command:

QUERY WAITING

Note: This command returns information only for those requests that were initiated by the host on which the QUERY WAITING command is issued.