Error Handling

As soon as something goes wrong when processing a request, an error is generated and put into the response document. The status of the response will be set to "Error" or "Warning" depending on the severity of the error. In case of an error, processing will abort immediately, while in case of a warning processing continues.

An error has the following format:

<Error Id=”12345”>
  <Severity>Error/Warning</Severity>
  <Description>Short description</Description>
  <ExternalDescription>An external error text if available</ExternalDescription>
</Error>
<ValidateErrors>
  <ValidateError LineNo="logic_line_no" ArgumentNo="argument_no">
    <Severity>Error/Warning</Severity>
    <Id>syntax_error_id</Id>
    <Description>error description</Description>
    <Details>additional details</Details>
  </ValidateError>
    . . .
    . . .
</ValidateErrors>

Example response when trying to validate a constant with a non exisiting data dictionary:

<ProLinga>
  <Validate Version="1.0">
    <Command Name="Validate" Mode="Response" Status="Error">
      <Object Application="Advance" Type="Constant" Name="Test2">
        <Error Id="30010">
          <Severity>Error</Severity>
          <Description>Contains Validate Errors</Description>
          <ExternalDescription></ExternalDescription>
        </Error>
        <ValidateErrors>
          <ValidateError LineNo="0" ArgumentNo="1">
           <Severity>Error</Severity>
           <Id>40009</Id>
           <Description>Invalid Data Dictionary Name</Description>
           <Details>Namexxx</Details>
          </ValidateError>
        </ValidateErrors>
      </Object>
    </Command>
  </Validate>
</ProLinga>

The "External" element will contain any error text passed on from the O/S or 3rd party products.

The following errors are defined:

Table 2. Errors

Error Id	Severity	Description
30000	Ok	No Error
30001	Error	Error parsing document
30002	Error	Empty document
30003	Error	Invalid root element
30004	Error	Invalid validate XML file
30005	Warning	No document match
30006	Warning	Document not found
30007	Warning	Document already deleted
30008	Error	Can not parse return string
30009	Error	Can not write document to repository
30010	Error	Contains Validate Errors
30011	Error	Invalid object document layout
30012	Warning	Object does not need to be validated

The following 4GL Syntax errors are defined:

Table 3. 4GL Syntax Errors

Error Id	Severity	Description
40000	Ok	No Error
40001	Error	No language validation document
40002	Error	Invalid logic command
40003	Error	Invalid number of arguments
40004	Error	Invalid argument
40005	Error	Valid argument, invalid as closing argument
40006	Error	Structure control command defined outside structure
40007	Error	Structure close command defined outside structure
40008	Error	Missing structure close command
40009	Error	Invalid Data Dictionary name
40010	Error	Invalid Record name
40011	Error	Invalid Index Name
40012	Error	Invalid Data Source Name
40013	Error	Invalid Logic Name