Administration Console Online Help

Previous Next Open TOC in new window
Content starts here

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

Related Topics


Back to Top