GETUS - Benutzerschalter abfragen

Allgemeines

Anwendungsgebiet:	Benutzer- und Auftragsschalter; siehe "Benutzer- und Auftragsschalter"
Makrotyp:	O-Typ; siehe "O-Typ-Makroaufrufe"

• Seit BS2000/OSD-BC V1.0 steht der neue Makro SWITCH zur Verfügung, der die Funktionalitäten der Makros GETSW, GETUS, SETSW und SETUS vereinigt.

Makrobeschreibung

(zur allgemeinen Beschreibung der Benutzerschalter siehe Makro SETUS).

Der Makro GETUS überträgt die Stellung der Benutzerschalter der angegebenen Benutzerkennung in das Register R0. Der Anwender kann seine eigene oder auch eine fremde Benutzerkennung angeben.
Die Schalter sind in aufsteigender Reihenfolge den Bits des Registers R0 (von rechts nach links) zugeordnet:

Bit 2 (0)  -->  Schalter 0
Bit 2 (1)  -->  Schalter 1
   :              :
   :              :
Bit 2 (31) -->  Schalter 31

Es gilt:
Bit 2ⁿ = 0: Schalter n ausgeschaltet
Bit 2ⁿ = 1: Schalter n eingeschaltet
0 <= n <= 31

Makroaufrufformat und Operandenbeschreibung

GETUS

[(1)]

(1)
1 = Register R1. Das Register R1 muss den Adresswert des Feldes mit der Benutzerkennung enthalten.
Die Benutzerkennung muss linksbündig in das Feld eingetragen werden (Angabe ohne „$“ und ggf. mit Leerzeichen auf 8 Stellen ergänzen).

Makroaufruf ohne Operand

Die Schalterstellungen für die Benutzerkennung aus dem Kommando SET-LOGON-PARAMETERS werden übergeben.

Rückinformation und Fehleranzeigen

R15:

+---------------+
|   |   |   |   |
|0|0|0|0|0|0|a|a|
+---------------+

Über die Ausführung des Makros GETUS wird im rechtsbündigen Byte des Registers R15 ein Returncode übergeben.

X'aa'	Erläuterung
X'00'	Normale Ausführung.
X'04'	Operandenfehler.
X'08'	Benutzerkennung existiert nicht.
X'0C'	Benutzerkennung ist nicht mehr gültig.
X'20'	Interner Fehler.