Operating System BS2000 OS DX V1.0 (en)

&pagelevel(3)&pagelevel

Show installation path

Component:	IMON-GPN
Functional area:	System control and optimization
Domain:	SYSTEM-MANAGEMENT
Privileges:	STD-PROCESSING SUBSYSTEM-MANAGEMENT

Function

The SHOW-INSTALLATION-PATH command can be used to show the logical name mapped to the path name of an installation item or to list the path names of all the installation items in an installation unit.
The output can be directed to SYSOUT (default) or to SYSLST.

An installation item which is part of an installation unit is uniquely identified by its logical name. The installation unit is uniquely identified by its name and its version string.

All the installation items in a given installation unit can be selected in a single invocation of the command.

If a partial version specification is used and there are a number of versions of the installation unit, information is supplied for each of these versions. The output consists of the name and version of the installation unit and the logical name, path name and attributes of each of the selected installation items.
The character “*” replaces the path name if the user cannot be shown the path name (i.e. the user is not authorized).

The information shown to nonprivileged users is restricted to installation items on user level TU (task unprivileged).

The command is a component of IMON-GPN. IMON is completely described in the “IMON” manual [19].

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

Privileged functions

Privileged users are shown information on all installation items. The lock status for each installation unit is shown in the output field LOCKED.

Format

SHOW-INSTALLATION-PATH

INSTALLATION-UNIT = *ALL (...) / <text 1..30 without-sep>(...)
	*ALL (...)
		\|	VERSION = *ALL / <product-version>
	<text 1..30 without-sep> (...)
		\|	VERSION = *ALL / <product-version>
,LOGICAL-IDENTIFIER = ALL / NONE / <filename 1..30 without-cat-user-gen-vers with-wild>
,SCI-NAME = *STD / <filename 1..54 without-cat-user-gen-vers>
,OUTPUT = SYSOUT / SYSLST(...)
	*SYSLST(...)
		\|	SYSLST-NUMBER = *STD / <integer 1..99>

Operands

INSTALLATION-UNIT =
Name of the installation unit containing the installation items.

INSTALLATION-UNIT = *ALL(...)
Selects all installation units.

VERSION =
Installation units version.

VERSION = *ALL
Selects all versions of the installation units.

VERSION = <product-version>
Explicit installation unit version specification in the format mm.n[a[so]].

INSTALLATION-UNIT = <text 1..30 without-sep>(...)
Explicit installation unit specification.

VERSION =
Installation unit version.

VERSION = *ALL
Selects all versions of the installation unit.

VERSION = <product-version>
Explicit installation unit version specification in the format mm.n[a[so]].

LOGICAL-IDENTIFIER =
Specifies whether in addition to information on the selected installation unit, information on associated installation items (with logical names) is also to be output. This information can either be requested for a specific logical name or for all logical names.

LOGICAL-IDENTIFIER = *ALL
Information on all logical names and assigned installation items in the selected installation unit is output.

LOGICAL-IDENTIFIER = <filename 1..30 without-cat-user-gen-vers with-wild>Information on the specified logical name and the assigned installation item is output.
A wildcard string can also be specified as the logical name. In this case the “*” symbol (asterisk) represents a placeholder for any string. The additional information is then output for all logical names that match this wildcard string.

LOGICAL-IDENTIFIER = *NONE
Information is output for the selected installation unit only.

SCI-NAME =
Identifies the SCI (System Configuration Inventory) from which the information is to be taken.

SCI-NAME = *STD
The information is taken from the default SCI (see MODIFY-IMON-SCI).

SCI-NAME = <filename 1..54 without-cat-user-gen-vers>
Name of a foreign SCI (catalog ID not the same as the home pubset or not a default name).

OUTPUT =
Identifies the destination for the output.

OUTPUT = *SYSOUT
The information is sent to SYSOUT.

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

SYSLST-NUMBER =
SYSLST number.

SYSLST-NUMBER = *STD
The information is sent to the standard SYSLST device.

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

Return codes

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, version or logical identifier not found.

Output in S variables

Output information	Name of the S variable	T	Contents
Function level on which the installation unit executes	var(*LIST).IU-FU-LEVEL	S	BOTH TPR *TU
Name of the installation unit	var(*LIST).IU-NAME	S	<c-string 1..30>
Version of the installation unit	var(*LIST).IU-VERSION	S	'' <product-version 4..7>
Lock status of the installation unit (only for privileged users)	var(*LIST).IU-LOCKED	S	YES NO
Dummy installation item present	var(LIST).IU-II-LIST(LIST).II-DUMMY	B	FALSE TRUE
Full or partially-qualified path name was output	var(LIST).IU-II-LIST(LIST).II-FILETYPE	S	FULL PARTIAL
Function level on which the installation unit executes	var(LIST).IU-II-LIST(LIST).II-FU-LEVEL	S	BOTH TPR *TU
Logical name of the installation item	var(LIST).IU-II-LIST(LIST).II-LOGICAL-ID	S	<filename 1..30>
The path name associated with a logical name must be present at installation	var(LIST).IU-II-LIST(LIST).II-MANDATORY	B	FALSE TRUE
Path name of the installation item	var(LIST).IU-II-LIST(LIST).II-PATH-NAME	S	<filename 1..54>
Hardware variant of the installation item	var(LIST).IU-II-LIST(LIST).II-TARGET	S	<text 1..1>
The file name associated with the logical name may be changed after installation	var(LIST).IU-II-LIST(LIST).II-UPDATE	B	FALSE TRUE

Example

Requesting information on the syntax file of the product LMS

/show-inst-path inst-unit=lms,logic-id=syssdf

INSTALLATION UNIT: LMS                            VERSION : 03.4B00
                                                  FU-LEVEL: TU
   
  LOGICAL-ID: SYSSDF                           TARGET: A (ANY)
   PATH-NAME: :1OSH:$TSOS.SYSSDF.LMS.034
   MANDATORY: YES  UPDATE: NO   DUMMY: NO   FILENAME: FULL    FU-LEVEL: TU
%  IMO9001 Command successfully processed

Output information on all installation units

/show-inst-path inst-unit=*all,logic-id=*none

INSTALLATION UNIT: ACS                            VERSION : 20.0A00
                                                  FU-LEVEL: TU
   
INSTALLATION UNIT: AID                            VERSION : 03.4B23 
                                                  FU-LEVEL: BOTH
   
   . 
   . 
   . 
INSTALLATION UNIT: WEBTRANS-OSD                   VERSION : 07.5B00
                                                  FU-LEVEL: TU
   
INSTALLATION UNIT: WEBTRANS-UTM                   VERSION : 07.5B00
                                                  FU-LEVEL: TU
   
INSTALLATION UNIT: XCS-TIME                       VERSION : 20.0A00
                                                  FU-LEVEL: TPR
   
INSTALLATION UNIT: XHCS-SYS                       VERSION : 02.2A02
                                                  FU-LEVEL: BOTH
%  IMO9012 Insufficient privilege to show more information
%  IMO9001 Command successfully processed

Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly

SHOW-INSTALLATION-PATH