Rational Developer for System z
Enterprise PL/I for z/OS, Version 3.8, Programming Guide

Using the PLISAXA and PLISAXB XML parsers

Overview
The PLISAXA built-in subroutine
The PLISAXB built-in subroutine
The SAX event structure
start_of_document
version_information
encoding_declaration
standalone_declaration
document_type_declaration
end_of_document
start_of_element
attribute_name
attribute_characters
attribute_predefined_reference
attribute_character_reference
end_of_element
start_of_CDATA_section
end_of_CDATA_section
content_characters
content_predefined_reference
content_character_reference
processing_instruction
comment
unknown_attribute_reference
unknown_content_reference
start_of_prefix_mapping
end_of_prefix_mapping
exception
Parameters to the event functions
Coded character sets for XML documents
Supported EBCDIC code pages
Supported ASCII code pages
Specifying the code page
Using a number:
Using an alias
Exceptions
Example
Continuable exception codes
Terminating exception codes

The PLISAXx (x = A or B) built-in subroutines provide basic XML parsing capability which allows programs to consume inbound XML documents, check them for well-formedness, and react to their contents.

These subroutines do not provide XML generation, which must instead be accomplished by PL/I program logic or by using the XMLCHAR built-in function.

PLISAXA and PLISAXB have no special environmental requirements. They execute in all the principal run-time environments, including CICS, IMS, and MQ Series, as well as z/OS batch and TSO.

PLISAXA and PLISAXB do have some important limits: they have no support for XML name spaces, no support for Unicode UTF-8 documents, and they require that the entire XML document be passed to them (either in a buffer or a file) before they do any parsing of it. The PLISAXC built-in subroutine does not have these limits, and while it has much similarity with the PLISAXA and PLISAXB built-in subroutines, it is different enough that this chapter will not describe it. The next chapter will discuss PLISAXC in detail.


Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)