Quando definido para uma situação, o comando Executar Ação ZOSWTO grava uma mensagem write-to-operator (WTO) multilinhas no console do operador quando a situação ocorre. A OMC multilinha é emitida no site z/OS (TEMS) ao qual um agente está conectado ou em um site z/OS (TEMA). A mensagem é produzida quando a situação é verdadeira ou falsa Quaisquer dados que seguem o nome do comando estarão presentes na mensagem multilinhas.
Para usar o comando, ao criar uma situação, inclua o comando Executar Ação ZOSWTO no seguinte formato:
ZOSWTO user_supplied_content
Em que user_supplied_content define o conteúdo a ser incluído na mensagem WTO e pode incluir variáveis de texto e de produto.
Quando a situação é acionada, a mensagem KO41041I é emitida no console do operador no seguinte formato:
O evento de situação é identificado na mensagem multilinhas pelo situation_event_id.. situation_name é o nome da situação e node_name é o nó de origem relacionado ao evento.. optional_display_item_value é o item de exibição, se um for definido para a situação.. A mensagem é produzida quando a situação é verdadeira (T) ou falsa (F).. O user_Supplied_content é o conteúdo conforme definido no comando ZOSWTO Quando a situação for falsa, os valores das variáveis de substituição no user_Supplied_content serão N/A
Os dados da mensagem são divididos em seções de 70 caracteres em um máximo de cinco linhas consecutivas
Dica: se você estiver usando a automação para reagir a uma situação com base na mensagem no console do operador, ao definir o comando ZOSWTO para uma situação, considere incluir informações de identificação no user_supplied_content, como um número de identificação exclusivo ou um rótulo.. Como cada situação acionada com um comando ZOSWTO definido produzirá a mensagem KO41041I, será necessário analisar outros detalhes para diferenciar as mensagens A capacidade de varrer informações exclusivas e conhecidas pode ajudar a identificar rapidamente as mensagens para uma situação específica.
Por padrão, o ZOSWTO usa o código de roteamento de opções WTO 2 (informações do operador) e o código descritor 12 (informações importantes). É possível alterar os valores padrão para essas opções, especificando os parâmetros ZOSWTO_ROUTE_CODE e ZOSWTO_DESCRIPTOR_CODE no membro KppENV de RKANPARU, em que pp é o código para o produto ou componente OMEGAMON que você deseja atualizar Também é possível substituir esses valores ao especificar o comando ZOSWTO usando o seguinte formato:
Observação: Além de definir o comando ZOSWTO como uma ação em uma situação, você também pode usar o recurso Take Action Tivoli Enterprise Portal para inserir manualmente o comando ZOSWTO, que requer o seguinte formato para substituir o código de roteamento e o código descritor:
Usando qualquer um dos métodos disponíveis (como, por exemplo,,, tacmd CLI), crie uma situação que inclua o comando Take Action ZOSWTO e defina o conteúdo (inclusive as variáveis do produto) a ser exibido na mensagem da OMC.
Quando a situação ocorre, a mensagem KO41041I, com um máximo de cinco linhas consecutivas, é gravada no console do operador
Exemplo
Este exemplo descreve como usar o comando ZOSWTO para gravar uma mensagem no console para uma situação específica detectada pelo IBM OMEGAMON for Messaging on z/OS, IBM MQ Monitoring Agent. Este exemplo fornece etapas de implementação para a interface de usuário aprimorada do 3270 e para o Tivoli Enterprise Portal, além de fornecer exemplos de mensagens de saída.
O cenário para esse exemplo é detectar quando o Evento do MQ para Alta Profundidade da Fila ocorreu e, quando esse evento ocorre, emitir uma mensagem para o console do operador que fornece o nome do gerenciador de fila do MQ , o nome do recurso do MQ (nome da fila) e o rótulo MQ01W, que será usado para identificação de mensagem no log...
Dica: Usar um rótulo é opcional e pode ajudar a simplificar a automação se houver várias situações usando o comando ZOSWTO .
O comando ZOSWTO a seguir contém o rótulo, o texto customizado e as variáveis de produto apropriadas para relatar ao console do operador para este evento:
ZOSWTO MQ01W Event queue depth high for Qmgr:&{Current_Events.Reporting_MQ_Manager_Name}; Queue:&{Current_Events.Resource_Name}
Para associar essa mensagem WTO à situação, você deve defini-la como um Comando do Sistema Executar Ação na situação. As seções a seguir mostram como fazer isso na interface de usuário aprimorada do 3270 e no Tivoli Enterprise Portal. Exemplos das mensagens produzidas no console do operador também são fornecidos..
Defina o comando ZOSWTO usando a interface com o usuário 3270 aprimorada
Use a guia Fórmula no Editor de Situação para definir os critérios para a situação, conforme mostrado na figura a seguir:
Figura 1. Definindo a fórmula de situação usando a interface com o usuário 3270 aprimorada
Observe o seguinte neste exemplo:
Um item de exibição é configurado para se tornar verdadeiro para cada fila possível. O item de exibição será incluído na mensagem WTO (como <optional_display_item_value>) quando o evento de situação ocorrer.
Em seguida, use a guia Ação do Editor de Situações para inserir o comando ZOSWTO como um Comando do sistema Você deve digitar S próximo a Comando para inserir o valor completo do comando, conforme mostrado nas figuras a seguir:
Figura 2 Definindo a ação de situação usando a interface com o usuário 3270 aprimoradaFigura 3. Definindo o comando ZOSWTO usando a interface com o usuário 3270 aprimorada
Definir o comando ZOSWTO usando o Tivoli Enterprise Portal
Use a guia Fórmula no Editor de Situação para definir os critérios da situação. Para este exemplo, a fórmula é o evento == Queue Depth High , conforme mostrado na figura a seguir:
Nota: Esta situação também possui um conjunto de itens de exibição para que ele se torne verdadeiro para cada fila possível. O item de exibição será incluído na mensagem WTO (como <optional_display_item_value>) quando o evento de situação ocorrer.
Figura 4. Definição da fórmula da situação usando o Tivoli Enterprise Portal
Em seguida, na Guia Ação do Editor de Situação, insira o comando ZOSWTO como um Comando do sistema, conforme mostrado na figura a seguir:
Figura 5. Definição do comando ZOSWTO usando o Tivoli Enterprise Portal
Visualizar as mensagens do WTO no console do operador
Quando essa situação ocorre (ou seja, quando a situação é true), a mensagem WTO a seguir aparece no console do operador:Figura 6. Mensagem WTO de exemplo quando a situação é verdadeira
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
Quando essa situação é limpa (ou seja, quando a situação é false), a mensagem WTO a seguir aparece no console do operador:Figura 7. Mensagem WTO de exemplo quando a situação é 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
O quê fazer em seguida
Opcionalmente, com base na ocorrência ou na resolução do evento de situação, é possível analisar a mensagem WTO para conduzir a automação ou notificar o programador de sistemas z/OS da situação
Observe o seguinte neste exemplo:
