IMS DB Access Support

This chapter contains the following topics:

•

Overview

•	Configurations

•	Supported Platforms

•

Tips

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.

Configurations

Configure the followings for the IMS DB Access Support.

•	Configure ART for CICS for Accessing IMS DB

•	Configuring ART for CICS Servers

•	Configuring Environment Variables

•	Configuring IMS

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.

Therefore, you should get these two librarires from Oracle Tuxedo Application Runtime for IMS and locate them in ART for CICS environment variable LD_LIBRARY_PATH.

•	On Linux platforms, you can get DL/I library from Oracle Tuxedo Application Runtime for IMS Rolling Patch 025 or later.

•	On AIX platforms, you can get DL/I library from Oracle Tuxedo Application Runtime for IMS Rolling Patch 026 or later.

The DL/I library is located in

•	art12.2.2.0.0/IMS_RT/lib/libcicsdli.so

•	art12.2.2.0.0/IMS_RT/lib/libcicsdlidb.so

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

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.us.oracle.com:6799:IMSD

Note:

--IMSDB argument must be the last argument in CLOPT.

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

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 Oracle Tuxedo Application Runtime for CICS Reference Guide.

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" section in Oracle Tuxedo Application Runtime for IMS Reference Guide.

Supported Platforms

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

Tips

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