IBM Support

Batch EXCI job fails to connect to CICS after changing XCFGROUP

Troubleshooting


Problem

Your batch EXCI job fails to connect to CICS after you change XCFGROUP on the target CICS Transaction Server for z/OS (CICS TS) region. You are running a product called MacKinney Batch to CICS (MBC) from MacKinney Systems that connects to CICS from batch using the external CICS interface (EXCI). MBC has been running flawlessly for years, but when you changed the XCFGROUP for your non-production regions from the default of DFHIR000 to DFHIR*nnn*, the EXCI connection for the product failed with reason code 00078049.

Symptom

The only messages you see are from the MBC product itself:

MBCB021-CONNECT FAILED: APPL(CICSAPPL) RESP(00655360) REASON(00078049-00000000)

Cause

The batch job fails to connect to CICS with reason code 00078049 because the batch EXCI application and the target CICS region belong to different XCFGROUPs but reside on the same LPAR. There is restriction documented in a note under the CICS system initialization table (SIT) parameter XCFGROUP that states:

Note: Regions in the same MVS image too, can communicate with each other using MRO, but this does not require a coupling facility.The only situation in which CICS regions in the same MVS image cannot communicate via MRO is when they are members of different XCF groups.    

EXCI applications and target CICS regions must also use the same XCFGROUP. If they do not, you must code a DFHXCOPT table with a XCFGROUP equal to the XCFGROUP coded within the SIT of the target CICS region. You must also ensure the new DFHXCOPT table is placed within a data set that resides above the SDFHEXCI data set.

Resolving The Problem

Code a DFHXCOPT table for the batch EXCI application with an XCFGROUP equal to the XCFGROUP coded within the SIT of the target CICS region. Also, ensure the new DFHXCOPT table is placed within a dataset that resides above the SDFHEXCI dataset in your JCL.

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB35","label":"Mainframe SW"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"ARM Category":[{"code":"a8m0z000000cwh7AAA","label":"CICS intercommunication"}],"ARM Case Number":"","Platform":[{"code":"PF035","label":"z\/OS"}],"Version":"5.3.0;5.4.0;5.5.0;5.6.0;6.1.0"}]

Product Synonym

CICS/TS CICSTS CICS TS CICS Transaction Server

Document Information

Modified date:
16 November 2023

UID

dwa1196098