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.