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] [...]

NoteThe “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 2-3 describes each component.

Table 2-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.

NoteTracing 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

NoteThe 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