SHWGUAD Show guard attributes

This macro shows the attributes of guards.

Macro

Operands

SHWGUAD

MF = D / L / C / M / E ,PREFIX = P / <name 1> ,MACID = RON / <name 3> ,PARAM = <name 1..8> ,XPAND = PARAM / OUTPUT ,NAME = <c-string: filename 1..40 without-gen-vers with-wild> / <c-string: partial-filename 2..40 with-wild> / <var: char(40)> / (<reg: A(char(40))>) ,SCOPE = *ANY / list-poss(3): *USER_GROUP / *USERID / *HOST_SYSTEM ,INFORM = *ALL / *NAME / <var: enum INFORM> / (<reg: enum INFORM>) ,OUTAREA = structure(2): (1) address: <label> / (<reg: pointer>) (2) length: <integer 4..231-1> / <var: integer(4)> / (<reg: integer(4)>)

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

XPAND

specifies the declarations to be expanded. This operand is valid only for MF=D.

=PARAM

Model of the parameter area.

=OUTPUT

Models of the partial output areas.

NAME

Name of the guard to be shown. This must be entered in uppercase letters, and may contain wildcards. Only guard administrators may specify wildcards in the user ID.

SCOPE

Selection by the SCOPE attribute (assigned in CREATE-GUARD or CREGUAD). Any specification other than *ANY shows only the guards with the specified scope. Only the owner and guard administrators may select guards by the SCOPE attribute.

INFORM

Information to be shown:

=*ALL

All available information about the guard is shown.

=*NAME

Only the names of the guards are shown. This specification is meaningless if there are no wildcards in NAME, since only the name of the guard which was specified for NAME is output.

OUTAREA

Address and length of the output area.

Application notes

1. The owner of a guard and guard administrators can always show all information about a guard. Other users can do this only if it is permitted by the SCOPE attribute.

2. If the guards are on a pubset which is accessible via RFA, the maximum supported output area length is 64 Kbytes, i.e. even if a larger area (>64 Kbytes) is specified, only 64 Kbytes of information are transferred to the output area by one macro call. If the block to be transferred is larger than 64 Kbytes, the interface must be called as many times as necessary to transfer the entire data.

3. The indicator prefix.RONOMOR in the parameter area shows whether there are further guards which fulfill the selection criteria when the space in the output area is full. The information for these guards can be read by calling the procedure again. Note, however, that the parameter block must not be modified before issuing further calls.

4. The field prefix.RONOUS# shows the length of the information transferred to the output area.

Macro return codes

SC2	SC1	Maincode	Meaning
	X’01’	X’1000’	The specified operand value lies outside the permitted range. The invalid operand is stored as a symbolic value in SC2
	X’20’	X’1001’	An internal error has occurred. A SERSLOG entry has been written for further analysis
	X’40’	X’1002’	Syntax error in the guard name
	X’40’	X’1003’	Memory for the parameter area not allocated with the required length or not accessible
	X’40’	X’1004’	Memory for the parameter area not allocated with the required length or cannot be written
	X’40’	X’1005’	The output area is too small
	X’40’	X’1007’	The specified guard does not exist
	X’80’	X’1009’	The specified guard is locked by another task
	X’40’	X’1012’	The specified catalog is not defined or not accessible
	X’40’	X’1013’	The pubset is not known to the GUARDS administration (the guards catalog was probably not opened at IMPORT-PUBSET)
	X’40’	X’1016’	Error in the MRS communication facility
	X’40’	X’1017’	Unknown user ID
	X’40’	X’1018’	The remote system is not available
	X’40’	X’1020’	No more memory space available
	X’40’	X’1021’	BCAM connection error
	X’40’	X’1022’	The BCAM connection has been interrupted
	X’40’	X’1023’	There is no guard matching the selection criteria
	X’40’	X’1024’	Use of the guard is not permitted
	X’40’	X’1029’	GUARDS is not available on the remote system
	X’80’	X’1036’	The guards catalog is locked