ODBM RAS U210 prevention enhancement

In IMS 15.2, ICON has been enhanced to prevent a 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 ICON timeouts, ODBM Timeouts, or a connection error, IMS issues a U210 abend. With this enhancement, ICON issues an internal DPSB call that rolls back uncommitted work and prevents the U210 abend.

To support this enhancement, new CSL4200W, CSL4201W, CSL4202W, and CSL4203W messages are added for the ODBM address space to return information about the internal DPSB request.

Important:

This enhancement must be applied to all IMS, ODBM, and IMS Connect address spaces to ensure that U210 abends in IMS for an internal DPSB requests from IMS Connect are prevented.

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 left unspecified so that it defaults to SHORT.

Changes to installing and defining IMS

With this enhancement, new parameter DIAGDPSBMSG=SHORT|LONG|NONE is added to the CSLDCxxx member of the IMS PROCLIB data set.

Changes to troubleshooting for IMS

New CSL4200W, CSL4201W, CSL4202W, and CSL4203W messages are added for the 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.

Log record changes

The DFSLOG07 macro of the X'07' log record now indicates whether changes in IMS have been rolled back 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 whether 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 more details.

Changes to troubleshooting for IMS

Trace records are written to the BPE Error trace table in the 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.2, see IMS 15.2 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.

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.

Table 1. Links to topics that have new or changed content for this enhancement
Publication Links to topics
Commands
Release planning
System definition
Diagnosis
IMS messages and codes DFS messages