Downloading pax.Z install and maintenance files for IDMS.

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

Description

This document covers the process for downloading the pax.Z files for IDMS install and maintenance. It provides examples of all the JCL required which includes FTP, BPXBATCH and GIMUNZIP.

Solution

  • Go to the download center on support.ca.com
  • Select product,
  • Select IDMS/DB-MVS.
  • Select the release and genlevel.
        For example: 16.0 0804M or 0804. A genlevel ending with an M is a maintenance tape and
        without is the product base tape. All the maintenance
        tapes are cumulative so they contain all the previous levels.
  • Click Go.

Refer to the file under CA IDMS/DB PRODUCT PACKAGE or IDMS SYSTEM MAINT TAPE MAG MED
such as G00804DOA00.pax.Z or G00804DOAM0.pax.Z for the product base or maintenance respectively. Also note the size of the pax.Z file under the Size column.

These pax.Z files will be referred to as RRxxxxDOA00.pax.Z or RRxxxxDOAM0.pax.Z in the JCL examples.
RR represents the release which is G0 for 16.0 and H0 for 17.0. Under DOWNLOAD click FTP_Path and the path on the server that has the file will be displayed. For example, Host:ftp://scftpd.ca.com. FTP Location : /orders/111111/999999/comp/RRxxxxDOA00.pax.Z, 111111 should be your site ID and 999999 your order number.

You can then run an FTP batch job or FTP by some other means to transfer the pax.Z from the directory on scftpd.ca.com to your directory on z/OS Unix System Services (USS). This directory on USS should be 3.5 times the size of the pax.Z file.

  1. FTP SAMPLE JCL:
  2. //*                                                                            
    //ESDGET   EXEC PGM=FTP,PARM='(EXIT TIMEOUT 720'                               
    //*                                                                            
    //SYSTCPD  DD DSN=VTAM.TCPIP.TCPIP.DATA,DISP=SHR                               
    //SYSPRINT DD SYSOUT=*                                                         
    //INPUT    DD *                                                                
    scftpd.ca.com                                                                  
    anonymous youremailaddress                                                    
    Binary                                                                         
    cd /orders/siteID/ordernumber/comp                                                 
    get RRxxxxDOA00.pax.Z +                                                        
        /your/USS/IDMS/directory/RRxxxxDOA00.pax.Z (rep                  
    dir                                                                            
    QUIT                                                                           
    /*                                                                             
    //*                                                                            
    //*********************************************************************        
    //*    Send an error message to the user if the FTP step fails to              
    //*    complete normally...                                                    
    //*********************************************************************        
    //*                                                                            
    //ESDERROR IF (ABEND          |                                                
    //             ESDGET.RC GT 0)                                                 
    //         THEN                                                                
    //*                                                                            
    //SENDERR  EXEC PGM=IKJEFT01,                                                  
    //             PARM='SE ''ESDGET - FTP LOAD OF THE ESD FILE HAS FAILED X       
    //             TO DOWNLOAD --- ** ERROR **'' USER(&SYSUID) LOGON'              
    //STDOUT   DD  SYSOUT=*                                                        
    //STDERR   DD  SYSOUT=*                                                        
    //SYSTSPRT DD  SYSOUT=*                                                        
    //SYSTSIN  DD  DUMMY                                                           
    //*                                                                            
    //ESDERROR ELSE                  /* INFORM USER OF SUCCESSFUL CREATION         
    //*                                                                            
    //*********************************************************************        
    //*  Send a message to the user informing them that the download was         
    //*  completed successfully.                                                    
    //*********************************************************************        
    //*                                                                            
    //SENDGOOD EXEC PGM=IKJEFT01,                                                  
    //             PARM='SE ''ESDGET - FTP LOAD OF ESD FILE HAS BEEN SUCCESX       
    //             SFUL '' USER(&SYSUID) LOGON'                                    
    //STDOUT   DD  SYSOUT=*                                                        
    //STDERR   DD  SYSOUT=*                                                        
    //SYSTSPRT DD  SYSOUT=*                                                        
    //SYSTSIN  DD  DUMMY                                                           
    //*                                                                            
    //*                                                                            
    //ESDERROR ENDIF  
  3. BPXBATCH SAMPLE JCL:
  4. //*********************************************************************        
    //*  UNPAX USS DIRECTORY FOR THE SMPE SYSMOD or Non SMPE product files         
    //*********************************************************************        
    //*                                                                            
    //UNPAX    EXEC PGM=BPXBATCH,                                                  
    //             PARM='sh cd /your/USS/IDMS/directory/;           pax    X       
    //             -rvf RRxxxxDOA00.pax.Z   '                                      
    //STDOUT   DD  SYSOUT=*                                                        
    //STDERR   DD  SYSOUT=*                                                        
    //*                                                                            
    //*********************************************************************        
    //*    Send an error message to the user if the UNPAX step fails to            
    //*    complete normally...                                                    
    //*********************************************************************        
    //*                                                                            
    //UNPAXERR IF (ABEND          |                                                
    //             UNPAX.RC GT 0)                                                  
    //         THEN                                                                
    //*                                                                            
    //*                                                                            
    //SENDERR  EXEC PGM=IKJEFT01,                                                  
    //             PARM='SE ''UNPAX - UNPAXING of the ESD Package has FAILEX       
    //             D  -------- ** ERROR **'' USER(&SYSUID) LOGON'                  
    //STDOUT   DD  SYSOUT=*                                                        
    //STDERR   DD  SYSOUT=*                                                        
    //SYSTSPRT DD  SYSOUT=*                                                        
    //SYSTSIN  DD  DUMMY                                                           
    //*                                                                            
    //UNPAXERR ELSE                  /* INFORM USER OF SUCCESSFUL CREATION         
    //*                                                                            
    //*********************************************************************        
    //*  Send a message to the user informing them that the UNPAX has            
    //*  completed successfully.                                                    
    //*********************************************************************        
    //*                                                                           
    //SENDGOOD EXEC PGM=IKJEFT01,                                                  
    //             PARM='SE ''UNPAX - SUCCESSFUL UNPAX of the ESD package. X       
    //             '' USER(&SYSUID) LOGON'                                         
    //STDOUT   DD  SYSOUT=*                                                      
    //STDERR   DD  SYSOUT=*                                                        
    //SYSTSPRT DD  SYSOUT=*                                                        
    //SYSTSIN  DD  DUMMY                                                           
    //*                                                                            
    //UNPAXERR ENDIF

    After running this BPXBATCH job it will create a subdirectory with a naming convention of GJrrnB for product base tapes where rr is the release such as H0 for 17.0 and n the Service level number. An example of this is GJH00B which is IDMS 17.0 SP00 for base. For maintenance subdirectory it is rrGJnM where rr is the release and n the service level number. Example, G0GJ7M for 16.0 SP7.The subdirectory is created in the same directory that has the pax.Z file.

    There are several ways to look at the contents of your directory. The most common is to use the ISHELL facility on TSO which has ISPF=like panels. The following two displays use ISHELL.

    EUID=2169   /your/USS/IDMS/directory/                                
      Type  Filename                                                               
    _ Dir   .                                                                      
    _ Dir   ..                                                                     
    _ Dir   GJH00B                                                                 
    _ File  H00809DOA00.pax.Z  

    Select the subdirectory and you will see the related install file or maintenance files. This example is for the 17.0 base SP0 base tape.

    These files are unzipped and migrated to the mainframe by GIMUNZIP. This JCL for this program is provided in the UNZIPJCL member in the subdirectory.

    ISHELL has several ways to edit and submit the UNZIPJCL member. We have found using the COPY function to copy the member to your JCLLIB is the easiest method. Once it has been copied to your JCLLIB dataset you can edit as you normally would any JCL and submit the job which will create the mainframe datasets you will use during the install.

     Type  Filename                                                              
    _ File  AREADME                                                                
    _ File  GIMPAF.XML                                                             
    _ File  GIMPAF.XSL                                                             
    _ Dir   SMPPTFIN                                                               
    _ Dir   SMPRELF                                                                
    _ File  S0001.CAIDMS.R170.BASE0809.SAMPJCL.pax.Z                               
    _ File  S0002.CAIDMS.R170.BASE0809.TOOLS.SAMPJCL.pax.Z                         
    _ File  S0003.CAIDMS.R170.BASE0809.ENDEVOR.SAMPJCL.pax.Z                       
    _ File  S0004.CAIDMS.R170.BASE0809.CAISAG.LOADLIB.pax.Z                        
    _ File  S0005.CAIDMS.R170.BASE0809.CAISAG.SKELETON.pax.Z                       
    _ File  S0006.CAIDMS.R170.BASE0809.TOOLS.CAISAG.LOADLIB.pax.Z                  
    _ File  S0007.CAIDMS.R170.BASE0809.TOOLS.CAISAG.SKELETON.pax.Z                 
    _ File  S0008.CAIDMS.R170.BASE0809.ENDEVOR.CAISAG.LOADLIB.pax.Z                
    _ File  S0009.CAIDMS.R170.BASE0809.ENDEVOR.CAISAG.SKELETON.pax.Z               
    _ File  S0010.CAIDMS.R170.BASE0809.GJH00B.FILE12.pax.Z                         
    _ File  S0011.CAIDMS.R170.BASE0809.GJH00B.FILE15.pax.Z                         
    _ File  S0012.CAIDMS.R170.BASE0809.GJH00B.FILE16.pax.Z                    
    _ File  S0013.CAIDMS.R170.BASE0809.GJH00B.FILE17.pax.Z                    
    _ File  S0014.CAIDMS.R170.BASE0809.GJH00B.FILE18.pax.Z                    
    _ File  S0015.CAIDMS.R170.BASE0809.GJH00B.FILE19.pax.Z                    
    _ File  S0016.CAIDMS.R170.BASE0809.GJH00B.FILE20.pax.Z                    
    _ File  S0017.CAIDMS.R170.BASE0809.GJH00B.FILE21.pax.Z                    
    _ File  S0018.CAIDMS.R170.BASE0809.R1021.MIGRATE.pax.Z                    
    _ File  S0019.CAIDMS.R170.BASE0809.SASO.SPG.TEXT.pax.Z                    
    _ File  S0020.CAIDMS.R170.BASE0809.GJH00B.FILE28.pax.Z                    
    _ File  S0021.CAIDMS.R170.BASE0809.CULPRIT.TEST.FILE.pax.Z                
    _ File  S0022.CAIDMS.R170.BASE0809.USMFLCON.LOADLIB.pax.Z                 
    _ File  S0023.CAIDMS.R170.BASE0809.USMFLCON.SRCLIB.pax.Z                  
    _ File  UNZIPJCL   
  5. GIMUNZIP SAMPLE JCL:
      //CAUNZIP  JOB (ACCOUNTID),'UNZIP GJH00B',MSGCLASS=?,CLASS=?,             
      // NOTIFY=&SYSUID                                                         
      //*                                                                       
      //**********************************************************              
      //*                                                                       
      //*    THIS ESD PACKAGE IS FOR IDMS RELEASE R170                          
      //*          PRODUCT-LEVEL IDENTITY IS GJH00B                             
      //*                                                                       
      //*    BEFORE SUBMITTING THIS JOB FOR EXECUTION:                          
      //*                                                                       
      //*    - EDIT THE JOB CARD TO INCLUDE A VALID ACCOUNTING                  
      //*      INFORMATION, JOB CLASS AND MSGCLASS.                             
      //*                                                                       
      //*    - CHANGE "yourHLQ" to your high level qualifier                    
      //*      Do not use a HLQ that may affect your SMPE installation files    
      //*                                                                       
      //*    - Set SMPDIR DD PATH= to the new sub-directory that contains       
      //*      un-paxed ESD package.                                            
      //*                                                                       
      //*    - Set SMPJHOME DD PATH= to the JAVA Path for your site                  
      //*                                                                            
      //*    volume="*" will use default work packs set by your site. (SMS)          
      //*      if you require your files to be loaded to a specific pack             
      //*      do a global edit change to 'volume="*' to 'volume="packname'          
      //*      Please remember that you will have to delete these files              
      //*      manually if you do not use the system default which normally          
      //*      deletes these downloaded temporary files after a few days             
      //*      automatically.                                                        
      //*                                                                            
      //* RC 12 will occur if you uppercase any of these GIMUNZIP commands           
      //*    i.e. the use of VOLUME="PACKNAME" instead of volume="PACKNAME"          
      //*      archid, newname, volume, replace must be lowercase.                   
      //*                                                                            
      //**********************************************************                   
      //*                                                                            
      //STEP1 EXEC PGM=GIMUNZIP,REGION=0M                                            
      //SMPDIR   DD  PATH='/your/USS/IDMS/directory/GJH00B',                   
      //             PATHDISP=KEEP                                                   
      //*                                                                            
      //*EXAMPLE DD  PATH='/usr/lpp/java/J1.4/' <-- JAVA z/OS                        
      //*                                                                            
      //SMPJHOME DD  PATH='/sys/javatm2/v1r4m2/usr/lpp/java/J1.4/' <-- JAVA          
      //*                                                                              
      //SMPOUT   DD  SYSOUT=*                                                          
      //SYSPRINT DD  SYSOUT=*                                                        
      //SYSUT2   DD  UNIT=SYSALLDA,SPACE=(CYL,(200,20))                              
      //SYSUT3   DD  UNIT=SYSALLDA,SPACE=(CYL,(50,10))                               
      //SYSUT4   DD  UNIT=SYSALLDA,SPACE=(CYL,(25,5))                                
      //SYSIN    DD  *                                                               
       <GIMUNZIP>                                                                    
      <ARCHDEF archid="CAIDMS.SAMPJCL"
newname="yourHLQ.SAMPJCL"
volume="*"
replace="YES"
      > </ARCHDEF>
      <ARCHDEF archid="CAIDMS.TOOLS.SAMPJCL"
newname="yourHLQ.TOOLS.SAMPJCL"
volume="*"
replace="YES"
      > </ARCHDEF>
      <ARCHDEF archid="CAIDMS.ENDEVOR.SAMPJCL"
newname="yourHLQ.ENDEVOR.SAMPJCL"
volume="*"
replace="YES"
      > </ARCHDEF>
      <ARCHDEF archid="CAIDMS.CAISAG.LOADLIB"
newname="yourHLQ.CAISAG.LOADLIB"
volume="*"
replace="YES"
      > </ARCHDEF>
      <ARCHDEF archid="CAIDMS.CAISAG.SKELETON"
newname="yourHLQ.CAISAG.SKELETON"
volume="*"
replace="YES"
      > </ARCHDEF>
      <ARCHDEF archid="CAIDMS.TOOLS.CAISAG.LOADLIB"
newname="yourHLQ.TOOLS.CAISAG.LOADLIB"
volume="*"
replace="YES"
      > </ARCHDEF>
      <ARCHDEF archid="CAIDMS.TOOLS.CAISAG.SKELETON"
newname="yourHLQ.TOOLS.CAISAG.SKELETON"
volume="*"
replace="YES"
      > </ARCHDEF>
      <ARCHDEF archid="CAIDMS.ENDEVOR.CAISAG.LOADLIB"
newname="yourHLQ.ENDEVOR.CAISAG.LOADLIB"
volume="*"
replace="YES"
      > </ARCHDEF>
      <ARCHDEF archid="CAIDMS.ENDEVOR.CAISAG.SKELETON"
newname="yourHLQ.ENDEVOR.CAISAG.SKELETON"
volume="*"
replace="YES"
      > </ARCHDEF>
      <ARCHDEF archid="CAIDMS.GJH00B.FILE12"
newname="yourHLQ.GJH00B.FILE12"
volume="*"
replace="YES"
      > </ARCHDEF>
      <ARCHDEF archid="CAIDMS.GJH00B.FILE15"
newname="yourHLQ.GJH00B.FILE15"
volume="*"
replace="YES"
      > </ARCHDEF>
      <ARCHDEF archid="CAIDMS.GJH00B.FILE16"
newname="yourHLQ.GJH00B.FILE16"
volume="*"
replace="YES"
      > </ARCHDEF>
      <ARCHDEF archid="CAIDMS.GJH00B.FILE17"
newname="yourHLQ.GJH00B.FILE17"
volume="*"
replace="YES"
      > </ARCHDEF>
      <ARCHDEF archid="CAIDMS.GJH00B.FILE18"
newname="yourHLQ.GJH00B.FILE18"
volume="*"
replace="YES"
      > </ARCHDEF>
      <ARCHDEF archid="CAIDMS.GJH00B.FILE19"
newname="yourHLQ.GJH00B.FILE19"
volume="*"
replace="YES"
      > </ARCHDEF>
      <ARCHDEF archid="CAIDMS.GJH00B.FILE20"
newname="yourHLQ.GJH00B.FILE20"
volume="*"
replace="YES"
      > </ARCHDEF>
      <ARCHDEF archid="CAIDMS.R1021.MIGRATE"
newname="yourHLQ.R1021.MIGRATE"
volume="*"
replace="YES"
      > </ARCHDEF>
      <ARCHDEF archid="CAIDMS.SASO.SPG.TEXT"
newname="yourHLQ.SASO.SPG.TEXT"
volume="*"
replace="YES"
      > </ARCHDEF>
      <ARCHDEF archid="CAIDMS.GJH00B.FILE28"
newname="yourHLQ.GJH00B.FILE28"
volume="*"
replace="YES"
      > </ARCHDEF>
      <ARCHDEF archid="CAIDMS.CULPRIT.TEST.FILE"
newname="yourHLQ.CULPRIT.TEST.FILE"
volume="*"
replace="YES"
      > </ARCHDEF>
      <ARCHDEF archid="CAIDMS.USMFLCON.LOADLIB"
newname="yourHLQ.USMFLCON.LOADLIB"
volume="*"
replace="YES"
      > </ARCHDEF>
      <ARCHDEF archid="CAIDMS.USMFLCON.SRCLIB"
newname="yourHLQ.USMFLCON.SRCLIB"
volume="*"
replace="YES"
      > </ARCHDEF>
      <ARCHDEF archid="CAIDMS.GJ.SMPMCS"
newname="yourHLQ.GJ.SMPMCS"
volume="*"
replace="YES"
      > </ARCHDEF>
      <ARCHDEF archid="CAIDMS.WI.SMPMCS"
newname="yourHLQ.WI.SMPMCS"
volume="*"
replace="YES"
      > </ARCHDEF>
      <ARCHDEF archid="CAIDMS.CAI.CKBH000.F1"
newname="yourHLQ.CAI.CKBH000.F1"
volume="*"
replace="YES"
      > </ARCHDEF>
      <ARCHDEF archid="CAIDMS.AB.SMPMCS"
newname="yourHLQ.AB.SMPMCS"
volume="*"
replace="YES"
      > </ARCHDEF>
      </GIMUNZIP>