XML TEST WELLFORMED-TEXT

This statement has the following parameter:

Parameter Description
DocumentPointer Identifier of a COBOL pointer data item that points to an XML document stored in memory as a text string.
DocumentLength Numeric literal or identifier of a COBOL numeric data item that specifies the length of the XML document stored in memory as a text string.

Description

The XML TEST WELLFORMED-TEXT statement tests the XML document specified by the DocumentPointer and DocumentLength parameters to see if it is well-formed. A well-formed XML document is one that conforms to XML syntax rules, but is not necessarily valid with respect to any schema. see ML VALIDATE FILE and XML VALIDATE TEXT for testing whether a document is valid with respect to a schema.

A status value is returned in the data item XML-Status of XML-data-group, which is defined in the copy file lixmldef.cpy.

Example

XML TEST WELLFORMED-TEXT
    MY-DOCUMENT-POINTER
    MY-DOCUMENT-LENGTH.
IF NOT XML-OK GO TO Z.