KI_EXTEND

Create a larger copy of a table

Synopsis:
CALL KI_EXTEND handle, new_handle, file$, size TO status
status = 'ki_extend( handle, new_handle, file$, size )
ArgumentEnumerationPurpose
handleHandle to source file
new_handleHandle of new file
file$New file name
sizeNumber of rows in new file
statusKDB_ERROR_ENUMReturn status
>KI_EXTEND

KI_EXTEND

The original table must already be open on handle handle. When called, the routine will create a new table with the supplied name and open it exclusively on the given handle new-handle. The data from the original table will be copied across to the new table and the controls updated. The new size must be greater than the original size. The index information is not copied and must be rebuilt with a call to KI_REBUILD.

This routine has been largely superseded by KI_GROW which uses extents and is faster and more flexible, and is NOT available for type 7 tables.

History
Introduced in KCML 3.00
See Also:
KI_CLOSE, KI_CLOSE_TABLE, KI_DB_NAME, KI_DESCRIBE_KEY, KI_DESCRIBE_SCHEMA, KI_DROP_TABLE, KI_GET_COL_LIST, KI_GET_HANDLE, KI_GET_SERIAL, KI_INFO, KI_INITIALISE, KI_LOCK_ALL, KI_OPEN, KI_PREFETCH_ROWS, KI_REBUILD, KI_RESET_CACHEID, KI_SET_DATESTAMP, KI_SET_SERIAL, KI_SET_TIMESTAMP, KI_SET_USERSTAMP, KI_SET_WLOCK_COUNT, KI_UNLOCK_FILE, KI_VERIFY, KI_WMODE_BITMAP
KCML database status codes