Table of Contents Previous Next PDF


Domains MIB

Domains MIB
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 Domains MIB consists of the following groups.
 
tuxDmAclTable
The tuxDmAclTable group contains objects that represent access control information for domains.
 
tuxDmAclName
Syntax
DisplayString (SIZE(1..15))
Access
read-only
Description
The access control list name.
tuxDmrAccessPointList
Syntax
DisplayString (SIZE(1..1000))
Access
read-write
Description
The 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).
tuxDmAclState
Syntax
INTEGER { valid(1) | invalid(2) }
Access
read-write
Description
This object denotes the current state of the tuxDmAcl instance.
GET requests:
valid(1): tuxDmAcl object is defined and inactive. This state is the only valid state for this group. ACL groups are never active.
SET requests:
invalid(2): Delete.
tuxDmConnectionTable
The tuxDmConnectionTable group contains objects that represent the status of connections between domain access points.
 
tuxDmConDmlAccessPoint
Syntax
DisplayString (SIZE(1..24))
Access
read-only
Description
The name of the local domain access point that identifies the connection between the domains.
tuxDmConDmrAccessPoint
Syntax
DisplayString (SIZE(1..24))
Access
read-only
Description
The name of the remote domain access point that identifies the connection between the domains
tuxDmConDmType
Syntax
INTEGER { tdomain(1)}
Access
read-only
Description
The type of domain, such as tdomain.
tuxDmConState
Syntax
INTEGER { active(1) | suspended(2) | initializing(3) | inactive(4) | unknown(5)}
Access
read-only
Description
This object denotes the current state of the tuxDmConnection instance.
GET requests:
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.
SET requests:
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 object
tuxDmConDmCurEncryptBits
Syntax
INTEGER { enc-0-bit(1) | enc-40-bits(2) | enc-56-bits(3) | enc-128-bits(4)}
Access
read-only
Description
This object is available when tuxDmConDmType=tdomain.
The level of encryption in use on this connection:
enc-0-bit(1)
No encryption
enc-40-bits(2), enc-56-bits(3), and enc-128-bits(4)
These values specify the encryption length (in bits).
tuxDmExportTable
The tuxDmExportTable group contains objects that represent local resources that are exported to one or more remote domains through a local access point.
 
tuxDmExpDmResourceName
Syntax
DisplayString (SIZE(1..15))
Access
read-only
Description
The 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.
tuxDmExpDmlAccessPoint
Syntax
DisplayString (SIZE(1..30))
Access
read-only
Description
The local access point name. Setting this object to “*” means the resource is available at all local access points.
tuxDmExpState
Syntax
INTEGER { valid(1) | invalid(2) }
Access
read-write
Description
This object denotes the current state of the tuxDmExport instance.
GET requests:
valid(1): The object exists.
SET requests:
invalid(2): Delete object.
tuxDmExpDmAclName
Syntax
DisplayString (SIZE(1..15))
Access
read-write
Description
The name of a tuxDmAcl object to use for security on this local service. This object is not permitted if tuxDmExpDmResourceType=qname.
tuxDmExpDmConv
Syntax
INTEGER { yes(1) | no(2) }
Access
read-only
Description
Specifies whether this local service is conversational or not.
tuxDmExpDmResourceType
Syntax
INTEGER { service(1) | qspace(2) | qname(3)}
Access
read-only
Description
Specifies whether this entry is for a service, qspace, or qname. The default is service.
tuxDmExpDmRemoteName
Syntax
DisplayString (SIZE(1..127))
Access
read-write
Description
For entries of type service or qspace, this object specifies the name exported through non-topend remote access points.
tuxDmExpDmInBufType
Syntax
DisplayString (SIZE(1..513))
Access
read-write
Description
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.
tuxDmExpDmOutBufType
Syntax
DisplayString (SIZE(1..513))
Access
read-write
Description
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.
tuxDmImportTable
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.
 
tuxDmImpDmResourceName
Syntax
DisplayString (SIZE(1..127))
Access
read-only
Description
The 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.
tuxDmImpDmrAccessPointList
Syntax
DisplayString (SIZE(1..15))
Access
read-only
Description
Identifies the remote domain access point through which this resource should be imported. This object value is a comma-separated failover domain list; it can contain up to three remote domain access points. If this object is set to “*”, the resource can be imported from all remote access points.
tuxDmImpDmlAccessPoint
Syntax
DisplayString (SIZE(1..15))
Access
read-only
Description
The name of the local domain access point through which this imported resource should be made available. If set to the null string, the resource is made available through all local domain access points.
tuxDmImpState
Syntax
INTEGER { valid(1) | invalid(2) }
Access
read-write
Description
This object denotes the current state of the tuxDmImport instance.
GET requests:
valid(1): The object exists.
SET requests:
invalid(2): The object is deleted. A state change is allowed in the active or suspended state and results in the invalid state.
tuxDmImpDmAutoTran
Syntax
INTEGER { yes(1) | no(2) }
Access
read-write
Description
When a request is received for a resource that is not already within a transaction, this object automatically starts a transaction for the resource. The default is no(2).
tuxDmImpDmConv
Syntax
INTEGER { yes(1) | no(2) }
Access
read-write
Description
A boolean value (yes or no) specifies whether the service is conversational.
tuxDmImpDmLoad
Syntax
INTEGER (1..32767)
Access
read-write
Description
The service load.
tuxDmImpDmPrio
Syntax
INTEGER (1..100)
Access
read-write
Description
The dequeuing priority. Service requests with a higher priority are serviced first.
tuxDmImpDmResourceType
Syntax
INTEGER { service(1) | qspace(2) | qname(3)}
Access
read-write
Description
Specifies whether this entry is for a service, qspace, or qname. The default is service.
tuxDmImpDmRemoteName
Syntax
DisplayString (SIZE(1..127))
Access
read-write
Description
For entries of type service or qspace, this object specifies the name imported through non-topend remote access points.
tuxDmImpDmRoutingName
Syntax
DisplayString (SIZE(1..15))
Access
read-write
Description
The name of a tuxDmRoutingTable object to use for routing criteria for this service or qspace.
tuxDmImpDmTranTime
Syntax
INTEGER (1..32767)
Access
read-write
Description
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.
Limitation: Run-time updates to this object are not reflected in active requests.
tuxDmImpDmInBufType
Syntax
DisplayString (SIZE(1..256))
Access
read-write
Description
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.
tuxDmImpDmOutBufType
Syntax
DisplayString (SIZE(1..256))
Access
read-write
Description
Attributes available from remote access points of tuxDmRemoteDmType=snax|ositp:
tuxDmLocalTable
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.
 
tuxDmLclDmAccessPoint
Syntax
DisplayString (SIZE(1..30))
Access
read-only
Description
This object value is an identifier unique within the scope of tuxDmLocal and tuxDmRemote entry names in the domain configuration.
tuxDmLclDmAccessPoint
Syntax
DisplayString (SIZE(1..30))
Access
read-write
Description
The domain access point identifier. This identifier is unique across all local and remote domain access points.
tuxDmLclDmSrvGroup
Syntax
DisplayString (SIZE(1..30))
Access
read-write
Description
The group in which the administrative servers and gateway processes of the local domain reside.
tuxDmLclDmType
Syntax
INTEGER { tdomain(1) | ositp(2) | snax(3)}
Access
read-write
Description
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.
tuxDmLclState
Syntax
INTEGER { valid(1) | invalid(2) }
Access
read-write
Description
This object denotes the current state of the tuxDmLocal instance.
GET requests:
valid(1): The object exists.
SET requests:
invalid(2): The object is deleted.
tuxDmLclDmAuditLog
Syntax
DisplayString (SIZE(1..256)) (up to 78 bytes for Oracle Tuxedo 8.0 or earlier)
Access
read-write
Description
The name of the audit log file for this local domain.
tuxDmLclDmBlockTime
Syntax
INTEGER (0..32767)
Access
read-write
Description
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.
tuxDmLclDmMaxRapTran
Syntax
INTEGER (0..32767)
Access
read-write
Description
The maximum number of remote domain access points that can be involved in a single transaction.
tuxDmLclDmMaxTran
Syntax
INTEGER (0..32767)
Access
read-write
Description
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.
tuxDmLclDmSecurity
Syntax
INTEGER { none(1) | app-pw(2) | dm-pw(3) | dm-user-pw(4) | te-clear(5) | te-safe(6) | te-private(7)}
Access
read-write
Description
The type of security enabled on this domain. This object must be set to one of the following:
none(1)
No security is enabled.
app-pw(2)
Valid only when tuxDmRemoteDmType=tdomain. Application password-based security is enabled.
dm-pw(3)
Valid only when tuxDmRemoteDmType=tdomain. Domain password-based security is enabled.
dm-user-pw(4)
Valid only when tuxDmRemoteDmType=snax. Translation of principal names is enabled.
tuxDmLclDmTlogDev
Syntax
DisplayString (SIZE(1..256)) (up to 78 bytes for Oracle Tuxedo 8.0 or earlier)
Access
read-write
Description
The device (raw slice) or file that contains the domain TLOG for this local domain access point. The TLOG is stored as an Oracle Tuxedo system VTOC table on the device. For reliability, the use of a device (raw slice) is recommended.
tuxDmLclDmTlogName
Syntax
DisplayString (SIZE(1..30))
Access
read-write
Description
The domain TLOG name for this local domain access point. If more than one TLOG exists on the same device, each TLOG must have a unique name.
tuxDmLclDmTlogSize
Syntax
INTEGER
Access
read-write
Description
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.
tuxDmLclDmConnectionPolicy
Syntax
INTEGER { on-demand(1) | on-startup(2) | incoming-only(3)}
Access
read-write
Description
Attributes available when tuxDmRemoteDmType=tdomain.
Specifies the conditions under which a local domain gateway tries to establish a connection to a remote domain. Supported values are:
on-demand(1)
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.
on-startup(2)
Means that a domain gateway attempts to establish a connection with its remote domain access points at gateway server initialization time. Remote services, (that is, services advertised by the domain gateway for this local access point) are advertised only if a connection is successfully established to that remote domain access point. Therefore, if there is no active connection to a remote domain access point, the remote services are suspended. By default, this connection policy retries failed connections every 60 seconds; however, you can specify a different value for this interval using the tuxDmLclMaxRetry and tuxDmLclDmRetryInterval objects.
tuxDmLclDmRetryInterval
Syntax
INTEGER
Access
read-write
Description
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.
tuxDmLclDmMaxRetry
Syntax
INTEGER
Access
read-write
Description
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.
tuxDmLclDmConnPrincipalName
Syntax
DisplayString (SIZE(1..511))
Access
read-write
Description
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”.
tuxDmLclDmMachineType
Syntax
DisplayString (SIZE(1..15))
Access
read-write
Description
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.
tuxDmLclDmBlobShmSize
Syntax
INTEGER
Access
read-write
Description
This object is relevant only to local domain access point entries. It specifies the amount of shared memory allocated to storing binary large object log information specific to ositp.
tuxDmOsitpTable
The tuxDmOsitpTable group contains objects that define the OSI TP protocol-related configuration information for a specific local or remote domain access point.
tuxDmOsiDmAccessPoint
Syntax
DisplayString (SIZE(1..30))
Access
read-only
Description
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.
tuxDmOsiDmState
Syntax
INTEGER { valid(1) | invalid(2) }
Access
read-write
Description
This object denotes the current state of the tuxDmOsitp instance.
GET requests:
valid(1): The object exists.
SET requests:
invalid(2): The object is deleted.
tuxDmOsiDmApt
Syntax
DisplayString (SIZE(1..78))
Access
read-write
Description
The application process title of the domain access point in object identifier form.
tuxDmOsiDmAeq
Syntax
DisplayString (SIZE(1..78))
Access
read-write
Description
The application entity qualifier of the domain access point in integer form.
tuxDmOsiDmNwDevice
Syntax
DisplayString (SIZE(1..78))
Access
read-write
Description
This object, which specifies the network device to be used, is relevant when it defines a local domain access point and ignored for a remote domain access point.
tuxDmOsiDmAcn
Syntax
INTEGER { atmi(1) | udt(2) }
Access
read-write
Description
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.
tuxDmOsiDmApid
Syntax
INTEGER
Access
read-write
Description
This optional object defines the application process-invocation identifier to be used on this domain access point.
tuxDmOsiDmAeid
Syntax
INTEGER
Access
read-write
Description
This optional object defines the application entity-invocation identifier to be used on this domain access point.
tuxDmOsiDmUrch
Syntax
DisplayString (SIZE(1..30))
Access
read-write
Description
This object specifies the user portion of the OSI TP recovery context handle. It can be required by an OSI TP provider in order to perform recovery of distributed transactions after a communication line or system failure.
This object is relevant for defining a local domain access point and ignored for a remote domain access point.
tuxDmOsiDmMaxListeningEp
Syntax
INTEGER (1..32767)
Access
read-write
Description
This object specifies the number of endpoints awaiting incoming OSI TP dialogue. It is relevant for defining a local domain access point and ignored for a remote domain access point.
tuxDmOsiDmXatmiEncoding
Syntax
INTEGER { cae(1) | preliminary(2) | oltp-tm2200(3) }
Access
read-write
Description
This object specifies the version of the XATMI protocol used to communicate with a remote system. Valid values are: cae, preliminary, and oltp-tm2200.
This object is relevant for remote domain access points and ignored for local domain access points.
tuxDmPasswordTable
The tuxDmPasswordTable group contains objects that represent configuration information for inter-domain authentication through access points of type tdomain.
 
tuxDmPasswdDmlAccessPoint
Syntax
DisplayString (SIZE(1..24))
Access
read-only
Description
The name of the local domain access point to which the password applies.
tuxDmPasswdDmrAccessPoint
Syntax
DisplayString (SIZE(1..24))
Access
read-only
Description
The name of the remote domain access point to which the password applies.
tuxDmPasswdDmlPWD
Syntax
DisplayString (SIZE(1..30))
Access
write-only
Description
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.
tuxDmPasswdDmrPWD
Syntax
DisplayString (SIZE(1..30))
Access
write-only
Description
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.
tuxDmPasswdState
Syntax
INTEGER { valid(1) | invalid(2) | recrypt(3) }
Access
read-write
Description
This object denotes the current state of the tuxDmPassword instance.
GET requests:
valid(1): The object exists.
SET requests:
invalid(2): The object is deleted.
recrypt(3): Re-encrypt all passwords using a new encryption key.
tuxDmPrincipalMapTable
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.
tuxDmPrinMapDmlAccessPoint
Syntax
DisplayString (SIZE(1..12))
Access
read-only
Description
The local domain access point to which the principal mapping applies.
tuxDmPrinMapDmrAccessPoint
Syntax
DisplayString (SIZE(1..12))
Access
read-only
Description
The remote domain access point to which the principal mapping applies.
tuxDmPrinMapDmlPrinName
Syntax
DisplayString (SIZE(1..12))
Access
read-only
Description
The local principal name in the principal mapping.
tuxDmPrinMapDmrPrinName
Syntax
DisplayString (SIZE(1..12))
Access
read-only
Description
The remote principal name in the principal mapping.
tuxDmPrinMapDirection
Syntax
INTEGER { in(1) | out(2) | both(3) }
Access
read-write
Description
The direction to which the principal mapping applies.
in(1)
Is incoming to this Oracle Tuxedo domain through the given remote domain access point and local domain access point.
out(2)
Is outgoing from this Oracle Tuxedo domain through the given local domain access point and remote domain access point.
both(3)
Applies to both incoming to and outgoing from this Oracle Tuxedo domain through the given local domain access point and remote domain access point.
tuxDmPrinMapState
Syntax
INTEGER { valid(1) | invalid(2) }
Access
read-write
Description
This object denotes the current state of the tuxDmPrincipalMap instance.
GET requests:
valid(1): The object exists.
SET requests:
invalid(2): The object is deleted.
tuxDmRemoteTable
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.
tuxDmRemoteDmAccessPoint
Syntax
DisplayString (SIZE(1..30))
Access
read-only
Description
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.
tuxDmRemoteDmAccessPointID
Syntax
DisplayString (SIZE(1..30))
Access
read-write
Description
The access point identifier. This identifier is unique across all local and remote domain access points.
tuxDmRemoteType
Syntax
INTEGER { tdomain(1) | ositp(2) | snax(3)}
Access
read-write
Description
The type of domain:
tdomain(1)
An Oracle Tuxedo domain.
ositp(2)
An OSI domain.
snax(3)
An SNA domain.
The presence or absence of other objects depends on the value of this object.
tuxDmRemoteState
Syntax
INTEGER { valid(1) | invalid(2)}
Access
read-write
Description
This object denotes the current state of the tuxDmRemote instance.
GET requests:
valid(1): The object exists.
SET requests:
invalid(2): The object is deleted.
tuxDmRemoteDmCodePage
Syntax
DisplayString (SIZE(1..20))
Access
read-write
Description
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.
tuxDmRemoteDmMachineType
Syntax
DisplayString (SIZE(1..15))
Access
read-write
Description
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.
tuxDmResourcesTable
The tuxDmResourcesTable group contains an object that represents Domains-specific configuration information.
tuxDmResourcesDmVersion
Syntax
DisplayString (SIZE(1..30))
Access
read-only
Description
A user-supplied identifier for the Domains configuration.
tuxDmRoutingTable
The tuxDmRoutingTable group contains objects that represent routing criteria information for routing requests to a domain through a remote domain access point.
 
tuxDmRoutingDmRoutingName
Syntax
DisplayString (SIZE(1..15))
Access
read-only
Description
The name of the routing criteria table entry.
tuxDmRoutingDmBufType
Syntax
DisplayString (SIZE(1..30))
Access
read-only
Description
List of types and subtypes of data buffers for which this routing entry is valid.
type1[:subtype1[,subtype2...]][:type2[:subtype3[,subtype4...]]...]
A maximum of 32 type/subtype combinations is allowed. The types are restricted to the following: FML, XML, VIEW, X-C-TYPE, or X_COMMON. No subtype can be specified for FML or XML; subtypes are required for types VIEW, X_C_TYPE, and X_COMMON (“*” is not allowed).
Note that subtype names should not contain semicolon (;), colon (:), comma (,), or asterisk (*)characters. Duplicate type/subtype pairs cannot be specified for the same routing criterion name; more than one routing entry can have the same criterion name as long as the type/subtype pairs are unique. If multiple buffer types are specified for a single routing entry, the data types of the routing field for each buffer type must be the same.
tuxDmRoutingDmField
Syntax
DisplayString (SIZE(1..30))
Access
read-write
Description
This object value is the routing field name. This field is assumed to be an FML buffer, XML buffer, or VIEW field name that is identified in an FML field table (using the FLDTBLDIR and FIELDTBLS environment variables), or an FML VIEW table (using the VIEWDIR and VIEWFILES environment variables), respectively. This information is used to get the associated field value for data-dependent routing to an access point of a remote domain.
For an XML buffer type, this field contains either a routing element type (or name) or a routing element object name.
The syntax of this object for an XML buffer type is as follows:
root_element[/child_element][/child_element][/...][/@object_\
name]
The element is assumed to be an XML document or datagram element type. Indexing is not supported. Therefore, the Oracle Tuxedo system recognizes only the first occurrence of a given element type when it processes an XML buffer for data-dependent routing. This information is used to get the associated element content for data-dependent routing while sending a message. The content must be a string encoded in UTF-8.
The object is assumed to be an XML document or datagram object of the defined element. This information is used to get the associated object value for data-dependent routing while sending a message. The value must be a string encoded in UTF-8.
The combination of element name and object name can contain up to 30 characters.
tuxDmRoutingDmFieldType
Syntax
INTEGER { char(1) | short(2) | long(3) | float(4) | double(5) | string(6)}
Access
read-write
Description
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.
tuxDmRoutingDmRanges
Syntax
DisplayString (SIZE(1..1000))
Access
read-write
Description
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:
lower[-upper]:raccesspoint
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.
The meta-character “*” (wild-card) in the position of a range indicates any values not covered by the other ranges previously seen in the entry. Only one wild-card range is allowed per entry and it should be the last range (ranges that follow it are ignored).
The routing field can be of any data type supported in FML. A numeric routing field must have numeric range values and a string routing field must have string range values.
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.
tuxDmRoutingState
Syntax
INTEGER { valid(1) | invalid(2)}
Access
read-write
Description
This object denotes the current state of the tuxDmRouting instance.
GET requests:
valid(1): The object exists.
SET requests:
invalid(2): The object is deleted.
tuxDmrPrincipalTable
The tuxDmrPrincipalTable group contains objects that represent password configuration information for remote principal names.
 
tuxDmrPrincipalDmrAccessPoint
Syntax
DisplayString (SIZE(1..24))
Access
read-only
Description
The remote domain access point to which the principal is applicable.
tuxDmrPrincipalDmrPrinName
Syntax
DisplayString (SIZE(1..24))
Access
read-only
Description
The remote principal name.
tuxDmrPrincipalDmrPrinPasswd
Syntax
DisplayString (SIZE(1..8))
Access
write-only
Description
The remote password used for the principal name when communicating through the remote domain access point identified in tuxDmrPrincipalDmrAccessPoint.
tuxDmrPrincipalState
Syntax
INTEGER { valid(1) | invalid(2)}
Access
read-write
Description
This object denotes the current state of the tuxDmrPrincipal instance.
GET requests:
valid(1): The object exists.
SET requests:
invalid(2): The object is deleted.
tuxDmSnaCRMTable
The tuxDmSnaCRMTable group defines the SNM-CRM-specific configuration information for the named local domain access point.
 
tuxDMSnaCRMDmSNACRM
Syntax
DisplayString (SIZE(1..30))
Access
read-only
Description
This object is an identifier, unique within the scope of the SNA CRM entries in the domain configuration, used to identify this SNA CRM entry.
tuxDMSnaCRMDmAccessPoint
Syntax
DisplayString (SIZE(1..30))
Access
write-only
Description
The name of the local domain access point entry with which this SNA CRM is used.
tuxDMSnaCRMState
Syntax
INTEGER { valid(1) | invalid(2)}
Access
read-write
Description
This object denotes the current state of the tuxDmSnaCRM instance.
GET requests:
valid(1): The object exists.
SET requests:
invalid(2): The object is deleted.
tuxDMSnaCRMDmNWAddr
Syntax
DisplayString (SIZE(1..256)) (up to 78 bytes for Oracle Tuxedo 8.0 or earlier)
Access
read-write
Description
Specifies the network address for communication between the domain gateway of the local domain access point and the SNA CRM.
tuxDMSnaCRMDmNWDevice
Syntax
DisplayString (SIZE(1..78))
Access
read-write
Description
Specifies the network device to be used for communication between the domain gateway of the local domain access point and the SNA CRM.
tuxDmSnaLinkTable
The tuxDmSnaLinkTable group contains objects that represent snax-specific configuration information for a remote domain access point.
tuxDmSnaLinkDmSNALink
Syntax
DisplayString (SIZE(1..30))
Access
read-only
Description
This object is an identifier, unique within the scope of the SNA LINK entries within the domain configuration, used to identify rows in this table.
tuxDmSnaLinkDmSNAStack
Syntax
DisplayString (SIZE(1..30))
Access
read-write
Description
The name of the snax stack entry to be used to reach this remote domain access point.
tuxDmSnaLinkDmrAccessPoint
Syntax
DisplayString (SIZE(1..30))
Access
read-write
Description
Identifies the remote domain access point name for which this entry provides the snax configuration data.
tuxDmSnaLinkDmlSysID
Syntax
DisplayString (SIZE(1..4))
Access
read-write
Description
The local SYSID used when establishing an SNA link to the remote logical unit (LU).
tuxDmSnaLinkDmrSysID
Syntax
DisplayString (SIZE(1..4))
Access
read-write
Description
The remote SYSID used when establishing an SNA link to the remote logical unit (LU).
tuxDmSnaLinkDmlUname
Syntax
DisplayString (SIZE(1..8))
Access
read-write
Description
Specifies the logical unit (LU) name associated with the remote domain access point.
tuxDmSnaLinkDmMinWin
Syntax
INTEGER
Access
read-write
Description
The minimum number of winner sessions to the remote LU.
tuxDmSnaLinkDmModeName
Syntax
DisplayString (SIZE(1..8))
Access
read-write
Description
Specifies the name associated with the session characteristics for sessions to the remote LU.
tuxDmSnaLinkState
Syntax
INTEGER { valid(1) | invalid(2)}
Access
read-write
Description
This object denotes the current state of the tuxDmSnaLink instance.
GET requests:
valid(1): The object exists.
SET requests:
invalid(2): The object is deleted.
tuxDmSnaLinkDmSecType
Syntax
INTEGER { local(1) | identify(2) | verify(3) | persistent(4) | mixidpe(5) }
Access
read-write
Description
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.
tuxDmSnaLinkDmStartType
Syntax
INTEGER { auto(1) | cold(2)}
Access
read-write
Description
Specifies the type of session start-up for the destination logical unit (LU).
auto(1)
The SNACRM, in conjunction with the domain gateway, chooses whether to COLDSTART or WARMSTART the LU.
cold(2)
Forces a COLDSTART with the LU.
tuxDmSnaLinkDmSNAsess
Syntax
INTEGER (0..32767)
Access
read-write
Description
Specifies maximum number of sessions to establish with the remote LU.
tuxDmSnaLinkDmMaxSyncLvl
Syntax
INTEGER (0..2)
Access
read-only
Description
The maximum SYNC LEVEL that can be support to this remote LU.
tuxDmSnaStackTable
The tuxDmSnaStackTable group defines an SNA stack to be used by a specific SNA CRM.
tuxDmSnaStackDmSnaStack
Syntax
DisplayString (SIZE(1..30))
Access
read-only
Description
The name of this tuxDmSnaStack entry. This object is an identifier, unique within the scope of the tuxDmSnaStackTable in the domain configuration.
tuxDmSnaStackDmSnaCRM
Syntax
DisplayString (SIZE(1..30))
Access
read-write
Description
Identifies the tuxDmSnaCRM table entry of the SNA CRM in which this SNA protocol stack definition is used.
tuxDmSnaStackDmStackType
Syntax
DisplayString (SIZE(1..30))
Access
read-write
Description
Identifies the protocol stack to be used.
tuxDmSnaStackDmlUname
Syntax
DisplayString (SIZE(1..8))
Access
read-write
Description
Specifies the LU name to be used on sessions established using this stack definition.
tuxDmSnaStackDmTpName
Syntax
DisplayString (SIZE(1..8))
Access
read-write
Description
Specifies the TP name associated with the SNA stack. A value of “*” means accept any TP name.
tuxDmSnaStackDmStackParams
Syntax
DisplayString (SIZE(1..128))
Access
read-write
Description
Provides protocol stack specific parameters.
tuxDmSnaStackState
Syntax
INTEGER { valid(1) | invalid(2)}
Access
read-write
Description
This object denotes the current state of the tuxDmSnaStack instance.
GET requests:
valid(1): The object exists.
SET requests:
invalid(2): The object is deleted.
tuxDmTdomainTable
The tuxDmTdomainTable group defines the domain-specific configuration for a local or remote domain access point.
 
tuxDmTdomainDmAccessPoint
Syntax
DisplayString (SIZE(1..24))
Access
read-only
Description
The local or remote domain access point name for which this entry provides the TDomain-specific configuration data.
When domain-level failover is in use, more than one tuxDmTdomainTable entry can be defined with the same tuxTDmTdomainDmAccessPoint.
tuxDmTdomainDmNwAddr
Syntax
DisplayString (SIZE(1..24))
Access
read-only
Description
Specifies the network address associated with the access point.
For a local domain access point, this object supplies the address used to listen for incoming connections.
For a remote domain access point, this object supplies the destination used when you connect to a remote domain access point.
The value of this object must be unique across all tuxDmTdomainTable objects.
tuxDmTdomainState
Syntax
INTEGER { valid(1) | invalid(2) }
Access
read-write
Description
This object denotes the current state of the tuxDmTdomain instance.
GET requests:
valid(1): The object exists.
SET requests:
invalid(2): Delete the object.
tuxDmTdomainDmNwDevice
Syntax
DisplayString (SIZE(1..78))
Access
read-write
Description
Specifies the network device used.
For a local domain access point, this object specifies the device used for listening.
For a remote domain access point, this object specifies the device used to connect to the remote domain access point.
tuxDmTdomainDmCmpLimit
Syntax
INTEGER
Access
read-write
Description
This object is relevant to remote domain access points only. It specifies the threshold over which compression occurs for traffic on connections to this access point.
tuxDmTdomainDmFailOverSeq
Syntax
INTEGER (0..32767)
Access
read-write
Description
This object is relevant to remote domain access points only. It specifies the position of this set of addressing in the failover sequence for this remote domain access point. If no failover sequence number is supplied, the first entry for this remote domain access point is allocated the number 10 greater than the highest failover sequence number known for the remote domain access point. Thus, the first entry gets 10, the second, 20, and so on.
tuxDmTdomainDmMinEncriptBits
Syntax
INTEGER { enc-0-bit(1) | enc-40-bits(2) | enc-56-bits(3) | enc-128-bits(4)}
Access
read-write
Description
This object is relevant to remote domain access points only. When establishing a network link to this access point, this object specifies the minimum level of encryption required.
enc-0-bit(1)
No encryption
enc-40-bits(2), enc-56-bits(3), and enc-128-bits(4)
These values specify the encryption length (in bits).
If this minimum level of encryption is not met, link establishment fails. The default value is enc-0-bit.
tuxDmTdomainDmMaxEncriptBits
Syntax
INTEGER { enc-0-bit(1) | enc-40-bits(2) | enc-56-bits(3) | enc-128-bits(4)}
Access
read-write
Description
This object is relevant to remote domain access points only. When establishing a network link to this access point, this object specifies the maximum level of encryption required.
enc-0-bit(1)
No encryption
enc-40-bits(2), enc-56-bits(3), and enc-128-bits(4)
These values specify the encryption length (in bits).
The default value is enc-128-bits.
Note:
tuxDmTransactionTable
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.
 
tuxDmTransactionDmlAccessPoint
Syntax
DisplayString (SIZE(1..30))
Access
read-only
Description
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.
tuxDmTransactionDmTPTranID
Syntax
DisplayString (SIZE(1..24))
Access
read-write
Description
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.
tuxDmTransactionState
Syntax
INTEGER { aborted(1) | abortonly(2) | active(3) | comcalled(4) | decided(5) | done(6) | habort(7) | hcommit(8) | heuristic(9) | ready(10) | unknown(11) | invalid(12) }
Access
read-write
Description
This object denotes the current state of the tuxDmTransaction instance.
GET requests:
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.
SET requests:
invalid(12): Forget the specified table entry. This state change is only valid in states HCOmmit and HABort.
tuxDmTransactionDmTxAccessPoint
Syntax
DisplayString (SIZE(1..30))
Access
read-only
Description
If the transaction originated from a remote domain, this object value is the name of the remote domain access point through which the transaction originated. If the transaction originated within this domain, this value is the name of the local domain access point.
tuxDmTransactionDmTxNetTranID
Syntax
DisplayString (SIZE(1..78))
Access
read-only
Description
If the transaction originated from a remote domain, this object value is the external transaction identifier received from the remote domain access point through which the transaction originated. If the transaction originated within this domain, the object contains the same value as the
tuxDmTransactionDmBranchCount
Syntax
INTEGER
Access
read-only
Description
The number of branches to remote domain access points involved in the transaction. For a domain gateway that does not make branch information available, this value is zero.
tuxDmTransactionDmBranchIndex
Syntax
INTEGER
Access
read-only
Description
The index of the first branch-specific object values (tuxDmTransactionDmBranchNo, tuxDmTransactionDmrAccessPoint, tuxDmTransactionDmNetTranID, and tuxDmTransactionDmBranchState) corresponding to this object.
tuxDmTransactionDmBranchNo
Syntax
INTEGER
Access
read-only
Description
The branch number of the participating branch (numbered from zero).
tuxDmTransactionDmrAccessPoint
Syntax
DisplayString (SIZE(1..30))
Access
read-only
Description
The name of the remote domain access point for this branch.
tuxDmTransactionDmNetTranID
Syntax
DisplayString (SIZE(1..78))
Access
read-only
Description
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.
tuxDmTransactionDmBranchState
Syntax
INTEGER { aborted(1) | abortonly(2) | active(3) | comcalled(4) | decided(5) | done(6) | habort(7) | hcommit(8) | heuristic-hazard(9) | heuristic-mixed(10) | ready(11) | unknown(12) }
Access
read-write
Description
A GET operation retrieves run-time information for the transaction branch (when the information is available for a particular domain gateway type).
GET requests:
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.

Copyright © 1994, 2017, Oracle and/or its affiliates. All rights reserved.