1. Application Runtime for CICS User's Guide
  2. IMS DB Access Support

8 IMS DB Access Support

This chapter contains the following topics:

8.1 Overview

ART for CICS enables you to use DL/I CALL 'CBLTDLI' to access IMS DB through Oracle ODBA. With this feature, ART for CICS application programs can do operations in IMS DB, such as adding, searching, and deleting data.

Parent topic: IMS DB Access Support

8.2 Configurations

Configure the followings for the IMS DB Access Support:

Parent topic: IMS DB Access Support

8.2.1 Configure ART for CICS for Accessing IMS DB

ART for CICS servers provide you IMS DB access environment by dynamically loading DL/I library (libcicsdli.so and libcicsdlidb.so), which works as a plug-in component in ART for CICS.

The DL/I library is located in

  • art22.1.0.0.0/IMS_RT/lib/libcicsdli.so
  • art22.1.0.0.0/IMS_RT/lib/libcicsdlidb.so

For more information about LD_LIBRARY_PATH, see Environment Variables in the Oracle Tuxedo Application Runtime for CICS Reference Guide.

Parent topic: Configurations

8.2.2 Configuring ART for CICS Servers

It is required to configure --IMSDB argument in ART for CICS Server CLOPT in UBBCONFIG file. For example,

--IMSDB -x -o wasa.myexample.com:6799:IMSD

Note:

--IMSDB argument must be the last argument in CLOPT

For more information, see IMS DB Argument in the Oracle Tuxedo Application Runtime for CICS Reference Guide

Parent topic: Configurations

8.2.3 Configuring Environment Variables

It is required to set the following environment variables.

  • ART_IMS_CONFIG
  • ART_IMS_DB
  • KIX_IMSDB_TRACE_LEVEL
  • LD_LIBRARY_PATH

For more information, see Environment Variables in the Oracle Tuxedo Application Runtime for CICS Reference Guide

Parent topic: Configurations

8.2.4 Configuring IMS

ART for CICS uses the following configuration files for accessing IMS DB:

  • Application Definition - imsapps.desc
  • Database Definition - imsdbs.desc
  • PSB Definition - $appname.psb
  • Segments Definition - segments.desc
  • Segment Definition - $segname.desc

For more information, see Configuration Files in Oracle Tuxedo Application Runtime for IMS Reference Guide.

Parent topic: Configurations

8.3 Supported Platforms

This feature supports all Linux/AIX 64-bits platforms that Oracle Tuxedo Application Runtime for CICS and Batch 22c Release 1 (22.1.0.0.0) supports, which are listed in the Supported Platforms in Oracle Tuxedo Application Runtime for CICS and Batch Installation Guide.

Tip:

When using COBOL-IT COBOL, you should use option -falloc-unused-linkage to compile programs which include DLIUIB in linkage section.

Parent topic: IMS DB Access Support