CLEAR( ) method (Handle)

This method performs the following actions:

Resets each attribute of a call object to its default value, which lets you reuse a call object.

Removes all elements from a dynamic ProDataSet object including buffers and relations. That is, it restores the state of the dynamic ProDataSet object to what it was immediately after the CREATE DATASET statement.

Initializes the internal state of the Application Debugger.

Clears temp-table definitions and removes temp-table data.

Return type:

LOGICAL

Applies to:

Call object handle, ProDataSet object handle, DEBUGGER system handle, Temp-table object handle

 

Syntax 

CLEAR ( )

For the Application Debugger system handle:

This method has no visible effect on the Debugger window.

If the Debugger is initialized, this method returns TRUE. Otherwise, it returns FALSE with no effect.

Note:

To use this method with the DEBUGGER system handle, you must have the Application Debugger installed in your OpenEdge environment.

For more information on using this method for the Debugger, see the reference entry for the DEBUGGER system handle and OpenEdge Development: Debugging and Troubleshooting.

For the call object handle, this method resets each attribute of a call object to its default value, which lets you reuse a call object.

Note:

To reset just the parameters, set the NUM-PARAMETERS attribute to zero.

For the temp-table object handle:

This method empties the temp-table and removes all its definitional data (field and index definitions and pending saved data). This puts the temp-table object into the CLEAR state, as opposed to the UNPREPARED or PREPARED state.

Calling any method after this one changes the state to UNPREPARED.