[z/OS]

DISPLAY USAGE

Use the MQSC command DISPLAY USAGE to display information about the current state of a page set, to display information about the log data sets, or to display information about the shared message data sets.

Using MQSC commands

For information on how you use MQSC commands, see Performing local administration tasks using MQSC commands.

IBM® i UNIX and Linux® Windows z/OS®
      2CR

For an explanation of the symbols in the z/OS column, see Using commands on z/OS.

Attention: From IBM MQ 8.0, the output of the DISPLAY USAGE command includes message CSQI065I +MP11 Buffer pool attributes, instead of message CSQP001I +MG11 Buffer pool 0 has 25000 buffers.
Synonym: DIS USAGE

DISPLAY USAGE

Read syntax diagramSkip visual syntax diagram DISPLAY USAGE CMDSCOPE(' ')CMDSCOPE(qmgr-name)1CMDSCOPE(*)1PSID(*)PSID(integer)TYPE(PAGESET)TYPE(DATASET)TYPE(SMDS)TYPE(ALL)
Notes:
  • 1 Valid only when the queue manager is a member of a queue-sharing group.

Parameter descriptions for DISPLAY USAGE

CMDSCOPE
This parameter specifies how the command is executed when the queue manager is a member of a queue-sharing group.
' '
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. This is optional.
*
An asterisk (*) on its own specifies all page set identifiers. This is the default value.
integer
This is a number, in the range 00 through 99.

The command fails if PSID has been specified together with TYPE(DATASET), or TYPE(SMDS).

If the command is running at the same time as an ALTER BUFFPOOL command the buffer pool attributes might not be entirely consistent. For example, the value of the location parameter might be BELOW, but the number of available buffers value might be more than can fit below the bar. If this occurs, run the display command again when the ALTER BUFFPOOL command has completed.

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 with a timestamp range that includes the timestamp of the last successful backup of any application structure known within the queue-sharing group.
SMDS
Display data set space usage information and buffer pool information for shared message data sets owned by this queue manager. Space usage information is only available when the data set is open. Buffer pool information is only available when the queue manager is connected to the structure. For more information about the displayed information, see the descriptions of messages CSQE280I and CSQE285I.
ALL
Display page set, data set, and SMDS information.
Note: This command is issued internally by IBM MQ:
  • During queue manager shutdown so that the restart RBA is recorded on the z/OS console log.
  • At queue manager startup so that page set information can be recorded.
  • When DEFINE PSID is used to dynamically define the first page set in the queue manager that uses the buffer pool specified on the DEFINE PSID command.