Anwendungsbereich: | SECURITY-ADMINISTRATION |
Privilegierung: | STD-PROCESSING, GUARD-ADMINISTRATION |
Dieses Kommando zeigt die für den Aufrufer gültigen Zugriffsbedingungen des benannten Guards an. Das Guard muss nicht ein eigenes, sondern kann auch ein fremdes sein.
Bei der Anzeige werden nur die Bedingungsdefinitionen bewertet, nicht jedoch, ob die Bedingung im Augenblick zutrifft. Es werden nur die für den Aufrufer gültigen Bedingungen angezeigt, nicht aber, welche weiteren Bedingungen für andere Subjekte in dem Guard abgelegt sind. Beispielsweise erhält ein Aufrufer die Information, dass ihm der Zugriff montags erlaubt ist, unabhängig vom Wochentag, an dem die Ausgabe erfolgt. Der SCOPE des Guards wird nicht berücksichtigt.
Der komplette Guard-Inhalt kann mit dem Kommando /SHOW-ACCESS-CONDITIONS angezeigt werden, sofern der SCOPE des Guards dies zulässt.
Der Aufrufer erhält keinen Hinweis darauf, auf Grund welcher Subjekt-Definition das Ergebnis der Auswertung zustande kommt (ob aus der USER-, GROUP-, OTHERS- oder ALL-USERS-Definition).
SHOW-ACCESS-ADMISSION |
GUARD-NAME = <filename 1..24 without-gen-vers> ,OUTPUT = list-poss(2): *SYSOUT / *SYSLST |
GUARD-NAME = <filename 1..24 without-gen-vers >
Angabe des Guards, dessen Zugriffsbedingungen angezeigt werden sollen.
Die Angabe der System-Standardkennung im Guardnamen, wie zum Beispiel $<filename> oder $.<filename>, wird nicht unterstützt.
OUTPUT =
Bestimmt das Ziel der Ausgabe.
OUTPUT = *SYSOUT
Ausgabe auf Datensichtstation, sofern das Kommando im Dialog gegeben wurde. Im Batchbetrieb hängt das Ausgabeziel von den Angaben im Job ab.
OUTPUT = *SYSLST
Ausgabe auf SYSLST.
Kommando-Returncode
(SC2) | SC1 | Maincode | Bedeutung |
0 | CMD0001 | Kommando erfolgreich ausgeführt | |
32 | PRO1001 | Ein interner Fehler trat auf. Für eine genauere Analyse wurde ein SERSLOG-Eintrag geschrieben | |
64 | PRO1002 | Der Guard-Name ist syntaktisch falsch | |
64 | PRO1007 | Das angegebene Guard existiert nicht | |
64 | PRO1012 | Der angegebene Katalog ist nicht definiert oder nicht zugreifbar | |
64 | PRO1013 | Das Pubset ist bei der GUARDS-Verwaltung unbekannt (Guardskatalog wurde wahrscheinlich bei IMPORT-PUBSET nicht geöffnet) | |
64 | PRO1016 | Fehler im Kommunikationsmittel des MRS | |
64 | PRO1017 | Unbekannte Benutzerkennung | |
64 | PRO1018 | Fernes System nicht verfügbar | |
64 | PRO1020 | Kein Speicher mehr vorhanden | |
64 | PRO1021 | BCAM-Verbindungsfehler | |
64 | PRO1022 | BCAM-Verbindung unterbrochen | |
64 | PRO1023 | Kein Guard entspricht den Auswahlkriterien | |
64 | PRO1024 | Nutzung des Guards nicht zugelassen | |
64 | PRO1028 | Guard hat falschen Typ | |
64 | PRO1029 | GUARDS auf dem fernen Rechner nicht verfügbar | |
64 | PRO1030 | Benutzer-Bedingung im Guard nicht erfüllbar | |
128 | PRO1009 | Das angegebene Guard ist von einer anderen Task gesperrt | |
64 | 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 |
Beispiel
Unter der Benutzerkennung SECOS1 wurden ein Guard GUARDEXA zwei Zugriffsbedingungen eingetragen:
/add-access-conditions guardexa,subjects=*user(secos1),admission=*yes
/add-access-conditions guardexa,subjects=*user(user1),admission=*no
Abhängig von der Benutzerkennung, unter der das Kommando /SHOW-ACCESS-ADMIS-SION aufgerufen wird, erhält man unterschiedliche Ausgaben:
Unter der Benutzerkennung SECOS1
/show-access-admission guardexa
:N:$SECOS1.GUARDEXA User ALWAYS has access admission -------------------------------------------------------------------------- End of display
Unter der Benutzerkennung USER1
/show-access-admission $secos1.guardexa
PRO1030 NO USER ACCESS TO OBJECT PROTECTED BY THIS GUARD
Das Kommando /SHOW-ACCESS-CONDITIONS liefert im Gegensatz dazu folgende Ausgaben:
Unter der Benutzerkennung SECOS1
/show-access-conditions guardexa
:N:$SECOS1.GUARDEXA User SECOS1 has ADMISSION User USER1 has NO ADMISSION -------------------------------------------------------------------------- Guards selected: 1 End of display
Unter der Benutzerkennung USER1
/show-access-conditions $secos1.guardexa
PRO1024 NO AUTHORIZATION FOR GUARD ':2OSG:$QM212.GUARDEXA'. FUNCTION NOT PROCESSED
Das Format der Ausgabe wird nicht garantiert.
Erläuterung der Ausgabe siehe Kommando SHOW-ACCESS-CONDITIONS.
Ausgabe in S-Variablen
Ausgabe-Information | Name der S-Variablen | T | Inhalt | Bedingung |
Name des Guards, dessen | var(*LIST).GUARD-NAME | S | ’’ | |
Subjekttyp USER : Bedingungen, die explizit für einen Benutzer gelten | ||||
Zugriffserlaubnis für den Benutzer | var(*LIST).USER.ADMIS | S | ’’ | |
Kalendardatum, ab dem der | var(*LIST).USER.DATE(*LIST).FROM | S | ’’ | |
Kalendardatum, an dem der | var(*LIST).USER.DATE(*LIST).TO | S | ’’ | |
Wie wird der Zugriff über die | var(*LIST).USER.DATE-KIND | S | ’’ | |
Privileg des Benutzers | var(*LIST).USER.PRIVIL(*LIST) | S | ’’ *FT-ADM | |
Wie wird der Zugriff über Privilegien | var(*LIST).USER.PRIVIL-KIND | S | ’’ | |
Name des Programms, über | var(*LIST).USER.PROG(*LIST).F | S | ’’ | |
Name des Bibliothekelements, in | var(*LIST).USER.PROG(*LIST).MODULE. | S | ’’ | |
Name der Bibliothek, in welcher | var(*LIST).USER.PROG(*LIST).MODULE.LIB | S | ’’ | |
Welche Version muss das | var(*LIST).USER.PROG(*LIST).MODULE. | S | ’’ | |
Name des Bibliothekelements, in | var(*LIST).USER.PROG(*LIST).PHASE. | S | ’’ | |
Name der Bibliothek, in welcher | var(*LIST).USER.PROG(*LIST).PHASE.LIB | S | ’’ | |
Welche Version muss das | var(*LIST).USER.PROG(*LIST).PHASE. | S | ’’ | |
Mit welchen Werten sind die | var(*LIST).USER.PROG-CONTR | S | ’’ | |
Tageszeit, ab der der Zugriff auf | var(*LIST).USER.TIME(*LIST).FROM | S | ’’ | |
Tageszeit, bei der der Zugriff auf | var(*LIST).USER.TIME(*LIST).TO | S | ’’ | |
Wie wird der Zugriff über die | var(*LIST).USER.TIME-KIND | S | ’’ | |
Wochentag, an dem der Zugriff auf | var(*LIST).USER.WEEKDAY(*LIST) | S | ’’ | |
Wie wird der Zugriff über die | var(*LIST).USER.WEEKDAY-KIND | S | ’’ | |
WHEN: Zusätzliche, maßgebende Bedingungen, die im Pseudosubjekt ALL-USERS hinterlegt sind | ||||
Zugriffserlaubnis für den Benutzer | var(*LIST).WHEN.ADMIS | S | ’’ | |
Kalendardatum, ab dem der | var(*LIST).WHEN.DATE(*LIST).FROM | S | ’’ | |
Kalendardatum, an dem der | var(*LIST).WHEN.DATE(*LIST).TO | S | ’’ | |
Wie wird der Zugriff über die | var(*LIST).WHEN.DATE-KIND | S | ’’ | |
Privileg | var(*LIST).WHEN.PRIVIL(*LIST) | S | ’’ *FT-ADM | |
Wie wird der Zugriff über Privilegien | var(*LIST).WHEN.PRIVIL-KIND | S | ’’ | |
Name des Programms, über | var(*LIST).WHEN.PROG(*LIST).F | S | ’’ | |
Name des Bibliothekelements, in | var(*LIST).WHEN.PROG(*LIST).MODULE. | S | ’’ | |
Name der Bibliothek, in welcher | var(*LIST).WHEN.PROG(*LIST).MODULE. | S | ’’ | |
Welche Version muss das | var(*LIST).WHEN.PROG(*LIST).MODULE. | S | ’’ | |
Name des Bibliothekelements, in | var(*LIST).WHEN.PROG(*LIST).PHASE. | S | ’’ | |
Name der Bibliothek, in welcher | var(*LIST).WHEN.PROG(*LIST).PHASE.LIB | S | ’’ | |
Welche Version muss das | var(*LIST).WHEN.PROG(*LIST).PHASE. | S | ’’ | |
Mit welchen Werten sind die | var(*LIST).WHEN.PROG-CONTR | S | ’’ | |
Tageszeit, ab der der Zugriff auf | var(*LIST).WHEN.TIME(*LIST).FROM | S | ’’ | |
Tageszeit, bei der der Zugriff auf | var(*LIST).WHEN.TIME(*LIST).TO | S | ’’ | |
Wie wird der Zugriff über die | var(*LIST).WHEN.TIME-KIND | S | ’’ | |
Wochentag, an dem der Zugriff auf | var(*LIST).WHEN.WEEKDAY(*LIST) | S | ’’ | |
Wie wird der Zugriff über die | var(*LIST).WHEN.WEEKDAY-KIND | S | ’’ |