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

Show entries in SDF parameter file

Component:

SDF

Functional area:

SDF control

Domain:

SDF

Privileges:

TSOS

Routing code:

@

Function

The SHOW-SDF-PARAMETERS command provides information on the entries of an SDF parameter file. The names of the system syntax files and all PROFILE-ID allocations to a group syntax file are displayed. There is also an option for including the names of the system-wide LOGON or LOGOFF procedures (call and include procedures).

Subsystem syntax files located on a pubset that were not available during system initialization are not displayed. These syntax files can only be activated when importing the pubset.

The command supports structured output in S variables (see "Output in S variables").

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

Operands

SCOPE =
Defines the scope of the information requested.

SCOPE = *TEMPORARY
The syntax files which were activated during the current session and/or the system-wide LOGON or LOGOFF procedures are output.

SCOPE = *NEXT-SESSION(...)
The syntax files and/or the system-wide LOGON or LOGOFF procedures stored in an SDF parameter file are output.

PARAMETER-FILE-NAME =
Specifies the SDF parameter file in which the requested information is stored.

PARAMETER-FILE-NAME = *CURRENT
The required information is stored in the current SDF parameter file, which was used when the session was started.

PARAMETER-FILE-NAME = <filename 1..54>
The fully qualified name of the SDF parameter file in which the requested information is stored. If alias names are being used, the name displayed for the SDF parameter file can be taken as being the result of a file name replacement carried out by ACS. Only if no alias name was declared for the SDF parameter file will the fully qualified, real, name of the SDF file be stored and output.

SYNTAX-FILE-TYPE =
Specifies the name(s) of the syntax files to be displayed.

SYNTAX-FILE-TYPE = *ALL
The output is to show the names of the basic system syntax file, of the subsystem syntax files (in conjunction with the names of the subsystems), and the names of the group syntax files (with their associated PROFILE-IDs).

SYNTAX-FILE-TYPE = *SYSTEM
The name of the basic system syntax file is to be output.

SYNTAX-FILE-TYPE = *SUBSYSTEM(...)
The names of the subsystem syntax files are to be output.

SUBSYSTEM-NAME =
Specifies the subsystems for which the syntax files are to be selected.

SUBSYSTEM-NAME = *ALL
The names of all the system syntax files which are assigned to a subsystem are to be output.

SUBSYSTEM-NAME = <structured-name 1..8 with-wild(24)>
The syntax files of the specified subsystems are to be displayed.

SYNTAX-FILE-TYPE = *GROUP(...)
The names of the group syntax files are to be output.

PROFILE-ID =
Uses the PROFILE-ID to determine the names of the group syntax files which are to be displayed.

PROFILE-ID = *ALL
The names of all group syntax files (in conjunction with the associated PROFILE-IDs) are to be output.

PROFILE-ID = <structured-name 1..30>
Specifies the PROFILE-IDs whose assigned group syntax files are to be displayed by name.

SYNTAX-FILE-TYPE = *NONE
No syntax file names will be displayed.

SYSTEM-LOGON-PROC = *YES / *NO
Specifies whether to display the name of the system-wide LOGON call procedure (invoked with the CALL-PROCEDURE command).

SYSTEM-LOGON-INCL = *YES / *NO
Specifies whether to display the name of the system-wide LOGON include procedure (invoked with the INCLUDE-PROCEDURE command).

SYSTEM-LOGOFF-PROC = *YES / *NO
Specifies whether to display the name of the system-wide LOGOFF call procedure (invoked with the CALL-PROCEDURE command).

SYSTEM-LOGOFF-INCL = *YES / *NO
Specifies whether to display the name of the system-wide LOGOFF include procedure (invoked with the INCLUDE-PROCEDURE command).

Return codes

(SC2)

SC1

Maincode

Meaning/Guaranteed messages


0

CMD0001

No errors
Guaranteed message: CMD0001

1

32

CMD0500

Erroneous syntax description in the current syntax file
Guaranteed message: CMD0500

1

64

CMD0601

Command is reserved for systems support
Guaranteed message: CMD0601

1

64

CMD0680

Error in SDF parameter file
Guaranteed messages: CMD0300, CMD0680, CMD0687

Output in S variables

All the operands of the command (SCOPE, SYNTAX-FILE-TYPE, SYSTEM-LOGOFF-INCL, SYSTEM-LOGOFF-PROC, SYSTEM-LOGON-INCL and SYSTEM-LOGON-PROC) support structured output in S variables. As a rule, all the S variables are generated. 

Exceptions

The exceptions to this rule are the S variables marked a), b) or c) in the “Condition” column:

  1. These S variables are not generated if SYNTAX-FILE-TYPE=*NONE is specified in the command.

  2. This S variable is not generated if no corresponding LOGON- or LOGOFF procedure was specified in the command (e.g. SYSTEM-LOGON-PROC=*NONE). 

Output information

Name of the S variable   

T

Contents                

Condition

Scope of the active syntax files.
If SCOPE=*NEXT-SESSION(...) is specified in the command, the name of the parameter file is output.

var(*LIST).SCOPE

S

*TEMP
<filename 1..54>


Syntax file name

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

S

<filename 1..54>

a)

The SDF file hierarchy is retained (the system syntax file is used for syntax analysis)
With SF(*LIST).TYPE=*SYS or *SUBSYS the value of the S variable is ''

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

S

''
*NO
*YES

a)

Subsystem name with SF(*LIST).TYPE =*SUBSYS.
With SF(*LIST).TYPE=*SYS the value of the S variable is BS2000. With SF(*LIST).TYPE=*GROUP the value of the S variable is ''

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

S

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

a)

Profile ID of the group syntax file.
With SF(*LIST).TYPE=*SYS or *SUBSYS the value of the S variable is ''

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

S

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

a)

Subsystem status.

The value of the S variable is'' in the following cases:
a) SF(*LIST).TYPE=*SYS;
b) SF(*LIST).TYPE=*SUBSYS;
c) a parameter file is specified in the SCOPE=*NEXT-SESSION(...) structure in the command.

ACTIVE status is always displayed for subsystems that are not activated by DSSM, with the following two exceptions:
1) If the subsystem syntax file could not be activated during system initialization, TO-IMPORT is displayed.
2) If the subsystem syntax file is deactivated by IMON, DEACTIVATED is displayed.

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

S

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

a)

Syntax file type

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

S

*GROUP
*SUBSYS
*SYS

a)

Syntax file version

var(*LIST).SF(*LIST).VERSION 

S

<text 1..12>

a)

Name of the system-wide LOGOFF procedure (called with INCLUDE-PROCEDURE)

var(*LIST).SYS-LOGOFF-INCL

S

*STD
<filename 1..54>

b)

Name of the system-wide LOGOFF procedure (called with CALL-PROCEDURE)

var(*LIST).SYS-LOGOFF-PROC

S

*STD
<filename 1..54>

b)

Name of the system-wide LOGON procedure (called with INCLUDE-PROCEDURE)

var(*LIST).SYS-LOGON-INCL

S

''
*STD
<filename 1..54>

b)

Name of the system-wide LOGON procedure (called with CALL-PROCEDURE)

var(*LIST).SYS-LOGON-PROC

S

''
*STD
<filename 1..54>

b)

Examples

/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
Powered by Atlassian Confluence and Scroll Viewport.