Dieser Abschnitt behandelt folgende Themen:
Siehe auch Standardwerte-Prüfung für BS2000.
Um ein Ereignis zu definieren, das bei Beendigung des Jobs geprüft
werden soll:
Drücken Sie PF2 (Add) im Bildschirm Job-Ende-Prüfung und -Aktionen.
Das Fenster Ereignis-Definition hinzufügen erscheint (Beispiel):
+---------------------------------------------------------------------+ ! ! ! Ereignis-Definition hinzufuegen ! ! BS2000 ! ! Ereignistyp ==> R R Exit J Spezielles ! ! S String Job-Ereignis ! ! U Benutzerschalter A Zusaetzliches ! ! V Job-Variable Job-ok, Job-nicht-ok ! ! ! ! Exit ==> BS2EJC01 in NAT Bibliothek ==> EOR531U_ Exit-Modus ==> _ ! ! ! ! String ==> ______________________________ fehlend ==> ! ! in Datei ==> ____________________________________________________ ! ! (Optional) Lese-Passwort ==> ! ! definiert ==> nein ! ! Benutzer-Schalter ==> 0_ von BS2000 Ben.-ID ==> ________ ! ! ! ! Auftreten des Ereignisses bedeutet OK oder NICHT OK ==> __ ! ! ! ! Enter-PF1---PF2---PF3-----------PF5-------------------------------- ! ! Help Add End Save ! +---------------------------------------------------------------------+ |
Weitere Informationen siehe Felder: Ereignis-Definition hinzufügen (BS2000).
Nachdem Sie das Ereignis definiert haben, haben Sie folgende Optionen:
Wenn Sie ein Ereignis vom Typ R definiert haben, können Sie den User Exit mit dem Entire Operations-Editor bearbeiten.
Dazu geben Sie im Bildschirm
Job-Ende-Prüfung und
-Aktionen das Zeilenkommando E
im Feld vor dem Ereignis ein.
Drücken Sie Enter.
Weitere Informationen siehe User Exits für Job-Ende-Prüfungen oder Aktionen erstellen oder bearbeiten.
Sie können eine beliebige Anzahl von Ereignissen zu jedem beliebigen Job definieren.
Dazu drücken Sie PF2 (Add), um die aktuelle Definition zu speichern und die Felder zu leeren, so dass Sie ein weiteres Ereignis definieren können.
Drücken Sie PF5 (Save), um die Ereignis-Definition(en) zu speichern.
Drücken Sie PF3 (End), um die Funktion zu beenden.
Der Bildschirm Job-Ende-Prüfung und -Aktionen erscheint. Die neuen Ereignisse werden auf diesem Bildschirm aufgelistet.
Das Fenster Ereignis-Definition hinzufügen enthält folgende Eingabefelder:
| Feld | Bedeutung | ||||||
|---|---|---|---|---|---|---|---|
| Ereignistyp | Typ des zu prüfenden Ereignisses.
Mögliche Werte:
|
||||||
| Exit | Für ein Ereignis vom Typ R (User Exit):
Name des User Exit zur Job-Ende-Prüfung, die bei Beendigung des Jobs laufen soll. Entire Operations führt vor Ausführung des Exits mit der Job-Start-Benutzerkennung einen ESY-Logon auf den Job-Ausführungsknoten durch. Siehe auch User Exits für Job-Ende-Prüfungen oder Aktionen erstellen oder bearbeiten. |
||||||
| in NAT Bibliothek | Für ein Ereignis vom Typ R (User Exit):
Natural-Bibliothek, in der sich der User Exit befindet. Diese Bibliothek sollte von der Entire Operations-Systembibliothek verschieden sein. |
||||||
| Exit-Modus |
|
||||||
| String | Für ein Ereignis vom Typ S (String):
Geben Sie die betreffende Zeichenkette an, auf die hin Entire Operations den SYSOUT des Jobs prüfen soll. Siehe auch Beispiel eines Ereignisses vom Typ S (BS2000). |
||||||
| fehlend | Für ein Ereignis vom Typ S (String):
Zeichenkette fehlt. Wenn Sie hier
|
||||||
| in Datei | Für ein Ereignis vom Typ S (String):
Wenn Sie dieses Feld leer lassen, sucht Entire Operations nach der Zeichenkette in der SYSOUT-Sammeldatei, die vom Entire Operations-Monitor erstellt wurde. Sie können an dieser Stelle eine andere Datei eingeben, in der stattdessen gesucht werden soll. Für den Dateinamen wird eine Symbolersetzung (aus der aktiven Symboltabelle) ausgeführt, falls er das Aktivierungsfluchtzeichen enthält. Der aktualisierte Dateiname wird in der aktiven Datenbank gespeichert. |
||||||
| (Optional) Lese-Passwort | Das Lese-Passwort für die Datei. | ||||||
| Benutzer-Schalter | Für ein Ereignis vom Typ U (Benutzerschalter):
Es muss ein gültiger BS2000-Benutzerschalter definiert werden. (Bereich: 0 bis 31). |
||||||
| von BS2000 Ben.-ID | Für ein Ereignis vom Typ U (Benutzerschalter):
Die BS2000 Benutzerkennung des Benutzerschalters. |
||||||
| Auftreten des Ereignisses bedeutet OK oder NICHT OK | Geben Sie den Status der Ereignisprüfung an, wenn
das definierte Ereignis auftritt.
Mögliche Werte:
|
Anmerkung:
Die Option "Ändern" (Zeilenkommando
M) steht nur auf der Ereignis-Ebene (Jobstep) zur
Verfügung.
Um eine vorhandene Ereignis-Definition zu ändern:
Geben Sie im Bildschirm Job-Ende-Prüfung und
-Aktionen das Zeilenkommando M
im Feld vor der zu ändernden Ereignis-Definition ein.
Drücken Sie Enter.
Der Bildschirm Ereignis-Definition ändern erscheint mit den aktuellen Werten für das Ereignis.
Sie können die Werte durch Überschreiben ändern.
Drücken Sie PF5 (Save), um die Änderungen zu speichern
Drücken Sie PF3 (End), um die Funktion zu beenden.
Der Bildschirm Job-Ende-Prüfung und -Aktionen erscheint.
Es folgen Beispiele für Ereignis-Definitionen vom Typ U (Benutzerschalter), Typ V (Job-Variable) und Typ J(Spezielles Ereignis).
Beispiele vom Typ R (User Exit) und Typ S (Zeichenketten-Suche) finden Sie im Abschnitt Ereignis-Definition für einen z/OS- oder z/VSE-Job anlegen/ändern.
+---------------------------------------------------------------------+ ! ! ! Ereignis-Definition hinzufuegen ! ! BS2000 ! ! Ereignistyp ==> S R Exit J Spezielles ! ! S String Job-Ereignis ! ! U Benutzerschalter A Zusaetzliches ! ! V Job-Variable Job-ok, Job-nicht-ok ! ! ! ! Exit ==> ________ in NAT Bibliothek ==> ________ Exit-Modus ==> _ ! ! ! ! String ==> ABEND_________________________ fehlend ==> _ ! ! in Datei ==> ____________________________________________________ ! ! (Optional) Lese-Passwort ==> ! ! definiert ==> nein ! ! Benutzer-Schalter ==> 0_ von BS2000 Ben.-ID ==> ________ ! ! ! ! Auftreten des Ereignisses bedeutet OK oder NICHT OK ==> __ ! ! ! ! Enter-PF1---PF2---PF3-----------PF5-------------------------------- ! ! Help Add End Save ! +---------------------------------------------------------------------+ |
| Feld | Bedeutung |
|---|---|
| String | Diese Zeichenkette wird in SYSOUT oder jeder anderen definierten
Datei gesucht. Wenn die Zeichenkette gefunden wurde, ist das Ereignis erfüllt.
Wenn die Zeichenkette mindestens ein Leerzeichen am Anfang, der Mitte oder am
Ende enthält, muss sie in Hochkommas gesetzt werden. Zum Beispiel:
' führende Leerzeichen' Die Zeichenkette darf Symbole enthalten. Symbole mit Aktivierungsfluchtzeichen werden bei der Job-Aktivierung ersetzt. Symbole mit Startfluchtzeichen werden bei der Job-Ende-Prüfung ersetzt. Fehlende Symbole verursachen einen permanenten Aktivierungsfehler oder einen permanenten Job-Ende-Prüfungsfehler. |
| fehlend | Wenn Sie die Zeichenketten-Suche nicht nutzen wollen, können sie
hier ein Y
eingeben.
|
| in Datei | Wenn Sie hier eine BS2000-Datei angeben, wird sie nach der
gesuchten Zeichenkette durchgeschaut. Die Symbolersetzung ist für jeden Teil
des Dateinamens möglich:
Ist dieses Feld leer, wird die SYSOUT abgesucht. Symbolersetzung ist hier möglich. Das vorliegende Fluchtzeichen wird genutzt. |
| (Optional) Lese-Passwort | Wenn die Datei zum Lesen passwortgeschützt ist, geben Sie an dieser Stelle das Passwort ein. |
+---------------------------------------------------------------------+ ! EOR0201 - Objekt geaendert ! ! Ereignis-Definition hinzufuegen ! ! BS2000 ! ! Ereignistyp ==> U R Exit J Spezielles ! ! S String Job-Ereignis ! ! U Benutzerschalter A Zusaetzliches ! ! V Job-Variable Job-ok, Job-nicht-ok ! ! ! ! Exit ==> ________ in NAT Bibliothek ==> ________ Exit-Modus ==> _ ! ! ! ! String ==> ______________________________ fehlend ==> _ ! ! in Datei ==> _____________________________________________________ ! ! (Optional) Lese-Passwort ==> ! ! definiert ==> nein ! ! Benutzer-Schalter ==> 12 von BS2000 Ben.-ID ==> ________ ! ! ! ! Auftreten des Ereignisses bedeutet OK oder NICHT OK ==> OK ! ! ! ! Enter-PF1---PF2---PF3-----------PF5-------------------------------- ! ! Help Add End Save ! +---------------------------------------------------------------------+ |
Das Ereignis ist ok, wenn der Benutzerschalter 12 bei
Beendigung des Jobs eingeschaltet ist.
| Feld | Bedeutung |
|---|---|
| Benutzerschalter | Ein gültiger BS2000-Benutzerschalter. Erlaubte
Werte: 0 bis 31.
|
| BS2000 Benutzer-ID | Eine gültige, definierte Logon-Benutzer-ID.
Anmerkung: |
+--------------------------------------------------------------------+ ! ! ! Ereignis-Definition: Pruefung einer Job-Variable ! ! BS2000 ! ! Wenn der Wert der Variable ! ! $NOP.JV.1_____________________________________________ ! ! an Position 1__ mit Laenge 10_ mit Format A ! ! ist EQ ! ! HUGO____________________________________________________________ ! ! ________________________________________________________________ ! ! ________________________________________________________________ ! ! ________________________________________________________________ ! ! (Optional) Lese-Passwort ==> ! ! definiert ==> nein ! ! Die erfolgr. Pruefung bedeutet OK oder NICHT OK ==> OK ! ! Enter-PF1---------PF3-----------PF5-------------------- ! ! Help End Save ! +--------------------------------------------------------------------+ |
Das Ereignis ist OK, wenn die Job-Variable $NOP.JV.1 als
Ergebnis "HUGO" an der Position 1 mit Länge 10 in alphanumerischem
Format (A) enthält.
| Feld | Bedeutung | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Wenn der Wert der Variable | Geben Sie den Namen einer gültigen BS2000
Job-Variable ein.
Wenn die Job-Variable ohne eine explizite Benutzerkennung angegeben wird, wird die Jobstandard-Benutzerkennung von BS2000 als Präfix benutzt. Symbolersetzung im Namen wird durchgeführt, wenn der Name mindestens einmal das Aktivierungsfluchtzeichen enthält. |
||||||||||||
| an Position | Geben Sie die Position der zu überprüfenden
Job-Variablen-Teil-Zeichenkette ein.
Mögliche Werte: 1 bis 253. |
||||||||||||
| mit Länge | Geben Sie die Länge der zu überprüfenden
Job-Variablen-Teil-Zeichenkette ein.
Mögliche Werte: 1 bis 253. |
||||||||||||
| mit Format | Geben Sie das Format ein, in dem die
Job-Variablen-Teil-Zeichenkette gegen die Vergleichs-Zeichenkette geprüft
werden soll.
Mögliche Werte:
|
||||||||||||
| ist | Dies ist der Vergleichsoperator. Geben Sie einen
logischen Operator für den Vergleich der definierten BS2000
Job-Variablen-Teil-Zeichenkette gegen die nachfolgende Vergleichs-Zeichenkette
ein.
Mögliche Werte:
|
||||||||||||
| (Vergleichs-Zeichenkette) | Geben Sie die Zeichenkette oder das Feld ein,
die/das mit der Job-Variablen-Zeichenkette verglichen werden soll. Die
Zeichenketten werden in dem definierten Format miteinander verglichen.
Der Inhalt dieses Feldes wird mit dem Teilstring der Job-Variable verglichen, oder er wird in den Teilstring der Job-Variable eingesetzt. Der Vergleich wird im definierten Format ausgeführt. Symbolersetzung im Namen wird durchgeführt, wenn der Name mindestens einmal das Aktivierungsfluchtzeichen enthält. |
||||||||||||
| (Optional) Lese-Passwort | Wenn die Job-Variable zum Lesen passwortgeschützt ist, geben Sie an dieser Stelle das Passwort ein. |
Um eine Job-Variable in BS2000 hinzuzufügen oder zu ändern:
Geben Sie im Bildschirm
Job-Ende-Prüfung und
-Aktionen das Zeilenkommando J
im Feld vor der zu ändernden Ereignis-Definition ein.
Drücken Sie Enter.
Der Bildschirm Job-Variable ändern erscheint mit den aktuellen Werten (Beispiel):
+--------------------------------------------------------------------+ ! ! ! Job ok beendet ! ! Job-Variable aendern ! ! ! ! Setze Inhalt der Job-Variable ! ! $NOP.JV.2_____________________________________________ ! ! an Position 11_ mit Laenge 10_ mit Format A ! ! auf ! ! set-jv__________________________________________________________ ! ! ________________________________________________________________ ! ! ________________________________________________________________ ! ! ________________________________________________________________ ! ! (Optional) Schreib-Passwort ==> ! ! definiert ==> nein ! ! Ausfuehren, falls temp. Dummy ==> _ ! ! ! ! Enter--PF1-----PF3-------PF5--------------PF9------------------- ! ! Help End Save Delete ! +--------------------------------------------------------------------+ |
Sie können die Werte durch Überschreiben ändern.
Falls auf Job-Ebene noch keine Job-Variable definiert wurden, sind die Felder leer. Sie können eine Job-Variable setzen, indem Sie hier die Werte eingeben.
Drücken Sie PF5 (Save), um die Eingaben zu speichern.
Drücken Sie PF3 (End), um die Funktion zu beenden.
Der Bildschirm Job-Ende-Prüfung und -Aktionen erscheint.
Anmerkung:
Symbolersetzung im Namen wird durchgeführt, wenn der Name mindestens
einmal das Aktivierungsfluchtzeichen enthält.
| Feld | Bedeutung | ||||
|---|---|---|---|---|---|
| Setze Inhalt der Job-Variable | Geben Sie den Namen einer gültigen BS2000 Job-Variablen ein. Wenn die Job-Variable ohne eine explizite Benutzerkennung angegeben wird, wird die Jobstandard-Benutzerkennung von BS2000 als Präfix benutzt. Symbolersetzung im Namen wird durchgeführt, wenn der Name mindestens einmal das Aktivierungsfluchtzeichen enthält. Symbolersetzung wird durchgeführt, wenn das Feld das Aktivierungsfluchtzeichen wenigstens einmal enthält. | ||||
| an Position | Geben Sie die Position der zu
überprüfenden Job-Variablen-Teil-Zeichenkette ein. Mögliche Werte:
1 bis 253.
|
||||
| mit Länge | Geben Sie die Länge der zu
überprüfenden Job-Variablen-Teil-Zeichenkette ein. Mögliche Werte:
1 bis 253.
|
||||
| mit Format | Geben Sie das Format ein, in dem die
Job-Variablen-Teil-Zeichenkette gegen die Vergleichs-Zeichenkette geprüft
werden soll.
Mögliche Werte:
|
||||
| auf | Geben Sie die Zeichenkette oder das Feld ein, die/das als Job-Variable oder als Unter-Zeichenkette der Job-Variablen gesetzt werden soll. | ||||
| (Optional) Schreib-Passwort | Wenn die Job-Variable zum Schreiben passwortgeschützt ist, geben Sie an dieser Stelle das Passwort ein. | ||||
| definiert | Dies ist ein reines Informationsfeld. Es zeigt an, ob ein Schreib-Passwort definiert ist oder nicht. | ||||
| Ausführen, falls temp. Dummy | Wenn hier
Y (ja) oder N (nein) angegeben wird, wird die
Job-Ende-Aktion entsprechend dieser Definition ausgeführt, falls der Job als
temporärer Dummy-Job ausgeführt wurde. Falls dieses Feld leer ist,
gelten die Standardeinstellungen für die Aktion.
|
Die PF-Tasten im unteren Bereich des Bildschirms Job-Variable ändern sind mit folgenden objektspezifischen Funktionen belegt:
| Taste | Name | Funktion | Weitere Informationen siehe: |
|---|---|---|---|
| PF9 | Delete | Die vollständige Job-Variablendefinition löschen. | - |
Informationen zu PF-Tasten, die mit Standard-Funktionen belegt sind, siehe Benutzung von PF-Tasten im Abschnitt Entire Operations-Bildschirme.
Diese Funktion ermöglicht es Ihnen, spezielle Ereignisse zu definieren, die während der Job-Ausführung eintreten können. Ein solches Ereignis bedeutet immer "Job nicht ok".
03.11.15 ***** Entire Operations ***** 15:10:27
Eigentuemer EXAMPLE Netzwerk B60-FLOW Version Job JOB-05
Jobende-Pruefung + Aktionen BS2000 Lauf Datum
------------------------------------------------------------------------------
K Aktion Step wird geprueft auf bedeutet AA
m JIR Job-Ausfuehrung unterbrochen n.ok
+-------------------------------------------------+
| |
| Ereignis-Definition: Spezielles Ereignis |
| BS2000 |
| |
| Ereignis ==> JIR |
| Job-Ausfuehrung unterbrochen |
*********** | | **************
_ C | Das Eintreten dieses Ereignisses bedeutet |
_ | immer 'Job nicht ok'. |
----------- | | --------------
A Aktiv. C | Enter-PF1-------PF3--------PF5--------------- | endern O And.
P Beschreib | Help End Save | -Exit Y Symbol
+-------------------------------------------------+
Kommando => ____________________________________________________________
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Add End Save Up Down Menu |
Feld Ereignis: JIR = Job-Ausführung unterbrochen.
Bei Systemabbruch während der Ausführung des Jobs tritt dieses Ereignis ein. Gilt immer dann, wenn ein Job nicht auf LOGOFF (Job ordnungsgemäß beendet) bzw. ABEND (Job mit Fehler abgebrochen) gelaufen ist. Die hierfür definierten Aktionen werden nach Monitor-Start ausgeführt.