SET MANAGER

Parámetros

NAME (máscara-nombre-gestor)

En sistemas z/OS® , este valor de parámetro es el nombre específico o genérico de 1 a 4 caracteres de los gestores de colas que desea supervisar. Para especificar un nombre genérico, especifique una serie de caracteres seguida de un asterisco (*). Por ejemplo, para supervisar todos los gestores de colas del sistema z/OS , especifique NAME(*). Este parámetro es necesario en sistemas z/OS .

En sistemas distribuidos, especifique el nombre completo del gestor de colas que desea supervisar sin ningún asterisco. Si no especifica este parámetro, se supervisa el gestor de colas predeterminado.

GROUP (nombre-grupo)

Grupo definido previamente que tiene valores predeterminados de parámetros que se pueden aplicar a este gestor de colas. El nombre debe coincidir exactamente con el nombre especificado en una sentencia SET GROUP anterior. El grupo predeterminado proporcionado se denomina DEFAULT.

ACTIVO (SÍ|NO )

Indica si se debe supervisar activamente este gestor de colas. YES es el valor predeterminado.

AGGRHIST(muestras-agregación)

Especifica el número de muestras recientes que se deben mantener en el almacenamiento del agente para todos los gestores de colas de este grupo. El valor predeterminado es 15. Puede ver datos por intervalo de muestreo reciente sobre un objeto determinado enlazando desde una fila sobre el objeto a un espacio de trabajo con un nombre que empiece por "Reciente".

COMANDO (SÍ|NO )

Especifica si está disponible el paso de comandos IBM MQ al gestor de colas desde Tivoli Enterprise Portal .

Los valores válidos son los siguientes:

• YES: Habilita la función Mandato MQ. A continuación, puede pasar los comandos IBM MQ al gestor de colas desde Tivoli Enterprise Portal. Es el valor predeterminado.
• NO: Inhabilita la función Mandato MQ.

EVENTS(REMOVE|BROWSE|NO)

Especifica cómo acceder a las colas de sucesos del sistema.

Los valores válidos son los siguientes:

• REMOVE : Lee y elimina mensajes de las colas de sucesos del sistema. Este valor proporciona los informes de sucesos más exactos. El valor que se configura automáticamente durante el proceso de instalación y configuración es REMOVE. Cuando está especificado REMOVE, el agente abre las colas de sucesos para acceso exclusivo.

  Para proporcionar soporte a múltiples aplicaciones para leer colas de eventos, utilice los comandos SET EVENTQIN y SET EVENTQOUT como se describe en SET EVENTQIN y SET EVENTQOUT.

• BROWSE: Examina (lee sin eliminar) mensajes de las colas de sucesos del sistema. Especifique este valor si más de una aplicación (IBM MQ Monitoring Agent u otra aplicación) lee las colas de eventos. En este caso, debe ejecutar una aplicación distinta para borrar las colas, como por ejemplo CSQUTIL con la función EMPTY.
  Recuerde: Si especifica EVENTS(BROWSE) y otras aplicaciones realizan lecturas destructivas contra las colas de eventos, IBM MQ Monitoring Agent podría perder algunos o todos los mensajes de eventos.
• NO : No supervisar colas de sucesos del sistema.

HLQ(calificador-alto-nivel)

Especifica el calificador de alto nivel para los nombres de cola creados por IBM MQ Monitoring Agent. El valor predeterminado es KMQ. La longitud máxima de este parámetro es de 8 caracteres.

IBM MQ Monitoring Agent utiliza estos nombres:

hlq.COMMAND.REPLY
hlq.REPLY

donde hlq es el valor especificado por el parámetro HLQ del comando SET MANAGER o SET GROUP .

Si lo desea, puede predefinir colas con esos nombres en sus gestores de colas. Si no están predefinidas, el agente creará colas dinámicas utilizando el modelo de cola que se especifica mediante el parámetro RQMODEL en el comando SET MANAGER o SET GROUP .

Después de OA61473, si ya existen colas dinámicas predefinidas o permanentes por los nombres indicados anteriormente, el agente reutilizará esas colas cuando se inicie. De forma predeterminada, el agente utiliza la cola de modelo dinámico permanente denominada SYSTEM.COMMAND.REPLY.MODEL. Una cola de modelo dinámico permanente en el parámetro de agente RQMODEL como este hace que el agente cree colas por esos nombres la primera vez que se inicia el agente y, a continuación, que las reutilice cuando se reinicie el agente. Si RQMODEL especifica una cola modelo diferente para una cola dinámica temporal, el agente creará colas dinámicas temporales con esos nombres cada vez que se inicie.

Si por alguna razón desea supervisar el mismo gestor de colas por más de un agente, debe asegurarse de que este parámetro HLQ sea exclusivo para cada tiempo de ejecución de agente en la misma LPAR; en este caso, se recomienda añadir los 1-4 caracteres utilizados para RTE_STC_PREFIX a "KMQ".

ICYCLE(ciclo-intervalo)

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

Este parámetro opcional especifica el número de ciclos de intervalo de muestreo que se debe esperar antes de recopilar datos de rendimiento para los gestores de colas especificados. El valor predeterminado es 1 minuto. Puede utilizar este parámetro para alargar el intervalo de muestreo para un gestor de colas o grupo de gestores de colas determinado cuya recopilación de datos es menos crítica y se puede realizar con menos frecuencia. Por ejemplo, si el intervalo de muestreo (SAMPINT) para un gestor de colas es 60 y su ciclo de intervalo (ICYCLE) es 5, se realiza proceso interrogativo para ese gestor de colas solamente en cada quinto ciclo; cada cinco minutos en lugar de cada minuto.

Si no especifica el parámetro ICYCLE, o si no se ha especificado en una sentencia SET GROUP anterior, el valor predeterminado es 1; se recopilan datos del gestor de colas una vez por cada intervalo de muestreo (SAMPINT).

LIKE (nombre-gestor-colas)

Nombre o apodo de un gestor de colas definido anteriormente. Los valores de parámetros que no se especifican en esta sentencia SET MANAGER se copian de los valores correspondientes para el gestor de colas especificado.

ACTIONAUTHUSERS(lista-máscaras-nombre-usuario)

Este parámetro sólo se puede aplicar al mandato manual Actuación.

Especifica que el ID de usuario de Tivoli Enterprise Portal debe coincidir con una de las listas de máscaras de nombres de usuario antes de que se pueda emitir el comando Take Action.

Si el parámetro ACTIONAUTHUSERS contiene un valor vacío [()], significa que ACTIONAUTHUSERS no está definido en la lista de parámetro. Este parámetro ACTIONAUTHUSERS no se tiene en cuenta.

Si el valor del parámetro ACTIONAUTHUSERS se establece en una lista de máscaras de nombres de usuario, especifica qué usuarios de Tivoli Enterprise Portal están autorizados a emitir los comandos Take Action asociados a este IBM MQ Monitoring Agent. Pueden existir varias entradas de datos para este parámetro. Separe cada entrada con una coma (,). Una entrada puede ser una máscara que incluya los caracteres comodín asterisco (*) y signo de interrogación (?). Un usuario de Tivoli Enterprise Portal que tenga un ID que coincida con cualquiera de las máscaras de esta lista está autorizado a emitir los comandos Take Action. Tivoli Enterprise Portal los ID de usuario se definen en Tivoli Enterprise Monitoring Server y no existen necesariamente en el nodo en el que se ejecuta IBM MQ Monitoring Agent .

ACTIONACCOUNT(UIUSER|MQAGENT|USER=id-usuario)

Este parámetro sólo es aplicable a los comandos Take Action que se proporcionan con IBM MQ Monitoring Agent.

Especifica que IBM MQ Monitoring Agent utiliza el valor ACTIONACCOUNT como ID de usuario alternativo al interactuar con IBM MQ. El parámetro ACTIONACCOUNT especifica si la autorización debe utilizar el ID de usuario de Tivoli Enterprise Portal , la cuenta del agente de supervisión o la cuenta predefinida.

Los valores válidos son los siguientes:

• (): altera temporalmente el valor definido en el mandato SET GROUP o SET MANAGER .
• UIUSER : El agente utiliza el identificador de usuario Tivoli Enterprise Portal para interactuar con IBM MQ.
• MQAGENT : El agente utiliza la cuenta del agente de monitorización para interactuar con IBM MQ.
• USUARIO=usuario-id: El agente utiliza la cuenta predefinida (usuario-id) para interactuar con IBM MQ.

Si se especifica un valor que no sea uno de esos valores, el valor no es válido; se considera entonces que el parámetro ACTIONACCOUNT no está definido en el mandato.

Para la automatización de reflejo, sólo se utiliza el ID especificado en ACTIONACCOUNT(USER=user_id) para emitir el mandato MQ ; de lo contrario, se utiliza el ID de usuario del agente de MQ Monitoring para emitir el mandato MQ .

MSGACCESS (NONE |DESC| RETRY | DATA | DELETE | USEQACCESS)

Controla el nivel de acceso del usuario a los mensajes en las colas para los gestores de colas especificados.

Los valores válidos son los siguientes:

• NONE: No se permite ningún acceso a las funciones de mensajes para los gestores de colas especificados, incluida la capacidad para listar los mensajes de una cola o recopilar estadísticas de mensajes.
• DESC: Permite que el descriptor de mensajes examine los espacios de trabajo de resumen de mensajes, los espacios de trabajo de detalle de mensajes o los espacios de trabajo y las situaciones de estadísticas de mensajes. Es el nivel predeterminado.
• RETRY: Permite el reintento de DLQ y el examen del descriptor de mensajes.
• DATA: Permite el examen de datos de mensajes (contenido), el examen del descriptor de mensajes y el reintento de DLQ.
• DELETE: Permite la supresión de mensajes y todas las demás funciones de mensajes.
• USEQACCESS: Especifica que todas las colas pertenecientes al grupo o gestor de colas actual deben definirse mediante un nuevo mandato SET QACCESS a fin de otorgar derechos de acceso a mensajes. Las colas pertenecientes al grupo actual que se hayan definido mediante un mandato SET QACCESS tienen el nivel de acceso a mensajes NONE.

NICKNAME(apodo)

Apodo (nombre alternativo) de 1 a 48 caracteres para este gestor de colas. Los mandatos posteriores pueden hacer referencia al gestor mediante su nombre de gestor o mediante su apodo. Este parámetro es opcional.

RETAINHIST(valor-retención-histórica)

Número de minutos que los objetos del gestor de colas (como, por ejemplo, canales y colas) que ya no están definidos en el gestor de colas se retienen en la memoria del agente y se devuelven para visualizarse en espacios de trabajo para facilitar el enlace con datos históricos sobre los objetos. Puede disminuir el valor de RETAINHIST si desea que se conserven menos datos en la memoria para estos objetos que ya no están definidos. Este parámetro sólo es válido para canales y colas locales.

RQMODEL(cola-modelo de cola-respuesta)

Especifica el nombre de 1 a 48 caracteres de una cola modelo que se utilizará como modelo para la cola de respuesta de IBM MQ Monitoring Agent, si no se han predefinido colas. Si necesita colas dinámicas, vea la descripción del parámetro HLQ.

Si no se especifica un valor para el parámetro RQMODEL , se utilizan los siguientes modelos estándar por defecto del sistema como modelo para la cola de respuesta de IBM MQ Monitoring Agent.

• SYSTEM.COMMAND.REPLY.MODEL

Si la cola que especifica como modelo está definida como dinámica permanente [DEFTYPE(PERMDYN)], se pueden acumular algunas colas de respuestas no utilizadas. El nombre de estas colas tiene los formatos siguientes:

• hlq.COMMAND.REPLY.dynamicsuffix
  hlq.REPLY.dynamicsuffix

donde el valor hlq es el valor que se especifica en el parámetro HLQ del comando SET MANAGER o SET GROUP , y el valor dynamicsuffix es el sufijo dinámico estándar que proporciona IBM MQ.

STATUS(ADD|DELETE|RESET)

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

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

Si se omite este parámetro, la definición del gestor se añade si es un nombre nuevo; la definición se modifica si el mismo nombre se ha especificado anteriormente.

Los valores válidos son los siguientes:

• ADD: Crea una nueva definición de gestor.
• DELETE: Suprime la definición del gestor y todos los datos históricos asociados.
• RESET: Restaura los parámetros de supervisión del gestor de colas a sus valores originales (tal como están definidos en el mandato SET MANAGER original para este nombre de gestor).

SYSNAME(id-sistema-z/OS)

ID del sistema donde se ejecuta este gestor de colas. Si se omite este parámetro, este mandato SET MANAGER se aplica a cualquier sistema z/OS .

REMOTE(YES|NO)

Especifica si el gestor de colas es un gestor de colas remoto o uno local.

Si se omite este parámetro, el gestor de colas es un gestor de colas local.

Los valores válidos son los siguientes:

• YES: El gestor de colas es un gestor de colas remoto.
• NO: El gestor de colas es un gestor de colas local.

MSGSITACCOUNT(MQAGENT|USER=id_usuario)

Especifica que IBM MQ Monitoring Agent utiliza el valor MSGSITACCOUNT como ID de usuario alternativo para interactuar con IBM MQ en situaciones de supervisión de mensajes.

Este parámetro sólo se aplica a las situaciones que se han definido para el grupo de atributos Resumen de mensajes.

Este parámetro sólo tiene efecto cuando MSGSITMON está establecido en YES.

Los valores válidos son los siguientes:

• MQAGENT : El agente utiliza la cuenta del agente de monitorización para interactuar con IBM MQ.
• USUARIO=usuario-id: El agente utiliza la cuenta predefinida (usuario-id) para interactuar con IBM MQ.

MSGSITMON ( SÍ|NO|STATÓNICAMENTE )

Especifica si habilitar situaciones que estén definidas para el grupo de atributos Resumen de mensajes para la supervisión del contenido y la cabecera del mensaje.

Los valores válidos son los siguientes:

• YES: permite situaciones para supervisión de mensajes. Este valor solo tiene efecto cuando se especifica el parámetro MSGSITACCOUNT. De lo contrario, su valor predeterminado es STATONLY.
• NO: inhabilita las situaciones para la supervisión de mensajes e inhabilita la supervisión de estadísticas de mensaje.
• STATONLY: Este es el valor predeterminado. El comportamiento de IBM MQ Monitoring Agent no cambia. No se pueden definir situaciones para el grupo de atributos Resumen de mensaje para supervisar el contenido y la cabecera del mensaje. Este es el valor a utilizar cuando no se especifica el parámetro MSGSITMON.