Additional Parameter Required with XML Extensions Processing Statements

In statements that use a Document Pointer parameter, you are also required to pass an additional Document Length parameter.

When using XML Extensions processing statements, each Document Pointer parameter must be immediately followed by a Document Length parameter. This applies to the following statements:

XML EXPORT TEXT
XML IMPORT TEXT
XML TEST WELLFORMED-TEXT
XML VALIDATE TEXT
XML GET TEXT
XML PUT TEXT
XML TRANSFORM TEXT

Note: XML FREE TEXT does not require that you use the Document Length parameter.

Solution:

Ensure that the Document Length parameter (MY-DOCUMENT-LENGTH) is specified immediately following the Document Pointer parameter (MY-DOCUMENT-POINTER) when calling an XML Extensions processing statement:

When the statement is outputting data, the statement will set MY-DOCUMENT-LENGTH:

XML EXPORT TEXT
        MY-DATA-ITEM
        MY-DOCUMENT-POINTER
        MY-DOCUMENT-LENGTH
        "MY-MODEL-FILE".
IF NOT XML-OK GO TO Z.

When the statement is inputting data, you must set MY-DOCUMENT-LENGTH before the statement is processed:

XML IMPORT TEXT
        MY-DATA-ITEM
        MY-DOCUMENT-POINTER
        MY-DOCUMENT-LENGTH *> Item size MY-DOCUMENT-POINTER points to.
        "MY-MODEL-FILE".
IF NOT XML-OK GO TO Z.