File Formats, Data Descriptions, MIBs, and System Processes Reference
The T_DM_TDOMAIN
class defines the TDomain specific configuration for a local or remote domain access point.
TA_DMACCESSPOINT(r)(k)(*) |
||||
TA_DMNWADDR(r)(k)(*) |
||||
TA_STATE(r) |
||||
TA_DMLACCESSPOINT(r)(k)(*) |
||||
(r)—required when a new object is created |
TA_DMCONNECTION_POLICY
value for a local domain access point is TA_DMCONNECTION_POLICY
value specified in the T_DM_LOCAL
class.The local or remote domain access point name for which this entry provides the TDomain-specific configuration data.
When Domains link-level failover is in use, more than one T_DM_TDOMAIN
class entry can be defined with the same TA_DMACCESSPOINT
attribute value.
TA_DMNWADDR
: string
[1..256] (up to 78 bytes for BEA Tuxedo 8.0 or earlier)
Specifies the network address associated with the access point. For a local domain access point, this attribute supplies the address to be used for listening for incoming connections. For a remote domain access point, this attribute supplies the destination address to be used when connecting to a remote domain access point. The value of this field must be unique across all T_DM_TDOMAIN
entries.
A SET
operation updates configuration information for the selected T_DM_TDOMAIN
object. The following states indicate the meaning of a TA_STATE
set in a SET
request. States not listed may not be set.
Specifies the network device to be used. For a local domain access point, this attribute specifies the device to be used for listening. For a remote domain access point, this attribute specifies the device to be used when connecting to the remote domain access point.
Relevant to remote domain access points only. Threshold message at which compression occurs for traffic to this access point.
Relevant to remote domain access points only. When establishing a connection to this access point, this attribute specifies the minimum level of encryption required. "0"
means no encryption, while "40"
, "56"
, and "128"
specify the encryption length (in bits). If this minimum level of encryption is not met, link establishment fails. The default is "0"
.
The value of 40 bits is provided for backward compatibility.
Note: Modifications to this attribute do not affect established connections.
Relevant to remote domain access points only. When establishing a network link to this access point, this attribute specifies the maximum level of encryption allowed. "0"
means no encryption, while "40"
, "56"
, and "128"
specify the encryption length (in bits). The default is "128"
.
The value of 40 bits is provided for backward compatibility.
Note: Modifications to this attribute do not affect established connections.
TA_DMCONNECTION_POLICY
=
"
{LOCAL
| ON_DEMAND
| ON_STARTUP
| INCOMING_ONLY
}"
Specifies the conditions under which the TDomain gateway associated with this local or remote domain access point tries to establish connections. Supported values are "LOCAL"
, "ON_DEMAND"
, "ON_STARTUP"
, or "INCOMING_ONLY"
. "LOCAL"
is relevant only to remote domain access points.
The TA_DMCONNECTION_POLICY
attribute is available in the T_DM_TDOMAIN
class when running BEA Tuxedo 8.1 or later software. Its value in the T_DM_TDOMAIN
class for a particular local or remote domain access point takes precedence over its global value in the T_DM_LOCAL
class. The ability to override the global connection policy enables you to configure connection policy on a per remote domain basis.
Specifying no connection policy for a local domain access point defaults to the global connection policy specified in the T_DM_LOCAL
class. If you choose to specify a global connection policy in the T_DM_TDOMAIN
class, do not specify a global connection policy in the T_DM_LOCAL
class.
A connection policy of "LOCAL"
means that a remote domain access point accepts the global connection policy specified in the T_DM_LOCAL
class. "LOCAL"
is the default connection policy for remote domain access points. Excluding "LOCAL"
, the connection policy value for a remote domain access point takes precedence over the connection policy value for a local domain access point.
A connection policy of "ON_STARTUP"
means that the TDomain gateway attempts to establish a connection at gateway server initialization time. For "ON_STARTUP"
, the remote services for a particular remote domain (that is, services advertised by the TDomain gateway) are advertised only if a connection is successfully established to the remote domain. Thus, if there is no active connection to the remote domain, the remote services are suspended. By default, this connection policy retries failed connections every 60 seconds, but you can specify a different value for this interval using the TA_DMRETRY_INTERVAL
attribute in the T_DM_TDOMAIN
class. Also, see the TA_DMMAXRETRY
attribute in this class.
A connection policy of "INCOMING_ONLY"
means that the TDomain gateway does not attempt an initial connection upon startup and that remote services are initially suspended. The TDomain gateway is available for incoming connections from a remote domain, and remote services are advertised when the gateway receives an incoming connection or an administrative connection (using the dmadmin(1)
connect
command) is made. Connection retry processing is not allowed when the connection policy is "INCOMING_ONLY"
.
Specifies or requests failover sequences and primary records for a TDomain session record in the BDMCONFIG
file. If a DM_MIB SET
request does not specify a TA_DMFAILOVERSEQ
value or a DM_MIB SET TA_DMFAILOVERSEQ
request is from Tuxedo releases prior to 9.0, the output TDomain session record in the BDMCOMFIG
file uses the default FAILOVERSEQ =
-1.
The record with the lowest FAILOVERSEQ
value is the primary record for that TDomain session. There is only one primary record for a TDomain session, all remaining records for the same TDomain session are called secondary/backup records. With the exceptions of NWADDR
, NWDEVICE
, and FAILOVERSEQ
, the primary record is the source for all TDomain session configuration parameters and attributes. All other parameters and attributes listed in secondary/backup records are ignored.
Based on the CONNECTION_POLICY
attribute you select, the local domain will try to connect to a TDomain session's primary record. If the primary record has a failover, it will then try to connect to the next sequential secondary/backup record. If all secondary record connections fail, it will retry the primary record information at a later time as determined by RETRY_INTERVAL
until MAXRETRY
is exhausted.
Specifies or requests a local domain access point found in the DM_LOCAL
section for a TDomain session record in the BDMCONFIG
file. The TA_DMLACCESSPOINT
parameter is used exclusively to define TDomain session gateways and can contain only one local domain accesspoint as its value.
If a DM_MIB SET
request does not specify a TA_DMLACCESSPOINT
value or a DM_MIB SET TA_DMLACCESSPOINT
request is from Tuxedo releases prior to 9.0, the output TDomain session record in the BDMCOMFIG
file uses the default LACCESPOINT ="*".
Note: DM_MIB
does not allow regular expression use with TA_DMLACCESSPOINT
.
The number of times that the TDomain gateway associated with this local or remote domain access point tries to establish a connection. This attribute is available in the T_DM_TDOMAIN
class when running BEA Tuxedo 8.1 or later software, and is valid when the TA_DMCONNECTION_POLICY
attribute for this access point is set to "ON_STARTUP"
. For other connection policies, automatic retries are disabled.
The minimum value for TA_DMMAXRETRY
is 0, and the maximum value is MAXLONG
(2147483647). MAXLONG
, the default, indicates that retry processing will be repeated indefinitely, or until a connection is established.
The number of seconds that the TDomain gateway associated with this local or remote domain access point waits between automatic attempts to establish a connection. This attribute is available in the T_DM_TDOMAIN
class when running BEA Tuxedo 8.1 or later software, and is valid when the TA_DMCONNECTION_POLICY
attribute for this access point is set to "ON_STARTUP"
. For other connection policies, automatic retries are disabled.
The minimum value for TA_DMRETRY_INTERVAL
is 0, and the maximum value is MAXLONG
(2147483647). The default is 60. If TA_DMMAXRETRY
is set to 0, setting TA_DMRETRY_INTERVAL
is not allowed.
Enables TCP-level keepalive for this local or remote domain access point. Supported values are "LOCAL"
, "NO"
, or "YES"
. "LOCAL"
is relevant only to remote domain access points.
The TA_DMTCPKEEPALIVE
attribute applies only to domain gateways of type TDOMAIN
running BEA Tuxedo 8.1 or later software. Its value for a remote domain access point takes precedence over its value for a local domain access point. The ability to override the local domain access point value enables you to configure TCP-level keepalive on a per remote domain basis.
A value of "LOCAL"
means that a remote domain access point accepts the TCP-level keepalive value defined for the local domain access point. "LOCAL"
is the default TCP-level keepalive value for remote domain access points.
A value of "NO"
means that TCP-level keepalive is disabled for this access point. "NO"
is the default TCP-level keepalive value for local domain access points.
A value of "YES"
means that TCP-level keepalive is enabled for this access point. When TCP-level keepalive is enabled for a connection, the keepalive interval used for the connection is the system-wide value configured for the operating system's TCP keepalive timer. This interval is the maximum time that the TDomain gateway will wait without receiving any traffic on the connection. If the maximum time is exceeded, the gateway sends a TCP-level keepalive request message. If the connection is still open and the remote TDomain gateway is still alive, the remote gateway responds by sending an acknowledgement. If the local TDomain gateway does not receive an acknowledgement within a fixed period of time of sending the request message, it assumes that the connection is broken and releases any resources associated with the connection.
Not only does TCP-level keepalive keep BEA Tuxedo interdomain connections open during periods of inactivity, but it also enable TDomain gateways to quickly detect connection failures.
Controls application-level keepalive for this local or remote domain access point. This value must be greater than or equal to -1 and less than or equal to 2147483647. The value -1 is relevant only to remote domain access points.
The TA_DMKEEPALIVE
attribute applies only to domain gateways of type TDOMAIN
running BEA Tuxedo 8.1 or later software. Its value for a remote domain access point takes precedence over its value for a local domain access point. The ability to override the local domain access point value enables you to configure application-level keepalive on a per remote domain basis.
A value of -1 means that a remote domain access point accepts the application-level keepalive value defined for the local domain access point. -1 is the default application-level keepalive value for remote domain access points.
A value of 0 means that application-level keepalive is disabled for this access point. 0 is the default application-level keepalive value for local domain access points.
A value greater than or equal to 1 and less than or equal to 2147483647, in milliseconds, currently rounded up to the nearest second by the Domains software, means that application-level keepalive is enabled for this access point. The time that you specify is the maximum time that the TDomain gateway will wait without receiving any traffic on the connection. If the maximum time is exceeded, the gateway sends an application-level keepalive request message. If the connection is still open and the remote TDomain gateway is still alive, the remote gateway responds by sending an acknowledgement. If the local TDomain gateway does not receive an acknowledgement within a configurable period of time (see the TA_DMKEEPALIVEWAIT
attribute) of sending the request message, it assumes that the connection is broken and releases any resources associated with the connection.
Not only does application-level keepalive keep BEA Tuxedo interdomain connections open during periods of inactivity, but it also enable TDomain gateways to quickly detect connection failures.
Specifies the maximum time for this local or remote domain access point that the TDomain gateway will wait without receiving an acknowledgement to a sent keepalive message. This value must be greater than or equal to 0 and less than or equal to 2147483647, in milliseconds, currently rounded up to the nearest second by the Domains software. The default is 0. This attribute applies only to domain gateways of type TDOMAIN
running BEA Tuxedo 8.1 or later software.
If TA_DMKEEPALIVE
is 0 (keepalive disabled) for this access point, setting TA_DMKEEPALIVEWAIT
has no effect.
If TA_DMKEEPALIVE
is enabled for this access point and TA_DMKEEPALIVEWAIT
is set to a value greater than TA_DMKEEPALIVE
, the local TDomain gateway will send more than one application-level keepalive message before the TA_DMKEEPALIVEWAIT
timer expires. This combination of settings is allowed.
If TA_DMKEEPALIVE
is enabled for this access point and TA_DMKEEPALIVEWAIT
is set to 0, receiving an acknowledgement to a sent keepalive message is unimportant: any such acknowledgement is ignored by the TDomain gateway. The gateway continues to send keepalive messages every time the TA_DMKEEPALIVE
timer times out. Use this combination of settings to keep an idle connection open through a firewall.
Deleting an instance of this class or updating the TA_DMNWDEVICE
attribute of an instance of this class is not permitted in the following scenarios:
GWADM
) server for the local access point is active.GWADM
) server is active.