REMCOO Remove co-owner protection rule

This function is used to delete co-owner protection rules from a rule container (guard).

Users may only delete rules from rule containers belonging to their own user ID. Guard administrators may also delete rules from rule containers belonging to other user IDs. If there are no further rules in a container then the container itself is deleted.

Macro

Operands

REMCOO

MF = C / D / L / M / E ,PREFIX = C / <name 1> ,MACID = OOR / <name 3> ,PARAM = <name 1..8> ,DIALOG = *STD / *NO / *COGUARD / *USERID / *CATALOG / <var: enum-of _dialog_s:1> ,ERRMSG = *NO / *YES / <var: bit:1> ,COGUARD =' ' / <c-string 1..40: filename 1..24 without-gen-vers with-wild(40)> / <var: char:40> ,RULENAM = ' ' / <c-string 1..20: alphanumeric name 1..12 with-wild(20)>/ <var: char:20> / *ALL

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.

=*STD

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

=*NO

The function is executed for every selected rule container without any query being issued.

=*COGUARD

For each selected rule container, 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 rule container 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 rule container 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 rule container is specified using wildcards.
It is possible to abort the function.

ERRMSG

Message output
The user can specify whether any errors which occur should be reported in a message. This may be required if, for example, a positioning rule is not available and processing is impossible as a consequence.

=*NO

No messages are output.

=*YES

Messages are output.

COGUARD

Name of the rule container
This operand designates the name of the rule container from which the rule is to be deleted.
If wildcards are used in the name of a rule container, the rules are deleted from multiple containers, 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!

RULENAM

Name of the rule
This operand designates the name of the rule to be deleted. Wildcards are permitted in the rule name. If there are no further rules in the rule container then the container is deleted.

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

=*ALL

All the rules in the container are to be deleted. As a result, the entire container is also deleted.

Macro return codes

SC2	SC1	Maincode	Meaning
X’00’	X’00’	X’0000’	class A: CMD0001
X’02’	X’00’	X’3000’	class A: COO3000 Warning: The dialog control query was answered with ’Terminate’ and execution of the function was aborted
X’02’	X’00’	X’3001’	class A: COO3001 Warning: A rule container was deleted because it no longer contained any rules
X’02’	X’00’	X’3002’	class A: COO3002 Warning: During wildcard processing, one or more rule containers were deleted because they no longer contained any rules
X’02’	X’00’	X’3003’	class A: COO3003 Warning: During wildcard processing it was not possible to process all the rule containers correctly
X’02’	X’00’	X’3004’	class A: COO3004 Warning: During wildcard processing it was not possible to process all the rule containers correctly and one or more rule containers were deleted because they no longer contained any rules
	X’01’	X’3100’	class B: COO3100
X’00’ X’01’ X’02’ X’03’ X’04’			Invalid parameter address Invalid operand: DIALOG Invalid operand: COGUARD Invalid operand: RULENAM Invalid value in reserved field
X’00’	X’20’	X’3200’	class C: COO3200
X’00’	X’40’	X’3300’	class D: COO3300
X’00’	X’40’	X’3302’	class D: COO3302
X’00’	X’40’	X’3304’	class D: COO3304
X’00’	X’40’	X’3306’	class D: COO3306
X’00’	X’40’	X’3308’	class D: COO3308
X’00’	X’40’	X’3309’	class D: COO3309
X’00’	X’40’	X’3310’	class D: COO3310
X’00’	X’40’	X’3313’	class D: COO3313
X’00	X’40	X’3314’	class D: COO3314
X’00’	X’40’	X’3315’	class D: COO3315
X’00’	X’80’	X’3900’	class E: COO3900
X’00’	X’80’	X’3901’	class E: COO3901
X’00’	X’80’	X’3902’	class E: COO3902

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 COO3902.