The following table describes the messages that may be generated when an error occurs in XML Extensions:
Message Number | Severity and Message Text | Description |
-5 | Warning - ambiguous model data name | More than one matching data name was found in the document. The most recently found data name is used. |
-4 | Warning - subscript out of range | A subscript is out of range on import. The offending item is not imported. |
-3 | Warning - data truncation | A nonnumeric import item has been truncated to fit the associated COBOL data item. |
-2 | Warning - extraneous element | The import data contains one or more elements that do not belong anywhere in the COBOL data structure; the element(s) have been ignored. |
0 | Success | A normal completion occurred. No informative, warning, or error message was detected. |
1 | Informative - directory contains no documents | An XML FIND FILE statement did not find any XML documents (files with an .xml extension) in the specified directory. |
2 | Informative - document file - no data | An XML EXPORT FILE or an XML EXPORT TEXT statement generated a document that contained no element values. |
3 | Warning - internal logic - memory not deallocated | During process cleanup, memory blocks that should have already been deallocated were still allocated. |
9 | Error - in function: CreateDocument | The underlying XML parser detected an error while trying to create an XML document. |
10 | Error - cannot create URL | The XML Extensions library detected that a URL (a string beginning with the sequence http://, https://, or file://) was used as an output document name. |
12 | Error - data item - not found | The XML Extensions library detected that there are no occurrences of the specified data item name in the COBOL object file or library. |
13 | Error - document file - create failure | An attempt to create an XML document file failed. |
14 | Error - document file - file open failure | The XML Extensions library detected an error while attempting to open an XML document file. |
15 | Error - extraneous element | The XML Extensions library detected an extra occurrence of a scalar data element. |
17 | Error - in function: GetFirstChild | The XML Extensions library detected an error in the function GetFirstChild while parsing an XML document. |
18 | Error - in function: GetNextSibling | The XML Extensions library detected an error in the function GetNextSibling while parsing an XML document. |
19 | Error - in function: GetNodeData | The XML Extensions library detected an error in the function GetNodeData while parsing an XML document. |
20 | Error - in function: GetRootNode | The XML Extensions library detected an error in the function GetRootNode while parsing an XML document. |
21 | Error - internal logic - memory allocation | An attempt to allocate a block of memory failed. |
22 | Error - internal logic - memory corruption | An attempt to deallocate (free) a block of memory failed either because the block header or trailer was corrupted or because the free memory call returned an error. |
23 | Error - internal logic - node not found | The XML Extensions library detected an inconsistency in its internal tables. Specifically, an expected entry in the Document Object Model is missing. |
24 | Error - in function: Initialization | Either an XML statement (other than XML INITIALIZE) was executed without first executing the XML INITIALIZE statement or the XML INITIALIZE statement failed. |
25 | Error - invalid data address | The XML Extensions library detected that the data structure address specified in an XML IMPORT or an XML EXPORT statement does not match the data address specified in the template file. This normally means that the COBOL program has been re-compiled but the model files produced by the XMLGEN compiler directive were not re-generated and are outdated. |
28 | Error - in function: LoadDocument | An error was detected while trying to load an XML document. This normally means that there was a problem locating the document (either the document does not exist or there is a problem with permissions). Occasionally, XML Extensions generates documents that are then loaded as input documents. In the unlikely event that the generated document contains errors, a load document error will be encountered. |
29 | Error - in function: LoadSchema | An error was detected while trying to load an XML schema file. This normally means that there was a problem locating the document (either the document does not exist or there is a problem with permissions) or that the schema itself is in error. |
30 | Error - in function: LoadStyleSheet | An error was detected while trying to load an internal or external XSLT stylesheet. This normally means that there was a problem locating the document (either the document does not exist or there is a problem with permissions). Another possible cause is that the XML parser software is not properly installed. |
32 | Error - in function: LoadTemplate | An error was detected while trying to load an XML template file. This normally means that there was a problem locating the document (either the document does not exist or there is a problem with permissions). Another possible cause is that the XML parser software is not properly installed. |
35 | Error - subscript out of range | While executing an XML IMPORT FILE or an XML IMPORT TEXT statement, the XML Extensions library detected that a subscript reference is out of range (the subscript value is greater than the maximum for the array). This may occur either when the subscript is explicitly supplied in an attribute or when the subscript is generated implicitly (when an extra occurrence is present). |
36 | Error - temporary file access error | The XML Extensions library encountered an error while attempting to access a temporary intermediate file. This error can occur during the XML IMPORT TEXT, XML EXPORT TEXT, XML VALIDATE TEXT, or XML TEST WELLFORMED-TEXT statements. |
37 | Error - in function: TransformDOM | An unexpected error occurred while performing an XSLT transform of an XML document. This might be an internal error, but can be caused by an error in an external stylesheet. |
38 | Error - in function: TransformText | An error occurred while performing an XSLT transform of an XML document using an external (user-supplied) XSLT stylesheet. This error may occur in the XML Extensions library. |
39 | Error - symbol table - not present in model file | The symbol table was not found in the specified model file. The model file was probably not produced by the XMLGEN compiler directive. |
42 | Error - in function: WriteDocument | An error occurred while attempting to write an XML document from the internal Document Object Model representation. |
45 | Error - invalid encoding selection | The value of the Encoding parameter of the XML SET ENCODING statement was neither "local" nor "utf-8". |
46 | Error - invalid UTF-8 data | An XML export operation failed because the data supplied was not valid for UTF-8. |
47 | Error - invalid MF_XMLEXT_LOCAL_ENCODING value | The value of the MF_XMLEXT_LOCAL_ENCODING environment variable on UNIX is not any of "mflatin1", "mflatin9", or a name recognized by the available iconv library. |
48 | Error - unable to locate iconv library | The value of the MF_XMLEXT_LOCAL_ENCODING environment variable on UNIX is not "mflatin1" nor "mflatin9", but an iconv library for character conversions could not be found. |
49 | Error - directory open failure | The XML FIND FILE statement was not able to locate and open the specified directory. |
50 | Error - missing XML parser (MSXML6) | The XML parser could not be found. This error occurs only on Windows and indicates the MSXML 6.0 parser is not installed in the Windows system. The MSXML 6.0 parser is normally installed when Visual COBOL is installed on Windows, but could not be found. MSXML 6.0 can be obtained by downloading it from Microsoft's web site. |
51 | Error - data item - illegal name format | A data-name being exported does not begin with an initial name character (letter, colon or underscore). This error should occur only for version 1.0 template files when a COBOL data-name begins with a digit. For version 2.0 template files, COBOL data-names that begin with a digit are prefixed with an underscore. |
52 | Error - CodeBridge conversion failure | The attempted conversion of data to or from a COBOL data type and a displayable string acceptable to XML failed. |
53 | Error - Name specified is not a data-item | When specifying a data structure name, a name was provided that is not a data item. For example, it might be a file-name, an index-name, a constant-name, and so forth. A data item name is required. |
62 | Error - requested template file cannot be found | Requested template file specified by the model file data name parameter cannot be found. |
63 | Error - resolved file name is too long | The resolved filename from one of the following statements is too large to fit in the buffer provided: XML EXPORT FILE XML EXPORT TEXT XML IMPORT FILE XML IMPORT TEXT XML RESOLVE DOCUMENT-FILE XML RESOLVE SCHEMA-FILE XML RESOLVE STYLESHEET-FILE XML RESOLVE MODEL-FILE |
64 | Error - resolved file name does not exist | The file name passed to one of the following statements cannot be resolved. It may not exist and is not accessible. XML EXPORT FILE XML EXPORT TEXT XML IMPORT FILE XML IMPORT TEXT XML RESOLVE DOCUMENT-FILE XML RESOLVE SCHEMA-FILE XML RESOLVE STYLESHEET-FILE |
65 | Error - name / value pair required | The XML SET XSL-PARAMETERS statement requires an even number of parameters (name / value pairs). |
66 | Error - excessive number of XSL parameters | The XML SET XSL-PARAMETERS statement is limited to a maximum of 40 parameters (20 name / value pairs). |
67 | Error - unique identifier too long for buffer | The buffer supplied in the XML GET UNIQUEID statement is too small. Unique identifiers require 38 character positions. |
68 | Error - add attribute node failed | Adding an attribute to the document failed. |
69 | Error - add element node failed | Adding an element to the document failed. |
70 | Error - add text node failed | Adding a text mode to the document failed. |
71 | Error - validate DOM document | Validating the DOM document failed. |
72 | Error - incorrect XML statement parameters | One or more of the parameters passed into the XML statement are invalid. |