SHOW-SELECTED-PRODUCT-VERSION

Show selected product version

Component:	IMON-GPN
Functional area:	Program control
Domain:	PROGRAM PROGRAMMING-SUPPORT SYSTEM-MANAGEMENT UTILITIES
Privileges:	STD-PROCESSING

Function

The SHOW-SELECTED-PRODUCT-VERSION command allows nonprivileged users to check the product version of an installation unit or of a DSSM subsystem (TU), as selected with the SELECT-PRODUCT-VERSION command.

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

Format

SHOW-SELECTED-PRODUCT-VERSION                                                                                                 

PRODUCT-NAME = *ALL / <text 1..30 without-sep>
,OUTPUT = *SYSOUT / *SYSLST(...)
	*SYSLST(...)
		|		SYSLST-NUMBER = *STD / <integer 1..99>

Operands

PRODUCT-NAME = *ALL / <text 1..30 without-sep>(...)
Specifies the name of the product. For subsystems (TU) loaded by DSSM this is the name of the subsystem; for IMON it is the name of an installation unit.

OUTPUT =
Determines where the output is sent.

OUTPUT = *SYSOUT
The information is written to SYSOUT.

OUTPUT = *SYSLST(...)
The information is written to SYSLST.

SYSLST-NUMBER =
SYSLST number.

SYSLST-NUMBER = *STD
The information is written to the default SYSLST file.

SYSLST-NUMBER = <integer 1..99>
Explicit SYSLST number specification. 

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	Command successfully executed
	32	IMO9101	Command terminated abnormally. Internal error in IMON-GPN
	64	IMO9100	Command not executed. Installation unit or version not found

Output in S variables

Output information	Name of the S variable	T	Contents	Condition
Product name (name of the installation unit)	var(*LIST).PRODUCT-NAME	S	<c-string 1..30>
The version of the product defined for SCOPE=*PROGRAM	var(*LIST).PROGRAM-SELECTION	S	'' <product-version 4..7>
The version of the product defined for SCOPE=*SYSTEM	var(*LIST).SYSTEM-SELECTION	S	'' <product-version 4..7>
The version of the product defined for SCOPE=*TASK	var(*LIST).TASK-SELECTION	S	'' <product-version 4..7>

Example

/show-select-product

PRODUCT NAME                   PROGRAM  TASK     SYSTEM
------------------------------  -------  -------  -------
EDT                                      17.0
SDF-A                          04.1
%  IMO9001 Command successfully processed