Domain: | Environment information |
The INSTALLATION-PATH( ) function outputs the path name that has been assigned from the SCI for the logical name of a file (installation item) that belongs to a particular product version.
The assignment of a path name to a logical name is only available if the file is a component of a product that was installed with IMON. The assignment can also be entered into the SCI by systems support using the SET-INSTALLATION-PATH command. For more details, see the “IMON” manual [19].
An expression must be specified in the DEFAULT-PATH-NAME operand which is returned as an alternative result if no path name has been assigned (the product is not registered in the SCI or no file exists 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 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 [V][m]m.naso format (see also SDF data type composed-name). If the specified version does not exist in the SCI, the function call is aborted without returning a result (or an alternative character string).
DEFAULT-PATH-NAME = string_expression
Determines the alternative character string (e.g. a path name that definitely exists) that is output if no assigned path name is available (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 pathname available! ***') /SHOW-VARIABLE A A = :2OSH:$TSOS.SYSLNK.EDT.171
The path name of the load module library for the product EDT is output. Subsequently, it is checked whether there exists a readme file:
/A = INSTALLATION-PATH(LOGICAL-ID='SYSRME.D',INSTALLATION-UNIT='EDT', DEFAULT-PATH-NAME='*** no readme file available! ***') % SDP0491 Warning: Logical-id 'SYSRME.D' not found in Installation-Unit 'EDT' version '*STD'. Default value assumed /SHOW-VARIABLE A A = *** no readme file available! ***