General
Application area: | Requesting and accessing lists and tables; see "Requesting and accessing lists and tables" |
Macro type: | Type S, MF format 2: standard/C/D/L/E form; see "S-type macros" |
Macro description
The RDUID macro transfers to a user program in its operand list the user ID and the account number of the job under which it is running (see the layout of the operand list after the operand description).
Macro format and description of operands
RDUID |
MF=S / E / L / C / D [,PARAM=addr / (r)] ,PREFIX=S / p ,MACID=RMR / macid |
MF=
For a general description of the MF operand, its operand values and any subsequent operands (e.g. PREFIX, MACID and PARAM), see section “S-type macros”. The valid MF values are given at the start of the macro description under “Macro type” and are included in the macro format.
A PREFIX can be specified in the C form or D form of the macro and additionally a MACID in the C form (see section “S-type macros”).
Return information and error flags
Standard header:
+---------------+ | | | | | |0|0|b|b|a|a|a|a| +---------------+
The following return code relating to the execution of the RDUID macro is transferred in the standard header (bb=Subcode1, aaaa=Maincode):
X'bb' | X'aaaa' | Meaning |
X'00' | X'0000' | Function successfully executed |
X'20' | X'00FF' | System erro |
Other return codes which, in accordance with conventions, apply to all macros are given in the table “Standard return codes” (Standard header).
The calling program is terminated when the following errors occur:
The data area is not assigned to the caller.
The data area is not aligned on a word boundary.
The data area is protected against write access.
Layout of the data area for RDUID MF=C
1 FHDR MF=(C,SRMR),EQUATES=NO 2 DS 0A 2 SRMRFHE DS 0XL8 0 GENERAL PARAMETER AREA HEADER 2 * 2 SRMRIFID DS 0A 0 INTERFACE IDENTIFIER 2 SRMRFCTU DS AL2 0 FUNCTION UNIT NUMBER 2 * BIT 15 HEADER FLAG BIT, 2 * MUST BE RESET UNTIL FURTHER NOTICE 2 * BIT 14-12 UNUSED, MUST BE RESET 2 * BIT 11-0 REAL FUNCTION UNIT NUMBER 2 SRMRFCT DS AL1 2 FUNCTION NUMBER 2 SRMRFCTV DS AL1 3 FUNCTION INTERFACE VERSION NUMBER 2 * 2 SRMRRET DS 0A 4 GENERAL RETURN CODE 2 SRMRSRET DS 0AL2 4 SUB RETURN CODE 2 SRMRSR2 DS AL1 4 SUB RETURN CODE 2 2 SRMRSR1 DS AL1 5 SUB RETURN CODE 1 2 SRMRMRET DS 0AL2 6 MAIN RETURN CODE 2 SRMRMR2 DS AL1 6 MAIN RETURN CODE 2 2 SRMRMR1 DS AL1 7 MAIN RETURN CODE 1 2 SRMRFHL EQU 8 8 GENERAL OPERAND LIST HEADER LENGTH
2 * 1 SRMRUID DC CL8' ' USERID 1 SRMRACC DC CL8' ' ACCOUNT NUMBER 1 SRMR# EQU *-SRMRFHE LENGTH OF RDUID PARAMETER BLOCK