Vordefinierte Symbole

In Entire Operations steht Ihnen zahlreiche vordefinierte Symbole zur Verfügung. Diese sind reserviert für Systemvariablen und besondere Systemaufgaben. Wir empfehlen Ihnen dringend, keines dieser Symbole für benutzerdefinierte Symbole zu benutzen.

Bereiche vordefinierter Symbole

Alle Symbolnamen, die mit einem Stern (*) und P- anfangen, sind reserviert für vordefinierte schreibgeschützte Symbole. Diese Präfixe dürfen nicht für benutzerdefinierte Symbole verwendet werden.

Vordefinierte Symbole für Kommandozeilen-Parameter

Symbol Format Bedeutung
CMDLINE-job  A80 Kommandozeilen-Parameter für

  • gestartete Tasks (Jobtyp STC) unter z/OS,

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

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

  • Windows Services (Jobtyp SRV),

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

Mehrere Parameter können, durch Leerzeichen getrennt, in diesem Symbol enthalten sein. job ist durch den Job-Namen zu ersetzen.

Kommandozeilen-Parameterübergabe

Wenn Sie Kommandozeilen-Parameter für einen Job übergeben möchten, können Sie das vordefinierte 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 Sysmbol 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 aufgerufene Start-Kommando ist: 

S STC001,PARM1=Y,PARM2=N

Kommandozeilen-Übergabe an Shell-Skripts in Entire Operations

  • Wenn ein Job gestartet werden soll, überprüft Entire Operations, ob ein Symbol CMDLINE-job vorhanden ist.

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

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

  • 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 #! /bin/sh anfängt), ungeachtet der Shell des Benutzer-Skripts.

  • UNIX: Deshalb müssen Kommandozeilen-Parameter in Bourne Shell-Syntax übergeben werden. Dies bedeutet, dass Sonderzeichen gemäß den Bourne Shell-Regeln in Apostrophen und den betreffenden Masken stehen müssen.

  • Um einen Windows Dateinamen zu übergeben, z.B. c:\work\test.txt, benutzen Sie bitte c:\\work\\test.txt.

  • Die maximale Gesamtlänge aller Parameter ist 1000 Bytes (einschließlich trennender Leerzeichen).

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

Vordefinierte 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 Symbol-Suchhierarchie.

  • zuerst in der aktiven Symboltabelle des Jobs,

  • falls nicht gefunden: in der aktiven Symboltabelle des Netzwerks,

  • falls nicht gefunden und falls im Unternetzwerk: in der aktiven Symboltabelle des aufrufenden Jobs vom Typ NET,

  • falls nicht gefunden: in der aktiven Symboltabelle des aufrufenden Netzwerks.

Die letzten beiden Schritte werden eventuell rekursiv aufsteigend wiederholt.

Vordefinierte Symbole für FTP-Jobs

Es gibt einige Symbole, die für 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-Job-Karten.
FTP-SITE* FTP "Site"-Kommandos.
FTP-PARM* FTP-Kommandozeilenparameter.

Tabelle vordefinierter Symbole

Folgende Symbole können verwendet werden, ohne dass sie in einer Symboltabelle definiert sind:

Symbol Format Bedeutung
*DATD  A8 Tagesdatum im Format DD.MM.YY.
*DATE  A8 Tagesdatum im Format DD/MM/YY.
*DATG  A15 Tagesdatum im Format DDmonthYY.
*DATI A8 Tagesdatum im Format YY/MM/DD.
*DATJ A5 Tagesdatum im Format YYDDD (Julian).
*DATN  N8 Tagesdatum im Format YYYYMMDD.
*DATU  A8 Tagesdatum im Format MM/DD/YY.
*DAT4J A7 Tagesdatum im Format YYYYDDD (Julian).
*TIME  A10 Tageszeit im Format HH:MM:SS.T (einschl. 1/10 Sek.)
*TIME8 A8 Tageszeit im Format HH:MM:SS.
*TIMN N7 Tageszeit im Format HHMMSST.

Siehe auch Symbolfunktion !TIMN. Diese Funktion gestattet die Verwendung von konstanten Zeitwerten.

*TIMN6 N6 Tageszeit im Format HHMMSS.
*TIMA6 A6 Tageszeit im Format HHMMSS.
*TIMA7 A7 Tageszeit im Format HHMMSST.
§PMPA

(Fluchtzeichen § oder wie definiert)

 A5 Wenn in der Definition eines Job-Master-JCL-Knotens, -Ausführungsknotens oder -SYSOUT-Knotens ein Fluchtzeichen (hier: §) definiert ist, wird der Inhalt des Suffix-Symbols des Mehrfachsymbols verwendet. Siehe Mehrfache Symbolwerte.

Dies ermöglicht die Ausführung von mehreren parallelen Jobs auf unterschiedlichen Knoten.

Das Mehrfachsymbol muss ein Array gültiger Knotennummern oder mnemonischer Knotenkurznamen sein.

P-ACT-USER A8 Bei manuellen Aktivierungen: Benutzerkennung des Benutzers, der das Netzwerk oder den Job aktiviert hat.

Bei Unternetzwerk-Aktivierungen: Aktivierungs-Benutzerkennung des aufrufenden (Parent-)Jobs.

Bei planmäßigen Aktivierungen: Standard-Benutzerkennung des Entire Operations-Monitor.

P-ACT-ORIGIN A1 Enthält einen Buchstaben, der den Ursprung der Aktivierung angibt:
A Durch API.
E Durch Job-Ende-Aktion.
M Durch manuelle Aktivierung.
R Durch Wiederherstellung.
S Durch Zeitplanauszug.
U Durch API, als Unternetzwerk.
P-DATE  A8 Ausführungsdatum im Format YYYYMMDD. Es wird das Datum des Vortages übergeben, falls die Endezeit des vorigen Produktionstages noch nicht erreicht ist.
P-EXEC-NODE N5 Ausführungsknoten.
P-EXECUTION-NODE N5 Ausführungsknoten.
P-JCL-FILE A250 JCL-Datei.

Falls nicht zutreffend, wird eine leere Zeichenkette zurückgegeben.

P-JCL-FILE wird immer zu einem voll qualifizierten Dateinamen aufgelöst.

Eine rekursive Auflösung von Symbolen wird durchgeführt.

Falls der JCL-Knoten ein Windows-Knoten ist, können umgekehrte Schrägstriche (\) im Dateinamen als Schrägstriche (/) zurückgegeben werden.

Zur Weiterverwendung in Windows BAT und Powershell JCL muss die folgende Zeichenkette verwendet werden:

+F+&P-JCL-FILE

Dabei ist das kaufmännische Und-Zeichen (&) das Fluchtzeichen.

Windows-Beispiel, bei dem das & als Fluchtzeichen angenommen wird: 

P-JCL-FILE = e:/sag/nop/jcl/job1.bat

type +F+&P-JCL-FILE wird aufgelöst zu: 

type e:\sag\nop\jcl\job1.bat
P-JCL-MEMBER A128 JCL-Member.

Falls nicht zutreffend, wird eine leere Zeichenkette zurückgegeben.

P-JCL-NODE N5 JCL-Knoten.
P-JOB  A10 Job.
P-JOB-ID A10 Die Job-ID (Job-Nummer, BS2000 TSN, Prozess-ID) des aktiven Jobs.
P-JI A10 Die Job-ID (Job-Nummer, BS2000 TSN, Prozess-ID) des aktiven Jobs.
P-JOBCOUNT A8 Nur bei Jobtyp SAP: Job Count im SAP-System.

Anmerkung:
Das Feld steht nach der Beendigung des Jobs zur Verfügung.

P-MUL  A8 Benutzer, der die letzte Änderung durchführte (in Kleinbuchstaben).
P-MUU  A8 Benutzer, der die letzte Änderung durchführte (in Großbuchstaben).
P-NADIR  A250 Verzeichnis für temporäre Dateien für dieses Netzwerk (nur bei UNIX und Windows).

Anmerkungen:

  1. Auf Windows-Knoten enthält der Verzeichnisname umgekehrte Schrägstriche (\). Für die Verwendung in Großrechner-(EBCDIC)-Umgebungen werden diese umgekehrten Schrägstriche als codierte Trigraphen zurückgegeben.
  2. Der Inhalt von P-NADIR ist abhängig von der verwendeten Entire Operations-Version.
P-NETWORK  A10 Netzwerk.
P-NETWORK-VERSION A10 Netzwerk-Version.

Weitere Informationen siehe Objekt-Versionierung im Dokument Konzept und Leistungsumfang.

P-NODE  N5 Ausführungsknoten.
P-OWNER  A10 Eigentümer des Netzwerks.
P-REPEAT

or

P-REPEAT-COUNT

 N10 Wiederholungszähler. Enthält die Nummer der aktuellen Wiederholung des Jobs (z. B. falls der Job erneut gestartet wurde).
P-RUN  N5 Laufnummer des Netzwerks.
P-RUN5 N5 Laufnummer des Netzwerks, immer mit 5 Stellen (mit führenden Nullen).

Example: Die Laufnummer 7 wird zurückgegeben als 00007.

Dieses Symbol steht auch in der Macro-JCL zur Verfügung.
P-SUL  A8 Job-Start-Benutzerkennung (in Kleinbuchstaben).
P-SUU  A8 Job-Start-Benutzerkennung (in Großbuchstaben).
P-SUBMIT-ID  A20 Benutzerkennung, unter der der Job gestartet wurde.
P-SUBMIT-GRP A20 UNIX-Gruppe oder Windows-Domäne, unter der der Job gestartet wurde.
P-SYSOUT  A54 Name der SYSOUT-Datei.

Diese Variable ist abhängig vom Betriebssystem, in dem der Job ausgeführt wird:

BS2000: Jederzeit nach der Aktivierung verfügbar.
z/OS, z/VSE usw.: Nicht verfügbar. Der Wert wird auf ’...’ gesetzt.
UNIX: Jederzeit nach der Aktivierung verfügbar.
Windows: Jederzeit nach der Aktivierung verfügbar. Der Dateiname wird in UNIX-Syntax zurückgegeben.
P-SYMTAB A10 Symboltabelle.
P-SYMBOL-TABLE  A10 Symboltabelle.
P-SYMTAB-VERSION A10 Version der Symboltabelle.

Vordefinierte Symbole für multiple, parallele Aktivierungen

Symbol Format Bedeutung

P-SUFFIX
oder
P-X

A10 Das Suffix des Job-Namens, wenn die multiple, parallele Job-Aktivierung benutzt wird. Einzelheiten zur multiplen, parallelen Job-Aktivierung finden Sie im Abschnitt Job-Verwaltung.

P-X ist eine Abkürzung für P-SUFFIX.

P-MPA  A50 Der vollständige und aktuelle Wert des Symbols, das das Suffix des Job-Namens enthält, wenn die multiple, parallele Job-Aktivierung benutzt wird. Zur Redefinition dieses Feldes gilt: 
§ 1 P-C-MPA (A50) 
§ 1 REDEFINE P-C-MPA ... 
#GET-SYMBOL  P-C-MPA

Siehe #GET-SYMBOL im Abschnitt Verwendung von Variablen in dynamisch generierter JCL.

P-MPI N3 Der numerische Index des Wertes des multiplen Symbols, der für eine multiple parallele Aktivierung verwendet wird.

Vordefinierte Symbole für Unternetzwerke und Fehlerbehebungs-Jobs

Die in der folgenden Liste aufgeführten Symbole werden von einem Unternetzwerk oder einem Fehlerbehebungs-Job benötigt, um mit dem aufrufenden Netzwerk bzw. dem aufrufenden Job zu kommunizieren.

Diese Symbole haben einen leeren Wert, falls sie nicht in einem Unternetzwerk oder einem Fehlerbehebungs-Job verwendet werden.

Symbol Format Bedeutung Fehlerbeh.-Job Unternetzw.
P-C-OWNER  A10 Eigentümer des aufrufenden Jobs oder aufrufenden Netzwerks. X X
P-C-NETWORK  A10 Netzwerk des aufrufenden Jobs oder aufgerufenen Unternetzwerks. X X
P-C-NETWORK-VERSION A10 Netzwerk-Version des aufrufenden Jobs oder aufgerufenen Unternetzwerks. X X
P-C-RUN  N5 Laufnummer des aufrufenden Jobs oder aufrufenden Netzwerks. X X
P-C-JOB  A10 Name des aufrufenden Jobs. X X
P-C-SUFFIX  A10 Suffix-Wert des Jobs, der das Unternetzwerk aufgerufen hat, in dem das Symbol benutzt wird. X X
P-C-JCL-NODE N5 JCL-Knoten des aufrufenden Jobs. X n/a
P-C-EXEC-NODE N5 Ausführungs-Knoten des aufrufenden Jobs. X n/a
P-C-SYMTAB A10 Symboltabelle der aufrufenden Jobs oder aufrufenden Netzwerks. X X
P-C-SYMTAB-VERSION A10 Version der Symboltabelle der aufrufenden Jobs oder aufrufenden Netzwerks. X X
P-C-MPA  A50 Der vollständige und aktuelle Wert des Symbols, das den Suffix des Job-Namens enthält, der das Unternetzwerk aufgerufen hat, wenn im aufrufenden Netzwerk die multiple, parallele Job-Aktivierung benutzt wird. Zur Redefinition dieses Feldes kodieren Sie: 
§ 1 P-C-MPA (A50) 
§ 1 REDEFINE P-C-MPA ... 
#GET-SYMBOL P-C-MPA
 X n/a
P-C-SUU A20 Job-Start-Benutzerkennung des aufrufenden Jobs.

Es ist möglich, dieses Symbol als Job-Start-Benutzerkennung in den Jobs des Unternetzwerks zu definieren und dabei das Aktivierungsfluchtzeichen voranzustellen. (Die Unternetzwerk-Jobs müssen eine Symboltabellen-Definition haben.)

X n/a
P-C-SUG A20 Start-Gruppe des aufrufenden Jobs.

Es ist möglich, dieses Symbol als Startgruppe in den Jobs des Unternetzwerks zu definieren, und dabei das Aktivierungsfluchtzeichen voranzustellen. (Die Unternetzwerk-Jobs müssen eine Symboltabellen-Definition haben.)

X n/a

n/a = nicht zutreffend