# 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.

## See Also

`tibemsConnection`

Copyright © Cloud Software Group, Inc. All rights reserved.