Troubleshooting
Problem
You are attempting to start the CICS Transaction Gateway for z/OS (CICS TG). You receive the following messages: DFHEX0100 followed by DFHEX0001 then DFHEX0004.
Symptom
DFHEX0100 The installed level of CICS SVC does not support the EXCI call.
DFHEX0001 An abend (code ---/0407) has occurred in module DFHXCPRH.
DFHEX0004 Jobname: Unknown, Stepname: Unknown, Procname: Unknown, Sysid in SMF: Unknown, Applid: Unknown.
Cause
The first CICS region to come up post-IPL was making use of a lower level DFHCSVC compared to the EXCI libraries being used by this CICS TG.
Diagnosing The Problem
The EXCI options table, DFHXCOPT, has a parameter for setting the SVC number. The supplied DFHXCOPT has CICSSVC = 0. Change this to the SVC for the CICS region being connected to, assemble the module, and make sure the output goes into a library that is program controlled.
Resolving The Problem
Code a DFHXCOPT module to specify the correct SVC number of the CICS Transaction Server region you are connecting to with EXCI. Make sure you place this customized DFHXCOPT module before the standard SDFHEXCI in STEPLIB, otherwise your changes will not be picked up.
If you do not want to create your own DFHXCOPT module and you run with multiple DFHCSVC modules within the LPA, you must ensure the first to logon to DFHIRP, following an IPL, is a CICS region running with the highest installed release's DFHCSVC. This could be a difficult task and is why IBM recommends to only run with the highest level DFHCSVC.
Note: This same issue can happen with any EXCI batch job. It is not specific to CICS TG only.
Related Information
Product Synonym
CICS/TS CICS TS CICS Transaction Server CICS TG CTG CICS Transaction Gateway
Was this topic helpful?
Document Information
Modified date:
15 June 2018
UID
swg21246301