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.
Note: 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 TLS communication using these parameters.

See TLS 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 TLS and TCP protocols.
  • Other error situations are possible.
TIBEMS_SECURITY_EXCEPTION
  • The server rejected the connection because the username or password was invalid.
  • TLS setup is incorrect.