Chapter 3: Configuring the XA Environment

Parameter definitions for [all] section

Entries for the [all] section in the XA configuration file are as follows:

[all]
logfile="logfile_name"
traceflags="[xa | xl | xc | cm| event | misc | os | ct | all]"
[properties=name=value] [...]

The “0x” values in the xa_config file can be lost or converted to non-ASCII characters because of the way some characters are processed. To avoid this problem, you must use quotes around all string values. Failure to do so can result in the introduction of unexpected characters into the string.

Table 3-3 describes each component.

**Table 3-3: Parameters for [all] section of XA configuration file**
Parameter	Meaning
logfile_name	The fully qualified file name to which the DTM XA Interface writes tracing information. The DTM XA Interface initializes the log file and trace flag settings with the initial xa_open() call.
traceflags	The trace flags control the output that is written to the log file. Specify one or more of the following flags: all – all tracing. ct – the ct_debug option with the CS_DBG_ERROR flag (ct_debug functionality is available only from within the debug version of Client-Library). cmn – entry and exit point tracing of internal XA Interface functions. event – tracing of significant internal events. misc – tracing of activities and information for problem resolution. xa – entry and exit point tracing at the xa_* level. xc – entry and exit point tracing at the xc_* level. xl – entry and exit point tracing at the xl_* level. Tracing at the xc_, xl_, event, misc, and cmn levels is intended to be meaningful only to Sybase development. Specify these tracing levels only when instructed to do so by Sybase Technical Support.
properties	The following property must be set in the [all] stanza. You cannot set it in the [xa] stanza: CS_LOGIN_TIMEOUT=timeout You can define these optional properties in the [all] section of the XA configuration file: PROPERTIES=CS_DISABLE_POLL=[CS_TRUE \| CS_FALSE] PROPERTIES=CS_EXTRA_INF=[CS_TRUE \| CS_FALSE] PROPERTIES=CS_HIDDEN_KEYS=[CS_TRUE \| CS_FALSE] PROPERTIES=CS_MAX_CONNECT=number_of_connections PROPERTIES=CS_NOINTERRUPT=[CS_TRUE \| CS_FALSE] PROPERTIES=CS_TEXTLIMIT=textlimit PROPERTIES=CS_TIMEOUT=timeout

View this book as PDF