Release 10.1A: OpenEdge Development:
Progress 4GL Reference

> ## CLEAR( ) method

> 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.

Copyright © 2005 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095