Error handling

Each check box on this tab corresponds to a message EO sub-module. The default is unchecked.

Selecting a check box elevates warnings that are thrown in the given message sub-module to errors.

These flags are stored as entries in the siteInfo file:

  • elevateWarningToErrorForRecParse=NO
  • elevateWarningToErrorForRecDefLoad=NO
  • elevateWarningToErrorForRecFormat=NO
  • elevateWarningToErrorForRecDefQuery=NO

They display after the current LogHistoryCompressCommand entry. The default is "NO", where the engine treats warnings in these categories as warnings. It prints a "WARN" message to the engine log, returns a warning message to Tcl, and then continues processing.

If they are set to "YES", then warnings in these categories are treated as errors. The "ERR" message is printed to the engine log, processing stops, and the message is transferred to the Error DB.

This table shows the available options on the Error handling tab:

Xlate Route Details dialog box

In Network Configurator, an Xlate Route Details dialog box opens when you click an xlate Type on the Route Messages or Route Replies tab. You can use this dialog box to indicate whether to error out the transaction. For example, in case there are warnings when parsing the incoming HMD message (Elevate warnings to errors . . .). Selecting this elevates warnings from the Message RefParse sub-module to errors on a per-route basis.

When this is selected, it overrides the RecParse setting (Message Parsing) in Site Preferences. If cleared, then it inherits the value from the Site Preferences dialog box.

The settings are stored as a new route detail entry in the NetConfig file.

The error control settings that are configured in individual translation actions override the site preferences and xlate route details settings.

For example, elevateWarningToErrorForRecParse=NO, ELEVATEWARNINGFORPARSE=1, error=skip, and there is a parse problem during a COPY action. The engine ignores the error because the error setting in the translation action takes precedence.