register_all_points

Gamma: Version 4.0
Prev |  | Next

# `register_all_points`

`register_all_points` -- registers an application to receive exceptions for all points.

## Syntax

    register_all_points (domain?, newflag?)

## Arguments

`domain`

  The Cascade DataHub domain in which to register.

`newflag`

  A flag determining whether to automatically register all future points from the datahub.

## 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`

Prev | Home | Next
`read_existing_point`, `read_point` | Up | `register_exception`

Copyright 1995-2002 by Cogent Real-Time Systems, Inc.