This statement can be used to display divers information about guards that have been saved to a backup file. The set of guards to be selected for displaying can be specified using wildcards. A nonprivileged user can only display the guards from his own ID while a guards administrator can display the guards from all IDs in the backup file.
The names of the saved guards, their attributes or a cross reference list of the reference guards can be selectably displayed together with the backup date.
Guards can reference further guards. For example, rules for co-owner protection can contain references to guards of type STDAC. The RESOLVE operand can be used to control whether referenced guards are also automatically included in the display. In this case, all referenced guards are selected for display regardless of their name or type. This means that the GUARD-NAME and GUARD-TYPE operands are meaningless for them. A cross reference list is created and output to SYSOUT/ SYSLST. If a reference guard cannot be accessed, e.g. because it does not belong to the (nonprivileged) caller, it is included in the list of referenced guards with a corresponding error code.
SHOW-BACKUP-FILE | ||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||
GUARD-NAME =
Specifies the guard(s) to be displayed.
Dependency to the SELECT operand
A type-dependent limitation can be made to the selected set of guards by specifying
SELECT=*BY-ATTRIBUTES(TYPE=...).Specifying
SELECT=*BY-ATTRIBUTES(RESOLVE=YES)causes referenced guards to also be displayed, regardless of their name or type.
GUARD-NAME = *
All guard names are to be selected for display.
GUARD-NAME = <filename 1..24 without-gen-vers with-wild(40)>
Part or fully qualified name of the guards to be displayed. Guard names may contain wildcards, but only a guards administrator is allowed to specify wildcards in the user ID.
A catalog ID cannot be specified in the path name because only the guards from a single pubset can be stored in a backup file.
Specifying the system default ID in guard names, e.g. $<filename> or $.<filename> is not supported.
SELECT =
Specifies the criteria to be used in addition to the GUARD-NAME operand for selecting the guards to be displayed.
SELECT = *ALL
Selects all guard types and all referenced guards. The referenced guards are thereby selected regardless of their names.
SELECT = *BY-ATTRIBUTES(...)
Modifies the set of guards selected with the GUARD-NAME operand by further criteria.
TYPE =
Specifies the guard type to limit selection to.
TYPE = *ANY
Selects the guards regardless of their type.
TYPE = list-poss(6): <name 1..8>
Selects only guards of the specified type or types. The following entries are permitted:
Guard type | Meaning |
COOWNERP | Rule container for co-owner protection |
DEFAULTP | Rule container for default protection |
DEFPATTR | Attribute guards (default protection) |
DEFPUID | User ID guards (default protection) |
STDAC | Access condition guards |
UNDEF | Guards of undefined type |
RESOLVE =
Specifies whether the selected guards are to be searched for referenced guards.
RESOLVE = *YES
Selected guards are searched for referenced guards. Any referenced guards found are selected additionally, regardless of their name or type.
Guard type | Reference guards |
COOWNERP | Access condition guards specified in the rules |
DEFAULTP | Attribute and user ID guards specified in the rules |
DEFPATTR | Guards specified in the protection attributes |
DEFPUID | none |
STDAC | none |
UNDEF | none |
RESOLVE = *NO
The guards are not searched for referenced guards. Only the guards selected by their name (GUARD-NAME operand) and type (TYPE operand) are displayed.
BACKUP-FILE-NAME = <filename 1..54 without-gen-vers>
Name of the backup file from which the files to be displayed are to be determined. Specifying the system default ID in file names, e.g. $<filename> or $.<filename> is allowed.
INFORMATION =
defines the scope of the display.
INFORMATION = *ATTRIBUTES
Displays the guard attributes of the saved guards.
INFORMATION = *NAMES-ONLY
Only displays the names of the saved guards.
INFORMATION = *SUMMARY
Only a summary of information from the backup file is displayed, but no list of guard names. From this brief information it is possible to ascertain the pubset that was saved, the date of the backup and the number of guards that were selected.
OUTPUT = list-poss(2):
This operand defines the destination for the output of a result logging.
OUTPUT= *SYSOUT
Output is sent to the data display terminal if the command was entered in dialog mode. In batch mode, the output destination depends on the specifications in the batch job.
OUTPUT = *SYSLST(...)
Output is sent to the system file SYSLST.
SYSLST-NUMBER = *STD
Output is sent to the system file SYSLST.
SYSLST-NUMBER = <integer 1..99>
Two-digit number nn used for forming the file name SYSLSTnn.
Examples for output after a display run
Output of guard attributes
//show-backup-file guard-name=*, -
backup-file-name=g-save, -
information=*ATTRIBUTES
% PRO7019 '2' GUARDS SELECTED OUT OF BACKUP FILE ':XXXX:$MARY.G-SAVE
%******************************************************************************
%GUARDS-SAVE SHOW-BACKUP-FILE Started by User MARY 2017-12-07/18:01:00
% -------------------------
% *** Begin of Output ***
%******************************************************************************
%Backup File : :XXXX:$MARY.G-SAVE
%Backup Date : 2017-12-07/14:11:58
%Backup Pubset : XXXX
%Backup Guards : 2
%
%Show Guard : :XXXX:$MARY.*
%Show Type : COOWNERP, DEFAULTP, DEFPATTR, DEFPUID , STDAC , UNDEF
%Show Resolve : *YES
%******************************************************************************
%Selected Guards : 2
%Faulty Guards : 0
%******************************************************************************
%
% Alphabetical List of Selected and Faulty Guards
%
%==============================================================================
%Guard Name Scope Type Creation Date Last Modification
%---------- ----- ---- ------------- -----------------
%:XXXX:$MARY.STDAC USR STDAC 2017-12-06/10:12:07 2017-12-06/10:12:12
% Referenzguard fur Miteigentuemerschutz
%:XXXX:$MARY.SYS.UCF USR COOWNERP 2017-12-06/10:13:54 2017-12-06/10:20:08
% Regelbehaelter fuer Miteigentuemerschutz
%==============================================================================
%
% Alphabetical List of Cross References
%
%==============================================================================
%:XXXX:$MARY.SYS.UCF COOWNERP -> :XXXX:$MARY.STDAC STDAC
%-----------------------------------------------------------------------------%:XXXX:$MARY.STDAC
STDAC <- :XXXX:$MARY.SYS.UCF COOWNERP
%==============================================================================
%
%******************************************************************************
%GUARDS-SAVE SHOW-BACKUP-FILE Started by User MARY 2017-12-07/18:01:00
% -------------------------
% *** End of Output ***
%******************************************************************************
%//
Output of guard names
//show-backup-file guard-name=*, -
backup-file-name=g-save, -
information=*NAMES-ONLY
% PRO7019 '2' GUARDS SELECTED OUT OF BACKUP FILE ':XXXX:$MARY.G-SAVE
%******************************************************************************
%GUARDS-SAVE SHOW-BACKUP-FILE Started by User MARY 2017-12-07/18:01:00
% -------------------------
% *** Begin of Output ***
%******************************************************************************
%Backup File : :XXXX:$MARY.G-SAVE
%Backup Date : 2017-12-07/14:11:58
%Backup Pubset : XXXX
%Backup Guards : 2
%
%Show Guard : :XXXX:$MARY.*
%Show Type : COOWNERP, DEFAULTP, DEFPATTR, DEFPUID , STDAC , UNDEF
%Show Resolve : *YES
%******************************************************************************
%Selected Guards : 2
%Faulty Guards : 0
%******************************************************************************
%
% Alphabetical List of Selected and Faulty Guards
%
%==============================================================================
%Guard Name Guard Type Error Status
%---------- ---------- ----- ------
%:XXXX:$MARY.STDAC STDAC
%:XXXX:$MARY.SYS.UCF COOWNERP
%==============================================================================
%
% Alphabetical List of Cross References
%
%==============================================================================
%:XXXX:$MARY.SYS.UCF COOWNERP -> :XXXX:$MARY.STDAC STDAC
%-----------------------------------------------------------------------------%:XXXX:$MARY.STDAC
STDAC <- :XXXX:$MARY.SYS.UCF COOWNERP
%==============================================================================
%
%******************************************************************************
%GUARDS-SAVE SHOW-BACKUP-FILE Started by User MARY 2017-12-07/18:01:00
% -------------------------
% *** End of Output ***
%******************************************************************************
%//
Output of an information summary
//show-backup-file guard-name=*, -
backup-file-name=g-save, -
information=*SUMMARY
% PRO7019 '2' GUARDS SELECTED OUT OF BACKUP FILE ':XXXX:$MARY.G-SAVE
%******************************************************************************
%GUARDS-SAVE SHOW-BACKUP-FILE Started by User MARY 2017-12-07/18:01:00
% -------------------------
% *** Begin of Output ***
%******************************************************************************
%Backup File : :XXXX:$MARY.G-SAVE
%Backup Date : 2017-12-07/14:11:58
%Backup Pubset : XXXX
%Backup Guards : 2
%
%Show Guard : :XXXX:$MARY.*
%Show Type : COOWNERP, DEFAULTP, DEFPATTR, DEFPUID , STDAC , UNDEF
%Show Resolve : *YES
%******************************************************************************
%Selected Guards : 2
%Faulty Guards : 0
%******************************************************************************
%
%******************************************************************************
%GUARDS-SAVE SHOW-BACKUP-FILE Started by User MARY 2017-12-07/18:01:00
% -------------------------
% *** End of Output ***
%******************************************************************************
%//