create

create — creates a new point.

Synopsis

(create name [0|1])
    

Arguments

name

The name of the point, as a string.

0|1

Tells create what to do if a point already exists with that name. Use 1 to ignore an existing point and do nothing. Use 0 to have create throw an error. If nothing is entered, the default is 0.

Returns

A message indicating success or error. Please refer to Return Syntax for details.

Description

This command creates a new point in a DataHub instance. Normally it is not necessary to create points manually—the DataHub instance creates a new point any time a program sends one. However, this command is useful for creating points programmatically from within the DataHub instance. See also cset.

Example

Using the Gamma datahub_command function, you could pass a create command to a DataHub instance as follows to create MyNewPoint in the default domain, and assign it a value of 1.

datahub_command ("(create default:MyNewPoint)", 1);