Build Parsing Subprocedure (BLDPRS)

The BLDPRS command is used to aid in writing RPG-XML Suite XML parsing code to be used with the RXS_Parse() subprocedure. RXS_Parse() relies on a “handler” subprocedure which can capture various XML parsing events, giving you access to the data in an XML document.

Note: You will need to make manual modifications to the generated parsing “handler” in addition to importing it into your program.

Please follow our example on Creating an XML Parsing Subprocedure to understand this process.

Parameters

Source Library (SRCLIB)

This is a required parameter.

Specify the library name where your parsing handler subprocedure source file member should be created.

Possible Values:

character-value
Library name to create the source file member in.

Source File (SRCPF)

This is a required parameter.

Specify the file name where your parsing handler subprocedure source file member should be created.

Possible Values:

character-value
File name to create the source file member in.

Source Member (SRCMBR)

This is a required parameter.

Specify the member name where your parsing handler subprocedure source file member should be created.

Possible Values:

character-value
Member name to hold the generated parsing handler subprocedure.

IFS XML Location (IFSXMLLOC)

This is a required parameter.

Specify an IFS file path to the stream file containing your XML to build the parsing handler subprocedure from. This must be a fully qualified file path.

Possible Values:

character-value
IFS path to XML file to build parsing handler subprocedure from.

Base Envelope (BASEENV)

This is a required parameter.

Specify the beginning portion of an XPath that is repeated for every element or attribute in the XML document.

Possible Values:

character-value
XPath to use as the base path to simplify code generation.

Generate Content Parsing (XMLCONTENT)

Specify whether or not XML “content” events should be captured in the generated parsing handler subprocedure.

Possible Values:

*YES
Generate XML "content" events
*NO
Do not generate XML "content" events

Generate Begin Element Parsing (XMLBEGIN)

Specify whether or not XML “begin element” events should be captured in the generated parsing handler subprocedure.

Possible Values:

*YES
Generate XML "begin element" events
*NO
Do not generate XML "begin element" events

Generate End Element Parsing (XMLBEGIN)

Specify whether or not XML “end element” events should be captured in the generated parsing handler subprocedure.

Possible Values:

*YES
Generate XML "end element" events
*NO
Do not generate XML "end element" events

Generate Attribute Parsing (XMLBEGIN)

Specify whether or not XML “attribute” events should be captured in the generated parsing handler subprocedure.

Possible Values:

*YES
Generate XML "attribute" events
*NO
Do not generate XML "attribute" events