Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

SHOW-SDF-PARAMETERS

&pagelevel(3)&pagelevel

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                                                                                                                        

 SCOPE = *TEMPORARY / *NEXT-SESSION(...)


*NEXT-SESSION(...)



|

PARAMETER-FILE-NAME = *CURRENT / <filename 1..54>

,SYNTAX-FILE-TYPE = *ALL / *SYSTEM / *SUBSYSTEM(...) / *GROUP(...) / *NONE


*GROUP(...)



|

PROFILE-ID = *ALL / <structured-name 1..30>


*SUBSYSTEM(...)



|

SUBSYSTEM-NAME = *ALL / <structured-name 1..8 with-wild(24)>

,SYSTEM-LOGON-PROC = *YES / *NO

,SYSTEM-LOGON-INCL = *YES / *NO

,SYSTEM-LOGOFF-PROC = *YES / *NO

,SYSTEM-LOGOFF-INCL = *YES / *NO

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
garantierte Meldung: CMD0001

1

32

CMD0500

Syntaxbeschreibung in der aktuellen Syntaxdatei fehlerhaft
garantierte Meldung: CMD0500

1

64

CMD0601

Kommando ist der Systembetreuung vorbehalten
garantierte Meldung: CMD0601

1

64

CMD0680

SDF-Parameterdatei fehlerhaft
garantierte Meldungen: CMD0300, CMD0680, CMD0687

 

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

  1. Diese S-Variablen werden nicht erzeugt, wenn im Kommando SYNTAX-FILE-TYPE=*NONE angegegeben wurde.

  2. 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
Wird im Kommando SCOPE=*NEXT-SESSION(...) angegeben, wird der Name der Parameterdatei ausgegeben.

var(*LIST).SCOPE

S

*TEMP
<filename 1..54>


Name der Syntaxdatei

var(*LIST).SF(*LIST).F-NAME

S

<filename 1..54>

a)

SDF-Dateihierarchie bleibt bestehen (zur Syntaxanalyse wird die Systemsyntaxdatei herangezogen).
Für SF(*LIST).TYPE=*SYS bzw. *SUBSYS enthält die S-Variable den Wert ’’.

var(*LIST).SF(*LIST).HIERARCHY

S

’’
*NO
*YES

a)

Name des Subsystems, wenn SF(*LIST).TYPE = *SUBSYS.
Für SF(*LIST).TYPE=*SYS enthält die S-Variable den Wert BS2000.
Bei SF(*LIST).TYPE=*GROUP den Wert ’’.

var(*LIST).SF(*LIST).NAME

S

’’
<struc.-name 1..8>
BS2000

a)

Profile-Id der Gruppensyntaxdatei.
Für SF(*LIST).TYPE=*SYS bzw. *SUBSYS enthält die S-Variable den Wert ’’.

var(*LIST).SF(*LIST).PROF-ID

S

’’<struc.-name 1..30>

a)

Zustand des Subsystems.
Die S-Variable enthält ’’ wenn:
a) SF(*LIST).TYPE=*SYS,
b) SF(*LIST).TYPE=*SUBSYS
c) im Kommando mit SCOPE=*NEXT-SESSION(...) eine Parameterdatei angegeben wurde.
Für Subsysteme, die nicht durch DSSM aktiviert wurden, wird mit folgenden zwei Ausnahmen immer der Status ACTIVE angezeigt:
1) Konnte die Subsystem-Syntaxdatei bei der Systemeinleitung nicht aktiviert werden, wird TO-IMPORT angezeigt.
2) Wurde die Subsystem-Syntaxdatei durch IMON deaktiviert, wird DEACTIVATED angezeigt.

var(*LIST).SF(*LIST).STATE

S

’’
ACTIVE
COEXISTENT
DEACTIVATED
HOLD
IN-EXCHA
IN-HOLD
TO-IMPORT

a)

Typ der Syntaxdatei

var(*LIST).SF(*LIST).TYPE

S

*GROUP
*SUBSYS
*SYS

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
<filename 1..54>

b)

Name der systemweiten LOGOFF-Prozedur (Aufruf mit CALL-PROCEDURE)

var(*LIST).SYS-LOGOFF-PROC

S

*STD
<filename 1..54>

b)

Name der systemweiten LOGON-Prozedur (Aufruf mit INCLUDE-PROCEDURE)

var(*LIST).SYS-LOGON-INCL

S

’’
*STD
<filename 1..54>

b)

Name der systemweiten LOGON-Prozedur (Aufruf mit CALL-PROCEDURE)

var(*LIST).SYS-LOGON-PROC

S

’’
*STD
<filename 1..54>

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