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

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

T_DEVICE Class Definition

Overview

The T_DEVICE class represents configuration and run-time attributes of raw disk slices or UNIX system files being used to store BEA Tuxedo system device lists. This class allows for the creation and deletion of device list entries within a raw disk slice or UNIX system file.

Attribute Table

Table 46 TM_MIB(5): T_DEVICE Class Definition Attribute Table

Attribute¹	Type	Permissions	Values	Default
TA_LMID(*)	string	ru-r--r--	LMID	"local_lmid"
TA_CFGDEVICE(r)(*)	string	ru-r--r--	string[2..64]	N/A
TA_DEVICE(*)	string	ru-r--r--	string[2..64]	"TA_CFGDEVICE"
TA_DEVOFFSET(*)	long	ru-r--r--	0 <= num	0
TA_DEVSIZE(r)	long	rw-r--r--	0 <= num	1000 ³
TA_DEVINDEX(*)2	long	r--r--r--	0 <= num	N/A

TA_STATE(k)	string	rwxr--r--	GET: "VAL" SET: "{NEW \| INV}"	N/A N/A
(k)—GET key field (r)—required field for object creation (SET TA_STATE NEW) (*)—GET/SET key, one or more required for SET operations

¹All attributes in the T_DEVICE class are local attributes.
²TA_DEVINDEX is required for SET operations to identify the particular device list entry except when setting the state to NEW for the purpose of creating a new device list entry. In the latter case, TA_DEVINDEX must not be set; a value will be assigned by the system and returned after a successful creation.
³TA_DEVSIZE may only be SET on object creation.

Attribute Semantics

TA_LMID: LMID

Logical machine identifier where the device is located. Note that this attribute may be used as a key field in both unbooted and booted applications as long as they are already configured (that is, at least one T_MACHINE entry is defined). It is required as a key field on SET operations when accessing a booted application. If specified when accessing the T_DEVICE class in an unconfigured application, this attribute is ignored.

TA_CFGDEVICE: string[2..64]

Absolute pathname of the file or device where the BEA Tuxedo filesystem is stored or is to be stored.

TA_DEVICE: string[2..64]

Absolute pathname of the device list entry.

TA_DEVOFFSET: 0 <= num

The offset, in blocks, at which space on this TA_DEVICE begins for use within the BEA Tuxedo System VTOC specified by TA_CFGDEVICE. Limitation: This attribute must be set to 0 for the first device list entry (TA_DEVICE) on the BEA Tuxedo filesystem (TA_CFGDEVICE).

TA_DEVSIZE: 0 <= num

The size in pages of the disk area to be used for the device list entry. Limitation: This attribute may be set only in conjunction with a state change to NEW.

TA_DEVINDEX: 0 <= num

Device index for TA_DEVICE within the device list addressed by TA_CFGDEVICE. This attribute value is used for identification purposes only in getting and setting attribute values relating to particular devices within a BEA Tuxedo filesystem.

TA_STATE:

GET: "{VALid}"

A GET operation will retrieve run-time information for the selected T_DEVICE object(s). The following states indicate the meaning of a TA_STATE returned in response to a GET request.

VALid

The BEA Tuxedo filesystem indicated by TA_CFGDEVICE exists and contains a valid device list. TA_DEVICE is a valid device within that filesystem with the device index telnet lchome3.

SET: "{NEW | INValid}"

A SET operation will update information for the selected T_DEVICE object or add the indicated 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 or reinitialize T_DEVICE object for application. State change allowed only when in the INValid or VALid state. Successful return leaves the object in the VALid state. If this state transition is invoked in the INValid state, the object is created; otherwise, it is reinitialized. The creation of the first TA_DEVICE device list entry on the TA_CFGDEVICE BEA Tuxedo filesystem will automatically create and initialize the necessary VTOC and UDL structures on TA_CFGDEVICE. The first device list entry created for a particular TA_CFGDEVICE must have equivalent values for the TA_DEVICE attribute.

INValid

Delete T_DEVICE object for application. State change allowed only when in the VALid state. Successful return leaves the object in the INValid state. Note that TA_DEVINDEX 0 is special and must be deleted last.

Limitations

None.