PK62863: DYNAMIC ROUTING OF A PROGRAM LINK FROM CICS WEB SERVICES DOES NOT REACT LIKE A NORMAL DPL LINK

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When attempting to dynamically route a link that has been
  invoked by a CICS Web Services application, the normal rules for
  DPL do not seem to apply with regards to the link being
  eligible for dynamic routing:
  .
    - Be defined to the local system as DYNAMIC(YES) or
    - Not be defined to the local system
  .
  DFHPGLE is returning to DFHPITL with an EXCEPTION response and
  a PROGRAM_NOT_DEFINED reason.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All.                                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: A web service provider invocation       *
  *                      is not dynamically routed unless        *
  *                      the web service provider program        *
  *                      is defined with DYNAMIC(YES) in         *
  *                      the routing region.                     *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  In a dynamic routing environment web service provider
  invocations are only being dynamically routed if the
  web service provider program is defined in the routing
  region with DYNAMIC(YES). The dynamic routing program
  e.g. DFHDYP or EYU9XLOP is not being called to establish
  a suitable target region if the program is not defined.
  
  DFHPITL receives an EXCEPTION response with reason
  PROGRAM_NOT_DEFINED from DFHPGLE, when the program
  is not defined in the routing region. However, DFHPITL
  does not specifically handle this situation and produces
  its own, general, TARGET_LINK_FAILED exception.
  
  Additional keyword: webservice
  

Problem conclusion

• DFHPITL has been changed to check for the
  PROGRAM_NOT_DEFINED response from DFHPGLE and to call
  DFHPIRI to drive a real EXEC CICS LINK when it receives
  this response.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

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

  UK39766 UK39767

Modules/Macros

•    DESPIIW  DESPITL  DFHPIIW  DFHPIIWA DFHPIIWM
  DFHPIIWT DFHPITL  DFHPITLA DFHPITLM DFHPITLT
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK39766

     UP08/09/14 P F809

• R500 PSY UK39767

     UP08/09/13 P F809

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.