Cogent C API and Utilities : Version 6.4
	Chapter 5. Communicating with the Cascade DataHub

Chapter 5. Communicating with the Cascade DataHub

Table of Contents

The Cascade DataHub contains a snapshot of the current values of all of its points. A point is essentially a name and an associated value, along with auxiliary information such as time stamp, security and lock status. The following functions provide access to the Cascade DataHub through the Cascade DataHub IPC functions (IP_*).

The Cascade DataHub provides three basic data services:

Read A user task synchronously reads a point value from the DataHub. See DH_ReadPoint and DH_ReadExistingPoint.

Write A user task synchronously writes a point to the DataHub. See DH_WritePoint and DH_WriteExistingPoint.

Exception A user task informs the DataHub that it would like to be alerted whenever a point value changes, and to have an unsolicited (asynchronous) message sent to it. See DH_RegisterPoint, DH_RegisterExistingPoint, DH_RegisterAllPoints, DH_ParsePointMsg, and DH_ParsePointString.

5.1. Exceptions

The Cascade DataHub is designed using the exception paradigm of point value transmission. That is, a client task can tell the DataHub that it would like to be informed whenever a value changes on one or more points, and then it simply waits for the DataHub to transmit the changes. This mechanism generally results in less network traffic and substantially reduced delays compared with the more popular polling method of DataHub query. The Cascade DataHub automatically concatenates point messages to be sent to a client if more than one exception occurs before a message is sent out.


4.3. Task Started and Stopped Messages		5.2. Echoes