IBM Support

OA54431: SMSVSAM OPEN DEADLOCK WITH LATCH CONTENTION REPORTED

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • During open of RLS data set latch contention may be reported and
    a hang / deadlock will be seen.  A d sms,smsvsam,diag(c) will
    shows latch contention on :
    DESCRIPTION: IGWLYSPH - SHM OBJECT POOL
    
    Problem occurs if a QUIESCE request is pending and a system from
    the plex is terminated during the OPEN processing.
    
     Additional Keywords:
    RLSOPEN RLSHANG IGWLYSPH
    SMSVSAM RLS VSAMRLS DF122
    RLSPSP/K
    

Local fix

  • n/a
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * All VSAM RLS users issuing Quiesce against a non-catalog     *
    * data set                                                     *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * SMSVSAM OPEN of a data set can hang with latch contention    *
    * reported after a Quiesce is issued against that data set     *
    * from a remote system.                                        *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    SMSVSAM obtains an ENQ and a Quiesce lock when opening a data
    set to serialize against the Quiesce data set process.
    When a Quiesce is issued against an open data set from a remote
    system, it will broadcast the request and then wait for
    responses from all the connected servers. If a SMSVSAM server is
    recycled in the middle of the Quiesce data set process, that
    server will release the ENQ without completing the Quiesce data
    set process correctly. A subsequent OPEN of that data set will
    obtain that ENQ, but then wait for the previous Quiesce to
    complete. As a result, the open data set process will hang.
    SMSVSAM must be recycled to release the hang.
    

Problem conclusion

  • The Quiesce data set process has been modified to correct the
    serialization error, avoiding the hang. A subsequent open will
    fail with IEC161I 242-0790, indicating that the data set is
    marked as quiesced. The data set will not be able to be opened
    until an Unquiesce is issued against it.
    

Temporary fix

  • *********
    * HIPER *
    *********
    

Comments

APAR Information

  • APAR number

    OA54431

  • Reported component name

    VSAM REC LEV SH

  • Reported component ID

    5695DF122

  • Reported release

    230

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    YesHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2017-11-17

  • Closed date

    2022-03-08

  • Last modified date

    2022-05-03

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

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

    UJ07922 UJ07923 UJ07924

Modules/Macros

  • IDAVQDRV
    

Fix information

  • Fixed component name

    VSAM REC LEV SH

  • Fixed component ID

    5695DF122

Applicable component levels

  • R230 PSY UJ07922

       UP22/04/14 P F204 ¢

  • R240 PSY UJ07923

       UP22/04/14 P F204 ¢

  • R250 PSY UJ07924

       UP22/04/14 P F204 ¢

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":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M"},"Platform":[{"code":"PF054","label":"z\/OS"}],"Version":"230"}]

Document Information

Modified date:
04 May 2022