Ereignis-Definition für UNIX- oder Windows-Job anlegen/ändern

Dieser Abschnitt behandelt folgende Themen:

Siehe auch Standardwerte-Prüfung für UNIX und Windows .


Bildschirm Ereignis-Definitionen hinzufügen aufrufen

Beginn der AnweisungslisteUm ein Ereignis zu definieren, das bei Beendigung des Jobs geprüft werden soll:

  1. Drücken Sie PF2 (Add) im Bildschirm Job-Ende-Prüfung und -Aktionen.

    Das Fenster Ereignis-Definition hinzufügen erscheint:

    +---------------------------------------------------------------------+         
    !                                                                     !         
    !                 Ereignis-Definition hinzufuegen                     !         
    !                                                            Linux    !         
    !  Ereignistyp ==> _  X  Exit-Code          J  Spezielles             !      
    !                     R  Exit                  Job-Ereignis           !         
    !                     S  String             A  Zusaetzliches          !         
    !                                              Job-ok, Job-nicht-ok   !         
    !                                                                     !         
    !  Exit-Code ist ==> __ als ==> 0___                                  !   
    !                                                                     !         
    !  Exit ==> ________ in NAT Bibliothek ==> ________ Exit-Modus ==> _  !
    !                                                                     !         
    !  String   ==> ______________________________       fehlend ==> _    !   
    !  in Datei ==> _____________________________________________________ !      
    !                                                                     !         
    !                                                                     !         
    !  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 (UNIX, Windows).

  2. Nachdem Sie das Ereignis definiert haben, haben Sie folgende Optionen:

    • Wenn Sie ein Ereignis vom Typ R definiert haben, können Sie 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 drücken.

      Weitere Informationen siehe User Exits für Job-Ende-Prüfungen oder Aktionen erstellen oder bearbeiten .

    • Sie können eine beliebige Anzahl von Ereignissen für jeden beliebigen Job definieren.

      Dazu drücken Sie PF2 (Add), um die Definition zu speichern, und die Felder zu leeren, so dass ein weiteres Ereignis hinzugefügt werden kann.

      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.

Felder: Ereignis-Definition hinzufügen (UNIX, Windows)

Das Fenster Ereignis-Definition hinzufügen enthält folgende Eingabefelder:

Feld Bedeutung
Ereignistyp Typ des zu prüfenden Ereignisses.

Mögliche Werte:

  • A - Zus. Job ok, nicht ok
    Zusätzliche Definition für "Job ok" bzw. "Job nicht ok".

  • R - User Exit
    Der SYSOUT des Jobs soll von einer User Exit geprüft werden.

  • X - Exit Code
    Exit-Code-Prüfung. Diese Funktion ermöglicht es Ihnen, den Exit- Code eines UNIX- oder Windows-Jobs zu prüfen. Das Ergebnis des Ereignisses resultiert aus dem Exit-Code eines Skriptes unter UNIX oder Windows, oder aus dem Exit-Code eines ausführbaren Programmes unter Windows. Bitte beachten Sie, dass eine Standardprüfung für den Exit-Code in den Entire Operations Standardwerten definiert werden kann. Siehe auch Fehlerbehandlung bei der Prüfung von Exit Codes.

  • S - String
    Ausprägung eines spezifischen Strings in Job-SYSOUT.

    Siehe auch Beispiel eines Ereignisses vom Typ S (UNIX und Windows).

  • J - Spezielles Job-Ereignis
    Spezielles Ereignis, das während der Job-Ausführung auftreten kann.

Exit  Für ein Ereignis vom Typ R (User Exit):

Name des User Exit zur Job-Ende-Prüfung, der 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
leer Der Exit wird synchron ausgeführt (Standardwert).
A Der Exit wird asynchron ausgeführt (in einem Natural Task).
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.

Die Suchzeichenkette 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 führen zu einem permanenten Aktivierungsfehler bzw. einem permanenten Job-Ende-Prüfungsfehler.

fehlend Für ein Ereignis vom Typ S (String): Wenn Sie hier Y eingeben: das Ereignis tritt ein, wenn der String nicht gefunden wird.
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.
Auftreten des Ereignisses bedeutet OK oder NICHT OK Geben Sie den Status der Ereignis-Prüfung an, wenn das definierte Ereignis auftritt.

Mögliche Werte:

OK Prüfung ok.
NO Prüfung nicht ok.
leer Kein Einfluß auf das Job-Ergebnis.

Fehlerbehandlung bei der Prüfung von Exit Codes

Wenn ein Lesefehler bei einer SYSOUT-Datei entsteht, während der Monitor gerade den Exit Code zu lesen versucht, wird dieser als ein vorübergehender Fehler behandelt. Der Monitor versucht zehnmal, den Exit Code zu lesen. Die Zeit zwischen den Versuchen ist gleich der Monitor-Wartezeit. Falls nach diesen 10 Versuchen kein Erfolg zu verzeichnen ist, wird der Job auf den Status "permamenter Fehler" gesetzt.

Ereignis-Definition für UNIX- oder Windows-Job ändern

Anmerkung:
Die Option "Ändern" (Zeilenkommando M) steht nur auf der Ereignis-Ebene zur Verfügung.

Beginn der AnweisungslisteUm eine vorhandene Ereignis-Definition zu ändern:

  1. 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 erscheint mit den aktuellen Werten für das Ereignis. Sie können die Werte durch Überschreiben ändern.

  2. Drücken Sie PF5 (Save), um die Änderung zu speichern.

  3. Drücken Sie PF3 (End), um die Funktion zu beenden.

    Der Bildschirm Job-Ende-Prüfung und -Aktionen erscheint.

Beispiel eines Ereignisses vom Typ S (UNIX und Windows)

+---------------------------------------------------------------------+         
! EOR1213 - Bitte Such-String eingeben                                !         
!                 Ereignis-Definition hinzufuegen                     !         
!                                                            Linux    !         
!  Ereignistyp ==> S  X  Exit-Code          J  Spezielles             !      
!                     R  Exit                  Job-Ereignis           !         
!                     S  String             A  Zusaetzliches          !         
!                                              Job-ok, Job-nicht-ok   !         
!                                                                     !         
!  Exit-Code ist ==> __ als ==> 0___                                  !   
!                                                                     !         
!  Exit ==> ________ in NAT Bibliothek ==> ________ Exit-Modus ==> _  !
!                                                                     !         
!  String   ==> error occurred________________       fehlend ==> _    !   
!  in Datei ==> _____________________________________________________ !      
!                                                                     !         
!                                                                     !         
!  Auftreten des Ereignisses bedeutet OK oder NICHT OK ==> __         !      
!                                                                     !         
! Enter-PF1---PF2---PF3-----------PF5-------------------------------- !         
!       Help  Add   End           Save                                !         
+---------------------------------------------------------------------+

Felder: Zeichenfolge-Suche (UNIX und Windows)

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 Anführungszeichen gesetzt werden. Zum Beispiel:
'    leading blanks'

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:
  • Durch die Aktivierung der Ersetzung - einmalig zur Aktivierungszeit.

  • Durch die vorliegende Ersetzung - während der Job-Ende-Prüfung.

Ist dieses Feld leer, wird die Datei SYSOUT abgesucht. Symbolersetzung ist hier möglich. Das vorliegende Fluchtzeichen wird genutzt.