report_domain

report_domain — registers points and requests information on a whole domain.

Syntax

(report_domain domain flags)
    

Arguments

domain

The desired domain.

flags

Any bitwise-or combination of:

DH_REG_ALLRegister all points on this domain.
DH_REG_FUTURERegister any new points created on this domain subsequent to this call.
DH_REG_QUALIFYTell the Cascade DataHub to emit all point names with the domain prepended, as in domain:point_name.
DH_REG_ONCEONLYTell the Cascade DataHub to send each point value exactly once.
DH_REG_MODELTell the Cascade DataHub to send the data model as well as the point values.

Returns

One or more messages, depending on the flag(s) chosen. Each message contains the complete definition of the point.

Description

This command lets TCP client connections decide on a per-domain basis whether to informed of the data model for the domain, and whether to get future updates, fully-qualified domain names, or new points.