•
|
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.
|
This is optional environment variable for local transaction optimization. When ARTKIX_XA_DISABLE=yes, it uses database local transaction instead of XA transaction. All ART application servers, such as
ARTSTRN/1,
ARTATRN/1,
ARTCTRN/1,
ARTWTRN/1, and
ARTDPL support
ARTKIX_XA_DISABLE by default; however, when rebuilding your own ART application server, you should specify
-n option in
buildartcics command to support
ARTKIX_XA_DISABLE. This local transaction optimization should be used only in local transaction scenario. Default value is
NO.
DD_VSAMFILE is a mandatory environment variable that indicates the location of VSAM configuration file "
desc.vsam" generated by ART Workbench, if the CICS program contains some VSAM operations.
If ARTKIX_XA_DISABLE=yes, then
DBCONNECT must be set, it specifies database connection string, for example,
USER/PASSWD@SID when using Oracle.
ISC_ENABLE is an optional environment variable. Set
ISC_ENABLE=YES to enable the following ISC related features:
•
|
START TRANSID with <ANY> TERMID
|
•
|
When ISC_ENABLE=YES, ART CICS cannot validate LUNAME across multi-CICS regions. Users must ensure LUNAME is unique across different CICS regions.
|
KIXCONFIG is a mandatory environment variable that indicates the directory where resource configuration files are located.
KIXDIR is a mandatory environment variable that indicates the directory where the CICS Runtime product is installed.
KIX_CBL_TRAP_ERROR is used to enable or disable the COBOL LE (language environment) error procedure. The default value is
Y, meaning the error procedure is enabled. If
KIX_CBL_TRAP_ERROR=N is specified, the error procedure will be disabled. For more information, see
Error Processing in CICS Runtime.
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.
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_DUMP_FILE is an optional environment variable that indicates the file where the COBOL-IT memory dumps are located. Currently, the
KIX_DUMP_FILE only take effect for COBOL-IT. And you must make sure the COBOL-IT version is newer than 3.7.7. The COBOL-IT version older than 3.7.8 can lead an infinite loop condition for memory
DUMP.
If KIX_DUMP_FILE is set to a valid local file, the final memory information of the program will be dumped in this specified dump file when CICS program aborts; otherwise, no dump file will be generated.
KIX_IMSDB_TRACE_LEVEL is an optional environment variable that specifies IMS DB access log trace level; its value equals to the level in Oracle Tuxedo Application Runtime for IMS.
KIX_JOURNAL_DIR is a mandatory environment variable for
WRITE JOURNALNAME. It indicates the directory where the files corresponding to journal records are located.
KIX_PROFILING is used to enable or disable the CICS runtime statistics function. Specify
KIX_PROFILING=YES to enable the statistics function. The default value is
NO. For more information, see
CICS Runtime Statistics.
KIX_RESSEC is an optional environment variable that enables or disables resource-based authorization.
•
|
KIX_RESSEC=A: performs resource-based authorization when you access a resource in a transaction. This applies to all transactions.
|
•
|
KIX_RESSEC=Y: performs resource-based authorization when you access a resource in a transaction. This only applies to the transactions whose RESSEC=Y is specified in transactions.desc.
|
•
|
KIX_RESSEC=N: no resource-based authorization is performed. This is the default value.
|
Mandatory for GETMAIN SHARED, it indicates the IPCKEY of the shared memory segment used for
GETMAIN SHARED.
Mandatory for GETMAIN SHARED, it indicates the size of shared memory used for
GETMAIN SHARED in unit of Mega-byte. Valid range is from 0 to 32768*1024. A value of 0 indicates no
GETMAIN SHARED support. Since the overhead introduced by internal implementation mechanism, the actual memory size that can be used by user is less than the value indicated by
KIX_SHR_SIZE.
Optional for GETMAIN SHARED, the attaching address of shared memory, default: 0x300000000000. If the value is specified, it must be a page-aligned address, address in range 0x300000000000 ~ 0x500000000000 is taken as valid.
For example: KIX_SPOOL_JOB_SUBMIT=/my_path/my_shell_script -f %s -c %s
KIX_TD_DIR is a mandatory environment variable that indicates the directory where files corresponding to the extra partition TDQueues are located.
KIX_TD_QSPACE_DEVICE is a mandatory environment variable for
TD QUEUE(INTRA). It indicates the Tuxedo QSPACE needed by the tdq_srv server.
KIX_TD_QSPACE_IPCKEY is a mandatory environment variable for
TD QUEUE(INTRA). It indicates the Tuxedo QSPACE ipckey needed by the tdq server.
KIX_TD_QSPACE_NAME is a mandatory environment variable for
TD QUEUE(INTRA). It indicates the Tuxedo QSPACE name needed by the tdq server.
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_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).
If KIX_USER_TRACE is set to
SID,
KIX_TRACE_PATH variable must be set. It defines the directory containing the trace files (the file name is ended by ".trc").
Optional variable for ARTTSQ. Set KIX_TSQ_FILE_OPT=YES to enable file open/close optimization for non-recoverable TSQ. Default is NO.
KIX_USER_TRACE=SID represents one trace file per connection. The other value is
STD, in this case traces will be in each stdout of server, if the variable is not set to STD is assumed.
KIX_USERID_TOUPPER is an optional environment variable that enables or disables user ID uppercase conversion. When
KIX_USERID_TOUPPER is set to
Y, user ID that is specified in the CESN transaction is converted to uppercase after authentication. The default value is
N.
KIX_XA_REOPEN_THRESHOLD is an optional environment variable. It defines threshold to trigger RM reopen. Threshold is continuous XA operation failure times; XA operation is
tpbegin/
tpcommit/
tpabort, from Tuxedo perspective. When the threshold is met, ART for CICS application servers (
ARTSTRN/1,
ARTATRN/1,
ARTCTRN/1,
ARTWTRN/1 and
ARTDPL) suspend its transaction service, and then try to re-open RM to recover the failure.
KIX_XA_REOPEN_THRESHOLD must be a positive value in decimal format; if it is not set, "XA error detect and RM reopen" function is not enabled.
KIX_XA_REOPEN_INTERVAL is an optional environment variable. It defines interval in seconds between two XA reopen tries. Specify
KIX_XA_REOPEN_INTERVAL when
XA_REOPEN_THRESHOLD is set. Its value must be positive integer in decimal format; the default interval is 30 seconds.
LD_LIBRARY_PATH is an optional environment variable that specifies the location of library.