read

read — reads a complete point definition.

Syntax

(read name)
    

Arguments

name
The name of a point.

Returns

The complete point definition in a message, with this syntax:

(point name type value [conf security locked seconds nanoseconds flags quality])

where:

name
The name of the point.
type
The data type of the point, one of integer, floating point, or character string.
value
The value of the point.
conf
The confidence level of the point, 0 - 100 percent, unused by most applications.
security
The security level of the point, 0 to 32768, where higher numbers represent higher security.
locked
0 for locked, or 1 for unlocked.
seconds
The operating system time in seconds when the point was read.
nanoseconds
The number of nanoseconds after seconds when the point was read.
flags
User-defined flags.
quality
A constant representing a quality of the connection, assigned by the DataHub for this point, such as Good, Bad, Last known, Local override, etc. The possible values are those supported by OPC in Microsoft Windows.

Description

This command reads the current value of a point, along with all the other information it contains. See also cread.