# 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 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 © Cloud Software Group, Inc. All rights reserved.