writept

writept — writes a point to the Cascade DataHub.

Synopsis

writept [-frils] [-d domain] [-S security] [pointname] [pointvalue]

Arguments

pointname

The name of the Cascade DataHub point to write to.

pointvalue

The value to assign to this point.

-d domain

Domain name for the DataHub to write the point to.

-f

Write the point as a floating point number.

-i

Write the point as a short integer.

-l

Write the point as a long integer.

-r

Same as -f.

-s

Write the point as a character string.

-S security

Set the security level for writing.

Returns

On success, nothing; on error, a message.

Description

The writept utility will write or create a value in any accessible Cascade DataHub. Alternate domains can be written to without having to use the -d option by passing point names with the domain:pointname syntax.

Strings containing spaces and special characters must be escaped from the shell appropriately. The point type will be guessed if not specified. The order of guessing is: long, float, string (the default). The guess is considered correct if the entire argument is converted. Long can be specified in standard C style, for example 0x5f for hex, O647 for octal, etc.

[Note]

The source code for this utility is normally installed in the /usr/cogent/src/datahub directory, and can also be viewed at the Writing data to the Cascade DataHub appendix of the Cogent C API manual.

Dependencies

qserve, nserve, datahub

See Also

datahub, readpt

Example

[sh]$  writept LIC02_sp 55

Writes to the point LIC02_sp the value of 55 in the DataHub default.

[sh]$  writept -d control m38onoff 1

Writes to the point m38onoff the value 1 in the DataHub control.