How to Use CAUNZIP to Unzip a Scart0.zip File to a USS Directory

Products

• OPS/MVS Event Management & Automation

Issue/Introduction

The client received a SCART0.zip to their USS directory and wants assistance to UNZIP the package to the mainframe.
 

Environment

All Mainframe Products - All releases

Resolution

To transfer a scart0.zip file to a z/OS system, please use the below:

 . Note: As the scart0.zip file could be very large, it may be better to transfer it directly to a z/OS USS Directory. 

In the following FTP sample, modify the z/OS USS Directory names to your own names: 

//*----------------------------------------------------------- 
//* 
//* * CAZIPCPY * ** 
//* ** 
//* FUNCTION: SAMPLE JOB USED TO COPY A ZIP FILE CREATED BY ** 
//* CA SUPPORT ONLINE TO A USS DIRECTORY. ** 
//* ** 
//*-------------------------------------------------------------------------** 
//* COPYRIGHT (C) 2013 CA. ALL RIGHTS RESERVED. ** 
//*-------------------------------------------------------------------------** 
//* 
//ZIPCOPY EXEC PGM=FTP,REGION=0K 
//SYSTCPD DD DISP=SHR,DSN=VTAM.TCPIP.TCPIP.DATA 
//SYSPRINT DD SYSOUT=* 
//INPUT DD * 
ftp://downloads.broadcom.com
[email protected] password
cd /ftp/orders/nnnnnn/nnnnnnnzip/ <-- (1) 
bin 
get scart0.zip /a/userid/mnt190/scart0.zip <--(2) 
quit 
/* 
// 

(1) The location on CA Support Online where the scart0.zip file is found 
(2) The existing z/OS USS directory to where the download will be done 

 Note: The z/OS USS directory needs to be quite large, as there could be many files created after the scart0.zip file is unzipped. 

 . To unzip the scart0.zip file, use the CAUNZIP utility:

 Note: To run the CAUNZIP utility, there needs to be CA Common Services running at least at release 14.1 with PTFs 
       RO54887 and RO58216 applied.

//*-----------------------------------------------------------------------------** 
//* * CAUNZIP * ** 
//* FUNCTION: SAMPLE JOB USED TO EXECUTE THE CAUNZIP UTILITY. ** 
//* THIS UTILITY WILL UNZIP YOUR SCART0.ZIP FILE ** 
//* CREATED BY CA SUPPORT ONLINE AND CREATE A SMPNTS ** 
//* INSTALLABLE PACKAGE. ** 
//*-----------------------------------------------------------------------------** 
//OUTCLASS SET OUTCLASS='*' 
//* 
//CAUNZIP EXEC PGM=IKJEFT01,DYNAMNBR=10,REGION=0M 
//ZIPRPT DD SYSOUT=&OUTCLASS,RECFM=FBA 
//SYSTSPRT DD SYSOUT=&OUTCLASS 
//SYSPRINT DD SYSOUT=&OUTCLASS 
//STDOUT DD SYSOUT=&OUTCLASS 
//STDERR DD SYSOUT=&OUTCLASS 
//SYSTSIN DD * 
CAUNZIP ZIPPATH(/a/userid/mnt190) - 
ZIPFILE(scart0.zip) - 
JAVAPATH(/usr/lpp/java/J8.0) 
/* 
// 

 . Carefully review the CAUNZIP Job output. 

 . The files should now be ready for the SMP/E RECEIVE, but first download and RECEIVE the HOLDDATA data set from CA Support Online:

 . To run the SMP/E RECEIVE you can run the following JCL: 

//RECEIVE EXEC PGM=GIMSMP,PARM='PROCESS=WAIT',DYNAMNBR=120,REGION=0M 
//SMPCSI DD DISP=SHR,DSN=TSDUMP.XXXXXXX.XXXXX.CSI 
//SMPOUT DD SYSOUT=* 
//SMPRPT DD SYSOUT=* 
//SYSPRINT DD SYSOUT=* 
//SMPJHOME DD PATHDISP=KEEP, 
// PATH='/usr/lpp/java/J8.0/' 
//SMPNTS DD PATHDISP=KEEP, 
// PATH='/a/userid/mnt190/scart0/' 
//SMPCNTL DD * 
SET BOUNDARY(GLOBAL) . 
RECEIVE FROMNTS(SMPNTS) 
SYSMODS 
HOLDDATA 
DELETEPKG 
. 
/* 

 . After running the SMP/E RECEIVE, the APPLY of all PTFs can be done in one JCL, running with APPLY ... CHECK:

//SMPCNTL DD * 
SET BOUNDARY(CAIT0) . 
APPLY PTFS 
BYPASS(HOLDSYSTEM) 
GROUPEXTEND 
CHECK. 

 . When the APPLY CHECK runs without problems, remove the CHECK clause, and run the SMP/E APPLY.