Creating a DataGrid Connection

In the Getting Started tutorial, the second task you must do using the plug-in is to create a DataGrid connection.

In the plug-in, a DataGrid shared resource represents a distributed database. The DataGrid shared resource is available at the Resources level. To use ActiveSpaces DataGrid activities, you must create a DataGrid connection and then add a table to the DataGrid.

Before you begin

You must create a project as described in Creating a Project .

    Procedure
  1. In the Project Explorer view, expand the created project.
  2. Right-click the Resources folder and click New > DataGrid to open the ActiveSpaces window.
  3. The Resource Folder, Package, and Resource Name of the DataGrid resource are provided by default. If you do not want to use the default configurations, browse and change them accordingly.
  4. Click Finish.
    The DataGrid Editor opens. See DataGrid Connection Parameters.

  5. In the General panel, provide the following details where required.
    1. The details that you provided in step 3 are seen in Package and Name.
    2. Optional: Enter details in Description for the DataGrid.
  6. In the DataGrid panel, provide the following details where required.
    1. Optional: Enter the Grid Name.
    2. Optional: Enter the Client Label.
    3. Enter the RealmServer URL. The default provided is: http://localhost:8080.
    4. Optional: Enter details of a backup server in Secondary Realm Server URL.
    5. Enter Wait Time. The default value is 0.1 second.
    6. Enter Timeout. The default value is 5.0 seconds.
    7. Enter the authenticated User Name for the server.
    8. Enter the authenticated Password for the server.
  7. In the Security panel, provide the following details as required.
    1. Optional: Select the SSL check box.
    2. If you have selected the SSL check box, enter the path for the SSL certificate in Trust File.
  8. In the Prefetch and Snapshot Settings panel, provide the following details where required.
    1. Enter prefetch details.
    2. Select the snapshot level.
  9. In the Proxy Binding Settings panel, provide the following details as required.
    1. Select the Binding Strategy. The default value is random strategy.
    2. If the binding strategy is random, enter the Number of Proxy Responses. Or, if the binding strategy is named, enter Pipe(|) Separated Proxy Names.
  10. Save the details. Restart TIBCO Business Studio.
    Important: If you are creating a new project in TIBCO Business Studio, you must restart before the next step.

    Note: If you want to reconnect automatically to the ActiveSpaces datagrid when it is restarted after it is shut down due to failure or maintenance, you must set the property, -Dbw.asplugin.isFailFastMechanismForConnectionDisabled=true in the VM arguments in TIBCO Business Studio during design time and then include the property in the config.ini file of the plug-in during runtime.

  11. Click Test Connection to validate the connection.
What to do next

After you have created a DataGrid, the next task is to add a table. See the Getting Started tutorial.