Defining a Custom Error Code from the Error Ring

Creating a custom error code is useful if you want to define a single error code or overwrite a single built-in error code. If you have multiple custom errors you want to use in the Error Ring, use the Error Code Editor dialog box. Complete the following steps to create a custom error from the Error Ring for a one-time use.

  1. Add the Error Ring to the block diagram.

     Add  Find
  2. Click the drop-down arrow to display the Select Error dialog box.
  3. In the Error Code Range drop-down listbox, select Custom Error Code.
  4. Specify an error code in the Error Code field.
  5. Enter a description in the Error Description (Optional) field. The description field accepts the same format specifiers, such as %s and %T, as the Format Into String function does. For example, for the custom error message "At time %T, the file %s was not found", the configured Error Ring adjusts to include inputs for a timestamp and a string, respectively, as displayed in the following figure.

  6. Use the radio buttons to configure the Error Ring to return either an error or a warning.
  7. Remove the checkmark from the Include Call Chain checkbox if you do not want to include the call chain information in the error cluster. If you include the call chain, the error description displays 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.
  8. Click OK.

After you configure the Error Ring, you can adjust the configuration without returning to the dialog box.