REMUID Remove IDs for object path

This function is used to remove user or group IDs from a user ID guard.

If no further IDs are left in the user ID guard then the entire guard is deleted.

Macro

Operands

REMUID

MF = C / D / L / M / E ,PREFIX = D / <name 1> ,MACID = EFH / <name 3> ,PARAM = <name 1..8> ,DIALOG = *STD / *NO / *UIDGUA / *USERID / *CATALOG / <var: enum-of _dialog_s:1> ,ERRMSG = *NO / *YES / <var: bit:1> ,UIDGUA = ' ' / <c-string 1..40: filename 1..24 without-gen-vers with-wild(40)> / <var: char:40> ,IDTYPES = array(20): *UID / *GRP / <var: enum-of _type_s:1> ,IDS = array(20): ' ' / <c-string 1..20: name 1..8 with-wild(20)> / *UNIVERS / <var: char:20>

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

DIALOG

Dialog control
The user can use the interface in a guided dialog and can define the type of dialog that is to be performed. Dialog control has no effect in batch mode and thus corresponds to the setting DIALOG-CONTROL=*NO.

=*NO

The command is executed for every selected user ID guard without any query being issued.

=*UIDGUA

For each selected user ID guard, the user can decide in interactive mode whether or not the function should be executed. Dialog control is performed regardless of whether or not the name of the user ID guard is specified using wildcards.
It is possible to abort the function.

=*USERID

This guided dialog can only be used by system administrators.
For each selected user ID, the system administrator can decide in interactive mode whether or not the function should be executed. However, dialog control is only performed if the user ID in the name of the user ID guard is specified using wildcards.
It is possible to abort the function.

=*CATALOG

For each selected catalog ID, the user can decide in interactive mode whether or not the function should be executed. However, dialog control is only performed if the catalog ID in the name of the user ID guard is specified using wildcards.
It is possible to abort the function.

=*STD

For each selected user ID guard, the user can decide in interactive mode whether or not the function should be executed. However, dialog control is only performed if the name of the user ID guard is specified using wildcards.
It is possible to abort the command.

ERRMSG

Message output
The user can specify whether any errors which occur should be reported in a message. This might be required, for example, if the specified user ID is not entered and the function cannot therefore be applied to the guard.

=*NO

No messages are output.

=*YES

Messages are output.

UIDGUA

Name of the user ID guard
This operand designates the name of a user ID guard of type DEFPUID from which the user IDs or group IDs are to be deleted.
If wildcards are used in the name of a user ID guard, the user IDs or group IDs are deleted from multiple guards, provided that these are accessible.
Only guard administrators are able to specify wildcards in the user ID.

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

IDTYPES

Type list
This operand is used to define an array of the types of ID which can be specified in the IDS operand.

=*UID

The ID is a user ID.

=*GRP

The ID is a group ID.

IDS

List of IDs
This operand can be used to specify an array of IDs (without $) whose type has to be defined by means of the TYPE operand. The IDs may contain wildcards.

CAUTION!
Only uppercase characters may be used!

=*UNIVERS

User group *UNIVERSAL.

Macro return codes

SC2	SC1	Maincode	Meaning
X’00’	X’00’	X’0000’	class A: CMD0001
X’02’	X’00’	X’3000’	class A: DEF3000 Warning: The dialog control query was answered with ’Terminate’ and execution of the function was aborted
X’02’	X’00’	X’3010’	class A: DEF3010 Warning: A user ID guard was deleted because it no longer contained any IDs
X’02’	X’00’	X’3011’	class A: DEF3011 Warning: During wildcard processing, one or more user ID guards were deleted because they no longer contained any IDs
X’02’	X’00’	X’3012’	class A: DEF3012 Warning: During wildcard processing, it was not possible to process all the user ID guards correctly
X’02’	X’00’	X’3013’	class A: DEF3013 Warning: During wildcard processing, it was not possible to process all the user ID guards correctly and one or more user ID guards were deleted because they no longer contained any IDs
	X’01’	X’3100’	class B: DEF3100
X’00’ X’01’ X’02’ X’03’ X’04’ X’05’			Invalid parameter address Invalid operand: DIALOG Invalid operand: UIDGUA Invalid operand: IDTYPES Invalid operand: IDS 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’3400’	class D: DEF3400
X’00’	X’40’	X’3402’	class D: DEF3402
X’00’	X’40’	X’3404’	class D: DEF3404
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. /HELP-MSG DEF3902.