Daylight v4.9
Release Date: 1 February 2008

Name

dt_thor_autocrunch_limit - specify the trigger for automatic unused space recovery

Generic Prototype

dt_thor_autocrunch_limit(dt_Handle, dt_Real) => dt_Real

C Prototype

#include "dt_thor.h"

dt_Real dt_thor_autocrunch_limit(dt_Handle database, dt_Real value)

FORTRAN Prototype

include 'dt_f_thor.inc'

real*4 dt_f_thor_autocrunch_limit(database, value)

integer*4 database
real*4 value

Description

Sets a databases "autocrunch" parameter, which is used to trigger an automatic database crunch whenever the fraction of free space exceeds 'value'. The free space is calculated as: free = free_bytes / (free_bytes + used_bytes).

When 'value' is less than 0.0, the function returns the current autocrunch limit, without modifying it. When 'value' is 1.0, the function disables autocrunch for the database. Values of greater than 1.0 are not allowed.

Return Value

Returns the autocrunch limit for the database, or -1.0 if an error is detected (such as trying to change a database that wasn't opened with executive permission).

Related Topics

dt_thor_crunchdata(3) dt_thor_crunchxref(3)