Cascade DataHub™ for Linux and QNX

Version 5.4

January 05, 2006

A memory resident real-time database that acts as a hub, providing fast and efficient concentration and distribution of data for QNX and Linux applications.

Cogent software is source-code compatible among the Linux, QNX 6, and QNX 4 operating systems.
Go to the Cogent Web Site.
Copyright, trademark, and software license information.

Table of Contents


1. Introduction
1.1. What is the Cascade DataHub?
1.2. A note about the Cascade DataHub API
1.3. System Requirements
1.4. Download and Installation
1.4.1. QNX 4
1.4.2. QNX 6
1.4.3. Linux
1.4.4. Installed file locations
1.4.5. Installing licenses
1.5. Quick Start
1.6. Cogent Product Integration
1.7. Where can I get help?

2. Using the Cascade DataHub
2.1. Starting up and shutting down.
2.2. Testing the installation
2.3. Configuration
2.3.1. Using a Configuration File at Startup
2.3.2. Dynamic Run-Time Configuration
2.4. Working with Data
2.4.1. Data Points
2.4.2. Registering for Exceptions
2.4.3. Domains and Names
2.5. Mirroring Data to Windows or other nodes in Linux or QNX
2.5.1. Exchanging data between Windows and Linux/QNX
2.5.2. Exchanging data between Linux/QNX and Linux/QNX
2.5.3. Mirroring Master Setup - Linux or QNX
2.5.4. Mirroring Slave Setup - Linux or QNX
2.5.5. Mirroring Master Setup - Windows
2.5.6. Mirroring Slave Setup - Windows
2.6. Viewing Data
2.6.1. Console Mode
2.6.2. QNX Photon Mode
2.6.3. X Windows Mode
2.7. Features
2.7.1. Exceptions and Echoes
2.7.2. Asynchronous Messages
2.7.3. Network Access in QNX 4
2.7.4. Confidence Factors
2.7.5. Security and Point Locking
2.7.6. Unlimited Point Count
2.7.7. Cascade DataHub performance

3. Data Transmission
3.1. Synchronous data transmission
3.2. Asynchronous data transmission
3.3. Cascade DataHub data transmission

I. Utilities
datahub - starts the Cascade DataHub.
dhview - a console-based viewer for the Cascade DataHub.dhview
phdhview - a Photon-based viewer for the Cascade DataHub.
readpt - reads a point from the Cascade DataHub.
waiter - registers for exceptions with a Cascade DataHub and displays values as updates are received.
writept - writes a point to the Cascade DataHub.
xdhview - an X Windows-based viewer for the Cascade DataHub.

II. Command Set
add - is not fully documented.
alive - tells the Cascade DataHub that the client is running.
append - is not fully documented.
assembly - is not fully documented.
asyncsocket - is not fully documented.
attribute - is not fully documented.
auto_create_domains - is not fully documented.
auto_timestamp - is not fully documented.
bandwidth_reduce - reduces the connection bandwidth.
connect_service - is not fully documented.
create - is not fully documented.
create_domain - is not fully documented.
debug - is not fully documented.
defaultprop - is not fully documented.
div - is not fully documented.
domain - identifies the client domain name.
dump - is not fully documented.
enable_connect_server - is not fully documented.
enable_dde_client - enables or disables DDE client capabilities.
enable_dde_server - enables or disables DDE server capabilities.
enable_mirror_master - enables or disables mirror master capabilities.
enable_mirror_slave - enables or disables mirror slave capabilities.
enable_opc_client - enables or disables OPC client capabilities.
enable_opc_server - enables or disables OPC server capabilities.
enable_tcp_server - enables or disables TCP server capabilities.
exception_buffer - is not fully documented.
exit - is not fully documented.
flush - is not fully documented.
format - is not fully documented.
heartbeat - establishes a heartbeat message.
ignore - ignore a given point.
ignore_old_data - is not fully documented.
include - is not fully documented.
instance - is not fully documented.
load_config_files - is not fully documented.
lock - is not fully documented.
master_host - is not fully documented.
master_service - is not fully documented.
mirror_master - is not fully documented.
mult - is not fully documented.
point - is not fully documented.
private_attribute - is not fully documented.
property - is not fully documented.
read - is not fully documented.
readid - is not fully documented.
register_datahub - registers the Cascade DataHub on a given domain.
report - is not fully documented.
report_all - is not fully documented.
report_domain - registers points and requests information on a whole domain.
request - requests the value of a point.
request_initial_data - gets current data when client connection is made.
secure - is not fully documented.
set - is not fully documented.
show_debug_messages - is not fully documented.
slave - is not fully documented.
subassembly - is not fully documented.
taskdied - is not fully documented.
taskstarted - is not fully documented.
tcp_service - is not fully documented.
timeout - suspends data flow.
transmit_insignificant - is not fully documented.
type - is not fully documented.
unreport - allows a client to stop receiving data value changes to a point.
version - is not fully documented.
warn_of_license_expiry - is not fully documented.
write - is not fully documented.
Index

List of Figures

2.1. The Cascade DataHub Viewer in Console Mode
2.2. The Cascade DataHub Viewer for QNX Photon
2.3. The Cascade DataHub Viewer for X Windows
2.4. Exceptions and Echoes
2.5. Asynchronous Messages
3.1. Synchronous data transmission
3.2. Asynchronous data transmission
3.3. Cascade DataHub Data Transmission

List of Tables

2.1. Memory Usage