Why is there only one member in my BASE SAMPJCL named @README after unloading multiple pax files for CA Common Services for z/OS r14.1 and executing GIMUNZIP?


Article ID: 18770


Updated On:


CA CIS CA Common Services for z/OS CA 90s Services CA Database Management Solutions for DB2 for z/OS CA Common Product Services Component CA Common Services CA Datacom/AD CA ecoMeter Server Component FOC CA Easytrieve Report Generator for Common Services CA Infocai Maintenance CA IPC Unicenter CA-JCLCheck Common Component CA Mainframe VM Product Manager CA Chorus Software Manager CA On Demand Portal CA Service Desk Manager - Unified Self Service CA PAM Client for Linux for zSeries CA Mainframe Connector for Linux on System z CA Graphical Management Interface CA Web Administrator for Top Secret CA CA- Xpertware CA Compress Data Compression for MVS CA Compress Data Compression for Fujitsu


During the install process of CA Common Services for z/OS r14.1 and after executing BPXBATCH to unload multiple pax files and the subsequent GIMUNZIP, some customers have found that the BASE SAMPJCL contains only a single member named @README.

Why does my Common Services r14.1 SAMPJCL contain only a @README member which refers me to other members that don't exist?   



Installing CA Common Services r14.1 into a z/OS environment using components from multiple pax files.   


   The probable cause is that during the download process, each pax file was unpackaged into the same product directory before executing GIMUNZIP.  which overlaid the previous file.  Assuming the BASE was the first file that was unpackaged, any additional pax file downloaded into the same directory as the BASE will overlay it.  Thus, when GIMUNZIP was executed, it processed the last file.   All members necessary to install the product are copied into the BASE SAMPJCL when GIMUNZIP is executed for the BASE . Each additional pax file contains its own GIMUNZIP and creates a corresponding SAMPJCL (ie. LEGACY,OPTIONAL) consisting of one @README member. Each @README refers you to the BASE SAMPJCL for the necessary JCL to install the components contained within the specific pax file. 
    There are two methods that can be used to avoid this from occurring
  • Download each pax file into it's own directory 
    • This is the recommended method as noted  in the Common Services r14.1 Installation Guide and Documentation wiki
  • If the same directory is to be used, ensure that each pax file is downloaded and the file specific GIMUNZIP is executed before processing the next file 



Additional Information

Refer to the section under the heading Create a Product Directory from the Pax File found in the CA Common Services r14.1 Documentation wiki