Dateien an Entire Output Management übergeben

#### Search Results

Search

# Dateien an Entire Output Management übergeben

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.

Dieses Kapitel behandelt folgende Themen:

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

- Dateien zur Übergabe an Entire Output Management auflisten

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

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

- SYSOUT- und Datei-Übergabe an Entire Output Management

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

Folgende grundlegende Erfordernisse gelten, wenn Dateien von Entire Operations an Entire Output Management übergeben werden:

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 dazu 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:

- SYSOUT- und Datei-Übergabe an Entire Output Management.

- Einstellen des Wiederhol-Limits für Entire Output Management-API, siehe NOM API Einstellungen im Abschnitt Standardwerte für andere Einstellungen in der Systemverwaltung-Dokumentation.

- Kontrollkästchen SYSOUT-Datei vor Übergabe an NOM kopieren in Standardwerte für andere Einstellungen - Register "Andere" in der Systemverwaltung-Dokumentation.

## Dateien zur Übergabe an Entire Output Management auflisten

Um Dateien aufzulisten, die zur Weiterverarbeitung in Entire Output Management definiert sind:

1. Markieren Sie im Dialog Verwaltung Jobs einen Job und wählen Sie das Registerkarte EOJ-Überprüfung.

   Der Buchstabe T in der Spalte Aktion zeigt an, ob eine Job-Ende-Aktion für Entire Output Management existiert.

2. Markieren Sie die Tabellenzeile, die den Buchstaben T enthält, und wählen Sie die Schaltfläche Ändern.

   Der Dialog Ändern EOJ-Überprüfung ... wird angezeigt (Beispiel s.u.).

3. Wählen Sie die Registerkarte Output Management:

   Die Registerkarte enthält eine Liste aller Dateien, die als EOJ-Aktion für die Übergabe an Entire Output Management definiert sind.

## 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.

Um 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 die Registerkarte EOJ-Überprüfung.

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 Job-Ende-Überprüfung zu definieren. Oder markieren Sie eine vorhandene Dateidefinition und wählen Sie die Schaltfläche Ändern.

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

   Abhängig von der Optionswahl unter Datei ist definiert durch sind im Bereich Dateidefintion andere Felder vorhanden.

   Weitere Vorgehensweise siehe:

   - Bei Option Spoolfile Type und Nummer sowie Proc. Step und DD-Name: Spool-Datei-Definition

   - Bei Option Parameter-Ausgabedatei: Parameter-Ausgabedatei-Definition

4. Wählen Sie die Registerkarte Output Management.

5. 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

- Parameter-Ausgabedatei-Definition

- Typ der Vorschubsteuerzeichen (CC-Typ)

### 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

Um 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.

   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

Um 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.

   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 | Option | Bedeutung
--- | ---
Datei ist definiert durch
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.
Dateidefinition
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-Definition

Dieser Abschnitt behandelt folgende Themen:

- Fenster: Ausgabedatei
- Felder: Ausgabedatei

#### Fenster: Ausgabedatei

Um 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:

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

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

   Weitere Informationen siehe Felder: Parameter-Ausgabedatei.

   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 | Datei, die an Entire Output Management übergeben werden soll. Die Definition darf bis zu 54 Bytes enthalten. Wenn der Dateiname das Aktivierungsfluchtzeichen enthält, erfolgt eine Symbolersetzung während der Aktivierung des Jobs. Dateinamen mit einer maximalen resultierenden Größe von 54 Bytes können nur auf diese Weise gehandhabt werden. Wenn der Dateiname das Startfluchtzeichen enthält, erfolgt eine Symbolersetzung unmittelbar bevor die Datei übergeben wird. Dateinamen mit einer maximalen resultierenden Größe von mehr als 54 Bytes müssen auf diese Weise gehandhabt werden. In diesem Fall ist die maximale resultierende Größe 250 Bytes. Wenn Sie in dem Dateinamen ein Platzhalterzeichen verwenden, können Sie alle Dateien, die zu dem Platzhalter passen, auf einmal an Entire Output Management übergeben.
CC-Typ | Gilt nicht bei z/OS. Typ der Vorschubsteuerzeichen (Carriage Control). Wenn die Datei Vorschubsteuerzeichen enthält, müssen Sie hier deren Typ angeben, siehe Typ der Vorschubsteuerzeichen (CC-Typ).
PName | Dieses Feld ist nur bei BS2000 relevant. Geben Sie hier den PNAME ein, wenn Sie den Job mittels der PNAME-Option des BS2000-Print-Befehls (`/Print ...,PNAME=ADAREP`) kennzeichnen möchten.
VolSer, Recfm, Lrecl, Blksize | Bei z/VSE sind diese Felder Pflichtfelder. Informationen, die zum Zuweisen der Datei dienen: Datenträgernummer (VolSer) , Satzformat (Recfm), Satzlänge (Lrecl) und Blocklänge (Blksize).
Ausführen, falls temp. Dummy | Wenn Sie dieses Kontrollkästchen markieren , wird die Job-Ende-Aktion entsprechend dieser Vorgabe ausgeführt, falls der Job als temporärer Dummy-Job ausgeführt wurde. Wenn Sie dieses Kontrollkästchen markieren nicht markieren, nicht ausgeführt. Siehe auch Job-Ende-Aktionen bei Ausführung als temporärer Dummy-Job und Job-Ausführung als Dummy-Job.

#### 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

Um eine Job-Ende-Aktion zu löschen:

1. Wählen Sie die Registerkarte 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 wird angezeigt.

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.

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

1. Wählen Sie auf der Registerkarte EOJ-Überprüfung die Schaltfläche Ändern.

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

2. Wählen Sie auf der Registerkarte EOJ-Überprüfung die Registerkarte 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 wird angezeigt.

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

- Dateikopie vor der Übergabe an Entire Output Management

- Datei auf einen anderen Entire System Server-Knoten kopieren

- Zusammenhang mit einer definierten Fehlerbehandlung (Recovery Action)

- Limit für SYSOUT-Zeilen

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

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

### 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.

Dabei gelten die folgenden Regeln:

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 eine 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 Fehlerbehandlungsaktionen definieren (Wiederherstellung).

### Limit für SYSOUT-Zeilen

Wenn die SYSOUT-Datei oder die Spool-Datei ein vorgegebenes Zeilen-Limit überschreitet, wird die kopierte Datei gekürzt. 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.

Um das Kopieren von SYSOUT nach Entire Output Management zu definieren:

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

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

2. Markieren Sie die Registerkarte 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. Siehe auch Standardwerte: Zeiträume in der Systemverwaltung-Dokumentation.
2. Wenn die SYSOUT-Datei oder die Spool-Datei ein vorgegebenes Zeilen-Limit überschreitet, wird die kopierte Datei gekürzt. 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.

### On this page

- Grundlegende Erfordernisse für Datei-Übergaben an Entire Output Management
- Dateien zur Übergabe an Entire Output Management auflisten
- Datei-Definition für Entire Output Management anlegen oder ändern
- Datei-Definitionen für Entire Output Management löschen
- SYSOUT- und Datei-Übergabe an Entire Output Management