Try OpenEdge Now
skip to main content
ABL Reference
Handle Attributes and Methods Reference : SET-READ-RESPONSE-PROCEDURE( ) method
 

SET-READ-RESPONSE-PROCEDURE( ) method

Specifies the name of the procedure to invoke when a READ-RESPONSE event occurs.
Return type: LOGICAL
Applies to: Socket object handle

Syntax

SET-READ-RESPONSE-PROCEDURE ( event-internal-procedure
[ , procedure-context] )
event-internal-procedure
A quoted string or character expression representing the name of an internal procedure that resides within procedure-context. When data is available on the socket, the specified internal procedure is called. If not specified, then no read procedure will be executed when the READ-RESPONSE event occurs.
procedure-context
A handle to a procedure that contains the internal procedure specified by event-internal-procedure. If not specified, THIS-PROCEDURE is used as the procedure-context.

Notes

*Returns FALSE if the procedure-context is not a valid handle; returns TRUE otherwise. If this method is not invoked, or it fails, no read procedure will be executed when the READ event occurs.
*In this procedure, the SELF handle identifies the affected socket object. Once you've ultimately deleted the socket object, you should also delete the SELF handle to avoid a memory leak.