Databases and Connections
The DB XA Module does not open connections to a database server. Instead, it makes use of connections previously opened by the TPM. When the TPM opens a connection to the Sybase SQL Server database, a CS_CONNECTION structure gets allocated. Therefore, the DB XA Module does not use Sybase Open Client Client-Library calls like the following, because these calls explicitly establish connections to database servers:
ct_close
ct_con_alloc
ct_con_drop
ct_con_props(with certain options)
ct_config
(for details, see the XA Interface Integration Guide for CICS, Encina and Tuxedo)
ct_connect
ct_exit
ct_getloginfo
ct_init
ct_options
(for details, see the XA Interface Integration Guide for CICS, Encina and Tuxedo)
ct_remote_pwd
ct_setloginfo
NOTE: Consult your Sybase and TPM documentation for complete and up-to-date information.
The connection handle is obtained using the logical resource manager (LRM) name provided during the configuration of the resource manager. The DB XA Module uses a global CS_CONTEXT for all database calls. It fetches the CS_CONNECTION object that was allocated by the TPM using the lrm_name and the thread information, in case the build is multithreaded. For more information about the LRM, see the XA Interface Integration Guide for CICS, Encina and Tuxedo.
