Micro Focus Visual COBOL 2.3 for Visual Studio 2015 > Programming > COBOL Programming > Using COBOL and XML together > XML Extensions > XML Extensions statements reference > Document processing statements > XML TEST WELLFORMED TEXT

XML TEST WELLFORMED TEXT

This statement has the following parameters:

Parameter	Description
DocumentPointer	The name of a COBOL pointer data item that points to an XML document that is stored in memory as a text string.
DocumentLength	The name of a COBOL numeric data item that contains the length of the XML document pointed to by DocumentPointer.

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 XML-data-group data item, which is defined in the copybook, lixmldef.cpy.

Example

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