A fix is available
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 number
PK36154
Reported component name
CICSTS 3.1 Z/OS
Reported component ID
5655M1500
Reported release
400
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2006-12-13
Closed date
2007-02-08
Last modified date
2007-03-01
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.
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.1","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
01 March 2007