# tibemsConnection

Type

## Purpose

Represent a server connection.

## Remarks

When a program first opens a connection, the connection is stopped—that is, it does not deliver inbound messages. To begin the flow of inbound messages, the program must explicitly call `tibemsConnection_Start`. (Outbound messages flow even before calling `tibemsConnection_Start`.)

The EMS C and COBOL APIs do not support the JMS methods `createConnectionConsumer` and `createDurableConnectionConsumer` (which are optional in the JMS specification).

## Asynchronous Errors

When a program uses a connection to send messages, the send calls can detect problems with the connection, and notify the client program (synchronously) by returning error codes.

However, when a program uses a connection only to receive messages, the client lacks that opportunity to detect problems. Instead, programs can handle such errors asynchronously by defining an exception listener callback (see `tibemsExceptionCallback`).

Function | Description
--- | ---
`tibemsConnection_Close` | Close the connection; reclaim resources.
`tibemsConnection_Create` `tibemsConnection_CreateSSL` | Create a new connection to an EMS server.
`tibemsConnection_CreateSession` | Create a session object.
`tibemsConnection_GetActiveURL` | Get the active URL of a connection.
`tibemsConnection_GetClientId` | Get the client ID of a connection.
`tibemsConnection_GetExceptionListener` | Get the exception listener of a connection.
`tibemsConnection_GetMetaData` | Get the metadata from a connection.
`tibemsConnection_IsDisconnected` | Check whether the connection has been disconnected.
`tibemsConnection_SetClientId` | Set the client ID of a connection.
`tibemsConnection_SetExceptionListener` | Set the exception listener for a connection.
`tibemsConnection_Start` | Start delivering inbound messages
`tibemsConnection_Stop` | Stop delivering inbound messages.

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