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.

To ensure that DFHINST6 runs successfully, perform the following steps:
  • 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.

When you have run the DFHINST6 job, the following SMP/E message is produced from the job:
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.

If the DFHINST6 job fails and you are using an existing global zone (that is, you specified the GZONE parameter of the DFHISTAR job with the disposition parameter OLD), perform the following steps:
  1. REJECT the CICS Transaction Server base-level function SYSMOD.
  2. 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.


dfhi6.html | Timestamp icon Last updated: Sunday, 4 June 2017