Copyright © TIBCO Software Inc. All Rights Reserved

> 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 on page 225).

> Function | Description | Page
> tibemsConnection_Close | Close the connection; reclaim resources. | 204
> tibemsConnection_Create tibemsConnection_CreateSSL | Create a new connection to an EMS server. | 206
> tibemsConnection_CreateSession | Create a session object. | 208
> tibemsConnection_GetActiveURL | Get the active URL of a connection. | 209
> tibemsConnection_GetClientId | Get the client ID of a connection. | 210
> tibemsConnection_GetExceptionListener | Get the exception listener of a connection. | 211
> tibemsConnection_GetMetaData | Get the metadata from a connection. | 212
> tibemsConnection_IsDisconnected | Checks whether the connection has been disconnected. | 213
> tibemsConnection_SetClientId | Set the client ID of a connection. | 214
> tibemsConnection_SetExceptionListener | Set the exception listener for a connection. | 215
> tibemsConnection_Start | Start delivering inbound messages. | 216
> tibemsConnection_Stop | Stop delivering inbound messages. | 217

Copyright © TIBCO Software Inc. All Rights Reserved