Reservierte Symbole

Reservierte Symbole dienen zur Ausführung von Aufgaben, die der Benutzer angegeben hat. Sie können sie bei Bedarf ändern, wenn Ihnen in Ihrem Benutzerprofil die Berechtigung zur Pflege von Symboltabellen erteilt worden ist (siehe Option Symboltabellen im Abschnitt Netzwerkverwaltung - Funktionen zur Netzwerk- und Job-Definition in der Master-Datenbank in der Systemverwaltung-Dokumentation).

Reservierte Symbole können Sie in Symboltabellen ebenso wie alle anderen Symbole anlegen, ändern und löschen.

Dieser Abschnitt behandelt folgende Themen:


Reservierte Symbole für Kommandozeilen-Parameter

Symbol Format Bedeutung
CMDLINE-job  A80 Kommandozeilen-Parameter für die folgenden Jobtypen und/oder JCL-Speicherarten:
  • gestartete Tasks (Jobtyp STC) unter z/OS,

  • für UNIX-Shell-Skripte (Jobtyp JOB),

  • Windows BAT-Dateien (Jobtyp JOB) und PowerShell-Skripte (Jobtyp WPS),

  • Windows Services (Jobtyp SRV),

  • Programme, die unter UNIX oder Windows direkt ausgeführt werden sollen (JCL-Speicherart EXE.

Dieser Abschnitt behandelt folgende Themen:

Kommandozeilen-Parameterübergabe

Wenn Sie Kommandozeilen-Parameter für einen Job übergeben möchten, können Sie das reservierte Symbol CMDLINE-job in der Symboltabelle des Jobs benutzen. Dabei ist job der Name des Jobs.

Es können mehrere, durch Leerzeichen voneinander getrennte Parameter in diesem Symbol enthalten sein, zum Beispiel:

Job-Name: JOB1
Member-Name in der JCL-Definition: STC001
Inhalt des Symbols CMDLINE-JOB1: PARM1=Y,PARM2=N

Das vom Entire Operations-Monitor generierte und abgesetzte Start-Kommando ist:

S STC001,PARM1=Y,PARM2=N

Kommandozeilen-Übergabe an Shell-Skripte in Entire Operations

  • Wenn ein Job aktiviert werden soll, überprüft Entire Operations, ob ein Symbol CMDLINE-job existiert.

    Falls ein solches Symbol existiert, wird sein Inhalt an den Aufruf des job.B-Skripts angehängt.

  • Verschachtelte (rekursive) Ersetzung:

    Der Wert von CMDLINE-job kann verschachtelte Symbole enthalten.

    Diesen kann als Präfix das Aktivierungsfluchtzeichen für die Ersetzung zur Aktivierungszeit oder das Startfluchtzeichen für die Ersetzung zur Startzeit vorangestellt sein.

  • Das Skript job.sh bzw. job.bat (das Skript des Benutzers, mit einigen Entire Operations-Kopfzeilendateien) wird nicht direkt aufgerufen, sondern aus dem Wrapping-Skript job.nnnnnnnn.frame.sh bzw. job.nnnnnnnn.frame.bat aufgerufen.

    Dabei ist nnnnnnnn ein achtstelliger Wiederholungszähler. Beim ersten Jobstart ist er 00000000.

  • Das Skript job.nnnnnnnn.frame.sh bzw. job.nnnnnnnn.frame.bat wird von Entire Operations zur Startzeit generiert. Unter UNIX handelt es sich immer um ein Bourne-Shell-Skript (das mit der Shebang-Zeichenkette #! /bin/sh beginnt), ungeachtet der Shell des Benutzer-Skripts.

  • UNIX: Kommandozeilen-Parameter müssen in Bourne-Shell-Syntax übergeben werden. Dies bedeutet, dass Sonderzeichen gemäß den Bourne-Shell-Regeln in Apostrophen und den speziellen Masken stehen müssen. Beachten Sie bitte, dass das Bourne-Shell-Skript anhand der Parameter apostrophiert, die im aufgerufenen Shell-Skript in Apostrophen stehen.

  • Benutzen Sie c:\\work\\test.txt, um einen Windows Dateinamen zu übergeben, z.B. c:\work\test.txt.

  • Die maximale Gesamtlänge aller Parameter ist 2000 Bytes (nach der Symbolersetzung, einschließlich trennender Leerzeichen).

  • Die maximale Länge eines einzelnen Parameters ist 240 Bytes.

Reservierte Symbole für Großrechner-Plattformen

Symbol Format Bedeutung
SYSOUT-NODE-GLOBAL  N5 (Nur in Tabelle SYSDBA/A)

Wenn dieses SYSOUT existiert und eine gültige Entire System Server-Knotennummer enthält, und wenn keine andere zutreffende SYSOUT-Knoten-Definition zur Verfügung steht, werden SYSOUT-Dateikopien für Entire Output Management auf diesem Knoten angelegt.

JCL-NODE  N5 Falls dieses Symbol bei der Job-Aktivierung gefunden wird, wird dieser Knoten für den aktiven Job als JCL-Knoten verwendet.
SUBMIT-NODE  N5 Falls dieses Symbol bei der Job-Aktivierung gefunden wird, wird dieser Knoten für den aktiven Job als Job-Start-Knoten verwendet.
SYSOUT-NODE  N5 Falls dieses Symbol bei der Job-Aktivierung gefunden wird, wird dieser Knoten für den aktiven Job als SYSOUT-Knoten verwendet.

Dieses Symbol hat Vorrang vor SYSOUT-NODE-GLOBAL.

Die Symbole JCL-NODE, SUBMIT-NODE und SYSOUT-NODE werden in Symboltabellen gesucht, siehe Symboltabellen-Typen und Symbol-Suchreihenfolge.

Reservierte Symbole für FTP-Jobs

Es gibt einige Symbole, die bei Jobs des Typs FTP eine besondere Bedeutung haben.

Platzhalterzeichen (Wildcard-Notation) bedeuten, dass alle mit dem erwähnten Präfix beginnenden Symbole reserviert sind.

Symbol Bedeutung
FTP-JOBC* FTP-JCL.
FTP-SITE* FTP-SITE-Kommandos.
FTP-PARM* FTP-Kommandozeilenparameter.

Reservierte Symbole für Profil-Skripte (UNIX)

Im Folgenden werden die reservierten Symbole beschrieben, die beim Generieren von UNIX-Frame-Skripten (job.current.frame.sh), die Profil-Skripte als Source benutzen, verwendet werden. Siehe auch UNIX: Verwendung von Profil-Skripten im Kapitel Job-Verwaltung.

Die reservierten Symbole werden im Format A definiert.

Symbol Beschreibung
ETC-PROFILE Bestimmt die als Source zu benutzenden Profil-Skripte.

Mögliche Werte:

Y Die in /etc/profile und /etc/profile.local enthaltenen Profil-Skripte werden benutzt (falls vorhanden).
N Die in /etc/profile und /etc/profile.local enthaltenen Profil-Skripte werden nicht benutzt.

Diese Einstellung hat die gleiche Wirkung, wie wenn ETC-PROFILE überhaupt nicht definiert wäre. Das Symbol wird dann in der Symbol-Suchhierarchie nicht gefunden.

Falls Sie Profil-Skripte nicht als Source benutzen möchten, müssen Sie sich vergewissern, dass ETC-PROFILE nicht auf einer höheren Ebene in der Symboltabellen-Suchhierarchie auf Y gesetzt ist (z.B. SYSDBA/A). In diesem Fall müssen Sie ETC-PROFILE auf einer niedrigeren Ebene in der Symbol-Suchhierarchie explizit auf N setzen. Siehe auch Symboltabellen-Typen und Symbol-Suchreihenfolge.

Wenn für ETC-PROFILE kein Wert angegeben ist, dann ist N die Standardeinstellung.

ENV script-name Das für dieses Symbol definierte benutzerdefinierte Profil-Skript benutzen.

Beispiel:

$HOME/.profile

Reserviertes Symbol für Epilog-Skripte (UNIX und Windows)

Im Folgenden wird das reservierte Symbol beschrieben, das zur Ausführung von Epilog-Skripten bei UNIX- und Windows-Jobs verwendet wird.

Symbol Format Beschreibung
NOP-EPILOG-execution_node A120 Voll qualifizierter Name einer Epilog-Skriptdatei.

Beispiel:

NOP-EPILOG-517

Pfad zu Shell-Datei:

/home/sag/jcl/epilog.node517.sh

Symboltabellen-Suche bei Epilog-Skripten

Jedes Mal, wenn ein Job auf einem UNIX- oder Windows-Ausführungsknoten gestartet wird, sucht Entire Operations in der Symboltabellen-Hierarchie nach dem Symbol NOP-EPILOG-execution_node.

Das Epilog-Skript wird nicht ausgeführt, wenn das Symbol NOP-EPILOG-execution_node in keiner Symboltabelle gefunden werden kann oder wenn der mit dem reservierten Symbol gelieferte Wert leer ist, einen Bindestrich (-) enthält oder auf NO gesetzt ist.

Ist das reservierte Symbol in der Symboltabelle (SYSDBA/A), die in der Symboltabellen-Hierarchie an oberster Stelle steht, enthalten, dann erfolgt die Ausführung des betreffenden Epilog-Skripts bei allen UNIX- und Windows-Jobs. Davon ausgenommen sind Jobs, die ein reserviertes Symbol referenzieren, das in einer in der Symboltabellen-Hierarchie niedriger stehenden Symboltabelle enthalten ist.

Epilog-Skripte benutzen

Das mit dem Symbol NOP-EPILOG-execution_node definierte Shell-Skript muss ausführbare Rechte haben.

Das Epilog-Skript wird durch das JCL-Frame-Skript aufgerufen und beginnt mit der Ausführung, wenn das Main-Skript beendet ist.

Wenn ein Epilog-Skript definiert ist, aber nicht gefunden werden kann, wird der Exit-Code des Jobs auf 102 gesetzt, so dass der gesamte Job als fehlerbehaftet beendet wird.

Das Epilog-Skript übernimmt keine Parameter. Unter Verwendung von reservierten Symbolen kann das Epilog-Skript Informationen von Umgebungsvariablen erhalten, die im JCL-Frame-Skript gesetzt sind. Weitere Informationen siehe Reservierte Symbole für UNIX- und Windows-Umgebungsvariablen im Kapitel User Exits.

Für das Epilog-Skript wird keine Ersetzung durchgeführt. Das Epilog-Skript wird durch das Frame-Skript direkt ausgeführt, das heißt, ohne Zwischenspeicherung in Entire Operations.

Ein Windows-Epilog-Skript darf nicht mit einem exit-Statement beendet werden. Setzen Sie einen Exit-Code folgendermaßen:

set errorlevel=exit_code

Wenn der im Epilog-Skript definierte Exit-Code höher ist als der Exit-Code des Frame-Skripts, wird der Exit-Code des Main-Skripts auf den Exit-Code des Epilog-Skripts gesetzt.