How to Interpret Fatal Error Messages

Last reviewed: 07/14/2010
Article ID: R10044

The information in this article applies to:

SUMMARY

Fatal error messages contain many clues as to what happened when the error was received. The error number and file names are the most important parts of the message. Read the message carefully to make sure you have the error number and all file names associated with the error. If you did not get the entire error, the STERROR.LOG file contains the last 300 lines of error information. If you are using a program that is Version 10.7 or later, select View | Log Files | Error Log. Otherwise, use a text editor, such as Notepad, to open the STERROR.LOG file, which is located in the program directory. (The program directory is shown in the Help | About window.)

Note:  If the fatal error message contains a filename of <filename>.CPP, you can ignore this filename. This file is a generic file and is not a usable file name for error resolution.

MORE INFORMATION

Fatal errors usually include three or four segments. A standard error format contains three segments in which the first segment number is usually less than 1300. An extended error format contains four segments in which the first segment number is usually 1300 or greater. Furthermore, extended errors include a file handler error code. The format of a program exception/access denied error message also contains three segments in which the first segment number is 3000 or 3001.

Use the following table to determine what type of error you received as well as interpret what the error indicates:

Standard
Error Format

N-L-C
    N is the 4 digit Error Number
    L is the location in the source code (usually 0)
    C is the Operating System (OS) error code (sometimes 0)

Note: This format is used if "N" is less than 1300.

Extended
Error Format

N-L-R-C
    N is the 4 digit Error Number
    L is the location in the source code (usually 0)
    R is the file handler error code (i.e., c-tree)
    C is the Operating System (OS) error code (sometimes 0)

Note: This format is used if "N" is 1300 or greater.

Program Exception/Access Denied Error Format

N-L-X
    N is the 4 digit Error Number
    L is the location in the source code (usually 0)
    X is the Exception Code in hexadecimal format (see example below).

A typical Exception Code is:
            0xC0000005 - Access Violation.

Note: This format is used if "N" is 3000 or 3001. There is no operating system error number for errors 3000 and 3001.

How To Troubleshoot An Error Message

When troubleshooting error messages, the error number represented by "N" tells what the general error is, whereas the other numbers provide more specific information. The file name from the error message indicates which file is involved in the error. The number represented by "L" is normally of little use unless all standard procedures used to resolve the error fail.

A list of all error numbers (represented by "N") can be found in KB Article R10045, "Fatal Error Messages". From this list, you can click on the individual error number to display information regarding the error. The topic may provide general troubleshooting steps to resolve the specific error or refer you to a more detailed troubleshooting article, such as KB Article R10011, "Troubleshooting Invalid Page Fault and Other Exception Errors". If you are having trouble resolving an error, call Technical Support at 402-419-2210, Monday-Friday, 8 a.m. - 5 p.m. central time. Please have your program serial number and all of the error information available to help expedite your support call.

Because there are many exception codes, only the most frequent codes are listed in KB Article R10045, "Fatal Error Messages". If you receive error codes not listed, please contact Technical Support at 402-419-2210.

If your error number is not listed in the list of Fatal Error Messages:

Call Technical Support at 402-419-2210. Please have your program serial number and all of the error information available to help expedite your support call.

Examples

Following are examples of error messages and how to determine what the numbers represent:

Example:  1020-1-5 Error opening file. Filename:  STTASK

The Error "1020" is "Error Opening File". This error is found on the Error Numbers list. We know it is not an extended error because the first number is less than 1300. The "1" is the location in the source code and can be ignored. Error "5" is an operating system error indicating that "Access is denied". This is found on the Operating System Errors list. The file name from the error message (STTASK) will indicate which file is involved in the error.

This error indicates that there is a problem opening the STTASK file. Check STTASK.DAT to determine if the file is locked open by someone, if the file is flagged as a read only file or if the user does not have all rights to the directory where STTASK is located.

Example:  1160-0-5 Unable to copy file. Filename:  G5MSTR

The Error "1160" is "Unable to copy file". This error is found on the Error Numbers list. We know it is not an extended error because the first number is less than 1300. The "0" is the location in the source code and can be ignored. Error "5" is an operating system error indicating that "Access is denied". This is found on the Operating System Errors list. The file name from the error message (G5MSTR) will indicate which file is involved in the error.

This error indicates that the user does not have rights to copy or create files on the network. Check the user's rights to network drives.

Example:  1310-1-14-0 Error opening file. Filename:  A3INVOIC

The Error "1310" is "Error Opening File". This is found on the Error Numbers list. We know it is an extended error because the first number is 1300 or greater. The "1" is the location in the source code and can be ignored. This is used for source code lookups if the error cannot be resolved through standard procedures. Error 14 is "File Corrupt At Open". This is found on the File Handler Errors list. The "0" is the operating system error. Here it is "0" because the error is not an error from the Operating System. The file name from the error message (A3INVOIC) will indicate which file is involved in the error.

This error indicates that the A3INVOIC file is corrupt. It is best to restore all A3*.* files from a complete backup. After the data is restored, run a Data File Integrity Check to ensure that the data is error free. After the data is restored, all work that was done since the backup was made must be redone.

Example: 1400-0-160-0 Error stepping. Filename: T3CLIENT

The Error "1400" is "Error Stepping". This is found on the Error Numbers list. We know it is an extended error because the first number is 1300 or greater. The "0" is the location in the source code and can be ignored. This is used for source code lookups if the error cannot be resolved through standard procedures. Error "160" is "Multi-user interference: index information updated by the time user got to actual data record". This is found on the File Handler Errors list. The "0" is the operating system error. Here it is "0" because the error is not an error from the Operating System. The file name from the error message (T3CLIENT) will indicate which file is involved in the error.

This error indicates the index file for T3CLIENT is corrupted. Run a Data File Integrity Check (DFIC). If there are errors in the DFIC they must be corrected before continuing. If the DFIC is error free, make a backup. Run the Reindex Data Files program and select to reindex the T3CLIENT file.

References


© 1999-2010 Software Technology, Inc.   All rights reserved. Terms of Use
The maker of Tabs3 and PracticeMaster
Tabs3, PracticeMaster, and the “pinwheel” symbol (The "Pinwheel" symbol is a Registered Trademark of Software Technology, Inc.) are registered trademarks of Software Technology, Inc.
e-Mail Suggestions for the Knowledge Base to: kb@Tabs3.com
Technical Support via e-mail is not available.
Knowledge Base:   http://support.Tabs3.com
Web Site:   http://www.Tabs3.com