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

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

T_DM_SNALINK Class Definition

Overview

The T_DM_SNALINK class represents SNAX-specific configuration information for a remote domain access point.

Attribute Table

Table 26 DM_MIB(5): T_DM_SNALINK Class Definition Attribute Table

Attribute	Type	Permissions	Values	Default
TA_DMSNALINK(r)(k)(*)	string	`rw-r--r--`	`string`[1..30]	N/A
TA_DMSNASTACK(r)(k)	string	`rw-r--r--`	`string`[1..30]	N/A
TA_DMRACCESSPOINT(r)(k)	string	`rw-r--r--`	`string`[1..30]	N/A
TA_DMLSYSID(r)	string	`rw-r--r--`	`string`[1..4]	N/A
TA_DMRSYSID(r)	string	`rw-r--r--`	`string`[1..4]	N/A
TA_DMLUNAME(r)	string	`rw-r--r--`	`string`[1..8]	N/A
TA_DMMINWIN(r)	short	`rw-r--r--`	0 <= `num` <= 32767	N/A
TA_DMMODENAME(r)	string	`rw-r--r--`	`string`[1..8]	N/A
TA_STATE(r)	string	`rw-r--r--`	`GET`: `"VAL"` `SET`: `"`{`NEW` \| `INV`}`"`	N/A N/A
TA_DMSECTYPE	string	`rw-r--r--`	`"`{`LOCAL` \| `IDENTIFY` \| `VERIFY` \| `PERSISTENT` \| `MIXIDPE`}`"`	`"LOCAL"`
TA_DMSTARTTYPE	string	`rw-r--r--`	`"`{`AUTO` \| `COLD`}`"`	`"AUTO"`
TA_DMMAXSNASESS	short	`rw-r--r--`	0 <= `num` <= 32767	64
TA_DMMAXSYNCLVL	short	`r--r--r--`	0 <= `num` <= 2	0
(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_DMSNALINK: string[1..30]

The name of the T_DM_SNALINK entry. An identifier, unique within the scope of the SNA LINK entries within the Domains configuration, used to identify this TA_DMSNALINK entry.

TA_DMSNASTACK: string[1..30]

The name of the SNAX stack entry to be used to reach this remote domain access point.

TA_DMRACCESSPOINT: string[1..30]

Identifies the remote domain access point name for which this entry provides the SNAX configuration data.

TA_DMLSYSID: string[1..4]

The local SYSID to be used when establishing an SNA link to the remote logical unit (LU).

TA_DMRSYSID: string[1..4]

The remote SYSID to be used when establishing an SNA link to the remote LU.

TA_DMLUNAME—>string[1..8]

Specifies the LU name associated with the remote domain access point.

TA_DMMINWIN: 0 <= num <= 32767

The minimum number of winner sessions to the remote LU.

TA_DMMODENAME: string[1..8]

Specifies the name associated with the session characteristics for sessions to the remote LU.

TA_STATE:

GET: "{VALid}"

A GET operation retrieves configuration information for the T_DM_SNALINK 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_SNALINK 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 state `"INValid"`.
`"INValid"`	The object is deleted.

TA_DMSECTYPE: "{LOCAL | IDENTIFY | VERIFY | PERSISTENT | MIXIDPE}"

Specifies the type of SNA security to be used on sessions to the remote LU. Valid values for this attribute are "LOCAL", "IDENTIFY", "VERIFY", "PERSISTENT", and "MIXIDPE".

TA_DMSTARTTYPE: "{AUTO | COLD}"

Specifies the type of session start-up for the destination LU. Setting this attribute to "COLD" forces a COLDSTART with the LU. If set to "AUTO", the SNACRM in conjunction with the domain gateway choose whether to COLDSTART or WARMSTART the LU.

TA_DMMAXSNASESS: 0 <= num <= 32767

Specifies maximum number of sessions to establish with the remote LU.

TA_DMMAXSYNCLVL: 0 <= num <= 2

The maximum SYNC LEVEL that can be supported to this remote LU.

Limitations

Deleting or updating an instance of the T_DM_SNALINK class that refers to a T_DM_SNASTACK class instance is not permitted under the following condition: the T_DM_SNASTACK class instance refers to a T_DM_SNACRM class instance that references a local domain access point for which the Domain gateway administration (GWADM) server is active.

On SET operations that add or update an instance of this class:

The remote domain access point specified in the TA_DMRACCESSPOINT attribute must exist in the T_DM_REMOTE class. If the access point does not exist, a "not defined" error is returned for the TA_DMRACCESSPOINT attribute, and the operation fails.
The SNA stack reference name specified in the TA_DMSNASTACK attribute must exist in the T_DM_SNASTACK class. If the reference name does not exist, a "not defined" error is returned for the TA_DMSNASTACK attribute, and the operation fails.