Wenn der Aktionsbefehl ZOSWTO für eine Situation definiert ist, schreibt er eine mehrzeilige WTO-Nachricht (Write-to-Operator) an die Bedienerkonsole, wenn die Situation auftritt. Die mehrzeilige WTO wird auf der z/OS (TEMS), mit der ein Agent verbunden ist, oder auf einer z/OS (TEMA) ausgestellt. Die Nachricht wird erzeugt, wenn die Situation wahr oder falsch ist. Alle Daten, die auf den Befehlsnamen folgen, werden in der mehrzeiligen Nachricht angezeigt.
Wenn Sie den Befehl zum Erstellen einer Situation verwenden möchten, schließen Sie den Aktionsbefehl ZOSWTO im folgenden Format ein:
ZOSWTO user_supplied_content
Dabei definiert user_supplied_content den Inhalt, der in die WTO-Nachricht eingeschlossen werden soll, und kann Text-und Produktvariablen enthalten.
Wenn die Situation ausgelöst wird, wird die Meldung KO41041I in der Bedienerkonsole in folgendem Format ausgegeben:
Das Situationsereignis wird in der mehrzeiligen Nachricht durch situation_event_idangegeben. situationsname ist der Name der Situation und knotenname ist der Ursprungsknoten im Zusammenhang mit dem Ereignis. optional_display_item_value ist das Anzeigeelement, wenn eines für die Situation definiert ist. Die Nachricht wird erzeugt, wenn die Situation wahr (T) oder falsch (F) ist. user_supplied_content ist der Inhalt, wie er im Befehl ZOSWTO definiert ist. Wenn die Situation falsch ist, lauten die Werte der Substitutionsvariablen in user_supplied_contentN/A.
Die Nachrichtendaten werden in maximal fünf aufeinanderfolgende Zeilen in 70 Zeichen unterteilt.
Tipp: Wenn Sie die Automatisierung verwenden, um auf eine Situation zu reagieren, die auf der Nachricht in der Bedienerkonsole basiert, sollten Sie beim Definieren des Befehls ZOSWTO für eine Situation in Betracht ziehen, Identifikationsinformationen wie eine eindeutige Identifikationsnummer oder eine Bezeichnung in user_supplied_contenthinzuzufügen. Da jede ausgelöste Situation mit einem definierten ZOSWTO -Befehl die Nachricht KO41041Ierzeugt, müssen Sie weitere Details analysieren, um die Nachrichten zu unterscheiden. Die Möglichkeit, nach eindeutigen, bekannten Informationen zu suchen, kann helfen, die Nachrichten für eine bestimmte Situation schnell zu identifizieren.
Standardmäßig verwendet ZOSWTO den Routing-Code 2 (Operatorinformationen) und den Deskriptorcode 12 (wichtige Informationen) für WTO-Optionen. Sie können die Standardwerte für diese Optionen ändern, indem Sie die Parameter ZOSWTO_ROUTE_CODE und ZOSWTO_DESCRIPTOR_CODE im Member KppENV von RKANPARUangeben, wobei pp der Code für das OMEGAMON-Produkt oder die Komponente ist, das bzw. die Sie aktualisieren wollen. Sie können diese Werte auch überschreiben, wenn Sie den Befehl ZOSWTO im folgenden Format angeben:
Hinweis: Zusätzlich zur Definition des ZOSWTO als Aktion in einer Situation können Sie auch die Tivoli Enterprise Portal "Take Action" verwenden, um den ZOSWTO manuell einzugeben, was das folgende Format erfordert, um den Routing-Code und den Deskriptor-Code zu überschreiben:
Erstellen Sie mit einer der verfügbaren Methoden (z. B.,, tacmd CLI) eine Situation, die den Befehl Take Action ZOSWTO enthält und den Inhalt (einschließlich Produktvariablen) definiert, der in der WTO-Nachricht erscheinen soll.
Wenn die Situation eintritt, wird die Nachricht KO41041Imit maximal fünf aufeinanderfolgenden Zeilen in die Bedienerkonsole geschrieben.
Beispiel
In diesem Beispiel wird beschrieben, wie der Befehl ZOSWTO zum Schreiben einer Nachricht an die Konsole für eine bestimmte Situation verwendet wird, die von IBM OMEGAMON for Messaging on z/OS, IBM MQ Monitoring Agent erkannt wird. Dieses Beispiel enthält Implementierungsschritte sowohl für die erweiterte 3270-Benutzerschnittstelle als auch für das Tivoli Enterprise Portal und bietet außerdem Beispiel-Ausgabemeldungen.
Das Szenario für dieses Beispiel soll erkennen, wann das MQ -Ereignis für 'Warteschlangenlänge hoch' aufgetreten ist, und, wenn dieses Ereignis auftritt, eine Nachricht an die Bedienerkonsole ausgeben, die den Namen des MQ -Warteschlangenmanagers, den Namen der MQ -Ressource (Warteschlangenname) und die Bezeichnung MQ01Wangibt, die für die Nachrichten-ID im Protokoll verwendet wird.
Tipp: Die Verwendung einer Bezeichnung ist optional und kann die Automatisierung vereinfachen, wenn mehrere Situationen mit dem Befehl ZOSWTO auftreten.
Der folgende ZOSWTO -Befehl enthält die Bezeichnung, den angepassten Text und die entsprechenden Produktvariablen, die an die Bedienerkonsole für dieses Ereignis gemeldet werden:
ZOSWTO MQ01W Event queue depth high for Qmgr:&{Current_Events.Reporting_MQ_Manager_Name}; Queue:&{Current_Events.Resource_Name}
Um diese WTO-Nachricht der Situation zuzuordnen, müssen Sie sie in der Situation als Aktionssystembefehl definieren. Die folgenden Abschnitte zeigen, wie Sie dies in der erweiterten 3270-Benutzeroberfläche und im Tivoli Enterprise Portal tun können. Es werden auch Beispiele für die erzeugten Nachrichten in der Bedienerkonsole bereitgestellt.
Befehl ZOSWTO mit der erweiterten 3270-Benutzerschnittstelle definieren
Verwenden Sie die Registerkarte Formel im Situationseditor, um die Kriterien für die Situation zu definieren, wie in der folgenden Abbildung dargestellt:
Abb. 1. Situationsformel mit der erweiterten 3270-Benutzerschnittstelle definieren
Beachten Sie Folgendes in diesem Beispiel:
Ein Anzeigeelement wird so festgelegt, dass es für jede mögliche Warteschlange wahr wird. Das Anzeigeelement wird in die WTO-Nachricht (als <optional_display_item_value>) eingeschlossen, wenn das Situationsereignis auftritt.
Verwenden Sie anschließend die Registerkarte 'Aktion' des Situationseditors, um den Befehl ZOSWTO als Systembefehl einzugeben. Sie müssen S neben Befehl eingeben, um den vollständigen Wert des Befehls einzugeben, wie in den folgenden Abbildungen dargestellt:
Abbildung 2: Situationsaktion mit der erweiterten 3270-Benutzerschnittstelle definierenAbb. 3 Befehl ZOSWTO mit der erweiterten 3270-Benutzerschnittstelle definieren
Definieren Sie den Befehl ZOSWTO über das Tivoli Enterprise Portal
Auf der Registerkarte Formel im Situationseditor können Sie die Kriterien für die Situation definieren. Für dieses Beispiel ist die Formel das Ereignis == Queue Depth High , wie in der folgenden Abbildung dargestellt.
Hinweis: Diese Situation verfügt auch über eine Anzeigeelementgruppe, sodass sie für jede mögliche Warteschlange wahr wird. Das Anzeigeelement wird in die WTO-Nachricht (als <optional_display_item_value>) eingeschlossen, wenn das Situationsereignis auftritt.
Abbildung 4. Definieren der Situationsformel mit dem Tivoli Enterprise Portal
Geben Sie anschließend auf der Registerkarte "Aktion" des Situationseditors den Befehl ZOSWTO als Systembefehl ein, wie in der folgenden Abbildung dargestellt:
Abbildung 5. Definieren des ZOSWTO über das Tivoli Enterprise Portal
WTO-Nachrichten in der Bedienerkonsole anzeigen
Wenn diese Situation eintritt (d. h., wenn die Situation wahrist) wird die folgende WTO-Nachricht in der Bedienerkonsole angezeigt:Abbildung 6. Beispiel einer WTO-Nachricht, wenn die Situation wahr ist
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
Wenn diese Situation gelöscht wird (d. h., wenn die Situation falseist), wird die folgende WTO-Nachricht in der Bedienerkonsole angezeigt:Abbildung 7. Beispiel einer WTO-Nachricht, wenn die Situation falsch ist
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
Nächste Schritte
Optional können Sie auf der Basis des Auftretens oder der Auflösung des Situationsereignisses die WTO-Nachricht analysieren, um die Automatisierung zu steuern, oder den z/OS -Systemprogrammierer über die Situation informieren.
Beachten Sie Folgendes in diesem Beispiel:
