Did you know where you can find the CAUNZIP utility and what does it do?

Document ID : KB000047206
Last Modified Date : 14/02/2018
Show Technical Document Details

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.