9.229 ZIP_GET_INFO
Allows information about a zip file to be retrieved.
Also See
Arguments
No | Type | Req/ Opt | Description | Min Len | Max Len | Min Dec | Max Dec |
|---|---|---|---|---|---|---|---|
1 | A | Req | Zip file/path name If no path is specified, the file is assumed to be in the temporary directory. If file name does not have an extension, .zip will be appended. | 1 | 256 | ||
2 | L | Opt | Working list containing file names or specifications to include. This argument also applies to files in subdirectories, but not to the subdirectory names. The default is to include all. The list cannot contain more than 32,767 entries. Note: If the list is empty, the default will be used. | 256 | 256 | ||
3 | L | Opt | Working list containing file names or specifications to exclude. This argument also applies to files in subdirectories, but not to the subdirectory names The default is to exclude none. The list cannot contain more than 32,767 entries. Note: If the list is empty, the default will be used. This argument is equivalent to zipinfo –x | 256 | 256 | ||
4 | A | Opt | Positioning filename Note: This argument would typically only be used to continue loading the list after a previous return code of OV | 1 | 256 |
Return Values
No | Type | Req/ Opt | Description | Min Len | Max Len | Min Dec | Max Dec |
|---|---|---|---|---|---|---|---|
1 | A | Req | Return Code OK = Zip file able to be read okay NR = No matching files found ER = An error was encountered OV = List returned completely filled, but more files in zip file than can fit in the list | 2 | 2 | ||
2 | N | Opt | Total size of matching uncompressed files, in bytes Note: This value is only affected by the list of files to include and exclude. If this BIF is called multiple times for overflow processing, this value will not change. | 1 | 10 | 0 | 0 |
3 | N | Opt | Number of matching files Note: This value is only affected by the list of files to include and exclude. If this BIF is called multiple times for overflow processing, this value will not change. | 1 | 10 | 0 | 0 |
4 | L | Opt | Working list to contain file names; will include paths if they exist. List must not contain more than 32,767 entries. | 256 | 256 | ||
5 | A | Opt | The last file name in the returned list | 1 | 256 | ||
6 | L | Opt | Working list to contain information about the files returned in the file name list. Entry 1 in the file name list relates directly to Entry 1 in this list. This list must have the same number of entries as the file name list. Formatted: Start End Description 1 - 10 Uncompressed size (bytes) 11 - 18 Date YYYYMMDD 19 - 24 Time HHMMSS | 18 | 24 |
Technical Notes
When specifying file names or specifications to include or exclude, the forward slash (/) must always be used when specifying a path. For example, x_lansa/x_ppp/mytable.dll
This BIF can be used to test (zip -t) the validity of a .zip file, without returning any information, if only the first return value is specified.