tibemsConnectionFactory_CreateXAConnection

Function

Purpose

Create an XA connection object.

C Declaration

extern tibems_status
tibemsConnectionFactory_CreateXAConnection(
    tibemsConnectionFactory factory,
    tibemsConnection* connection,
    const char* username,
    const char* password);

COBOL Call

CALL "tibemsConnectionFactory_CreateXAConnection"
    USING BY VALUE factory,
           BY REFERENCE connection,
           BY REFERENCE username,
           BY REFERENCE password,
           RETURNING tibems-status
END-CALL.
Note: factory and connection have usage pointer.

Parameters

Parameter Description
factory Use this connection factory to create a connection.
connection The function stores the new connection object in this location.
userName The connection object presents this user identity to the server. Set to NULL if the server isn’t authenticating or authorizing users.
password The connection object authenticates the user identity with this password. Set to NULL if the server isn’t authenticating or authorizing users.

Remarks

When the identity parameters are null, the connection object presents a default user identity. If the server configuration permits that anonymous user, then the call succeeds.