SHWOBJ Display default protection attributes for objects

With this function, users can display the default protection values which are defined for a specified object name together with the rules in which these default protection values are described. However, the default protection attributes are only displayed for the command caller’s own objects or for objects to which he or she has a corresponding co-owner authorization.

Default protection rules can be specified for both files and job variables and entered in a separate, active rule container for each of these object types. For this reason, the COTYPE operand is used to define whether information is required concerning the default protection attributes of files or job variables. It should be noted that a complete attribute set is always displayed irrespective of whether or not individual attributes for job variables are applicable.

Macro	Operands
SHWOBJ	MF = C / D / L / M / E ,PREFIX = D / <name 1> ,MACID = EFD / <name 3> ,PARAM = <name 1..8> ,XPAND = PARAM / OUTPUT ,OBJNAM = ' ' / <c-string 1..54: filename 1..54 without-gen-vers> / <var: char:54> ,COTYPE = *FILE / *JV / <var: enum-of _container_type_s:1> ,OUTAREA = structure(2): (1) address: NULL / <var: pointer> (2) len: *MAXLEN / <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.

OBJNAM

Object
Name of the object about whose default value assignment the caller of the function requires information.

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

COTYPE

Type of active rule container
Default protection rules can be specified for both files and job variables and entered in a separate, active rule container for each of these object types. For this reason, this operand can be used to define whether information is required concerning the coownership of files or job variables.

=*FILE

A search is performed in an active rule container that contains co-ownership rules for files.

=*JV

A search is performed in an active rule container that contains co-ownership rules for job variables.

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 164 bytes long.

*MAXLEN

Maximum length of the output.

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: COTYPE Invalid operand: OBJNAM Invalid operand: OUTAREA
X’00’	X’20’	X’3200’	class C: DEF3200
X’00’	X’40’	X’3300’	class D: DEF3300
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’3312’	class D: DEF3312
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’3316’	class D: DEF3316
X’00’	X’40’	X’3317’	class D: Output area is not large enough
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.