PK67564: DFHAC2047 WHEN ROUTING A WEB SERVICES REQUEST FROM A TOR TO AN AOR, AFTER THE USERID WAS REVOKED.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• SIT USRDELAY parameter fails to detect an invalid userid before
  a Web services transaction route request directs the transaction
  to an AOR.  As a result, the AOR will issue message DFHAC2047,
  causing the TOR to issue message DFHIR3783.
  There are 2 issues that need addressing here.
  1) RZ domain needs to be called during task termination.
     Currently RZXM is not called for RELEASE_XM_CLIENT
     processing.
  2) RZXM needs to issue a DELETE_USER call at task termination
     time.
  Additional Symptom(s) Search Keyword(s):
  KIXREVJXD
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All Users                                    *
  ****************************************************************
  * PROBLEM DESCRIPTION: A user ID associated with a CICS Web    *
  *                      Service that has been changed is never  *
  *                      removed from the User domain.           *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The user ID specified in the DFHWS-USERID container is added to
  the system when the pipeline attaches a new transaction to
  implement the requested context switch, but the user ID is not
  deleted when the transaction is detached.
  .
  The Instore Transport Requeststream handler does not contain
  any function to handle transaction detach. Therefore the use
  count for the user ID is not decremented, and the user ID
  never becomes eligible to be purged by USRDELAY processing.
  Additional Keywords:
  AC2047 msgDFHAC2047 msgDFHIR3783 IR3783 RZ0324
  

Problem conclusion

• The Instore Transport Requeststream handler (DFHRZIS) has been
  altered to handle transaction detach. This detects whether a new
  user ID has been added during transaction attach, and deletes it
  if present.
  
  The CICS Transaction Server for z/OS Version 3 Release 1, CICS
  Trace Points, SC34-6443-04, page 461 and The CICS Transaction
  Server for z/OS Version 3 Release 2, CICS Trace Points,
  SC34-6828-01, page 646 needs to be altered under section
  "Request streams domain trace points". The following trace point
  needs to be added to the table.
  
  Point ID   Module   Lvl    Type           Data
  --------   ------   ---    ----           ----
  RZ  0324   DFHRZXM  Event  xm_release     1  XMclientblock
  

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:

  UK40435 UK40436

Modules/Macros

•    DESRZCON DESRZDM  DESRZDUF DESRZIS  DESRZLN
  DESRZRM  DESRZRS  DESRZSK  DESRZST  DESRZTC  DESRZTR  DESRZTRI
  DESRZTX  DESRZXM  DESXMAT  DESXMCON DESXMTRI DFHMRXM  DFHRZCON
  DFHRZDM  DFHRZDMC DFHRZDMD DFHRZDUF DFHRZISC DFHRZIX  DFHRZLN
  DFHRZNR2 DFHRZRG2 DFHRZRM  DFHRZRMC DFHRZRMD DFHRZRSC DFHRZRSD
  DFHRZRS1 DFHRZSKC DFHRZSO  DFHRZSOA DFHRZSOJ DFHRZSOM DFHRZSOT
  DFHRZSOV DFHRZSO1 DFHRZTA  DFHRZTAA DFHRZTAM DFHRZTAT DFHRZTCC
  DFHRZTCX DFHRZTRC DFHRZTRD DFHRZTRI DFHRZTR1 DFHRZTXC DFHRZXM
  DFHXMAB  DFHXMAT  DFHXMCON DFHXMER  DFHXMERA DFHXMERI DFHXMERM
  DFHXMERT DFHXMIXN DFHXMRSC DFHXMRSD DFHXMTA  DFHXMTRI DFHXMXE
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK40435

     UP08/10/08 P F810

• R500 PSY UK40436

     UP08/10/08 P F810

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.