Aliaskatalog-Einträge ausgeben
Komponente: | ACS |
Funktionsbereich: | Dateiverarbeitung |
Anwendungsbereich: | FILE |
Privilegierung: | STD-PROCESSING |
Funktionsbeschreibung
Das Kommando SHOW-ALIAS-CATALOG-ENTRY gibt AC-Einträge nach SYSOUT aus. Einträge, die mit dem Attribut INVISIBLE definiert sind, werden nur dem ACS-Administrator ausgegeben. Der Benutzer wählt die auszugebenden Einträge über die vereinbarten Aliasnamen aus. Bei Auswahl aller Einträge kann er den Umfang der Informationsausgabe einschränken:
Ausgabe einer Summenzeile für alle betroffenen AC-Einträge
Auswahl nach dem Geltungsbereich der Einträge (Benutzer- oder Systemeintrag)
Auswahl nach Wirkungsbereich der Einträge (für Dateien und/oder Jobvariablen)
Das Kommando unterstützt die strukturierte Ausgabe in S-Variable (siehe „Ausgabe in S-Variable").
Format
SHOW-ALIAS-CATALOG-ENTRY | ||||||||||||||||||||||||
| ||||||||||||||||||||||||
Operandenbeschreibung
ALIAS-FILE-NAME = *ALL / <filename 1..80 with-wild>
Auswahl der auszugebenden AC-Einträge erfolgt über die Angabe der zugehörigen Aliasnamen. Einträge, die mit dem Attribut INVISIBLE definiert wurden, werden nur dem ACS-Administrator angezeigt.
ALIAS-FILE-NAME = *ALL
Für alle Aliasnamen sollen die AC-Einträge ausgegeben werden. Der Umfang der auszugebenden Informationen kann eingeschränkt werden.
ALIAS-FILE-NAME = <filename 1..80 with-wild>
Angabe eines Aliasnamen bzw. einer Musterzeichenfolge für eine Menge von Aliasnamen, deren AC-Einträge ausgegeben werden sollen.
SELECT = *ALL / *BY-ATTRIBUTES(...)
Kriterien für die Auswahl von AC-Einträgen.
SELECT = *ALL
Informiert über alle AC-Einträge.
SELECT = *BY-ATTRIBUTES(...)
Beschränkt die Menge der auszugebenden AC-Einträge auf AC-Einträge, die die nachfolgenden Eigenschaften besitzen.
TYPE = *ALL / *USER-ENTRIES / *SYSTEM-ENTRIES
Informiert über über AC-Einträge in Abhängigkeit von der Art des Eintrags (Benutzer- oder Systemeinträge).
TYPE = *ALL
Die Art des Eintrags dient nicht als Auswahlkriterium. Es werden sowohl Benutzer- als auch Systemeinträge ausgegeben.
TYPE = *USER-ENTRIES
Es werden nur Benutzereinträge ausgegeben.
TYPE = *SYSTEM-ENTRIES
Es werden nur Systemeinträge ausgegeben.
RANGE = *ANY / *FILE / *JV
Informiert über über AC-Einträge in Abhängigkeit des Wirkungsbereichs (für Dateien oder Jobvariablen).
RANGE = *ANY
Die Wirkungsbereich dient nicht als Auswahlkriterium.
RANGE = *FILE
Informiert über alle AC-Einträge, die für Dateien wirken (d.h. alle Einträge, die mit dem Wirkungsbereich RANGE=*FILE bzw. *BOTH eingerichtet sind).
RANGE = *JV
Informiert über alle AC-Einträge, die für Jobvariablen wirken (d.h. alle Einträge, die mit dem Wirkungsbereich RANGE=*JV bzw. *BOTH eingerichtet sind).
INFORMATION = *STD / *SUMMARY
Bestimmt den Umfang der Ausgabe.
INFORMATION = *STD
Für jeden AC-Eintrag wird der Aliasname und der reale Datei- bzw. Jobvariablenname ausgegeben. Das vorangestellte Zeichen „S“ kennzeichnet einen Systemeintrag, das vorangestellte Zeichen „U“ einen Benutzereintrag. Das Zeichen „+“ vor einem Aliasnamen zeigt an, dass der Eintrag das Attribut LOGGING besitzt. Das Zeichen „P“ zeigt an, dass der Eintrag geschützt ist (Attribut PROTECTED).
Das dritte Zeichen zeigt den Wirkungsbereich des AC-Eintrags an (Vereinbarung im Operanden RANGE). Mögliche Werte sind „F“ (*FILE), „J“ (*JV )und „B“ (*BOTH).
Die Ausgabe endet mit einer Summenzeile, die die Gesamtanzahl der im Operand ALIAS-FILE-NAME ausgewählten Aliasnamen und die zahlenmäßige Aufteilung in System- und Benutzereinträge enthält.
INFORMATION = *SUMMARY
Es wird nur die Summenzeile ausgegeben.
Kommando-Returncode
(SC2) | SC1 | Maincode | Bedeutung |
|---|---|---|---|
0 | CMD0001 | ordnungsgemäße Ausführung des Kommandos | |
2 | 0 | ACS0006 | Warnung: AC-Eintrag nicht gefunden |
32 | CMD0221 | interner Fehler | |
64 | ACS0017 | Fehler: Aliaskatalog ist nicht vorhanden | |
64 | ACS0024 | ungültiger Aliaskatalogeintrag | |
128 | ACS0018 | ACS ist nicht verfügbar |
Ausgabe in S-Variable
Der Operand INFORMATION des Kommandos legt fest, welche S-Variablen erzeugt werden. Für INFORMATION sind die Werte *STD und *SUMMARY möglich.
Ausgabe-Information | Name der S-Variablen | T | Inhalt | Bedingung |
|---|---|---|---|---|
Aliasname einer Datei bzw. Jobvariablen | var(*LIST).ACS(*LIST).ALIAS-F-NAME | S | <filename 1..54> | INF=*STD |
realer Datei- bzw. Jobvariablenname | var(*LIST).ACS(*LIST).F-NAME | S | <filename 1..54> | INF=*STD |
Protokollierung eingeschaltet | var(*LIST).ACS(*LIST).LOG | S | *NO | INF=*STD |
Schutz des Aliaskatalogeintrags | var(*LIST).ACS(*LIST).PROT | S | *NO | INF=*STD |
Wirkungsbereich des Aliaskatalogeintrags (für Dateien und/oder Jobvariablen) | var(*LIST).ACS(*LIST).RANGE | S | *FILE | INF=*STD |
Art des Aliaskatalogeintrags | var(*LIST).ACS(*LIST).TYPE | S | *SYS | INF=*STD |
AC-Eintrag sichtbar | var(*LIST).ACS(*LIST).VISIBLE | S | *NO | INF=*STD |
Anzahl der Systemeinträge | var(*LIST).NUM-OF-ENTRY.SYS | I | <integer 0...65535> | INF=*STD/ |
Anzahl aller AC-Einträge | var(*LIST).NUM-OF-ENTRY.TOTAL | I | <integer 1...65535> | INF=*STD/ |
Anzahl der Benutzereinträge | var(*LIST).NUM-OF-ENTRY.USER | I | <integer 0...65535> | INF=*STD/ |
Beispiele
/SHOW-ALIAS-CATALOG-ENTRY (Ausgabe unter dem Privileg ACS-ADMINISTRATION)% ALIAS FILE NAME -> FILE NAME%UB : BOTH -> FILE-OR-JV-NAME%UF : FILE -> FILE-NAME%UJ : JV -> JV-NAME%UJI : JV.INV -> JV-ALIAS.BLIND%SB : LOAD-BIND -> $.BINDER%SB : LOAD-PAMCONV -> $.PAMCONV%UJIP+ SF -> FILE-ALL
% ACS0037 NUMBER OF ALIAS CATALOG ENTRIES: 7 (FOR SYSTEM: 2, FOR USER: 5)
Die Ausgabe eines Eintrages hat folgendes Format:
BEISPIEL: %SB : LOAD-BIND -> $.BINDER (Beispiel einer Zeile)
FORMAT: %abcde alias-name -> Jobvariablen- oder Dateiname
Dabei bedeuten die ersten 5 Zeichen folgendes:
%abcde mögliche Bedeutung der
||||| Inhalte möglichen Inhalte
||||e : Alias Ersetzung wird nicht gelogged
||||e + Alias Ersetzung wird gelogged
|||d ' ' Eintrag nicht geschützt
|||d P Protected, Eintrag geschützt
||c ' ' Eintrag bei SHOW-ALIAS-CATALOG-ENTRY wird angezeigt
||c I Invisible, Eintrag wird nur dem Administrator angezeigt
|b F File Eintrag
|b J JV Eintrag
|b B Both (File oder JV)
a S System Eintrag
a U User Eintrag
Genaue Bedeutung der Begriffe bitte unter dem Kommando ADD-ALIAS-CATALOG-ENTRY nachlesen.
Für weitere Beispiele, siehe Kommandos ADD-ALIAS-CATALOG-ENTRY, LOAD-ALIAS-CATALOG und SET-FILE-NAME-PREFIX.