---

T_NETGROUP CLASS

Overview

The T_NETGROUP class represents application attributes of network groups. Network groups are groups of LMIDs which can communicate over the TA_NADDR network addresses defined in the T_NETMAP class.

Attribute Table

Table 2: T_NETGROUP Class Definition Attribute Table

Attribute1	Type	Permissions	Values	Default
TA_NETGROUP( r )( * )	string	rU-------	string[1 . . . 30]	DEFAULTNET
TA_NETGRPNO( r )( * )	long	rU-------	1 <= num < 8192	N/A
TA_STATE( k )	string	rw-r--r--	GET:"{VAL}" SET:"{NEW|INV}"	N/A N/A
TA_NETPRIO( * )	long	rwyrw----	1 <= num < 8192	100
(r) - Required field for object creation (SET TA_STATE NEW) ( * ) - GET/SET key, one or more required for SET operation

Attribute Semantics

TA_NETGROUP:string[1 . . .30]

Logical name of the network group. A group name is a string of printable characters and cannot contain a point sign, comma, colon, or newline.

TA_NETGRPNO: 1 <= num <= 8192

Group identifier associated with network group.

TA_STATE:

GET: {VALid}

A GET operation will retrieve configuration information for the selected T_NETGROUP object(s). The following states indicate the meaning of a TA_STATE returned in response to a GET request. States not listed will not be returned.

VALid

T_NETGROUP object is defined and inactive. Note that this is the only valid state for this class. NETGROUPs are never ACTive.

SET: {NEW|INValid}

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

NEW	Create T_NETGROUP object for application. State change allowed only when in the INValid state. Successful return leaves the object in the VALid state.
unset	Modify an existing T_NETGROUP object. Only allowed in the VALid state. Successful return leaves the object state unchanged.
INValid	Delete T_NETGROUP object from application. State change allowed only when in the VALid state and only if there are no objects in the T_NETMAP class which have this network group object as a key. Successful return leaves the object in the INValid state.

TA_NETPRIO:1 <= num < 8192

The priority band for this network group. All network groups of equivalent band priority will be used in parallel. If all network circuits of a certain priority are torn down by the administrator or by network conditions, the next lower priority circuit is used. Retries of the higher priority are attempted.

Note: In Release 6.4, parallel data circuits are prioritized by network group number (NETGRPNO) within priority group number. In future releases, a different algorithm may be used to prioritize parallel data circuits.

Limitations

None.

---

---