Error Ring

Use the Error Ring to quickly select and pass NI or custom error codes throughout your VI.

You can configure the ring to return a built-in error message or you can create a custom error message for a one-time use. By default, the source string of the error cluster contains the call chain from the top-level VI to the current VI.

Note To reduce unnecessary execution time in your VIs, place Error Rings inside a case structure that executes only when the error condition the Error Ring reports is met.

(Real-Time Module) Exclude the call chain to reduce jitter in real-time applications. You cannot use the Error Ring in VIs that run on RT targets.


icon

Inputs/Outputs

  • ierrcodeclst.png error out

  • The following is a configured Error Ring.

    The configured Error Ring has the following parts.

    SectionDescription
    Toggles between error and warning.
    Indicates if the error includes the call chain.
    6:LabVIEWDescription of the error. Right-click the Error Ring and select Visible Items»Error Explanation Text from the shortcut menu to show or hide the error description.
    Note You can include format specifiers, such as %s and %T, in the description. Refer to Defining a Custom Error Code from the Error Ring for more details.
    Launches the Select Error dialog box.

    After you select the error, you can change the type (Error or Warning) and whether to include the call chain by clicking the icons on the ring. You also can toggle the error type and call chain options by right-clicking the Error Ring and selecting Generate Error, Generate Warning, Include Call Chain, or Exclude Call Chain from the shortcut menu.