PI15189: EXEC CICS CSD ALTER COMMAND RESP 119 CSDERR NO DFHCA48XX MESSAGE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Your CICS region has programs issuing EXEC CICS CSD commands.
  In this instance an EXEC CICS CSD ALTER command received a
  EIBRESP 0119 CSDERR and RESP2 5 which should have resulted in a
  DFHCA4859 message to the CSMT transient data destination but
  now message is issued.
  
  DFHAMP runs and the abend handler DFHAMPAB detects a CSDERR
  condition and calls DFHAMER to retrieve a DFHCA48nn message
  which is later freed by DFHAMP without issuing the message.
  
  Additional Symptom(s) Search Keyword(s): KIXREVWJB EIBRESP2
  DFHAM4858
  DFHAM4829
  DFHAM4864
  DFHAM4822
  DFHAM4824
  DFHAM4865
  DFHAM4880
  DFHAM4820
  DFHAM4859
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: Message DFHCA4859 is not sent to the    *
  *                      CSMT transient data destination when    *
  *                      an EXEC CICS CSD command receives       *
  *                      an EIBRESP=0119 (CSDERR) and RESP2=5    *
  *                      response.                               *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  When an EXEC CICS CSD command fails with an EIBRESP of 0119
  (CSDERR), DFHAMER should issue a DFHMEMEM SEND_MESSAGE
  to send a DFHCA48nn message to the CSMT transient data
  destination, giving more information about the nature of the
  problem.
  Task local storage, DFHDMTLS, contains a flag to indicate
  an EXEC CICS CSD request is being processed. For the first
  EXEC CICS CSD request made by a task the CSDERR condition can
  arise before the flag is set. This causes DFHAMER to treat
  the error as if it was a CEDA request. DFHAMER issues
  a DFHMEMEM RETRIEVE_MESSAGE to retrieve a DFHAM48nn message.
  Processing for CEDA would subsequently output this message
  but the EXEC CICS CSD processing causes it to be discarded.
  
  Additional keywords:
  DFHCA4858 DFHCA4829 DFHCA4824 DFHCA4880 DFHCA4820 DFHCA4859
  MSGDFHCA4858 MSGDFHCA4829 MSGDFHCA4824 MSGDFHCA4880
  MSGDFHCA4820 MSGDFHCA4859
  

Problem conclusion

• CICS has been changed so the task local storage flag, indicating
  this is an EXEC CICS CSD request, is always set before executing
  code which can return the CSDERR condition. DFHAMER can hence
  detect that an EXEC CICS CSD request is being processed and
  send the appropriate DFHCA48nn message to CSMT.
  
  The CICS Transaction Server for z/OS Version 5 Release 1
  Data Areas, GC34-2849-00, will be updated to add the following
  in Table 533, TCA - Task Control Area, after the existing
  TCATSUSP field.
  Offset Hex    Type   Len        Name      Description
  (1AF)
                       .... .1..  TCACSDAI  processing EXEC CSD
                                            request
                       .... ..11  *         Reserved
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

  PI14098

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

  UI18261

Modules/Macros

• DFHAMPFI DFHEIQCS DFHTCA
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R800 PSY UI18261

     UP14/05/30 P F405

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.