Table Of Contents

Error Message Design for Distributed APIs

Last Modified: January 12, 2018

Refer to the following table for best practices for designing error messages.

Guideline Required or Recommended? Details

Reserve a range of error codes for your API and use those codes for error conditions specific to your API.


Pick a range for error codes between -8999 through -8000, 5000 through 9999, and 500,000 through 599,999, which are reserved for external users.

When generating or manipulating errors on the diagram of your API VIs, make sure you use the Error API to construct and manipulate error clusters.


Never bundle or unbundle error cluster elements directly in LabVIEW NXG.

If the VI has no way to generate errors, consider excluding error inputs and outputs.


If a VI does not generate errors, users of the VI can take advantage of parallelism in LabVIEW NXG.

If you exclude error inputs and outputs on a VI in your API, leave the error input and output locations on the connector pane empty.


When unused error inputs and outputs on a VI are left empty, you can add error handling to the VI later.

Recently Viewed Topics