Chapter 2. Using the Cascade DataHub

Table of Contents

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.4.4. Assemblies, Subassemblies, Attributes, and Properties
2.4.5. Attributes and Types
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

2.1. Starting up and shutting down.

Follow these steps to start the Cascade DataHub.

  1. Ensure that /usr/cogent/bin is in your PATH (check this using the set command).
  2. Start the Cascade DataHub using the datahub command with the appropriate arguments, (no ampersand '&' is required). For example:
    [sh]$  datahub
    The example above would start the DataHub in the default domain (called "default"). Another example is:
    [sh]$  datahub -d test
    This second example starts the DataHub in an application domain called "test".

Once started you can check that the DataHub is running by using the nsnames command. For example:

[sh]$  nsnames
Name         Domain    Queue         NID   PID
/dh/test     test      /dh/test      0     15367

The DataHub derives its name and queue name from the domain(s) that it is operating in. If no domain is specified, the DataHub takes the name /dh/default. Please refer to Section 2.4.3, “Domains and Names” for more information on this. The NID and PID will vary depending on circumstances.