Copyright © TIBCO Software Inc. All Rights Reserved

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

> Parameters

> 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. If configuring a fault-tolerant client, enter two of more URLs, as described in Configuring C and COBOL Clients for Fault-Tolerant Connections.
> 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 on page 325

Copyright © TIBCO Software Inc. All Rights Reserved