The Domains MIB describes the interaction between Oracle Tuxedo domains. The term access point defines an object through which you gain access to another object. Therefore, you access a remote domain through a remote domain access point, and remote domains gain access to a local domain through a local domain access point.
The tuxDmAclTable group contains objects that represent access control information for domains.
.1.3.6.1.4.1.140.300.80.1.1.10 .1.3.6.1.4.1.140.300.80.1.1.20 .1.3.6.1.4.1.140.300.80.1.1.30The list of remote domain access points associated with this access control list. tuxDmrAccessPointlist is a comma-separated list of remote access point names (that is, the value of the tuxDMRemoteDmAccessPoint object of a valid tuxDmRemote object). The list can contain up to 50 remote access point identifier elements. Setting the value of this object to “*” means that all the remote domains in the configuration are associated with this entry. blank string means no remote access points are associated with this entry. The default is - (equivalent of NULL string).This object denotes the current state of the tuxDmAcl instance.valid(1): tuxDmAcl object is defined and inactive. This state is the only valid state for this group. ACL groups are never active.invalid(2): Delete.The tuxDmConnectionTable group contains objects that represent the status of connections between domain access points.
.1.3.6.1.4.1.140.300.90.1.1.10 .1.3.6.1.4.1.140.300.90.1.1.20 .1.3.6.1.4.1.140.300.90.1.1.30 .1.3.6.1.4.1.140.300.90.1.1.40 .1.3.6.1.4.1.140.300.90.1.1.50The type of domain, such as tdomain.This object denotes the current state of the tuxDmConnection instance.active(1): The connection is active.suspended(2): The connection is awaiting retry.initializing(3): The connection is initializing.inactive(4): The specified domain access points are disconnected. (Returned in case of Tuxedo 7.1 and later only.)unknown(5): The state cannot be determined.active(1):Connect the specified domain access points. If the current state is suspended or inactive, SET:active places the connection into the state initializing, otherwise, there is no change.inactive(4): Disconnect the specified domain access points and destroy the tuxDmConnection objectThis object is available when tuxDmConDmType=tdomain.The tuxDmExportTable group contains objects that represent local resources that are exported to one or more remote domains through a local access point.
.1.3.6.1.4.1.140.300.100.1.1.10 .1.3.6.1.4.1.140.300.100.1.1.20 .1.3.6.1.4.1.140.300.100.1.1.30 .1.3.6.1.4.1.140.300.100.1.1.40 .1.3.6.1.4.1.140.300.100.1.1.50 .1.3.6.1.4.1.140.300.100.1.1.60 .1.3.6.1.4.1.140.300.100.1.1.70 .1.3.6.1.4.1.140.300.100.1.1.80 .1.3.6.1.4.1.140.300.100.1.1.90The local resource name for entries of resource type service (the service name), qspace (the queue space name), and qname (the queue name). For a service entry, the value of this object corresponds to the value of an active tuxTSrvGrp:tuxTsvcName object. This resource is exported to other domains with the same name or with the alias defined in the tuxDmExpDmRemoteName objects.This object denotes the current state of the tuxDmExport instance.valid(1): The object exists.invalid(2): Delete object.The name of a tuxDmAcl object to use for security on this local service. This object is not permitted if tuxDmExpDmResourceType=qname.For entries of type service or qspace, this object specifies the name exported through non-topend remote access points.Attributes available from remote access points of tuxDmExpDmResourceType=snax|ositp:type[:subtype] -Input buffer type, optionally followed by subtype.If this object is present, it defines the buffer type (and subtype) accepted. This object should be defined for entries of tuxDmExpDmResourceType=service when access is permitted from remote access points using ositp with the UDT application context, or when using snax. This object is not permitted if tuxDmExpDmResourceType=qspace.Attributes available from remote access points of tuxDmExpDmResourceType=snax|ositp:type[:subtype] -Output buffer type, optionally followed by subtype.If this object is present, it defines the buffer type (and subtype) output by the service. This object should be defined for entries of tuxDmExpDmResourceType=service when access is permitted from remote access points using ositp with the UDT application context, or when using snax. This object is not permitted if tuxDmExpDmResourceType=qspace and qname.The tuxDmImportTable group contains objects that represent remote resources that are imported through one or more remote domain access points and made available to the local domain through one or more local domain access points.
.1.3.6.1.4.1.140.300.110.1.1.10 .1.3.6.1.4.1.140.300.110.1.1.20 .1.3.6.1.4.1.140.300.110.1.1.30 .1.3.6.1.4.1.140.300.110.1.1.40 .1.3.6.1.4.1.140.300.110.1.1.50 .1.3.6.1.4.1.140.300.110.1.1.60 .1.3.6.1.4.1.140.300.110.1.1.70 .1.3.6.1.4.1.140.300.110.1.1.80 .1.3.6.1.4.1.140.300.110.1.1.90 .1.3.6.1.4.1.140.300.110.1.1.100 .1.3.6.1.4.1.140.300.110.1.1.110 .1.3.6.1.4.1.140.300.110.1.1.120 .1.3.6.1.4.1.140.300.110.1.1.130 .1.3.6.1.4.1.140.300.110.1.1.140 .1.3.6.1.4.1.140.300.110.1.1.150 .1.3.6.1.4.1.140.300.110.1.1.160 .1.3.6.1.4.1.140.300.110.1.1.170 .1.3.6.1.4.1.140.300.110.1.1.180 .1.3.6.1.4.1.140.300.110.1.1.190 .1.3.6.1.4.1.140.300.110.1.1.200The remote resource name used for entries of resource type service (the service name, qspace (the queue space name), and qname (the queue name). This resource is imported from remote domains with the same name or with the alias defined in the tuxDmImpDmRemoteName or tuxDmImpDmte* objects.valid(1): The object exists.invalid(2): The object is deleted. A state change is allowed in the active or suspended state and results in the invalid state.For entries of type service or qspace, this object specifies the name imported through non-topend remote access points.Transaction time value (in seconds) of transactions automatically started for this service or qspace. Transactions are started automatically when a request not in transaction mode is received and the tuxDmImpDmAutoTran object is set to yes.Attributes available from remote access points of tuxDmRemoteDmType=snax|ositp:type[:subtype] - Input buffer type, optionally followed by subtype. If this object is present, it defines the buffer type (and subtype) accepted. This object should be defined for entries of DMRESOURCETYPE=service when access is permitted to remote access points that use ositp with the UDT application context, or that use snax. This object is not permitted if tuxDmImpDmResourceType=qspace.Attributes available from remote access points of tuxDmRemoteDmType=snax|ositp:The tuxDmLocalTable group defines a local domain access point. A local domain access point is used to control access to local services exported to remote domains and to control access to remote services imported from remote domains.
This object value is an identifier unique within the scope of tuxDmLocal and tuxDmRemote entry names in the domain configuration.The type of domain: tdomain for an Oracle Tuxedo domain, ositp for an OSI domain, and snax for an SNA domain. The presence or absence of other objects depends on the value of this object.valid(1): The object exists.invalid(2): The object is deleted.Specifies the maximum wait time allowed for a blocking call. The value sets a multiplier of the SCANUNIT parameters specified in the tuxTdomain group. The value SCANUNIT * tuxDmLclDmBlockTime must be greater than or equal to SCANUNIT and less than 32,768 seconds. If this object is not specified, the default is set to the value of the tuxDmLclDmBlockTime object specified in the tuxTdomain object. A timeout always implies a failure of the affected request. Notice that the timeout specified for transactions in the tuxTdomain is always used when the request is issued within a transaction.The maximum number of simultaneous transactions allowed on this local domain access point. This number must be greater than or equal to the tuxTdomainMaxGTT object in the tuxTdomain group.INTEGER { none(1) | app-pw(2) | dm-pw(3) | dm-user-pw(4) | te-clear(5) | te-safe(6) | te-private(7)}Valid only when tuxDmRemoteDmType=tdomain. Application password-based security is enabled.Valid only when tuxDmRemoteDmType=tdomain. Domain password-based security is enabled.Valid only when tuxDmRemoteDmType=snax. Translation of principal names is enabled.The size in pages of the TLOG for this local domain access point. This size is constrained by the amount of space available on the device identified in tuxDmLclTlogDev.Attributes available when tuxDmRemoteDmType=tdomain.Means that a connection is attempted only when requested by either a client request to a remote service or an administrative “connect” command. The default setting for this object is on-demand. The on-demand policy provides the equivalent behavior to previous releases, in which this object was not explicitly available.The number of seconds between automatic attempts to establish a connection to remote domain access points. The minimum value is 0 and the maximum value is 2147483647. The default setting is 60. If tuxDmLclDmMaxRetry is set to 0, setting tuxDmLclDmRetryInterval is not allowed.This object is valid only when the tuxDmLclDmConnectionPolicy object is set to on-startup. For other connection policies, automatic retries are disabled.The number of times that a domain gateway tries to establish connections to remote domain access points. The minimum value is 0 and the maximum is MAXLONG. MAXLONG indicates that retry processing is repeated indefinitely, or until a connection is established. For a connection policy of on-startup, the default setting for tuxDmLclMaxRetry is MAXLONG. Setting this object to 0 turns off the auto retry mechanism. For other connection policies, auto retries are disabled.The tuxDmLclMaxRetry object is valid only when the connection policy is on-startup.The connection principal name identifier. This object value is the principal name used for verifying the identity of this local domain access point when establishing a connection to a remote domain access point. This object only applies to domains of type TDOMAIN that are running Oracle Tuxedo 7.1 or later software.This object can contain a maximum of 511 characters (excluding the terminating null character). If this object is not specified, the connection principal name defaults to the tuxDmLclDmAccessPointId string for this local domain access point.For default authentication plug-ins, if a value is assigned to this object for this local domain access point, it must be the same as the value assigned to the tuxDmLclAccessPointId object for this local domain access point. If these values do not match, the local domain gateway process does not boot and the system generates the following userlog(3c) message: “ERROR: Unable to acquire credentials”.Used for grouping domains so that encoding/decoding of messages between domains can be bypassed. If no value is specified, the default is to turn encoding/decoding on. If the value set for this object is the same in both the DM_LOCAL and the DM_REMOTE section of a domain configuration file, data encoding/decoding is bypassed. The value set for this object can be any string value up to 15 characters in length. The value is used only for comparison.This object is valid only when tuxDmRemoteDmType=tdomain.The tuxDmOsitpTable group contains objects that define the OSI TP protocol-related configuration information for a specific local or remote domain access point.
The domain access point name for which this entry provides the protocol-specific configuration information. This object matches the domain access point name given in the tuxDmLocal or tuxDmRemote entry that defines the protocol-independent configuration of the domain access point.valid(1): The object exists.invalid(2): The object is deleted.The application context name to use with this domain access point. When you establish a dialogue to a remote domain access point, use the application context name from the remote domain access point, if it is present. If the application context name from the remote domain access point is absent, use the application context name from the local domain access point. The value xatmi selects the use of the X\Open-defined xatmi Application Service Element (ASE) and encoding. The value udt selects the use of the ISO/IEC 10026-5 User Data Transfer encoding.This object specifies the version of the XATMI protocol used to communicate with a remote system. Valid values are: cae, preliminary, and oltp-tm2200.The tuxDmPasswordTable group contains objects that represent configuration information for inter-domain authentication through access points of type tdomain.
The local password used to authenticate connections between the local domain access point identified by tuxDmPasswdDmlAccessPoint and the remote domain access point identified by tuxDmPasswdDmrAccessPoint.The remote password used to authenticate connections between the local domain access point identified by tuxDmPasswdDmlAccessPoint and the remote domain access point identified by tuxDmPasswdDmrAccessPoint.valid(1): The object exists.invalid(2): The object is deleted.recrypt(3): Re-encrypt all passwords using a new encryption key.The tuxDmPrincipalMapTable group contains objects that represent configuration information for mapping principal names to and from external principal names across access point of type snax.
This object denotes the current state of the tuxDmPrincipalMap instance.valid(1): The object exists.invalid(2): The object is deleted.The tuxDmRemoteTable group contains objects that represent remote domain access point configuration information. Local resources that can be exported through one or more local domain access points are made accessible to a remote domain through a remote domain access point. Similarly, remote resources are imported from a remote domain through a remote domain access point.
The name of this tuxDmRemote entry. This object value is an identifier unique within the scope of tuxDmLocal and tuxDmRemote entry names in the domain configuration.This object denotes the current state of the tuxDmRemote instance.valid(1): The object exists.invalid(2): The object is deleted.Attributes available when tuxDmRemoteDmType=snax. The name of the default translation tables to use when translating requests and replies that are sent through this access point.Attributes available when tuxDmRemoteDmType=tdomain.These objects are used for grouping domains so that encoding/decoding of messages between domains can be bypassed. If it is not specified, the default is to turn encoding/decoding on. If the value set for this object is the same in both the DM_LOCAL and the DM_REMOTE sections of a domain configuration file, data encoding/decoding is bypassed. The value set for this object can be any string value up to 15 characters in length. The object value is used only for comparison.The tuxDmResourcesTable group contains an object that represents Domains-specific configuration information.
The tuxDmRoutingTable group contains objects that represent routing criteria information for routing requests to a domain through a remote domain access point.
The type can be char, short, long, float, double, or string. Only one type is allowed. This object value is used only for routing XML buffers.This object includes the ranges and associated server groups for the tuxDmRoutingFieldType routing field. The format of the string is a comma-separated, ordered list of range/group name pairs. A range/group pair has the following format:where lower and upper are assigned numeric values or character strings in single quotes. lower must be less than or equal to upper. To embed a single quote in a character string value, the quote must be preceded by two backslashes (for example, ‘O\\’Brien’). The value MIN can be used to indicate the minimum value for the data type of the associated field on the machine. The value MAX can be used to indicate the maximum value for the data type of the associated field on the machine. Thus, “MIN-5” is all numbers less than or equal to -5, and “6-MAX” is all numbers greater than or equal to 6.String range values for string, carray, and character field types must be placed inside a pair of single quotes, and cannot be preceded by a sign. The short and long integer values are a string of digits, optionally preceded by a plus or minus sign. Floating point numbers are of the form accepted by the C compiler or atof(3): an optional sign, then a string of digits (that optionally contains a decimal point), then an optional e or E followed by an optional sign or space, followed by an integer.The raccesspoint parameter indicates the remote domain access point to which the request is routed if the field matches the range. A raccesspoint of “*” indicates that the request can go to any remote domain access point that imports the desired service.This object denotes the current state of the tuxDmRouting instance.valid(1): The object exists.invalid(2): The object is deleted.The tuxDmrPrincipalTable group contains objects that represent password configuration information for remote principal names.
The remote password used for the principal name when communicating through the remote domain access point identified in tuxDmrPrincipalDmrAccessPoint.This object denotes the current state of the tuxDmrPrincipal instance.valid(1): The object exists.invalid(2): The object is deleted.The tuxDmSnaCRMTable group defines the SNM-CRM-specific configuration information for the named local domain access point.
This object denotes the current state of the tuxDmSnaCRM instance.valid(1): The object exists.invalid(2): The object is deleted.The tuxDmSnaLinkTable group contains objects that represent snax-specific configuration information for a remote domain access point.
The name of the snax stack entry to be used to reach this remote domain access point.Identifies the remote domain access point name for which this entry provides the snax configuration data.This object denotes the current state of the tuxDmSnaLink instance.valid(1): The object exists.invalid(2): The object is deleted.Specifies the type of SNA security to be used on sessions to the remote logical unit. Valid values for this object are local, identify, verify, persistent, and mixidpe.The SNACRM, in conjunction with the domain gateway, chooses whether to COLDSTART or WARMSTART the LU.Forces a COLDSTART with the LU.The tuxDmSnaStackTable group defines an SNA stack to be used by a specific SNA CRM.
The name of this tuxDmSnaStack entry. This object is an identifier, unique within the scope of the tuxDmSnaStackTable in the domain configuration.Identifies the tuxDmSnaCRM table entry of the SNA CRM in which this SNA protocol stack definition is used.This object denotes the current state of the tuxDmSnaStack instance.valid(1): The object exists.invalid(2): The object is deleted.The tuxDmTdomainTable group defines the domain-specific configuration for a local or remote domain access point.
When domain-level failover is in use, more than one tuxDmTdomainTable entry can be defined with the same tuxTDmTdomainDmAccessPoint.The value of this object must be unique across all tuxDmTdomainTable objects.This object denotes the current state of the tuxDmTdomain instance.valid(1): The object exists.invalid(2): Delete the object.If this minimum level of encryption is not met, link establishment fails. The default value is enc-0-bit.The default value is enc-128-bits.The tuxDmTransactionTable group contains objects that represent information about transactions that span domains. This object can be used to find out what remote domain access points are involved in the transaction, the parent domain access point, the transaction state, and other information.
The name of the local domain access point with which the transaction is associated. This object is a required field for GET operations. For SET operations, this object must be specified.The transaction identifier returned from tpsuspend(3c) mapped to a string representation. The data in this field should not be interpreted directly by the user, except for equality comparison. For SET operations, this object must be specified.This object denotes the current state of the tuxDmTransaction instance.aborted(1): The transaction is being rolled back.abortonly(2): The transaction has been identified for rollback.active(3): The transaction is active.comcalled(4): The transaction has initiated the first phase of commitment.decided(5): The transaction has initiated the second phase of commitment.done(6): The transaction has completed the second phase of commitment.habort(7): The transaction has been heuristically rolled back.hcommit(8): The transaction has been heuristically committed.heuristic(9): The transaction commitment or rollback has completed heuristically.ready(10): The transaction has completed the first phase of a two-phase commit. All the participating groups and remote domains have completed the first phase of commitment and are ready to be committed.unknown(11): It was not possible to determine the state of the transaction.invalid(12): Forget the specified table entry. This state change is only valid in states HCOmmit and HABort.The index of the first branch-specific object values (tuxDmTransactionDmBranchNo, tuxDmTransactionDmrAccessPoint, tuxDmTransactionDmNetTranID, and tuxDmTransactionDmBranchState) corresponding to this object.The external transaction identifier used with the remote domain access point for this branch. Some types of domain gateways do not return this information; in this scenario, this object is set to the empty string. For example, TDomains uses the local transaction identifier in tuxDmTransactionDmTpTranID for branches to remote domain access points and sets this value to the empty string.A GET operation retrieves run-time information for the transaction branch (when the information is available for a particular domain gateway type).ABorteD(1): The transaction branch is being rolled back.ABortonlY(2): The transaction branch has been identified for rollback.ACTive(3): The transaction branch is active.COMcalled(4): The transaction branch has initiated the first phase of commitment.DECided(5): The transaction branch has initiated second phase of commitment.DONe(6): The transaction branch has completed the second phase of commitment.HABort(7): The transaction has been heuristically rolled back.HCOmmit(8): The transaction has been heuristically committed.Heuristic HaZard(9): Communications for the transaction branch failed and it has not been determined if rollback completed successfully.Heuristic MIxed(10): The transaction commitment or rollback for the transaction branch has completed and the remote domain has reported that the state of some of the resources used for the commitment or rollback is not consistent with the outcome of the transaction.REAdy 11): The transaction has completed the first phase of a two-phase commit. All the participating groups and remote domains have completed the first phase of commitment and are ready to be committed.UNKnown(12): The state of the transaction could not be determined.