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.

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

If WEB-CONTEXT is used outside of a WebSpeed environment, the AVM raises a run-time error.