niHWS Store Waveform

NI-HWS LabVIEW

niHWS Store Waveform

Creates a new file for storing a waveform. The instances of this polymorphic VI correspond to the type of analog or digital data you are storing.

This VI is intended for storing a single waveform in a file. To store multiple waveforms in a file, you must use the Low Level Write VIs.

Use the pull-down menu to select an instance of this VI.

Store Analog WDT

Creates a new file for storing an analog waveform.

file path specifies the path and file name of the HWS file to create.

The .hws extension is typically used for HWS files, although using this extension is optional.

compression level provides control over the amount of compression applied to the waveform samples as they are written to the HWS file.

A value of 0 means no compression. A value of 9 means maximum compression. Values between zero and nine indicate increasing levels of compression.

overwrite existing file? allows this VI to overwrite the file if it exists.

Select Yes to overwrite the existing file and create a new file.

Select No to prevent overwriting an existing file.

analog waveform is the array containing the data for the waveform.
gain is intended for waveforms that are to be generated by hardware that supports a gain control that is applied to the downloaded waveform. For example, this parameter can be used for the gain parameter in NI-FGEN.

NI-HWS does not apply this gain when writing the data.

offset is intended for waveforms that are to be generated by hardware that supports an offset control that is applied to the downloaded waveform. This parameter can be used for the offset parameter in NI-FGEN, for example.

NI-HWS does not apply this offset when writing the data.

error in (no error) can accept error information wired from VIs previously called. Use this information to decide if any functionality should be bypassed in the event of errors from other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

status is either TRUE (X) for an error, or FALSE (checkmark) for no error or a warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

code identifies the error or warning. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.
source describes the origin of the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

new file path passes the path to the file where the data was stored.
error out passes error or warning information out of a VI to be used by other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

status is either TRUE (X) for an error, or FALSE (checkmark) for no error or a warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

code identifies the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

source describes the origin of the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

Store Analog DBL

Creates a new file for storing an analog waveform as double-precision floating-point data (DBL).

file path specifies the path and file name of the HWS file to create.

The .hws extension is typically used for HWS files, although using this extension is optional.

rate is the rate of the Sample clock used to capture the waveform.
compression level provides control over the amount of compression applied to the waveform samples as they are written to the HWS file.

A value of 0 means no compression. A value of 9 means maximum compression. Values between zero and nine indicate increasing levels of compression.

overwrite existing file? allows this VI to overwrite the file if it exists.

Select Yes to overwrite the existing file and create a new file.

Select No to prevent overwriting an existing file.

data is the array containing the data for the waveform.
gain is intended for waveforms that are to be generated by hardware that supports a gain control that is applied to the downloaded waveform. For example, this parameter can be used for the gain parameter in NI-FGEN.

NI-HWS does not apply this gain when writing the data.

offset is intended for waveforms that are to be generated by hardware that supports an offset control that is applied to the downloaded waveform. This parameter can be used for the offset parameter in NI-FGEN, for example.

NI-HWS does not apply this offset when writing the data.

error in (no error) can accept error information wired from VIs previously called. Use this information to decide if any functionality should be bypassed in the event of errors from other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

status is either TRUE (X) for an error, or FALSE (checkmark) for no error or a warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

code identifies the error or warning. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.
source describes the origin of the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

new file path passes the path to the file where the data was stored.
error out passes error or warning information out of a VI to be used by other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

status is either TRUE (X) for an error, or FALSE (checkmark) for no error or a warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

code identifies the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

source describes the origin of the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

Store Analog I8

Creates a new file for storing an analog waveform as 8-bit signed integers (I8).

file path specifies the path and file name of the HWS file to create.

The .hws extension is typically used for HWS files, although using this extension is optional.

rate is the rate of the Sample clock used to capture the waveform.
compression level provides control over the amount of compression applied to the waveform samples as they are written to the HWS file.

A value of 0 means no compression. A value of 9 means maximum compression. Values between zero and nine indicate increasing levels of compression.

overwrite existing file? allows this VI to overwrite the file if it exists.

Select Yes to overwrite the existing file and create a new file.

Select No to prevent overwriting an existing file.

data is the array containing the data for the waveform.
gain is intended for waveforms that are to be generated by hardware that supports a gain control that is applied to the downloaded waveform. For example, this parameter can be used for the gain parameter in NI-FGEN.

NI-HWS does not apply this gain when writing the data.

offset is intended for waveforms that are to be generated by hardware that supports an offset control that is applied to the downloaded waveform. This parameter can be used for the offset parameter in NI-FGEN, for example.

NI-HWS does not apply this offset when writing the data.

error in (no error) can accept error information wired from VIs previously called. Use this information to decide if any functionality should be bypassed in the event of errors from other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

status is either TRUE (X) for an error, or FALSE (checkmark) for no error or a warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

code identifies the error or warning. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.
source describes the origin of the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

new file path passes the path to the file where the data was stored.
error out passes error or warning information out of a VI to be used by other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

status is either TRUE (X) for an error, or FALSE (checkmark) for no error or a warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

code identifies the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

source describes the origin of the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

Store Analog I16

Creates a new file for storing an analog waveform as 16-bit signed integers (I16).

file path specifies the path and file name of the HWS file to create.

The .hws extension is typically used for HWS files, although using this extension is optional.

rate is the rate of the Sample clock used to capture the waveform.
compression level provides control over the amount of compression applied to the waveform samples as they are written to the HWS file.

A value of 0 means no compression. A value of 9 means maximum compression. Values between zero and nine indicate increasing levels of compression.

overwrite existing file? allows this VI to overwrite the file if it exists.

Select Yes to overwrite the existing file and create a new file.

Select No to prevent overwriting an existing file.

data is the array containing the data for the waveform.
gain is intended for waveforms that are to be generated by hardware that supports a gain control that is applied to the downloaded waveform. For example, this parameter can be used for the gain parameter in NI-FGEN.

NI-HWS does not apply this gain when writing the data.

offset is intended for waveforms that are to be generated by hardware that supports an offset control that is applied to the downloaded waveform. This parameter can be used for the offset parameter in NI-FGEN, for example.

NI-HWS does not apply this offset when writing the data.

error in (no error) can accept error information wired from VIs previously called. Use this information to decide if any functionality should be bypassed in the event of errors from other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

status is either TRUE (X) for an error, or FALSE (checkmark) for no error or a warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

code identifies the error or warning. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.
source describes the origin of the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

new file path passes the path to the file where the data was stored.
error out passes error or warning information out of a VI to be used by other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

status is either TRUE (X) for an error, or FALSE (checkmark) for no error or a warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

code identifies the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

source describes the origin of the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

Store Analog I32

Creates a new file for storing an analog waveform as 32-bit signed integers (I32).

file path specifies the path and file name of the HWS file to create.

The .hws extension is typically used for HWS files, although using this extension is optional.

rate is the rate of the Sample clock used to capture the waveform.
compression level provides control over the amount of compression applied to the waveform samples as they are written to the HWS file.

A value of 0 means no compression. A value of 9 means maximum compression. Values between zero and nine indicate increasing levels of compression.

overwrite existing file? allows this VI to overwrite the file if it exists.

Select Yes to overwrite the existing file and create a new file.

Select No to prevent overwriting an existing file.

data is the array containing the data for the waveform.
gain is intended for waveforms that are to be generated by hardware that supports a gain control that is applied to the downloaded waveform. For example, this parameter can be used for the gain parameter in NI-FGEN.

NI-HWS does not apply this gain when writing the data.

offset is intended for waveforms that are to be generated by hardware that supports an offset control that is applied to the downloaded waveform. This parameter can be used for the offset parameter in NI-FGEN, for example.

NI-HWS does not apply this offset when writing the data.

error in (no error) can accept error information wired from VIs previously called. Use this information to decide if any functionality should be bypassed in the event of errors from other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

status is either TRUE (X) for an error, or FALSE (checkmark) for no error or a warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

code identifies the error or warning. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.
source describes the origin of the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

new file path passes the path to the file where the data was stored.
error out passes error or warning information out of a VI to be used by other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

status is either TRUE (X) for an error, or FALSE (checkmark) for no error or a warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

code identifies the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

source describes the origin of the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

Store Digital WDT

Creates a new file for storing a digital waveform.

file path specifies the path and file name of the HWS file to create.

The .hws extension is typically used for HWS files, although using this extension is optional.

compression level provides control over the amount of compression applied to the waveform samples as they are written to the HWS file.

A value of 0 means no compression. A value of 9 means maximum compression. Values between zero and nine indicate increasing levels of compression.

overwrite existing file? allows this VI to overwrite the file if it exists.

Select Yes to overwrite the existing file and create a new file.

Select No to prevent overwriting an existing file.

digital waveform contains the data for the waveform.
error in (no error) can accept error information wired from VIs previously called. Use this information to decide if any functionality should be bypassed in the event of errors from other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

status is either TRUE (X) for an error, or FALSE (checkmark) for no error or a warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

code identifies the error or warning. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.
source describes the origin of the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

new file path passes the path to the file where the data was stored.
error out passes error or warning information out of a VI to be used by other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

status is either TRUE (X) for an error, or FALSE (checkmark) for no error or a warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

code identifies the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

source describes the origin of the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

Store Digital 1D U8

Creates a new file for storing a digital waveform as an array of 8-bit unsigned integers (U8).

file path specifies the path and file name of the HWS file to create. The .hws extension is typically used for HWS files, although using this extension is optional.
rate is the rate of the Sample clock used to capture the waveform.
compression level provides control over the amount of compression applied to the waveform samples as they are written to the HWS file.

A value of 0 means no compression. A value of 9 means maximum compression. Values between zero and nine indicate increasing levels of compression.

overwrite existing file? allows this VI to overwrite the file if it exists.

Select Yes to overwrite the existing file and create a new file.

Select No to prevent overwriting an existing file.

data is the array containing the data for the waveform.
valid signals is the list of signals (or bits) in the digital samples that are valid. For example, "0,3,6" means that only bits 0, 3, and 6 of each U8 digital sample contain valid digital data.

The values in the string can receive any integer value between 0 and 7. Individual lines are separated by commas. You can use a hyphen to denote an inclusive range of lines. For example, "2-5" is equivalent to "2,3,4,5".

error in (no error) can accept error information wired from VIs previously called. Use this information to decide if any functionality should be bypassed in the event of errors from other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

status is either TRUE (X) for an error, or FALSE (checkmark) for no error or a warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

code identifies the error or warning. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.
source describes the origin of the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

new file path passes the path to the file where the data was stored.
error out passes error or warning information out of a VI to be used by other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

status is either TRUE (X) for an error, or FALSE (checkmark) for no error or a warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

code identifies the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

source describes the origin of the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

Store Digital 2D U8

Creates a new file for storing a digital waveform as a two-dimensional array of 8-bit unsigned integers (U8).

file path specifies the path and file name of the HWS file to create. The .hws extension is typically used for HWS files, although using this extension is optional.
rate is the rate of the Sample clock used to capture the waveform.
compression level provides control over the amount of compression applied to the waveform samples as they are written to the HWS file.

A value of 0 means no compression. A value of 9 means maximum compression. Values between zero and nine indicate increasing levels of compression.

overwrite existing file? allows this VI to overwrite the file if it exists.

Select Yes to overwrite the existing file and create a new file.

Select No to prevent overwriting an existing file.

data is the two-dimensional array containing the data for the waveform.
error in (no error) can accept error information wired from VIs previously called. Use this information to decide if any functionality should be bypassed in the event of errors from other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

status is either TRUE (X) for an error, or FALSE (checkmark) for no error or a warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

code identifies the error or warning. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.
source describes the origin of the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

new file path passes the path to the file where the data was stored.
error out passes error or warning information out of a VI to be used by other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

status is either TRUE (X) for an error, or FALSE (checkmark) for no error or a warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

code identifies the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

source describes the origin of the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

Store Digital 1D U16

Creates a new file for storing a digital waveform as an array of 16-bit unsigned integers (U16).

file path specifies the path and file name of the HWS file to create. The .hws extension is typically used for HWS files, although using this extension is optional.
rate is the rate of the Sample clock used to capture the waveform.
compression level provides control over the amount of compression applied to the waveform samples as they are written to the HWS file.

A value of 0 means no compression. A value of 9 means maximum compression. Values between zero and nine indicate increasing levels of compression.

overwrite existing file? allows this VI to overwrite the file if it exists.

Select Yes to overwrite the existing file and create a new file.

Select No to prevent overwriting an existing file.

data is the array containing the data for the waveform.
valid signals is the list of signals (or bits) in the digital samples that are valid. For example, "0,3,6" means that only bits 0, 3, and 6 of each U16 digital sample contain valid digital data.

The values in the string can receive any integer value between 0 and 15. Individual lines are separated by commas. You can use a hyphen to denote an inclusive range of lines. For example, "2-5" is equivalent to "2,3,4,5".

error in (no error) can accept error information wired from VIs previously called. Use this information to decide if any functionality should be bypassed in the event of errors from other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

status is either TRUE (X) for an error, or FALSE (checkmark) for no error or a warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

code identifies the error or warning. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.
source describes the origin of the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

new file path passes the path to the file where the data was stored.
error out passes error or warning information out of a VI to be used by other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

status is either TRUE (X) for an error, or FALSE (checkmark) for no error or a warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

code identifies the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

source describes the origin of the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

Store Digital 2D U16

Creates a new file for storing a digital waveform as a two-dimensional array of 16-bit unsigned integers (U16).

file path specifies the path and file name of the HWS file to create. The .hws extension is typically used for HWS files, although using this extension is optional.
rate is the rate of the Sample clock used to capture the waveform.
compression level provides control over the amount of compression applied to the waveform samples as they are written to the HWS file.

A value of 0 means no compression. A value of 9 means maximum compression. Values between zero and nine indicate increasing levels of compression.

overwrite existing file? allows this VI to overwrite the file if it exists.

Select Yes to overwrite the existing file and create a new file.

Select No to prevent overwriting an existing file.

data is the two-dimensional array containing the data for the waveform.
error in (no error) can accept error information wired from VIs previously called. Use this information to decide if any functionality should be bypassed in the event of errors from other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

status is either TRUE (X) for an error, or FALSE (checkmark) for no error or a warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

code identifies the error or warning. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.
source describes the origin of the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

new file path passes the path to the file where the data was stored.
error out passes error or warning information out of a VI to be used by other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

status is either TRUE (X) for an error, or FALSE (checkmark) for no error or a warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

code identifies the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

source describes the origin of the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

Store Digital 1D U32

Creates a new file for storing a digital waveform as an array of 32-bit unsigned integers (U32).

file path specifies the path and file name of the HWS file to create. The .hws extension is typically used for HWS files, although using this extension is optional.
rate is the rate of the Sample clock used to capture the waveform.
compression level provides control over the amount of compression applied to the waveform samples as they are written to the HWS file.

A value of 0 means no compression. A value of 9 means maximum compression. Values between zero and nine indicate increasing levels of compression.

overwrite existing file? allows this VI to overwrite the file if it exists.

Select Yes to overwrite the existing file and create a new file.

Select No to prevent overwriting an existing file.

data contains the data for the waveform.
valid signals is the list of signals (or bits) in the digital samples that are valid. For example, "0,3,6" means that only bits 0, 3, and 6 of each U32 digital sample contain valid digital data.

The values in the string can receive any integer value between 0 and 31. Individual lines are separated by commas. You can use a hyphen to denote an inclusive range of lines. For example, "2-5" is equivalent to "2,3,4,5".

error in (no error) can accept error information wired from VIs previously called. Use this information to decide if any functionality should be bypassed in the event of errors from other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

status is either TRUE (X) for an error, or FALSE (checkmark) for no error or a warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

code identifies the error or warning. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.
source describes the origin of the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

new file path passes the path to the file where the data was stored.
error out passes error or warning information out of a VI to be used by other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

status is either TRUE (X) for an error, or FALSE (checkmark) for no error or a warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

code identifies the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

source describes the origin of the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

Store Digital 2D U32

Creates a new file for storing digital waveform data as a two-dimensional array of 32-bit unsigned integers (U32).

file path specifies the path and file name of the HWS file to create. The .hws extension is typically used for HWS files, although using this extension is optional.
rate is the rate of the Sample clock used to capture the waveform.
compression level provides control over the amount of compression applied to the waveform samples as they are written to the HWS file.

A value of 0 means no compression. A value of 9 means maximum compression. Values between zero and nine indicate increasing levels of compression.

overwrite existing file? allows this VI to overwrite the file if it exists.

Select Yes to overwrite the existing file and create a new file.

Select No to prevent overwriting an existing file.

data contains the data for the waveform.
error in (no error) can accept error information wired from VIs previously called. Use this information to decide if any functionality should be bypassed in the event of errors from other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

status is either TRUE (X) for an error, or FALSE (checkmark) for no error or a warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

code identifies the error or warning. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.
source describes the origin of the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

new file path passes the path to the file where the data was stored.
error out passes error or warning information out of a VI to be used by other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

status is either TRUE (X) for an error, or FALSE (checkmark) for no error or a warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

code identifies the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

source describes the origin of the error or warning.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.