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 Jakarta Messaging methods createConnectionConsumer and createDurableConnectionConsumer (which are optional in the Jakarta Messaging 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.