Open string parameters

The format for parameters in the open string for the DTM XA Interface is:

-Nlrm_name -Uusername -Ppassword [-Llogfile_name] 
 [-Ttraceflags] [-V11] [-O1] [-O-1]

Table 3-1 describes each component of the open string.

Table 3-1: Sybase X/Open XA open string parameters

Parameter

Meaning

lrm_name

The name of the LRM as defined in the XA configuration file.

username

The user name used to log in to Adaptive Server. See “dtm_tm_role required for username” below for more information.

password

The password accompanying the user name.

logfile_name

The fully qualified file name to which the XA Interface writes tracing information (optional).

The XA Interface initializes the log file and trace flag settings with the initial xa_open() call. If no logfile_name is specified, then the DTM XA Interface logs information to a file named syb_xa_log in the current directory.

traceflags

Trace flags control the output that is written to the log file (optional). See “Parameters for [all] section of XA configuration file” in this document for a list of valid trace flags.

-V11

Specifies Open Client version 11 behavior for backward compatibility (optional).

-O1 or -O-1

Specifies an option for transaction operation. At this time only -O1 (tightly coupled transaction branches) is supported. -O1 sets the option. -O-1 clears the option. -O-1 is the default.

WARNING! See “Tightly coupled transactions” in chapter 4 of this document before setting -O1.