SETINSP Enter or modify installation path

The SETINSP macro enables you to change the correlation between path name and logical ID after product installation or to cancel the assignment. Note that the change is not implemented if it is not permitted by the attributes.

SETINSP requires the presence of a SYSSII file for the product.

Privilege required: SUBSYSTEM-MANAGEMENT

Macro

Operands

SETINSP

MF=	D / L / C / M / E
,PREFIX=	I / <char (1)>
,MACID=	MOS / <char (3)>
,PARAM=	<adr> / (<reg>)
,CALLER=	USER / SYSTEM
,SCINAME=	’'BLANK'’ / <c-string 1..54> / <var: char:54>
,IUNAME=	<c-string 1..30> / <var: char:30>
,IUVERS=	<c-string 7..7> / <var: char:7>
,TARGET=	’'BLANK'’ / <c-string 1..1> / <var: char:1>
,LOGID=	<c-string 1..30> / <var: char:30>
,PATHNAM=	*NONE / <c-string 1..54> / <var: char:54>
,ENFORCE=	*NO / *YES

   

The MF, PREFIX, MACID, and PARAM parameters are described in “Macro forms” on "Macro syntax ".

CALLER

Defines the type of system call if MF = E.

=USER

System call via SVC for nonprivileged caller (TU).

=SYSTEM

Direct system call for privileged caller (TPR).

SCINAME

Name of the SCI.

=’'BLANK'’

The standard SCI will be processed (the files $TSOS.SYS.IMON.SCI and $TSOS.SYS.IMON.SCI.GPN).

=<c-string 1..54> / <var: char:54>

Name of a foreign SCI.

IUNAME

Name of the installation unit to be processed, see "Installation unit (IU) ".

=<c-string1..30>

Explicit specification of the installation unit.

=<var: char:30>

Symbolic address containing the specification for the name of the installation unit. May not be specified with MF=L.

IUVERS

Version of the installation unit. Format: <mm.naso>

=<c-string 7..7>

Explicit specification of the version.

=<var: char:7>

Symbolic address containing the specification for the version of the installation unit. May not be specified with MF=L.

TARGET= - / <c-string 1..1> / <var: char:1>

Specifies the hardware form belonging to the installation item

(specify for IUNAME and IUVERS).

Possible values: 

-	:  The installation item is part of the hardware variant of thecurrent system.
A	:  The installation item is independent of the hardware variant.
S	:  The installation item is part of the /390 variant only.
K	:  The installation item is only part of the X86 variant.
P	:  The installation item is only part of the SPARC variant.

LOGID

The logical name of the installation item to be updated.

=<c-string 1..30>

Explicit specification of logical name of the installation item.

=<var: char:30>

Symbolic address containing the specification for the logical ID of the installation item. May not be specified with MF=L.

PATHNAM

The path name assigned to the logical name of the installation item.

=*NONE

No path name assigned to the logical name.

An existing assignment is cancelled. This specification will be

rejected if the logical ID was defined with “Mandatory Y” (see "Installation item (II) ").

=<c-string1..54>

Explicit specification of the path name (fully or partially qualified).

The partially qualified file name refers to all files assigned to the logical ID.

=<var: char:54>

Symbolic address containing the specification for the path name of the installation item. May not be specified with MF=L.

ENFORCE

Specifies whether the path name can be assigned.

=*NO

The path name is not assigned.

=*YES

The path name will be assigned even though the logical name was defined with “Update N” (see page 44 (Installation item (II) )).

Macro return codes

(SC2)	SC1	Maincode	Meaning
X‘00‘	X‘00‘	X‘0000‘	Function successfully executed
X‘05‘	X‘00‘	X‘0000‘	Enforced function successfully executed
X‘06‘	X‘00‘	X‘0000‘	Warning: File does not exist
X‘07‘	X‘00‘	X‘0000‘	Warning: Forced file does not exist
X‘00‘	X‘01‘	X‘0001‘	Name of installation unit invalid
X‘00‘	X‘01‘	X‘0002‘	Version of installation unit invalid
X‘00‘	X‘01‘	X‘0003‘	Logical ID invalid
X‘00‘	X‘01‘	X‘0004‘	Path name invalid
X‘00‘	X‘01‘	X‘0008‘	Illegal use of fields reserved for the parameter area
X‘00‘	X‘40‘	X‘0011‘	Installation unit not found
X‘00‘	X‘40‘	X‘0012‘	Version of installation unit not found
X‘00‘	X‘40‘	X‘0013‘	Logical ID not found
X‘00‘	X‘40‘	X‘0014‘	Path name cannot be changed as requested
X‘00‘	X‘40‘	X‘0015‘	User without SUBSYSTEM-MANAGEMENT privilege
X‘00‘	X‘40‘	X‘0018‘	SCI invalid
X‘00‘	X‘40‘	X‘001A‘	SCI version invalid
X‘00‘	X‘40‘	X‘001B‘	SCI does not exist
X‘00‘	X‘40‘	X‘001C‘	Path name incomplete
X’00’	X’01’	X’0025	Target operand invalid
X’00’	X’01’	X’0026’	SYSTEM RC cannot be written.
X‘00‘	X‘20‘	X‘00FF‘	DMS error in SCI access
X’00’	X‘20‘	X‘0100‘	System error
X’00’	X‘20‘	X‘0101‘	Internal error