General
Application area: | User and job switches; see "S-type macros" |
Macro type: | Type O; see "O-type macros" |
As of BS2000/OSD-BC V1.0, the new macro SWITCH is available. This macro combines the functionality of the GETSW, GETUS, SETSW and SETUS macros.
Macro description
For a general description of the user switch see the SETUS macro.
The macro GETUS copies the settings of the user switches for the specified user ID into register R0. Users can specify their own user ID or that of another user.
The switches are assigned to the bits of register R0 in ascending sequence (from right to left):
bit 2 (0) --> switch 0 bit 2 (1) --> switch 1 : : : : bit 2 (31) --> switch 31
where:
bit 2n = 0: switch n off
bit 2n = 1: switch n on
0 <= n <= 31
Macro format and description of operands
GETUS |
[(1)] |
(1)
Register R1. Register R1 must contain the address of a field containing the user ID.
The user ID must be copied left-justified into the address field (specification without “$”; to be padded with blanks to eight positions, if required).
Macro call without operand
The switch settings for the user ID specified in the SET-LOGON-PARAMETERS command will be supplied.
Return information and error flags
R15:
+---------------+ | | | | | |0|0|0|0|0|0|a|a| +---------------+
A return code relating to the execution of the GETUS macro is transferred in the rigtmost byte of register R15.
X'aa' | Meaning |
X'00' | Normal execution. |
X'04' | Operand error. |
X'08' | The user ID does not exist. |
X'0C' | The user ID is no longer valid. |
X'20' | Internal error. |