This statement displays the list of the files included in the currently opened ZIP file.
This statement supports structured output in S variables.
SHOW-FILE-ATTRIBUTES | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
FILE-NAME = *ALL
All the files included in the container are listed.
FILE-NAME = <composed-name 1..98 with-under with-wild(132)>
All the files matching the pattern are listed.
FILE-NAME = <c-string 1..1024 with-low>
All files which match the specified string (wildcards according to the SDF rules for wildcard selection (see SDF syntax in the “Commands” manual [2]) are permitted) are extracted from the ZIP container. Wildcards may be specified in the input string.
All the matching files are listed. Specification as a C string must be used if the container was created in a non-BS2000 system and the file names concerned do not comply with BS2000 syntax (e.g. upper/lower case).
FILE-NAME = *PATH-NAME(...)
The specified file will be shown. The operand will not interpret characters like forward slash, asterisk, square brackets and others as wildcards, but as part of the filename. Use this operand to show a single relative path name inside of the ZIP container.
INFORMATION = *SUMMARY
Only the name of the archived file plus its origin is displayed. The display ends with the message SZP0087, which shows the total number of files listed. See also “Layout of the output information”.
INFORMATION = *ALL
Complete information about the archived files is displayed. The display ends with the message SZP0087, which shows the total number of files listed. See also “Layout of the output information”.
TEXT-OUTPUT = *SYSOUT / *SYSLST(...) /*NONE
Specifies where the information is to be output (output as text string).
TEXT-OUTPUT = *SYSOUT
The information is output to the system file SYSOUT.
TEXT-OUTPUT = *NONE
No information is output except error messages.
TEXT-OUTPUT = *SYSLST(...)
The information is output to the system file SYSLST.
SYSLST-NUMBER = *STD / <integer 1..99>
Specifies whether the information is to be output to the system file SYSLST or to a SYSLST file from the set SYSLST01 through SYSLST99.
The default is *STD, i.e. output is directed to the system file SYSLST.
STRUCTURE-OUTPUT = *SYSINF / *NONE / <composed-name 1..255>(...)
Controls structured output in S variables (see also “Structured output in S variables”).
STRUCTURE-OUTPUT = *SYSINF
The structured output is directed to the S variable stream SYSINF. The information is accessible if SYSINF was previously assigned to an S variable using the ASSIGN-STREAM command (see “Command output in S variables” in the “Commands” manual [2]).
STRUCTURE-OUTPUT = *NONE
No structured output is to be generated.
STRUCTURE-OUTPUT = <composed-name 1..255>(...)
Name of the variable into which the structured output is to be made. This variable must bedeclared as a list variable:
/DECLARE-VARIABLE VAR-NAME=<var>(TYPE=*STRUCTURE),MULTIPLE-ELEMENTS=*LIST
WRITE-MODE = *REPLACE / *EXTEND
Specifies whether the list variable is to be overwritten or extended.
*REPLACE means that the list is overwritten.
Layout of the output information
Layout with INFORMATION=*SUMMARY
CURRENT CONTAINER : @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ + BS2000 : @@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ + BS2000 : @@@ ... @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ + BS2000 : @@@ % SZP0087 'n' file(s) are matching your request
The first line displays the name of the currently opened ZIP container and its format: BS2 (= BS2000 format) or WIN (= WinZip compatible format). The file name and the BS2000 output field are displayed in one line for each selected file. Encrypted files are marked with a “+” in front of the BS2000 output field. File names which are longer than 64 characters are displayed in more than one line.
Layout with INFORMATION=*ALL:
CURRENT CONTAINER : @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@
--------------------------- FILE INFORMATION --------------------------------
FILENAME : @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
...
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
BS2000 : @@@
MODIFIED : YYYY-MM-DD HH:MM:SS
SIZE : NNNNNNNNNNNNN
PACKED : NNNNNNNNNNNNN
RATIO : NN.N %
ENCRYPTED : @@@
CCSNAME : @@@@@@@@
DELIMITER : @@@@@@@@
------------------------------- COMMENTS ------------------------------------
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
...
% SZP0087 'n' file(s) are matching your request
Fields description
CURRENT CONTAINER | is the name of the currently opened ZIP container and its format: |
FILENAME | is the name of the file included in the ZIP container. In case of BS2000 file, this name has the following format: In case of non-BS2000 files, this name has the format with which it has been saved. For example, /dir1/dir2/Myfile.txt. It is case sensitive. Up to 64 characters of the file name are displayed in one line. When file names are longer than 64 characters, the remaining characters are displayed in continuation lines. Up to 1024 characters can be displayed. |
BS2000 | Indicates the origin of the file. |
| YES | means that the file has been included in the container by BS2ZIP program in a BS2000 system |
| NO | otherwise |
| MODIFIED | is date and time of the last file modification. |
| SIZE | is the size in bytes of the original file. In case of Gzip archive this field will display "NOT AVAILABLE", because Gzip does not store the original file length. |
| PACKED | is the size in bytes of the file after compression. |
| RATIO | is the compression ratio. It is computed according to the formula: It can occur that the packed size is greater than the original size when no compression is required at ADD-FILE statement. In case of Gzip archive this field will display "NOT AVAILABLE", because Gzip does not store the original file length. |
| ENCRYPTED | Specifies whether the file was encrypted when it was added to the container. |
| YES | displays an encrypted file. |
| NO | displays a not encrypted file. |
| CCSNAME | Displays Unicode encoding CCSNAME or CCSNAME type for non-Unicode encodings in which the file is stored inside of the archive. See table below to check each CCSNAME type. This CCSNAME is stored inside extensible data field of the file. If this file in archive is not a text file and CCSNAME is not defined in XHCS this field will display BINARY. This field is displayed only if the file in archive has BS2ZIP extensible data fields and if its CCSNAME is defined in XHCS or the file is not a text file. |
| DELIMITER | is the characters that are used as end-of-line delimiter in the file. This field is shown only if the file has BS2ZIP custom extra field and the file is a text file. |
| COMMENTS | is the comments associated to the file in archive. In the case of files added to archive by BS2ZIP, the comments begin with a *BS2: string and then list the DMS properties of the original file as operands of a FILE macro (see the “DMS Macros” manual [4]). This list of DMS properties is referred as "file-info" in this manual. |
Note
There are 3 types of CCSNAMEs:
| *EBCDIC | *ASCII | Unicode |
|---|---|---|
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 |
The container format is also available in the file attributes of the container in the field USER-INFO (Organization section):
USER-INFO = BS2ZIP-B for BS2000 format
USER-INFO = BS2ZIP-W for WinZip compatible
Structured output in S variables
The INFORMATION=*SUMMARY operand supplies only the S variables for the file name and the file origin (FILENAME and BS2000) with values. INFORMATION=*ALL causes all the S variables to be supplied with values.
Output information | Name of the S variable | T | Contents |
Alternate index (ISAM file) | var(*LIST).ALTERNATE-INDEX | S | ’’ |
Block control information | var(*LIST).BLKCTRL | S | NO |
Buffer size | var(*LIST).BLKSIZE | S | ’’ |
Origin of the file | var(*LIST).BS2000 | S | *YES |
Name code table of the original file | var(*LIST).CODED-CHAR-SET | S | ’’ |
New line delimiter | var(*LIST).DELIMITER | S | ’’ 0A 0D0A 000D000A 0D15 15 |
File encryption | var(*LIST).ENCRYPTED | *YES | |
File structure (access method used to create the file) | var(*LIST).FCBTYPE | S | SAM |
File name; in the case of non-BS2000 files possibly as a path name | var(*LIST).FILENAME | S | <filename> |
Indicator for the file type PLAM library | var(*LIST).FILETYPE | S | ’’ |
Performance requirements for I/O operations | var(*LIST).IOPERF | S | ’’ |
Operation(s) affected by the I/O performance requirements | var(*LIST).IOUSAGE | S | ’’ |
Length of the ISAM key | var(*LIST).KEYLEN | I | <integer> |
Position of the ISAM key in the record | var(*LIST).KEYPOS | I | <integer> |
Validity of last byte pointer (LBP) | var(*LIST).LAST-BYTE-VALID | B | FALSE TRUE |
Length of the logical flag in the ISAM index | var(*LIST).LOGLEN | I | <integer> |
Date of last file modification | var(*LIST).MODIFIED-DATE | S | <yyyy-mm-dd> |
Time of last file modification | var(*LIST).MODIFIED-TIME | S | <hh:mm:ss> |
Size of compressed file (byte) | var(*LIST).PACKED | I | <integer> |
Compression ratio | var(*LIST).RATIO | S | ’’ nn.n |
File record format | var(*LIST).RECFORM | S | F |
File record length | var(*LIST).RECSIZE | I | <integer> |
Secondary allocation for file extensions | var(*LIST).SEC-ALLOC | I | <integer> |
Original file size (byte) | var(*LIST).SIZE | I | <integer> |
Encoding in which file is stored in archive | var(*LIST).STORED-CCSNAME | S | '' *ASCII *EBCDIC UTF8 UTF16 UTFE BINARY |
Length of the value flag in the ISAM index | var(*LIST).VALLEN | I | <integer> |
Treatment of the value flag within a data or index block (for K-ISAM files) | var(*LIST).VALPROP | S | ’’ |
Example
|