Mit SELPROV können Sie 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 der Benutzer arbeiten will. Beim Start des zugehörigen Programms bzw. bei Konnektierung an ein Subsystem wird die ausgewählte Version verwendet.
| Makro | Operanden | ||||||||||||||
| SELPROV |
|
Zur Beschreibung der Parameter MF, PREFIX, MACID und PARAM 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). |
| PRODNAM | Gibt den Produktnamen an, siehe "Liefereinheit (Supply-Unit) ". |
=<c-string1..30> | Explizite Angabe des Produktnamens. |
=<var: char:30> | Symbolische Adresse, die die Angabe zum Namen des Produktes enthält. Darf nicht zusammen mit MF=L angegeben werden. |
| PRODVER | Legt die zu ladende Version des Produkts fest. 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. |
=*STD | Eine früher getroffene Versionsauswahl wird rückgängig gemacht. Damit tritt die Voreinstellung des Systems (die höchste Version wird verwendet) wieder in Kraft. |
=<c-string 4..7> | Explizite Angabe der Produktversion. |
=<var: char:7> | Symbolische Adresse, die die Angabe zur Produktversion enthält. Darf nicht zusammen mit MF=L angegeben werden. |
| SCOPE | Bestimmt die Gültigkeitsdauer der Auswahl. |
=*PROGRAM | Die Auswahl gilt bis zum Ende des laufenden bzw. nachfolgenden Programms. |
=*TASK | Die Auswahl gilt bis zum Taskende. |
=*SYSTEM | Die Auswahl gilt systemweit für diesen Systemlauf (bis Shutdown). Dieser Operand darf für den Funktionszustand TPR nur verwendet werden, wenn der Benutzer über das Privileg SUBSYSTEM- MANAGEMENT verfügt. |
=<var: enum-of scope:1> | |
| Name des Feldes mit der Gültigkeitsdauer. | |
Makro-Returncode
(SC2) | SC1 | Maincode | Bedeutung |
X’00’ | X’00’ | X’0000’ | Funktion erfolgreich ausgeführt |
X’00’ | X’01’ | X’0001’ | Name des Produktes ungültig |
X’00’ | X’01’ | X’0002’ | Produktversion ungültig |
X’00’ | X’01’ | X’0005’ | Operand SCOPE ungültig |
X’00’ | X’01’ | X’0008’ | Illegaler Gebrauch der für den Parameterbereich reservierten Felder |
X’00’ | X’40’ | X’0011’ | Produkt 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’0015’ | Fehlen des Privilegs SUBSYSTEM-MANAGEMENT |
X’00’ | X’40’ | X’0019’ | Für das Produkt kann keine Version ausgewählt werden |
X’00’ | X’40’ | X’001D | DSSM-Subsystem kann nicht konnektiert werden |
X’00’ | X’40’ | X’001F | Version kann nicht mit DSSM ausgewählt werden |
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
Wird eine Version sowohl für PROGRAM als auch für TASK bzw. SYSTEM angegeben, hat die Angabe für PROGRAM den Vorrang.
Für ein Produkt kann nur eine Version ausgewählt werden. Wird der Makro für ein Produkt zweimal mit verschiedenen Versionen ausgeführt, so gilt die zuletzt getroffene Festlegung.
Eine Auswahl mit SCOPE=*SYSTEM gilt nur bis Shutdown. In einem neuen Systemlauf muss die Auswahl neu getroffen werden.
Als nichtprivilegierter Benutzer zeigt Ihnen dieser Makro nur die Installation-Items des Funktionszustandes TU (siehe Abschnitt „Attribute einer Installation-Unit" (Installation-Unit (IU) )).