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.