Select Error Dialog Box

Requires: Base Development System

Select the Error Ring drop-down arrow to display this dialog box.

Use this dialog box to select a built-in error code or create a custom error message for a one-time use.

This dialog box includes the following components:

• Error Code Range—Displays a list of error code categories. You also can create your own category of errors.
• Filter—Specifies the keyword to search for within the specified error code range. Use this option to narrow down the list of error codes to display in the Error Listing table. This option is not available if you select Custom Error Code from the Error Code Range drop-down listbox.
• Error Listing—Displays the errors available in the specified error code range. You can scroll through the list to find the error code or you can type the error code number and the listbox scrolls down to that entry. You can narrow down the list of error codes to display using the Filter textbox.
• Error Code—Appears when you select Custom Error Code from the Error Code Range drop-down listbox.
  • To define a custom error code, enter an error code from the following ranges of error codes specifically reserved for custom error messages: -8999 through -8000, 5000 through 9999, and 500,000 through 599,999.
  • To overwrite an existing error code message, enter the existing error code. Creating a custom error message for an already-defined error code is useful when you want to return the error code for a common error case but you want to provide specific information about this particular instance of the error. For example, you can use error code 7, "File not found." and replace that with a description about the specific file that was not found.
• Error Description (Optional)—Appears when you select Custom Error Code from the Error Code Range drop-down listbox. Enter the description of the error. This field accepts the same % codes as the Format Into String function. Use the % codes to customize the error description. (Real-Time Module) A custom error string creates jitter on real-time applications. Leave the string blank if you are going to generate this error inside code from which you need strong determinism.
• Error or Warning—Specifies if the selected error code is handled as an error or a warning.
• Include Call Chain—Includes in the error description the chain of callers from the current VI to the top-level VI, which is useful when determining where in the VI hierarchy the error occurred. (Real-Time Module) Exclude the call chain to reduce jitter in real-time applications.