XML-NTEXT Special Register

The XML-NTEXT special register is defined during XML parsing to contain document fragments that are USAGE NATIONAL.

XML-NTEXT is an elementary national data item of the length of the contained XML document fragment. The length of XML-NTEXT can vary from zero through 8,000,000 national character positions. The maximum byte length is 16,000,000.

Note: There is no equivalent COBOL data description entry.

When used in nested programs, this special register is implicitly defined with the global attribute in the outermost program.

The parser sets XML-NTEXT to the document fragment associated with an event before transferring control to the processing procedure, in these cases:

When XML-NTEXT is set, the XML-TEXT special register has a length of zero. At any given time, only one of the two special registers XML-NTEXT and XML-TEXT has a non-zero length.

Use the LENGTH function to determine the number of national characters that XML-NTEXT contains. The LENGTH OF special register for XML-NTEXT has the number of bytes, rather than the number of national characters, contained in XML-NTEXT.

Note: Start of change The START-DOCUMENT event may be greater than 8,000,000 national characters. In this case, special register XML-NTEXT will contain only the first 8,000,000 characters of the event, and its LENGTH will be set to 16,000,000 bytes. End of change

XML-NTEXT cannot be used as a receiving item.