tibemsLookupContext_Create


Function

Purpose

Create a new EMS lookup context object.

C Declaration

tibems_status tibemsLookupContext_Create( 
    tibemsLookupContext* context, 
    const char* brokerURL, 
    const char* username, 
    const char* password ); 
 
tibems_status tibemsLookupContext_CreateSSL( 
    tibemsLookupContext* context, 
    const char* brokerURL, 
    const char* username, 
    const char* password, 
    tibemsSSLParams sslParams, 
    const char* pk_password ); 

COBOL Call

CALL "tibemsLookupContext_Create" 
     USING BY REFERENCE context, 
           BY REFERENCE brokerURL, 
           BY REFERENCE username, 
           BY REFERENCE password, 
           RETURNING tibems-status 
END-CALL. 
 
CALL "tibemsLookupContext_CreateSSL" 
     USING BY REFERENCE context, 
           BY REFERENCE brokerURL, 
           BY REFERENCE username, 
           BY REFERENCE password, 
           BY VALUE sslParams, 
           BY REFERENCE pk-password, 
           RETURNING tibems-status 
END-CALL. 

context and sslParams have usage pointer.

Parameter
Description
context
The function stores the new lookup context object in this location.
brokerURL
The context object connects to the EMS server at this URL.
username
The context object identifies itself to the server with this user name.
password
The context object identifies itself to the server with this password.
sslParams
The context object uses this data to create an SSL connection to the EMS server.
pk_password
The context object uses this password to decrypt its SSL private key.

Remarks

The first call produces a lookup context that communicates with server without encryption. The second call produces a lookup context that communicates using an SSL connection.

If the server permits anonymous lookup, you may supply null values for the username and password parameters.

See Also

tibemsLookupContext_CreateExternal


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