IBM Support

PH05816: FASTPATH NOTIFY DIAGNOSTICS ( DFS0066I ) DON'T INCLUDE UOW LOCK MODE TRANSITION SUPPORT. CUSTOMER NEEDS THIS FOR DIAGNOSTICS.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Message DFS0066I was added in IMS V12 to help customers diagnose
    Fastpath NOTIFY response issues in datasharing complex.
    Unfortunately, the support added did not include the NOTIFY
    processing involved in UOW Lock Mode transition. In this case,
    partner systems allow 15 seconds for all CI locks on Area to
    be released, and if this time is exceeed, reply 'TIMEOUT' to
    the NOTIFY. The DFS0066I logic is essentially looking for
    missing responses, not 'TIMEOUT' responses and no DFS0066I
    messages are issued in the case where one or more partners
    respond timeout. DBFICLI0 should be changed to issue a new
    version of DFS0066I ( or a new message ) indicating that a
    TIMEOUT response has been received for a UOWL NOTIFY message.
    This will allow customer to determine which system in the group
    is still holding CI locks on the Area and use local diagnostic
    tools to find the lock owner, and take appropriate action.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * IMSFP V15 DEDB data sharing users.                           *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * FASTPATH NOTIFY DIAGNOSTICS ( DFS0066I ) DON'T INCLUDE UOW   *
    * LOCK MODE TRANSITION SUPPORT. CUSTOMER NEEDS THIS FOR        *
    * DIAGNOSTICS.                                                 *
    ****************************************************************
    * RECOMMENDATION:                                              *
    * INSTALL CORRECTIVE SERVICE FOR APAR/PTF                      *
    ****************************************************************
    Message DFS0066I was added to help customers diagnose Fastpath
    NOTIFY response issues in datasharing complex. Unfortunately,
    the support added did not include the NOTIFY processing involved
    in UOW Lock Mode transition. In this case, partner systems allow
    15 seconds for all CI locks on Area to be released, and if this
    time is exceeed, reply 'TIMEOUT' to the NOTIFY. The DFS0066I
    logic is essentially looking for missing responses, not
    'TIMEOUT' responses. No DFS0066I messages are issued in the case
    where one or more partners respond timeout. DBFICLI0 should be
    changed to issue a new message indicating that a TIMEOUT
    response has been received for a UOWL NOTIFY message. This will
    allow customer to determine which system in the group is still
    holding CI locks on the Area and use local diagnostic tools to
    find the lock owner, and take appropriate action.
    

Problem conclusion

  • The following change has been made to correct the reported
    problem:
    DBFICLI0:  Add code to display message DFS4888I when an IMS
    receives 'TIMEOUT' response from a partner system for an UOW
    Lock Mode transition notify.
               DFS4888I UOW LOCK NOTIFY RECEIVED TIMEOUT RESPONSE
    FROM ims_id
    ----------------------------------------------------------------
    --
    GC27-6789-00  IMS V15 Messages and Codes, Volume 1:  DFS
    Messages
    New message DFS4888I
    
    DFS4888I UOW LOCK NOTIFY RECEIVED TIMEOUT RESPONSE FROM ims_id
    
    Explanation
    
    IMS Fast Path has a sysplex communication protocol, which
    utilizes the IRLM notify process to communicate with all sharing
    IMS subsystems in the sysplex. IMS waits until all IMS
    subsystems respond to the sysplex communication protocol, or
    until the initiating IMS times out the notification, and then
    terminates the requested function.  This IMS sends a UOW lock
    mode transition (UOWL) message to other sysplex member due to
    high speed sequential processing (HSSP) or high speed
    reorganization (HSR).  The partner systems allow 15 seconds for
    all CI locks on Area to be released, and if this time is
    exceeded, reply with 'TIMEOUT' to the NOTIFY.
    
    In the message text:
    
    ims_id
    
        The IMS ID of the sysplex that successfully returned a
    timeout response to the UOW lock mode transition message.
    System programmer response:
    
        This IMSID is still holding CI locks on the Area. Use local
    diagnostic tools to find the lock owner(s) and take appropriate
    action.
    Module: DBFICLI0
    

Temporary fix

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

Comments

APAR Information

  • APAR number

    PH05816

  • Reported component name

    IMS V15

  • Reported component ID

    5635A0600

  • Reported release

    500

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    YesHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2018-11-27

  • Closed date

    2018-12-27

  • Last modified date

    2019-02-02

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

    PH03605

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

    UI60449

Modules/Macros

  • DBFICLI0
    

Publications Referenced
GC27678900    

Fix information

  • Fixed component name

    IMS V15

  • Fixed component ID

    5635A0600

Applicable component levels

  • R500 PSY UI60449

       UP19/01/04 P F901 ¢

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":"SSEPH2","label":"IMS"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"15","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Document Information

Modified date:
22 December 2023