Creating the ODBA DRA start-up table

Create the ODBA DRA startup table using the DFSPRP macro.

The startup table uses the DSNAME to dynamically allocate the data set that contains the rest of the ODBA interface routines. The DDNAME is generated to allow multiple connections to IMS™ from the same z/OS® application region. If you specify the DDNAME on the DFSPRP macro, it is ignored.

The default DSNAME is IMS.SDFSRESL. This is the default name established by the IMS definition process. Make sure this data set is APF authorized.

Note: IMS.SDFSRESL library does not contain an DRA startup table. You must generate your own table by using the DFSPRP macro. Name the load module based on the following naming conventions:
  • Characters 1-3 = DFS
  • Characters 4-7 = specified 4-byte ID

    The 4-byte ID should be the IMSID of the IMS system to which you will connect. However, this is not a requirement.

  • Character 8 = 0 (zero)

Ensure that the DRA startup table module name is not the same as the name of an existing IMS module. To prevent accidental overlay, put the module in a load library that is accessible by the z/OS application region and not by the IMS region.

If you use a different library for your own versions, make sure that the library is APF authorized. The DRA callable interface dynamically allocates the library by using the data set name specified in the DRA startup table. The DDNAME is generated to allow multiple connections to IMS from the same z/OS application region.

The DFSPRP macro is documented in IMS Version 13 System Programming APIs.