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 : @@@
------------------------------- 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. |
| COMMENTS | is the comments associated to the file. In the case of BS2000 files, 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]). |
Note
The container format is also available in the catalog entry 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 | var(*LIST).CODED-CHAR-SET | S | ’’ |
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> |
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
|