Mit dieser Anweisung können unterschiedliche Angaben über Guards angezeigt werden, die in einer Sicherungdatei gesichert worden sind. Die Menge der für die Anzeige auszuwählenden Guards kann durch Musterzeichen festgelegt werden. Ein nichtprivilegierter Benutzer sich darf nur die Guards seiner eigenen Kennung, ein Guards-Administrator darf sich die Guards aller Kennungen aus der Sicherungsdatei anzeigen lassen.
Neben dem Datum der Sicherung können wahlweise die Namen der gesicherten Guards, deren Attribute, oder eine Querverweisliste der gesicherten Referenzguards angezeigt werden.
Guards können weitere Guards referenzieren. Zum Beispiel können in Regeln für den Miteigentümerschutz Verweise auf Guards des Typs STDAC auftreten. Mit dem Operanden RESOLVE kann gesteuert werden, ob referenzierte Guards automatisch mit angezeigt werden sollen. In diesem Fall werden alle referenzierten Guards unabhängig von ihrem Namen und ihrem Typ für die Sicherung ausgewählt. Das heißt, für sie haben die Angaben der Operanden GUARD-NAME und GUARD-TYPE keine Bedeutung. Es wird eine Querverweisliste erzeugt und nach SYSOUT/ SYSLST ausgegeben. Kann auf ein Referenzguard nicht zugegriffen werden, z.B. weil es dem (nichtprivilegierten) Aufrufer nicht gehört, wird es in der Liste der referenzierten Guards mit einem entsprechenden Fehlercode aufgelistet.
SHOW-BACKUP-FILE | ||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||
GUARD-NAME =
Angabe des oder der Guards, die angezeigt werden sollen.
Abhängigkeit zum Operanden SELECT
Mit der Angabe von
SELECT=*BY-ATTRIBUTES(TYPE=...)kann eine typabhängige Einschränkung der benannten Guardmenge erzielt werden.Bei Angabe von
SELECT=*BY-ATTRIBUTES(RESOLVE=YES)werden auch referenzierte Guards angezeigt und zwar unabhängig von ihrem Namen und Typ.
GUARD-NAME = *
Bei der Selektion für die Anzeige soll jeder Guardname berücksichtigt werden.
GUARD-NAME = <filename 1..24 without-gen-vers with-wild(40)>
Teil- oder vollqualifizierter Name der Guards, die angezeigt werden sollen. Guardnamen dürfen Musterzeichen enthalten, Musterzeichen in der Benutzerkennung darf nur ein Guards-Administrator angeben.
Eine Katalogkennung darf im Pfadnamen nicht angegeben werden, denn eine Sicherungsdatei kann nur die Guards eines einzelnen Pubsets aufnehmen.
Die Angabe der System-Standardkennung im Guardnamen, wie zum Beispiel $<filename> oder $.<filename>, wird nicht unterstützt.
SELECT =
Angabe der Kriterien, die zusätzlich zum Operanden GUARD-NAME für die Auswahl der anzuzeigenden Guards herangezogen werden sollen.
SELECT = *ALL
Es werden alle Guardtypen und alle referenzierten Guards ausgewählt. Die Referenzguards werden dabei unabhängig von ihrem Namen ausgewählt.
SELECT = *BY-ATTRIBUTES(...)
Die Menge der mit dem Operanden GUARD-NAME ausgewählten Guards wird durch weitere Kriterien modifiziert.
TYPE =
Angabe des Guardtyps, auf den die Auswahl beschränkt werden soll.
TYPE = *ANY
Die Guards werden unabhängig von ihrem Typ ausgewählt.
TYPE = list-poss(6): <name 1..8>
Nur Guards des angegeben Typs bzw. der angegebenen Typen werden ausgewählt. Folgende Angaben sind erlaubt:
Guardtyp | Bedeutung |
COOWNERP | Regelbehälter für den Miteigentümerschutz |
DEFAULTP | Regelbehälter für den Standardschutz |
DEFPATTR | Attributguards (Standardschutz) |
DEFPUID | Benutzerkennungsguards (Standardschutz) |
STDAC | Zugriffsbedingungsguards |
UNDEF | Guards undefiniertenTyps |
RESOLVE =
Angabe, ob die ausgewählten Guards nach referenzierten Guards durchsucht werden sollen.
RESOLVE = *YES
Ausgewählte Guards werden nach referenzierten Guards durchsucht. Die so gefundenen Referenzguards werden zusätzlich unabhängig von ihrem Namen und Typ ausgewählt.
Guardtyp | Referenzguards |
COOWNERP | In den Regeln spezifizierte Zugriffsbedingungsguards |
DEFAULTP | In den Regeln spezifizierte Attribut- und Benutzerkennungsguards |
DEFPATTR | In den Schutzattributen spezifizierte Guards |
DEFPUID | keine |
STDAC | keine |
UNDEF | keine |
RESOLVE = *NO
Die Guards werden nicht nach referenzierten Guards durchsucht. Angezeigt werden ausschließlich die aufgrund ihres Namens (Operand GUARD-NAME) und Typs (Operand TYPE) ausgewählten Guards.
BACKUP-FILE-NAME = <filename 1..54 without-gen-vers>
Name der Sicherungsdatei, aus der die anzuzeigenden Guards ermittelt werden sollen. Die Angabe der System-Standardkennung im Dateinamen, wie zum Beispiel $<filename> oder $.<filename> ist erlaubt.
INFORMATION =
Legt den Umfang der Anzeige fest.
INFORMATION = *ATTRIBUTES
Es werden die Guardattribute der gesicherten Guards angezeigt.
INFORMATION = *NAMES-ONLY
Es werden nur die Namen der gesicherten Guards angezeigt.
INFORMATION = *SUMMARY
Es werden nur zusammenfassende Informationen aus der Sicherungsdatei angezeigt, jedoch keine Listen mit Guardnamen. Aus dieser Kurzinformation ist zum Beispiel ersichtlich, für welches Pubset und an welchem Datum die Sicherung durchgeführt wurde und wie viele Guards selektiert wurden.
OUTPUT = list-poss(2):
Dieser Operand bestimmt das Ziel der Ausgabe einer Ergebnisprotokollierung.
OUTPUT= *SYSOUT
Die Ausgabe erfolgt auf die Datensichtstation, sofern die Anweisung im Dialog angegeben wurde. Im Batchbetrieb hängt das Ausgabeziel von den Angaben im Job ab.
OUTPUT = *SYSLST(...)
Die Ausgabe erfolgt auf die Systemdatei SYSLST.
SYSLST-NUMBER = *STD
Die Ausgabe erfolgt auf die Systemdatei SYSLST.
SYSLST-NUMBER = <integer 1..99>
Zweistellige Zahl nn, die zur Bildung des Dateinamens SYSLSTnn verwendet wird.
Beispiele für die Ausgabe nach einem Anzeigelauf
Ausgabe der Guardattribute
//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 ***
%******************************************************************************
%//
Ausgabe der Guardnamen
//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 ***
%******************************************************************************
%//
Ausgabe einer zusammenfassenden Information
//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 ***
%******************************************************************************
%//