Anwendungsbereich: | SECURITY-ADMINISTRATION |
Privilegierung: | STD-PROCESSING, GUARD-ADMINISTRATION |
Mit diesem Kommando kann sich ein Anwender für einen spezifizierten Objektnamen anzeigen lassen, welche Standardschutzwerte festgelegt sind und in welchen Regeln diese Standardschutzwerte beschrieben sind. Die Standardschutzattribute werden jedoch nur für eigene Objekte des Kommandoaufrufers oder für Objekte mit entsprechender Miteigentümerberechtigung angezeigt.
Regeln für den Standardschutz können sowohl für Dateinamen als auch für Jobvariablen spezifiziert und in einem jeweils separaten, aktiven Regelbehälter eingetragen sein. Darum wird über den Operand RULE-CONTAINER-TYPE gesteuert, ob Auskunft über Standardschutzattribute von Dateien oder von Jobvariablen gewünscht wird.
SHOW-OBJECT-PROTECTION-DEFAULT(SHO-OBJ-PRO-DEF) | ||||||||||||||||||||||||
| ||||||||||||||||||||||||
OBJECT-NAME =
Name des Objektes, über das sich der Aufrufer bezüglich der Standardschutzattribute informieren will.
Der Name darf keine Musterzeichen enthalten.
RULE-CONTAINER-TYPE =
Typ des aktiven Regelbehälters, in dem nach Regeln für die Standardattributfestlegung gesucht wird.
RULE-CONTAINER-TYPE = *FILE
Es wird in aktiven Regelbehältern gesucht, in denen Regeln für den Standardschutz von Dateien spezifiziert sind (SYS.UDF[<n>]).
RULE-CONTAINER-TYPE = *JV
Es wird in aktiven Regelbehältern gesucht, in denen Regeln für den Standardschutz von Jobvariablen spezifiziert sind (SYS.UDJ[<n>]).
INFORMATION =
Legt den Umfang der Information fest, die ausgegeben wird.
INFORMATION = *ATTRIBUTE-VALUES
Es werden die aus den entsprechenden Regelbehältern und Regeln ermittelten Werte der Standardschutzattribute ausgegeben.
INFORMATION = *ATTRIBUTE-ORIGIN
Es werden zusätzlich zu den Attributwerten pro Standardschutzattribut diejenigen Regelbehälternamen und Regeln angezeigt, in denen der jeweilige Attributwert festgelegt ist.
OUTPUT = list-poss(2):
Dieser Operand bestimmt das Ziel der Ausgabe.
OUTPUT = *SYSOUT
Die Ausgabe erfolgt auf die Datensichtstation, sofern das Kommando 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.
Ausgabelayout (Attribute Values)
Beispiel
Der Miteigentümer LUZIFER informiert sich, welche Standardschutzattribute eine Datei mit Namen $GUABRIEL.PARADIES erhalten würde, wenn er die Datei neu einrichten oder die Attribute mit /MODIFY-FILE-ATTRIBUTES PROTECTION-ATTR=*BY-DEF-PROT-OR-STD ändern würde.
Der Benutzer gibt folgendes Kommando:
|
------------------------------------------------------------------------------
DEFAULTS FOR FILE :ABCD:$GUABRIEL.PARADIES
------------------------------------------------------------------------------
% SCOPE: CREATE-OBJECT % SCOPE: MODIFY-OBJECT-ATTR
% --------------------------- % --------------------------
ACCESS % *SYSTEM-STD % *READ
USER-ACCESS % *SYSTEM-STD % *OWNER-ONLY
BASIC-ACL % *SYSTEM-STD % *NONE
GUARDS % *SYSTEM-STD % READ = $GUABRIEL.REAGUARD
% % WRITE = $GUABRIEL.WRIGUARD
% % EXEC = $GUABRIEL.EXEGUARD
READ-PASSWORD % *SYSTEM-STD % *YES
WRITE-PASSWORD % *SYSTEM-STD % *SYSTEM-STD
EXEC-PASSWORD % *SYSTEM-STD % *SYSTEM-STD
DESTROY-BY-DELETE % *SYSTEM-STD % *YES
SPACE-RELEASE-LOCK % *SYSTEM-STD % *YES
EXPIRATION-DATE % *SYSTEM-STD % *SYSTEM-STD
FREE-FOR-DELETION % *SYSTEM-STD % *SYSTEM-STD
------------------------------------------------------------------------------
END OF DISPLAY
Ausgabelayout (Attribute Origin)
Beispiel
Der Miteigentümer LUZIFER informiert sich, woher die Standardschutzattribute für eine Datei mit Namen $GUABRIEL.PARADIES genommen werden, wenn er die Datei neu einrichten oder die Attribute mit /MODIFY-FILE-ATTRIBUTES PROTECTION-ATTR=*BY-DEF-PROT-OR-STD ändern würde.
Der Benutzer gibt folgendes Kommando:
|
------------------------------------------------------------------------------
DEFAULT ORIGIN FOR FILE :ABCD:$GUABRIEL.PARADISE
------------------------------------------------------------------------------
ACCESS SCOPE % CREATE-OBJECT
VALUE % *SYSTEM-STD
CONTAINER GUARD % $GUABRIEL.SYS.UDF USR ACTIVE
RULE % RULE00000001
USERID GUARD % IGNORED
ATTRIBUTE GUARD % $GUABRIEL.MYATTRIB
------------------------------------------------------------------------------
ACCESS SCOPE % MODIFY-OBJECT-ATTR
VALUE % *SYSTEM-STD
CONTAINER GUARD % $GUABRIEL.SYS.UDF USR ACTIVE
RULE % RULE00000001
USERID GUARD % IGNORED
ATTRIBUTE GUARD % $GUABRIEL.MYATTRIB
------------------------------------------------------------------------------
USER-ACCESS *)
BASIC-ACL *)
GUARDS *)
READ-PASSWORD *)
WRITE-PASSWORD *)
EXEC-PASSWORD *)
DESTROY-BY-DELETE *)
SPACE-RELEASE-LOCK *)
EXPIRATION-DATE *)
------------------------------------------------------------------------------
FREE-FOR-DELETION SCOPE : CREATE-OBJECT
VALUE % *SYSTEM-STD
CONTAINER GUARD: $TSOS.SYS.PDF PVS ACTIVE
RULE : 2
USERID GUARD : *ANY-USER-ID
ATTRIBUTE GUARD: $TSOS.SYSATTR
------------------------------------------------------------------------------
FREE-FOR-DELETION SCOPE : MODIFY-OBJECT-ATTR
VALUE % *SYSTEM-STD
CONTAINER GUARD: $TSOS.SYS.PDF PVS ACTIVE
RULE : 2
USERID GUARD : *ANY-USER-ID
ATTRIBUTE GUARD: $TSOS.SYSATTR
------------------------------------------------------------------------------
END OF DISPLAY
*) Auf die Ausgabe für diese Attribute wird aus Platzgründen verzichtet, das Format der Ausgabe ist wie bei den Attributen ACCESS und FREE-FOR-DELETION
Das Format der Ausgabe wird nicht garantiert.
Kommando-Returncode
(SC2) | SC1 | Maincode | Bedeutung |
0 | CMD0001 | Kommando erfolgreich ausgeführt | |
1 | DEF3100 | Es wurde ein fehlerhafter Operandenwert erkannt. | |
32 | DEF3200 | Es ist ein interner Fehler aufgetreten. Für eine genaue Analyse wurde ein SERSLOG-Eintrag erzeugt. | |
64 | DEF3300 | Der angegebene Regelbehälter existiert nicht. | |
64 | DEF3302 | Der Benutzer ist nicht autorisiert, die Funktion auszuführen. | |
64 | DEF3306 | Ein angegebenes Guard ist nicht vom erforderlichen Guardtyp. | |
64 | DEF3308 | Eine Benutzerkennung ist unbekannt. | |
64 | DEF3309 | Keine Unterstützung für einen Remote-File-Access. | |
64 | DEF3312 | Es wurde keine Standardschutzregel für ein genanntes Objekt gefunden. | |
64 | DEF3313 | Ein angegebenes Public Volume Set ist nicht verfügbar. | |
64 | DEF3314 | Fehler im Kommunikationsmittel des MRS. | |
64 | DEF3315 | Ein angegebenes Public Volume Set ist der lokalen GUARDS-Verwaltung nicht bekannt. | |
64 | DEF3316 | Der Standardschutz ist nicht aktiv, da kein aktiver Regelbehälter gefunden wurde. | |
64 | DEF3318 | Ein Guard mit Benutzerkennungen, das in eine Regel eingetragen werden soll, ist nicht zugreifbar. | |
64 | DEF3320 | Ein angegebenes Attributguard ist nicht zugreifbar. | |
64 | DEF3321 | Ein benötigter benutzerspezifischer Regelbehälter ist nicht zugreifbar. | |
64 | DEF3322 | Ein benötigter pubsetspezifischer Regelbehälter ist nicht zugreifbar. | |
128 | DEF3900 | Es steht nicht mehr genügend Systemspeicher zur Verfügung. | |
128 | DEF3901 | Ein zu bearbeitendes Guard ist von einer anderen Task gesperrt und kann zur Zeit nicht bearbeitet werden. | |
128 | DEF3902 | Ein Guard ist vorübergehend nicht zugreifbar, weil der GUARDS-Katalog gewechselt wird, oder ein Master-Wechsel im Rechnerverbund stattfindet. | |
128 | OPS0002 | Ausgabe der S-Variablen wurde unterbrochen | |
130 | OPS0001 | Ausgabe der S-Variablen konnte nicht durchgeführt werden | |
32 | CMD2009 | Systemfehler bei Ausgabe der S-Variablen |
Ausgabe in S-Variablen
Mit dem Operanden INFORMATION des Kommandos wird festgelegt, welche S-Variablen mit Werten versorgt werden. Folgende Angaben sind für INFORMATION möglich:
Schreibweise im Kommando | gekürzte Schreibweise in Tabelle |
INFORMATION = *ATTRIBUTE-VALUES | 1 |
INFORMATION = *ATTRIBUTE-ORIGIN | 2 |
Ausgabe-Information | Name der S-Variablen | T | Inhalt | Bedingung |
Name des Objekts | VAR(*LIST).OBJECT-NAME | S | <filename 1..54> | 1, 2 |
Typ des aktiven Regelbehälters | VAR(*LIST).RULE-CONTAIN-TYPE | S | *FILE | 1, 2 |
Attributbereich | VAR(*LIST).SCOPE(*LIST).SCOPE | S | *CREATE-OBJECT | 1, 2 |
Zugriffsart | VAR(*LIST).SCOPE(*LIST).ATTR-ACCESS | S | *SYSTEM-STD | 1, 2 |
Benutzerkreis des Objekts | VAR(*LIST).SCOPE(*LIST). | S | *SYSTEM-STD | 1, 2 |
Schutz durch BASIC-ACL | VAR(*LIST).SCOPE(*LIST). | S | *SYSTEM-STD | 1, 2 |
Leseberechtigung für OWNER | VAR(*LIST).SCOPE(*LIST). | S | *YES | 1, 2 |
Ausführberechtigung für OWNER | VAR(*LIST).SCOPE(*LIST). | S | *YES | 1, 2 |
Schreibberechtigung für OWNER | VAR(*LIST).SCOPE(*LIST). | S | *YES | 1, 2 |
Leseberechtigung für GROUP | VAR(*LIST).SCOPE(*LIST). | S | *YES | 1, 2 |
Ausführberechtigung für GROUP | VAR(*LIST).SCOPE(*LIST). | S | *YES | 1, 2 |
Schreibberechtigung für GROUP | VAR(*LIST).SCOPE(*LIST). | S | *YES | 1, 2 |
Leseberechtigung für OTHERS | VAR(*LIST).SCOPE(*LIST). | S | *YES | 1, 2 |
Ausführberechtigung für OTHERS | VAR(*LIST).SCOPE(*LIST). | S | *YES | 1, 2 |
Schreibberechtigung für OTHERS | VAR(*LIST).SCOPE(*LIST). | S | *YES | 1, 2 |
Schutz durch GUARDS | VAR(*LIST).SCOPE(*LIST). | S | *SYSTEM-STD | 1, 2 |
Name des Guards, über das | VAR(*LIST).SCOPE(*LIST). | S | <guard-name> | 1, 2 |
Name des Guards, über das | VAR(*LIST).SCOPE(*LIST). | S | <guard-name> | 1, 2 |
Name des Guards, über das | VAR(*LIST).SCOPE(*LIST). | S | <guard-name> | 1, 2 |
Lesekennwort | VAR(*LIST).SCOPE(*LIST). | S | *SYSTEM-STD | 1, 2 |
Schreibkennwort | VAR(*LIST).SCOPE(*LIST). | S | *SYSTEM-STD | 1, 2 |
Ausführungskennwort | VAR(*LIST).SCOPE(*LIST). | S | *SYSTEM-STD | 1, 2 |
Datenzerstörung beim Löschen | VAR(*LIST).SCOPE(*LIST). | S | *SYSTEM-STD | 1, 2 |
Freigabe von Speicherplatz | VAR(*LIST).SCOPE(*LIST). | S | *SYSTEM-STD | 1, 2 |
Freigabedatum | VAR(*LIST).SCOPE(*LIST). | S I | *SYSTEM-STD | 1, 2 |
Löschungsdatum des Objekts | VAR(*LIST).SCOPE(*LIST). | S I | *SYSTEM-STD | 1, 2 |
Regel, mit der die Zugriffsart | VAR(*LIST).SCOPE(*LIST).ORIG-ACCESS | Unterstruktur (Aufbau | 1 | |
Regel, mit der der Benutzerkreis | VAR(*LIST).SCOPE(*LIST). | Unterstruktur (Aufbau | 1 | |
Regel, mit der der Schutz durch | VAR(*LIST).SCOPE(*LIST). | Unterstruktur (Aufbau | 1 | |
Regel, mit der der Schutz durch | VAR(*LIST).SCOPE(*LIST). | Unterstruktur (Aufbau | 1 | |
Regel, mit der das Lesekennwort | VAR(*LIST).SCOPE(*LIST). | Unterstruktur (Aufbau | 1 | |
Regel, mit der das Schreibkennwort | VAR(*LIST).SCOPE(*LIST). | Unterstruktur (Aufbau | 1 | |
Regel, mit der das Ausführungskennwort | VAR(*LIST).SCOPE(*LIST). | Unterstruktur (Aufbau | 1 | |
Regel, mit der die Datenzerstörung | VAR(*LIST).SCOPE(*LIST). | Unterstruktur (Aufbau | 1 | |
Regel, mit der die Freigabe von | VAR(*LIST).SCOPE(*LIST). | Unterstruktur (Aufbau | 1 | |
Regel, mit der das Freigabedatum | VAR(*LIST).SCOPE(*LIST). | Unterstruktur (Aufbau | 1 | |
Regel, mit der das Löschungsdatum | VAR(*LIST).SCOPE(*LIST). | Unterstruktur (Aufbau | 1 | |
Anmerkung
Die Unterstrukturen ORIG-ACCESS, ORIG-USER-ACCESS, ORIG-B-ACL, ORIG-GU-ARDS, ORIG-READ-PASS, ORIG-WRITE-PASS, ORIG-EXEC-PASS, ORIG-DESTROY, ORIG-SPACE-RELE-LOCK, ORIG-EXPIR-DATE und ORIG-DEL-DATE bestehen aus folgenden Einzelvariablen:
Ausgabe-Information | Name der S-Variablen | T | Inhalt | Bedingung |
Regelbehälter, in dem der Wert | VAR(*LIST).SCOPE(*LIST).ORIG-xxx. | S | <filename 1..24> | 1 |
Angabe, ob es ein pubsetglobaler | VAR(*LIST).SCOPE(*LIST).ORIG-xxx. | S | USR ACTIVE | 1 |
Name der Regel, durch die der | VAR(*LIST).SCOPE(*LIST).ORIG-xxx. | S | <alphanumeric name | 1 |
Name des Attributguards, das in | VAR(*LIST).SCOPE(*LIST).ORIG-xxx. | S | <filename 1..24> | 1 |
Name des Benutzerkennungsguards, | VAR(*LIST).SCOPE(*LIST).ORIG-xxx. | S | <filename 1..24> | 1 |
Angabe, ob ein Benutzerkennungsguard | VAR(*LIST).SCOPE(*LIST).ORIG-xxx. | S | IGNORED | 1 |
Beispiel
Die Unterstruktur VAR(*LIST).SCOPE(*LIST).ORIG-ACCESS besteht aus folgenden Variablen:
VAR(*LIST).SCOPE(*LIST).ORIG-ACCESS.RULE-CONTAIN-GUARD
VAR(*LIST).SCOPE(*LIST).ORIG-ACCESS.RULE-CONTAIN-CONDITION
VAR(*LIST).SCOPE(*LIST).ORIG-ACCESS.RULE-NAME
VAR(*LIST).SCOPE(*LIST).ORIG-ACCESS.ATTRIBUTE-GUARD
VAR(*LIST).SCOPE(*LIST).ORIG-ACCESS.USER-ID-GUARD und
VAR(*LIST).SCOPE(*LIST).ORIG-ACCESS.USER-ID-GUARD-IND