`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 XML 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.