SHOW-PACKAGES Output information on software deliveries

Privileges:          SUBSYSTEM-MANAGEMENT

Function

Information on software deliveries that are registered in the open SCI (see "Software Configuration Inventory (SCI) ") are output with the SHOW-PACKAGES statement. Deliveries can also be selected interactively in the dialog mode with the PACKAGE-NAME=*BY-DIALOG operand. 

The statement supports structured output in S variables (see "Output in S variables" "SHOW-PACKAGES Output information on software deliveries ").

Format

SHOW-PACKAGES

PACKAGE-NAME = *ALL / *BY-DIALOG / list-poss(30): <alphanum-name 1..12>
,USER-CODE = *ALL / <alphanum-name 1..8>
,INFORMATION = *PARAMETERS(...)
	*PARAMETERS(...)
		|	SUPPLY-UNITS = *YES / *NO
		|	,REPORT-LEVEL = *MINIMUM / *ALL-ATTRIBUTES
,OUTPUT = *SYSOUT / *SYSLST(...) / *NONE
	*SYSLST(...)
		|	SYSLST-NUMBER = *STD / <integer 1..99>
,STRUCTURE-OUTPUT = *NONE / *SYSINF / <composed-name 1..255>(...)
	<composed-name 1..255>(...)
		|	WRITE-MODE = *REPLACE / *EXTEND
,SELECT = *BY-ATTRIBUTES(...)
	*BY-ATTRIBUTES(...)
		|	CREATION-DATE = *ANY / *INTERVAL(...)
		|		*INTERVAL(...)
		|			|	FROM = *ANY / <date with-compl>(...)
		|			|	,TO = *ANY / <date with-compl>(...)
		|	,CHANGE-DATE = *ANY / *INTERVAL(...)
		|		*INTERVAL(...)
		|			|	FROM = *ANY / <date with-compl>(...)
		|			|	,TO = *ANY / <date with-compl>(...)
		|	,CONTAINED-SU-STATUS = *ANY / *ALL-INSTALLED / *PARTIALLY-INSTALLED / NOTHING-INSTALLED

Operands

PACKAGE-NAME =

Selection of the software deliveries to be displayed using the package name (as specified in the footer of the delivery notification). The output can be restricted to a certain customer ID in the USER-CODE operand.

PACKAGE-NAME = *ALL

All software deliveries registered in the SCI are selected.

PACKAGE-NAME = *BY-DIALOG

The software deliveries are listed in a selection window and can be selected there interactively (see also “Selection of deliveries” in the menu mode on "View menu "). The information requested is output after the software deliveries have been selected by entering any character in front of the corresponding package names and the window has been closed with [DUE]. 
The data must be specified for all customer IDs (USER-CODE=*ALL).

PACKAGE-NAME = list-poss(30): <alphanum-name 1..12>

Only software deliveries with the specified package name are selected.

USER-CODE =

Selection of the software deliveries to be displayed using the customer ID (as specified in the footer of the delivery notification).

USER-CODE = *ALL

Data is output for all customer IDs.

USER-CODE = <alphanum-name 1..8>

Data is output only for software deliveries with the specified customer ID.

INFORMATION = *PARAMETERS(...)

Specifies the scope of the information to be output.

SUPPLY-UNITS = *YES / *NO

Specifies if the supply units contained in the specified deliveries are also to be output.

REPORT-LEVEL =

Controls the output of the attributes of the supply units.

REPORT-LEVEL = *MINIMUM

Only the names of the supply units are output.

REPORT-LEVEL = *ALL-ATTRIBUTES

The names and attributes of the supply units are output.

OUTPUT =

Specifies the destination of the output.

OUTPUT = *SYSOUT

The information is output to SYSOUT.

OUTPUT = *SYSLST(...)

The information is output to SYSLST.

SYSLST-NUMBER =

SYSLST number.

SYSLST-NUMBER = *STD

The information is output to the standard SYSLST.

SYSLST-NUMBER = <integer 1..99>

Specification of the SYSLST number.

OUTPUT = *NONE

No output is generated except structured output when requested.

STRUCTURE-OUTPUT =

Target of structured output when requested.

STRUCTURE-OUTPUT = *NONE

No structured output is requested.

STRUCTURE-OUTPUT = *SYSINF

Specification is only possible if the chargeable subsystem SDF-P is available.

The SYSINF stream is to be used for structured output.

STRUCTURE-OUTPUT = <composed-name 1..255>(...)

Specification is only possible if the chargeable subsystem SDF-P is available.

Name of the S-variable (of the “list” type) to be used for the structured output.

WRITE-MODE = *REPLACE

The S-variable is created or overwritten if already existing.

WRITE-MODE = *EXTEND

S-variable is completed with the new information.

SELECT = *BY-ATTRIBUTES(...)

Limits the selection of deliveries with specific criteria.

CREATION-DATE = *ANY / *INTERVAL(...)

All deliveries are shown according to creation date (time when the delivery was first entered in the SCI).

CREATION-DATE = *ANY

The selection of deliveries is independent of creation date.

CREATION-DATE = *INTERVAL(...)

All the deliveries which were first entered into the SCI within the stated time period are displayed.

Area specifications include the area boundaries.

A meaningful output with area boundaries is only possible, if a lower boundary <= the upper boundary is selected. If no upper or lower boundary is selected (corresponding to the default *ANY), the selection area has no upper or lower limit.

FROM = *ANY / <date with-compl>

All deliveries which were first entered in the SCI after the stated date, are displayed (CREATION-DATE >= stated date).

TO = *ANY / <date with-compl>

All deliveries which were first entered in the SCI before the stated date, are displayed (CREATION-DATE <= stated date).

CHANGE-DATE = *ANY / *INTERVAL(...)

All deliveries are shown, according to change date (the time at which the delivery was last modified in the SCI).

CHANGE-DATE = *ANY

The selection of deliveries is independent of change date.

CHANGE-DATE = *INTERVAL(...)

All deliveries which have been modified in the SCI within the stated time period, are displayed.

Area specifications include the area boundaries.

A meaningful output with area boundaries is only possible, if a lower boundary <= the upper boundary is selected. If no upper or lower boundary is selected (corresponding to the default *ANY), the selection area has no upper or lower limit.

FROM = *ANY / <date with-compl>

All deliveries which were last changed in the SCI after the stated date, are displayed (CREATION-DATE >= stated date).

TO = *ANY / <date with-compl>

All deliveries which were last changed in the SCI before the stated date, are displayed (CREATION-DATE <= stated date).

CONTAINED-SU-STATUS = *ANY / *ALL-INSTALLED / *PARTIALLY-INSTALLED / *NOTHING-INSTALLED

All deliveries are displayed, according to installation status of the supply units that belong to it.

CONTAINED-SU-STATUS = *ANY

The selection of deliveries is independent of the supply units that belong to it.

CONTAINED-SU-STATUS = *ALL-INSTALLED

All deliveries are shown in which all supply units that belong to it have been installed (status “Installed”).

CONTAINED-SU-STATUS = *PARTIALLY-INSTALLED

All deliveries are shown in which only a portion of the supply units that belong to it has been installed (status “Installed”).

CONTAINED-SU-STATUS = *NOTHING-INSTALLED

All deliveries are shown in which none of the supply units that belong to it have been installed (status “Installed”) yet.

Notes

1. In the following cases the statement is rejected without taking any action and an error message is output:

   • Selections are to be made interactively (PACKAGE-NAME=*BY-DIALOG) and an operand value not equal to *ALL was specified in the USER-CODE operand.

   • PACKAGE-NAME=*BY-DIALOG was specified in the batch mode.

   • Package names were specified more than once in a list of package names in the PACKAGE-NAME operand.

2. If there is no delivery for one of the specified package names and customer IDs, then a warning is output and execution of the statement is continued.

3. Supply units already installed using a different package/customer ID are marked with an asterisk after the installation status in the output for a specified package name /customer ID.

Output in S variables

Output information	Name of the S variable	T	Contents
change date	var(*LIST).PACK-CHANGE-DATE	S	yyyy-mm-dd
change time	var(*LIST).PACK-CHANGE-TIME	S	hh:mm:ss
creation date	var(*LIST).PACK-CREA-DATE	S	yyyy-mm-dd
creation time	var(*LIST).PACK-CREA-TIME	S	hh:mm:ss
device type of the delivery (if MEDIUM=A)	var(*LIST).PACK-DEL-DEV-TYPE	S	<device>
delivery library (if MEDIUM=L)	var(*LIST).PACK-DEL-LIB	S	<filename 1..54>
VSN of the delivery (if MEDIUM=A)	var(*LIST).PACK-DEL-VSN	S	<vsn>
documentation library	var(*LIST).PACK-DOC-LIB	S	<filename 1..54>
delivery medium type L=library A=data volume	var(*LIST).PACK-MEDIUM	S	L / A
name of the package	var(*LIST).PACK-NAME	S	<alphanum-name 1..12>
installation status	var(*LIST).PACK-SU(*LIST).SU-INST-STATUS	S	Installed Being installed Parked In Library On SOLIS2 Volume On Local Volume Being deinstalled Partially installed
name of the supply unit	var(*LIST).PACK-SU(*LIST).SU-NAME	S	<text 1..30>
version of the supply unit	var(*LIST).PACK-SU(*LIST).SU-VERSION	S	<product-version 7..7>
number of contained supply units	var(*LIST).PACK-SU-COUNT	I	<integer 0..2147483647>
user code	var(*LIST).PACK-USER-CODE	S	<alphanum-name 1..8>
user ID	var(*LIST).PACK-USID	S	<name 1..8>
work file location	var(*LIST).PACK-WORK-FILE-LOC	S	<filename 1..22>