A fix is available
APAR status
Closed as program error.
Error description
When a webservice transaction is coded with DYNAMIC(YES) and DSRTPGM(NONE) is coded in the DFHSIT, the existing RZ domain (request streamS) code will try to call distributed routing program "NONE". When the RZ code realizes "NONE" is not a loadable program, it issues message DFHRZ0205. This APAR is being taken to make the RZ code smarter and not try to call the DSRTPGM when it is set to NONE. Additional Symptom(s) Search Keyword(s): KIXREVEPH MSGDFHRZ0205
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: * * All. * **************************************************************** * PROBLEM DESCRIPTION: * * DFHRZ0205 issued when a Web Service * * transaction is defined DYNAMIC(YES) * * but DSRTPGM=NONE is coded in the * * SIT. * **************************************************************** * RECOMMENDATION: * * . * **************************************************************** In the reported problem, a Web Service transaction was defined as DYNAMIC(YES). This meant the decision about where to execute the transaction is taken by the distributed routing program This program is defined to the CICS system via the DSRTPGM SIT parameter but in this case DSRTPGM=NONE was specified. . RZ domain attempted to load program 'NONE', this failed and DFHRZ0205 was issued.
Problem conclusion
DFHRZRTX has been modified so the distributed routing program is not called if DSRTPGM=NONE. The Knowledge Center will be updated as follows for CICS Transaction Server for z/OS 5.3 at the following locations: CICS Transaction Server 5.3.0 >Developing system programs >Customizing with user-replaceable programs >Writing a distributed routing program >Routing inbound web service requests >When the distributed routing program is invoked The following line will be removed: For notification of a statically-routed request. This occurs when the transaction definition specifies DYNAMIC(NO)." and at: CICS Transaction Server 5.3.0 >Reference >System definition >The system definition parameter descriptions and summary >DSRTPGM The NONE option will have the following addition: For eligible Web Service requests, no routing program is invoked.
Temporary fix
Comments
APAR Information
APAR number
PI57213
Reported component name
CICS TS Z/OS V5
Reported component ID
5655Y0400
Reported release
000
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2016-02-15
Closed date
2016-04-28
Last modified date
2016-06-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI37504
Modules/Macros
DFHRZDM DFHRZDUF DFHRZIX DFHRZLN DFHRZNR2 DFHRZRG2 DFHRZRM DFHRZRS1 DFHRZRT1 DFHRZRT2 DFHRZRT DFHRZSO1 DFHRZSO DFHRZTA DFHRZTCX DFHRZTR1 DFHRZTRI DFHRZXM
Fix information
Fixed component name
CICS TS Z/OS V5
Fixed component ID
5655Y0400
Applicable component levels
R000 PSY UI37504
UP16/05/16 P F605
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":"5.3","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":"5.3","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 June 2016