GETINSV liefert die Version einer Installation-Unit.
Macro | Operanden | ||||||||||||||||||||||||||||
GETINSV |
|
Zur Beschreibung der Parameter MF, PREFIX, MACID, PARAM und XPAND siehe Abschnitt „Makroformen“ auf "Makrosyntax ".
CALLER | Steuert die Art des Systemaufrufes bei MF=E. |
=USER | Systemaufruf über SVC für nichtprivilegierte Aufrufer (TU). |
=SYSTEM | Direkter Systemaufruf für privilegierte Aufrufer (TPR). |
| IUNAME | Name der Installation-Unit, in der das Installation-Item bzw. die Installation-Items enthalten sind, siehe "Installation-Unit (IU) ". |
=<c-string 1..30> | Explizite Angabe der Installation-Unit. |
=<var: char:30> | Symbolische Adresse, die die Angabe zum Namen der Installation-Unit enthält. Darf nicht zusammen mit MF=L angegeben werden. |
IUVERS | Version der Installation-Unit. Format: <mm.naso> |
=<c-string 7..7> | Explizite Angabe der Version der Installation-Unit. |
=<var: char:7> | Symbolische Adresse, die die Angabe zur Version der Installation-Unit enthält. Darf nicht zusammen mit MF=L angegeben werden. |
| SDFVSYN | Angabe des Syntaxformats der Version. |
=*NO | Die Version wird bei IUVERS mit „mm.n[aso]“ angegeben. |
=*YES | Die Version wird bei IUVERS mit [’] [V][m]m.n[aso][’] angegeben. |
SCOPE | Bestimmt die Art wie die Installation-Unit geladen werden kann. Dieser Operand wird unter DSSM V3.0 ignoriert. |
=*ANY | Die Installation-Unit kann beliebig geladen werden. |
=*SYSTEM | Die Installation-Unit kann als DSSM-Subsystem geladen werden, sie ist im DSSM-Katalog eingetragen. |
=*LOCAL | Die Installation-Unit kann als Programm geladen werden. |
=<var: enum-of scope:1> | |
| Name des Feldes mit der Art, wie die Installation-Unit geladen wird. | |
| ACTIVE | Gibt an, ob die Installation-Unit bereits aktiviert ist. Der Parameter wird ignoriert, wenn SCOPE=*LOCAL angegeben wurde. Er ist nur für Installation-Units relevant, die DSSM-Subsysteme sind. Dieser Operand wird unter DSSM V3.0 ignoriert. |
=*ANY | Die Installation-Unit kann, muss aber nicht aktiviert sein. |
=*YES | Die Installation-Unit muss aktiviert sein, d.h. das Subsystem ist gestartet. |
=<var: enum-of active:1> | |
| Name des Feldes mit dem Wert, der anzeigt, ob die Installation-Unit aktiviert ist. | |
OUT@=<adr> / (<reg>) | |
Adresse eines Bereiches, der die Ausgabeinformation aufnehmen soll. Die Adresse muss auf Wortgrenze ausgerichtet sein. Dieser Parameter ist nur bei MF=M von Bedeutung. | |
OUTLEN= <integer 1..2147483647> / <var: int:4> | |
Länge der Ausgabebereichs in Byte, die Mindestlänge ist 4. Die Ausgabeinformation wird nur in der angegebenen Länge übertragen. Die ersten 4 Byte enthalten die Länge der zurückgelieferten Ausgabeinformation. Anschließend folgen eine oder mehrere Versionen der Installation-Unit. | |
Layout des Ausgabebereiches
Distanz | Länge | Format | Inhalt |
X’00’ | 4 | <integer> | Länge der Ausgabeinformation |
X’04’ | 7 | <char> | Versionsbezeichnung, Format nn.n[ann] |
X’0B’ | 1 | S / L / U | SCOPE bestimmt die Art, wie die Installation-Unit geladen wird. S = SYSTEM, L = LOCAL, U = UNDEFINED |
X’0C’ | 1 | Y / N / U | ACTIVE gibt an, ob die Installation-Unit bereits aktiviert ist. Y = YES, N = NO, U = UNDEFINED (kein Subsystem) |
X’0D’ | 1 | Y / N / U | Ausgewählt durch das Kommando SELECT-PRODUCT-VERSION: Y = YES, N = NO, U = UNDEFINED |
X’0E’ | 1 | Y / N / U | Logischer Name existiert Y = YES, N = NO, U = UNDEFINED |
... | Weitere Versionen der Installation-Unit |
Makro-Returncode
(SC2) | SC1 | Maincode | Bedeutung |
X’00’ | X’00’ | X’0000’ | Funktion erfolgreich ausgeführt |
X’03’ | X’00’ | X’0000’ | Funktion erfolgreich ausgeführt (Teilinformation) |
X’09’ | X’00’ | X’0000’ | Installation-Unit gesperrt |
X’00’ | X’01’ | X’0001’ | Name der Installation-Unit ungültig |
X’00’ | X’01’ | X’0002’ | Teilversion der Installation-Unit ungültig |
X’00’ | X’01’ | X’0005’ | Parameter SCOPE ungültig |
X’00’ | X’01’ | X’0006’ | Parameter ACTIVE ungültig |
X’00’ | X’01’ | X’0008’ | Illegaler Gebrauch der für den Parameterbereich reservierten Felder |
X’00’ | X’40’ | X’0011’ | Installation-Unit nicht gefunden |
X’00’ | X’40’ | X’0012’ | Keine passende Version vorhanden |
X’03’ | X’40’ | X’0012’ | Zugriff auf angegebene Version nicht zulässig |
X’00’ | X’40’ | X’0018’ | SCI ungültig |
X’00’ | X’40’ | X’001A’ | SCI-Version ungültig |
X’00’ | X’40’ | X’001B’ | SCI existiert nicht |
X’00’ | X’01’ | X’0021’ | Ausgabefeld-Adresse nicht zugewiesen |
X’00’ | X’01’ | X’0022’ | Ausgabefeld-Länge zu klein (Minimum=4) |
X’00’ | X’01’ | X’0023’ | Ausgabefeld zu klein |
X’00’ | X’20’ | X’00FF’ | DVS-Fehler bei SCI-Zugriff |
X’00’ | X’20’ | X’0100’ | Systemfehler |
X’00’ | X’20’ | X’0101’ | Interner Fehler |
Hinweise
Die Länge der gelieferten Information kann den ersten 4 Byte des Ausgabebereiches entnommen werden.
Als nichtprivilegierter Benutzer zeigt Ihnen dieser Makro nur die Installation-Items des Funktionszustandes TU (siehe Abschnitt „Attribute einer Installation-Unit" (Installation-Unit (IU) )).
Auf einem System mit DSSM-Version 3.0 wird die höchste passende Version zurückgeliefert, wenn IUVERS=*STD angegeben wurde.
SCOPE=*SYSTEM wird nur dann ausgewertet, wenn der Name des Subsystems und der Name für die angegebene Installation-Unit gleich sind.
Wurde die Version für unterschiedliche Gültigkeitsbereiche (SCOPE, siehe SELPROV-Makro) eingestellt, wird mit IUVERS=*STD der „kleinste“ eingestellte Gültigkeitsbereich ausgegeben (PROGRAM < TASK < SYSTEM).