CLEAR( ) method (ProDataSet Object Handle)

Removes all elements from a dynamic ProDataSet object including buffers and relations.

Return type: LOGICAL

Applies to: ProDataSet object handle

Syntax

CLEAR ( )

This method restores the state of the dynamic ProDataSet object to what it was immediately after the CREATE DATASET statement.

If an error occurs while executing the CLEAR() method, the method returns FALSE. Otherwise, it returns TRUE.

Note: If you call CLEAR() or CREATE-LIKE() more than once on a dataset, the dynamic temp-tables from the prior call(s) are not deleted automatically and have the potential to cause a memory leak. Therefore the application is responsible for deleting the temp-tables if CLEAR() or CREATE-LIKE() are called again.