SHOW-SYNTAX-VERSIONS

Display syntax file versions

Component:	SDF
Functional area:	SDF control
Domain:	SDF
Privileges:	STD-PROCESSING HARDWARE-MAINTENANCE SAT-FILE-EVALUATION SAT-FILE-MANAGEMENT SECURITY-ADMINISTRATION

Function

The SHOW-SYNTAX-VERSIONS command outputs to SYSOUT information on the system, subsystem and group syntax files currently activated for the task. This information includes the names and version statuses of all currently valid syntax descriptions of the software units and components used.
This information can also be requested for a specific software unit or component or a list of them.

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

Format

SHOW-SYNTAX-VERSIONS                                                                                                                       

SOFTWARE-UNIT-NAME = *ALL / list-poss(2000): <structured-name 1..16>

Operands

SOFTWARE-UNIT-NAME = *ALL / list-poss(2000): <structured-name 1..16>
Specifies the names of the software units on which information is to be output. 

Return codes

(SC2)	SC1	Maincode	Meaning/Guaranteed messages
	0	CMD0001	Command executed without errors
1	32	CMD0500	Syntax description in current syntax file invalid
1	64	CMD0811	Command execution not successful. Guaranteed messages: CMD0300, CMD0500, CMD0811

Output in S variables

Output information	Name of the S variable	T	Contents	Condition
Syntax file path name	var(*LIST).F-NAME	S	<filename 1..54>
Software component name	var(*LIST).SW-UNIT(*LIST).COMPONENT(*LIST).NAME	S	<struc.-name 1..15> <struc.-name 16..16>
Software component version	var(*LIST).SW-UNIT(*LIST).COMPONENT(*LIST).VERSION	S	<product-version> <text 8..8>
Software unit name	var(*LIST).SW-UNIT(*LIST).NAME	S	<struc.-name 1..15> <struc.-name 16..16>
Software unit version	var(*LIST).SW-UNIT(*LIST).VERSION	S	<product-version> <text 7..8>
Syntax file type; no distinction is made between system and subsystem syntax files	var(*LIST).TYPE	S	*GROUP *SYS

Examples

Output to SYSOUT

/show-syntax-versions software-unit=(lms,sdf-p)

SYNTAX VERSION OF LMS              :
FOR SYSTEM SYNTAX FILE :
:SQGB:$TSOS.SYSSDF.LMS.035
-------------------------------------------------------
 LMS              = 03.5B00
                    LMS              = 035
SYNTAX VERSION OF SDF-P            :
FOR SYSTEM SYNTAX FILE :
:SQGB:$TSOS.SYSSDF.SDF-P.025
-------------------------------------------------------
 SDF-P            = 02.5F10
                    SDP              = 025
/

Output in S variable

/declare-var var-name=out(type=*structure),multiple-elem=*list
/exec-cmd cmd=(show-syntax-versions software-unit=(lms,sdf-p)),
          text-output=*none,structure-output=out
/show-var out,inf=*par(list-index=*yes)

OUT#1.F-NAME = :SQGB:$TSOS.SYSSDF.LMS.035
OUT#1.TYPE = *SYS
OUT#1.SW-UNIT#1.NAME = LMS
OUT#1.SW-UNIT#1.VERSION = 03.5B00
OUT#1.SW-UNIT#1.COMPONENT#1.NAME = LMS
OUT#1.SW-UNIT#1.COMPONENT#1.VERSION = 035
OUT#2.F-NAME = :SQGB:$TSOS.SYSSDF.SDF-P.025
OUT#2.TYPE = *SYS
OUT#2.SW-UNIT#1.NAME = SDF-P
OUT#2.SW-UNIT#1.VERSION = 02.5F10
OUT#2.SW-UNIT#1.COMPONENT#1.NAME = SDP
OUT#2.SW-UNIT#1.COMPONENT#1.VERSION = 025
/