# tibemsXAConnection_CreateXASession

Function

## Purpose

Create an XA session object.

## C Declaration

    tibems_status tibemsXAConnection_CreateXASession(
        tibemsConnection connection,
        tibemsSession* session );

## COBOL Call

    CALL "tibemsXAConnection_CreateXASession"
         USING BY VALUE connection,
               BY REFERENCE session,
               RETURNING tibems-status
    END-CALL.

Note: `connection` and `session` have usage pointer.

## Parameters

Parameter | Description
--- | ---
`connection` | Create a session on this connection.
`session` | Stores the new session.

## Remarks

The new session has transactional semantics with an external transaction manager, and uses the connection for all server communications.

Note: XA sessions do not support routed queues.

## See Also

`tibemsSession`

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