Domain: Environment information
The INSTALLATION-PATH( ) specifies the path name assigned from the SCI for the logical name of a file (installation item) that belongs to a specific product version.
The association between the logical name and the path name of a file is only available when the file is part of a product that was installed using IMON. The assignment can also be entered in the SCI by systems support with the SET-INSTALLATION-PATH command. See the “IMON” manual [12] for more detailed information.
An expression must be specified in the DEFAULT-PATH-NAME operand that is returned as a replacement when no assigned path name exists (the product is not registered in the SCI or there is no file for the logical name specified).
Format
INSTALLATION-PATH( ) |
LOGICAL-ID = string_expression ,INSTALLATION-UNIT = string_expression ,VERSION = *STD / string_expression ,DEFAULT-PATH-NAME = string_expression |
Result type
STRING
Input parameters
LOGICAL-ID = string_expression
Designates a file ID (e.g. designates the logical name of the file (installation item) whose path name is to be output (e.g. SYSPRG).
INSTALLATION-UNIT = string_expression
Designates the product name (name of the installation unit).
VERSION = *STD / string_expression
Designates the product version (up to 8 characters).
A version can be specified explicitly in the format [V][m]m.naso (see also the SDF data type composed-name). If the specified version is not registered in the SCI, then the function call is cancelled without returning a result (not even a replacement string as the result).
DEFAULT-PATH-NAME = string_expression
Specifies the replacement string (e.g. a path name that surely exists) to be output when no path name assignment is available (i.e. when the product or installation item is not registered in the SCI).
Result
A string, conforming to the rules for the SDF data type <filename 1..54>.
Error messages
SDP0469 INVALID PARAMETER ‘(&00)‘ SPECIFIED
SDP0470 INTERNAL ERROR RETURNED BY GETINSP/GETINSV INTERFACE. RETURN CODE
‘(&00)‘ RECEIVED
SDP0489 WARNING: INSTALLATION-UNIT '(&00)' NOT FOUND IN IMON SOFTWARE
INVENTORY. DEFAULT VALUE ASSUMED
SDP0490 INSTALLATION-UNIT '(&00)', VERSION '(&01)' NOT FOUND
SDP0491 WARNING: LOGICAL-ID '(&00)' NOT FOUND IN INSTALLATION-UNIT '(&01)'
, VERSION '(&02)'. DEFAULT VALUE ASSUMED
Examples
/A = INSTALLATION-PATH(LOGICAL-ID='SYSLNK',INSTALLATION-UNIT='EDT', DEFAULT-PATH-NAME='*** No path name present! ***') /SHOW-VARIABLE A A = :2OSH:$TSOS.SYSLNK.EDT.166
The path name of the load library of the EDT product is output.
/A = INSTALLATION-PATH(LOGICAL-ID='SYSRME.D',INSTALLATION-UNIT='EDT', DEFAULT-PATH-NAME='*** No readme file present! ***') % SDP0491 Warning: Logical-id 'SYSRME.D' not found in Installation-Unit 'EDT' version '*STD'. Default value assumed /SHOW-VARIABLE A A = *** No readme file present! ***
The replacement string as defined in DEFAULT-PATH-NAME is output as no readme file for the current EDT version exists.
/B = INSTALLATION-PATH(LOGICAL-ID='SYSLNK',INSTALLATION-UNIT='EDT', VERSION='16.0',DEFAULT-PATH-NAME='*** no path name present! ***') % SDP0490 Installation-Unit 'EDT' version '16.0' not found % SDP0431 ERROR 'SDP0490' IN BUILTIN FUNCTION 'INSTALLATION-PATH' % SDP0239 ERROR DURING EVALUATION OF RIGHT SIDE OF ASSIGNMENT /SHOW-VARIABLE B % SDP1008 VARIABLE/LAYOUT 'B' DOES NOT EXIST % SDP0234 OPERAND 'NAME' INVALID
The function call is aborted. The product EDT is certainly installed (see above), but the explicitly specified version V16.0 does not exist. No value is assigned to variable B (and it is not implicitly declared) as no value is returned.
/C = INSTALLATION-PATH(LOGICAL-ID='SYSPRC',INSTALLATION-UNIT='USER-TOOLS', DEFAULT-PATH-NAME='$RZTOOLS.SYSPRC.USER-TOOLS.010') /SHOW-VARIABLE C C = $RZTOOLS.SYSPRC.USER-TOOLS.010
The replacement string as defined in DEFAULT-PATH-NAME is output (in this case a path name), as there is no product with the name USER-TOOLS registered in the SCI.