tibemsConnection
Type
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. |