===========================================================
LiveView sample that connects to an ActiveSpaces Metaspace
===========================================================

This LiveView sample is configured to connect to an already
configured and running ActiveSpaces Metaspace. You must have
separately installed TIBCO ActiveSpaces, See the ActiveSpaces 
documentation on docs.tibco.com for further information.

Make sure you have the most recent version of ActiveSpaces installed 
and tested. Contact your TIBCO Support representative to make sure your ActiveSpaces
release is up-to-date.

The configuration file RemoteASTables.lvconf has sample configuration
information needed to connect to the ActiveSpaces Metaspace.

Follow these steps to run this sample in StreamBase Studio:

 1. Configure sbd.sbconf to point the <jar> and <library> elements to the 
    location of your ActiveSpaces libraries in the ActiveSpaces
    installation directory.

 2. Make sure there is a Metaspace and Space currently up and running
    on the machine you want to connect to. The sample includes a
    configuration file named asAdminCLIScript.txt, which can be used
    to start such a Metaspace and correctly-defined Space on your
    machine using the following command, run from the $AS_HOME/lib
    directory:
    java -jar as-admin.jar -i <path_to_sample_project>/asAdminCLIScript.txt

  3. Start the LiveView project:
    - In the LiveView Project Viewer, click the green Run button in
      the upper right.
    - Right-click any of the lvconf table configuration files 
      in the Package Explorer view, or right-click the project folder 
      itself, and select Run As > LiveView Fragment.

  4. You can use a LiveView client publish command to write data to the 
     sample space. Open a StreamBase Command Prompt window and enter,
     for example:

       lv-client publish sbspace
       employeeNumber,firstName,lastName,department,location
       1,Jane,Doe,Lighting,Venus

  5. You can connect LiveView Desktop or lv-client to this sample
     and query data in the ActiveSpaces space. Start LiveView
     Desktop and connect to the default server:port, and look for
     the table named sbspace in the Table Explorer. Double-click 
     sbspace and look for a snapshot of sbspace with the 
     Jane Doe line you just published.

  6. Return to the open window in step 4, and publish another row:

       2,John,Smith,Sound,Mars

  7. After publishing another row in step 6, look in LiveView Desktop 
     for the new row added to the sbspace table.

You can also use predicate expressions to filter result sets. The expressions
used are sent directly ActiveSpaces, so you must use the ActiveSpaces filter
syntax as described in the TIBCO ActiveSpaces(R) Developer's Guide.