Running the DFHINST6 job
This job performs the SMP/E APPLY and ACCEPT functions that install CICS® Transaction Server into the target and distribution libraries respectively.
- Ensure that the DB2® SDSNLOAD library is available for this job. Without SDSNLOAD, DFHINST6 fails; see
Specifying the data set name of the SDSNLOAD library.
If you run DFHINST6 with an empty SDSNLOAD library, the APPLY step completes with return code 4, and the return code from the binder is 8. The REXX for CICS modules, CICSQL and CICDB2, which interface with DB2, are stored in SCICLOAD without the required DB2 routines and are not usable.
- Run DFHINST6 on the same MVS™ image on which the z/OS UNIX file system is installed, unless you
are set up for MVS sharing.
If you have modified the other installation jobs (for example, to use existing libraries and therefore existing target and distribution zones), consider splitting the DFHINST6 job to do APPLY CHECK, APPLY, ACCEPT CHECK, and ACCEPT functions as four separate jobs.
The DFHINST6 job is the longest running of all the installation jobs. It produces a large amount of printed output. The region size for the DFHINST6 job is currently set to 'REGION=0M', because this job requires more memory than the other installation jobs. Adjust your JES parameters (for example, with a JES2 /*JOBPARM LINES=99 statement) to avoid a system abend 722.
If successful, this job gives a return code of 4. See the "GIM23903W - LINK SUCCESSFUL . . " message, listed in the report that is output by the apply job. DFHINST6 job issues messages GIM23903W and GIM23913W depending on the execution environment of the installer. Both messages are acceptable.
The binder produces IEW2454W messages during the APPLY stage for unresolved external references while some CICS Transaction Server load modules are being link-edited during installation, giving return code 4. You might also receive numerous IEW2646W and IEW2651W messages, which indicate conflicts with user-specified RMODE and AMODE modes respectively. You can ignore these IEWxxxx messages, which are produced for component object modules of executable CICS Transaction Server load modules.
Messages IEW2689W, IEW2470E, IEW2648E, and IEW2303E might be displayed. You can ignore them.
GIM20502I GIMSMP PROCESSING IS COMPLETE - THE HIGHEST RETURN CODE WAS 04 -
You can ignore this SMP/E message.
If any other SMP/E messages appear, see the SMP/E: Messages & Codes manual for guidance information about their meaning and take the appropriate action.
If the DFHINST6 job finishes abnormally, examine the job log to determine the cause, correct the problem, and then repeat all the jobs, beginning with DFHINST1. This correction avoids SMP/E space problems, and consequent X37 abends, during reruns of these SMP/E jobs.
- REJECT the CICS Transaction Server base-level function SYSMOD.
- Rerun the DFHINST1 job. When you rerun the installation jobs, some steps that were successfully completed in the previous run produce return codes with a value of 8.