Run CAUNZIP

You can invoke CAUNZIP online as a TSO command or from a batch job running under the IKJEFT01 Terminal Monitor Program. For a sample job, see Run the CAUNZIP utility to extract the zip file in NTS format. If you invoke the utility as a TSO command, manually allocate the SYSOUT files that are listed in the sample job DD statements.

CAUNZIP supports the following required parameters:

ZIPPATH(pathname)

Path where ZIPFILE is located. The path name is case-sensitive.

Example: ZIPPATH(/u/maint/CA/CAESD)

ZIPFILE(filename)

Name of the file in ZIPPATH downloaded from CA Support Online. The file is name case-sensitive.

Example: ZIPFILE(scart0.zip)

Note: Spaces are not allowed in the USS file name.

JAVAPATH(pathname)

The path name for Java. Any 31 bit or 64-bit version of Java 5 or higher is supported. The path name is case-sensitive.

Example: JAVAPATH(/usr/lpp/java/J6.0)

TEMPHLQ(yourhlq)

The High-Level Qualifier that is used when creating temporary data sets. This utility creates at least 300 cylinders of temporary data sets that are cleaned up when the utility finishes.

The output that CAUNZIP produces varies depending on the contents of the order that is contained in the zip file.

CAUNZIP DD	Purpose
ZIPRPT	This SYSOUT data set contains the CAUNZIP Summary Report. This report provides a summary of the content of the product order zip file with JCL for executing the SMP/E receive processing. In addition, the report includes details on the content of each of the data sets and z/OS UNIX files produced.
SYSTSPRT	This SYSOUT data set contains messages produced during CAUNZIP utility processing, including any error messages.

An order directory is created in the ZIPPATH specified. The directory name is derived from the ZIPFILE name. For example, if the zip file name is scart0.zip, any product files are created in a new directory that is named scart0. If a directory with that name exists, CAUNZIP generates a new directory name that is not currently in use, for example: scart1.

z/OS UNIX Order Directory	Purpose
SMPNTS	This directory contains GIMZIP archive files and associated metadata files for all extracted PTFs, APARs, and HOLDDATA in the zip file. This directory can be used as the SMPNTS input to SMP/E RECEIVE FROMNTS processing.
SMPTXT	This directory contains a single TEXTFILE, containing PTFs/APARs in the zip file, concatenated and separated with headers. Review them prior to installing PTFs in the zip file.

Extracted Product-Related Files

If the zip file contains any product files (for example: .pax, .pdf, .ESD, or .ICO files), CAUNZIP creates a z/OS UNIX directory, SMPPAX, in the order directory and copies the product files to that directory. The directory name is derived from the ZIPFILE name.