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.
IDMS - All Supported Releases
Refer to the file under CA IDMS/DB Version 19.0 S1912 - Product Package
Also note the size of the pax.Z file .
These pax.Z files will be referred to as RRxxxxDOA00.pax.Z in the JCL examples.
Under DOWNLOAD click FTP_Path and the path on the server that has the file will be displayed. For example, Order Location : /nnnnnnnn/IDMS.V19R0.ZOSMF.pax.Z nnnnnnnn is 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.
//* //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
//********************************************************************* //* 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
//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>