PURPOSE

buildtms - construct a transaction manager server load module

SYNOPSIS

buildtms
[ -v ] -o name -r rm_name

DESCRIPTION

buildtms is used to construct a transaction manager server load module.

While several TM servers are provided with TUXEDO System/T and System/D, new resource managers may be provided to work with System/T for distributed transaction processing. The resource manager must conform to the X/OPEN XA interface. The following four items must be published by the resource manager vendor: the name of the structure of type xa_switch_t that contains the name of the resource manager, flags indicating capabilities of the resource manager, and function pointers for the actual XA functions; the name of the resource manager that is contained in the name element of the xa_switch_t structure; the name of the object files that provide the services of the XA interface and supporting software; and the format of the information string supplied to the OPENINFO and CLOSEINFO parameters in the UBBCONFIG configuration file. See ubbconfig(5).

When integrating a new resource manager into System/T, the file $TUXDIR/udataobj/RM must be updated to include the information about the resource manager. The format of this file is rm_name:rm_structure_name:library_names
where rm_name is the resource manager name, rm_structure_name is the name of the xa_switch_t structure, and library_names is the list of object files for the resource manager. White space (tabs and/or spaces) is allowed before and after each of the values and may be embedded within the library_names. The colon (:) character may not be embedded within any of the values. Lines beginning with a pound sign (#) are treated as comments and are ignored.

A transaction manager server for the new resource manager must be built using buildtms and installed in $TUXDIR/bin. buildtms uses the buildserver(1) command to build the resulting a.out. The options to buildtms have the following meaning:

-v

specifies that buildtms should work in verbose mode. In particular, it writes the buildserver command to its standard output and specifies the -v option to buildserver.

-o name

specifies the name of the file the output load module is to have.

-r rm_name

specifies the resource manager associated with this server. The value rm_name must appear in the resource manager table located in $TUXDIR/udataobj/RM. The entry associated with the rm_name value is used to include the correct libraries for the resource manager automatically and properly to set up the interface between the transaction manager and resource manager (using the xa_switch_t structure).

buildtms uses the buildserver command to produce the a.out. buildserver uses the CC and CFLAGS environment variables, if set, for the compiler and compiler flags, respectively. See buildserver(1) for further details.

PORTABILITY

buildtms is supported as a TUXEDO System-supplied compilation tool on UNIX Systems only.

EXAMPLES

buildtms -o $TUXDIR/bin/TMS_D -r TUXEDO/D    # standard System/D TMS
buildtms -o $TUXDIR/bin/TMS_XYZ  -r XYZ/SQL  # TMS for XYZ resource manager 

SEE ALSO

buildserver(1),

ubbconfig(5)