KI_SET_EXTENT

Defines how tables extents should be allocated

Synopsis:
CALL KI_SET_EXTENT handle, percent, mode TO status
status = 'ki_set_extent( handle, percent, mode )
ArgumentEnumerationPurpose
handleHandle
percentPercentage of original table size for the extent
modeMode flags
statusKDB_ERROR_ENUMReturn status
>KI_SET_EXTENT

KI_SET_EXTENT

The argument percent is the percentage of current maximum rows the table should automatically be extended by when either the index or data fills. Set this to zero to disable autoextending. The mode is a bit field.

BitPurpose
0x01auto-reindex ON if set (KDB6 only)
0x02auto-extension ON if set

Compatibility

This has no effect on Oracle tables. The size of extents should be configured when the tablespaces are created.

KDB7 tables will extend automatically up to the available space in the filesystem. If the percentage is not set with an EXTEND clause in CREATE TABLE the default is 50%.

KDB6 tables can extend automatically for a limited number of extents. KDB5 and earlier cannot do this on their own but KI_GROW and KI_EXTEND and manually extend a table. KDB6 tables can recover space and postpone running out of space by reindexing on the fly. This is not enabled by default.

When a table is extended or re-indexed automatically a warning entry is raised in the error log (see WRITE LOG for more about error logs).

History
Introduced in KCML 5.03
See Also:
KI_COPY_TABLE, KI_CREATE, KI_CREATE_TMP, KI_DELETE_ROWS, KI_GET_SERIAL, KI_GROW, KI_INFO, KI_INITIALISE, KI_LOCK_ALL, KI_LOCK_OWNER, KI_MOVE_ROWS, KI_MOVE_TABLE, KI_OPEN, KI_READ, KI_READ_HOLD, KI_READ_HOLD_NEXT, KI_READ_HOLD_PTR, KI_READ_NEXT, KI_READ_PTR, KI_READ_RAW, KI_REBUILD, KI_REWRITE, KI_SET_ROWS, KI_SET_SERIAL, KI_SET_WLOCK_COUNT, KI_SIZE_FILE, KI_START, KI_START_BEG, KI_UNLOCK, KI_UNLOCK_FILE, KI_VERIFY, KI_WMODE_BITMAP, KI_WRITE, KI_WRITE_PTR, KI_WRITE_RAW, KI_WS_CREATE, KI_WS_DELETE, KI_WS_OPEN, KI_WS_READ, KI_WS_REWRITE, KI_WS_WRITE
KCML database status codes