Question:
Did you know where you can find the CAUNZIP utility and what does it do?
Answer:
The CA UNZIP utility will be delivered with CA Common Services for z/OS.
You can download a Published Solutions zip or a CA HOLDDATA file from the CA FTP server to your z/OS system.
Then 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 the sample at the end of this page. If you invoke the
utility as a TSO command, manually allocate the SYSOUT files that are listed in the sample job DD
CAUNZIP supports the following required parameters:
Note:Path and file names are case-sensitive.
ZIPPATH(pathname)
Path where ZIPFILE is located.
Example:ZIPPATH(/u/maint/CA/CAESD)
ZIPFILE(filename)
Name of the file in ZIPPATH downloaded from CA Support Online (http://www.ca.com/support).
Example:ZIPFILE(scart0.zip)
JAVAPATH(pathname)
The path name for Java. Any 31- or 64-bit version of Java 5 or higher is supported.
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.
UNZIP
DD
Purpose
ZIP
RPT
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.
The report includes details on the content of each of the data sets and z/OS UNIX files produced.
SYS
TSP
RT
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
Direct
ory
Purpose
SMPN
TS
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.
SMPT
XT
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.
Sample JCL CAUNZIP Utility to Extract the Zip File in NTS format
For a sample job used to execute the CAUNZIP utility, see member CAUNZIP in the CAW0JCL data set.