IBM Support

PK98456: AXMSC0038 IS ISSUED REPEATEDLY FOLLOWING CF OUTAGE AND TEMP STORAGE SERVER RESTART

A fix is available

Subscribe

You can track all active APARs for this component.

 

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