LOAD
The LOAD command is used to parse and load the XML document whose contents are to be queried.
The LOAD command must be executed successfully before using the SET or QUERY commands.
Required
LOAD ------- FILE ------------- file path -------------------->
-----------------------------------------------------------------
Optional
>-- VALIDATE ---------- *NO ------------------------->
*YES
>-- NAMESPACEAWARE ---- *NO -------------------------|
*YES
Keywords
| FILE |
The path and file name for the XML document whose contents are to be queried. |
| VALIDATE |
By default (and if you specify *NO for this keyword) the XML document is parsed WITHOUT validating it against any DTD or schema it may reference. In this mode, the XML document is required to be well-formed, but conformance to the DTD or schema is NOT checked. For many typical applications of the XMLQueryService, validation is an unnecessary overhead. However, if you require validation to be performed, you may specify *YES for this keyword. |
| NAMESPACEAWAREE
|
By default (and if you specify *NO for this keyword) the XML document is parsed in a non-namespace-aware mode. For most cases, this simplifies the form of the XPath expressions necessary to perform a given query. In some more complex documents (and especially for documents in which more than one namespace is referenced) it may be necessary to specify *YES for this keyword in order to load the document in namespace-aware mode. Note that the value specified (or assumed) for this keyword will affect the form of XPath expressions necessary to successfully perform a given query. |
Examples
RDML Example:
USE BUILTIN(JSM_COMMAND) WITH_ARGS('LOAD FILE(salesorder.xml)') TO_GET(#JSMSTS #JSMMSG)
RDMLX Example:
use builtin(jsmx_command) with_args(#jsmhdle 'load file(salesorder.xml)') to_get(#jsmsts #jsmmsg)
ILE RPG Example:
c eval jsmcmd = 'load'
c + ' file(salesorder.xml)'
c callp p_jsmcmd(jsmcmd:jsmsts:jsmmsg)