27.10.2013 Views

Firebird 2.1 Release Notes

Firebird 2.1 Release Notes

Firebird 2.1 Release Notes

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

Changes to the <strong>Firebird</strong> API and ODS<br />

The current value of FB_API_VER is 20 (two-digit equivalent of 2.0). This macro can be used by client applications<br />

to check the version of ibase.h its being compiled with.<br />

Additions to the isc_database_info() Structure<br />

V. Khorsun<br />

The following items have been added to the isc_database_info() function call structure:<br />

isc_info_active_tran_count<br />

Returns the number of currently active transactions.<br />

isc_info_creation_date<br />

Returns the date and time when the database was [re]created.<br />

To decode the returned value, call isc_vax_integer twice to extract (first) the date and (second) the time<br />

portions of the ISC_TIMESTAMP. Then, use isc_decode_timestamp() as usual.<br />

Additions to the isc_transaction_info() Structure<br />

V. Khorsun<br />

The following items have been added to the isc_transaction_info() function call structure:<br />

isc_info_tra_oldest_interesting<br />

Returns the number of the oldest [interesting] transaction when the current transaction started. For snapshot<br />

transactions, this is also the number of the oldest transaction in the private copy of the transaction inventory<br />

page (TIP).<br />

isc_info_tra_oldest_active<br />

• For a read-committed transaction, returns the number of the current transaction.<br />

• For all other transactions, returns the number of the oldest active transaction when the current transaction<br />

started.<br />

isc_info_tra_oldest_snapshot<br />

Returns the number of the lowest tra_oldest_active of all transactions that were active when the current<br />

transaction started.<br />

Note<br />

This value is used as the threshold ("high-water mark") for garbage collection.<br />

19

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!