Progress
Version 9
Product Update Bulletin
HANDLER Attribute
A handle to the procedure containing the SAX callbacks.
Data Type: HANDLEAccess: Readable/WritableApplies To: SAX-READER ObjectThe default is a handle to the procedure that contains the SAX-PARSE(), or the SAX-PARSE-FIRST() and the SAX-PARSE-NEXT().
When SAX-PARSE(), SAX-PARSE-FIRST(), or SAX-PARSE-NEXT() executes, the SAX-READER object looks for callbacks only in the procedure whose handle is stored in HANDLER. HANDLER must be a valid procedure handle and cannot be a proxy.
NOTE: It is permissible for both the driver procedure (the procedure containing the SAX-PARSE(), or the SAX-PARSE-FIRST() and SAX-PARSE-NEXT()) and handler procedure of a SAX application to reside on a remote AppServer. If this occurs, callbacks are invoked local to the AppServer.Callbacks can reside within a special handler procedure file that is run persistently or within the driver procedure, which is the procedure that contains the SAX-PARSE(), or the SAX-PARSE-FIRST() and SAX-PARSE-NEXT().
Within a procedure file, to get a handle to the procedure file, use the THIS-PROCEDURE handle. The following fragment assigns HANDLER a handle to the current procedure:
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |