IMS catalog API enhancement

In IMS 15, the IMS catalog API function enhancements allow both the staging and the directory data sets of the IMS catalog to be accessed using a single OPEN, GET, and LIST requests. The HLQ request allows the boot strap data set (BSDS) name to be discovered automatically for the IMS catalog API OPEN request. The IMS catalog API can support up to 36 concurrent FUNCTION=OPEN requests. These enhancements can be used by IMS vendor-supplied tools.

The IMS catalog API function enhancement to OPEN, GET, and LIST requests is delivered by APARs/PTFs PI84981/UI53467 and PI84986/UI54029. The IMS catalog API HLQ function is delivered by APARs/PTFs PI90082/UI55179.

The OPEN function enhancement allows you to allocate and open the staging and the directory data sets of the IMS catalog by providing the new keyword BOTH for the DEFINITION parameter of the OPEN request. Previously, each OPEN request could allocate and open only either the staging data set or the directory data set, but could not open both.

The HLQ function enhancement allows IMS vendor-provided tools to acquire the high-level qualifier of the boot strap data set (BSDS) during an OPEN request without manually specifying the BSDS name in the request JCL.

The LIST and GET functions of the IMS catalog API are also enhanced, allowing you to define whether the functions retrieve information from the staging or the directory data set.

With APAR/PTF PH39492/UI80985, the GET functions of the IMS catalog API are enhanced so that you do not need to return the extended attribute table in a DBD. This parameter is valid only for the FORMAT=DBDLIB parameter.

The CLOSE function has also been updated to close both the staging and the directory data sets of the IMS catalog if they are both open.

Changes to programming for IMS

For a list of topics about programming IMS that are changed by this enhancement, see the Application Programming APIs row in the table in Documentation changes.

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 Links to topics
Release planning
Application programming APIs