Einträge der SDF-Parameterdatei ausgeben
Komponente: | SDF |
Funktionsbereich: | SDF-Steuerung |
Anwendungsbereich: | SDF |
Privilegierung: | TSOS |
Berechtigungsschlüssel: | @ |
Funktionsbeschreibung
Das Kommando SHOW-SDF-PARAMETERS gibt Auskunft über die Einträge einer SDF-Parameterdatei. Es werden dabei die Namen der Systemsyntaxdateien und alle Zuordnungen PROFILE-ID zu einer Gruppensyntaxdatei ausgegeben. Wahlweise können die Namen der systemweiten LOGON- bzw. LOGOFF-Prozeduren (Call- und Include-Prozedur) mit ausgegeben werden.
Hinweis
Subsystem-Syntaxdateien, die sich auf einem Pubset befinden, der während der Systemeinleitung nicht verfügbar war, werden nicht angezeigt. Diese Syntaxdateien können nur beim Importieren des Pubsets aktiviert werden.
Das Kommando unterstützt die strukturierte Ausgabe in S-Variable (siehe „Ausgabe in S-Variable").
Format
SHOW-SDF-PARAMETERS | ||||||||||||||||||||||||||||||||||||||||||||||||
|
Operandenbeschreibung
SCOPE =
bestimmt den Umfang der Aktivierung.
SCOPE = *TEMPORARY
Die in der laufenden Sitzung aktivierten Syntaxdateien und/oder systemweiten LOGON- bzw. LOGOFF-Prozeduren werden ausgegeben.
SCOPE = *NEXT-SESSION(...)
Die Syntaxdateien und/oder systemweiten LOGON- bzw. LOGOFF-Prozeduren, die in einer SDF-Parameterdatei hinterlegt sind, werden ausgegeben.
PARAMETER-FILE-NAME =
Bestimmt die SDF-Parameterdatei, in der die angeforderten Informationen hinterlegt sind.
PARAMETER-FILE-NAME = *CURRENT
Die benötigen Informationen sind in der aktuellen SDF-Parameterdatei, die beim Starten des Systemlaufs verwendet wurde, hinterlegt.
PARAMETER-FILE-NAME = <filename 1..54>
Vollqualifizierter Name der SDF-Parameterdatei, in der die angeforderten Informationen hinterlegt sind.
Der angezeigte Name der SDF-Parameterdatei kann im Falle der Verwendung von Aliasnamen durch ACS als Ergebnis einer Dateinamensersetzung interpretiert werden. Nur wenn kein Aliasname für die SDF-Parameterdatei vereinbart wurde, wird der vollqualifizierte, reale Dateiname von SDF gespeichert und ausgegeben.
SYNTAX-FILE-TYPE =
Legt fest, welche Syntaxdateinamen angezeigt werden sollen.
SYNTAX-FILE-TYPE = *ALL
Es sollen die Namen der Basis-Systemsyntaxdatei, der Subsystem-Syntaxdateien (in Verbindung mit dem Namen der Subsysteme) und die Namen der Gruppensyntaxdateien (mit den zugehörigen PROFILE-IDs) ausgegeben werden.
SYNTAX-FILE-TYPE = *SYSTEM
Es soll der Name der Basis-Systemsyntaxdatei ausgegeben werden.
SYNTAX-FILE-TYPE = *SUBSYSTEM(...)
Es sollen die Namen der Subsystem-Syntaxdateien ausgegeben werden.
SUBSYSTEM-NAME =
Legt fest, welche Subsystem-Syntaxdateien ausgewählt werden sollen.
SUBSYSTEM-NAME = *ALL
Es sollen die Namen aller Systemsyntaxdateien, die einem Subsystem zugeordnet sind, ausgegeben werden.
SUBSYSTEM-NAME = <structured-name 1..8 with-wild(24)>
Die Syntaxdateien der angegebenen Subsysteme sollen angezeigt werden.
SYNTAX-FILE-TYPE = *GROUP(...)
Es sollen die Namen von Gruppensyntaxdateien ausgegeben werden.
PROFILE-ID =
Bestimmt über die PROFILE-ID die Namen anzuzeigenden Gruppensyntaxdateien.
PROFILE-ID = *ALL
Die Namen aller Gruppensyntaxdateien (in Verbindung mit den zugehörigen PROFILE-IDs) sollen ausgegeben werden.
PROFILE-ID = <structured-name 1..30>
Bestimmt die PROFILE-ID, deren zugeordnete Gruppensyntaxdatei namentlich angezeigt werden soll.
SYNTAX-FILE-TYPE = *NONE
Es sollen keine Syntaxdateinamen angezeigt werden.
SYSTEM-LOGON-PROC = *YES / *NO
Gibt an, ob der Name der systemweiten LOGON-Call-Prozedur (Aufruf mit dem Kommando CALL-PROCEDURE) angezeigt werden soll.
SYSTEM-LOGON-INCL = *YES / *NO
Gibt an, ob der Name der systemweiten LOGON-Include-Prozedur (Aufruf mit dem Kommando INCLUDE-PROCEDURE) angezeigt werden soll.
SYSTEM-LOGOFF-PROC = *YES / *NO
Gibt an, ob der Name der systemweiten LOGOFF-Call-Prozedur (Aufruf mit dem Kommando CALL-PROCEDURE) angezeigt werden soll.
SYSTEM-LOGOFF-INCL = *YES / *NO
Gibt an, ob der Name der systemweiten LOGOFF-Include-Prozedur (Aufruf mit dem Kommando INCLUDE-PROCEDURE) angezeigt werden soll.
Kommando-Returncode
(SC2) | SC1 | Maincode | Bedeutung / garantierte Meldungen |
---|---|---|---|
0 | CMD0001 | Ohne Fehler | |
1 | 32 | CMD0500 | Syntaxbeschreibung in der aktuellen Syntaxdatei fehlerhaft |
1 | 64 | CMD0601 | Kommando ist der Systembetreuung vorbehalten |
1 | 64 | CMD0680 | SDF-Parameterdatei fehlerhaft |
Ausgabe in S-Variable
Von allen Operanden des Kommandos (SCOPE, SYNTAX-FILE-TYPE, SYSTEM-LOGOFF-INCL, SYSTEM-LOGOFF-PROC, SYSTEM-LOGON-INCL und SYSTEM-LOGON-PROC) wird eine strukturierte Ausgabe in S-Variablen unterstützt. In der Regel werden alle S-Variablen erzeugt.
Ausnahmen
Ausnahmen bilden die S-Variablen, welche in der Spalte „Bedingung“ mit a) oder b) gekennzeichnet sind:0
Diese S-Variablen werden nicht erzeugt, wenn im Kommando SYNTAX-FILE-TYPE=*NONE angegegeben wurde.
Diese S-Variable wird nicht erzeugt, wenn im Kommando keine entsprechende LOGON- bzw. LOGOFF-Prozedur vereinbart wurde (z.B. SYSTEM-LOGON-PROC=*NONE).
Ausgabe-Information | Name der S-Variablen | T | Inhalt | Bedingung |
---|---|---|---|---|
Umfang der aktivierten Syntaxdateien | var(*LIST).SCOPE | S | *TEMP | |
Name der Syntaxdatei | var(*LIST).SF(*LIST).F-NAME | S | <filename 1..54> | a) |
SDF-Dateihierarchie bleibt bestehen (zur Syntaxanalyse wird die Systemsyntaxdatei herangezogen). | var(*LIST).SF(*LIST).HIERARCHY | S | ’’ | a) |
Name des Subsystems, wenn SF(*LIST).TYPE = *SUBSYS. | var(*LIST).SF(*LIST).NAME | S | ’’ | a) |
Profile-Id der Gruppensyntaxdatei. | var(*LIST).SF(*LIST).PROF-ID | S | ’’<struc.-name 1..30> | a) |
Zustand des Subsystems. | var(*LIST).SF(*LIST).STATE | S | ’’ | a) |
Typ der Syntaxdatei | var(*LIST).SF(*LIST).TYPE | S | *GROUP | a) |
Version der Syntaxdatei | var(*LIST).SF(*LIST).VERSION | S | <text 1..12> | a) |
Name der systemweiten LOGOFF-Prozedur (Aufruf mit INCLUDE-PROCEDURE) | var(*LIST).SYS-LOGOFF-INCL | S | *STD | b) |
Name der systemweiten LOGOFF-Prozedur (Aufruf mit CALL-PROCEDURE) | var(*LIST).SYS-LOGOFF-PROC | S | *STD | b) |
Name der systemweiten LOGON-Prozedur (Aufruf mit INCLUDE-PROCEDURE) | var(*LIST).SYS-LOGON-INCL | S | ’’ | b) |
Name der systemweiten LOGON-Prozedur (Aufruf mit CALL-PROCEDURE) | var(*LIST).SYS-LOGON-PROC | S | ’’ | b) |
Beispiel
/declare-var var-name=var(type=*structure),multiple-elem=*list
/exec-cmd cmd=(show-sdf-parameters syntax-file-type=*sys),
text-output=*none,structure-output=var
/show-var var,inf=*par(val=*c-literal)
VAR(*LIST).SCOPE = '*TEMP' VAR(*LIST).SF(*LIST).NAME = 'BS2000' VAR(*LIST).SF(*LIST).TYPE = '*SYS' VAR(*LIST).SF(*LIST).VERSION = '20' VAR(*LIST).SF(*LIST).F-NAME = ':SQGB:$TSOS.SYSSDF.SDF.048' VAR(*LIST).SF(*LIST).STATE = '' VAR(*LIST).SF(*LIST).PROF-ID = '' VAR(*LIST).SF(*LIST).HIERARCHY = '' *END-OF-VAR VAR(*LIST).SYS-LOGON-PROC = '$TSOS.SYS.SDF.LOGON.SYSPROC' VAR(*LIST).SYS-LOGON-INCL = '$TSOS.SYS.SDF.LOGON.SYSINCL' VAR(*LIST).SYS-LOGOFF-PROC = '$TSOS.SYS.SDF.LOGOFF.SYSPROC' VAR(*LIST).SYS-LOGOFF-INCL = '$TSOS.SYS.SDF.LOGOFF.SYSINCL' *END-OF-VAR
/exec-cmd cmd=(show-sdf-parameters syntax-file-type=*none),
text-output=*none,structure-output=var
/show-var var,inf=*par(val=*c-literal)
VAR(*LIST).SCOPE = '*TEMP' VAR(*LIST).SYS-LOGON-PROC = '$TSOS.SYS.SDF.LOGON.SYSPROC' VAR(*LIST).SYS-LOGON-INCL = '$TSOS.SYS.SDF.LOGON.SYSINCL' VAR(*LIST).SYS-LOGOFF-PROC = '$TSOS.SYS.SDF.LOGOFF.SYSPROC' VAR(*LIST).SYS-LOGOFF-INCL = '$TSOS.SYS.SDF.LOGOFF.SYSINCL' *END-OF-VAR