Mit dieser Anweisung listen Sie die Dateien des aktuell geöffneten ZIP-Archivs auf.
Die Anweisung unterstützt die strukturierte Ausgabe in S-Variable.
SHOW-FILE-ATTRIBUTES | ||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||
FILE-NAME = *ALL
Alle im Archiv enthaltenen Dateien werden aufgelistet.
FILE-NAME = <composed-name 1..98 with-under with-wild(132)>
Alle dem Muster entsprechenden Dateien werden aufgelistet.
FILE-NAME = <c-string 1..1024 with-low>
Alle Dateien, die der angegebenen Zeichenfolge entsprechen (Musterzeichen nach den SDF-Regeln für Auswahlangaben sind erlaubt (siehe SDF-Metasyntax, Handbuch „Kommandos“ [2]), werden aus dem ZIP-Archiv aufgelistet. Die Angabe als C-String ist zu verwenden, wenn das Archiv nicht in einem BS2000-System erstellt wurde und die betroffenen Dateinamen nicht BS2000-konform sind (z.B. Groß-/Kleinschreibung).
FILE-NAME = *PATH-NAME(...)
Die angegebene Datei wird angezeigt. Der Operand interpretiert Zeichen wie Schrägstrich, Sternchen, eckige Klammern und andere nicht als Platzhalter, sondern als Teil des Dateinamens. Verwenden Sie diesen Operanden, um einen einzelnen relativen Pfadnamen innerhalb des ZIP-Containers anzuzeigen.
INFORMATION = *SUMMARY
Nur der Name der archivierten Datei sowie ihre Herkunft werden angezeigt. Die Ausgabe endet mit der Meldung SZP0087, die die Anzahl der insgesamt aufgelisteten Dateien anzeigt. Siehe auch „Layout der Ausgabeinformation“.
INFORMATION = *ALL
Es wird die vollständige Information für die archivierte Datei wird angezeigt. Die Ausgabe endet mit der Meldung SZP0087, die die Anzahl der insgesamt aufgelisteten Dateien anzeigt. Siehe auch „Layout der Ausgabeinformation“.
TEXT-OUTPUT = *SYSOUT / *SYSLST(...) /*NONE
Gibt an, wohin die Information auszugeben ist (Ausgabe als Textstring).
TEXT-OUTPUT = *SYSOUT
Die Ausgabe erfolgt in die Systemdatei SYSOUT.
TEXT-OUTPUT = *NONE
Mit Ausnahme von Fehlermeldungen erfolgt keine Informationsausgabe.
TEXT-OUTPUT = *SYSLST(...)
Die Ausgabe erfolgt in die Systemdatei SYSLST.
SYSLST-NUMBER = *STD / <integer 1..99>
Bestimmt, ob die Ausgabe in die Systemdatei SYSLST oder in eine SYSLST-Datei aus der Menge SYSLST01 bis SYSLST99 erfolgen soll.
Voreinstellt ist *STD, d.h. die Ausgabe erfolgt in die Systemdatei SYSLST.
STRUCTURE-OUTPUT = *SYSINF / *NONE / <composed-name 1..255>(...)
Steuert die strukturierte Ausgabe in S-Variable (siehe auch „Strukturierte Ausgabe in S-Variable“).
STRUCTURE-OUTPUT = *SYSINF
Die strukturierte Ausgabe wird in den S-Variablenstrom SYSINF gelenkt. Die Informationen sind zugreifbar, wenn SYSINF mit dem Kommando ASSIGN-STREAM vorher einer S-Variablen zugewiesen wurde (siehe „Ausgabe in S-Variablen“, Handbuch „Kommandos“ [2]).
STRUCTURE-OUTPUT = *NONE
Es erfolgt keine strukturierte Ausgabe.
STRUCTURE-OUTPUT = <composed-name 1..255>(...)
Name der Variablen, in welche die strukturierte Ausgabe erfolgen soll. Die Variable muss als Listenvariable deklariert sein:
/DECLARE-VARIABLE VAR-NAME=<var>(TYPE=*STRUCTURE),MULTIPLE-ELEMENTS=*LIST
WRITE-MODE = *REPLACE / *EXTEND
Gibt an, ob die strukturierte Ausgabe eine bestehende Liste überschreiben oder erweitern soll. Mit *REPLACE ersetzt die Ausgabe bereits existierende Listenelemente.
Layout der Ausgabeinformation
Layout bei INFORMATION=*SUMMARY
CURRENT CONTAINER : @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ + BS2000 : @@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ + BS2000 : @@@ ... @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ + BS2000 : @@@ % SZP0087 'n' file(s) are matching your request
Die erste Zeile zeigt den Namen des aktuell geöffneten ZIP-Archivs und dessen Format an: BS2 (= BS2000-Format) oder WIN (= WinZip-kompatibles Format). Für jede selektierte Datei wird in einer Zeile der Dateiname und das Ausgabefeld BS2000 angezeigt. Verschlüsselte Dateien sind mit einem „+“ vor dem Ausgabefeld BS2000 gekennzeichnet. Dateinamen, die länger als 64 Zeichen sind, werden über mehrere Zeilen angezeigt.
Layout bei INFORMATION=*ALL
CURRENT CONTAINER : @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@
--------------------------- FILE INFORMATION --------------------------------
FILENAME : @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
...
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
BS2000 : @@@
MODIFIED : YYYY-MM-DD HH:MM:SS
SIZE : NNNNNNNNNNNNN
PACKED : NNNNNNNNNNNNN
RATIO : NN.N %
ENCRYPTED : @@@
------------------------------- COMMENTS ------------------------------------
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
...
% SZP0087 'n' file(s) are matching your request
Beschreibung der Ausgabefelder
| CURRENT CONTAINER | ist der Name des aktuell geöffneten ZIP-Archivs und sein Format: BS2 : BS2000-Format WIN : WinZip-kompatibles Format. |
| FILENAME | ist der Name der in das ZIP-Archiv aufgenommenen Datei. Bei BS2000-Dateien hat dieser Name das folgende Format: Im Fall von Nicht-BS2000-Dateien hat dieser Name das Format, mit dem er gespeichert wurde. Zum Beispiel /dir1/dir2/Myfile.txt. Groß- und Kleinschreibung sind berücksichtigt. In einer Zeile werden maximal 64 Zeichen des Dateinamens angezeigt. Bei Dateinamen, die länger als 64 Zeichen sind, werden die restlichen Zeichen in Folgezeilen angezeigt. Maximal sind 1024 Zeichen möglich. |
BS2000 | Gibt die Herkunft der Datei an. |
| YES | bedeutet, dass die Datei im BS2000 mit dem Programm BS2ZIP in das Archiv aufgenommen wurde. |
| NO | steht für alle anderen Fälle. |
MODIFIED | steht für das Datum und die Uhrzeit der letzten Änderung an der Datei. |
| SIZE | ist die Größe der Originaldatei in Byte. |
| PACKED | ist die Größe der komprimierten Datei in Byte. |
| RATIO | ist die Komprimierungsrate. Die Berechnung erfolgt nach der Formel: (SIZE – PACKED) * 100 / SIZE. Es kann vorkommen, dass die komprimierte Datei größer ist als die Originaldatei, wenn in der Anweisung ADD-FILE keine Komprimierung verlangt wurde. In diesem Fall hat RATIO den Wert 0. |
| ENCRYPTED | Gibt an, ob die Datei beim Aufnehmen in das Archiv verschlüsselt wurde. |
| YES | zeigt eine verschlüsselte Datei an. |
| NO | zeigt eine unverschlüsselte Datei an. |
| CCSNAME | zeigt den Namen der Kodierung an, in der die Datei im Archiv gespeichert ist, ihren Typ und den Kodierungstyp der Originaldatei. Dieses Feld wird nur angezeigt, wenn die Datei mit BS2ZIP V21.0B10 oder neuer hinzugefügt wurde. Wurde die Datei mit älteren Versionen von BS2ZIP oder Archivmanagern von Drittanbietern hinzugefügt, fehlt das erweiterbare Datenfeld mit dem aktuellen Kodierungsnamen. Der Kodierungsname ist bis zu 8 Byte lang und in XHCS definiert und wird im Attribut CODED-CHARACTER-SET einer Datei unter BS2000 verwendet. Beispiele: ISO8859F, EDF041, UTF8. Der Kodierungstyp bezieht sich auf die Kodierungskategorie, die das Verhalten des Programms bestimmt. Es gibt vier Typen: *EBCDIC, *ASCII, *UNICODE und *UNKNOWN. Zuerst wird der Name der Kodierung ausgegeben, gefolgt von den aktuellen und ursprünglichen Kodierungstypen in Klammern. Der ursprüngliche Kodierungsname befindet sich im Attribut CODED-CHAR-SET des Dateiinfo-Kommentars. Beispiel: CCSNAME : ISO8859F (CURRENT: *ASCII ; ORIGIN: *EBCDIC ) |
| DELIMITER | sind die Zeichen, die in der Datei als Zeilenendetrennzeichen verwendet werden. Dieses Feld wird nur angezeigt, wenn die Datei über ein benutzerdefiniertes BS2ZIP-Zusatzfeld verfügt und es sich bei der Datei um eine Textdatei handelt. |
| COMMENTS | steht für die einer Datei zugeordneten Kommentare. Bei Dateien, die BS2ZIP dem Archiv hinzugefügt hat, beginnt der Kommentar mit der Zeichenfolge *BS2: und listet danach die DMS-Eigenschaften der Originaldatei als Operanden eines FILE-Makroaufrufs auf (siehe Handbuch „DMS Makroaufrufe“ [4]). Diese Liste von DMS Datei-Attributen wird in diesem Manual als "Datei-Info" bezeichnet. |
Hinweis
Es gibt vier Typen von CCS-Namen:
| *EBCDIC | *ASCII | *UNICODE | *UNKNOWN |
|---|---|---|---|
EDF03IRV EDF03DRV EDF04DRV EDF041 EDF042 EDF043 EDF044 EDF045 EDF046 EDF047 EDF049 EDF04A EDF04B EDF04C EDF04D EDF04E EDF04F EEHCL2 EEHCLC EEHCLC1 EEHCLAA EEHCLG | ISO88591 ISO88592 ISO88593 ISO88594 ISO88595 ISO88597 ISO88599 ISO8859F WCP1252P | UTF8 UTFE UTF16 | Alle CCSNAMEs, die in |
Das Format des Archivs ist auch in dessen Katalog-Eintrag im Feld USER-INFO (Abschnitt Organization) abgelegt:
USER-INFO = BS2ZIP-B für BS2000-Format
USER-INFO = BS2ZIP-W für WinZip-kompatibles Format
Strukturierte Ausgabe in S-Variable
Mit dem Operanden INFORMATION=*SUMMARY werden nur die S-Variablen für den Dateinamen und die Herkunft der Datei (FILENAME und BS2000) mit Werten versorgt. Mit INFORMATION=*ALL werden alle aufgelisteten S-Variablen mit Werten versorgt.
Ausgabe-Information | Name der S-Variablen | T | Inhalt |
Indikator für Sekundär-Index (bei ISAM-Datei) | var(*LIST).ALTERNATE-INDEX | S | ’’ |
Blockkontrollinformation | var(*LIST).BLKCTRL | S | NO |
Puffergröße | var(*LIST).BLKSIZE | S | ’’ |
Herkunft der Datei | var(*LIST).BS2000 | S | *YES |
Name des Zeichensatzes der Original-Datei | var(*LIST).CODED-CHAR-SET | S | ’’ |
Zeichensatztyp der Original-Datei | var(*LIS).ORIGIN-CCSTYPE | S | '' *ASCII *EBCDIC *UNICODE *UNKNOWN |
Zeilentrenner | var(*LIST).DELIMITER | S | '' |
Dateiverschlüsselung | var(*LIST).ENCRYPTED | S | *YES |
Dateistruktur | var(*LIST).FCBTYPE | S | SAM |
Name der Datei; bei Nicht-BS2000-Dateien ggf. als Pfadname | var(*LIST).FILENAME | S | <filename> |
Indikator für den Dateityp PLAM-Bibliothek | var(*LIST).FILETYPE | S | ’’ |
Performance-Eigenschaft bzgl. Ein-/Ausgabeoperationen | var(*LIST).IOPERF | S | ’’ |
Operation(en), auf die sich die Performance-Eigenschaft bezieht | var(*LIST).IOUSAGE | S | ’’ |
Länge des ISAM-Schlüssels | var(*LIST).KEYLEN | I | <integer> |
Position des ISAM-Schlüssels im Datensatz | var(*LIST).KEYPOS | I | <integer> |
Gültigkeit des Last-Byte-Pointers | var(*LIST).LAST-BYTE-VALID | B | FALSE |
Länge der logischen Markierung im ISAM-Index | var(*LIST).LOGLEN | I | <integer> |
Datum des letzten ändernden Dateizugriffs | var(*LIST).MODIFIED-DATE | S | <yyyy-mm-dd> |
Zeitpunkt (Uhrzeit) des letzten ändernden Dateizugriffs | var(*LIST).MODIFIED-TIME | S | <hh:mm:ss> |
Dateigröße im komprimierten Zustand (in Byte) | var(*LIST).PACKED | I | <integer> |
Komprimierungsrate | var(*LIST).RATIO | S | '' |
Satzformat der Datei | var(*LIST).RECFORM | S | F |
Satzlänge der Datei | var(*LIST).RECSIZE | I | <integer> |
Sekundärzuweisung für Dateierweiterung | var(*LIST).SEC-ALLOC | I | <integer> |
Original-Dateigröße (in Byte) | var(*LIST).SIZE | I | <integer> |
Zeichensatz der im Archiv gespeicherten Datei | var(*LIST).STORED-CCSNAME | S | '' |
Zeichensatztyp der im Archiv gespeicherten Datei | var(*LIST).STORED-CCSTYPE | S | '' *ASCII *EBCDIC *UNICODE *UNKNOWN |
Länge der Wertmarkierung im ISAM-Index | var(*LIST).VALLEN | I | <integer> |
Behandlung der Wertmarkierung innerhalb eines Daten- oder Indexblocks (für K-ISAM-Dateien) | var(*LIST).VALPROP | S | ’’ |
Beispiel
|