IBM Support

CTG6876E EXCI Reason = 623 during CICS TG startup after upgrade to CICS 5.4

Question & Answer


Question

Why am I receiving message CTG6876E and unable to start the CICS Transaction Gateways (CICS TG) V9.2 after putting the CICS Transaction Server for z/OS (CICS TS) V5.4 SDFHEXCI library into the LINKLIST? I am upgrading from CICS TS V5.2 to CICS TS V5.4.

The errors seen from the CICS TG side are:

CTG6876E EXCI error: Function Call = 1, Response = 16, EXCI Reason = 623, Subreason field-1 = 0xfd8000, subreason field-2 = 0x00, ctg_rc=-9

CTG6686E Unable to initialize JNI library: [EXCI is not available]

CTG6513E CICS Transaction Gateway failed to initialize

CTG0827W Child completed with a non-zero return code 1

There were no changes made to the EXCI definitions in the CICS region, and other than the change to the LINKLIST, there were no other changes to the CICS region. I have two CICS TGs running. One has it's PRM 'STEPLIB' entry pointing to the CICS TS V5.2 SDFHEXCI, and the other points to the CICS TS V5.4 SDFHEXCI. As long as the CICS V5.2 SDFHEXCI library is in the LINKLIST, both CICS TGs start. But, if the CICS TS V5.4 SDFHEXCI is in the LINKLIST, neither of the CICS TGs will start.

Answer

The 623 reason code in message CTG6876E relates to ESTAE_INVOKED and Subreason field-1 contains the MVS abend code of FD8. This relates to SVC 216 (x'D8'). At CICS TS V5.4, the default CICSSVC within DFHXCOPT has changed from 0 to 216. So the problem is due not having SVC 216 defined as a Type 3 SVC.

You will have to change DFHXCOPT to either CICSSVC = 0 (the default value prior to CICS TS 5.4) or to the SVC number your CICS regions are using. After making this change, you will need to reassemble the DFHXCOPT table with DFHAUPLE. Don't forget to add the alias of DFHXCOPE statement. Your JCL should look similar to:

 //SYSLIN   DD *   
 INCLUDE ADFHMOD(DFHXCOPT)
 MODE AMODE(31),RMODE(ANY)
 ENTRY DFHXCOPT 
 ALIAS DFHXCOPE
 NAME DFHXCOPT(R) RC=0
 /*

Also, make sure you put the new DFHXCOPT table into a library that is above SDFHEXCI to ensure that CICS uses the new table.

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMJ2","label":"CICS Transaction Gateway"},"Platform":[{"code":"PF035","label":"z\/OS"}],"Component":"","Version":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Platform":[{"code":"PF035","label":"z\/OS"}],"Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Product Synonym

CICSTG CICS TG;CICS/TS CICSTS CICS TS CICS Transaction Server

Document Information

Modified date:
28 February 2019

UID

dwa1493764

Page Feedback