Enabling the DRA for the ODBA interface

Four steps are required to enable the DRA before an ODBA interface can use it. The first step is to create the ODBA DRA startup table.

There are four steps required to enable the DRA before an ODBA interface can use it:

  1. Create the ODBA DRA Startup Table.
  2. Verify that the ODBA and DRA modules reside in the STEPLIB or JOBLIB in the z/OS® application region.
  3. Link the ODBA application programs with DFSCDLI0.
  4. Configure security.

The ODBA interface starts the initialization process after the ODBA application program issues either a CIMS INIT request or, if the ODBA application requires connections to multiple IMS systems, a CIMS CONNECT request. The CIMS INIT and CIMS CONNECT requests establish the ODBA environment in the address space. APSB requests then call the DRA to process the PSB schedule request with the IMS DB specified in DFSxxxx0, where xxxx is the DRA startup table name specified on the APSB call in the AIBRSNM2 field of the AIB.

After processing the CIMS INIT request or the CIMS CONNECT request, the DRA identifies itself to IMS DB if the optional xxxx value is passed on the CIMS INIT or CIMS CONNECT call. The DRA is then capable of handling other requests. The DRA's structure at this time is shown in the following figure.

Figure 1. DRA component structure with the ODBA interface
begin figure description - This figure is described in the surrounding text. end figure description.

The remainder of the DRA modules reside in a load library that is dynamically allocated by DFSAERA0. The DDNAME and DSNAME of this load library are specified in the startup table. The default DSNAME (IMS.SDFSRESL) contains all the DRA code.