SHOW-GUARD-MANAGEMENT-STATUS Display system status of GUARDS

Domain:	SECURITY-ADMINISTRATION
Privileges:	TSOS, GUARD-ADMINISTRATION

This command displays the following information about the status of the GUARDS administration:

• the name of the guards catalog

• the name of the SSINFO file

• the number of server tasks

• the number of pubsets managed by GUARDS

• the number of pubsets per server task

• for each pubset: the related server task
  the status of the pubset - one of the following:

  NOT INITIALIZED	guards catalog is not initialized on the pubset
  INITIALIZED	guards catalog is initialized on the pubset
  IN INITIALIZATION	guards catalog is being initialized on the pubset
  IN TERMINATION	GUARDS is being terminated for the pubset
  LOCKED BY ARCHIVE	guards catalog on the pubset is locked by ARCHIVE

This command cannot be used with MSCF or RFA.

SHOW-GUARD-MANAGEMENT-STATUS

OUTPUT = list-poss(2): *SYSOUT / *SYSLST

OUTPUT =
Destination for the output. If both keywords are specified, the output is sent to both the data display terminal and SYSLST. In batch mode, specification of *SYSOUT is ignored.

Command return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	Command successfully executed
	32	PRO1001	An internal error has occurred. A SERSLOG entry has been written for further analysis
	64	PRO1014	The user is not authorized to execute this function.
	64	PRO1020	No more memory space available
	64	OPS0002	Output of S variables has been aborted
	130	OPS0001	It was not possible to output the S variables
	32	CMD2009	System error during output of S variables

Example

/show-guard-management-status

                      Status Information for  G U A R D S                      
                      -----------------------------------                      
GUARD Catalog name    : $TSOS.SYSCAT.GUARDS                                    
INFO File name        : $TSOS.SYSSSI.GUARDS.055                                
Number of server tasks: 1               Number of served pubsets: 1            
Task serves pubsets                                                            
PR01                    11                                                     
Pubset served by task                   Status                                 
11                      PR01            INITIALIZED                            
                                                               End of display

Output in S variables

Output information	Name of the S variable	T	Contents	Condition
Name of the guard catalog	var(*LIST).GUARD-CAT-NAME	S	<filename 1..40>
Number of pubsets managed by GUARDS	var(*LIST).NUM-OF-SERVED-PUBSET	I	<integer 1..16>
Number of server tasks	var(*LIST).NUM-OF-SERVER-TASK	I	<integer 1..32767>
Catalog ID of the pubset	var(*LIST).PUBSET(*LIST).PUBSET	S	<cat-id 1..4>
Status of the pubset *IN-INIT: guard catalog is being initialized on the pubset *IN-TERM: GUARDS is terminated for this pubset *INIT: guard catalog has been initialized on the pubset *LOCK-BY-ARCHIVE: the guard catalog on this pubset has been locked by ARCHIVE for security purposes *NOT-INIT: guard catalog has not been initialized on the pubset	var(*LIST).PUBSET(*LIST).STA	S	*IN-INIT *IN-TERM *INIT *LOCK-BY-ARCHIVE *NOT-INIT
TSN of the server task	var(*LIST).PUBSET(*LIST).TSN	S	<name 1..4>
Catalog ID of the pubset	var(*LIST).SERVER(*LIST).PUBSET(*LIST)	S	<cat-id 1..4>
TSN of the server task	var(*LIST).SERVER(*LIST).TSN	S	<name 1..4>
Name of the SSINFO file	var(*LIST).SSINFO-F-NAME	S	<filename 1..40>