WTCRemoteTuxDom

WTCRemoteTuxDom

Description

This interface provides access to the WTC remote Tuxedo Domain configuration attributes. The methods defined herein are applicable for WTC configuration at the WLS domain level.

Syntax
<WTCRemoteTuxDom


AccessPoint="String


AccessPointId="String


AclPolicy=( "GLOBAL" | "LOCAL" )


AllowAnonymous=( "true" | "false" )


AppKey=( "TpUsrFile" | "LDAP" | "Custom" )


CmpLimit="number


ConnPrincipalName="String


ConnectionPolicy=( "ON_DEMAND" | "ON_STARTUP" | "INCOMING_ONLY" | "LOCAL" )


CredentialPolicy=( "GLOBAL" | "LOCAL" )


CustomAppKeyClass="String


CustomAppKeyClassParam="String


DefaultAppKey="number


FederationName="String


FederationURL="String


LocalAccessPoint="String


MaxEncryptBits=( "0" | "40" | "56" | "128" )


MaxRetries="number


MinEncryptBits=( "0" | "40" | "56" | "128" )


NWAddr="String


Name="String


Notes="String


RetryInterval="number


TpUsrFile="String


TuxedoGidKw="String


TuxedoUidKw="String


Type="String



/>
Parent Elements

WTCServer

Attributes

Attribute

Description

Range of Values and Default
AccessPoint Defines a name used to identify a remote Tuxedo access point in a WTC Service. This name must be unique within defined Remote Tuxedo Access Points. This allows you to define unique configurations having the same Access Point ID. Admin Console field label: Access Point
AccessPointId Defines the connection name used to identify this remote Tuxedo access point when attempting to establish a session connection with a local Tuxedo access point. The AccessPointId of a WTCRemoteTuxDom MBean must match the corresponding DOMAINID in the *DM_LOCAL_DOMAINS section of your Tuxedo DMCONFIG file. Admin Console field label: Access Point ID
AclPolicy Defines the inbound access control list (ACL) policy toward requests from a remote Tuxedo access point.

If Interoperate is set to Yes, AclPolicy is ignored.

LOCAL: The local Tuxedo access point modifies the identity of service requests received from a given remote Tuxedo access point to the principal name specified in the local principal name for a given remote Tuxedo access point.

GLOBAL: The local Tuxedo access point passes the service request with no change in identity.
Admin Console field label: ACL PolicyRequired: noDefault: LOCALSecure value: "GLOBAL" or "LOCAL"
AllowAnonymous Specifies whether the anonymous user is allowed to access Tuxedo. If the anonymous user is allowed to access Tuxedo, the default AppKey will be used for for TpUsrFile and LDAP AppKey plug-ins. Interaction with the Custom AppKey plug-in depends on the design of the Custom AppKey generator. Admin Console field label: Allow AnonymousDefault: false
AppKey Specifies the type of AppKey plug-in used. You can choose from the following:
TpUsrFile.

LDAP.

Custom.
TpUsrFile is the default plug-in. It uses an imported Tuxedo TPUSR file to provide user security information. Previous releases of WebLogic Tuxedo Connector support this option.The LDAP plug-in utilizes an embedded LDAP server to provide user security information. The user record must define the Tuxedo UID and GID information in the description field. This functionality is not supported in previous releases of WebLogic Tuxedo Connector. The Custom plug-in provides the ability to write your own AppKey generator class to provide the security information required by Tuxedo. This functionality is not supported in previous releases of WebLogic Tuxedo Connector. Admin Console field label: AppKey GeneratorRequired: noDefault: TpUsrFile
CmpLimit Defines the compression threshold used when sending data to a local Tuxedo access point. Application buffers larger than this size are compressed. Admin Console field label: Cmp LimitDefault: 2³¹-1Minimum: 0Maximum: 2³¹-1
ConnPrincipalName Defines the principal name used to verify the identity of this remote Tuxedo access point when establishing a connection to a local Tuxedo access point.

This parameter only applies to domains of type TDOMAIN that are running BEA Tuxedo 7.1 or later software.

If not specified, the connection pricipal name defaults to the AccessPointID for this access point.
Note: ConnectionPrincipalName is not supported in this release. Admin Console field label: Connection Principal NameRequired: no
ConnectionPolicy Defines the conditions under which a remote Tuxedo access point tries to establish a connection to a local Tuxedo access point.

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.
Admin Console field label: Connection PolicyRequired: noDefault: ON_DEMAND
CredentialPolicy Defines the outbound access control list (ACL) policy toward requests to a remote Tuxedo access point.

If Interoperate is set to Yes, CredentialPolicy is ignored.

LOCAL: The remote Tuxedo access point controls the identity of service requests received from the local Tuxedo access point to the principal name specified in the local principal name for this remote Tuxedo access point.

GLOBAL: The remote Tuxedo access point passes the service request with no change.
Admin Console field label: Credential PolicyRequired: noDefault: LOCAL
CustomAppKeyClass Defines the full pathname to the Custom AppKey generator class. This class is loaded at runtime if the Custom AppKey generator plug-in is selected. Admin Console field label: Custom AppKey ClassRequired: no
CustomAppKeyClassParam Defines the optional parameters to be used by the Custom AppKey class at the class initialization time. Admin Console field label: Custom AppKey ParamRequired: no
DefaultAppKey The default AppKey value to be used by the anonymous user and other users who are not defined in the user database if the AppKey plug-in allows them to access Tuxedo. The TpUsrFile and LDAP plug-ins do not allow users that are not defined in user database to access Tuxedo unless Allow Anonymous is enabled. Admin Console field label: Default AppKeyDefault: -1
FederationName Defines the context at which to federate to a foreign name service. If omitted then the federation point is tuxedo.domains. Admin Console field label: Federation NameRequired: no
FederationURL Defines the URL for a foreign name service that is federated into JNDI. If omitted:

WebLogic Tuxedo Connector assumes there is a CosNaming server in the foreign domain.

WebLogic Tuxedo Connector federates to the CosNaming server using TGIOP.
WebLogic Tuxedo Connector can to federate to non-CORBA service providers. Admin Console field label: Federation URLRequired: no
LocalAccessPoint The local Tuxedo access point name from which a remote Tuxedo access point is reached. Admin Console field label: Local Access Point
MaxEncryptBits Defines the maximum encryption key length (in bits) used when establishing a session connection for a local Tuxedo access point.

A value of 0 indicates no encryption is used.

The value of the MaxEncryptBits attribute must be greater than or equal to the value of the MinEncrypBits attribute.

A MaxEncryptBits of 40 can be used only with domains running Tuxedo 7.1 or higher.
Admin Console field label: Max Encryption LevelRequired: noDefault: 128
MaxRetries Defines the number of times that a domain gateway tries to establish session connections to remote Tuxedo access points. Use only when Connection Policy is set to ON_STARTUP.

Use -1 to default to the value defined by the WTCLocalTuxDomMBean MaxRetries attribute.

Use 0 to disable the retry mechanism.

Use the maximum value to try until a connection is established.
Admin Console field label: Max RetriesDefault: -1Minimum: -1Maximum: 2⁶³-1
MinEncryptBits Defines the minimum encryption key length (in bits) used when establishing a session connection for a local Tuxedo access point.

A value of 0 indicates no encryption is used.

The value of the MinEncrypBits attribute must be less than or equal to the value of the MaxEncrypBits attribute.

A MinEncrypBits of 40 can be used only with domains running Tuxedo 7.1 or higher.
Admin Console field label: Min Encryption LevelRequired: noDefault: 0Secure value: "40"
NWAddr The network address and port number of this remote Tuxedo access point. Specify the TCP/IP address in one of the following formats:

//hostname:port_number

//#.#.#.#:port_number
If the hostname is used, the access point finds an address for hostname using the local name resolution facilities (usually DNS). If dotted decimal format is used, each # should be a number from 0 to 255. This dotted decimal number represents the IP address of the local machine. The port_number is the TCP port number at which the access point listens for incoming requests. Admin Console field label: Network AddressRequired: no
Name The name of this configuration. WebLogic Server uses an MBean to implement and persist the configuration. Required: no
Notes Optional information that you can include to describe this configuration. Required: no
RetryInterval Defines the number of seconds between automatic attempts to establish a session connection to remote Tuxedo access points.

Use only when Connection Policy is set to ON_STARTUP.

Use -1 to default to the value defined by the WTCLocalTuxDomMBean RetryInterval attribute.
Admin Console field label: Retry IntervalDefault: -1Minimum: -1Maximum: 2³¹-1
TpUsrFile The full path to the user password file containing UID/GID information. This file is generated by the Tuxedo tpusradd utility on the remote Tuxedo domain specified by the remote Tuxedo access point. A copy of this file must be available in your WebLogic Tuxedo Connector environment to provide correct authorization, authentication, and auditing. Admin Console field label: Tp User FileRequired: no
TuxedoGidKw Defines the keyword for Tuxedo GID (group id) used in the WlsUser when using the Tuxedo migration utility tpmigldap. The keyword is used to find Tuxedo GID in the user record in the embedded LDAP database. Admin Console field label: Tuxedo GID KeywordRequired: noDefault: TUXEDO_GID
TuxedoUidKw Defines the keyword for Tuxedo UID (user id) used in the WlsUser when using the Tuxedo migration utility tpmigldap. The keyword is used to find Tuxedo UID in the user record in the embedded LDAP database. Admin Console field label: Tuxedo UID KeywordRequired: noDefault: TUXEDO_UID
Type Returns the type of the MBean. Required: no

Attribute	Description	Range of Values and Default
AccessPoint	Defines a name used to identify a remote Tuxedo access point in a WTC Service. This name must be unique within defined Remote Tuxedo Access Points. This allows you to define unique configurations having the same Access Point ID.	Admin Console field label: Access Point
AccessPointId	Defines the connection name used to identify this remote Tuxedo access point when attempting to establish a session connection with a local Tuxedo access point. The AccessPointId of a WTCRemoteTuxDom MBean must match the corresponding DOMAINID in the *DM_LOCAL_DOMAINS section of your Tuxedo DMCONFIG file.	Admin Console field label: Access Point ID
AclPolicy	Defines the inbound access control list (ACL) policy toward requests from a remote Tuxedo access point. If Interoperate is set to Yes, AclPolicy is ignored. LOCAL: The local Tuxedo access point modifies the identity of service requests received from a given remote Tuxedo access point to the principal name specified in the local principal name for a given remote Tuxedo access point. GLOBAL: The local Tuxedo access point passes the service request with no change in identity.	Admin Console field label: ACL PolicyRequired: noDefault: LOCALSecure value: "GLOBAL" or "LOCAL"
AllowAnonymous	Specifies whether the anonymous user is allowed to access Tuxedo. If the anonymous user is allowed to access Tuxedo, the default AppKey will be used for for TpUsrFile and LDAP AppKey plug-ins. Interaction with the Custom AppKey plug-in depends on the design of the Custom AppKey generator.	Admin Console field label: Allow AnonymousDefault: false
AppKey	Specifies the type of AppKey plug-in used. You can choose from the following: TpUsrFile. LDAP. Custom. TpUsrFile is the default plug-in. It uses an imported Tuxedo TPUSR file to provide user security information. Previous releases of WebLogic Tuxedo Connector support this option.The LDAP plug-in utilizes an embedded LDAP server to provide user security information. The user record must define the Tuxedo UID and GID information in the description field. This functionality is not supported in previous releases of WebLogic Tuxedo Connector. The Custom plug-in provides the ability to write your own AppKey generator class to provide the security information required by Tuxedo. This functionality is not supported in previous releases of WebLogic Tuxedo Connector.	Admin Console field label: AppKey GeneratorRequired: noDefault: TpUsrFile
CmpLimit	Defines the compression threshold used when sending data to a local Tuxedo access point. Application buffers larger than this size are compressed.	Admin Console field label: Cmp LimitDefault: 2³¹-1Minimum: 0Maximum: 2³¹-1
ConnPrincipalName	Defines the principal name used to verify the identity of this remote Tuxedo access point when establishing a connection to a local Tuxedo access point. This parameter only applies to domains of type TDOMAIN that are running BEA Tuxedo 7.1 or later software. If not specified, the connection pricipal name defaults to the AccessPointID for this access point. Note: ConnectionPrincipalName is not supported in this release.	Admin Console field label: Connection Principal NameRequired: no
ConnectionPolicy	Defines the conditions under which a remote Tuxedo access point tries to establish a connection to a local Tuxedo access point. 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.	Admin Console field label: Connection PolicyRequired: noDefault: ON_DEMAND
CredentialPolicy	Defines the outbound access control list (ACL) policy toward requests to a remote Tuxedo access point. If Interoperate is set to Yes, CredentialPolicy is ignored. LOCAL: The remote Tuxedo access point controls the identity of service requests received from the local Tuxedo access point to the principal name specified in the local principal name for this remote Tuxedo access point. GLOBAL: The remote Tuxedo access point passes the service request with no change.	Admin Console field label: Credential PolicyRequired: noDefault: LOCAL
CustomAppKeyClass	Defines the full pathname to the Custom AppKey generator class. This class is loaded at runtime if the Custom AppKey generator plug-in is selected.	Admin Console field label: Custom AppKey ClassRequired: no
CustomAppKeyClassParam	Defines the optional parameters to be used by the Custom AppKey class at the class initialization time.	Admin Console field label: Custom AppKey ParamRequired: no
DefaultAppKey	The default AppKey value to be used by the anonymous user and other users who are not defined in the user database if the AppKey plug-in allows them to access Tuxedo. The TpUsrFile and LDAP plug-ins do not allow users that are not defined in user database to access Tuxedo unless Allow Anonymous is enabled.	Admin Console field label: Default AppKeyDefault: -1
FederationName	Defines the context at which to federate to a foreign name service. If omitted then the federation point is tuxedo.domains.	Admin Console field label: Federation NameRequired: no
FederationURL	Defines the URL for a foreign name service that is federated into JNDI. If omitted: WebLogic Tuxedo Connector assumes there is a CosNaming server in the foreign domain. WebLogic Tuxedo Connector federates to the CosNaming server using TGIOP. WebLogic Tuxedo Connector can to federate to non-CORBA service providers.	Admin Console field label: Federation URLRequired: no
LocalAccessPoint	The local Tuxedo access point name from which a remote Tuxedo access point is reached.	Admin Console field label: Local Access Point
MaxEncryptBits	Defines the maximum encryption key length (in bits) used when establishing a session connection for a local Tuxedo access point. A value of 0 indicates no encryption is used. The value of the MaxEncryptBits attribute must be greater than or equal to the value of the MinEncrypBits attribute. A MaxEncryptBits of 40 can be used only with domains running Tuxedo 7.1 or higher.	Admin Console field label: Max Encryption LevelRequired: noDefault: 128
MaxRetries	Defines the number of times that a domain gateway tries to establish session connections to remote Tuxedo access points. Use only when Connection Policy is set to ON_STARTUP. Use -1 to default to the value defined by the WTCLocalTuxDomMBean MaxRetries attribute. Use 0 to disable the retry mechanism. Use the maximum value to try until a connection is established.	Admin Console field label: Max RetriesDefault: -1Minimum: -1Maximum: 2⁶³-1
MinEncryptBits	Defines the minimum encryption key length (in bits) used when establishing a session connection for a local Tuxedo access point. A value of 0 indicates no encryption is used. The value of the MinEncrypBits attribute must be less than or equal to the value of the MaxEncrypBits attribute. A MinEncrypBits of 40 can be used only with domains running Tuxedo 7.1 or higher.	Admin Console field label: Min Encryption LevelRequired: noDefault: 0Secure value: "40"
NWAddr	The network address and port number of this remote Tuxedo access point. Specify the TCP/IP address in one of the following formats: //hostname:port_number //#.#.#.#:port_number If the hostname is used, the access point finds an address for hostname using the local name resolution facilities (usually DNS). If dotted decimal format is used, each # should be a number from 0 to 255. This dotted decimal number represents the IP address of the local machine. The port_number is the TCP port number at which the access point listens for incoming requests.	Admin Console field label: Network AddressRequired: no
Name	The name of this configuration. WebLogic Server uses an MBean to implement and persist the configuration.	Required: no
Notes	Optional information that you can include to describe this configuration.	Required: no
RetryInterval	Defines the number of seconds between automatic attempts to establish a session connection to remote Tuxedo access points. Use only when Connection Policy is set to ON_STARTUP. Use -1 to default to the value defined by the WTCLocalTuxDomMBean RetryInterval attribute.	Admin Console field label: Retry IntervalDefault: -1Minimum: -1Maximum: 2³¹-1
TpUsrFile	The full path to the user password file containing UID/GID information. This file is generated by the Tuxedo tpusradd utility on the remote Tuxedo domain specified by the remote Tuxedo access point. A copy of this file must be available in your WebLogic Tuxedo Connector environment to provide correct authorization, authentication, and auditing.	Admin Console field label: Tp User FileRequired: no
TuxedoGidKw	Defines the keyword for Tuxedo GID (group id) used in the WlsUser when using the Tuxedo migration utility tpmigldap. The keyword is used to find Tuxedo GID in the user record in the embedded LDAP database.	Admin Console field label: Tuxedo GID KeywordRequired: noDefault: TUXEDO_GID
TuxedoUidKw	Defines the keyword for Tuxedo UID (user id) used in the WlsUser when using the Tuxedo migration utility tpmigldap. The keyword is used to find Tuxedo UID in the user record in the embedded LDAP database.	Admin Console field label: Tuxedo UID KeywordRequired: noDefault: TUXEDO_UID
Type	Returns the type of the MBean.	Required: no