SET-INSTALLATION-PATH

Define/modify installation path

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

Function

The SET-INSTALLATION-PATH command allows systems support staff

• to assign a path name to the logical name of an installation item or to modify this path name.

• modify all path names of an installation unit by replacing a (sub)string of the name with a different string.

The SHOW-INSTALLATION-PATH command provides information on current assignments.

Each installation item has a logical name or identifier. A product is uniquely identified by its name and its version string.

Prerequisites for the command

The product’s installation items must be included in the SCI along with their path names. This precondition is fulfilled in the following cases:

• The product is a standard software product. It was supplied by Fujitsu Technology Solutions (SOLIS2 delivery) and installed correctly using IMON.

• The product is a private software product. It was registered in SCI using a SYSSII file generated by the customer.

The path name is only allocated if its attributes allow it.

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

Format

SET-INSTALLATION-PATH

SCI-NAME = *STD / <filename 1..54 without-gen-vers>
,LEVEL = *ITEM(...) / *UNIT(...)
	*ITEM(...)
		|	PATH-NAME = *NONE / <filename 1..54 without-gen-vers> / <partial-filename 2..53>
		|	,LOGICAL-IDENTIFIER = <filename 1..30 without-cat-user-gen-vers>
		|	,TARGET = *STD / A / S / P / K
		|	,INSTALLATION-UNIT = <text 1..30 without-sep>(...)
		|		<text 1..30 without-sep> (...)
		|			|	VERSION = <product-version mandatory-man-corr>
	*UNIT(...)
		|	,INSTALLATION-UNIT = <text 1..30 without-sep>(...)
		|		<text 1..30 without-sep> (...)
		|			|	VERSION = <product-version mandatory-man-corr> /
		|			|	<product-version mandatory-man-without-corr> / <product-version without-man-corr>
		|	,OLD-STRING = <filename 1..22 without-gen-vers> / <partial-filename 2..23>
		|	,NEW-STRING = <filename 1..22 without-gen-vers> / <partial-filename 2..23>
,ENFORCE = *NO / *YES

Operands

SCI-NAME =
Defines the SCI to be processed.

SCI-NAME = *STD
The standard SCI is processed (the files $TSOS.SYS.IMON.SCI and $TSOS.SYS.IMON.SCI.GPN).

SCI-NAME = <filename 1..54 without-gen-vers>
Name of the alien SCI. Alien SCIs (e.g. on imported pubsets) can be modified using this operand. If the name of an IMON SCI is specified, the relevant IMON-GPN-SCI is also accepted by the suffix .GPN automatically being added.

LEVEL =
Defines the operation to be carried out.

LEVEL = *ITEM(...)
A path name is to be set (or possibly reset) and linked with the logical name of an item of an existing installation unit.

PATH-NAME =
Designates the path name assigned to the logical name of the installation item.

PATH-NAME = *NONE
No path name is assigned to the logical name. Any existing assignment is canceled.

PATH-NAME = <filename 1..54 without-gen-vers>
Explicit path name specification.

PATH-NAME = <partial-filename 2..53>
The path name is specified in partially qualified form. It refers to all files assigned to the logical name.

LOGICAL-IDENTIFIER =
Designates the logical name of the installation item.

LOGICAL-IDENTIFIER = <filename 1..30 without-cat-user-gen-vers>
Explicit specification of the logical name of the installation item.

TARGET =
Specifies the hardware version of the subsystem to which the installation item belongs.

TARGET = *STD
The current system’s standard selection procedure is used.

TARGET = A
The installation item is independent of the hardware version.

TARGET = S
The installation item pertains to the /390 version of the subsystem (SU /390 and S server).

TARGET = P
This hardware version is meaningless for systems as of BS2000/OSD V9.0.

TARGET = K
The installation item belongs to the X86 version of the subsystem (SU x86).

INSTALLATION-UNIT = <structured-name 1..30>(...)
Name of the installation unit containing the logical name.

VERSION = <product-version mandatory-man-corr>
Explicit installation unit version specification.

LEVEL = *UNIT(...)
A string or substring in all path names of the specified installation unit(s) is to be replaced.

INSTALLATION-UNIT = <text 1..30 without-sep>(...)
Name of the installation unit containing the logical name.

VERSION = <product-version mandatory-man-corr> / <product-version mandatory-man-without-corr> / <product-version without-man-corr>
Explicitly specified version of the installation unit.

OLD-STRING = <filename 1..22 without-gen-vers> / <partial-filename 2..23>
String to be searched for in the path names and to be replaced by the string specified with NEW-STRING.

NEW-STRING = <filename 1..22 without-gen-vers> / <partial-filename 2..23>
New string that will be inserted in the place of the OLD-STRING.

ENFORCE = *NO / YES
Determines whether the path name can be assigned even though the logical name was defined with UPDATE=NO (see the “IMON” manual [19]).

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	Command successfully executed
	32	IMO9101	Command terminated abnormally (internal error in IMON-GPN)
	64	CMD0216	User does not have required privilege
	64	IMO9100	Command not executed. Installation unit or version not found, or path name cannot be modified.