This statement has no named parameters.
Description
A non-successful termination of an XML statement may cause one or more lines of descriptive text to be placed in a queue. The
XML GET STATUS-TEXT statement fetches the next line of descriptive text.
A status value is returned in the data item XML-data-group, which is defined in the copybook,
lixmldef.cpy. The following condition names are also described in this copybook:
- XML-IsSuccess. A successful completion occurred (no informative, warning, or error messages).
- XML-OK. An OK (or satisfactory) completion occurred, including informative or warning messages.
- XML-IsDirectoryEmpty. An informative status indicating that
XML FIND FILE found no XML documents in the indicated directory.
An example of processing the status information in this item is found below and in the copybook,
lixmldsp.cpy.
Example
Display-Status.
If Not XML-IsSuccess
Perform With Test After Until XML-NoMore
XML GET STATUS-TEXT
Display XML-StatusText
End-Perform
End-If.
Note: In the
lixmldef.cpy copybook, the definition of the XML-StatusText field may be edited from the default of 80 to change the size of the buffer used to contain XML status information. See
Displaying Status Information.
