Copyright © TIBCO Software Inc. All Rights Reserved

> tibemsAdmin_Create
> Function
> Purpose
> Create an administration connection to a server.
> C Declaration
> tibems_status tibemsAdmin_Create(
> tibemsAdmin* admin,
> const char* url,
> const char* userName,
> const char* password,
> tibemsSSLParams sslparams);
> COBOL Call
> CALL "tibemsAdmin_Create"
> USING BY REFERENCE admin,
> BY REFERENCE url,
> BY REFERENCE userName,
> BY REFERENCE password,
> BY VALUE sslParams,
> RETURNING tibems-status
> END-CALL.

> | sslParams has usage pointer.

> Parameters

> Parameter | Description
> admin | Store the new administrative connection in this location.
> url | Find the EMS server at this URL.
> userName | Authenticate the client program to the server with this username.
> password | Authenticate the client program to the server with this password.
> sslparams | Establish SSL communication using these parameters. See the section on SSL server parameters in the TIBCO Enterprise Message Service User’s Guide for more information.

> Status Codes

> Status Code | Description
> TIBEMS_SERVER_NOT_CONNECTED |
> • | 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.
> TIBEMS_SECURITY_EXCEPTION |
> • | The server rejected the connection because the username or password was invalid.
> • | SSL setup is incorrect.

Copyright © TIBCO Software Inc. All Rights Reserved