PK49217: VARIOUS RESTART/RECOVERY PROBLEMS WHEN USING WSAT BETWEEN CICS 3.1 AND WAS 6.1

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Various errors detected when attempting to use WSAT from CICS
  3.1 to WAS 6.1 with security active.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All                                          *
  ****************************************************************
  * PROBLEM DESCRIPTION: Messages DFHPI0732 and DFHPI0733 not    *
  *                      issued for WS-AT rollbacks.             *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  When a remote WS-AT coordinator requests that CICS backout the
  current transaction message, DFHPI0732 should be issued to
  indicate this is happening.  When CICS times out waiting for a
  PREPARE message from a remote WS-AT coordinator message,
  DFHPI0733 should be issued.
  
  These messages are not being issued.
  
  Also failures in the DFHPIIM functions handling WS-AT context
  tokens are not being traced correctly.
  

Problem conclusion

• CICS pipeline domain code has been changed to issue messages
  DFHPI0732 and DFHPI0733.  Also the tracing of failures in
  DFHPIIM has been corrected.
  
  The CICS Transaction Server for z/OS Version 3 release 2 CICS
  Messages and Codes manual (GC34-6827-00) will be updated as
  follows:
  
  Add the following two new messages at the appropriate place in
  chapter 1 'DFH messages', section 'DFHPIxxxx messages'.
  
  DFHPI0732  DATE TIME APPLID  A REQUEST TO
            ROLLBACK UNIT OF WORK -  X'UOWID'  HAS BEEN
            RECEIVED FROM A REMOTE WS-AT COORDINATING
            TRANSACTION.
  
  EXPLANATION:  During processing of an atomic transaction
  the remote WS-AT coordinating task has requested that CICS
  rolls back the specified unit of work.
  
  SYSTEM ACTION:  The specified unit of work will be rolled
  back.
  
  USER RESPONSE:  None.
  
  DESTINATION:  CPIO
  
  MODULE:  DFHPIRS
  
  XMEOUT PARAMETERS: date, time, applid,
  X'uowid'
  
  ****************************************************************
  
  DFHPI0733  DATE TIME APPLID  A TRANSACTION
            TIMED OUT WHILE WAITING FOR A PREPARE MESSAGE FROM
            A REMOTE WS-AT COORDINATOR. THE UNIT OF WORK -
             X'UOWID'  WILL BE ROLLED BACK.
  
  EXPLANATION:  A CICS transaction waiting for a Prepare
  message from a remote WS-AT coordinator has timed out.
  
  SYSTEM ACTION:  The specified unit of work will be rolled
  back.
  
  USER RESPONSE:  None.
  
  DESTINATION:  CPIO
  
  MODULE:  DFHPIPM
  
  XMEOUT PARAMETERS: date, time, applid,
  X'uowid'
  
  
  The CICS Transaction Server for z/OS Version 3 Release 2
  Supplementary Data Areas manual (GC34-6864-00) will be updated
  as follows;
  
  In section 'PIDCC Pipeline Manager Control Blocks' replace the
  following constants which appear at the end of the section;
  
  2       HEX           1808              TID_PIIM_DESTROY_CTX
  2       HEX           1809              TID_PIIM_RECREATE_CTX
  
  with these;
  
  2       HEX           1808              TID_PIIM_CTX_FUNC_FAILED
  2       HEX           1809              TID_PIIM_DESTROY_CTX
  2       HEX           1810              TID_PIIM_RECREATE_CTX
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

  PK42688

• APAR is sysrouted TO one or more of the following:

  UK31539

Modules/Macros

•    DESPIAT  DESPIDC  DESPIIM  DESPIIS  DESPIPM
  DESPIRE  DESPIRM  DESPIRS  DESPITRI DESRUTK  DFHMEPIC DFHMEPIE
  DFHMEPIK DFHPIAT  DFHPIDCC DFHPIDCD DFHPIIMC DFHPIISC DFHPIPM
  DFHPIRE  DFHPIRM  DFHPIRS  DFHPITRI DFHRUTKC DFH49217
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R500 PSY UK31539

     UP07/11/28 P F711

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.