Cuando se define para una situación, el mandato de Actuación ZOSWTO escribe un mensaje WTO (write-to-operator) de varias líneas en la consola del operador cuando se produce la situación. La OMC multilínea se emite en la dirección z/OS (TEMS) a la que está conectado un agente o en una dirección z/OS (TEMA). El mensaje se genera cuando la situación es verdadera o falsa. Los datos que siguen al nombre de mandato estarán presentes en el mensaje de varias líneas.
Para utilizar el mandato, al crear una situación, incluya el mandato de actuación ZOSWTO en el formato siguiente:
ZOSWTO user_supplied_content
Donde user_supplied_content define el contenido que se debe incluir en el mensaje WTO y puede incluir texto y variables de producto.
Cuando se activa la situación, el mensaje KO41041I en la consola del operador con el siguiente formato:
El suceso de situación se identifica en el mensaje de varias líneas mediante situation_event_id. situation_name es el nombre de la situación y node_name es el nodo de origen relacionado con el suceso. optional_display_item_value es el elemento de visualización, si se ha definido uno para la situación. El mensaje se genera cuando la situación es verdadera (T) o falsa (F). user_supplied_content es el contenido tal como se define en el mandato ZOSWTO . Cuando la situación es falsa, los valores de las variables de sustitución en user_supplied_content son N/A.
Los datos del mensaje se dividen en secciones de 70 caracteres en un máximo de cinco líneas consecutivas.
Sugerencia: Si va a utilizar la automatización para reaccionar ante una situación basada en el mensaje de la consola del operador, cuando defina el mandato ZOSWTO para una situación, considere la posibilidad de añadir información de identificación en user_supplied_content, como un número de identificación exclusivo o una etiqueta. Puesto que cada situación desencadenada con un mandato ZOSWTO definido generará el mensaje KO41041I, tendrá que analizar otros detalles para diferenciar los mensajes. La capacidad de buscar información exclusiva y conocida puede ayudar a identificar rápidamente los mensajes para una situación específica.
De forma predeterminada, ZOSWTO utiliza el código de direccionamiento de opciones WTO 2 (información de operador) y el código de descriptor 12 (información importante). Puede cambiar los valores predeterminados para estas opciones especificando los parámetros ZOSWTO_ROUTE_CODE y ZOSWTO_DESCRIPTOR_CODE en el miembro KppENV de RKANPARU, donde pp es el código del producto o componente OMEGAMON que desea actualizar. También puede alterar temporalmente estos valores al especificar el mandato ZOSWTO utilizando el formato siguiente:
Nota: Además de definir el comando ZOSWTO como una acción en una situación, también puede utilizar la función Take Action Tivoli Enterprise Portal para introducir manualmente el comando ZOSWTO, que requiere el siguiente formato para anular el código de enrutamiento y el código descriptor:
Utilizando cualquiera de los métodos disponibles (como,,, tacmd CLI), cree una situación que incluya el comando Take Action ZOSWTO y defina el contenido (incluidas las variables de producto) que aparecerá en el mensaje de la OMC.
Cuando se produce la situación, el mensaje KO41041I, con un máximo de cinco líneas consecutivas, se graba en la consola del operador.
Ejemplo
Este ejemplo describe cómo utilizar el mandato ZOSWTO para escribir un mensaje en la consola para una situación específica detectada por el agente de IBM OMEGAMON for Messaging on z/OS, IBM MQ Monitoring. Este ejemplo proporciona pasos de implementación tanto para la interfaz de usuario 3270 mejorada como para el Tivoli Enterprise Portal, y también proporciona ejemplos de mensajes de salida.
El escenario de este ejemplo es detectar cuándo se ha producido el suceso de MQ para profundidad de cola alta y, cuando se produce este suceso, emitir un mensaje a la consola del operador que proporciona el nombre del gestor de colas de MQ , el nombre del recurso de MQ (nombre de cola) y la etiqueta MQ01W, que se utilizará para la identificación de mensajes en el registro.
Sugerencia: El uso de una etiqueta es opcional y puede ayudar a simplificar la automatización si hay varias situaciones utilizando el mandato ZOSWTO .
El siguiente mandato ZOSWTO contiene la etiqueta, el texto personalizado y las variables de producto adecuadas para informar a la consola del operador para este suceso:
ZOSWTO MQ01W Event queue depth high for Qmgr:&{Current_Events.Reporting_MQ_Manager_Name}; Queue:&{Current_Events.Resource_Name}
Para asociar este mensaje WTO con la situación, debe definirlo como un mandato del sistema de actuación en la situación. Las siguientes secciones muestran cómo hacerlo en la interfaz de usuario 3270 mejorada y en el Tivoli Enterprise Portal. También se proporcionan ejemplos de los mensajes producidos en la consola del operador.
Definir el mandato ZOSWTO utilizando la interfaz de usuario 3270 mejorada
Utilice el separador Fórmula del Editor de situaciones para definir los criterios para la situación, tal como se muestra en la figura siguiente:
Figura 1. Definición de la fórmula de situación utilizando la interfaz de usuario 3270 mejorada
Observe lo siguiente en este ejemplo:
Se establece un elemento de visualización para que se convierta en verdadero para cada cola posible. El elemento de visualización se incluirá en el mensaje WTO (como <optional_display_item_value>) cuando se produzca el suceso de situación.
A continuación, utilice el separador Acción del Editor de situaciones para especificar el mandato ZOSWTO como mandato del sistema. Debe escribir S junto a Mandato para especificar el valor completo del mandato, tal como se muestra en las figuras siguientes:
Figura 2. Definición de la acción de situación utilizando la interfaz de usuario 3270 mejoradaFigura 3. Definición del mandato ZOSWTO utilizando la interfaz de usuario 3270 mejorada
Definir el comando ZOSWTO utilizando el Tivoli Enterprise Portal
Utilice el separador Fórmula del Editor de situaciones para definir los criterios de la situación. Para este ejemplo, la fórmula es el suceso == Queue Depth High , tal como se muestra en la figura siguiente.
Nota: Esta situación también tiene un elemento de visualización establecido para que se convierta en verdadero para cada cola posible. El elemento de visualización se incluirá en el mensaje WTO (como <optional_display_item_value>) cuando se produzca el suceso de situación.
Figura 4. Definición de la fórmula de situación utilizando el Tivoli Enterprise Portal
A continuación, en el separador Acción del Editor de situaciones, especifique el mandato ZOSWTO como un mandato del sistema, tal como se muestra en la figura siguiente:
Figura 5. Definición del comando ZOSWTO mediante Tivoli Enterprise Portal
Ver los mensajes WTO en la consola del operador
Cuando se produce esta situación (es decir, cuando la situación es true), aparece el siguiente mensaje WTO en la consola del operador:Figura 6. Ejemplo de mensaje WTO cuando la situación es verdadera
2023096 11:53:18.36 S0780082 00000090 KO41041I SITUATION EVENT 607
607 00000090 MQ_Queue_Depth_High:QK20:RSB2:MQESA<ABCAPPL_TYPE2_RECEIVING_Q> T MQ01W
607 00000090 Event queue depth high for Qmgr:QK20; Queue:ABCAPPL_TYPE2_RECEIVING_Q
607 00000090
607 00000090
607 00000090
Cuando esta situación se borra (es decir, cuando la situación es false), aparece el siguiente mensaje WTO en la consola del operador:Figura 7. Ejemplo de mensaje WTO cuando la situación es falsa
2023096 12:02:18.35 S0780082 00000090 KO41041I SITUATION EVENT 621
621 00000090 MQ_Queue_Depth_High:QK20:RSB2:MQESA<ABCAPPL_TYPE2_RECEIVING_Q> F MQ01W
621 00000090 Event queue depth high for Qmgr:N/A; Queue:N/A
621 00000090
621 00000090
621 00000090
Qué hacer a continuación
Opcionalmente, en función de la aparición o resolución del suceso de situación, puede analizar el mensaje WTO para dirigir la automatización o notificar al programador de sistemas z/OS la situación.
Observe lo siguiente en este ejemplo:
