ODBM RAS U210 prevention enhancement
In IMS 15, ICON has been enhanced to prevent U210 abend in IMS when UDB applications terminate with work in progress.
This enhancement is added to IMS 15 by APAR PH07679/UI62878
When UDB applications terminate and close their socket connections with work in progress due to either ICON timeouts, ODBM Timeouts, or a connection error, causing IMS to issue With this enhancement, ICON now issues an internal DPSB call that results in a rollback of uncommitted work and the prevention of a U210 abend.
To support this enhancement, new CSL4200W, CSL4201W, CSL4202W, and CSL4203W messages are added for ODBM address space to return information about the internal DPSB request.
If the ODBM CSLDCxxx member is being shared among all ODBM address spaces and you would like to override the DIAGDPSBMSG= parm in this member, then the value must be set after the enhancement changes are applied to all ODBM address spaces. If the CSLDCxxx member is modified before the APAR is applied then the ODBM initialization will fail in error parsing the parameter.
Any SLIP Traps for msgid=DFS554A monitoring for abendU0210 must be modified to SLIP on CSL4202W or CSL4203W messages. Additionally if DIAGDPSBMSG=NONE is specified in the CSLDCxxx member then it must be modified to SHORT or LONG or not be specified so it defaults to SHORT.
Changes to installing and defining IMS
With this enhancement, a DIAGDPSBMSG=SHORT|LONG|NONE parameter is introduced to
the DFSDFxxx member of the IMS PROCLIB data set. A new parameter DIAGDPSBMSG=SHORT|LONG|NONE is
added to CSLDCxxx member.
Changes to troubleshooting for IMS
New CSL4200W, CSL4201W, CSL4202W, and CSL4203W messages are added for ODBM address space to return information about the internal DPSB request. Also, IMS Connect Recorder trace and the BPE RCTR trace in IMS Connect is modified to trace the IMS Connect Socket logon token.
Migration considerations
IMS 15 is the first IMS release where the DFSDFxxx member of the PROCLIB data set is mandatory.
Log record changes
The DFSLOG07 macro of the X'07' log record is changed to provide indicators if changes in IMS have been rolled back due to prevent a u210 abend.
The DFSLOG07 macro is enhanced to include a new X'08' flag bit (DLRIRLBK) in DLRFLAG4 at offset X'15E'. The DLRIRLBK flag bit operates as an indicator to state if IMS changes were rolled back before the DPSB request from ODBM was processed to prevent a U210 abend. This DPSB from ODBM is due to the internal DPSB request from IMS Connect. Refer to the CSL4200W and CSL4201W and additional CSL4202W or CSL4203W messages in ODBM for additional details.
Changes to troubleshooting for IMS
Trace records are written to BPE Error trace table in ODBM address space.
For a list of the messages and codes that are new or changed for this enhancement, see the IMS messages and codes row in the table in Documentation changes.
For a complete list of all of the new, changed, and deleted messages, and abend codes in IMS 15, see IMS 15 Message and code changes.
Changes to commands
The QUERY ODBM command is updated to return the DIAGDPSBMSG value.
For a list of the commands that are new or changed for this enhancement see the IMS commands row in the table in Documentation changes.
Changes to exit routines
The control statement for the log edit user exit (LOGEDIT) is moved from the DFSVSMxx member of the IMS PROCLIB data set to the new LOGGER section of the DFSDFxxx member.
Documentation changes
The following publications contain new or changed information for the ODBM RAS U210 abend enhancement. Publications that are not impacted by this enhancement are not included in the table.
| Publication | Links to topics | ||
|---|---|---|---|
| Commands | |||
| Release planning |
|
||
| System definition |
|
||
| Diagnosis | |||
| IMS messages and codes | DFS messages | ||