Try OpenEdge Now
skip to main content
ABL Reference
Handle Attributes and Methods Reference : SET-INPUT-SOURCE( ) method
 

SET-INPUT-SOURCE( ) method

Specifies the source of XML text to be parsed by a SAX-reader object.
Return type: LOGICAL
Applies to: SAX-reader object handle

Syntax

SET-INPUT-SOURCE ( mode , { file | memptr | handle | longchar } )
mode
A CHARACTER expression evaluating to "FILE", "MEMPTR", "HANDLE", or "LONGCHAR" indicating whether the XML source is a file, a MEMPTR, a WEB-CONTEXT system handle, or a LONGCHAR variable.
file
A CHARACTER expression that indicates the name of a file that contains the source XML text. This can be a relative pathname, an absolute pathname, or an HTTP URL. Any relative pathname is relative to the current working directory. The pathname can contain Unicode characters. See OpenEdge Development: Internationalizing Applications for more information about Unicode.
memptr
A MEMPTR variable that contains the source XML text. The size of the MEMPTR variable must match the size of the XML text.
handle
A WEB-CONTEXT system handle. In a WebSpeed application, this directs SAX-reader to get the XML source from WEB-CONTEXT.
longchar
A LONGCHAR variable that contains the source XML text. The size of the LONGCHAR variable must match the size of the XML text.
The following checks are not performed by SET-INPUT-SOURCE( ) but are performed by SAX-PARSE( ) at run time:
*Whether or not a file exists and is accessible
*Whether or not a MEMPTR is usable
*Whether or not WEB-CONTEXT's XML attribute is YES
Note: If WEB-CONTEXT is used outside of a WebSpeed environment, the AVM raises a run-time error.