SHOW-SYNTAX-FILE Output information on syntax file

Privileges:                  STD-PROCESSING, TSOS

The SHOW-SYNTAX-FILE statement returns information on a system or group syntax file; this can be either a currently processed or explicitly defined syntax file.

This statement displays the following information:

• name, type, version and format of the syntax file

  The current format is V4.1. Formats V1 through V4 are historical and can only occur in older syntax files.

• version information on products included in the syntax file

• global information from the syntax file (in sections)

• privileges of commands only for INFORMATION=CMD-INTERFACE)

SHOW-SYNTAX-FILE

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

,INFORMATION = ALL-ATTRIBUTES / VERSIONS / GLOBALS / CMD-INTERFACE

,PRODUCT-NAME = *ALL / <structured-name 1..15>

FILE =
Defines the system or group syntax file for which information is to be output.

FILE = *CURRENT
The operand value can only be specified after at least one preceding OPEN statement. Information relates to:

• the syntax file specified under INPUT-FILE in an immediately preceding OPEN statement

• the current temporary SDF-I work file after a MERGE or REMOVE statement.

FILE = *INPUT-FILE
The operand value can only be specified after at least one preceding OPEN statement. Information relates to the input syntax file specified under INPUT-FILE in the OPEN statement.

FILE = <filename 1..54>
Information related to the explicitly specified system or group syntax file is output.

INFORMATION =
Defines the type of information which is output. All outputs include the syntax file type (GROUP or SYSTEM).

INFORMATION = ALL-ATTRIBUTES
The following information is output:

• name, type, version and format of the syntax file

• versions of all SUSFs contained in the specified syntax file
  (*CUSTOM* is output as the version for user-created syntax files)

• SDF global information (in sections)

INFORMATION = VERSIONS
The following information is output:

• name, type, version and format of the syntax file

• versions of all SUSFs contained in the specified syntax file
  (*CUSTOM* is output as the version for user-created syntax files)

INFORMATION = GLOBALS
The following information is output:

• name, type, version and format of the syntax file

• SDF global information (in sections)

INFORMATION = CMD-INTERFACE
Outputs the name, type, version and format of the syntax file and a list of commands defined in the syntax file. The list also includes the privileges for commands (see example on "SHOW-SYNTAX-FILE Output information on syntax file ").

PRODUCT-NAME =
This operand is effective only if INFORMATION=CMD-INTERFACE is set. It specifies if only the commands for a specific product are to be output.

PRODUCT-NAME = *ALL
All commands of the specified syntax file are output.
When an SUSF (software unit syntax file) or INSF (installation syntax file) supplied by Fujitsu is output, commands created by the customer and merged into these files are not displayed.

PRODUCT-NAME = <structured-name 1..15>
All commands of the specified product are output.
If commands created by the customer were merged into an SUSF (software unit syntax file) or INSF (installation syntax file) supplied by Fujitsu are displayed, then the REMOVE-ID used during the merge must be used as the product name.

Example

/start-sdf-i ——————————————————————————————————————————————————————————  (1)
*%  BLS0500 PROGRAM 'SDF-I', VERSION 'Vnn.nAnn' OF 'yyyy-mm-dd' LOADED
%  BLS0552 COPYRIGHT (C) yyyy FUJITSU TECHNOLOGY SOLUTIONS GMBH. ALL RIGHTS
RESERVED
*show-syntax-file $.syssdf.bs2cp.170,information=cmd-interface ————————  (2)
% SYNTAX FILE : :1OSH:$TSOS.SYSSDF.BS2CP.170
% TYPE : SYSTEM    VERSION : SESD17.0A300    FORMAT : V4.1 ————————————  (3)
%
% COMMANDS INFORMATIONS :
% -----------------------
%           EXT.NAME            INT.NAME  ENTRY   INT  PRODUCT
%           --------            --------  -----   ---  -------
% $CMSSCAS                      $CMSSCAS DSCSCCH  ISL
% ALL  1000000000000000000000000000000000000000000000000000000000000000
% $CMSSCAV                      $CMSSCAV DSCVLCH  ISL
% ALL  1000000000000000000000000000000000000000000000000000000000000000
% $DMAWCC1                      $DMAWCC1 DMAWICA  ISL
% ALL  1111111111111111111111111111111111111111111111111111111111111111
.
.
% ADD-CONSOLE-FILTER            $OPRACF  NBOAFIL  ISL
% ALL  0000000000000000000000000000000001000000000000000000000000000000
% ADD-DEVICE-DEPOT              NKCADDE  NKCADDE  ISL
% ALL  0000000000000000000000000000000001000000000000000000000000000000
% ADD-FILE-LINK                 $DCOAFL  DCOADFL  ISL
% ALL  0000001000110000000000000000000010000000000000000000000000000000
.
.
% SHOW-FILE                     SHFIL    DSHOWCM  ISL
% ALL 0100001000110000000000000000000010000000000000000000000000000000 (4)
% BA  0000000000000000000000000000000000000000000000000000000000000000 (4)
% BPA 0000000000000000000000000000000000000000000000000000000000000000 (4)
% DA  0100001000110000000000000000000010000000000000000000000000000000 (4)
% DPA 0100001000110000000000000000000010000000000000000000000000000000 (4)
% GA  0100001000110000000000000000000010000000000000000000000000000000 (4)
% CA  0100001000110000000000000000000010000000000000000000000000000000 (4)
% SHOW-FILE-ATTRIBUTES          SHFAT    DCOFSDF ISL
% ALL 0100001000110000000000000000000010000000000000000000000000000000
% SHOW-FILE-LINK                SHFILI   DCORTF2 ISL
% ALL 0000001000110000000000000000000010000000000000000000000000000000
.
.
% WRITE-ACCOUNTING-RECORD       WRACRE   NACPWAC ISL
% ALL 0000000000100000000000000000000010000000000000000000000000000000
* ————————————————————————————————————————————————————————————————————— (5)


                                                                                          

(1)

SDF-I is started.

(2)

Information is requested on the commands and their privileges contained in the basic BS2000 system syntax file. The output is displayed in the example in sections.

(3)

The syntax file has the current V4.1 format. Only for older syntax files another format (V1, V2, V3, V4) can be displayed.

(4)

The output includes, among other things, the privileges for the SHOW-FILE command (ALL line) and the possible input modes. The input modes correspond to the modes that were specified in the command definition with ADD-CMD (see the “SDF-A” [4] manual):

BA: BPA: DA: DPA: GA: CA:

BATCH-ALLOWED BATCH-PROC-ALLOWED DIALOG-ALLOWED DIALOG-PROC-ALLOWED GUIDED-ALLOWED CMD-ALLOWED

Following the input mode, the related privileges are output in the remainder of the line. Each character (0 or 1) represents a privilege. 1 means that execution of the command is permitted in this mode for a user job with this privilege. The order of privileges in this string corresponds to the order in which the privileges have been currently defined in the system. If no line is output for a particular input mode, then PRIVILEGE=*SAME is defined for the input mode implicitly, i.e. the privileges are exactly the same as those defined for the command.

(5)

Following the output, SDF-I requests further inputs with the '*' prompt.