Produktversion auswählen
Komponente: | IMON-GPN |
Funktionsbereich: | Programm-Steuerung |
Anwendungsbereich: | PROGRAM |
Privilegierung: | STD-PROCESSING |
Funktionsbeschreibung
Mit diesem Kommando kann der nicht-privilegierte Anwender die Produktversion einer Installation-Unit oder eines DSSM-Subsystems (TU, ab DSSM V3.5) auswählen. Sind mehrere Versionen dieses Produktes installiert und zugreifbar, so kann die Version festgelegt werden, mit der er arbeiten will. Beim Start des zugehörigen Programms bzw. bei Konnektierung an ein Subsystem wird die ausgewählte Version verwendet.
Für Kommandoaufrufe mit derselben Gültigkeitsdauer (Operand SCOPE) gilt:
Für ein Produkt kann nur eine Version ausgewählt werden.
Wird das Kommando für ein Produkt zweimal mit verschiedenen Versionen ausgeführt, so gilt die zuletzt getroffene Festlegung.
Mit dem Kommando SHOW-SELECTED-PRODUCT-VERSION kann sich der Anwender über die aktuelle Versionswahl informieren.
Privilegierte Funktion
Die Systembetreuung kann mit SCOPE=*SYSTEM die Produktversion einer Installation-Unit für die Dauer des Systemlaufs auswählen.
Format
SELECT-PRODUCT-VERSION |
PRODUCT-NAME = <text 1..30 without-sep> ,VERSION = *STD / <product-version> ,SCOPE = *TASK / *PROGRAM / *SYSTEM |
Operandenbeschreibung
PRODUCT-NAME = <text 1..30 without-sep>
Gibt den Namen des Software-Produktes an. Für Subsysteme, die mit DSSM geladen werden, ist es der Name des Subsystems und/oder der Name der IMON-Installation-Unit. In Bezug auf DBL ist es der Name einer Ladeeinheit.
VERSION =
Bestimmt die zu ladende Version des Produkts. Die Auswahl kann teilqualifiziert angegeben werden. In diesem Fall wird die höchste passende Version bzw. im Fall eines DSSM-Subsystems, die genau passende Version ausgewählt.
VERSION = *STD
Eine früher getroffene Versionsauswahl wird rückgängig gemacht. Damit gilt wieder die Voreinstellung des Systems (die höchste Version wird verwendet) wieder in Kraft.
VERSION = <product-version>
Gibt die Version des Software-Produktes an. Der DBL verwendet beim Ladevorgang nur diese Version zur Befriedigung von Externverweisen.
SCOPE =
Bestimmt die Gültigkeitsdauer der Auswahl.
SCOPE = *TASK
Die Auswahl gilt bis zum Ende der Task.
SCOPE = *PROGRAM
Die Auswahl gilt bis zum Ende des laufenden bzw. nachfolgenden Programms.
SCOPE = *SYSTEM
Der Operandenwert steht nur dem privilegierten Anwender mit dem Privileg SUBSYSTEM-MANAGEMENT zur Verfügung.
Die Auswahl (nur für Installation-Units) gilt systemweit für diesen Systemlauf (bis Shutdown). Für DSSM-Subsysteme kann diese Einstellung nicht vorgenommen werden.
Kommando-Returncode
(SC2) | SC1 | Maincode | Bedeutung |
|---|---|---|---|
0 | CMD0001 | Kommando erfolgreich ausgeführt | |
32 | IMO9101 | Kommando abnormal beendet. Interner Fehler in IMON-GPN | |
64 | CMD0216 | Privilegienfehler | |
64 | IMO9100 | Kommando nicht ausgeführt. Installation-Unit bzw. Version nicht gefunden |
Hinweise
Das Kommando wird für ein Produkt und eine explizit angegebene Version in folgenden zwei Fällen akzeptiert:
Der Produktname ist als Installation-Unit im SCI registriert: In diesem Fall muss die im Operanden VERSION explizit angegebene Version ebenfalls existieren.
Der Produktname ist nicht im SCI registriert: In diesem Fall muss ein entsprechendes DSSM-Subsystem konnektierbar sein. Das bedeutet, dass das Subsystem mit dem Namen und der angegebenen Version im DSSM-Subsystemkatalog deklariert ist und gestartet wurde.