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

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

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 points of `TA_DMTYPE=`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.

TA_STATE:

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. This attribute is not permitted if TA_DMRESOURCETYPE="QNAME".

TA_DMCONV: "{Y | N}"

Specifies whether this local resource is conversational.

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.

Attributes available from remote domain access points of TA_DMTYPE=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. 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.

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. 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.

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.