Vordefinierte Symbole

Vordefinierte Symbole dienen zur Ausführung von speziellen Aufgaben, z.B. in JCL-Dateien oder Scripts. Sie werden von Entire Operations definiert und können nicht geändert werden.

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

Vordefinierte Symbole dürfen nicht in Symboltabellen benutzt werden.

Tabelle vordefinierter Symbole

Die in der folgenden Tabelle aufgeführten Symbole können nur gelesen werden. Sie können verwendet werden, ohne dass sie in einer Symboltabelle definiert sind.

Weitere Informationen siehe auch Datums- und Zeitformate.

Symbol Format Bedeutung
*DATD  A8 Tagesdatum im Format DD.MM.YY.
*DATE  A8 Tagesdatum im Format DD/MM/YY.
*DATG  A15 Tagesdatum im Format DDmonthnameYYYY (gregorianisches Datum).
*DATI A8 Tagesdatum im Format YY/MM/DD.
*DATJ A5 Tagesdatum im Format YYDDD (julianisches Datum).
*DATN  N8 Tagesdatum im Format YYYYMMDD.
*DATU  A8 Tagesdatum im Format MM/DD/YY.
*DAT4J A7 Tagesdatum im Format YYYYDDD (julianisches Datum).
*TIME  A10 Tageszeit im Format HH:II:SS.T (dabei ist HH = Stunden, II = Minuten, SS = Sekunden, T = 1/10 Sek.)
*TIME8 A8 Tageszeit im Format HH:II:SS.
*TIMN N7 Tageszeit im Format HHIISST.

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

*TIMN6 N6 Tageszeit im Format HHIISS.
*TIMA6 A6 Tageszeit im Format HHIISS.
*TIMA7 A7 Tageszeit im Format HHIISST.
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-ESC-ACT A1 Das für das aktuelle Objekt (z.B. ein Job) definierte Aktivierungsfluchtzeichen. Siehe Fluchtzeichen zur Symbolersetzung.

Anmerkungen:

  1. Der Wert von P-ESC-ACT wird durch das Meta-Statement #EOR-ESC-ACT innerhalb einer JCL nicht geändert. Siehe Definitionen in JCL und Macro-Source.
  2. P-ESC-ACT kann auch als vordefinierte Variable in Meta-Statements in Macro-JCL benutzt werden.
P-ESC-SUB A1 Das für das aktuelle Objekt (z.B. ein Job) definierte Startfluchtzeichen. Siehe Fluchtzeichen zur Symbolersetzung.

Anmerkungen:

  1. Der Wert von P-ESC-SUB wird durch das Meta-Statement #EOR-ESC-SUB innerhalb einer JCL nicht geändert. Siehe Definitionen in JCL und Macro-Source.
  2. P-ESC-ACT kann auch als vordefinierte Variable in Meta-Statements in Macro-JCL benutzt werden.
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 Zeichenkette +F+&P-JCL-FILE verwendet werden (Dabei ist das kaufmännische Und-Zeichen (&) das Fluchtzeichen.).

Windows-Beispiel, bei dem das kaufmännische Und-Zeichen (&) als Fluchtzeichen angenommen wird: 

P-JCL-FILE = e:/sag/nop/jcl/job1.bat
type +F+&P-JCL-FILE

wird aufgelöst zu: 

e:\sag\nop\jcl\job1.bat
P-JCL-MEMBER   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

oder

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

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

Dieses Symbol steht auch in der Macro-JCL zur Verfügung.
P-SGL A50 UNIX-Gruppe oder Windows-Domäne des Jobs (in Kleinbuchstaben).
P-SGU A50 UNIX-Gruppe oder Windows-Domäne des Jobs (wie definiert).
P-SUL  A50 Job-Start-Benutzerkennung (in Kleinbuchstaben).
P-SUU  A50 Job-Start-Benutzerkennung (in Großbuchstaben).
P-SUBMIT-ID  A50 Job-Start-Benutzerkennung (wie definiert).
P-SUBMIT-GRP A50 UNIX-Gruppe oder Windows-Domäne (wie definiert) des Jobs.
P-SYSF1 A10 Verkettete Datenbankkennung (DBID) und Dateinummer (FNR) der Entire Operations-Systemdatei 1.

Beispiel:

Entire Operations-Systemdatei 1 hat die LFILE-Einstellung LFILE=(216,9,17).

P-SYSF1 wird auf 0000900017 gesetzt.

 P-SYSOUT A250 Name der SYSOUT-Datei.

Diese Variable und ihre effektive Größe sind abhängig vom Betriebssystem, in dem der Job ausgeführt wird:

BS2000: Jederzeit nach der Aktivierung verfügbar. Die effektive (nutzbare) Größe ist 54.
z/OS und z/VSE: Nicht verfügbar. Der Wert wird auf drei aufeinanderfolgende Punkte (...) 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 mehrfache, parallele Aktivierungen

Symbol Format Bedeutung

P-SUFFIX
oder
P-X

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

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

PMPA A5 Inhalt des Suffix-Symbols des Symbols mit mehrfachen Symbolwerten.

Das Symbol kann in Job-Master-JCL-Knoten-, Ausführungsknoten- und SYSOUT-Knoten-Definitionen benutzt werden, die das Aktivierungsfluchtzeichen als Präfix haben. Bei einem Ausführungsknoten können Sie auch das Startfluchtzeichen als Präfix für das Symbol benutzen.

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

Das Symbol mit mehrfachen Symbolwerten muss ein Array gültiger Knotennummern oder mnemonischer Knotenkurznamen sein.

Siehe auch P-MPA.

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

Siehe auch PMPA.

P-MPI N3 Der numerische Index des Wertes des Symbols mit mehrfachen Symbolwerten, der für eine mehrfache, 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-RUNS N5 Fünfstellige Laufnummer (mit führenden Nullen) des aufrufenden Jobs oder aufrufenden Netzwerks. Zum Beispiel: Laufnummer 7 wird als 00007 zurückgegeben.

Dieses Symbol ist auch in der Macro JCL verfügbar.

    
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 nicht zutreffend
P-C-EXEC-NODE N5 Ausführungs-Knoten des aufrufenden Jobs. X nicht zutreffend
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 mehrfache, 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 nicht zutreffend
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 nicht zutreffend
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 nicht zutreffend