SET QUEUE

Utilice la sentencia SET QUEUE para especificar las colas que se deben supervisar.

Recuerde: La sentencia SET QUEUE no afecta a las consultas de atributos bajo demanda. Incluso si el agente no toma muestras de datos sobre tipos de colas en particular, o el agente sólo toma muestras con poca frecuencia de datos definitorios de colas, aún puede obtener los datos más actuales para una cola utilizando una consulta de grupo de atributos a demanda.

Sintaxis

SET QUEUE NAME(queue-name-mask)
       MGRNAME(manager-name) | GROUP(group-name)
       [QDEFTYPE(PREDEFINED|PERMDYN|TEMPDYN|ALL)]
       [STATISTICS(YES|NO)]
       [STATUS(ADD|DELETE)]
       [QTYPE (ALL|QLOCAL|QALIAS|QCLUSTER|QREMOTE|QMODEL)]
       [DEFSAMPCYCLE(n-sample-interval)]

Parámetros

NAME (máscara-nombre-cola)

Especifica un nombre de canal, genérico o específico, de entre 1 y 48 caracteres, que desea supervisar. Para especificar un nombre genérico, especifique una serie de caracteres seguida de un asterisco (*). Este parámetro es obligatorio.

Si establece este parámetro en un carácter en blanco ( ), la IBM MQ Monitoring Agent sólo recopila datos de supervisión muestreados para la cola de letra muerta.

Si establece este parámetro en un carácter de asterisco (*), el agente recopilará datos de supervisión muestreados para todas las colas que sean aplicables dados otros parámetros a SET QUEUE.

MGRNAME (nombre-gestor)

Asocia esta sentencia SET QUEUE con un gestor de colas definido en una sentencia SET MANAGER anterior. Puede utilizar el nombre o apodo del gestor. El nombre debe coincidir exactamente con el nombre especificado en el mandato SET MANAGER correspondiente. Este parámetro es necesario si no se especifica el parámetro GROUP.

GROUP (nombre-grupo)

Asocia esta sentencia SET QUEUE a un grupo de gestores de colas definidos en una sentencia SET GROUP anterior. El nombre debe coincidir exactamente con el nombre especificado en la sentencia SET GROUP correspondiente. Este parámetro es necesario si no se especifica el parámetro MGRNAME.

QDEFTYPE (PREDEFINIDO|PERMDYN|TEMPDYN|TODOS )

Indica qué tipos de colas se deben supervisar. Especifique alguno de los siguientes tipos de definición, o todos ellos:

PREDEFINED: Supervisar sólo las colas predefinidas que coincidan con el nombre de cola específico o genérico. Es el valor predeterminado.
El valor predeterminado puede evitar aumentar la cantidad de datos de cola que se muestrea y se mantiene para colas dinámicas y temporales.
PERMDYN: Supervisar sólo las colas dinámicas permanentes que coincidan con el nombre de cola específico o genérico.
TEMPDYN: Supervisar sólo las colas dinámicas temporales que coincidan con el nombre de cola específico o genérico.
ALL: Supervisar todas las colas que coincidan con el nombre de cola específico o genérico.

Recuerde: Esta opción no afecta a los espacios de trabajo que contienen datos bajo demanda. Por ejemplo, los espacios de trabajo Definiciones de cola en tiempo real y Datos de cola en tiempo real muestran información relacionada con todas las colas sin tener en cuenta este atributo.

ESTADÍSTICAS( SÍ|NO )

Especifica si se recopilan estadísticas de cola mediante el procesamiento del comando IBM MQ Reset Queue Statistics.

YES: Recopila estadísticas utilizando el proceso del mandato Restablecer estadísticas de cola para colas que coinciden con el nombre de cola específico o genérico.

NO: No recopila estadísticas utilizando el proceso del mandato Restablecer estadísticas de cola para colas que coinciden con el nombre de cola específico o genérico. Es el valor predeterminado. Consulte Recopilación de datos de estadísticas de colas para obtener una descripción de la función Estadísticas de colas.

STATUS(ADD|DELETE)

Especifica qué se debe hacer si este mandato SET QUEUE se ha especificado anteriormente con el mismo nombre.

Si se omite este parámetro, la definición de cola se añade si es un nombre nuevo; la definición se modifica si el mismo nombre se especificó anteriormente.

ADD: Crea una nueva definición de cola. Si este mandato SET QUEUE se especificó anteriormente con el mismo nombre, no se modifica y se emite un mensaje de error.

DELETE: Suprime una definición de cola y todos los datos históricos asociados.

Especifica qué tipos de colas se deben supervisar. Especifique alguno o todos los siguientes tipos de colas y utilice comas (,) para separar los valores especificados.

ALL: supervisa todos los tipos de cola. Es el valor predeterminado.
QLOCAL: sólo supervisa las colas locales.
QALIAS: sólo supervisa las colas alias.
QCLUSTER: sólo supervisa las colas de clúster.
QREMOTE: sólo supervisa las colas remotas.
QMODEL: sólo supervisa las colas de modelo.

Recuerde: Este parámetro no afecta a los espacios de trabajo que contienen datos bajo demanda. Por ejemplo, los espacios de trabajo Definiciones de cola en tiempo real y Datos de cola en tiempo real muestran información sobre todas las colas, independientemente de este valor de parámetro.

DEFSAMPCYCLE(intervalo-muestra-n)

Este parámetro sólo se aplica a sistemas z/OS® .

Especifique la frecuencia con que se muestrean los datos de definición de cola. El número especificado, n, indica que el agente recopila los datos de definición de cola cada muestra de n-th. El valor predeterminado es 1, que indica que el agente recopila datos en cada intervalo de muestreo. El valor 0 indica que el agente recopila datos de definición sólo en el primer intervalo de muestreo. Tras dicho intervalo, los datos de definición sólo se renuevan cuando el agente encuentra una nueva cola local.

Ejemplo

Para supervisar todas las colas asociadas con el gestor de colas MGRA, especifique la siguiente sentencia:
```
SET QUEUE NAME(*) MGRNAME(MGRA) QDEFTYPE(ALL)
```
Para supervisar una cola predefinida llamada ACCOUNTS, especifique la siguiente sentencia:
```
SET QUEUE NAME(ACCOUNTS) MGRNAME(MGRA)
```
Para supervisar y recopilar estadísticas utilizando el proceso del mandato Restablecer estadísticas de cola para todas las colas predefinidas gestionadas por el gestor de colas MGRA, especifique la sentencia siguiente:
```
SET QUEUE NAME(*) MGRNAME(MGRA) STATISTICS(YES)
```
Para supervisar las colas dinámicas permanentes en el gestor de colas MGRA cuyos nombres comiencen por PAYR, especifique la siguiente sentencia:
```
SET QUEUE NAME(PAYR*) MGRNAME(MGRA) QDEFTYPE(PERMDYN)
```
Para supervisar las colas dinámicas predefinidas y temporales en el gestor de colas MGRC cuyos nombres comiencen por MARCH, especifique la siguiente sentencia:
```
SET QUEUE NAME(MARCH*) MGRNAME(MGRC) -
QDEFTYPE(PREDEFINED,TEMPDYN)
```