A fix is available
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:
APAR is sysrouted TO one or more of the following:
UI60449
Modules/Macros
DBFICLI0
| 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