Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 7 Connection : tibemsConnection : tibemsConnection_Create

tibemsConnection_Create
Function
Purpose
Create a new connection to an EMS server.
C Declarations
tibems_status tibemsConnection_Create(
    tibemsConnection* connection,
    const char* brokerURL,
    const char* clientId,
    const char* username,
    const char* password );
 
tibems_status tibemsConnection_CreateSSL(
    tibemsConnection* connection,
    const char* brokerURL,
    const char* clientId,
    const char* username,
    const char* password,
    tibemsSSLParams sslParams,
    const char* pk_password );
COBOL Call
CALL "tibemsConnection_Create"
USING BY REFERENCE connection,
BY REFERENCE brokerURL,
BY REFERENCE clientId,
BY REFERENCE username,
BY REFERENCE password
RETURNING tibems-status
END-CALL.
 
CALL "tibemsConnection_CreateSSL"
USING BY REFERENCE connection,
BY REFERENCE brokerURL,
BY REFERENCE clientId,
BY REFERENCE username,
BY REFERENCE password,
BY VALUE tibemsSSLParams,
BY REFERENCE pk-password,
RETURNING tibems-status
END-CALL.
 
connection and sslParams have usage pointer.
On IBM z/OS systems, the pk-password must always be a null value.
Parameters
 
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.
See Also
tibemsConnectionFactory_Create on page 261
SSL Implementation on IBM EBCDIC Systems

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved