DISPLAY QMSTATUS on Multiplatforms

Use the MQSC command DISPLAY QMSTATUS to display status information associated with this queue manager.


Use MQSC commands

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

Synonym: DIS QMSTATUS

DISPLAY QMSTATUS

DISPLAY QMSTATUS ALL LOGRequested attributesLog attributesRequested attributes,CHINITCMDSERVCONNSINSTDESCINSTNAMEINSTPATHLDAPCONNQMNAMESTANDBYSTATUSSTARTDASTARTTILog attributes,ARCHLOGARCHSZCURRLOGLOGINUSELOGPATHLOGUTILMEDIALOGRECLOGMEDIASZRECSZREUSESZ


Parameter descriptions for DISPLAY QMSTATUS

    ALL
    Specify this parameter to display all the parameters. If this parameter is specified, any parameters that are requested specifically have no effect; all parameters are still displayed.

    This parameter is the default if we do not request any specific parameters.


Requested parameters

Specify one or more parameters that define the data to be displayed. The parameters can be specified in any order, but do not specify the same parameter more than once.

    ARCHLOG (x)
    Name of the oldest log extent for which the queue manager is waiting for archive notification. This parameter is:

    • Available only on queue managers using archive log management.
    • Blank, if the queue manager is not using archive log management, or if the queue manager has no extents waiting for notification.

    ARCHSZ (x)

    The amount of space occupied, in megabytes, by log extents no longer required for restart or media recovery, but waiting to be archived.

    Note that this value impacts the total space used by the queue manager for log extents.

    This parameter is available only on queue managers using archive log management. If the queue manager is not using archive log management, this parameter is zero.

    This attribute is not valid on IBM® i.

    CHINIT
    The status of the channel initiator reading SYSTEM.CHANNEL.INITQ. It is one of the following:

      STOPPED
      The channel initiator is not running.

      STARTING
      The channel initiator is in the process of initializing and is not yet operational.

      RUNNING
      The channel initiator is fully initialized and is running.

      STOPPING
      The channel initiator is stopping.

    CMDSERV
    The status of the command server. It is one of the following:

      STOPPED
      The command server is not running.

      STARTING
      The command server is in the process of initializing and is not yet operational.

      RUNNING
      The command server is fully initialized and is running.

      STOPPING
      The command server is stopping.

    CONNS
    The current number of connections to the queue manager.

    CURRLOG
    The name of the log extent being written to at the time that the DISPLAY QMSTATUS command is processed. If the queue manager is using circular logging, and this parameter is explicitly requested, a blank string is displayed.

    INSTDESC
    Description of the installation associated with the queue manager. This parameter is not valid on IBM i.

    INSTNAME
    Name of the installation associated with the queue manager. This parameter is not valid on IBM i.

    INSTPATH
    Path of the installation associated with the queue manager. This parameter is not valid on IBM i.

    LDAPCONN
    The status of the connection to the LDAP server. It is one of the following:

      CONNECTED
      The queue manager currently has a connection to the LDAP server.

      ERROR
      The queue manager attempted to make a connection to the LDAP server and failed.

      INACTIVE
      The queue manager is not configured to use an LDAP server or has not yet made a connection to the LDAP server.

    LOG
    Specify this parameter to display all the LOG parameters. If this parameter is specified, any LOG parameters that are requested specifically have no effect; all parameters are still displayed.

    LOGINUSE (x)
    The percentage of the primary log space in use for restart recovery at this point in time.

    A value of 100 or greater indicates the queue manager might have allocated, and be using, secondary log files, probably due to long-lived transactions at this point in time.

    This attribute is not valid on IBM i.

    LOGPATH (x)
    Identifies the directory where log files are created by the queue manager.

    LOGUTIL (x)

    A percentage estimate of how well the queue manager workload is contained within the primary log space.

    If the value is consistently above 100 you might want to investigate whether there are long-lived transactions, or if the number of primary files is not sufficient for the workload.

    If the utilization continues to rise, eventually requests for most further operations requiring log activity will be refused, together with an MQRC_RESOURCE_PROBLEM return code being returned to the application. Transactions might be backed out.

    This attribute is not valid on IBM i.

    MEDIALOG
    The name of the oldest log extent required by the queue manager to perform media recovery. If the queue manager is using circular logging, and this parameter is explicitly requested, a blank string is displayed.

    MEDIASZ (x)

    Size of the log data required for media recovery in megabytes.

    This value shows how much log that must be read for media recovery and directly impacts the time taken for this operation.

    This is zero for a circular logging queue manager. The size is typically reduced by taking more frequent media images of objects.

    This attribute is not valid on IBM i.

    QMNAME
    The name of the queue manager. This parameter is always returned.

    RECLOG
    The name of the oldest log extent required by the queue manager to perform restart recovery. If the queue manager is using circular logging, and this parameter is explicitly requested, a blank string is displayed.

    RECSZ (x)
    Size of the log data required for restart recovery in megabytes.

    This value shows how much log that must be read for restart recovery and directly impacts the time taken for this operation.

    This attribute is not valid on IBM i.

    REUSESZ (x)
    This attribute is valid only on automatic or archive log management queue managers.

    The amount of space occupied, in megabytes, by log extents available to be reused.

    This value impacts the total space used by the queue manager for log extents.

    The size is automatically managed by the queue manager, but if necessary we can request reductions using the RESET QMGR TYPE(REDUCELOG) command.

    This attribute is not valid on IBM i.

    STANDBY
    Whether a standby instance is permitted. It is one of the following:

      NOPERMIT
      Standby instances are not permitted.

      PERMIT
      Standby instances are permitted.

    STATUS
    The status of the queue manager. It is one of the following:

      STARTING
      The queue manager is in the process of initializing.

      RUNNING
      The queue manager is fully initialized and is running.

      QUIESCING
      The queue manager is quiescing.

    STARTDA
    The date on which the queue manager was started (in the form yyyy-mm-dd).

    STARTTI
    The time at which the queue manager was started (in the form hh.mm.ss).