Datei-Übergabe an Entire Output Management

Sie können SYSOUT-Dateien und/oder eine oder mehrere Dateien (z.B. Ausgabedateien eines Jobs) an Entire Output Management (NOM) zur Weiterbehandlung der Ausgabe(n) in dieser Umgebung übergeben.

Dieser Abschnitt behandelt folgende Themen:


Grundlegende Erfordernisse für Datei-Übergaben an Entire Output Management

Dieser Abschnitt behandelt grundlegende Erfordernisse für Datei-Übergaben von Entire Operations an Entire Output Management.

  1. In den Start-Parametern für System Automation Tools (SAT) bzw. Entire Operations muss eine NTLFILE-Makro- bzw. LFILE-Definition für die Entire Output Management-Systemdatei eingetragen sein.

    Weitere Informationen siehe Installation und Inbetriebnahme-Dokumentation.

  2. Wenn Entire Output Management (LFILE 206) definiert ist, und wenn der Entire Operations-Monitor die Meldung NAT0082 beim Aufrufen der Entire Output Management API erhält, wird vor dem Neustart des Entire Operations-Task die Meldung NOM Trigger-Schnittstelle nicht aktiv in das Protokoll (Log) geschrieben. Nachfolgende Versuche, SYSOUT an Entire Output Management zu übergeben, werden ignoriert und die Meldung Übergabe an NOM unmöglich ausgegeben.

  3. Wenn eine SYSOUT-Datei oder eine andere Datei nicht an die Entire Output Management API übergeben werden kann, fordert die Entire Output Management API auf, dass ein Job wiederholt werden soll. Prüfen Sie das Entire Operations-Protokoll ("Log") auf ausführlichere Fehlerinformationen.

  4. In Entire Output Management lautet der Bericht-Name EOR-SOUT.

  5. Bezüglich UNIX und Windows siehe SYSOUT-Übergabe von UNIX- und Windows-Knoten an Entire Output Management.

Siehe auch:

Datei-Definition für Entire Output Management anlegen oder ändern

Dieser Abschnitt beschreibt, wie Sie Definitionen für Dateien, die in Entire Output Management verarbeitet werden sollen, anlegen oder ändern können.

Anmerkung:
Die Anzahl der Dateien, die Sie pro Job-Ereignis definieren können, ist auf 10 begrenzt. Wenn Sie mehr als 10 Dateien pro Job definieren wollen, müssen Sie zunächst eine oder mehrere zusätzliche Ereignisdefinitionen "Job ok / Job nicht ok" anlegen, und dort die zusätzlichen Dateien für diese Ereignisse definieren.

Beginn der AnweisungslisteUm eine Datei-Definition für Entire Output Management anzulegen oder zu ändern:

  1. Markieren Sie im Dialog Verwaltung Jobs einen Job und wählen Sie das Register EOJ-Überprüfung. Siehe auch Register EOJ-Überprüfung aufrufen im Abschnitt Job-Ende-Prüfung und -Aktionen verwalten.

  2. Wählen Sie die Schaltfläche Neu, um eine neue Job-Ende-Aktion anzulegen.

    Oder markieren Sie eine vorhandene EOJ-Definition, die für Entire Output Management definiert ist (gekennzeichnet durch den Buchstaben T in der Spalte Aktion), und wählen Sie die Schaltfläche Ändern

    Der Dialog Neu hinzufügen EOJ-Überprüfung wird angezeigt.

  3. Wählen Sie die Schaltfläche Neu, um eine neue Datei-Definition anzulegen, bzw. wählen Sie die Schaltfläche Ändern bei einer in der Tabelle im Fenster enthaltenen Datei-Definition.

  4. Wählen Sie die Schaltfläche Neu, um eine Job-Ende-Überprüfung zu definieren. Oder markieren Sie eine vorhandene Dateidefinition, und wählen Sie die Schaltfläche Ändern bei einer in der Tabelle im Fenster enthaltenen Datei-Definition.

    Das Dialogfenster Neu hinzufügen Datei-Definition für Output Management bzw. Ändern Datei-Definition für Output Management wird angezeigt (Beispiel):

    Ändern Dateidefinition für Output Management

    In Abhängigkeit vom Schalter Datei ist definiert durch sind im unteren Bereich des Dialogfensters andere Felder vorhanden.

    Weitere Vorgehensweise siehe:

  5. Wählen Sie das Register Output Management.

  6. Wählen Sie die Schaltfläche OK, um die Eingaben zu speichern.

    Die neue bzw. geänderte Datei wird Entire Output Management zugewiesen.

Weitere Vorgehensweise siehe:

Spool-Datei-Definition

Sie können zur Weiterbehandlung durch Entire Output Management eine Spool-Datei entweder durch Angabe von Spoolfile-Typ und Nummer oder Proc.-Name, Step-Name und DD-Name definieren.

Spoolfile-Typ und Nummer

Beginn der AnweisungslisteUm eine Spool-Datei für Entire Output Management durch "Spoolfile-Typ und Nummer" zu definieren:

  1. Markieren Sie im Dialog Neu hinzufügen Dateidefinition für Output Management bzw. Ändern Dateidefinition für Output Management die Option Spoolfile Typ und Nummer.

    Dateidefinition für Output Management - Spoolfile Typ und Nummer

    Sie können eine Datei des Job-SYSOUT zur Weiterbehandlung durch Entire Output Management definieren. Weitere Informationen siehe Felder: Spool-Datei-Definition.

  2. Bestätigen Sie die Eingaben mit OK.

    Die neue Datei ist damit Output Management zugewiesen.

Proc.-Name, Step-Name und DD-Name

Beginn der AnweisungslisteUm eine Spool-Datei für Entire Output Management durch "Proc.-Name, Step-Name und DD-Name" zu definieren:

  1. Markieren Sie im Dialogfenster Neu hinzufügen Dateidefinition für Output Management bzw. Ändern Dateidefinition für Output Management die Option Proc., Step and DD-Name.

    Dateidefinition für Output Management - Proc. Step and DD-Name

    Sie können eine Datei des Job-SYSOUT zur Weiterbehandlung durch Entire Output Management definieren. Weitere Informationen Sie Felder: Spool-Datei-Definition.

  2. Bestätigen Sie die Eingaben mit OK.

    Die neue Datei ist damit dem Output Management zugewiesen.

Felder: Spool-Datei-Definition

Dieser Abschnitt beschreibt die Felder, die im Dialog Dateidefinition für Output Management vorhanden sind.

Feld Bedeutung
Typ der Spool-Datei Typ der Spool-Datei, zum Beispiel SO für JES SYSOUT.
Nummer der Spool-Datei (bei z/VSE nicht erforderlich)

Die Nummer der Spool-Datei.

Procname PROCNAME, der die Datei kennzeichnet.
Stepname STEPNAME, der die Datei kennzeichnet.
DD name DD Name, der die Datei kennzeichnet.

Weitere Informationen zu Spool-Dateien finden Sie unter Report-Identifikation für JES definieren oder Report-Identifikation für POWER definieren im Abschnitt Attribute eines Reports definieren im Entire Output Management-Benutzerhandbuch.

Parameter-Ausgabedatei

Dieser Abschnitt behandelt folgende Themen:

Fenster: Ausgabedatei

Beginn der AnweisungslisteUm eine Ausgabedatei für Entire Output Management zu definieren:

  1. Markieren Sie im Dialogfenster Neu hinzufügen Dateidefinition für Output Management bzw. Ändern Dateidefinition für Output Management die Option Parameter-Ausgabedatei.

    Bei einem Großrechner-Jobstart-Knoten wird folgendes Fenster angezeigt:

    Dateidefinition für Output Management

    Bei einem UNIX- oder Windows-Jobstart-Knoten wird folgendes Fenster angezeigt:

    Dateidefinition für Output Management (WinUx)

    In diesem Fenster können Sie Dateien, die vom Job erzeugt wurden, für die Übergabe an Entire Output Management definieren.

    Falls der Dateiname das Aktivierungsfluchtzeichen enthält, wird eine Symbolersetzung aus der aktiven Symboltabelle des Jobs ausgeführt.

  2. Bestätigen Sie die Eingaben mit OK.

    Die neue Datei ist damit dem Output Management zugewiesen.

Felder: Ausgabedatei

Feld Bedeutung
Datei Die Datei, die an Entire Output Management übergeben werden soll.

Wenn der Dateiname das Aktivierungsfluchtzeichen enthält, erfolgt eine Symbolersetzung unter Verwendung der aktiven Symboltabelle des Jobs.

Wenn der Dateiname das Jobstartfluchtzeichen enthält, erfolgt eine Symbolersetzung unter Verwendung der aktiven Symboltabelle des Jobs.

Wenn Sie Platzhalterzeichen verwenden, können Sie alle entsprechenden Dateien auf einmal an Entire Output Management übergeben.

CC-Typ Typ der Vorschubsteuerzeichen, siehe Typ der Vorschubsteuerzeichen (CC-Typ).
PName Dieses Feld ist nur für BS2000 relevant.

Geben Sie hier PNAME ein, wenn Sie den Job mittels der PNAME-Option des BS2000-Print-Befehls (/Print ...,PNAME=ADAREP) kennzeichnen möchten.

VolSer, Recfm, Lrecl, Blksize Informationen, die zum Zuweisen der Datei dienen: Datenträgernummer (VolSer) , Satzformat (Recfm), Satzlänge (Lrecl) und Blocklänge (Blksize).

Bei z/VSE sind diese Felder Pflichtfelder.

Ausführen, falls temp. Dummy Wenn Sie dieses Kontrollkästchen markieren bzw. nicht markieren, wird die Job-Ende-Aktion entsprechend dieser Vorgabe ausgeführt bzw. nicht ausgeführt, falls der Job als temporärer Dummy-Job ausgeführt wurde.

Siehe auch Job-Ende-Aktionen bei Ausführung als temporärer Dummy-Job und Job-Ausführung als Dummy-Job.

An OPO übergeben

Markiert: Die Datei soll an die Open Print Option (OPO) übergeben werden. In diesem Fall können keine Platzhalterzeichen (Wildcards) verwendet werden.

Die Übergabe an die Open Print Option erfolgt nicht standardmäßig.

Anmerkungen

  • Der Entire System Server auf UNIX führt das Kopieren von Dateien mit Platzhalterzeichen (Wildcards) im Namen aus, indem er das Kommando cp (UNIX) oder copy (Windows) absetzt, statt das Kopieren mit eigenem Code auszuführen.

  • Alle Dateien werden synchron kopiert.

  • Wegen der Einschränkung durch die EntireX Broker-Zeitüberschreitungseinstellung usw. sollten Sie nicht zu viele Dateien auf einmal kopieren.

Üblicherweise identifiziert Entire Output Management Report-Definitionen mittels Spool-Attributen. Allerdings existieren keine solchen Spool-Attribute, wenn Entire Operations die Verarbeitung von Ausgabedateien anstößt. Stattdessen werden Entire Operations-Attribute an Entire Output Management wie folgt weitergegeben:

Entire Operations-Attribute Entire Output Management-Identifikation
  z/OS  z/VSE  BS2000
JOBNAME Jobname Jobname PNAME
USER ID Destination Destination Benutzerkennung

Typ der Vorschubsteuerzeichen (CC-Typ)

Je nach Betriebssystemen und den im Dateikatalog enthaltenen Katalogeinträgen ist es notwendig, dass der Typ der Vorschubsteuerzeichen (Carriage Control/CC) für Ausgabedateien angegeben wird.

Bei z/OS ist keine Angabe erforderlich, weil dort der CC-Typ aus dem Katalogeintrag der Datei übernommen wird.

Betriebssystem CC-Typ Bedeutung
BS2000  leer Wenn die Datei mit RECFORM=(...,M) oder RECFORM=(...,A) erstellt wurde, kann der Typ der Vorschubsteuerzeichen aus dem Katalogeintrag der Datei genommen werden, sonst muss er im Feld CC-Typ angegeben werden.
ASA-Code ASA-Code.
Maschinencode Maschinencode.
EBCDIC BS2000-EBCDIC-Vorschubsteuerzeichen.
z/VSE  ASA-Code ASA-Code.
Maschinencode Maschinencode.
z/OS leer CC-Typ nicht erforderlich.

Datei-Definitionen für Entire Output Management löschen

Beginn der Anweisungsliste Um eine Job-Ende-Aktion zu löschen:

  1. Wählen Sie das Register EOJ-Überprüfung.

  2. Markieren Sie eine Job-Ende-Aktion, die für Entire Output Management definiert ist (gekennzeichnet durch ein T in der Spalte Aktion), und wählen Sie die Schaltfläche Löschen.

    Ein Dialogfenster mit der Aufforderung zur Bestätigung erscheint.

  3. Wählen Sie die Schaltfläche Ja, um die Löschung zu bestätigen.

    Die Job-Ende-Aktion wird mit allen Datei-Definitionen für Entire Output Management gelöscht.

Beginn der Anweisungsliste Um einzelne, für eine Job-Ende-Aktion definierte Dateien zu löschen:

  1. Wählen Sie im Register EOJ-Überprüfung die Schaltfläche Ändern.

    Der Dialog Ändern EOJ-Überprüfung ... wird angezeigt.

  2. Wählen Sie im Register EOJ-Überprüfung das Register Output Management.

    Markieren Sie die zu löschende Datei-Definition, und wählen Sie die Schaltfläche Löschen.

    Ein Dialogfenster mit der Aufforderung zur Bestätigung erscheint.

  3. Wählen Sie die Schaltfläche Ja, um die Löschung zu bestätigen.

    Die markierte Datei-Definition wird gelöscht.

SYSOUT- und Datei-Übergabe an Entire Output Management

Dieser Abschnitt behandelt folgende Themen:

Wiederholung bei fehlender oder geöffneter Datei

Falls die zu übergebende Datei (noch) nicht existiert hat, bzw. (noch) nicht geschlossen ist, wird die Übergabe bis zu fünf Mal versucht. Die Zeit zwischen den Übergabe-Versuchen entspricht der Monitor-Wartezeit.

Die folgenden Regeln gelten:

Fall Wiederholungen Intervalle zwischen den Wiederholungen
Ausgabedatei wird nicht gefunden

(gilt nicht für Spool-Dateien)

3 5 Minuten
In allen anderen Fällen 1000 30 Minuten

Die Wiederholungswarteschlange wird beim Herunterfahren oder Neustart des Monitors nicht gelöscht.

Dateikopie vor der Übergabe an Entire Output Management

In den Standardeinstellungen kann definiert werden, dass SYSOUT-Dateien vor der Übergabe an Entire Output Management physisch kopiert werden. Weitere Informationen siehe Kontrollkästchen SYSOUT-Datei vor Übergabe an NOM kopieren im Abschnitt Standardwerte für andere Einstellungen - Register "Andere" in der Systemverwaltung-Dokumentation.

Der Vorteil dabei ist, dass die exklusive Nutzung (sowie Umbenennen und Löschen) der Kopie durch Entire Output Management in Entire Operations weiterhin betrachtet werden kann. Dies hat allerdings einen erhöhten Platzbedarf für SYSOUT-Dateien zur Folge.

Datei auf einen anderen Entire System Server-Knoten kopieren

Unter folgenden Randbedingungen wird die SYSOUT-Kopie auf einem anderen Knoten angelegt:

  • Das Symbol SYSOUT-NODE-GLOBAL existiert in der Symboltabelle SYSDBA/A und enthält deine gültige Knotennummer.

  • In der Zielumgebung existieren die gleichen PubIDs und BS2000-Benutzerkennungen wie in der Quellumgebung.

Zusammenhang mit einer definierten Fehlerbehandlung (Recovery Action)

Definierte Fehlerbehandlungs-Aktionen für einen fehlerhaften Job werden erst ausgeführt, nachdem sämtliche Aktivitäten für die Übergabe der SYSOUT-Datei an Entire Output Management abgeschlossen sind, oder nachdem die maximale Anzahl an Übergabe-Versuchen erreicht wurde.

Im Falle einer Fehlerbehandlung werden die SYSOUT-Dateien aller Job-Läufe an Entire Output Management übergeben.

Weitere Informationen siehe Fehlerbehandlung definieren.

Limit für SYSOUT-Zeilen

Wenn die SYSOUT-Datei oder die Spool-Datei ein vorgegebenes Zeilen-Limit überschreitet, wird die kopierte Datei trunkiert. Siehe Limit für SYSOUT-Zeilen auf der Registerkarte Netzwerk-Optionen in der Systemverwaltung.

Übergabe von SYSOUT von UNIX- und Windows-Knoten an Entire Output Management

Auf UNIX- und Windows-Systemen muss die Umgebungsvariable EOR_NOM definiert sein. Sie muss einen gültigen Verzeichnisnamen enthalten. Entire Operations kopiert die SYSOUT-Dateien für Entire Output Management in dieses Verzeichnis. Wenn das Verzeichnis nicht vorhanden ist, erstellt es der Entire System Server auf UNIX (Entire System Server auf Windows) beim ersten Versuch, es zu benutzen.

Beginn der AnweisungslisteUm das Kopieren von SYSOUT nach Entire Output Management zu definieren:

  1. Markieren Sie im Dialog Verwaltung Jobs das Register EOJ-Überprüfung.. Wählen Sie die Schaltfläche Neu.

    Der Dialog Neu hinzufügen EOJ-Überprüfung wird angezeigt.

  2. Markieren Sie das Register SYSOUT.

  3. Wählen Sie aus der Auswahlliste SYSOUT den Eintrag an EOM übergeben.

    Siehe auch Felder: SYSOUT-Aktionen.

  4. Wählen Sie OK, um die Eingaben zu bestätigen.

Dies ist eine Definition auf Jobebene. Sie gilt nur für den gewählten Job.

Entire Operations erstellt die SYSOUT-Dateikopien in diesem Verzeichnis mit eindeutigen Namen.

Es ist obliegt dann Entire Output Management, die Dateien von dort abzuholen.

Anmerkungen:

  1. Wenn kopierte SYSOUT-Dateien nicht von Entire Output Management innerhalb des Aufbewahrungszeitraums für aktive Jobs abgeholt werden, werden sie durch die Entire Operations-Bereinigung nach diesem Zeitpunkt gelöscht (nur wenn Entire System Server Version 2.1.2 PL 2 oder höher im Einsatz ist). Es empfiehlt sich, Entire System Server Version 2.1.2 PL 2 oder höher in Verbindung mit dieser Funktionalität zu benutzen.
  2. Wenn die SYSOUT-Datei oder die Spool-Datei ein vorgegebenes Zeilen-Limit überschreitet, wird die kopierte Datei trunkiert. Siehe Limit für SYSOUT-Zeilen auf der Registerkarte Netzwerk-Optionen in der Systemverwaltung.

Namenskonventionen für Dateien, die in das Verzeichnis EOR_NOM kopiert werden (UNIX und Windows)

SYSOUT-Dateien

Die Dateinamen für SYSOUT-Dateien für das Verzeichnis $EOR_NOM haben folgende Syntax:

dbid-fnr.owner.network.run.job.txt
Dabei hat ... ... folgende Bedeutung:
dbid-fnr Verkettete Datenbankkennung und Dateinummer, 10 Stellen.
owner Job-Eigentümer.
network Netzwerk des Jobs.
run Laufnummer des Jobs.
job Job.

Andere Dateien

Die Dateinamen für andere Dateien für das Verzeichnis $EOR_NOM haben folgende Syntax:

Format A mit den Bestandteilen

yymmdd.hhiisst.rrrrr.filename.ext
Dabei hat ... ... folgende Bedeutung:
yymmdd Jahr, Monat, Tag.
hhiisst Zeit, einschließlich 1/10 Sek.
rrrr Entire Operations-Laufnummer, mit führenden Nullen.
filename Nicht qualifizierter Teil des ursprünglichen Dateinamens.
ext Erweiterung des ursprünglichen Dateinamens.

Format B mit den Bestandteilen

yymmdd.hhiisst.rrrrr.job.ix
Dabei hat ... ... folgende Bedeutung:
yymmdd Jahr, Monat, Tag.
hhiisst Zeit, einschließlich 1/10 Sek.
rrrr Entire Operations-Laufnummer, mit führenden Nullen.
job Entire Operations-Job-Name.
ix Index der Dateidefinition in Entire Operations (2 Stellen).

Anmerkung:
Aufgrund einer Größenbeschränkung in Entire Output Management wird Format B nur dann benutzt, wenn die Länge von filename.ext mehr als 20 Zeichen beträgt.