IBM Support

PH09381: LOG UNLOCK REQUESTS to LOGREPLICATE logstream

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • An application repeatedly issued read-update, unlock, for every
    record in the file until it found the record it wanted to
    update.
    Because CICS does not log UNLOCK FILE requests to the
    file's LOGREPLICATE logstream, it exposes a problem for
    IIDR/VSAM where it will continue to track read-for-update
    requests in memory until storage is exhausted. This leads to a
    subscription error and replication stoppage for all replication
    mappings of the subscription.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users                               *
    ****************************************************************
    * PROBLEM DESCRIPTION: CICS does not log UNLOCK FILE requests  *
    *                      to the file's LOGREPLICATE logstream,   *
    ****************************************************************
    Because CICS TS does not log UNLOCK FILE requests to the file's
    LOGREPLICATE logstream it exposes a problem for IIDR/VSAM where
    it will continue to track read-for-update requests in memory
    until storage is exhausted. This causes a subscription error and
    replication stoppage for all replication mappings of the
    subscription.
    
    A second problem where double logging of a read-update record
    occurs when RLS browse for update is used is also fixed.
    

Problem conclusion

  • CICS will now journal a UNLOCK RECORD for an UNLOCK request
    against a VSAM file when replication logging is active.
    IIDR for VSAM product may be updated to exploit the new UNLOCK
    record.
    

Temporary fix

Comments

  • ×**** PE19/05/24 FIX IN ERROR. SEE APAR PH12501  FOR DESCRIPTION
    ×**** PE19/06/11 FIX IN ERROR. SEE APAR PH13200  FOR DESCRIPTION
    

APAR Information

  • APAR number

    PH09381

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    900

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2019-03-06

  • Closed date

    2019-04-05

  • Last modified date

    2019-07-16

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

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

    UI62345 UI62346 UI62348 UI62349 010PC2Ÿ 010PC2Ÿ 010PC2Ÿ

Modules/Macros

  • DFH$FCBF DFH$FCBV DFH$FCLD DFHAPTR5 DFHFCBD  DFHFCFS  DFHFCIR
    DFHFCLGD DFHFCLJ  DFHFCLJ1 DFHFCLJT DFHFCQU  DFHFCRC  DFHFCRS
    DFHFCVS  DFHJUP   DFHL2LB  DFHL2SR2 DFHLGICV
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R000 PSY UI62346

       UP19/04/06 P F904

  • R100 PSY UI62348

       UP19/04/06 P F904

  • R200 PSY UI62345

       UP19/04/24 P F904

  • R900 PSY UI62349

       UP19/04/09 P F904

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":"5.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":"5.2","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
16 July 2019