tibemsQueueConnection_Create


Function

Purpose

Backward compatibility. Create a connection restricted to queue operations.

C Declaration

tibems_status tibemsQueueConnection_Create( 
    tibemsQueueConnection* queueConnection, 
    const char* brokerURL, 
    const char* clientId, 
    const char* username, 
    const char* password ); 
 
tibems_status tibemsQueueConnection_CreateSSL( 
    tibemsQueueConnection* queueConnection, 
    const char* brokerURL, 
    const char* clientId, 
    const char* username, 
    const char* password, 
    tibemsSSLParams sslParams, 
    const char* pk_password ); 

Parameter
Description
queueConnection
The function stores the new connection in this location.
brokerURL
Find the EMS server at this URL.
clientId
Identify the client program to the server with this unique ID.
username
Identify the client program to the server with this user name.
password
Authenticate the client program to the server with this password.
sslParams
Establish SSL communication using these parameters.
pk_password
Private key password for SSL.

Remarks

When the authentication parameters are null, the connection object presents a default user identity. If the server configuration permits that anonymous user, then the call succeeds.

Status Code
Description
  • No server is running at the specified URL.
  • The call could not communicate with a server because of mismatched SSL and TCP protocols.
  • Other error situations are possible.
  • The server rejected the connection because the username or password was invalid.
  • SSL setup is incorrect.
The client ID is not unique; that is, another client already uses the ID.

See Also

tibemsConnection_Create


TIBCO Enterprise Message Service™ C and COBOL Reference
System Release 4.3, February 2006
Copyright © TIBCO Software Inc. All rights reserved
www.tibco.com