MODIFY-IMON-SCI

Modify IMON SCI

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

Function

Systems support can use the MODIFY-IMON-SCI command to incorporate path name modifications in the SCI (System Configuration Inventory) of IMON and IMON-GPN.
A catalog ID (e.g. modification of the pubset with PVSREN), a user ID or a prefix can be modified. Systems support can also prepare the SCI for a new pubset.

Format

MODIFY-IMON-SCI                                                                                                                                       

SCI-NAME = *STD / <filename 1..50 without-gen-vers>
,REFERRED-PUBSET = *UNCHANGED / *PARAMETERS(...)
	*PARAMETERS(...)
		|	OLD-NAME = <cat-id 1..4>
		|	,NEW-NAME = <cat-id 1..4>
,REFERRED-USER-ID = *UNCHANGED / *PARAMETERS(...)
	*PARAMETERS(...)
		|	OLD-NAME = <name 1..8>
		|	,NEW-NAME = <name 1..8>
,REFERRED-PREFIX = *UNCHANGED / *PARAMETERS(...)
	*PARAMETERS(...)
		|	OLD-NAME = *NONE / <partial-filename 2..7 without-cat-user>
		|	,NEW-NAME = *NONE / <partial-filename 2..7 without-cat-user>

Operands

SCI-NAME =
Name of the SCI.

SCI-NAME = *STD
The default SCI is used ($TSOS.SYS.IMON.SCI and $TSOS.SYS.IMON.SCI.GPN).

SCI-NAME = <filename 1..50 without-gen-vers>
Specification of the foreign SCI, e.g. the SCI on an imported pubset
(<filename 1..50 without-gen-vers> and <filename 1..50 without-gen-vers>.GPN).

REFERRED-PUBSET = *UNCHANGED / *PARAMETERS(...)
Specifies the pubset whose modified name is to be registered in the SCI.

REFERRED-PUBSET = *PARAMETERS(...)
Specifications concerning the modified pubset name:

OLD-NAME = <cat-id 1..4>
Old catalog ID.

NEW-NAME = <cat-id 1..4>
New catalog ID.

REFERRED-USER-ID = *UNCHANGED / *PARAMETERS(...)
Specifies the user ID for which the name change is to be included in the SCI.

REFERRED-USER-ID = *PARAMETERS(...)
Specifications concerning the modified user ID name:

OLD-NAME = <name 1..8>
Old name of user ID.

NEW-NAME = <name 1..8>
New name of user ID.

REFERRED-PREFIX = *UNCHANGED / *PARAMETERS(...)
Specifies the prefix for which the change of name is to be included in the SCI.

REFERRED-PREFIX = *PARAMETERS(...)
Specifications concerning the modified prefix name:

OLD-NAME = *NONE / <partial-filename 2..7 without-cat-user>
Old prefix name. *NONE indicates that a prefix is not considered in the existing path names in the SCI (see Notes).

NEW-NAME = *NONE / <partial-filename 2..7 without-cat-user>
New prefix name. *NONE indicates that a prefix is not added to the existing path names in the SCI (see Notes). 

Notes

1. The three types of changes that can be made (pubset, user ID, prefix) are added, i.e. with the command

   /MODIFY-IMON-SCI  REFERRED-PVS=*PAR(OLD-NAME=R,NEW-NAME=N)
                   ,REFERRED-USER-ID=*PAR(OLD-NAME=TSOSWRK,NEW-NAME=TSOS)
                   ,REFERRED-PREFIX=*PAR(OLD-NAME=PREF1.,NEW-NAME=PREF2.)
   

   all strings “:R:$TSOSWRK.PREF1.” in existing path names are replaced by “:N:$TSOS.PREF2.”

2. If *NONE is specified for the old prefix and a value other than *NONE for the new prefix, then a new prefix is added to the path name and an existing prefix is ignored.

3. If a value other than *NONE is specified for the old prefix and *NONE is specified for the new prefix, then the old prefix is removed from the path name. 

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	Command processed without errors
2	0	IMO9103	Partially modified
	32	IMO9101	Command terminated abnormally (system error in external call; internal error in IMON-GPN)
	64	CMD0216	Privilege error
	64	IMO9100	SCI not available, SCI version or format in IMON-GPN invalid, or problem when renaming IMON-SCI