PM04710: IF CICS REGION ATTEMPTS TO CONNECT TO WRONG MQ REGION, STARTCKTI FAILS, CKTI LEFT IN A HUNG STATE. CICS REGION HAS TO BE RECYCLED

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• The WMQ change team was able to recreate the problem.  A hole
  exists where this problem is created and there is currently no
  way out of it once it arises other than to cycle the CICS
  system.  This APAR will introduce a method of recovering from
  this situation (when CICS region is connected to wrong WMQ
  region).
  .
  The way to avoid this error is to ensure that any User who has
  authority to the START CKTI transaction, CKSQ, also has
  authority to CKTI, the resultant task of CKSQ.
  

Local fix

• The way to avoid this error is to ensure that any User who has
  authority to the START CKTI transaction, CKSQ, also has
  authority to CKTI, the resultant task of CKSQ.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All                                          *
  ****************************************************************
  * PROBLEM DESCRIPTION: Following a failure of CKTI before      *
  *                      the INITQ is open, i.e. due to a RACF   *
  *                      error, all subsequent attempts to start *
  *                      CKTI fail with message:                 *
  *                                                              *
  *                      DFHMQ0382D applid DFHMQSSQ CKTI with    *
  *                      the same initiation queue name is being *
  *                      started. STARTCKTI rejected.            *
  *                                                              *
  *                      Attempts to stop CKTI to correct the    *
  *                      problem have no effect and the User     *
  *                      is forced to recycle CICS.              *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  When DFHMQSSQ is invoked to start an instance of CKTI a
  'starting' mail message is created. If the START command fails
  the mail message for this CKTI is freed, if not it persists and
  when DFHMQTRU processes an INITQ OPEN for CKTI the mail message
  is changed to 'started'. In the problem scenario a RACF
  authorisation failure at CICS attach time prevented the
  execution of CKTI and so the 'starting' mail message remains
  causing any subsequent attempt to start the same CKTI/INITQ
  combination to fail with message DFHMQ0382D.
  A recycle of CICS is required to correct the problem.
  

Problem conclusion

• DFHMQSSQ is changed to clear the 'starting' mail message when
  STOP CKTI is issued thereby making it possible to re-issue the
  START CKTI command.
  
  In addition the following documentation changes will be made:
  
  The following documentation change is made to:
  
  CICS Transaction Server for z/OS Messages and Codes
  Version 3 Release 2  GC34-6827-02
  
  Message: DFHMQ0382D
  
  Sub Heading: User Response
  
  is changed to read:
  
  User Response: Review the console for messages in the range
  DFHMQ0100D through DFHMQ0109D for further information, or use
  CICS operator commands (for example CEMT INQ TASK) to determine
  why the CKTI started earlier is not running. If the review
  indicates the earlier CKTI has terminated then issue STOP CKTI
  specifying the same Initiation Queue Name. This will resolve
  the pending start and allow the re-issue of START CKTI for the
  same Initiation Queue Name.
  

Temporary fix

•             *********
              * HIPER *
              *********
  FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

  PK91531

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

  PM05791 UK55007

Modules/Macros

•    DFHMEMQE DFHMQSSQ DFH04710
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R500 PSY UK55007

     UP10/03/12 P F003

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.