RESET QSTATS (informar y restablecer datos de rendimiento de cola) en z/OS

Utilice el mandato MQSC RESET QSTATS para informar de los datos de rendimiento de una cola y, a continuación, para restablecer dichos datos.

Utilización de mandatos MQSC en z/OS

Para obtener información sobre cómo utilizar los mandatos MQSC en z/OS®, consulte Orígenes desde los que puede emitir mandatos MQSC y PCF en IBM® MQ for z/OS.

Puede emitir este mandato desde los orígenes 2CR. Para obtener una explicación de los símbolos de origen, consulte Orígenes desde los que puede emitir mandatos MQSC y PCF en IBM MQ for z/OS.

Diagrama de sintaxis
Notas de uso para RESET QSTATS
Descripciones de parámetros para RESET QSTATS

Sinónimo: Ninguno

Notas:

¹ Sólo es válido cuando el gestor de colas es miembro de un grupo de compartición de colas.

Notas de uso para RESET QSTATS

Si hay más de una cola con un nombre que satisfaga el nombre-q genérico, se restablecerán todas esas colas.
Emita este mandato desde una aplicación, y no desde la consola de z/OS o su equivalente, para asegurarse de que se registra la información estadística.
La información siguiente se conserva para todas las colas, tanto privadas como compartidas. Para las colas compartidas, cada gestor de colas mantiene una copia independiente de la información:

MSGIN

Se incrementa cada vez que se coloca un mensaje en la cola compartida

MSGOUT

Se incrementa cada vez que se elimina un mensaje de la cola compartida

PROFUNDIDAD

Se calcula comparando el valor actual para HIQDEPTH retenido por este gestor de colas con la nueva profundidad de cola obtenida del recurso de acoplamiento durante cada operación de colocación. La profundidad de la cola se ve afectada por todos los gestores de colas que transfieren mensajes a la cola u obtienen mensajes de la misma.

Para recuperar la información y obtener estadísticas completas para una cola compartida, especifique CMDSCOPE(*) para difundir el mandato a todos los gestores de colas del grupo de compartición de colas.

La profundidad de cola máxima se aproxima al máximo de todos los valores HIQDEPTH devueltos, el recuento total de MQPUT se aproxima a la suma de todos los valores MSGIN devueltos y el recuento total de MQGET se aproxima a la suma de todos los valores MSGOUT devueltos.
Si el atributo PERFMEV del gestor de colas es DISABLED, el mandato falla.

Descripciones de parámetros para RESET QSTATS

nombre-qgenérico

El nombre de la cola local con una disposición de QMGR, COPY o SHARED, pero no GROUP, con datos de rendimiento que se van a restablecer.

Un asterisco final (*) coincide con todas las colas con la raíz especificada seguida de cero o más caracteres. Un asterisco (*) por sí mismo especifica todas las colas.

Los datos de rendimiento se devuelven en el mismo formato que los parámetros devueltos por los mandatos DISPLAY. Los datos son:

QSTATS: El nombre de la cola
QSGDISP: La disposición de la cola, es decir, QMGR, COPY o SHARED.
RESETINT: Número de segundos desde la última vez que se hayan restablecido las estadísticas.
PROFUNDIDAD: La profundidad de cola máxima desde la última vez que se hayan restablecido las estadísticas.
MSGSIN: Número de mensajes que se han añadido a la cola mediante llamadas MQPUT y MQPUT1 desde la última vez que se hayan restablecido las estadísticas.
El recuento incluye los mensajes añadidos a la cola en unidades de trabajo que todavía no se han confirmado, pero el recuento no disminuye si las unidades de trabajo se restituyen posteriormente. El valor máximo visualizable es 999 999 999; si el número supera este valor, se visualiza 999 999 999.
PSOUT: Número de mensajes eliminados de la cola por llamadas MQGET destructivas (sin examinar) desde la última vez que se hayan restablecido las estadísticas.
El recuento incluye los mensajes eliminados de la cola en unidades de trabajo que todavía no se han confirmado, pero el recuento no disminuye si las unidades de trabajo se restituyen posteriormente. El valor máximo visualizable es 999 999 999; si el número supera este valor, se visualiza 999 999 999.

CMDSCOPE

Este parámetro especifica cómo se ejecuta el mandato cuando el gestor de colas es miembro de un grupo de compartición de colas.

' ': El mandato se ejecuta en el gestor de colas en el que se ha especificado. Éste es el valor predeterminado.
nombre-gestcolas: El mandato se ejecuta en el gestor de colas que especifique, siempre que el gestor de colas esté activo dentro del grupo de compartición de colas.
Puede especificar un nombre de gestor de colas, que no sea el gestor de colas en el que se ha especificado el mandato, sólo si está utilizando un entorno de grupo de compartición de colas y si el servidor de mandatos está habilitado.
*: El mandato se ejecuta en el gestor de colas local y también se pasa a cada gestor de colas activo del grupo de compartición de colas. El efecto de esto es el mismo que entrar el mandato en cada gestor de colas del grupo de compartición de colas.

Salida de ejemplo

El ejemplo siguiente muestra la salida del mandato en z/OS.

12.44.16 STC16696  CSQM201I !MQ13 CSQMDRTC  RESET QSTATS DETAILS  902   
   902             QSTATS(CICS01.INITQ)                                 
   902             QSGDISP(QMGR)                                        
   902             RESETINT(43)                                         
   902             HIQDEPTH(0)                                          
   902             MSGSIN(0)                                            
   902             MSGSOUT(0)                                           
   902              END QSTATS DETAILS                                  
12.44.16 STC16696  CSQM201I !MQ13 CSQMDRTC  RESET QSTATS DETAILS  903   
   903             QSTATS(MQ13.DEAD.QUEUE)                              
   903             QSGDISP(QMGR)                                        
   903             RESETINT(43)                                         
   903             HIQDEPTH(0)                                          
   903             MSGSIN(0)                                            
   903             MSGSOUT(0)                                           
   903              END QSTATS DETAILS                                  
12.44.16 STC16696  CSQM201I !MQ13 CSQMDRTC  RESET QSTATS DETAILS  904   
   904             QSTATS(SYSTEM.ADMIN.ACTIVITY.QUEUE)                  
   904             QSGDISP(QMGR)                                        
   904             RESETINT(43)                                         
   904             HIQDEPTH(0)                                          
   904             MSGSIN(0)                                            
   904             MSGSOUT(0)