> # Remote Tuxedo Access Points: Connections

> Configuration Options Related Tasks Related Topics

> Use this page to define the connection configuration of a remote Tuxedo access point that will be used with this WTC server.

> #### Configuration Options

> Name | Description
> --- | ---
> Connection Policy | The conditions under which this remote Tuxedo access point establishes a session connection with a local Tuxedo access point. The allowed values are:

> - ON_DEMAND: A connection is attempted only when requested by either a client request to a remote service or an administrative connect command.

> - ON_STARTUP: A domain gateway attempts to establish a connection with its remote Tuxedo access points at gateway server initialization time. Remote services (services advertised in JNDI by the domain gateway for this local Tuxedo access point) are advertised only if a connection is successfully established to that remote Tuxedo access point. If there is no active connection to a remote Tuxedo access point, then the remote services are suspended. By default, this connection policy retries failed connections every 60 seconds. Use the MaxRetry and RetryInterval attributes to specify application specific values.

> - INCOMING_ONLY: A domain gateway does not attempt an initial connection to remote Tuxedo access points at startup and remote services are initially suspended. The domain gateway is available for incoming connections from remote Tuxedo access points and remote services are advertised when the domain gateway for this local Tuxedo access point receives an incoming connection. Connection retry processing is not allowed.

> - LOCAL: Specifies that the remote domain connection policy is explicitly defaulted to the local domain ConnectionPolicy attribute value.

> MBean Attribute:
> `WTCRemoteTuxDomMBean.ConnectionPolicy`

> Connection Principal Name | The principal name used to verify the identity of this remote Tuxedo access point when it establishes a session connection with a local Tuxedo access point. If not specified, the connection principal name defaults to the AccessPointID for this access point.

> Note: This parameter only applies to domains of type TDOMAIN that are running Oracle Tuxedo 7.1 or later software.

> Note: ConnPrincipalName is not supported in this release.

> MBean Attribute:
> `WTCRemoteTuxDomMBean.ConnPrincipalName`

> Retry Interval | The number of seconds that this remote Tuxedo access point waits between automatic connection attempts to local Tuxedo access points. Use this only when the ConnectionPolicy value is set to `ON_STARTUP`. Range of Values: Between `-1` and a positive 32-bit integer.

> Note: When the ConnectionPolicy value is `LOCAL`, the RetryInterval value from the local Tuxedo access point is used. When the ConnectionPolicy value is `ON_STARTUP`, a value of `-1` indicates 60.

> MBean Attribute:
> `WTCRemoteTuxDomMBean.RetryInterval`

> Minimum value: `-1`

> Maximum value: `2147483647`

> Max Retries | The maximum number of times that this remote Tuxedo access point tries to establish a session connections to local Tuxedo access points. Use only when the ConnectionPolicy value is set to `ON_STARTUP`. Note: When the ConnectionPolicy value is `LOCAL`, the MaxRetries value from the local Tuxedo access point is used. When the ConnectionPolicy value is `ON_STARTUP`, a value of `-1` indicates 9223372036854775807.

> Range of Values: Between `-1` and a positive 64-bit integer.

> - Use `0` to disable the retry mechanism.

> - Use the maximum value to try until a connection is established.

> MBean Attribute:
> `WTCRemoteTuxDomMBean.MaxRetries`

> Minimum value: `-1`

> Maximum value: `9223372036854775807`

> Cmp Limit | The compression threshold this remote Tuxedo access point uses when sending data to a local Tuxedo access point. Application buffers larger than this size are compressed. Range of Values: Between `0` and a positive 32-bit integer. MBean Attribute:
> `WTCRemoteTuxDomMBean.CmpLimit`

> Minimum value: `0`

> Maximum value: `2147483647`

> Keep Alive | Indicates whether this remote Tuxedo access point is configured with Application Level Keep Alive.

> - Greater than 0: Application Level Keep Alive is enabled and the value indicates the amount of idle time, in milliseconds rounded to the nearest second, allowed before starting the wait timer.

> - 0: Application Level Keep Alive is not enabled for the access point.

> - -1: Application Level Keep Alive is enabled and indicates that the value from the local Tuxedo access point is used to indicate the amount of idle time, in milliseconds rounded to the nearest second, allowed before starting the wait timer.

> MBean Attribute:
> `WTCRemoteTuxDomMBean.KeepAlive`

> Minimum value: `-1`

> Maximum value: `2147483647`

> Keep Alive Wait | Indicates whether this remote Tuxedo access point requires the acknowledgement of Application Level Keep Alive. If the value is:

> - Greater than 0: Application Level Keep Alive is enabled and the value indicates the amount of idle time, in milliseconds rounded to the nearest second, allowed before WebLogic Tuxedo Connector marks the connection as failed if the heartbeat is not acknowledged.

> - 0: Application Level Keep Alive is not enabled for the access point but the access point acknowledges if a heartbeat is received.

> MBean Attribute:
> `WTCRemoteTuxDomMBean.KeepAliveWait`

> Minimum value: `0`

> Maximum value: `2147483647`

> Related Tasks

> - Configure connections for remote access points

> Related Topics

> - Configuring Oracle WebLogic Tuxedo Connector