SHWUID Display IDs for object path

System administrators and guard administrators can use this function to display user and group IDs from a user ID guard.

Macro	Operands
SHWUID	MF = C / D / L / M / E ,PREFIX = D / <name 1> ,MACID = EFI / <name 3> ,PARAM = <name 1..8> ,UIDGUA = ' ' / <c-string 1..24: filename 1..24 without-gen-vers> / <var: char:24> ,OUTAREA= structure(2): (1) address: NULL / <var: pointer> (2) len: 0 / *ONEID / *MAXIDS / <integer 52..268435455> / <var: int:4>

For a description of the parameters MF, PREFIX, MACID, PARAM see the “Executive Macros” manual [ 16 ].

UIDGUA

Name of the user ID guard
This operand designates the name of a user ID guard of type DEFPUID which contains the IDs which are to be displayed.

CAUTION!
A value must be specified for this operand. Only uppercase characters may be used.

OUTAREA

Output area
This operand designates the address and length of the address space in which the obtained output information is entered. If all the selected rules cannot fit into the output area, an error is reported and the user calling the function must make a larger output area available.

address:

Address
Specifies the address of the output area.

CAUTION!
The output area must be aligned on a word boundary.

len:

Length
Specifies the length of the output area.

CAUTION!
The output area must be at least 52 bytes long.

*ONEID

Output length for one rule.

*MAXIDS

Suggested output length for multiple rules.

Macro return codes

SC2	SC1	Maincode	Meaning
X’00’	X’00’	X’0000’	class A: CMD0001
	X’01’	X’3100’	class B: DEF3100
X’00’ X’01’ X’02’ X’03’			Invalid parameter address Invalid operand: UIDGUA Invalid operand: OUTAREA Invalid value in reserved field
X’00’	X’20’	X’3200’	class C: DEF3200
X’00’	X’40’	X’3302’	class D: DEF3302
X’00’	X’40’	X’3306’	class D: DEF3306
X’00’	X’40’	X’3308’	class D: DEF3308
X’00’	X’40’	X’3309’	class D: DEF3309
X’00’	X’40’	X’3313’	class D: DEF3313
X’00’	X’40’	X’3314’	class D: DEF3314
X’00’	X’40’	X’3315’	class D: DEF3315
X’00’	X’40’	X’3317’	class D: Output area is not large enough
X’00’	X’40’	X’3400’	class D: DEF3400
X’00’	X’40’	X’3401’	class D: DEF3401
X’00’	X’40’	X’3402’	class D: DEF3402
X’00’	X’80’	X’3900’	class E: DEF3900
X’00’	X’80’	X’3901’	class E: DEF3901
X’00’	X’80’	X’3902’	class E: DEF3902

The precise cause of the error can be determined by calling the /HELP-MSG command with the error number specified in the table, e.g. z.B. /HELP-MSG DEF3902.