Procédure: Ecrire un message sur la console pour une situation
Vous pouvez utiliser la commande Action ZOSWTO (z/OS WTO) pour écrire un message dans la console opérateur z/OS pour une situation.
Avant de commencer
Vous pouvez utiliser la commande Take Action ZOSWTO lorsque vous créez une situation à l'aide de l'une des méthodes disponibles (telles que,, tacmd CLI).
Lorsqu'elle est définie pour une situation, la commande Action ZOSWTO écrit un message WTO sur plusieurs lignes dans la console de l'opérateur lorsque la situation se produit. L'OMC multiligne est délivrée sur le site z/OS (TEMS) auquel un agent est connecté ou sur un site z/OS (TEMA). Le message est généré lorsque la situation est vraie ou fausse. Toutes les données qui suivent le nom de la commande seront présentes dans le message multiligne.
Pour utiliser la commande, lors de la création d'une situation, incluez la commande Action ZOSWTO au format suivant:
ZOSWTO user_supplied_content
Où user_supplied_content définit le contenu à inclure dans le message WTO et peut inclure du texte et des variables de produit.
Lorsque la situation est déclenchée, un message KO41041I est émis dans la console de l'opérateur dans le format suivant :
L'événement de situation est identifié dans le message multiligne par situation_event_id. situation_name est le nom de la situation et nom_poste est le noeud d'origine associé à l'événement. optional_display_item_value est l'élément d'affichage, s'il est défini pour la situation. Le message est généré lorsque la situation est vraie (T) ou fausse (F). user_supplied_content est le contenu tel que défini dans la commande ZOSWTO . Lorsque la situation est fausse, les valeurs des variables de substitution dans user_supplied_content sont N/A.
Les données de message sont divisées en sections de 70 caractères sur un maximum de cinq lignes consécutives.
Astuce: Si vous utilisez l'automatisation pour réagir à une situation basée sur le message dans la console opérateur, lorsque vous définissez la commande ZOSWTO pour une situation, envisagez d'ajouter des informations d'identification dans user_supplied_content, telles qu'un numéro d'identification unique ou un libellé. Etant donné que chaque situation déclenchée avec une commande ZOSWTO définie génère le message KO41041I, vous devez analyser d'autres détails pour différencier les messages. La possibilité de rechercher des informations uniques et connues peut aider à identifier rapidement les messages d'une situation spécifique.
Par défaut, ZOSWTO utilise le code de routage des options WTO 2 (informations sur l'opérateur) et le code de descripteur 12 (informations importantes). Vous pouvez modifier les valeurs par défaut de ces options en spécifiant les paramètres ZOSWTO_ROUTE_CODE et ZOSWTO_DESCRIPTOR_CODE dans le membre KppENV de RKANPARU, où pp est le code du produit ou du composant OMEGAMON que vous souhaitez mettre à jour. Vous pouvez également remplacer ces valeurs lors de la spécification de la commande ZOSWTO en utilisant le format suivant:
Remarque : Outre la définition de la commande ZOSWTO comme action dans une situation, vous pouvez également utiliser la fonction Take Action de Tivoli Enterprise Portal pour saisir manuellement la commande ZOSWTO, qui nécessite le format suivant pour remplacer le code d'acheminement et le code du descripteur :
En utilisant l'une des méthodes disponibles (telles que,, tacmd CLI), créez une situation qui inclut la commande Take Action ZOSWTO et définit le contenu (y compris les variables de produit) qui doit apparaître dans le message OMC.
Lorsque la situation se produit, le message KO41041I, avec un maximum de cinq lignes consécutives, est écrit sur la console opérateur.
Exemple
Cet exemple explique comment utiliser la commande ZOSWTO pour écrire un message dans la console pour une situation spécifique détectée par IBM OMEGAMON for Messaging on z/OS, IBM MQ Monitoring Agent. Cet exemple fournit des étapes de mise en œuvre pour l'interface utilisateur 3270 améliorée et le Tivoli Enterprise Portal, ainsi que des exemples de messages de sortie.
Le scénario de cet exemple consiste à détecter quand l'événement MQ pour la longueur élevée de la file d'attente s'est produit et, lorsque cet événement se produit, à envoyer un message à la console opérateur qui fournit le nom du gestionnaire de files d'attente MQ , le nom de la ressource MQ (nom de la file d'attente) et le libellé MQ01W, qui sera utilisé pour l'identification des messages dans le journal.
Astuce: L'utilisation d'un libellé est facultative et peut simplifier l'automatisation s'il existe plusieurs situations à l'aide de la commande ZOSWTO .
La commande ZOSWTO suivante contient le libellé, le texte personnalisé et les variables de produit appropriées à signaler à la console opérateur pour cet événement:
ZOSWTO MQ01W Event queue depth high for Qmgr:&{Current_Events.Reporting_MQ_Manager_Name}; Queue:&{Current_Events.Resource_Name}
Pour associer ce message WTO à la situation, vous devez le définir en tant que commande système d'action dans la situation. Les sections suivantes expliquent comment procéder dans l'interface utilisateur 3270 améliorée et dans le Tivoli Enterprise Portal Des exemples de messages générés dans la console de l'opérateur sont également fournis.
Définition de la commande ZOSWTO à l'aide de l'interface utilisateur 3270 améliorée
Utilisez l'onglet Formule de l'éditeur de situations pour définir les critères de la situation, comme illustré dans la figure suivante:
Figure 1 : Définition de la formule de situation à l'aide de l'interface utilisateur 3270 améliorée
Notez ce qui suit dans cet exemple:
Un élément affiché est défini de sorte qu'il devienne vrai pour chaque file d'attente possible. L'élément affiché sera inclus dans le message WTO (en tant que <optional_display_item_value>) lorsque l'événement de situation se produit.
Utilisez ensuite l'onglet Action de l'éditeur de situations pour entrer la commande ZOSWTO en tant que commande système. Vous devez entrer S en regard de Commande pour entrer la valeur complète de la commande, comme illustré dans les figures suivantes:
Figure 2. Définition de l'action de situation à l'aide de l'interface utilisateur 3270 amélioréeFigure 3 Définition de la commande ZOSWTO à l'aide de l'interface utilisateur 3270 améliorée
Définir la commande ZOSWTO à l'aide de Tivoli Enterprise Portal
Utilisez l'onglet Formule de l'éditeur de situations pour définir les critères de la situation. Pour cet exemple, la formule est l'événement == Queue Depth High , comme illustré dans la figure suivante.
Remarque: Cette situation comporte également un élément d'affichage défini de sorte qu'il devienne vrai pour chaque file d'attente possible. L'élément affiché sera inclus dans le message WTO (en tant que <optional_display_item_value>) lorsque l'événement de situation se produit.
Figure 4 Définition de la formule de situation à l'aide de Tivoli Enterprise Portal
Ensuite, dans l'onglet Action de l'éditeur de situations, entrez la commande ZOSWTO en tant que commande système, comme illustré dans la figure suivante:
Figure 5. Définition de la commande ZOSWTO à l'aide de Tivoli Enterprise Portal
Afficher les messages WTO dans la console opérateur
Lorsque cette situation se produit (c'est-à-dire lorsque la situation est true), le message WTO suivant apparaît dans la console opérateur:Figure 6 Exemple de message WTO lorsque la situation est vraie
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
Lorsque cette situation est effacée (c'est-à-dire lorsque la situation est false), le message WTO suivant apparaît dans la console opérateur:Figure 7 Exemple de message WTO lorsque la situation est fausse
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
Etape suivante
Eventuellement, en fonction de l'occurrence ou de la résolution de l'événement de situation, vous pouvez analyser le message WTO pour piloter l'automatisation ou avertir le programmeur système z/OS de la situation.
Notez ce qui suit dans cet exemple:
