PI57213: DFHRZ0205 ISSUED WHEN DSRTPGM(NONE) IS CODED IN THE SIT AND TRANSACTION IS CODED AS DYNAMIC(YES)

Obtain the fix for this APAR.

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 is sysrouted FROM one or more of the following:

  PI55591

• 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.