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-OPTIONS

&pagelevel(3)&pagelevel

Show active syntax files and SDF options

Component:

SDF                                                                                                                

Functional area:

SDF control

Domain:

SDF

Privileges:

STD-PROCESSING
TSOS
HARDWARE-MAINTENANCE
SAT-FILE-EVALUATION
SAT-FILE-MANAGEMENT
SECURITY-ADMINISTRATION

Function

The SHOW-SDF-OPTIONS command displays the names and versions of the currently active syntax files as well as the current settings of the SDF options. For syntax files, it always displays their real file names, even if the user entered a MODIFY-SDF-OPTIONS command in order to specify a user syntax file using the appropriate alias name declared in the alias catalog (see the ADD-ALIAS-CATALOG-ENTRY command).

The INFORMATION operand controls the scope of the information to be displayed. INFORMATION=*USER provides information only on settings which the user can modify via MODIFY-SDF-OPTIONS for each task: this information includes the names and versions of all activated user syntax files and all settings of the SDF options. INFORMATION=*GROUP provides the names and versions of the activated group syntax files in addition to the user-specific settings.

The MODIFY-SDF-OPTIONS command can then be used to activate or deactivate user syntax files and to change the settings of SDF options for a specific task.

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

Format

SHOW-SDF-OPTIONS                                                     

Alias: SHSDFO

INFORMATION = *ALL / *USER / *GROUP

Operands

INFORMATION = *ALL / *USER / *GROUP
Determines the scope of the information to be displayed.

INFORMATION = *ALL
Outputs information on the activated syntax files and the current settings of the SDF options

INFORMATION = *USER
Outputs information on the activated user syntax files and the current settings of the SDF options.

INFORMATION = *GROUP
Outputs information on the activated group and user syntax files and the current settings of the SDF options. 

Return codes

(SC2)

SC1

Maincode

Meaning


0

CMD0001

Command executed without errors

Output format

The output fields and values under the heading “CURRENT SDF OPTIONS” correspond to the operands and operand values of the MODIFY-SDF-OPTIONS command.

Output field

Meaning and possible values

SYNTAX FILES CURRENTLY ACTIVATED:

Header line for information on the activated syntax files

  • SYSTEM

Name of the active system syntax file

  • VERSION

Version of the system syntax file

  • SUBSYSTEM

Name of an active subsystem syntax file

  • VERSION

Version of the subsystem syntax file

  • GROUP

Name of an active group syntax file

  • VERSION

Version of the group syntax file; omitted if no group syntax file is activated (GROUP=*NONE)

  • USER

Name of an active user syntax file

  • VERSION

Version of the user syntax file; omitted if no user syntax file is activated (USER=*NONE)

  • CURRENT SDF OPTIONS:

Header line for information on the current settings of the SDF options

  • GUIDANCE

Guidance level:
*EXPERT / *NO / *MINIMUM / *MEDIUM / *MAXIMUM

  • LOGGING

Scope of the logging of commands and statements:
*INPUT-FORM / *ACCEPTED-FORM / *INVARIANT-FORM

  • CONTINUATION

Command continuation:
*OLD-MODE / *NEW-MODE 

  • UTILITY-INTERFACE

Input interface for utilities:
*OLD-MODE / *NEW-MODE

  • PROCEDURE-DIALOGUE

Syntax error dialog or help dialog in procedures:
*YES /*NO

  • MENU-LOGGING

Menu logging:
*YES /*NO

  • CMD-STATISTICS

Output for privileged users only (TSOS)
Statistical recording of commands:
*YES /*NO

  • MODE

Syntax check of commands:
*EXECUTION / *TEST

  • CHECK-PRIVILEGES

Consideration of privileges during syntax check:
*YES /*NO

  • DEFAULT-PROGRAM-NAME

Syntax check of statements of a program:
*NONE / <structured-name 1..20>

  • FUNCTION-KEYS

Function key assignment:
*OLD-MODE / *NEW-MODE

  • INPUT-HISTORY

Input buffer:
*ON / *OFF

  • NUMBER-OF-INPUTS

Size of the input buffer (maximum number of inputs that can be saved):
<integer 1..100>

  • PASSWORD-PROTECTION

Protection of secret operand values in the input buffer:
*YES / *NO

Table 150: Output format of the SHOW-SDF-OPTIONS command

Output in S variables

The INFORMATION operand controls the output scope with regard to the active syntax files: *GROUP suppresses the information on system and subsystem files, and *USER suppresses the information on system, subsystem and group syntax files. A variable structure SF with the S variables F-NAME, TYPE, and VERSION is created for each active syntax file contained in the output. Exception: If no user syntax file is activated, a variable structure with TYPE=*USER is created anyway, with the F-NAME and VERSION variables containing the empty string.

Output information

Name of the S variable             

T

Contents                      

Condition

Check privileges during syntax check

var(*LIST).CHECK-PRIV

S

*NO
*YES


Command history statistics are written on the basis of the system syntax file.
The values *NO and *YES are output only for users with TSOS privilege. A value of '' is output for users without TSOS privilege.

var(*LIST).CMD-STATIS

S

''
*NO
*YES


Position of the continuation character for command input
*NEW-MODE: in columns 2 thru 72
*OLD-MODE: in column 72

var(*LIST).CONTI

S

*NEW-MODE
*OLD-MODE


Function of key mapping

var(*LIST).FUNC-KEY

S

*OLD-MODE
*STYLE-GUIDE-MODE


Dialog guidance mode

var(*LIST).GUIDE

S

*EXPERT
*MAX
*MED
*MIN
*NO


Command input history feature active

var(*LIST).INPUT-HIST

S

*OFF
*ON


Logging form for commands and statements

var(*LIST).LOG

S

*ACCEPT-FORM
*INPUT-FORM
*INVARIANT-FORM


Full menu logging in guided dialog

var(*LIST).MENU-LOG

S

*NO
*YES


Execution of all issued commands (*EXEC) or command syntax checking (*TEST) on input; the MODIFY-SDF-OPTIONS command is always executed

var(*LIST).MODE

S

*EXEC
*TEST


Size of the input buffer

var(*LIST).NUM-OF-INPUT

I

<integer 0..100>


Passwords are replaced by ^ in the buffer and ISP commands are not recorded

var(*LIST).PASSWORD-PROT

S

*NO
*YES


Invalid procedure commands can be corrected during the procedure run

var(*LIST).PROC-DIALOG

S

*NO
*YES


Syntax file name.
If INF=*USER is specified in the command and no user syntax file is active, the S variable is assigned the null string ''

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

S

''
<filename 1..54>


Syntax file type.
If INF=*USER is specified in the command and no syntax file is active, the S variable is nonetheless assigned a value of *USER; the SF(*LIST).F-NAME and SF(*LIST).VERSION variables are assigned the null string ''

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

S

*GROUP
*SUBSYS
*SYS
*USER


Syntax file version.
If INF=*USER is specified in the command and no syntax file is active, the S variable is assigned the null string ''

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

S

''
UNDEFINED
<text 1..12>


Name of the test program used for syntax checking on SDF program statements. Syntax checking enabled with MODE=*TEST.

var(*LIST).TEST-PROG-NAME

S

*NONE
<struc.-name 1..30>


Input interface mode for utilities which offer both old-style (*OLD-MODE) and new-style (*NEW-MODE) interfaces

var(*LIST).UTILITY-INTERF

S

*NEW-MODE
*OLD-MODE


Examples

Output in S variable

/declare-var var-name=var(type=*structure),multiple-elem=*list
/exec-cmd cmd=(show-sdf-options inf=*all),text-output=*none,structure-output=var
/show-var var,inf=*par(val=*c-literal,list-index=*yes)

VAR#1.SF#1.F-NAME = ':1OSH:$TSOS.SYSSDF.SDF.048'
VAR#1.SF#1.TYPE = '*SYS'
VAR#1.SF#1.VERSION = 'SESD04.8A00'
*END-OF-VAR
VAR#1.SF#2.F-NAME = ':1OSH:$TSOS.SYSSDF.ACS.200'
VAR#1.SF#2.TYPE = '*SUBSYS'
VAR#1.SF#2.VERSION = 'SESD20.0A000'
*END-OF-VAR
...........
...........

VAR#1.SF#161.F-NAME = ':1OSH:$TSOS.SYSSDF.TASKDATE.200'
VAR#1.SF#161.TYPE = '*SUBSYS'
VAR#1.SF#161.VERSION = 'SESD20.0A000'
*END-OF-VAR
OUT#1.SF#162.F-NAME = ':1OSH:$TSOS.SYSSDF.BCAM.240.CMD'
OUT#1.SF#162.TYPE = '*SUBSYS'
OUT#1.SF#162.VERSION = 'SESD24.0A000'
VAR#1.SF#163.F-NAME = ':2OSG:$USER1.SDF.USER.SYNTAX'
VAR#1.SF#163.TYPE = '*USER'
VAR#1.SF#163.VERSION = 'UNDEFINED'
*END-OF-VAR
VAR#1.GUIDE = '*EXPERT'
VAR#1.LOG = '*INPUT-FORM'
VAR#1.CONTI = '*NEW-MODE'
VAR#1.UTILITY-INTERF = '*NEW-MODE'
VAR#1.PROC-DIALOG = '*NO'
VAR#1.MENU-LOG = '*NO'
VAR#1.CMD-STATIS = ''
VAR#1.MODE = '*EXEC'
VAR#1.CHECK-PRIV = '*YES'
VAR#1.TEST-PROG-NAME = '*NONE'
VAR#1.FUNC-KEY = '*STYLE-GUIDE-MODE'
VAR#1.INPUT-HIST = '*ON'
VAR#1.NUM-OF-INPUT = 20
VAR#1.PASSWORD-PROT = '*YES'
*END-OF-VAR
*END-OF-CMD

Output on SYSOUT

/show-sdf-opt ——————————————————————————————————————————————————— (1)

%SYNTAX FILES CURRENTLY ACTIVATED :
%  SYSTEM    : :1OSH:$TSOS.SYSSDF.SDF.048
%              VERSION : SESD04.8A00
%  SUBSYSTEM : :1OSH:$TSOS.SYSSDF.ACS.200
%              VERSION : SESD20.0A000
   .
   .
   .
%  SUBSYSTEM : :1OSH:$TSOS.SYSSDF.TASKDATE.200
%              VERSION : SESD20.0A000
%  SUBSYSTEM : :1OSH:$TSOS.SYSSDF.BCAM.240.CMD
%              VERSION : SESD24.0A000
%  GROUP     : *NONE
%  USER     : :2OSG:$USER1.SYSSDF.USER.SYNTAX
%              VERSION : UNDEFINED
%CURRENT SDF OPTIONS :
%  GUIDANCE           : *EXPERT
%  LOGGING            : *INPUT-FORM
%  CONTINUATION       : *NEW-MODE
%  UTILITY-INTERFACE  : *NEW-MODE
%  PROCEDURE-DIALOGUE : *NO
%  MENU-LOGGING       : *NO
%  MODE               : *EXECUTION
%     CHECK-PRIVILEGES   : *YES
%  DEFAULT-PROGRAM-NAME : *NONE
%  FUNCTION-KEYS      : *STYLE-GUIDE-MODE
%  INPUT-HISTORY      : *ON
%     NUMBER-OF-INPUTS   : 20
%     PASSWORD-PROTECTION: *YES

/mod-sdf-opt syntax=*add(syssdf.user.special.01) —————————————————————— (2)
/show-sdf-opt inf=*user ——————————————————————————————————————————————— (3)

%  USER      : :2OSG:$USER1.SDF.USER.SYNTAX
%              VERSION : UNDEFINED
%  USER      : :2OSG:$USER1.SYSSDF.USER.SPECIAL.01
%              VERSION : UNDEFINED
%CURRENT SDF OPTIONS :
%  GUIDANCE           : *EXPERT
%  LOGGING            : *INPUT-FORM
%  CONTINUATION       : *NEW-MODE
%  UTILITY-INTERFACE  : *NEW-MODE
%  PROCEDURE-DIALOGUE : *NO
%  MENU-LOGGING       : *NO
%  MODE               : *EXECUTION
%     CHECK-PRIVILEGES   : *YES
%  DEFAULT-PROGRAM-NAME : *NONE
%  FUNCTION-KEYS      : *STYLE-GUIDE-MODE
%  INPUT-HISTORY      : *ON
%     NUMBER-OF-INPUTS   : 20
%     PASSWORD-PROTECTION: *YES

(1)

The SHOW-SDF-OPTIONS command displays information on all activated syntax files and the SDF options set. The output of the subsystem syntax files can be very extensive, depending on the number of activated subsystems. This example shows only an excerpt. The user syntax file SYSSDF.SDF.USER.SYNTAX is active.

(2)

The user syntax file SYSSDF.USER.SPECIAL01 is activated with the MODIFY-SDF-OPTIONS command.

(3)

The SHOW-SDF-OPTIONS command with INFORMATION=*USER provides information on activated user syntax files and the SDF options set.

Powered by Atlassian Confluence and Scroll Viewport.