getFreeSpace

getFreeSpace(freeSpace: Integer64 output): Integer;

The getFreeSpace method of the JadeDbFilePartition class evaluates the total amount of free space in a single physical database partition and returns the amount as an Integer64 value. This method returns the number of errors encountered, if any, while performing the evaluation operation.

You can initiate the free space evaluation operation while the database is open with update usage; however, if the database mode is not exclusive and is not archive, the file access mode must be read-only.

Restrictions for evaluating free space are those that apply when compacting a database partition. For details, see "Compacting Files", in Chapter 3 of the JADE Database Administration Guide.

This method executes on a persistent server node, and is implemented and executed by the physical database engine. For details, see "Evaluating Free Space", in Chapter 3 of the JADE Database Administration Guide.

An exception is raised if the database partition was not located or there was an error accessing a database partition control file.