The
path option specifies the path to the element as it
appears in the XML document, with elements separated by forward slashes.
For example, if this option is path=main/info/name, the parser will
expect the document element to be "main", a child of "main" to be
"info", and a child of "info" to be "name". If no element can be found,
the operation will fail with status 00353 (XML does not match RPG
variable).
Note: The value of the "allowmissing" option
has no effect on this situation.
Note: The path option
is required when %HANDLER is used to specify an array-handling procedure.
Default: When the
path option is
not specified, the search for the XML element matching the RPG variable
depends on the type of the variable.
- For non-array variables, the outermost XML element is expected
to have the same name as the RPG variable.
- For array variables, the outermost XML element is expected to
have child elements with the same name as the RPG array variable.
The outermost XML element can have any name.
Note: - If the variable is a qualified subfield, only the name of the
subfield is used in determining the path to the XML variable. For
example, if the variable is DS.SUB1, the default is to expect the
outermost XML element to be called "sub1".
- The path specified by this option is case sensitive. It must be
in the same case as the matching elements in the XML document unless
the case option is also specified.