DataGrid Connection Parameters

Given below are the parameters that you can specify for a datagrid in the DataGrid Editor to establish a connection with ActiveSpaces®.

General

The General panel shows the package that stores the DataGrid shared resource and the shared resource name. You can also provide a description for the shared resource in this panel.

The following table describes the fields in the General panel of the DataGrid shared resource:

Field Module Property? Description
Package No Specifies the package that saves the DataGrid shared resource.
Name No Specifies the name to be displayed as the label for the DataGrid shared resource in the process.
Description No Optional: Specifies a short description for the shared resource.

DataGrid

In the DataGrid panel, you can provide information for the ActiveSpaces datagrid that the plug-in connects to.

The following table describes the fields in the DataGrid panel of the DataGrid shared resource:

Field Module Property? Description
Grid Name

 

 No Specifies the name to be displayed as the label for the DataGrid shared resource in the process.

Besides the default name, you can specify another name for the DataGrid shared resource.

Client Label No Optional: Specifies a label for the client that can be used for monitoring.
Realm Server URL Yes Specifies the FTL realm server URL of a datagrid used by a member to connect. The default value is http://localhost:8080

For more information, see TIBCO ActiveSpaces Developer’s Guide.

Secondary Realm Server URL   Optional: Specifies the backup FTL realm server URL of a datagrid used by a member to connect.
Wait Time (seconds) Yes Optional: Specifies the amount of time that the member waits for a connection to the datagrid. The value must be set to greater than the client-proxy roundtrip time or the connection will fail and must be retried.

The default value is 0.1 second.

For more information, see TIBCO ActiveSpaces Java API Reference.

Timeout (seconds) Yes Optional: Specifies the amount of time that the member waits for a reconnection after the connection to the datagrid terminates unexpectedly.

The default value is 5.0 seconds.

For more information, see TIBCO ActiveSpaces Java API Reference.

User Name Yes Specifies the user name for the realm server. The user name has a string value.
Password Yes Specifies the password for the realm server. The password has a string value.

Security

The Security panel is used for securing the transfer of data.

The following table describes the fields in the Security panel of the DataGrid shared resource:

Field Module Property? Description
Use SSL No Specifies whether to use a secure URL for the DataGrid shared resource.
Trust File No Specifies the path of the SSL certificate or the trust file. This field is visible when the Use SSL check box is selected.

Prefetch and Snapshot Settings

The Prefetch and Snapshot Settings panel is used for transferring data. It is used only for the Query and QueryBySQL activities. You cannot use it for the Get, Put, and Delete activities.

The following table describes the fields in the Prefetch and Snapshot Settings panel of the DataGrid shared resource:

Field Module Property? Description
Prefetch No Specifies the units of data to be transferred in the DataGrid shared resource.
Note: If you set a value in the "prefetch" field of the Input tab in the Query or QueryBySQL activity, that value overrides the value provided here.
Snapshot Level No Specifies the snapshot level to be displayed for the DataGrid shared resource in the process. You can select either global snapshot or local snapshot.

Note: If you set a value in the "Global_Snapshot_Required_for_Iterator" field of the Input tab for the Query Activity or "Global_Snapshot_Required_for_Statements" for the QueryBySQL activity, that value overrides the value provided here.

Proxy Binding Settings

The Proxy Binding Settings panel is used to bind proxies to a client.

The following table describes the fields in the Proxy Binding Settings panel of the DataGrid shared resource:

Field Module Property? Description
Binding Strategy No Specifies the method to select a proxy for the client. You can select either the random binding strategy or the named binding strategy. By default, the random binding strategy is selected. If you want more control over proxy selection, use the named binding strategy.
Number of Proxy Responses No Specifies the number of proxy responses that can be received if random binding strategy is selected.
Pipe(|) Separated Proxy Names No Specifies the list of proxies that can be bound to a client if named binding strategy is selected The pipe symbol (|) is used as a delimiter to separate proxies in a list. For example, proxy1|proxy2|proxy3. The highest priority proxy is specified first in this list followed by the others. The last proxy in the list has the lowest priority.