Chapter 3. Getting Started

Table of Contents

3.1. How to Run a Script
3.2. The Script Editor
3.3. The Script Log
3.4. The Script Application Manager

3.1. How to Run a Script

DataHub scripts run on Gamma, the DataHub scripting engine, which starts up whenever the DataHub starts and runs continuously as long as the DataHub runs. You can access DataHub scripts and scripting capabilities by pressing the Scripting button in the Properties window.

This will display the Scripting and Customization screen. The upper half of the screen shows the Gamma files currently configured in the DataHub:

To run an existing script for the first time, you will need to first add it to the list of scripts. To create a new script, please refer to Section 4.1, “Creating a Script”

  1. To add a script to the list, press the Add button and choose the script from the file selector. Scripts are normally kept in the DataHub's scripts subdirectory, such as C:\Program Files\Cogent\DataHub\scripts\myscript.g. Be sure to choose a Gamma script (with a .g extension).
  2. If you need to edit the script before running it, press the Edit button to open the selected script in the Script Editor.
  3. To run the script manually, press the Load Now button.
  4. To see any script output or error messages, you can press the Script Log button near the bottom of the Properties window to open the Script Log.
  5. To configure a script to run automatically at startup, check the checkbox next to it . The next time you start the DataHub, this script will load and run automatically.
  6. Once a script is started, it will continue running until the DataHub shuts down. To stop the script without shutting down the DataHub, press the Script Manager button to open the Script Application Manager.
    Highlight the script you want to stop, and press the Stop Selected button.