Simulator Error Messages and Format

Simulator displays descriptive error messages that provide details about the cause of errors encountered while processing input files.

For errors detected in an input file, such as EMMA input, grammars, and audio files, error messages contain the following information.

• File name (if applicable)

• Number of the line that contains the error (if applicable)

• Message type: Error, Warning, or Info

• Error code (if applicable)

• Error description

Upon successful completion, Simulator displays a message indicating that processing is complete and returns EXIT_SUCCESS (0).

Fatal Errors

When a fatal error occurs, Simulator displays an error message indicating that a fatal error has occurred, halts execution of the tool, and returns EXIT_FAILURE (1). Examples of fatal errors include the following:

• Basic file problems such as failure to find a file, open a file, or write to a file.

• XML file validation issues.

• Configuration issues.

Errors that occur in the underlying recognition services are passed through to the user.

Nonfatal Errors

Nonfatal errors are displayed on the console, and are recorded inside the EMMA document, but do not halt execution. The nonfatal errors are as shown in the following list:

• Cannot connect to recognition services.

• Grammar not found.

• Audio not found.

• Recognition failed.

Remarks

You must either specify a recognition engine configuration file using the /RecoConfig option, or create a default configuration file named "RecoConfig.xml" in the current directory (the directory for the command line), or in the directory that contains Simulator.exe. The tool will generate an error if you do not supply it with a configuration file.