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>
Die 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. Die vorangestellten Zeichen und deren Bedeutung sind im Beispiel unten erklärt.
Die Ausgabe endet mit einer Summenzeile, die die Gesamtanzahl der im Operanden 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.