Technical Reference > CitectSCADA Reference Information > Error Messages > Generic driver errors

Generic driver errors

The following errors are generic to every CitectSCADA driver. A driver error needs to be mapped to a generic error before CitectSCADA can interpret it.

Error

Description

GENERIC_ADDRESS_RANGE_ERROR

(0x0001 | SEVERITY_ERROR)

A request was made to a device address that does not exist. For example, an attempt was made to read register number 4000 when there are only 200 registers in the device.

GENERIC_CMD_CANCELED

(0x0002 | SEVERITY_ERROR)

The server canceled the command while the driver was processing it. This can happen if the driver takes too long to process the command. Check the timeout and retries for the driver.

GENERIC_INVALID_DATA_TYPE

(0x0003 | SEVERITY_ERROR)

A request was made specifying a data type not supported by the protocol. This error will not occur during normal operation.

GENERIC_INVALID_DATA_FORMAT

(0x0004 | SEVERITY_ERROR)

A request contains invalid data; for example, writing to a floating-point address with an invalid floating-point number. Check the CitectSCADA database.

GENERIC_INVALID_COMMAND

(0x0005 | SEVERITY_ERROR)

The server sent a command to the driver that it did not recognize. This error will not occur during normal operation.

GENERIC_INVALID_RESPONSE

(0x0006 | SEVERITY_ERROR)

The communication channel is not performing normally, and is causing errors in the transmitted data.

GENERIC_UNIT_TIMEOUT

(0x0007 | SEVERITY_ERROR)

A device is not responding to read or write requests. The driver sent a command to the device and the device did not respond within the timeout period.

GENERIC_GENERAL_ERROR

(0x0008 | SEVERITY_ERROR)

Unmapped driver specific errors are normally reported as a general error. Refer to the protocol-specific errors listed with the protocol you are using.

GENERIC_WRITE_PROTECT

(0x0009 | SEVERITY_ERROR)

A write operation was attempted to a location that is protected against unauthorized modification. Change the access rights to this location to permit a write operation.

GENERIC_HARDWARE_ERROR

(0x000A | SEVERITY_UNRECOVERABLE)

The communication channel, server, or device hardware is not performing normally. Examine hardware components. The server's operation needs to also be examined for proper operation.

GENERIC_UNIT_WARNING

(0x000B | SEVERITY_WARNING)

The communication link between the server and the device is functioning correctly; however, the device is experiencing an error or is in a non-operational state, for example, the device is in program mode.

GENERIC_UNIT_OFFLINE

(0x000C | SEVERITY_SEVERE)

The device is in offline mode, preventing any external communication. This error will cause any stand-by units to become active. CitectSCADA will attempt to re-initialize the unit.

GENERIC_SOFTWARE_ERROR

(0x000D | SEVERITY_SEVERE)

An internal software error has occurred in the driver. This error should not occur during normal operation.

GENERIC_ACCESS_VIOLATION

(0x000E| SEVERITY_ERROR)

An attempt has been made by an unauthorized user to access information. Check the user's access rights.

GENERIC_NO_MEMORY

(0x000F | SEVERITY_UNRECOVERABLE)

The server or driver has run out of memory and cannot continue execution. Minimize buffer and queue allocation or expand the server computer's memory (physical or virtual memory).

GENERIC_NO_BUFFERS

(0x0010 | SEVERITY_ERROR)

There are no communication buffers left to allocate. The performance of the server may be reduced; however, it can still continue to run. Increase the number of communication buffers.

GENERIC_LOW_BUFFERS

(0x0011| SEVERITY_WARNING)

This error may occur in periods of high transient loading with no ill effects. If this error occurs frequently, increase the number of communication buffers.

GENERIC_TOO_MANY_COMMANDS

(0x0012| SEVERITY_WARNING)

Too many commands have been sent to the driver.

GENERIC_DRIVER_TIMEOUT

(0x0013 | SEVERITY_ERROR)

The server is not receiving any response from the driver. This error should not occur during normal operation.

GENERIC_NO_MORE_CHANNELS

(0x0014 | SEVERITY_SEVERE)

Each driver can only support a fixed number of communication channels. You have exceeded the limit. The command or data request has not been completed.

GENERIC_CHANNEL_OFFLINE

(0x0015 | SEVERITY_SEVERE)

A communication channel is currently offline, disabling communication. The server cannot initialize the communication channel or the channel went offline while running. Every device (units)connected using this channel will be considered to be offline so this will cause any stand-by devices to become active. CitectSCADA will attempt to re-initialize the channel.

GENERIC_BAD_CHANNEL

(0x0016| SEVERITY_SEVERE)

The server has attempted to communicate using a channel that is not open.

GENERIC_CHANNEL_NOT_INIT

(0x0017 | SEVERITY_SEVERE)

The server is attempting to communicate with a channel that has not been initialized. This error should not occur during normal operation. The command or data request has not been completed. If the condition persists, contact support.

GENERIC_TOO_MANY_UNITS

(0x0018 | SEVERITY_SEVERE)

A channel has too many devices attached to it. This error should not occur during normal operation.

GENERIC_INVALID_DATA

(0x0019 | SEVERITY_ERROR)

The data requested is not in a valid format or expected type.

GENERIC_CANNOT_CANCEL

(0x001A | SEVERITY_WARNING)

The server tried to cancel a command, but the driver could not find the command. This error should not occur during normal operation.

GENERIC_STANDBY_ACTIVE

(0x001B | SEVERITY_WARNING)

Communication has been switched from the primary to the stand-by unit(s). The server returns this message when a hot changeover has occurred.

GENERIC_MSG_OVERRUN

(0x001C | SEVERITY_ERROR)

A response was longer than the response buffer. If this error occurs on serial communication drivers, garbled characters may be received. Check the communication link and the baud rate of the driver.

GENERIC_BAD_PARAMETER

(0x001D | SEVERITY_ERROR)

There is a configuration error, for example invalid special options have been set.

GENERIC_STANDBY_ERROR

(0x001E| SEVERITY_WARNING)

There is an error in a stand-by unit.

GENERIC_NO_RESPONSE

(0x001F | SEVERITY_ERROR)

There is no response from the communications server.

GENERIC_UNIT_REMOTE

(0x0020 | SEVERITY_ERROR)

Cannot talk with remote unit (for example dial-up I/O Devices). Only used for scheduled I/O Devices.

GENERIC_GENERAL_WARNING

(0x0024 | SEVERITY_WARNING)

The driver is performing the action requested, but needs to notify of a potential issue. For example, some drivers may use this to alert you to stale data.