Open Database Manager (ODBM) and JDBC driver support for INIT STATUS Group call

In IMS 15.2, support for ODBM to allow INIT STATUS GROUPx call from an application using IMS Universal Drivers (UDB) is added. This feature is delivered through the APARs PH0366 and PH02698 (for IMS Universal Drivers).

To prevent an IMS Java application from terminating abnormally with ABEND U3303 or ABEND U0777 due to an unavailable database or due to a deadlock, respectively, IMS allows the application to issue an INIT STATUS call before the database can be accessed. With APAR PH02698, IMS Universal Drivers can allow an application to issue an INIT STATUS call, in conjunction with APAR PH00366 that modifies ODBM to enable the support. Issuing the INIT STATUS GROUPA call avoids the ABEND U3303 and issuing the INIT STATUS GROUPB call avoids the ABEND U0777.

Note: This enhancement requires that the APARs PH00366 and PH02698 are applied together.

Changes to programming for IMS

The new methods initStatusGroupA(), initStatusGroupB(), and setInitStatusGroup(String) are added to the Java API specifications for IMS Universal Drivers and IMS JDR resource adapter packages to reflect the support extended for INIT STATUS GROUPx calls. To avoid ABEND U3303, use either initStatusGroupA() or setInitStatusGroup("A"). To avoid ABEND U0777 due to a deadlock condition (Abendu777) use INIT STATUS GROUPB. A new optional connection property <initStatusGroup> is also added to the JDBC DriverManager interface to connect to the IMS database. For detailed information the INIT STATUS Group calls, see Javadoc listed in the Documentation Changes table.

Documentation changes

The following table lists the publications that contain new or changed topics for the New function name 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 New or changed topics
Release planning
Application programming APIs