A fix is available
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 number
PM04710
Reported component name
CICSTS V3 Z/OS
Reported component ID
5655M1500
Reported release
500
Status
CLOSED PER
PE
NoPE
HIPER
YesHIPER
Special Attention
NoSpecatt
Submitted date
2010-01-11
Closed date
2010-03-10
Last modified date
2010-04-03
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
PM05791 UK55007
Modules/Macros
DFHMEMQE DFHMQSSQ DFH04710
GC34682702 |
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.
[{"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":"3.2","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":"3.2","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
03 April 2010