Anwendungsgebiet: | Umgebungsinformationen |
Die Funktion INSTALLATION-PATH( ) gibt für den logischen Namen einer Datei (Installation-Item), die zu einer bestimmten Produktversion gehört, den zugeordneten Pfadnamen aus dem SCI aus.
Die Zuordnung zwischen logischem Namen und dem Pfadnamen einer Datei ist nur verfügbar, wenn die Datei Bestandteil eines Produktes ist, das mit IMON installiert wurde. Die Zuordnung kann von der Systembetreuung auch mit dem Kommando SET-INSTALLATION-PATH in das SCI eingetragen werden. Nähere Einzelheiten siehe Handbuch „IMON“ [19].
Im Operanden DEFAULT-PATH-NAME muss ein Ausdruck angegeben werden, der ersatzweise als Ergebnis zurückgegeben wird, wenn kein zugeordneter Pfadname existiert (das Produkt ist nicht im SCI registriert oder zu dem angegebenen logischen Namen existiert keine Datei).
Format
INSTALLATION-PATH( ) |
LOGICAL-ID = string_ausdruck ,INSTALLATION-UNIT = string_ausdruck ,VERSION = *STD / string_ausdruck ,DEFAULT-PATH-NAME = string_ausdruck |
Ergebnistyp
STRING
Eingabeparameter
LOGICAL-ID = string_ausdruck
Bezeichnet den logischen Namen der Datei (Installation-Item), deren Pfadname ausgegeben werden soll (z.B. SYSPRG).
INSTALLATION-UNIT = string_ausdruck
Bezeichnet den Produktnamen (Name der Installation-Unit).
VERSION = *STD / string_ausdruck
Bezeichnet die Produktversion (bis zu 8 Zeichen).
Explizit kann eine Version im Format [V][m]m.naso angegeben werden (siehe auch SDF-Datentyp composed-name). Ist die angegebene Version nicht im SCI registriert, wird der Funktionsaufruf ohne Rückgabe eines Ergebnisses (auch keine Ersatzzeichenfolge) abgebrochen.
DEFAULT-PATH-NAME = string_ausdruck
Legt die Ersatzzeichenfolge (z.B. einen Pfadnamen, der mit Sicherheit existiert) fest, die ausgegeben wird, wenn kein zugeordneter Pfadname verfügbar ist (Produkt oder Installations-Item nicht im SCI registriert).
Ergebnis
String gemäß den Richtlinien für den SDF-Datentyp <filename 1..54>.
Fehlermeldungen
SDP0469 DER ANGEGEBENE PARAMETER '(&00)' IST UNGUELTIG
SDP0470 INTERNER FEHLER BEIM GETINSP-/GETSINV-SCHNITTSTELLENAUFRUF.
RETURNCODE '(&00)'
SDP0489 WARNUNG: INSTALLATION-UNIT '(&00)' NICHT IM IMON SOFTWARE
INVENTORY GEFUNDEN. STANDARDWERT WIRD BENUTZT
SDP0490 INSTALLATION-UNIT '(&00)', VERSION '(&01)' NICHT GEFUNDEN
SDP0491 WARNUNG: LOGICAL-ID '(&00)' NICHT GEFUNDEN IN INSTALLATION-UNIT
'(&01)' , VERSION '(&02)' . STANDARD-WERT WIRD BENUTZT
Beispiele
/A = INSTALLATION-PATH(LOGICAL-ID='SYSLNK',INSTALLATION-UNIT='EDT', DEFAULT-PATH-NAME='*** kein Pfadname vorhanden! ***') /SHOW-VARIABLE A A = :2OSH:$TSOS.SYSLNK.EDT.170
Ausgegeben wird der Pfadname der Ladebibliothek des Produkts EDT. Anschließend wird überprüft, ob eine Readme-Datei vorhanden ist:
/A = INSTALLATION-PATH(LOGICAL-ID='SYSRME.D',INSTALLATION-UNIT='EDT', DEFAULT-PATH-NAME='*** keine Readme-Datei vorhanden! ***') % SDP0491 Warning: Logical-id 'SYSRME.D' not found in Installation-Unit 'EDT' version '*STD'. Default value assumed /SHOW-VARIABLE A A = *** keine Readme-Datei vorhanden! ***