Use of the IMS catalog is optional in PowerExchange and IMS. However, certain IMS functionality, such as database versioning and the management of run-time application control blocks, requires the IMS catalog. For more information, see the IBM IMS documentation.

To get DBD information for source objects from the IMS catalog, PowerExchange uses the IMS catalog API. This API consists of the DFS3CATQ assembly program in the IMSxx.SDFSRESL.RESLIB library and the DFS3CATQ macro in the IMSxxx.SDFSMAC library. The API requires the high-level qualifier of the IMS bootstrap data set. If the IMS control region is

not

running, or if you are using an IMS version earlier than IMS 15, you must specify the high-level qualifier of the bootstrap data set in the IMSBSDS statement in the DBMOVER configuration file. If you use IMS 15 and the control region is running, the high-level qualifier can be retrieved programmatically.

To use the IMS catalog, configure the IMSBSDS statement in the DBMOVER configuration file on the PowerExchange Listener system. This statement specifies the high-level qualifier of the bootstrap data set and the order in which PowerExchange searches locations, such as the IMS catalog and IMS DBDLIB library, for DBD information. Ensure that the

ims_ssid

value that you specify in this statement matches the

ims_ssid

value in an IMSID statement in the DBMOVER file. If DBD information cannot be found in the IMS catalog, PowerExchange uses the associated IMSID statement to find the DBDLIB library. For more information, see the "DBMOVER Configuration File" chapter in the

PowerExchange Reference Manual

.