1. Application Runtime for CICS Reference Guide
  2. CICS Runtime Server Build Tool
  3. Overview
  4. Administration

12.1.2 Administration

To make this tool work correctly, several environment variables must be set firstly as shown in the following Table.

Table 12-2 Required Environment Variables

Variable Name Description
TUXDIR Mandatory. Install directory of Tuxedo. If it is not set, the tool will stop with a clear error message.
KIXDIR Mandatory.

Install directory of ART CICS Runtime. It’s <ART_INSTALL_DIR>/Cics_RT. If it is not set, the tool will stop with a clear error message.

Besides, “$KIXDIR/bin” must be included in “$PATH” to execute buildartcics.

COBDIR | COBOLITDIR Mandatory. Install directory of COBOL compiler (COBDIR is for Micro Focus COBOL; COBOLITDIR is for COBOL-IT). One and only one can be set in the environment. If neither or both of them exist, the tool will stop with a clear error message.
DB2DIR | ORACLE_HOME Mandatory in some situations.

Optional for others.

Install directory of database (DB2DIR is for UDB and is mandatory when “-r UDB_XA*” is specified; ORACLE_HOME is for Oracle and is mandatory when “-r Oracle_XA*” is specified).

If either of them does not exist when required, the tool will stop with a clear error message.
MT_DB_LOGIN Mandatory for ARTTSQ* servers built with UDB database.

Optional for others.

The connect parameter for DB2 database is used in: 
db2 connect to […]

General Syntax: “db-alias user username using passord”
DB2INSTANCE Mandatory for ARTTSQ* servers built with UDB database.

Optional for others.

Specifies current DB instance.
MQM Optional. Stands for the install dir of WebSphere MQ. If not set, it equals to “/usr/mqm” for AIX platforms and “/opt/mqm” for Linux and Solaris platforms.

Note:

  • To use COBOL-IT compiler, please make a copy or create a symbol link of “$COBOLITDIR/bin/cobmf” as “$COBOLITDIR/bin/cob”. For example, you can use following command: ln -s $COBOLITDIR/bin/cobmf $COBOLITDIR/bin/cob.
  • For Solaris platform, please make sure that $LD_LIBRARY_PATH includes library path for 64-bit "libc*" libraries, which are located in <SUN_STUDIO_INSTALL_DIR>/lib/v9.
  • For Solaris platform, please ensure that $LD_LIBRARY_PATH includes library path for 64-bit "libc*" libraries, which are located in <SUN_STUDIO_INSTALL_DIR>/lib/v9.
  • To build ARTTSQ with UDB, please make sure the table "TS_Q_CONTENT" already exists in the Database; if not, you can run "<ARTINSTALL_DIR>/Cics_RT/tools/crtstable_UDB" after all required environment variables are set correctly.

Parent topic: Overview