T_DEVICE CLASS

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

T_DEVICE Class Definition Attribute Table

Attribute¹ Type Permissions Values Default

TA_LMID( * )
TA_CFGDEVICE( r )( * )
TA_DEVICE( * )
TA_DEVOFFSET( * )
TA_DEVSIZE( r )
TA_DEVINDEX( * )2

string
string
string
long
long
long

ru-r--r--
ru-r--r--
ru-r--r--
ru-r--r--
rw-r--r--
r--r--r--

LMID
string[2...64]
string[2...64]
0 <= num
0 <= num
0 <= num

local_lmid
N/A
TA_CFGDEVICE
0
1000³
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

**T_DEVICE Class Definition Attribute Table**
Attribute¹	Type	Permissions	Values	Default
`TA_LMID( * )` `TA_CFGDEVICE( r )( * )` `TA_DEVICE( * )` `TA_DEVOFFSET( * )` `TA_DEVSIZE( r )` `TA_DEVINDEX( * )2`	string string string long long long	ru-r--r-- ru-r--r-- ru-r--r-- ru-r--r-- rw-r--r-- r--r--r--	LMID string[2...64] string[2...64] 0 <= num 0 <= num 0 <= num	local_lmid N/A `TA_CFGDEVICE` 0 1000³ 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 Class T_DEVICE 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. States not listed will not be returned. 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, then 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.

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

`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, then 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.

[Top] [Prev] [Next] [Bottom]