# tibemsConnectionFactory_SetConnectAttemptTimeout

Function

## Purpose

Modify the connection timeout setting.

## C Declaration

    tibems_status tibemsConnectionFactory_SetConnectAttemptTimeout(
        tibemsConnectionFactory factory,
        tibems_int timeout );

## COBOL Call

    CALL "tibemsConnectionFactory_SetConnectAttemptTimeout"
         USING BY VALUE factory,
               BY VALUE timeout,
               RETURNING tibems-status
    END-CALL.

Note: `factory` has usage pointer.

## Parameters

Parameter | Description
--- | ---
`factory` | Set the connection timeout parameter of this connection factory.
`timeout` | This value determines the maximum time (in milliseconds) the client will wait for a connection to the server to be established. The minimum permitted timeout is 100 milliseconds. However, under stress conditions, this minimum may be too low to enable reliable connection creation. In such cases, a value of greater than 1000 is suggested. Zero is a special value, which specifies no timeout. Note that the maximum can be exceeded if the timeout is set to be less than 1000. If the value provided is less than 1000, the creation of the socket is subject to its own minimum of 1 second, which can impact the timeout. When this property is not set, the default value is 0.

## See Also

`tibemsConnectionFactory_SetConnectAttemptCount`

`tibemsConnectionFactory_SetConnectAttemptDelay`

"Setting Connection Attempts, Timeout and Delay Parameters" in the TIBCO Enterprise Message Service User’s Guide

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