# tibemsConnection_CreateSession

Function

## Purpose

Create a session object.

## C Declaration

    tibems_status tibemsConnection_CreateSession(
        tibemsConnection connection,
        tibemsSession* session,
        tibems_bool transacted,
        tibemsAcknowledgeMode acknowledgeMode );

## COBOL Call

    CALL "tibemsConnection_CreateSession"
         USING BY VALUE connection,
               BY REFERENCE session,
               BY VALUE transacted,
               BY VALUE acknowledgeMode,
               RETURNING tibems-status
    END-CALL.

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

## Parameters

Parameter | Description
--- | ---
`connection` | Create a session on this connection.
`session` | Store the new session in this location.
`transacted` | When true, the new session has transaction semantics. When false, it has non-transaction semantics.
`acknowledgeMode` | Determine the acknowledge mode of the session. Supply a value enumerated by `tibemsAcknowledgeMode`.

## Remarks

The new session uses the connection for all server communications.

## See Also

`tibemsMsg_Acknowledge`

`tibemsSession`

`tibemsAcknowledgeMode`

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