# tibemsConnectionFactory_SetServerURL

Function

## Purpose

Set the server URL.

## C Declaration

    tibems_status tibemsConnectionFactory_SetServerURL(
        tibemsConnectionFactory factory,
        const char* url );

## COBOL Call

    CALL "tibemsConnectionFactory_SetServerURL"
         USING BY VALUE factory,
               BY REFERENCE url,
               RETURNING tibems-status
    END-CALL.

Note: `factory` has usage pointer.

## Parameters

Parameter | Description
--- | ---
`factory` | Set the server URL of this connection factory.
`url` | The factory object contacts the EMS server at this URL, to access a corresponding factory defined by the administrator.

## Reconnect and Fault Tolerance

To enable reconnection behavior and fault tolerance, the connection factory’s server URL parameter must be a comma-separated list of two or more URLs. To enable client reconnection in a situation with only one server, you may supply two copies of that server’s URL (for example, `tcp://localhost:7222,tcp://localhost:7222`).

Note that `tibemsConnectionFactory_SetServerURL` can be used to set the server URL for a connection factory only once. If the URL has previously been set for the connection factory, `tibemsConnectionFactory_SetServerURL` returns the status code `TIBEMS_EXCEPTION`.

When specifying an IPv6 address, use square brackets around the address specification. For example, `tcp://[2001:cafe::107]:7222`.

Copyright © Cloud Software Group, Inc. All rights reserved.