RESET QSTATS

---

Use RESET QSTATS to report performance data for a queue and then to reset that data.

Synonym: None

                                .-CMDSCOPE(' ')------------.
>>-RESET QSTATS(generic-qname)--+--------------------------+---><
                                |                     (1)  |
                                +-CMDSCOPE(qmgr-name)------+
                                |             (1)          |
                                '-CMDSCOPE(*)--------------'
 
 

Notes:

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

 

Parameter descriptions

generic-qname

The name of the local queue with a disposition of QMGR, COPY, or SHARED, but not GROUP, whose performance data is to be reset.

A trailing asterisk (*) matches all queues with the specified stem followed by zero or more characters. An asterisk (*) on its own specifies all queues.

The names must all be defined to the local queue manager or queue-sharing group.

The performance data is returned in the same format as parameters returned by DISPLAY commands. The data is:

QSTATS

The name of the queue

QSGDISP

The disposition of the queue, that is, QMGR, COPY, or SHARED.

RESETINT

The number of seconds since the statistics were last reset.

HIQDEPTH

The peak queue depth since the statistics were last reset.

MSGSIN

The number of messages that have been added to the queue by MQPUT and MQPUT1 calls since the statistics were last reset.

The count includes messages added to the queue in units of work that have not yet been committed, but the count is not decremented if the units of work are subsequently backed out.

MSGSOUT

The number of messages removed from the queue by destructive (non-browse) MQGET calls since the statistics were last reset.

The count includes messages removed from the queue in units of work that have not yet been committed, but the count is not decremented if the units of work are subsequently backed out.

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.

 

Usage notes

1. If there is more than one queue with a name that satisfies the generic q-name, all those queues are reset.

2. Issue this command from an application, and not the z/OS console or its equivalent, to ensure that the statistical information is recorded.

3. Each queue manager in a queue-sharing group maintains its copy of the following performance statistics independently:

   MSGIN

   Incremented each time a message is put to the shared queue

   MSGOUT

   Incremented each time a message is removed from the shared queue

   HIQDEPTH

   Calculated by comparing its current value for HIQDEPTH with the new queue depth it obtains from the coupling facility during every put operation.

   To obtain full statistics for a shared queue, specify CMDSCOPE(*) on RESET QSTATS to broadcast the command to all queue managers in the queue-sharing group.

   The peak queue depth approximates to the maximum of all the returned HIQDEPTH values, and the total MQPUT and MQGET counts approximates to the sum of all the returned MSGIN and MSGOUT values respectively.

4. If the PERFMEV attribute of the queue manager is DISABLED, the command fails.

 

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.