Product Documentation

c-treeRTG V2 Update Guide

Previous Topic

Next Topic

Support for returning 8-byte record position

In V2 and later, the B_GET_POSITION operation returns 8-byte record positions instead of the 4-byte record number used by Btrieve. The operations that accept a record position as input (currently B_GET_DIRECT and B_UNLOCK) now support 8-byte record positions as input.

By default the BTRV interface returns and expects 4-byte record positions, returning error B_DATA_MESSAGE_TOO_SMALL (97) if the record position is over 4GB.

To instruct the BTRV interface to return and expect 8-byte record positions, open the file using a ‑120 bias in keyNum parameter when requesting a B_OPEN operation. For example, to open a file exclusively, pass ‑124 instead of ‑4 in the keyNum parameter.

TOCIndex