SET AGENT

Utilice la sentencia SET AGENT para especificar el nombre de calificador medio que se utiliza en el nombre del sistema gestionado.
Nota: SET AGENT no debe utilizarse en sistemas z/OS , porque no es compatible con la interfaz de usuario 3270 mejorada o con nombres de sistemas gestionados OMEGAMON. Por lo tanto, SET AGENT solo se debe utilizar en entornos de plataforma distribuida. Sin embargo, hay una forma de especificar varios agentes en una LPAR en sistemas z/OS: especifique el parámetro de ID de agente en el mandato START en el KMQAGST del conjunto de datos rhilev.midlev.rtename.RKANCMDU, que se especifica mediante el parámetro KMQ_X_KMQAGENT_AGENTID en PARMGEN. Para obtener más información, consulte KMQ_X_KMQAGENT_AGENTID en la publicación Parameter Reference Guide.
Cuando se inicia IBM MQ Monitoring Agent, se registra el siguiente sistema gestionado:
  • En el sistema distribuido: monitoredqueuemanagername:agentname:MQ
  • En sistemas z/OS® : monitoredqueuemanagername:agentname:MQESA
donde monitoredqueuemanagername es el nombre del gestor de colas supervisado por el agente, agentname es el nombre de calificador medio del nombre del sistema gestionado.

En sistemas distribuidos, si no se especifica el valor de agentname, no se utiliza ningún valor.

En sistemas z/OS , si no se especifica el valor agentname , se utiliza el nombre de host (ID de SMF). Si especifica este valor, se utiliza sólo en los nombres de subnodos del sistema gestionado.

En sistemas distribuidos, puede utilizar la sentencia SET AGENT para realizar las operaciones siguientes:
  • Dos instancias activas de IBM MQ Monitoring Agent que se conecten al mismo servidor de monitorización de concentradores no pueden tener el mismo nombre de sistema gestionado.
    • En los sistemas distribuidos, si su entorno de trabajo tiene varios gestores de colas con el mismo nombre que se ejecutan en nodos diferentes, debe especificar el nombre del agente para cada gestor de colas. Para que IBM MQ Monitoring Agent pueda crear un nombre de sistema gestionado único.
    • En sistemas distribuidos, si la longitud del nombre de sistema gestionado supera los 32 caracteres, es posible que dos nombres de gestor de colas distintos se resuelvan en el mismo porque se trunquen. Para distinguir los nombres de sistemas gestionados para gestores de colas, especifique el nombre del agente para cada gestor de colas.
  • Puede agrupar e identificar nombres de gestores de colas por algo que no sea el nombre de host ni el nombre del gestor de colas, como por ejemplo un nombre de clúster de alta disponibilidad.
  • Permitir que varios agentes conectados a la misma Tivoli® Enterprise Monitoring Server supervisen el mismo gestor de colas.

Sintaxis

SET AGENT NAME(agentname)

Parámetros

NAME (nombre_agente)

El nombre que se debe utilizar para el nombre de calificador medio del nombre del sistema gestionado.

En sistemas distribuidos, el nombre completo del sistema gestionado es monitoredqueuemanagername:agentname:MQ.

En sistemas z/OS , el nombre completo del sistema gestionado es monitoredqueuemanagername:agentname:MQESA. Sin embargo, como se ha indicado anteriormente, SET AGENT no debe utilizarse en sistemas z/OS.

La longitud máxima para el nombre completo del sistema gestionado es de 32 caracteres, por lo que la longitud máxima para agentname depende de la longitud del nombre del gestor de colas. Si no hay suficientes caracteres para ajustar el agentname completo que se ha especificado, se trunca a no menos de 8 caracteres.

Ejemplo

Para supervisar un gestor de colas llamado PERSONNEL en el nodo AIX1 cuando también hay un gestor de colas llamado PERSONNEL en el nodo HPUX2, especifique las siguientes sentencias en el archivo de supervisión correspondiente al nodo AIX1:

SET MANAGER NAME(PERSONNEL)
SET AGENT NAME(AIX1)

Para supervisar simultáneamente el gestor de colas PERSONNEL en el nodo HPUX2, especifique las siguientes sentencias en el archivo de supervisión correspondiente al nodo HPUX2:

SET MANAGER NAME(PERSONNEL)
SET AGENT NAME(HPUX2)