Environment Variables

CICS Runtime Environment variables

Two important Tuxedo environment variables are MANDATORY.

•	TUXDIR– must be set to indicate the directory in which Tuxedo is installed.

•	APPDIR – must be set to indicate the directory where the application server binaries are installed.

Note:

For CICS Runtime, APPDIR must be set to the directory containing the CICS Runtime server binaries.

CICS Runtime specific environment variables

KIXDIR

KIXDIR is a mandatory environment variable that indicates the directory where the CICS Runtime product is installed.

Usually, the Tuxedo environment variable APPDIR should be set to ${KIXDIR}/bin

KIXCONFIG

KIXCONFIG is a mandatory environment variable that indicates the directory where resource configuration files are located.

KIX_TS_DIR

KIX_TS_DIR is a mandatory environment variable that indicates the directory where files corresponding to non-recoverable TS are located. It can be differentiated for each tsq server by setting it differently in the server envfile (see the Tuxedo documentation).

KIX_TECH_DIR

KIX_TECH_DIR is a mandatory environment variable that indicates the directory where technical files used internally by ART CICS, for exemple to manage named DELAYs and CANCELs (thru the REQID option) or ENQ/DEQ are written. It should be the same for each server until one wants to reproduce the source limitation, where a named DELAY submitted on one CICS region, could not be canceled easily in another region.

KIX_CWA_SIZE

This environment variable is optional.

On the source platform the Common Work Area (CWA) is shared by all the Programs executing inside a single CICS Region. The size of this CICS zone can vary from 0 to 32765 bytes, 0 indicating that no CWA is defined.

On the target platform, the KIX_CWA_SIZE variable also indicates the size of the CWA, ranging from 0 to 32765 bytes. If this environment variable is not set, the value defaults to 0. A value of zero (either explicit or implicit) indicates that no CWA is defined.

KIX_CWA_IPCKEY

The Common Work Area (CWA), when defined (see KIX_CWA_SIZE), is implemented on each machine by a shared memory segment. The KIX_CWA_IPCKEY variable indicates the IPCKEY (the identifier) of the shared memory segment. The value must be defined in the range from 1 to 99 999 999.

Note:

This variable is mandatory when KIX_CWA_SIZE is set to a value greater than zero.

KIX_QSPACE_IPCKEY

This mandatory variable is used to create the Tuxedo qspace named ASYNC_QSPACE utilized by ARTATRN for delayed asynchronous transactions.

The value for the IPC key should be picked so as not to conflict with your other requirements for IPC resources. It should be a value greater than 32 768 and less than 262 143.

KIX_TRACE_LEVEL

This optional variable allows the administrator to get traces for the system activities.

It can be set from 0 to 9, 0 meaning no trace, 9 meaning maximum trace. The default value is 0 when the variable is not defined.

KIX_MAP_PATH

This optional variable defines the path (the list of directories) in which the physical file of the mapset will be searched, in case the absolute path is not specified in the FILENAME field of Mapset in the Typeterm configuration file.