Allgemeines
Anwendungsgebiet: | Abfragen und Zugriff zu Listen und Tabellen; siehe "Abfragen und Zugriff zu Listen und Tabellen" |
Makrotyp: | S-Typ, MF-Format 2: Standardform/C-/D-/L-/E-Form; siehe "S-Typ-Makroaufrufe" |
Makrobeschreibung
Der Makro RDUID übergibt in seinem Datenbereich einem Benutzerprogramm die Benutzerkennung und die Abrechnungsnummer des Auftrags, unter dem es läuft (siehe Layout des Datenbereichs im Anschluss an die Operandenbeschreibung).
Makroaufrufformat und Operandenbeschreibung
RDUID |
MF=S / E / L / C / D [,PARAM=adr / (r)] ,PREFIX=S / p ,MACID=RMR / macid |
MF=
Zur allgemeinen Beschreibung des Operanden MF, der dazugehörenden Operandenwerte und der evtl. nachfolgenden Operanden (z.B. PREFIX, MACID und PARAM) siehe Abschnitt „S-Typ-Makroaufrufe“. Die gültigen MF-Werte sind zu Beginn der Makrobeschreibung bei „Makrotyp“ angegeben und aus dem Aufrufformat ersichtlich.
Bei der C-Form oder D-Form des Makroaufrufs kann ein Präfix PREFIX und bei der C-Form zusätzlich eine Macid MACID angegeben werden (siehe Abschnitt „S-Typ-Makroaufrufe“).
Rückinformation und Fehleranzeigen
Standardheader:
+---------------+ | | | | | |0|0|b|b|a|a|a|a| +---------------+
Über die Ausführung des Makros RDUID wird im Standardheader folgender Returncode übergeben (bb=Subcode1, aaaa=Maincode):
X'bb' | X'aaaa' | Erläuterung |
X'00' | X'0000' | Funktion erfolgreich ausgeführt. |
X'20' | X'00FF' | Systemfehler |
Weitere Returncodes, deren Bedeutung durch Konvention makroübergreifend festgelegt ist, können der Tabelle „Standard-Returncodes“ (Standardheader) entnommen werden.
Das aufrufende Programm wird beendet, wenn folgende Fehler auftreten:
Der Datenbereich ist dem Aufrufer nicht zugewiesen.
Der Datenbereich ist nicht auf Wortgrenze ausgerichtet.
Der Datenbereich ist gegen Schreibzugriff geschützt.
Layout des Datenbereichs für 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