Deletes all records from a temp-table associated with a buffer object or from a temp-table directly identified by a temp-table object handle.

When you empty a temp-table that is defined as UNDO within a transaction, the AVM deletes the records individually. This is less efficient than emptying the temp-table outside the transaction, where the AVM deletes all records in the temp-table as a unit.

Return type: LOGICAL

Applies to: Buffer object handle, Temp-table object handle

Syntax

EMPTY-TEMP-TABLE ( )

If the temp-table you invoke this method on was used to populate one or more temp-tables via the GET-CHANGES() method, the AVM sets the ORIGIN-HANDLE attribute for those populated temp-tables to the Unknown value (?).

This method corresponds to the EMPTY TEMP-TABLE statement.

Note: The EMPTY-TEMP-TABLE() method cannot be used together with other assignments in a single ASSIGN statement.