Call this subprocedure to parse either an XML document residing in the IFS or the contents of an RPG variable that contains XML.
Note: Sending to standard out (using RXS_STDOUT for pOutType) when offering a web service generally executes faster because it does not need to go to an IFS stream file first. Using RXS_VAR for pOutType will also execute slightly faster when executing a web service on a remote machine because it does not need to go to an IFS stream file.
Ordinarily you will set up or “register” handler pointers using one or all of the following subprocedures before calling RXS_parse():
The RXS_parse() function will run even if you do not register any handlers. However, if you do not specify any handlers, the parser will only notify the program when it finds XML errors. It will not return notice of any other events.
Every locally defined subprocedure registered with the parser as an event handler must have the four parameters listed in the following example:
D Handler pi
D pType value like(RXS_Type)
D pXPath value like(RXS_XPath)
D pData value like(RXS_XmlData)
D pDataLen value like(RXS_Length)