Section 5 - File Formats, Data Descriptions, MIBs, and System Processes Reference

Tuxedo

e-docs > Tuxedo > File Formats, Data Descriptions, MIBs, and System Processes Reference > Section 5 - File Formats, Data Descriptions, MIBs, and System Processes Reference

File Formats, Data Descriptions, MIBs, and System Processes Reference

Previous

Next

Contents

View as PDF

T_DM_EXPORT Class Definition

Overview

The T_DM_EXPORT class represents local resources that are exported to one or more remote domains through a local access point.

Attribute Table

Table 14 DM_MIB(5): T_DM_EXPORT Class Definition Attribute Table

Attribute	Type	Permissions	Values	Default
TA_DMRESOURCENAME(r)(k)(*)	string	rw-r--r--	string[1..15]	N/A
TA_DMLACCESSPOINT(k)(*)	string	rw-r--r--	string[1..30]	* (meaning all)
TA_STATE(r)	string	rw-r--r--	GET: "VAL" SET: "{NEW \| INV}"	N/A N/A
TA_DMACLNAME	string	rw-r--r--	string[1..15]	N/A
TA_DMCONV	string	rw-r--r--	"{Y \| N}"	"N"
TA_DMREMOTENAME	string	rw-r--r--	string[1..30]	N/A
Attributes available from remote domain access point of TA_DMTYPE=TOPEND:
TA_DMRESOURCETYPE	string	rw-r--r--	"{SERVICE \| QSPACE \| QNAME}"	"SERVICE"
TA_DMTE_PRODUCT	string	rw-r--r--	string[1..32]
TA_DMTE_FUNCTION	string	rw-r--r--	string[1..8]
TA_DMTE_TARGET	string	rw-r--r--	string[1..8]	Spaces
TA_DMTE_QUALIFIER	long	rw-r--r--	0 <= num <= MAXLONG	0 (Zero)
TA_DMTE_RTQGROUP	string	rw-r--r--	string[1..32]
TA_DMTE_RTQNAME	string	rw-r--r--	string[1..8]
Attributes available from remote domain access points of TA_DMTYPE=TOPEND\|SNAX\|OSITP\|OSITPX:
TA_DMINBUFTYPE	string	rw-r--r--	string[0..513]	N/A
TA_DMOUTBUFTYPE	string	rw-r--r--	string[0..513]	N/A
Attributes available from remote domain access points of TA_DMTYPE=OSITPX:
TA_DMCOUPLING(r)	string	rw-r--r--	"{TIGHT \| LOOSE}"	"LOOSE"
TA_DMINRECTYPE(r)	string	rw-r--r--	string[0..78]	""
TA_DMOUTRECTYPE(r)	string	rw-r--r--	string[0..78]	""
(r)—required when a new object is created (k)—a key field for object retrieval (*)—a required key field for all SET operations on the class

Attribute Semantics

TA_DMRESOURCENAME: string[1..15]

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 attribute corresponds to the value of the TA_SERVICENAME attribute of an active T_SVCGRP object. This resource is exported to remote domains with the same name or with the alias defined in the TA_DMREMOTENAME or TA_DMTE* attributes.

TA_DMLACCESSPOINT: string[1..30]

The local access point name through which this local resource is available. Setting this attribute to "*" means the resource is available at all local access points.

GET: "{VALid}"

A GET operation retrieves configuration information for the T_DM_EXPORT object. The following state indicates the meaning of a TA_STATE attribute value returned in response to a GET request. States not listed are not returned.

"VALid"

The object exists.

SET: "{NEW | INValid}"

A SET operation updates configuration information for the selected T_DM_EXPORT object. The following states indicate the meaning of a TA_STATE set in a SET request. States not listed may not be set.

"NEW"	A new object is created.
unset	Modify an existing object. This combination is not allowed in the "INValid" state. A successful return leaves the object state unchanged.
"INValid"	The object is deleted.

TA_DMACLNAME: string[1..15]

The name of a T_DM_ACL object to use for security for this local resource. When access is permitted from TOPEND remote domain access points, this optional attribute may be specified if TA_DMRESOURCETYPE="SERVICE" or "QSPACE". This attribute is not permitted if TA_DMRESOURCETYPE="QNAME".

TA_DMCONV: "{Y | N}"

Specifies whether this local resource is conversational. When access is permitted from TOPEND remote domain access points, this attribute must be set to "N" if TA_DMRESOURCETYPE="QSPACE" or "QNAME".

TA_DMREMOTENAME: string[1..30]

Specifies the name of this local resource exported through the remote domain access points. If this attribute is not specified, the name of the local resource defaults to the name specified in TA_DMRESOURCENAME. The TA_DMREMOTENAME attribute does not apply to domain gateways of type TOPEND.

Attributes available from remote domain access points of TA_DMTYPE=TOPEND

TA_DMRESOURCETYPE: "{SERVICE | QSPACE | QNAME}"

Specifies whether this local resource is a "SERVICE", "QSPACE", or "QNAME". The default is "SERVICE".

TA_DMTE_PRODUCT: string[1..32]

The BEA TOP END product name for this local resource. When access is permitted from TOPEND remote domain access points, this attribute must be specified if TA_DMRESOURCETYPE="SERVICE" or "QNAME". This attribute is not permitted if TA_DMRESOURCETYPE="QSPACE".

TA_DMTE_FUNCTION: string[1..8]

The BEA TOP END function name for this local resource. When access is permitted from TOPEND remote domain access points, this attribute must be specified if TA_DMRESOURCETYPE="SERVICE" or "QNAME". This attribute is not permitted if TA_DMRESOURCETYPE="QSPACE".

TA_DMTE_TARGET: string[1..8]

The BEA TOP END Message Sensitive Routing (MSR) target for this local resource. When access is permitted from TOPEND remote domain access points, this optional attribute may be specified if TA_DMRESOURCETYPE="SERVICE", "QSPACE", or "QNAME".

TA_DMTE_QUALIFIER: 0 <= num <= MAXLONG

The BEA TOP END function qualifier for this local resource. When access is permitted from TOPEND remote domain access points, this optional attribute may be specified if TA_DMRESOURCETYPE="SERVICE" or "QNAME". This attribute is not permitted if TA_DMRESOURCETYPE="QSPACE".

TA_DMTE_RTQGROUP: string[1..32]

The BEA TOP END Recoverable Transaction Queuing (RTQ) queue group name for this local resource. When access is permitted from TOPEND remote domain access points, this attribute must be specified if TA_DMRESOURCETYPE="QSPACE". This attribute is not permitted if TA_DMRESOURCETYPE="SERVICE" or "QNAME".

TA_DMTE_RTQNAME: string[1..8]

The BEA TOP END RTQ queue name for this local resource. When access is permitted from TOPEND remote domain access points, this attribute must be specified if TA_DMRESOURCETYPE="QSPACE". This attribute is not permitted if TA_DMRESOURCETYPE="SERVICE" or "QNAME".

Attributes available from remote domain access points of TA_DMTYPE=TOPEND|SNAX|OSITP|OSITPX

TA_DMINBUFTYPE: string[0..513]

type[:subtype]—Specifies the input buffer type, optionally followed by the subtype, for this local resource. If this attribute is present, it defines the buffer type [and subtype] accepted. When access is permitted from TOPEND remote domain access points, this optional attribute may be specified if TA_DMRESOURCETYPE="SERVICE" or "QNAME"; this attribute is not permitted if TA_DMRESOURCETYPE="QSPACE". This attribute should be defined for entries of TA_DMRESOURCETYPE="SERVICE" when using SNAX, or when access is permitted from remote domain access points using OSITP or OSITPX with the UDT application context.

For BEA TOP END service and queue name entries, the valid values for type are FML32, CARRAY, and X_OCTET.

TA_DMOUTBUFTYPE: string[0..513]

type[:subtype]— Specifies the output buffer type, optionally followed by subtype, for this local resource. If this attribute is present, it defines the buffer type [and subtype] output by the service. When access is permitted from TOPEND remote domain access points, this optional attribute may be specified if TA_DMRESOURCETYPE="SERVICE"; this attribute is not permitted if TA_DMRESOURCETYPE="QSPACE" or QNAME". This attribute should be defined for entries of TA_DMRESOURCETYPE="SERVICE" when using SNAX, or when access is permitted from remote domain access points using OSITP or OSITPX with the UDT application context.

For BEA TOP END service and queue name entries, the valid values for type are FML32, CARRAY, and X_OCTET.

Attributes available from remote domain access points of TA_DMTYPE=OSITPX

TA_DMCOUPLING: string"{TIGHT | LOOSE}"

Specifies whether the transaction coupling is to be tight or loose when requests for this local service come through the same remote domain access point. The default is "LOOSE". Setting TA_DMCOUPLING="LOOSE" means that database updates made by the first request to this local service cannot be seen by the second request to the local service even though both requests are involved in the same global transaction. Setting TA_DMCOUPLING="TIGHT" means that multiple calls to the same local service through the same remote domain access point are tightly coupled: database updates made by the first request can be seen by the second request.

TA_DMCOUPLING="TIGHT" applies only when duplicate service requests come through the same remote domain access point. When the service requests are through different remote domain access points, the requests are always loosely coupled.

TA_DMINRECTYPE: string[1..78]

type[:subtype]—Specifies the type, optionally followed by subtype, and in some case the format of the reply buffer that a particular client requires for this local service. This attribute can be omitted if the local service sends a buffer that is identical in type and structure to the buffer that the remote client expects. If you do not specify TA_DMINRECTYPE, the type of buffer is unchanged.

TA_DMOUTRECTYPE: string[1..78]

type[:subtype]—Specifies the type, optionally followed by subtype, of the buffer sent by the remote client for this local service. This attribute is used to enforce stronger type checking.

Limitations

On SET operations that add or update an instance of this class, and where a specific local domain access point is specified in the TA_DMLACCESSPOINT attribute, the access point must exist in the T_DM_LOCAL class. If it does not, a "not defined" error is returned for the TA_DMLACCESSPOINT attribute, and the operation fails.

Back to Top

Previous

Next