A fix is available
APAR status
Closed as program error.
Error description
Following a hardward error on the Coupling Facility (CF) used for Shared Temporary Storage, the CICS Temporary Storage Server address space restarts, which necessitates CICS TS re-opening its connection to the Server once again. You may receive message AXMS0031I in this situation, signaling a failed connection attempt to your server. Additional Keywords: KIXREVSXY
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All * **************************************************************** * PROBLEM DESCRIPTION: Message AXMSC0038 repeatedly issued * * during shared TS connect process. * **************************************************************** * RECOMMENDATION: * **************************************************************** A hardware failure in a coupling facility broke connectivity to the shared temporary storage structures there. The shared TS server restarted. CICS was unaware of this however, and when the next shared TS request was issued, the server returned an abend 0D6 as the connection token used was associated with a broken linkage index value. DFHTSSH's recovery routine caught this abend, and retried the request. However, it failed to reacquire the TS domain lock as part of the retry path. This allowed other tasks running under their own OTE open TCBs to be able to interleave through the same code without being serialized against concurrent access. This meant that two tasks could drive connect processing at the same time, and in doing so one of them could then fail as the other had already reconnected to the server. This caused message AXMSC0038 to be issued. The API returned SYSIDERR to the application. In this case it had a NOHANDLE specified on the command, and looped back to retry the request which had failed. Since the pca_connect_failed flag had been left on due to the interleaving tasks, the result was another attempt to reconnect to the server, another AXMSC0038, and another retry of the command. This process continued and the CICS joblog showed many thousands of such messages. Keywords: L8 opentcb AXM TSSH
Problem conclusion
DFHTSSH has been changed, to preserve the server's connect token value in working storage between releasing the domain lock and issuing the dfhxqifr and dfhxqifi calls to the shared TS server. This prevents other tasks from invalidating the token in this processing window. DFHTSSH has also been changed to ensure that the recovery routine reacquires the domain lock before attempting to retry a request that has failed with an abend 0D6.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PK98456
Reported component name
CICSTS V3 Z/OS
Reported component ID
5655M1500
Reported release
500
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2009-10-12
Closed date
2009-11-17
Last modified date
2009-12-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
PK99014 UK52018
Modules/Macros
DESTSSH DFHTSSH
Fix information
Fixed component name
CICSTS V3 Z/OS
Fixed component ID
5655M1500
Applicable component levels
R500 PSY UK52018
UP09/11/20 P F911
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:
02 December 2009