Script (MQSC) Command Reference: DISPLAY USAGE

DISPLAY USAGE

Use DISPLAY USAGE to display information about the current state of a page set, or to display information about the log data sets.
Synonym: DIS USAGE
DISPLAY USAGE
 
                  .-CMDSCOPE(' ')------------.
>>-DISPLAY USAGE--+--------------------------+------------------>
                  |                     (1)  |
                  +-CMDSCOPE(qmgr-name)------+
                  |             (1)          |
                  '-CMDSCOPE(*)--------------'
 
   .-PSID(*)-------.  .-TYPE(PAGESET)-.
>--+---------------+--+---------------+------------------------><
   '-PSID(integer)-'  +-TYPE(DATASET)-+
                      '-TYPE(ALL)-----'
 
 
Notes:

Valid only on full function WebSphere MQ for z/OS when the queue manager is a member of a queue-sharing group.

Parameter descriptions

CMDSCOPE

This parameter specifies how the command is executed when the queue manager is a member of a queue-sharing group.
CMDSCOPE cannot be used for commands issued from the first initialization input data set CSQINP1.

' '

The command is executed on the queue manager on which it was entered. This is the default value.

qmgr-name

The command is executed on the queue manager you specify, providing the queue manager is active within the queue-sharing group.
You can specify a queue manager name, other than the queue manager on which the command was entered, only if you are using a queue-sharing group environment and if the command server is enabled.

*

The command is executed on the local queue manager and is also passed to every active queue manager in the queue-sharing group. The effect of this is the same as entering the command on every queue manager in the queue-sharing group.

PSID(integer)

The page-set identifier that a storage class maps to. This is optional.
This is a number, in the range 00 through 99. An asterisk (*) on its own specifies all page set identifiers.
The command fails if PSID has been specified together with TYPE(DATASET).

TYPE

Defines the type of information to be displayed. Values are:

PAGESET
Display page set and buffer pool information. This is the default.

DATASET
Display data set information for log data sets. This returns messages containing 44-character data set names for the following:

The log data set containing the BEGIN_UR record for the oldest incomplete unit of work for this queue manager, or if there are no incomplete units of work, the log data set containing the current highest written RBA.
The log data set containing the oldest restart_RBA of any pageset owned by this queue manager.
The log data set whose timestamp range includes the timestamp of the last successful backup of any application structure known within the queue-sharing group.

ALL
Display both page set and data set information.

Note:

This command is issued internally by WebSphere MQ during queue manager shutdown so that the restart RBA is recorded on the z/OS console log.

WebSphere is a trademark of the IBM Corporation in the United States, other countries, or both.

IBM is a trademark of the IBM Corporation in the United States, other countries, or both.