Configure an ArchestrA data source object

Add an ArchestrA data source object to your Gateway Communication Driver hierarchy

1. Right-click Configuration in the hierarchy, and select Add ArchestrA Connection.

   • A new object is created in the hierarchy tree and is named New_ArchestrA_000 by default (in "edit mode"). Rename it, if desired. You are allowed to add only one ArchestrA data source.

     The New_ArchestrA_000 Parameters configuration view (right pane) is displayed.

2. Configure the new ArchestrA object according to the following option definitions:

   • Device Group Name: Name of the topic to which DDE or SuiteLink clients of Gateway Communication Driver connect in order to access items in the ArchestrA data source.

     Default value is ArchestrA (this cannot be edited).

   • Reconnect Attempts: Number of times Gateway Communication Driver attempts to reconnect to the specified data source if a connection fails.

     Default value is 3.

     Minimum/maximum range is -1 to 1,000,000. Entry of a value that is excessively out of the allowed range will display an error message about illegal format.

     The value (-1) means no limit to the number of attempts. The value Zero (0) means no attempts.

   • Reconnect Period: Delay (in ms) between reconnection attempts if a connection fails.

     Default value is 30000 ms. Minimum/maximum range is 10,000 to 300,000 ms (corresponding to the range of 10 sec to 5 min). Entry of a value beyond the allowed range will display an error message about illegal format.

   • Write Credentials: User credentials created in ArchestrA for write qualifications.

   • Read Only: Check this box for the Gateway Communication Driver to make all the items connected through the ArchestrA data source as ‘read-only’. This is in addition to other read-only conditions that ArchestrA imposes. Clearing the selection removes the read-only condition for the item imposed by the Gateway Communication Driver. By default, the Read-Only check-box is selected.

   • Domain: Enter the domain name to logon to ArchestrA. If the Read Only box is unchecked and ArchestrA has security enabled, enter the domain name as configured in ArchestrA.

     Note: The Domain option should have a valid domain name when the ArchestrA security authentication mode is "OS Users" or "OS Groups". This option should be left empty when the ArchestrA security authentication mode is "Galaxy".

   • User Name and Password: These options, along with Domain, comprise the credentials used to logon to ArchestrA. If the Read Only box is unchecked and ArchestrA has security enabled, you must enter valid credentials as configured in ArchestrA.

     Note: ArchestrA user login data is not hot-configurable. Gateway Communication Driver must be restarted for the new values to take affect.