Progress
Language Reference


DELETE OBJECT Statement

Interfaces
OS
SpeedScript
All
All
Yes

Deletes an instance of an object such as a widget, a procedure, a server, or a socket. Deleting the handle causes all allocated resources associated with the handle to be returned to the system.

SYNTAX

DELETE OBJECT handle [ NO-ERROR ] 

handle

A handle to the object to delete. The handle parameter must be a variable of type HANDLE and must contain a valid handle.

If the handle parameter refers to a widget handle, the DELETE OBJECT statement is a synonym for the DELETE WIDGET statement.

If the handle parameter refers to a persistent procedure handle or proxy persistent procedure handle, the DELETE OBJECT statement is a synonym for the DELETE PROCEDURE statement. This statement deletes a local persistent procedure handle immediately. For a proxy persistent procedure handle, this statement deletes
the handle immediately unless there is an outstanding asynchronous request on this
handle (handle:ASYNC-REQUEST-COUNT is greater than zero (0)). If handle:ASYNC-REQUEST-COUNT is greater than zero (0), this statement raises the ERROR condition. Otherwise, the statement also sends a request to the AppServer to delete the corresponding remote persistent procedure on the AppServer. If the AppServer is executing any asynchronous requests ahead of it, Progress queues the delete request (as with any asynchronous remote request) until the AppServer is available to handle it.

NOTE: This same behavior occurs if the remote procedure deletes itself (using DELETE...THIS-PROCEDURE) on the AppServer.

For more information on remote persistent procedures, see Building Distributed Applications Using the Progress AppServer .

If the handle parameter refers to a server handle, the DELETE OBJECT statement:

NO-ERROR

Suppresses reporting of errors that occur while DELETE OBJECT executes. Afterwards, you can get information on possible errors by checking the ERROR-STATUS system handle.

NOTES

SEE ALSO

DELETE PROCEDURE Statement, DELETE WIDGET Statement, ERROR-STATUS System Handle


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