HZAZIP program parameters

The HZAZIP utility can accept up to two program parameters. The first parameter specifies the function the program is to perform and the second parameter can provide a data definition override list for programs that dynamically invoke the utility.

When you invoke the HZAZIP utility as a stand-alone batch program, the PARM value on the EXEC statement specifies the functional request. DD statements define the details of the following files:

The SYSPRINT report file
The SYSUT1 input file
The SYSUT2 output file

You can specify program parameters in the function request in mixed case. The following information describes valid program parameters.

none: If you omit the program parameter, usage notes will be printed to SYSPRINT and LIST processing will be initiated. If SYSUT1 is not allocated the program completion code will be set to 1.

LIST: If you specify this parameter, the utility produces a list of the entries in the central file directory.
TEST: This function will list the local file headers as well as the entries in the central file directory, check that the stored and actual values of some properties match, then perform a trial unzip of each file in the zip archive.
ZIP or ZIP=filename.ext: Use this parameter to compress a partitioned data set into an archive where each member is loaded as a separate zipped file within the archive. A sequential input file is processed as a single member stored in the archive under the name specified in the parameter. If no name is specified in the parameter, the name seq.txt is used. The data is treated as text.
ADD or ADD=filename.ext: This parameter performs the same function as ZIP except that the output file must be an existing zip archive. The utility writes the compressed data as additional member(s) and prints a report of the original contents of the output archive before it starts to process any new data. The data is treated as text. There is no dependency on the text or binary nature of the existing zipped files in the archive.
UNZIP or UNZIP=filenamemask: Use this parameter to decompress an archive into a partitioned data set and load each zipped file into a separate member. The parameter restores data sets from archives made by the HZAZIP utility with PARM=ZIP. If the output data set is sequential, only the first file in the archive is unzipped. You can use the file name mask specification to filter the files to be unzipped.
ZIPBIN or ZIPBIN=filename.ext: Use this parameter to compress a partitioned data set into an archive and load each member as a separate zipped file within the archive. A sequential input file is processed as a single member stored in the archive under the name specified in the parameter. If no name is specified in the parameter then the name seq.bin is used. The data is treated as binary data and no translation is performed.
ADDBIN or ADDBIN=filename.ext: This parameter performs the same function as the ZIPBIN parameter except that the output file must be an existing zip archive. The utility writes the compressed data as additional member(s) and prints a report of the original contents of the output archive before it starts to process any new data. The data is treated as binary and no translation is performed. There is no dependency on the text or binary nature of the existing zipped files in the archive.
UNZIPBIN or UNZIPBIN=filenamemask: Use this parameter to decompress an archive into a partitioned data set and load each zipped file into a separate member. The parameter restores data sets from archives made by the HZAZIP utility with PARM=ZIPBIN. If the output data set is sequential, only the first file in the archive is unzipped. Use the file name mask specification to filter the files to be unzipped.

The filenames and filename masks that you specify in program parameters must not exceed 128 bytes in length. File name mask matching is case insensitive. The following characters are generic masking characters for filename masks:

? (question mark) matches any single character.
* (asterisk) matches any zero or more contiguous characters.

If the function request is absent or invalid, the utility writes usage notes to the report file. If the request is absent, the utility attempts to run the LIST function.

Controlling zip compaction

For the program parameter values described above, wherever the parameter begins with the characters ZIP or ADD, the values ZPn or ADn can be substituted respectively, where n is a decimal digit in the 0 to 9 range which specifies the compaction that the zip process is to use.

A value of 0 specifies that the shrink method is to be used, which is the method the HZAZIP program always used in releases prior to Version 8 Release 2.

A value in the 1 to 9 range specifies the corresponding compaction level of the deflate method. As the compaction level number increases, so does both the data compress and the CPU time consumed by the zip process.

The default is the fastest deflate compaction level. That is, PARM=ZIP is equivalent to PARM=ZP1 and PARM=ADD is equivalent to PARM=AD1.