PK16989: DFHAC2016 MAY INCORRECTLY REPORT THAT DFHMIRS IS NOT AVAILABLE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You're are attempting to issue a SOAP request using HTTP
  protocols and CICS is functioning as a server.  You receive the
  following message
  .
  DFHAC2016 Transaction XXXX cannot run because program DFHMIRS is
  not available.
  .
  where 'XXXX' is the transaction you are attempting to run.  You
  check the status of DFHMIRS in the region, and it is available.
  If you have CICS dump on the AC2016 message, the dump will show
  a SOAP request in which a context-switch occurs. This causes the
  initial web-alias task to attach a new task to run the actual
  SOAP server program. This is achieved using BTS services to
  execute the server program asynchronously using EXEC CICS RUN
  ACTIVITY (rather than EXEC CICS LINK ACTIVITY which runs
  synchronously under the web-alias task). The transaction ID
  chosen to run the asynchronous BTS ACTIVITY is XXXX. This
  happens to be defined with an INITIAL_PROGRAM of DFHMIRS.
  However, in this context it will not execute DFHMIRS. BTS
  ensures that it executes program YYYYYYYY. The DFHBAXM
  BIND_ACTIVITY_REQUEST which runs during transaction
  initialization of XXXX ensures this.  If program YYYYYYYY is
  disabled for some reason, DFHXMAT receives an EXCEPTION with
  REASON(PROGRAM_NOT_ENABLED). DFHAPXME is called for function
  REPORT_MESSAGE. This calls DFHACP which tries to report message
  DFHAC2016. It inquires on the INITIAL_PROGRAM for transaction
  XXXX. This is DFHMIRS so this is what gets plugged into the
  message domain call as the failing program.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All.                                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: Message DFHAC2016 may contain the wrong *
  *                      program name as an insert.              *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  In the reported problem a SOAP request performed a context
  switch.  This caused the initial web-alias task to attach a new
  task to run the actual SOAP server program.  However, the SOAP
  server program was disabled which caused message DFHAC2016 to
  be issued but the program name reported in message DFHAC2016
  was the initial program associated with the transaction and
  not the disabled SOAP server program.
  
  KEYWORDS: MSGDFHAC2016 AC2016
  

Problem conclusion

• DFHXMTA and DFHACP have been modified.  DFHXMTA will now save
  the disabled program name in the system TCA where it may be
  retrieved by DFHACP.
  
  The following documentation change will be made:
  
  The CICS Transaction Server for z/OS CICS Data Areas manual
  for R3.1 (LY33-6107-00) will have the following update made to
  the 'system area' of the TCA dsect thus:
  
                       SYSTEM AREA
  -----------------------------------------------------------
    (0)   CHARACTER       0    DFHSYTCA
  | (0)   CHARACTER       8    TCACPROG   Current program name
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

  PK13404

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

  UK10690

Modules/Macros

•    DESXMAT  DFHACP   DFHTCA   DFHTCAPS DFHXMTA
  

Fix information

• Fixed component name

  CICSTS 3.1 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK10690

     UP06/01/18 P F601

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.