Configuration

XIMS toolkit enables the IMS/DC application to run under XCICS TS. That means that XCICS must be correctly configured (please refer to XCICS TS documentation) to host XIMS.

Furthermore, in order to run properly an application, XIMS toolkit also must be correctly configured.

An XIMS application is defined as a set of transaction, programs, maps and other resources, grouped together to run under the control of a single XCICS main process.

XIMS configuration is provided in the same configuration as XCICS TS (xcics.conf).

First of all, when defining an XIMS application, the xcics.conf must include the following directives:

set use_xims=yes;
set use_dli=yes;
load library=$H2RHOME/lib/libdl1.sl;
load library=$H2RHOME/lib/libims.sl;
set xims_format_path=$HOME/fmt;
set xims_spool_command=$HOME/bin/xims_spool;
set xims_spool_path=$HOME/spool/tmp;

Where the IMS_FORMATS paths to the directory where .msg and .fmt are stored (see fmt2bms).

And a default DBC named DL1 must be defined:

define dbc name=DL1, database=HTORA1, user=upim, password=upim;
bind dbc=DL1 default;

Parameters, resources and environment variables are specified using the define directive

Every directive is terminated using ?;?. Directive parameters are comma (?,?) separarted. If not explicitly required no quotas (?) is required for values.

Lines started with ?#? are treated as remarks.