PK36154: DYNAMIC ROUTING OF A PROGRAM LINK FROM CICS WEB SERVICES ONLY RU NS LOCALLY.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You are attempting to dynamically route the link to your
  application program that has been invoked by CICS Web Services.
  However, the application program is never routed and is invoked
  only in the routing region.
  Your application program has been defined in the requesting
  region as DYNAMIC(YES).
  In the manual, CICS Webservices Guide, under section :
  11.4 Dynamic routing of inbound requests in a terminal handler,
  it says :
  
  "For applications deployed with the CICS Web services assistant,
  there is a second opportunity to dynamically route the request,
  at the point where CICS links to the user's program. At this
  point, the request is routed using the dynamic routing model, in
  which the routing program is specified in the DTRPGM system
  initialization parameter. Eligibility for routing is determined,
  in this case, by the characteristics of the program."
  
  Additional Symptom(s) and Keyword(s): 5655M1500 R310 3.1.0
  
  Dynamic routing of the LINK PROGRAM from CICS Web Services
  occurs only when the PROGRAM definition includes REMOTESYSTEM
  with a non-blank value.
  

Local fix

• Define application program definition as DYNAMIC(YES) and
  REMOTESYSTEM with a four byte non-blank value.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All.                                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: A WEBSERVICES provider program, defined *
  *                      as dynamic, is run locally instead of   *
  *                      where directed by the dynamic routing   *
  *                      program.                                *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The provider program for a WEBSERVICE is defined as
  DYNAMIC(YES). The CICS region that hosts the WEBSERVICE has a
  dynamic routing program but when the provider program is linked
  to, it runs in the local region. What should happen is the
  dynamic routing program should be called to direct where the
  provider program link is routed. The same problem exists when
  the web service requester and the web service provider are in
  the same region utilising the optimisation code in DFHPIIW.
  Additional keywords: DFHDYP
  

Problem conclusion

• DFHPITL routine dfhpitl_invoke_program has been changed to
  inquire on the provider program and if defined as dynamic then
  the force_local(no) parameter is set on the pgle LINK_EXEC. This
  will return a response of exception reason dynamic_pgm. The
  routine dfhpitl_check_pgle_response_codes has been changed to
  recognise this reason code and call DFHPIRI to invoke the
  dynamic routing program for this request. The same change has
  been made in DFHPIIW routine dfhpiiw_link_program.
  

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:

  UK21956

Modules/Macros

•    DESPIIW  DESPITL  DFHPIIW  DFHPITL
  

Fix information

• Fixed component name

  CICSTS 3.1 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK21956

     UP07/02/14 P F702

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.