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

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

T_TLOG Class Definition

Overview

The T_TLOG class represents configuration and run-time attributes of transaction logs. This class allows the user to manipulate logs within an application, that is, create, destroy, migrate, and so on.

Attribute Table

Table 61 TM_MIB(5): T_TLOG Class Definition Attribute Table

Attribute¹	Type	Permissions	Values	Default
`TA_LMID`(*)	string	`r--r--r--`	`LMID`	N/A
`TA_STATE`(k)	string	`r-xr-xr--`	`GET`: `"`{`ACT` \| `INA` \| `WAR`}`"` `SET`: `"WAR"`	N/A N/A
`TA_TLOGCOUNT`	long	`r-xr-xr--`	1 <= `num`	N/A
`TA_TLOGINDEX`	long	`r-xr-xr--`	0 <= `num`	N/A
`TA_GRPNO`(k)	long	`r--r--r--`	1 <= `num` < 30,000	(²)
`TA_TLOGDATA`	string	`r-xr-xr--`	`string`[1..256]	(²)
(k)—`GET` key field (*)—`GET/SET` key, one or more required for `SET` operations

¹All attributes in the T_TLOG class are local attributes
²One or more TA_GRPNO and TA_TLOGDATA attribute values may be returned with each object of the T_TLOG class. The attribute values for each of these attributes belonging to the particular object are the TA_TLOGCOUNT number of occurrences beginning with the TA_TLOGINDEX.

Attribute Semantics

TA_LMID: LMID

Transaction log logical machine identifier.

TA_STATE:

GET: "{ACTive | INActive | WARmstart}"

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

`ACTive`	The transaction log exists and is actively logging commit records for transactions coordinated on the site. This corresponds to the associated `T_MACHINE` object being active.
`INActive`	The transaction log exists but is currently inactive. This state corresponds to the associated `T_MACHINE` object being inactive and can only be returned if the site has a tlisten(1) process running; otherwise, the site is unreachable and a object will not be returned.
`WARmstart`	The transaction log exists, is currently active, and is marked for warmstart processing. Warmstart processing will occur when the next server group is started on the site. This state is `ACTive` equivalent for the purposes of determining permissions.

SET: "{WARmstart}"

A SET operation will update log configuration and run-time information for the selected T_TLOG object. The following states indicate the meaning of a TA_STATE set in a SET request. States not listed may not be set.

`unset`	Modify `T_TLOG` object. Allowed only when in the `ACTive` state. Successful return leaves the object state unchanged. The only object modifications permitted on this class are additions to the transaction log. In this case, `TA_TLOGINDEX` and `TA_TLOGCOUNT` indicate the objects of `TA_TLOGDATA` to be added.
`WARmstart`	Initiate warmstart for the `T_TLOG` object. State change allowed only when in the `ACTive` state. Successful return leaves the object in the `WARmstart` state.

TA_TLOGCOUNT: 1 <= num

Number of transaction log data records (TA_TLOGDATA) counted, retrieved, or to be added. This attribute is ignored for SET operations with a state change indicated. For valid SET operations with no state change, this attribute indicates the number of log records to be added to an active transaction log. A GET operation with neither TA_GRPNO nor TA_TLOGDATA specified returns a count of in-use log records. A GET operation with only TA_GRPNO set will return a count of in use log records with a coordinator group matching the indicated group. A GET operation with only TA_TLOGDATA set ("") will return a count of in use log records and populate arrays of TA_TLOGDATA and TA_GRPNO attribute values corresponding to the in use log records. A GET operation with both TA_GRPNO and TA_TLOGDATA set ("") will return a count of in use log records with a coordinator group matching the indicated group and populate arrays of TA_TLOGDATA and TA_GRPNO attribute values corresponding to the in use log records.

TA_TLOGINDEX: 0 <= num

Index of the first object specific attribute values (TA_GRPNO and TA_TLOGDATA) corresponding to this object.

TA_GRPNO: 1 <= num < 30,000

Transaction coordinator's group number.

TA_TLOGDATA: string[1..256]

Formatted transaction log entry. This attribute value should not be interpreted directly. Rather, it should be used solely as a means of migrating log records as part of server group migration.

Limitations

None