SHWCOO Display co-owner protection rule

This command can be used to display co-owner protection rules which are entered in a rule container (guard).

The rules are only displayed to a user who is neither the owner of the container to be displayed nor the guard administrator if he or she has the appropriate authorization required to access the container (SCOPE=*USER-GROUP or *HOST-SYSTEM).

Macro

Operands

SHWCOO

MF = C / D / L / M / E ,PREFIX = C / <name 1> ,MACID = OOS / <name 3> ,PARAM = <name 1..8> ,XPAND = PARAM / OUTPUT ,COGUARD = ' ' / <c-string 1..40: filename 1..40 without-gen-vers> / <var: char:40> ,RULENAM = *ALL / <c-string 1..20: alphanumeric name 1..12 with-wild(20)> / <var: char:20> ,OUTAREA = structure(2): (1) address: NULL / <var: pointer> (2) len: 0 / *ONERULE / *SUGRULES / <integer 144..268435455> / <var: int:4>

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

XPAND

specifies the declarations to expand. This operand only applies if MF=D.

=PARAM

The model of the parameter area.

=INFO

The models of the parts of the output.

COGUARD

Name of the rule container
This operand designates the name of a rule container from which one or more rules are to be displayed.

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

RULENAM

Name of the rule
This operand designates the name of the rule to be displayed. Wildcards are permitted in the name.

CAUTION!
Only uppercase characters may be used.

=*ALL

All the rules are displayed.

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 then 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 144 bytes long.

*ONERULE

Output length for one rule.

*SUGRULES

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: COO3100
X’00’ X’01’ X’02’ X’03’			Invalid parameter address Invalid operand: COGUARD Invalid operand: RULENAM Invalid operand: OUTAREA
X’00’	X’20’	X’3200’	class C: COO3200
X’00’	X’40’	X’3300’	class D: COO3300
X’00’	X’40’	X’3301’	class D: COO3301
X’00’	X’40’	X’3302’	class D: COO3302
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’40’	X’3317’	class D: Output area is not large enough
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.