Using CitectSCADA > Reporting Information > Handling Communication Errors in Reports > Reporting errors in I/O device data

Reporting errors in I/O Device data

If a communication error is detected (with an I/O Device) or if the data is invalid, one of the following alert messages are written to the report (instead of the value):

Error

Meaning

#ASS

The value is incorrectly associated (with a substitution string or Genie).

#COM

Communication with the I/O Device has been lost

#DIV/0

An attempt was made to divide a number by 0 (zero)

#ERR

An uncommon error has occurred. (Use the IsError function to find the occurrence.)

#MEM

Out of memory or more than 64 kb bytes of memory requested.

#PEND

Data from this device is pending an initial update to display a value.

#RANGE

The value returned is out of range

#STACK

The value has caused a stack overflow

#WAIT

Data from this scheduled device is not available as it has not reached its scheduled interval and has no cache value.

For example:

Report Format:

{PV_1} {SP_1} {OP_1}

If the above report is run when the value of PV_1 is out of range (for example 101.5), SP_1 is 42.35 and OP_1 is 60.0, the output of the report is:

Report Output:

#RANGE 42.35 60.0

When reports are written to a database device, you might sometimes want to disable the alert messages and write the values to the report (even if the values are invalid). Use the ERR_FORMAT_OFF command to disable alert messages and write data as values.

For example:

Report Format:

{ERR_FORMAT_OFF}
{PV_1} {SP_1} {OP_1}
If the above report is run when the value of PV_1 is out of range (for example 101.5) , SP_1 is 42.35 and OP_1 is 60.0, the output of the report is:

Report Output:

42.35 60.0

To re-enable the alert messages, use the ERR_FORMAT_ON specifier.

Note: If an I/O Device goes offline and you have disabled communication errors, the value printed into the report is either 0 (zero) or the last value read from the I/O Device when the report was last run. In either case, the value is invalid.

See Also