PK17426: NEW OPTION FOR TRANSACTIONAL EXCI TASKS

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• New Function
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All.                                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: 422 SERVER_ABENDED returned on the      *
  *                      the EXCI DPL call after an abend        *
  *                      of the mirror task. A rollback may not  *
  *                      initiated.                              *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  If a DPL request is made via Transactional  EXCI (TxEXCI) and
  the called CICS program abends, the abend is passed back to the
  batch client as a return code 422 SERVER_ABENDED on the EXCI DPL
  call, however,  the UOW is not rolled back in CICS unless
  the DPL client instructs CICS (via RRS) to do so.
  

Problem conclusion

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

• DFHXCOPT has been amended to include a new option, ABENDBKOUT.
  This specifies whether a task that abends within the CICS
  server is to trigger an automatic rollback of the global
  unit of work. A global unit of work exists when an EXCI
  client program is controlling resource recovery through
  MVS RRS (that is, SYNCONRETURN is not specified on the
  DPL request). In this case you may well want the global
  unit of work to be marked for rollback if the CICS
  server program abends.
  As part of the design to implement this, an ALIAS was created
  for DFHXCOPT called DFHXCOPE. The EXCI driving module DFHXCPRH
  which does the MVS LOAD for the options table was changed to
  FIRST load DFHXCOPE, and if that was not found, then try loading
  DFHXCOPT. DFHXCOPE is generated when the PTF is applied.
  The JCLIN shipped with this fix has JCLIN which changed the
  SMP environment to know about the ALIAS. However, if you have
  assembled and linked your customized DFHXCOPT module outside
  of SMP, be sure to review JCLIN documented in External
  Interface Guide SC34-6244-09 regarding the alias.
  The CICS Transaction Server for z/OS V3R1, SC34644901, CICS
  External Interfaces Guide, Section 3.6, should be amended.
  In section 'USING the EXCI options table, DFHXCOPT' add:
  ABENDBKOUT={NO|YES}
  Specifies whether a transactional EXCI task that abends within
  the CICS server is to trigger an automatic rollback of the
  global unit of work.  If, for example, an EXCI client program is
  controlling resource recovery through MVS RRS (that is,
  SYNCONRETURN is not specified on the DPL request) you may well
  want the global unit of work to be marked for
  rollback if the CICS server program abends.
  ABENDBKOUT=NO is the default.
  Note: ABENDBKOUT has no effect when SYNCONRETURN is specified on
  the DPL request.
  
  NO
  The global unit of work is not marked for rollback.
  
  YES
  When processing the abend of the server program, the CICS mirror
  program marks the global unit of work for backout.
  The CICS Transaction Server for z/OS V3R1, LY33610700, CICS
  Data Areas, should be amended.
  In TCA   Task Control area, add:
  after (16A) TCABRPS
              1... ....    Reserved
              .1.. ....    TCATXBK      Texci backout
  In TCTTE Terminal Control entry, add:
  after (1B9) TCTEIRF2
              .... .1..    TCTETXBK     Texci backout if abend
  In IRRDS Interregion Session Recovery entry, add:
  after (1)   IRFLG2
              .... 1...    IRFLTXBK     Texci backout if abend
  The CICS Transaction Server for z/OS V3R1, LY33610800, CICS
  Supplementary Data Areas, should be amended.
  In XCCBC External CICS Interface Control blocks add:
  (A6)   Character     1   XCG_VERSION_FLAG      Version Flag
  (A7)   Bitstring     8   XCG_OPT_FLAGS         Option Flags
         1... ....          XCG_TEXCI_BACKOUT    Backout after
                                                   abend
  

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  PK17427 UK12092

Modules/Macros

•    DESMRXM  DFHCRNP  DFHIRRDS DFHMIRS  DFHMRXM
  DFHSP    DFHTCSSP DFHTCTTE DFHTCTZE DFHXCCBC DFHXCCBD DFHXCO
  DFHXCOPT DFHXCPRH HCI6400J
  

Fix information

• Fixed component name

  CICSTS 3.1 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK12092

     UP06/03/03 P F603

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.