register_all_points

Arguments

Returns

t on success, or nil on failure.

Description

This function registers the current application to receive exceptions from the Cascade DataHub for all points in the given domain. Once this function has been called, any changes to the value of any point in the Cascade DataHub will be transmitted to the input queue of the application. These changes are events, and as such must be processed by calling next_event or next_event_nb before the application will recognize the new value of the point.

If the domain is nil, then the current default domain (set by set_domain) will be used. If the domain is named, even if it is the default domain, then the datahub will transmit all points as fully qualified names, in the domain:name format. If the newflag is given and is non-nil, then any points which are created on the datahub after this call is made will be automatically registered. If newflag is nil or not provided, then the datahub will not automatically register points which were created since this call.

Example

Gamma> register_all_points(nil,t);
t
Gamma> write_point(#b,22);
t
Gamma> next_event();
nil
Gamma> b;
22
Gamma> register_all_points("plant",t);
t
Gamma> 
		

See Also

register_point