Reset Queue Statistics (Response)

The response to the Reset Queue Statistics (MQCMD_RESET_Q_STATS) command consists of the response header followed by the QName structure and the attribute parameter structures shown in the following sections.

If a generic queue name was specified, one such message is generated for each queue found.

Always returned:

HighQDepth , MsgDeqCount , MsgEnqCount , QName , QSGDisposition , TimeSinceReset

Response data

HighQDepth (MQCFIN)

Maximum number of messages on a queue (parameter identifier: MQIA_HIGH_Q_DEPTH).

This count is the peak value of the CurrentQDepth local queue attribute since the last reset. The CurrentQDepth is incremented during an MQPUT call, and during backout of an MQGET call, and is decremented during a (nonbrowse) MQGET call, and during backout of an MQPUT call.

MsgDeqCount (MQCFIN)

Number of messages dequeued (parameter identifier: MQIA_MSG_DEQ_COUNT).

This count includes messages that have been successfully retrieved (with a nonbrowse MQGET) from the queue, even though the MQGET has not yet been committed. The count is not decremented if the MQGET is later backed out.

On z/OS, if the value exceeds 999 999 999, it is returned as 999 999 999

MsgEnqCount (MQCFIN)

Number of messages enqueued (parameter identifier: MQIA_MSG_ENQ_COUNT).

This count includes messages that have been put to the queue, but have not yet been committed. The count is not decremented if the put is later backed out.

On z/OS, if the value exceeds 999 999 999, it is returned as 999 999 999

QName (MQCFST)

Queue name (parameter identifier: MQCA_Q_NAME).

The maximum length of the string is MQ_Q_NAME_LENGTH.

QSGDisposition (MQCFIN)

QSG disposition (parameter identifier: MQIA_QSG_DISP). Specifies the disposition of the object (that is, where it is defined and how it behaves). This parameter is valid on z/OS only. The value can be any of the following values:

MQQSGD_COPY

The object is defined as MQQSGD_COPY.

MQQSGD_SHARED

The object is defined as MQQSGD_SHARED.

MQQSGD_Q_MGR

The object is defined as MQQSGD_Q_MGR.

TimeSinceReset (MQCFIN)

Time since statistics reset in seconds (parameter identifier: MQIA_TIME_SINCE_RESET).

Parent topic: Definitions of the Programmable Command Formats