DISPLAY USAGE on z/OS

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.


Use MQSC commands

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

We can issue this command from sources 2CR. For an explanation of the source symbols, see Sources from which we can issue MQSC commands on z/OS .

Synonym: DIS USAGE


DISPLAY USAGE

DISPLAY USAGE CMDSCOPE(' ')CMDSCOPE(qmgr-name)1CMDSCOPE(*)1PSID(n)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 runs when the queue manager is a member of a queue sharing group.

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

      qmgr-name
      The command runs on the queue manager you specify, providing the queue manager is active within the queue sharing group.

      We can specify a queue manager name, other than the queue manager on which the command was entered, only if we are using a queue sharing group environment and if the command server is enabled.

      *
      The command runs 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.

    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), 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 page set 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.

Parent topic: MQSC commands


Related reference