2.6.34.3 OE Control Displays Key .................................................................................... 99
NW3000 Signal Builder Key ............................................................................. 75
3 Index ..................................................................................................................................... 100
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 7
Settings Edito
1 Settings Editor
Settings Editor is a tool for viewing, editing and managing the OpenEnterprise Settings file. The
settings are displayed in a two pane key and values window. The OpenEnterprise settings file is a
text based INI file. This is found in the designated Application Data directory.
Typically, in a WindowsXP installation, this would be 'C:\Documents and Settings\All
Users\Application Data\Bristol\OpenEnterprise\Application Data'. In Vista, this directory would be
'C:\ProgramData\Bristol\OpenEnteprise\Application Data.
Although Settings Editor enables you to inspect and modify OpenEnterprise settings, normally you do
not need to do so, and making incorrect changes can break your system. An advanced user who is
prepared and able to edit, save and restore the settings file can safely use Settings Editor for such
tasks as creating allowed non-default keys and values (such as the Connection Overrides key
We strongly recommend that you use each OpenEnterprise component to modify its own settings e.g.
use the Session Manager to create or modify new sessions and tasks, rather than attempt to edit the
settings directly in the Settings Editor.
).
1.1 Command line options
The Settings Editor can be launched with the following command line options.
Option
/f
/?
/r
/i
/sv
/ck
/dk
/dv
Set the path to an alternative Settings File. This can be used for examining
configuration files other than the current default OpenEnterprise configuration
file.
Show command line help. The Settings Editor Help file will open with this topic
displayed.
Import settings from the registry.
Import Settings from a file. Specify the file after the /i option.
Set a value in the Settings File. Specify the key path using /k, the value name
using /v and the value data using /d.
Create a key in the Settings file. Path is specified using /k.
Delete a key from the Settings File. Path is specified using /k.
Delete a value from the Settings File. Specify the key path using /k and the
value name using /v.
Explanation
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 8
Settings Edito
/no
/nd
/k
/v
/d
/s
/p
/da
/x
/wf
/sf
/rs <file>
Do not allow use of the /sv option to overwrite an existing value.
Suppress writing of the default value when creating a new key.
Specify a key path for /dv, /dk, /ck, /sv, /x options.
Specify a value name for /sv, /dv options.
Specify value data for the /sv option.
Create a Restore Point. The description of the Restore Point is specified after
the /s option.
Indicate that a Restore Point created with /s is to be permanent.
Delete the Settings File.
Export a key from the Settings File. Specify the key path using /k. Specify the
file path after the /x option.
Create standard folders applicable to a workstation installation.
Create standard folders applicable to a server installation.
Run a script file (a text file containing command line options which will be
executed in order).
1.2 Warning
When the Settings Editor is started, by default it will display this warning. This is because it is an
advanced administration tool only. An inexperienced user could render the OpenEnterprise
application unusable.
It is strongly recommended that users should alter settings through the OpenEnterprise component's
own interface. There is a checkbox to prevent the dialog from being shown again.
1.2.1 Do not show this message again
Check this box if you do not want it to appear again when the Settings Editor is started.
To enable the warning dialog again, set the data of the DoNotShowWarning value on the Settings
Editor key to 0 (zero).
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 9
Settings Edito
1.3 Main Interface
The main interface of the Settings Editor displays OpenEnterprise application keys in the left pane as
folders. Any values that apply to the selected key are shown in the right pane.
1.3.1 File
The File menu allows the user to import and export keys or key values, see the log file viewer,
configure restore points and view Settings Editor properties.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 10
1.3.1.1 Import
The 'Choose file for Import' dialog enables the user to select a previously saved .INI file for import into
the Settings Editor.
Settings Edito
1.3.1.2 Export
The Export menu enables the user to export All Keys or selected Keys or values to a .INI file. This is a
way of saving the current OpenEnterprise setup. Exported files can be imported later using the Import
menu.
1.3.1.2.1 All Keys
If the 'All Keys' option is selected, the 'Choose Export File' dialog will open. The default output folder is
displayed.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 11
Settings Edito
The default file name of 'OpenEnterprise.ini' will be placed in the 'File name' field. If this file name is
left unchanged, the original file will be overwritten .
The file name can be changed, but bear in mind that when the Settings Editor is opened, by default it
uses the 'OpenEnterprise.ini' file, which it finds in the output directory to display OpenEnterprise
settings. Also all individual OpenEnterprise components will access this file to determine and write its
settings. The Settings Editor can be made to use another configuration file when it starts by using the
/f command line argument when starting the Settings Editor.
1.3.1.2.2 Selected Keys
The Settings Editor will export the selected key and all its sub-keys to a configuration file (with a .ini
extension). All key values will also be exported to the file.
The 'Choose Export File' dialog will open with the default output folder displayed. A suggested
filename will be placed in the 'File name' field, based on the name of the currently selected key. This
name can be changed if required.
1.3.1.2.3 Selected Values
The Settings Editor will export the currently selected value or values to a configuration file (with a .ini
extension).
The 'Choose Export File' dialog will open with the default output folder displayed. A suggested
filename will be placed in the 'File name' field, based on the name of the key to which the currently
selected value or values belong. This name can be changed if required.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 12
1.3.1.3 Log File Viewer
This option opens the Log File Viewer dialog.
1.3.1.4 Restore Points
This option opens the Restore Points dialog.
1.3.1.5 Properties
This option opens the Properties dialog.
Settings Edito
1.3.2 Edit
The Edit menu enables users to create, modify or delete keys and values.
1.3.2.1 New
A sub menu opens, which enables the user to add a new key or value.
1.3.2.2 Modify
This option opens the Modify Value dialog.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 13
When accessed from the Edit Menu, it is only enabled if the user has currently selected a value in the
right pane of the main interface.
1.3.2.3 Rename
A sub menu opens, which enables the user to rename a key or value.
1.3.2.4 Delete
A sub menu opens, which enables the user to delete a key or value. The currently selected key or
value will be deleted.
Settings Edito
1.3.2.4.1 Delete Key Verification
Before the deletion of a key, the following dialog will be displayed. Select Yes to continue with the
deletion, or No to abort the deletion.
1.3.2.4.2 Delete Value Verification
Before the deletion of a value, the following dialog will be displayed. Select Yes to continue with the
deletion, or No to abort the deletion.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 14
1.3.2.5 Undo
Undoes the last action taken, whether it was to add, modify or delete an object. When an action is
taken, a description of the action will be written to the menu option to aid the user in identifying the
action that was taken.
If the action is undone, a description of the previous action is written to the Undo menu option.
Settings Edito
All edits that occurred during the current session can be undone one at a time. When the first action
that occurred during the session is undone, the Undo menu is disabled until a new action is
undertaken.
1.3.3 Application Keys
The left pane displays the application keys as nodes of a tree.
For a full explanation of the settings that can be applied on each key, see the 'Key Settings
There is a context menu
the user to create a new key or modify the selected key, or delete the key.
that appears when any of the keys in the left pane are selected. This enables
' page.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 15
1.3.3.1 Keys Context Menu
When the user selects a key and right clicks, this context menu becomes available. It enables the
user to perform operations on the keys in that pane.
1.3.3.1.1 New
Settings Edito
This option opens the New Key dialog.
1.3.3.1.2 Rename
This option opens the Rename Key dialog.
1.3.3.1.3 Delete
Deletes the currently selected value. Before the deletion, the user is asked to verify the deletion with
this dialog.
Selecting Yes will continue the deletion, No will abort the deletion.
1.3.3.1.4 Copy
Copies the currently selected value to the Windows clipboard.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 16
1.3.3.1.5 Paste
Pastes a copied value into the right pane. A value that is copied into the same key will be renamed to
'Copy of <value name>'.
1.3.3.1.6 Export
This option on the Key context menu enables the user to save the selected key to the Application
Data directory.
Settings Edito
1.3.4 Key Values
When a key is selected from the left pane, the values that are configured for that key are displayed in
this pane.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 17
All values have a value name and value data component. Possible value names for each key are set
by OpenEnterprise. A new value created must have a name that matches the values available for the
currently selected key.
The value data can be changed by OpenEnterprise components or by the Settings Editor.
To create, modify or delete a value, select a value on this pane and right click. The context menu
provides options to do these things.
Settings Edito
or a full explanation of the settings that can be applied on each key, see the 'Key Settings
1.3.4.1 Value Name
Each key has a number of associated 'values' that are used to configure the OpenEnterprise
component represented by the key. Each value has a name and data component.
Most of the keys have values that are created by OpenEnterprise at installation, and default data is
used. Other keys may have values that are not created at installation time, but must be inserted into
the key by a user.
When creating a new value or renaming an existing one, the dialog displays an editable field into
which the user must type the name of the value.
When creating new values, it should be remembered that value names are set strings that are
recognized by OpenEnterprise as being associated with a customizable setting. Value names must
therefore coincide with the setting values that are recognized internally. Review the 'Key Settings'
page for the selected key before adding a new value.
However, when modifying an existing value, the Name field is not editable, because modification of a
value only applies to its data component.
' page.
1.3.4.2 Value Data
Value data is a string that provides OpenEnterprise with information about how the component
represented by the key is to be configured. The value data string can also represent a number.
OpenEnterprise decides the data type that is meant.
Certain default data will be used on installation, but value data can be changed using the Settings
Editor.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 18
When creating a new value, the dialog displays an editable data field into which the user must type
the data. The user must be aware of feasible data for the value selected. Before entering data for a
value, the user should review the possible values and expected data for the selected key in the Key
Settings section of this document help file.
When renaming an existing value, the data field is not editable.
1.3.4.3 Values Context Menu
When the user selects a value and right clicks, this context menu becomes available. It enables the
user to perform operations on the values in that pane.
Settings Edito
1.3.4.3.1 New
This option opens the New Value dialog.
1.3.4.3.2 Modify
This option opens the Modify Value dialog.
When accessed from the Edit Menu, it is only enabled if the user has currently selected a value in the
right pane of the main interface.
1.3.4.3.3 Delete
Deletes the currently selected value. Before the deletion, the user is asked to verify the deletion with
this dialog.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 19
Selecting Yes will continue the deletion, No will abort the deletion.
1.3.4.3.4 Rename
This option opens the Rename Value dialog.
1.3.4.3.5 Copy
Copies the currently selected value to the Windows clipboard.
Settings Edito
1.3.4.3.6 Paste
Pastes a copied value into the right pane. A value that is copied into the same key will be renamed to
'Copy of <value name>'.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 20
1.3.4.3.7 Export
Settings Edito
1.4 New Key
Enables the user to create a new key.
1.4.1 Key Name
Type the key name into this field. See the 'Key Settings' section of this document for information on
keys that can be created by the user.
Most keys are created by OpenEnterprise at installation time. The number of keys that can be created
by a user after installation are limited. For instance, a typical key that can be created by an
administrative user would be the 'ConnectionOverrides' key. This can become a sub-key of any
OpenEnterprise Task key.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 21
Settings Edito
1.5 New Value
Enables the user to create a new value on the currently selected key.
1.5.1 Value Name
Each key has a number of associated 'values' that are used to configure the OpenEnterprise
component represented by the key. Each value has a name and data component.
Most of the keys have values that are created by OpenEnterprise at installation, and default data is
used. Other keys may have values that are not created at installation time, but must be inserted into
the key by a user.
When creating a new value or renaming an existing one, the dialog displays an editable field into
which the user must type the name of the value.
When creating new values, it should be remembered that value names are set strings that are
recognized by OpenEnterprise as being associated with a customizable setting. Value names must
therefore coincide with the setting values that are recognized internally. Review the 'Key Settings'
page for the selected key before adding a new value.
However, when modifying an existing value, the Name field is not editable, because modification of a
value only applies to its data component.
1.5.2 Value Data
Value data is a string that provides OpenEnterprise with information about how the component
represented by the key is to be configured. The value data string can also represent a number.
OpenEnterprise decides the data type that is meant.
Certain default data will be used on installation, but value data can be changed using the Settings
Editor.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 22
When creating a new value, the dialog displays an editable data field into which the user must type
the data. The user must be aware of feasible data for the value selected. Before entering data for a
value, the user should review the possible values and expected data for the selected key in the Key
Settings section of this document help file.
When renaming an existing value, the data field is not editable.
Settings Edito
1.6 Rename Key
Enables the user to rename the selected key.
1.6.1 Key Name
Type the key name into this field. See the 'Key Settings' section of this document for information on
keys that can be created by the user.
Most keys are created by OpenEnterprise at installation time. The number of keys that can be created
by a user after installation are limited. For instance, a typical key that can be created by an
administrative user would be the 'ConnectionOverrides' key. This can become a sub-key of any
OpenEnterprise Task key.
1.7 Rename Value
Enables the user to rename the currently selected value in the right pane.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 23
Settings Edito
1.7.1 Value Name
Each key has a number of associated 'values' that are used to configure the OpenEnterprise
component represented by the key. Each value has a name and data component.
Most of the keys have values that are created by OpenEnterprise at installation, and default data is
used. Other keys may have values that are not created at installation time, but must be inserted into
the key by a user.
When creating a new value or renaming an existing one, the dialog displays an editable field into
which the user must type the name of the value.
When creating new values, it should be remembered that value names are set strings that are
recognized by OpenEnterprise as being associated with a customizable setting. Value names must
therefore coincide with the setting values that are recognized internally. Review the 'Key Settings'
page for the selected key before adding a new value.
However, when modifying an existing value, the Name field is not editable, because modification of a
value only applies to its data component.
1.7.2 Value Data
Value data is a string that provides OpenEnterprise with information about how the component
represented by the key is to be configured. The value data string can also represent a number.
OpenEnterprise decides the data type that is meant.
Certain default data will be used on installation, but value data can be changed using the Settings
Editor.
When creating a new value, the dialog displays an editable data field into which the user must type
the data. The user must be aware of feasible data for the value selected. Before entering data for a
value, the user should review the possible values and expected data for the selected key in the Key
Settings section of this document help file.
When renaming an existing value, the data field is not editable.
1.8 Modify Value
Enables the user to modify the data for the currently selected value in the right pane.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 24
Settings Edito
1.8.1 Value Name
Each key has a number of associated 'values' that are used to configure the OpenEnterprise
component represented by the key. Each value has a name and data component.
Most of the keys have values that are created by OpenEnterprise at installation, and default data is
used. Other keys may have values that are not created at installation time, but must be inserted into
the key by a user.
When creating a new value or renaming an existing one, the dialog displays an editable field into
which the user must type the name of the value.
When creating new values, it should be remembered that value names are set strings that are
recognized by OpenEnterprise as being associated with a customizable setting. Value names must
therefore coincide with the setting values that are recognized internally. Review the 'Key Settings'
page for the selected key before adding a new value.
However, when modifying an existing value, the Name field is not editable, because modification of a
value only applies to its data component.
1.8.2 Value Data
Value data is a string that provides OpenEnterprise with information about how the component
represented by the key is to be configured. The value data string can also represent a number.
OpenEnterprise decides the data type that is meant.
Certain default data will be used on installation, but value data can be changed using the Settings
Editor.
When creating a new value, the dialog displays an editable data field into which the user must type
the data. The user must be aware of feasible data for the value selected. Before entering data for a
value, the user should review the possible values and expected data for the selected key in the Key
Settings section of this document help file.
When renaming an existing value, the data field is not editable.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 25
Settings Edito
1.9 Log File Viewer
The Log File Viewer displays all edits that have been made to the 'OpenEnterprise.ini' file. The edits
may have been made by the Settings Editor itself, or another OpenEnterprise component, like the
Alarm Client Server or the Bristol OPC Server.
1.9.1 Menu
These are the options available on the Log File Viewer's menu bar.
1.9.1.1 File
These are the options available on the Log File Viewer's file menu.
1.9.1.1.1 Previous and Next File
These options are only enabled if the Settings Editor has been configured to have a new log file
created each day. If the default setting is left as it is, the Settings Editor uses a single log file, and
these options are disabled.
1.9.1.1.1.1 File Menu
If they are enabled, these options allow the user to skip backward and forward between the log files
that have been created for each day.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 26
1.9.1.1.1.2 Toolbar
The same options are displayed like this on the Log Viewer toolbar.
1.9.1.2 Edit
These are the options available on the Log File Viewer's edit menu.
1.9.1.2.1 Select All
Settings Edito
Selects all events listed in the Log File Viewer.
1.9.1.2.2 Copy
Copies the currently selected Log File events to the Windows clipboard.
1.9.1.3 View
These are the options available on the Log File Viewer's view menu.
1.9.1.3.1 Refresh View
Refreshes the actions list when selected from the menu or the toolbar
1.9.1.3.1.1 Toolbar button
1.9.1.3.2 Order by Most Recent First
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 27
Orders the events in the Log File View actions list so that the most recent events are at the top of the
list.
1.9.1.3.2.1 Toolbar button
The example button above has an orange border around it, indicating that this option has been
selected.
1.9.1.3.3 Order by Most Recent Last
Orders the events in the Log File View actions list so that the most recent events are at the bottom of
the list.
1.9.1.3.3.1 Toolbar button
Settings Edito
The example button above has no orange border around it, indicating that this option is not selected.
1.9.1.3.4 Show All Events
Toggles the showing of all events on and off. When unselected, the events list will only show
'Request' and 'Failed' completion entries.
1.9.1.3.4.1 Toolbar button
The example above has an orange border around the button, indicating that it has been selected. In
this state, all events will be shown, including 'Action' and 'Success' completion entries.
1.9.1.4 Tools
These are the options available on the Log File Viewer's tools menu.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 28
1.9.1.4.1 Find
Enables the user to search the Log Viewer's action list. Click the hotspots on the image below for
more help.
1.9.1.4.1.1 Search Text
Type the search string in this field, make sure that the right occurrence button is selected, then press
the [OK] button to begin the search. The search finds the next or previous instance of the exact text
typed into the 'Search Text' field.
Settings Edito
1.9.1.4.1.2 Find Next Occurrence
Finds the next occurrence of the text that has been typed into the 'Search Text' field.
1.9.1.4.1.3 Find Previous Occurrence
Finds the previous occurrence of the text that has been typed into the 'Search Text' field.
1.9.1.4.2 Find Next
Finds the next instance of the search string provided by the user on the 'Find In Logfile' dialog or in
the 'Find' text field on the toolbar.
1.9.1.4.2.1 Toolbar button
The button on the toolbar provides exactly the same functionality as the 'Find Next' menu.
1.9.1.4.3 Find Previous
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 29
Finds the previous instance of the search string provided by the user on the 'Find In Logfile' dialog or
in the 'Find' text field on the toolbar.
1.9.1.4.3.1 Toolbar button
The button on the toolbar provides exactly the same functionality as the 'Find Previous' menu.
Settings Edito
1.9.2 Toolbar
These are the options available on the Log File Viewer's toolbar.
1.9.2.1 Log File
If the Log Viewer is set up to use a single file, this field displays 'Current', indicating that the current
log file is being used.
If the Log Viewer is set up to use a daily file, this field displays date of the active file that is being
viewed, as shown below. Click the small arrow to the right of the field to see a list of all available log
files.
1.9.2.2 Previous and Next File
These options are only enabled if the Settings Editor has been configured to have a new log file
created each day. If the default setting is left as it is, the Settings Editor uses a single log file, and
these options are disabled.
1.9.2.2.1 File Menu
If they are enabled, these options allow the user to skip backward and forward between the log files
that have been created for each day.
1.9.2.2.2 Toolbar
The same options are displayed like this on the Log Viewer toolbar.
1.9.2.3 Refresh View
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 30
Refreshes the actions list when selected from the menu or the toolbar
1.9.2.3.1 Toolbar button
1.9.2.4 Order by Most Recent First
Orders the events in the Log File View actions list so that the most recent events are at the top of the
list.
1.9.2.4.1 Toolbar button
Settings Edito
The example button above has an orange border around it, indicating that this option has been
selected.
1.9.2.5 Order by Most Recent Last
Orders the events in the Log File View actions list so that the most recent events are at the bottom of
the list.
1.9.2.5.1 Toolbar button
The example button above has no orange border around it, indicating that this option is not selected.
1.9.2.6 Show All Events
Toggles the showing of all events on and off. When unselected, the events list will only show
'Request' and 'Failed' completion entries.
1.9.2.6.1 Toolbar button
The example above has an orange border around the button, indicating that it has been selected. In
this state, all events will be shown, including 'Action' and 'Success' completion entries.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 31
1.9.2.7 Find Text
Type the search text in here. Then click the Next of Previous buttons to the right of this field to search
the actions list for the text entered here.
1.9.2.8 Find Next
Finds the next instance of the search string provided by the user on the 'Find In Logfile' dialog or in
the 'Find' text field on the toolbar.
1.9.2.8.1 Toolbar button
The button on the toolbar provides exactly the same functionality as the 'Find Next' menu.
Settings Edito
1.9.2.9 Find Previous
Finds the previous instance of the search string provided by the user on the 'Find In Logfile' dialog or
in the 'Find' text field on the toolbar.
1.9.2.9.1 Toolbar button
The button on the toolbar provides exactly the same functionality as the 'Find Previous' menu.
1.9.2.10 Help Button
Opens the Settings Editor help file when selected.
1.9.3 Actions List
The actions list displays the edits that have taken place on the main OpenEnterprise configuration file.
As well as the Settings Editor, most OpenEnterprise components access this file when their settings
are changed.
The list can be filtered to show all events or only a sub-set of events.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 32
Settings Edito
1.10 Restore Point Properties
Restore points are a snapshot of the Settings file as it is at the time the restore point is created. They
allow the user to return OpenEnterprise settings to a previous state. Restore points can be created
automatically, or manually at any time.
1.10.1 Restore Point List
The restore point list displays all of the restore points that are available. Click on the 'Created' column
to reverse the sort order by date. By default, the most recent dates are at the top of the list.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 33
Settings Edito
1.10.2 Create a restore point before restoring
If this box is checked, when a restore point is activated by clicking the [Restore] button, the Settings
Editor will create a restore point from the current settings before restoring the previous settings.
The box is checked by default, since it is the safe option.
1.10.3 Create
Manually creates a new restore point using the current settings. It is possible to create a manual
restore point using the command line. See 'Command line options' topic.
1.10.4 Restore
Restores the settings from a selected restore point.
Current settings will be overwritten, so it is probably a good idea to check the 'Create a restore point
before restoring' box before clicking this button.
1.10.5 Delete
Deletes the selected restore point. Note that restore points can only be deleted if their 'Restore Point
may be deleted' option is checked on the Restore Point Properties
dialog.
1.10.6 Restore Point Properties
Displays the creation date and description of the selected restore point. There is also an option to
enable or disable deletion for the restore point. Click the hotspots for more help.
1.10.6.1 Creation Date
The date the restore point was created.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 34
1.10.6.2 Description
Describes the restore point. When automatic restore points are created, the text in this field reads
'Automatically created'.
When manually creating a restore point, the user should type helpful text in this field to explain the
reason for creating the restore point.
1.10.6.3 Restore Point Deletable
When checked, the restore point can be deleted. When unchecked, the restore point cannot be
deleted.
It is a good idea to create certain restore points that cannot be deleted. By default, all automatically
created restore points can be deleted.
Settings Edito
1.11 Settings Editor Properties
Displays the Settings and current log files used by the Settings Editor. Also allows modification of log
file and restore point settings.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 35
Settings Edito
1.11.1 Settings File
The full path and filename of the settings file currently being used by the Settings Editor.
1.11.2 Current Log File
The full path and filename of the current Settings Log File.
1.11.3 New Log File each Day
Select this option to have a new Log File created each day. The default behaviour is to have a single
log file.
1.11.4 Keep for Days
When the 'New Log file each day' button is selected this option becomes enabled. Enter the number
of days to keep each log file that is created.
1.11.5 Single Log File
This is the default setting. The Settings Editor will use a single Log File.
1.11.6 Maximum Size
Enter the maximum size that the Log File should ever get to. When the file reaches this size, the
Settings Editor deletes 10% of the oldest entries in the file and continues filling it from that point.
1.11.7 Keep Restore Points for days
The number of days to keep restore points for before deletion. Note that automatically created restore
points must have their 'Restore point may be deleted' property set on the 'Restore Point Properties'
dialog in order to be available for automatic deletion. This property may be set/unset for a restore
point by doing the following:-
1. Select 'File>Restore Points' from the main Settings Editor interface
2. Select the restore point from the list on the 'Restore Points
3. Select the [Properties] button at the bottom of the 'Restore Points' dialog
4. Check/uncheck the 'Restore point can be deleted' box on the 'Restore Point Properties
' dialog
' dialog
1.11.8 Automatic Restore Point Interval
The interval for creating automatic restore points. The smallest unit is one day.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
p
D5092
11-Dec-2007 - Page 36
2 Key Settings
Each key contains values and data that define OpenEnterprise settings.
2.1 OpenEnterprise Key
Settings Edito
This key stores basic OpenEnterprise settings. The data is determined at installation time. Warning:
making changes in the Settings Editor could cause OpenEnterprise to fail.
Value Name
Database The OpenEnterprise data service name to which all
database clients will connect.
TimeZone The time zone of the OpenEnterprise project. This is
determined when the database is built. If using the
Database Project Builder, there is a Time Zone page in
the wizard, where the time zone can be selected.
Type Signifies the type of OpenEnterprise installation. The
options, which are decided at installation are:-
• OpenEnterprise Server - installs the
OpenEnterprise database, Session Manager and
ancillary server components. Enables the host
PC to run a full OpenEnterprise Session,
including the database and any server tasks
required.
• OpenEnterprise Server and Workstation - installs
the above, plus the OpenEnterprise HMI.
Enables the host PC to run a full OpenEnterprise
Session, and to display the data in the
OpenEnterprise HMI.
• OpenEnterprise Workstation - installs the
OpenEnterprise HMI only. Enables the host PC
to connect to any remote OpenEnterprise data
service and view the data through the HMI.
• Standalone ODBC - installs and sets u
Value Data Default Data
'rtrdb1' for local
database.
GMT
None
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 37
components for clients to connect to a remote
OpenEnterprise data service via ODBC.
• OpenEnterprise Messaging - installs the
OpenEnterprise Messaging Server and
configuration tool. Enables the host computer to
connect to a remote OpenEnterprise data
service and act as an OpenEnterprise
messaging server.
• OpenEnterprise Report Suite - installs the
OpenEnterprise Reporting Suite. Enables the
host computer to connect to a remote
OpenEnterprise data service and act as a report
server.
• OpenEnterprise Report Add-in - installs the
OpenEnterprise Report add-in, enabling
OpenEnterprise report templates to be created
on the host computer.
Settings Edito
2.2 DataServices Key
This key contains the Administrative users name and password values. Under the key will be a key
that names any data services that may be connected to. Each key will have its own name and
password values. These keys or their values should not be changed using the Settings Editor.
Value Name
Password An encrypted password for the main administrative user
configured for the data service.
User Name The name of the main administrative user configured for
the data service.
Value Data Default Data
'rtrdb1' for local
database.
GMT
2.3 Directories Key
Defines the main OpenEnterprise directories on the host. The first part of the path is defined by a
variable which has a different value depending on whether the PC is operating in Windows XP or
Vista.
Value Name
ApplicationConfiguration The common
Value Data Default Data
<ApplicationData> is a variable that precedes the
application data folder,
where settings for
OpenEnterprise
components will be
stored.
rest of the path. The typical value of this variable in
custom changes to the
database configuration
and content reside in
this directory. By
default the Database
Project Builder places
its custom files in this
folder.
Install The main
OpenEnterprise
installation folder
OEStore Any files created by
users at runtime that
store their runtime data
(ie view files etc) will be
placed in sub
directories under this
directory.
Output These are files created
by applications during
runtime to log their
activity (eg
Scheduler.txt,
ArchiveFileManager.txt)
These files will be
considered user
specific and will be
saved to the current
user's documents
folder.
<PublicDocuments> is a variable that represents the
path. The typical value of this variable in XP would
be 'C:\Documents and Settings\All Users\Documents'
Typical Vista value = C:\Users\Public\Documents
A sub-directory within this directory will be used -
\Bristol\OpenEnterprise\Custom
Both XP and Vista use the same directory -
'C:\Program Files\Bristol\OpenEnterprise'
During installation, a check will be made for an O
drive configured with a 'Displays' sub directory. If
found, then O will be offered as the location of
OEStore.
If it is not, then the following location will be used for
OEStore -
<ApplicationData>\Bristol\OpenEnterprise\OEStore.
On XP the <UserDocuments> variable represents the
current user's documents folder.
On XP this is 'C:\Documents and Settings\<user>\My
Documents'.
On Vista it is 'C:\Users\<user>\Documents'.
A sub directory within this directory will be used:
<UserDocuments>\Bristol\OpenEnterprise\Output
Files.
2.4 ProductInformation Key
Provides information on the OpenEnterprise product installed.
Value Name
PRODUCTNAME The name of the OpenEnterprise product installed. OpenEnterprise
Value Data Default Data
2.5 Sessions Key
This is the parent key for all OpenEnterprise sessions. The actual sessions are represented in this
document by a single 'Configured Sessions Keys' topic. In actual fact, there can be multiple
configured sessions, as shown in the example below.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 39
OpenEnterprise sessions are created by the user from within the Session Manager. See the Session
Manager document for more information on how to create a session.
Settings Edito
2.5.1 Configured Sessions Keys
OpenEnterprise sessions are created by the user from within the Session Manager. See the Session
Manager document for more information on how to create a session.
The value names available for use on each configured session key will be the same, but the data may
be different.
Value Name
AffinityMask Set to a mask value that indicates
the processors that this session is
allowed to run on. 0 = CPU1, 1 =
CPU2 etc. Only applicable to multiprocessor PCs. See the Session
Settings topic of the Session
Manager document for more
information.
DatabaseDataService The name of the database which is
used by the configured session
(e.g. rtrdb1). See the Session Type
topic of the Session Manager
document for more information.
Dirty Ignore this value. It is there for
future use.
Value Data Default Data
0
rtrdb1
0
Type A string which describes the type
of session (e.g. Fault Tolerant).
See the Session Type
Session Manager document for
more information.
topic of the
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Depends on installation.
Reference Guide
r
D5092
11-Dec-2007 - Page 40
Settings Edito
WorkingDirectory The directory path where the
database data files are found. See
the Session Type
Session Manager document for
more information.
2.5.1.1 Fault Tolerance Key
The values on this key define the two Servers of a Fault Tolerant OpenEnterprise database. See the
Server Identification Page
Value Name
MachineLabel This value gives a label to the local Server to
in the Session Manager document for further help on these settings.
distinguish it from the other Server in the Redundant
pair. The label is usually either A or B. One server must
be A and the other must be B.
topic of the
Value Data Default Data
On XP:
C:\
Program Files\
Bristol\
OpenEnterprise\
Data
On Vista:
<PublicDocuments>\
Bristol\
OpenEnterprise\
Data
See the Directories Key topic
for a definition of the
<PublicDocuments> variable.
When
configuring a
session the
default is A.
One server
must be A,
and the other
must be B.
ThisHostName The name of the local machine. This can be an alias
(eg ServerA or ServerB) that has been defined in the
Hosts file on each server.
OtherHostName This is the name of the other Server. This also can be
an alias that has been defined in the Hosts file on each
server.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Default =
HOSTA, if this
is Machine
Label A. The
actual
name/alias of
the local
server should
be substituted
here.
Default =
HOSTB if this
is Machine
Label A. The
actual
name/alias of
the other
server should
be substituted
here.
Reference Guide
r
D5092
11-Dec-2007 - Page 41
2.5.1.1.1 Arbitrator Key
These settings appear on the Arbitrator Page of the Session Manager's New Session wizard. For help
on these settings see the Arbitrator Page
of the Session Manager documentation.
Settings Edito
Value Name
DataService Defines the order in
Retries The number of retries,
Value Data Default Data
which the local server
looks for a connection to
the arbitrator data
service when starting an
OpenEnterprise
session.
which when multiplied
by the RetriesMultiplier
value indicate the
number of times the
Session Manager will
retry when attempting to
connect to an arbitrator
database. Thus if
Retries = 1 and
RetriesMultiplier = 3,
then the Session
Manager will retry a
total of 3 times to
connect to the arbitrator
database.
HOSTA:Arbitrator1,HOSTB:Arbitrator1.
This value is merely to show the format of
the arbitrator data service string. Substitute
HOSTA and HOSTB with the actual host
names of the local and remote server.
1
RetriesMultiplier The multiplier for the
Retries value (see
above).
Timeout The length of time when
multiplied by the
TimeoutMultiplier value
taken between retries
when the Session
Manager is attempting
to connect to an
arbitrator database.
TimeoutMultiplier The multiplier for the
Timeout value (see
above).
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
1
5
1
Reference Guide
r
D5092
11-Dec-2007 - Page 42
2.5.1.1.2 DataLink Key
The DatalinkOPCServer is used as part of the OpenEnterprise Server Redundancy when using a
TBar to determine the Master/Standby status of the servers. It provides a dedicated communications
link between a pair of OpenEnterprise servers. This communications link is used by the redundant
OpenEnterprise Session Managers to send heartbeats to each other. These heartbeats are used to
pass current states and associated heartbeat time stamps.
Settings Edito
Value
Name
OPCServer Specifies the OPC (OLE for Process
Control) server to use.
PortName The name (e.g. COM3) of the serial
port being used for the Data Link.
Disable Make this 1 to disable DataLink if it
is not being used. 0 signifies that
DataLink is being used.
2.5.1.1.3 DiskSpace Key
This key is used internally by OpenEnterprise, and has no user configurable values.
2.5.1.1.4 TBar Key
This key is used when a Tbar has been employed to determine redundancy states.
Value Name
TagName This gives the name of the OPC Server and the T-Bar
Disable Set to 1 if a T-Bar is not being used. This will disable the
T-Bar interface. A value of 0 signifies that the T-Bar is
enabled.
2.5.1.2 Persistence Key
Defines whether persistence is enabled.
Value Name
Enabled A value of 1 = Persistence is enabled, a value of 0 =
Persistence is disabled.
Blocking This value is reserved for future use 0
Value Data Default Data
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
1
0
Reference Guide
r
D5092
11-Dec-2007 - Page 43
2.5.1.3 Software Watchdog Key
See the Software Watchdog
values found on this key.
topic of the Session Manager document for more information on the
Settings Edito
Value Name
Enabled If 0 the software watchdog does not run. If 1, it is
enabled
Period The frequency, in seconds, that the Software watchdog
will check the tasks that are configured to run
Retries Reserved for future use. 0
RetryPeriod Reserved for future use. 0
2.5.1.4 Session Tasks Key
The Tasks that will be run as part of a named OpenEnterprise Session. The actual name of this key is
'Tasks', as shown in the image below. Like the 'Sessions' key, there are no actual values to be
defined on the named Session Task key itself.
The keys under the Sessions 'Tasks' key are configured from the Session Manager. The keys under
the other 'Tasks' key are configured from the actual OpenEnterprise components themselves.
Value Data Default Data
1
60
2.5.1.4.1 Session Task Key
Session task keys are created under the key of each named session. In the example below, the
Turbidity session will have six tasks running within it - AFM (Archive File Manager), Calculation
Server, Database, RDI3000, Report Scheduler and Scheduler.
Some of the tasks are mandatory. For example each session has to have one database task, and one
RDI task (this is the RDI3000, if the RTUs are NW3000 or Control Wave).
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 44
The names of the keys provide a visual indication of what tasks they are, but the definition of the task
is contained in the values on the key. These values and their meaning are given below.
Settings Edito
Value Name
Application The Data must be the executable name and
path of an OpenEnterprise server
component. This value is Mandatory.
CommandLine Command line arguments. Consult the
Task’s document for possible command line
parameters. This value is Mandatory.
WorkingDirectory Full pathname for the working directory for
the task. Long or short pathnames. This
value is Mandatory.
CriticalProcess If this is set to 1 the task is considered
critical. If a critical task fails then it will be
restarted by Session Manager. This value is
Optional.
Retries Number of times to retry starting the task (if it
is critical) given repeated task restart
failures. Defaults to infinite retries. This value
is Optional.
ResourceFile Poly.cfg resource filename. This value is
only necessary for database tasks.
Value Data Default
Data
Set at
installation
Set at
installation
Set at
installation
Set at
installation
-1
Poly.cfg
EventNumber If this task is a critical task and it should fail,
the eventnumber is the number that will be
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
N/A
Reference Guide
r
D5092
11-Dec-2007 - Page 45
Settings Edito
used to log the event. Eventnumbers have
associated priorities configured in the
database. By default the number 101 is used
which has an associated priority of 254. This
value is Optional.
RetryPeriod This value is reserved for future use and
should be ignored.
ShutdownApplication Application used to terminate the task (eg
ShutDownDB.exe). Empty string means the
task will be killed.
The keywords _CLOSE, _KILL and _NULL
can also be used. _CLOSE will attempt to
close a task cleanly using WM_CLOSE.
_KILL will kill the task. _NULL will do nothing
(assumes the task will shut itself down when
it loses its database connection).
ShutdownCommandLine Additional command line options to pass to
the application specified by the
ShutdownApplication key.
ShutdownTimeout -56
ShutdownTimeoutKill 0
MasterShutdownCommandLine Additional command line options to pass to
the application specified by the
MasterShutdownApplication key. This value
is Optional.
0
_CLOSE
Set at
installation
Set at
installation
Visible 1 if the task is to be started visible on the
desktop, otherwise set to 0. This value is
Optional.
ActiveOnStandby Set to 1 if you wish this task to be active
when the session is standby. Tasks are
ordinarily started when the session is
master. This value is Optional.
AffinityMask Set to a mask value that indicates the
processors that this process is allowed to run
on. 0 = CPU1, 1 = CPU2 etc. Only applicable
to multi-processor PCs. This value is
Optional.
Disabled Enable or disable the task. A value of 1
results in the task being disabled and will not
be started by the Session Manager. Default
value: 0, enabled. This value is Optional.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
0
0
0
0
Reference Guide
r
D5092
11-Dec-2007 - Page 46
Settings Edito
2.6 Tasks Key
The Tasks key is the parent key under which the keys for each OpenEnterprise component go.
There are no configurable values for the Tasks key itself. Each task key has its own configurable
values. The values on these keys can be set by the component's configuration interface.
2.6.1 Connection Overrides
A 'Connection Overrides' key can be added to any Task key. This key has values which can fine tune
how the component connects to the database. These settings can be tweaked to minimize network
bandwidth problems which may be caused when Views are trying to connect to the database.
2.6.2 Alarm Client Server Key
The values on this key define the settings of the Alarm Client Server. This is the server component
that provides the data that the Alarm View displays.
These settings are best modified from the Alarm Client Server interface.
Value Name
Databases A space separated list of databases that the Alarm
Client Server will attempt to connect to when it is
started. This enables the Alarm Server to be started
and connected to relevant databases before any
Alarm View clients begin requesting alarm or event
data.
HideOnMinimize Forces the Alarm Client Server to be hidden when it is
minimized. A value of 1 mains the Alarm Client
Server will be hidden when minimized, zero (0) means
The Alarm Client Server will not be hidden when
minimized.
Value Data Default
Data
default =
User defined
at
installation
time.
1
MessagesDatabase A typical system may be configured for retrieving N/A
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 47
Settings Edito
historical data (events) from a database configured for
read-only access. The Create Event facility will not
work in this situation, as the database transaction will
always fail. To cater for this, an alternate database for
Event Inserts can be specified.
This means that events can be sourced from a readonly database (for example: rtrdb1), edited (using the
Create Event option) then inserted into a second,
distinct database (as defined by the Messages
Databases registry value)
OptionsDatabase A pre-defined Options database can be configured
here. The Options database is used for retrieving the
Options data. This is essentially a list of real-time and
historical attributes, available conditions, priorities and
color schemes that a default Alarm Client will use. It
may be different to the Messages database.
ShowTrayIcon When set to 1, the Alarm Client Server icon will be
displayed in the System Tray when it is running.
Double clicking on this icon in the System Tray will
open the Alarm Server's User Interface. If set to zero
(0) the Alarm Server icon will no longer appear in the
System Tray when it is running.
ShowWindow When set to 1, the Alarm Client Server's User
Interface will be displayed on startup.
Minimize When set to 1, the Alarm Client Server's User
Interface will be displayed minimized on the Windows
Start bar at startup.
2.6.2.1 Connection Overrides Key
When OpenEnterprise is installed as a Server application there are default Connection Overrides
applied to the Session Manager component.
Initially set
at
installation
time.
1
0
0
However, the Connection Overrides key, with its values may be added as a sub-key to any
OpenEnterprise Task listed under the Task key of an OpenEnterprise installation.
Also, the Connection Overrides key can affect all Workstation HMI components if it is attached to the
COMServer task key. If necessary, the COMServer task key can be added by a user as a sub-key
under the Tasks key,
The settings defined here can be redefined for any OpenEnterprise Client (e.g. Alarm Viewer, Notes
Client, Database Explorer) by adding the Connection Overrides key to the component key in the
Tasks list and changing the values.
Value Name
Auto
Reconnect
A non-zero value means that the Client will
automatically attempt to reconnect to the database
following a connection failure.
Value Data Default Data
0
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 48
Settings Edito
Connection
Timeout
Reconnection
Retries
Reconnection
Interval
Reconnection
Retries
Heartbeat
Interval
Heartbeat
Timeout
A timeout specified in seconds applied to all TCP/IP
socket requests (open, read and write).
Increase this value when client disconnects occur when
connecting to a database over a very slow or high
latency network.Normally used in conjunction with the
following poly.cfg resources:
ConnectionOpenTimeout, ConnectionReadTimeout and
ConnectionWriteTimeout.
The maximum number of times a database reconnection
is attempted for each individual dataservice following a
loss of connection.
Millisecond interval between successive reconnection
attempts.
The maximum number of times a database reconnection
is attempted for each individual dataservice following a
loss of connection.
Interval, in milliseconds, between each heartbeat
message being sent to the database.
Timeout in milliseconds, for each heartbeat sent to the
database. If no reply is received from the database within
this time
10
N/A
N/A
N/A
N/A
N/A
Maintain
Queries
Deadband
Seconds
Deadband
MicroSeconds
FT
Connection
Type
FT Options When set to 1, fault tolerant options are enabled. Set to
Keep copies of all active query data to enable calculation
of data changes after a fail over.
The Deadband Seconds and Microseconds specify a
minimum interval between active query deltas.
See “Deadband Seconds”.The default value is 0 (zero). 0
This value, if present defines the connection type for the
client. “ACTIVE” means the Client should connect to the
Master, “RO” means the Client should Connected as
Read-Only, “RW”, which is the default means the Client
is connected in Read-Write mode and “STANDBY”
means the Client should connect to a Standby .
Note: specifying this value only at the COMServer
override level will ensure all connections on this
workstation are of the same type; that is, defining the
value “RO” will result in a read-only workstation, which
may be desirable in certain scenarios.
null or 0 to disable fault-tolerant options.
N/A
0
RW
1
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 49
Settings Edito
2.6.3 Alarm Printer Key
The Alarm Printer Task key has one value which MUST be set by the User for it to operate.
Value Name
Print Filter If set to 1 the Alarm Printer Client will ignore any settings
which have been made on its Filter Property page. The
Filter page will become disabled.
It will only print out alarms of signals which are
associated with the active printer defined in the Alarm
Printer Client. Signals can be associated with the active
printer by setting the 'printer' attribute of the signal to the
exact name of the active printer defined in the Alarm
Printer Client.
Value Data Default Data
0
2.6.4 Alarm Printer Server Key
The Alarm Printer Server has settings that are configured through its property pages. These settings
are stored on this key as values.
Value Name
Databases A space-separated string, which lists the data services
that the Alarm Printer Server will attempt to connect to
at startup.
ShowTrayIcon When set to 1, the Alarm Printer Server icon will be
displayed in the System Tray when it is running.
Double clicking on this icon in the System Tray will
open the Alarm Printer Server's User Interface. If set to
zero (0) the Alarm Server icon will no longer appear in
the System Tray when it is running.
Value Data Default Data
N/A
1
ShowWindow When set to 1, the Alarm Printer Server's User Interface
will be displayed on startup.
HideOnMinimize The Alarm Printer Server will be hidden when it is
minimized. A value of 1 mains the Alarm Client Server
will be hidden when minimized, zero (0) means The
Alarm Client Server will not be hidden when minimized.
Minimize When set to 1, the Alarm Printer Server's User Interface
will be displayed minimized on the Windows Start bar at
startup.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
0
0
0
Reference Guide
r
D5092
11-Dec-2007 - Page 50
Settings Edito
2.6.5 Bristol HDA Server Key
The Bristol Historical Data Access (HDA) Server has settings that are configured through its property
pages. These settings are stored on this key as values.
Value Name
AutoTerminate By default, the OPC and HDA Servers remain open
when a calling Client closes. This behaviour can be
changed by changing this value to 1.
Databases A space-separated string, which lists the data services
that the Bristol HDA Server will attempt to connect to
at startup.
ShowTrayIcon When set to 1, the Bristol HDA Server icon will be
displayed in the System Tray when it is running.
Double clicking on this icon in the System Tray will
open the Bristol HDA Server's User Interface. If set to
zero (0) the Alarm Server icon will no longer appear
in the System Tray when it is running.
ShowWindow When set to 1, the Bristol HDA Server's User Interface
will be displayed on startup.
HideOnMinimize The Bristol HDA Server will be hidden when it is
minimized. A value of 1 mains the Alarm Client
Server will be hidden when minimized, zero (0) means
The Alarm Client Server will not be hidden when
minimized.
Value Data Default
Data
0
N/A
1
0
0
Minimize When set to 1, the Bristol HDA Server's User Interface
will be displayed minimized on the Windows Start bar
at startup.
StaticsRefreshTime The time interval (in milliseconds) after which the HDA
statistics will be refreshed.
DisableBrowse Used to prevent the HDA Server building browse
information on startup. On stressed systems, this
reduces load time and resource usage.
The value is set to 1 to disable browsing.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
0
1000 (1
second)
0
Reference Guide
r
D5092
11-Dec-2007 - Page 51
Settings Edito
2.6.6 Bristol OPC Server Key
The Bristol OPC Server has settings that are configured through its property pages. These settings
are stored on this key as values.
Value Name
AutoTerminate By default, the OPC and OPC
Servers remain open when a
calling Client closes. This
behaviour can be changed by
changing this value to 1.
Databases A space-separated string, which
lists the data services that the
Bristol OPC Server will attempt to
connect to at startup.
ShowTrayIcon When set to 1, the Bristol OPC
Server icon will be displayed in the
System Tray when it is running.
Double clicking on this icon in the
System Tray will open the Bristol
OPC Server's User Interface. If set
to zero (0) the Alarm Server icon
will no longer appear in the System
Tray when it is running.
ShowWindow When set to 1, the Bristol OPC
Server's User Interface will be
displayed on startup.
Value Data Default
Data
0
N/A
1
0
HideOnMinimize The Bristol OPC Server will be
hidden when it is minimized. A
value of 1 mains the Alarm Client
Server will be hidden when
minimized, zero (0) means The
Alarm Client Server will not be
hidden when minimized.
Minimize When set to 1, the Bristol OPC
Server's User Interface will be
displayed minimized on the
Windows Start bar at startup.
SynchronousReadTimeout Indicates the timeout, in
milliseconds, after which
synchronous reads will be aborted
SynchronousWriteTimeout Indicates the timeout, in
milliseconds, after which
synchronous writes will be aborted
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
0
0
1000
1000
Reference Guide
r
y
D5092
11-Dec-2007 - Page 52
Settings Edito
BUILDINITIALBROWSEONREQUEST If this is set to a non-zero value,
then the first time that any OPC
Client requests browse information,
queries will be started, and an
initial browse hierarchy will be
created.
SHOWALTERNATIVETABLENAME If this is set to a non-zero value,
then tags describing an attribute of
a Network3000 signal table or view
will be displayed in the browse
hierarchy listed by device name
rather than by table name. Setting
this value will also cause the node
name to be stripped from the
beginning of the NW3000 signal
name, if the AbbreviateTagLabels
registry key is also set to a nonzero value.
DISABLEPROPERTIES If this is set to a non-zero value
then it will not be possible to invoke
the OPC Servers Properties dialog.
GETADDITIONALNW3000ATTRIBUTES If this is set to a non-zero value,
then any OPC Item defining a
Network 3000 Signal, (using the
Views and not the table), will have
it's OPC Quality influenced by the
value of the questionable attribute
of that signal. In addition any
NW3000 Analog Signal will have
its operator limits obtained, which
will also used to influence the OPC
Quality.
0
0
1 on
Workstation,
0 on Server
0
QuestionableToOPCQuality This value must be created and
defined by the user, since it cannot
be defined from the Bristol OPC
Server's property pages.
Enables signals from tables and
views other than
NW3000RealAnalog,
NW3000Digital or NW3000String
to have their questionable value
linked to the OPCQuality value.
If an object residing in a table or
view that has this functionality
enabled has a questionable
attribute value of non-zero , then
the OPC Quality will be marked as
OPC_QUALITY_UNCERTAIN for
an
OPC tags defined on that
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
N/A
Reference Guide
r
_
D5092
11-Dec-2007 - Page 53
Settings Edito
object.
If tables/views are defined within
the
'QuestionableToOPCQualityTables'
key value that DON'T contain an
attribute called questionable, then
all tags defined on those
tables/views will fail. This is
because the OPC Server, (not
being schema aware) will
automatically add the
'questionable' attribute to the object
query containing the OPC tags of
interest, causing that query to fail.
Objects within the
NW3000RealAnalog,
NW3000Digital or NW3000String
views should access this
functionality by using the
GetAdditionalNW3000Attributes
registry key value
ConvertTime Determines whether the OPC
Server converts all timestamps to
local time prior to sending them to
the OPC Client. True = 1. False =
0.
DeleteTagList Causes the OPC Server to delete
tags from the browse structures
when the OPC Client removes
those tags. True = 1. False = 0.
AbbreviateTagLabels If this is set to a non-zero value,
when displaying the constituent
parts of tags within the browse
hierarchy, at the primary key and
attribute levels, a shortened form of
those labels will be displayed.
TransactionLogLength Defines the size of the cyclic buffer
used to store an audit of
transaction attempts made by the
OPC Server.
TimeFormat If set to 0, then date and time data
will ALWAYS be returned to the
OPC Client as a string in the
format DD-MMM-YYYY
HH:MM:SS.mmm e.g.
29-JAN-2003 10:05:01.285
If set to 1, then the date and time
data is returned in VT
DATE form,
0
0
0
10
0
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 54
and the precise formatting, and
how that data is presented to the
user is the responsibility of the
OPC Client. For instance an OPC
Client may display such data in the
format DD/MM/YYYY HH:MM:SS
e.g.
29/01/2003 10:05:01
Other OPC Clients may provide a
different format, or allow the user a
range of formats in which to
present such data.
Settings Edito
2.6.7 BSI Commstats Import Key
The BSI Commstats Import component has settings that are configured through its property pages.
These settings are stored on this key as values.
Value Name
GlobalPollFrequency The polling period, in milliseconds after which the
BSI Commstats Import component will poll OpenBSI
for global communication statistics. Limits for the
Global Polling period are:Minimum value = 5 seconds
Maximum value = 86400 seconds
MonitorBackupLines When set to 1, monitoring of Backup lines is
enabled.
MonitorBSAPLines When set to 1, monitoring of BSAP lines is enabled. 1
MonitorEBSAPLines When set to 1, monitoring of EBSAP lines is
enabled.
MonitorIPLines When set to 1, monitoring of IP lines is enabled. 1
PollFrequency The polling period, in milliseconds after which the
BSI Commstats Import component will poll OpenBSI
for communication statistics relating specifically to
each of the configured lines. This value is set by
default to 10 seconds. Limits for the Line Stats
Polling period are:Minimum value = 5 seconds
Maximum value = 86400 seconds
Value Data Default
10000 (10
seconds)
0
0
10000 (10
seconds)
Data
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 55
Settings Edito
2.6.8 COMServer Key
The COMServer task key can be added by a user as a sub-key under the Tasks key.
There are no values associated with the COMServer key itself. It can be useful when a Connection
Overrides key is attached to it as a sub-key. In this scenario, the settings on the Connection Overrides
key will affect all Workstation HMI components.
In particular the FTConnectionType value on the Connection Overrides key can effectively create a
read-only Workstation.
2.6.9 Database Explorer Key
The Database Explorer key has three sub-keys - Settings, SYSTEM and Users. The most basic
Database Explorer settings are stored on this key as the following values.
Value
Name
Databases A space separated list of the
databases that the Database
Explorer will attempt to
connect to on startup.
Default
DBX Files
2.6.9.1 Settings Key
The Settings sub-key of the Database Explorer stores the following values.
The default .dbx file
directory. This is the
directory where the default
.dbx sample files are stored.
There is a DBX file for each
table of the database that
returns all objects and
attributes for that table.
When the user double clicks
on a table from the Database
Explorer Database or Tables
pane, these DBX files are
accessed and a query is
initiated automatically.
Value Data Default Data
None
XP - C:\Program
Files\Bristol\OpenEnterprise\Examples\DBX
Vista - <OEStore>\Examples\DBX
Value Name
Last User The name of the last logged in user of the Database
Explorer.
2.6.9.2 SYSTEM Key
The SYSTEM sub-key of the Database Explorer stores the following values.
Value Data Default Data
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
None
Reference Guide
r
D5092
11-Dec-2007 - Page 56
Settings Edito
Value Name
AttributeSearchValue Can be used to provide a default value for
the 'Search for Attribute' dialog during
runtime. The name of an attribute is typed
into the Data field of this value. When the
Database Explorer is next opened and the
user selects the 'Search for Attribute' menu
option, this attribute name will be already
written into the name field on the 'Search for
Attribute' dialog.
ContentBool Set by the 'Bool' check box on the Database
Explorer's Content Window. This value is set
to 1 to view boolean attributes. If set to zero
(0), boolean attributes will not be shown in
the Attributes pane of the Database
Explorer.
ContentFK Set by the 'Foreign Key' check box on the
Database Explorer's Content Window. This
value is set to 1 to view foreign key
attributes. If set to zero (0), foreign key
attributes will not be shown in the Attributes
pane of the Database Explorer.
Value Data Default Data
Null
1
1
ContentHidden Set by the 'Hidden' check box on the
Database Explorer's Content Window. This
value is set to 1 to view hidden attributes. If
set to zero (0), hidden attributes will not be
shown in the Attributes pane of the
Database Explorer.
ContentInteger Set by the 'Integer' check box on the
Database Explorer's Content Window. This
value is set to 1 to view integer attributes. If
set to zero (0), integer attributes will not be
shown in the Attributes pane of the
Database Explorer.
ContentNK Set by the 'Not Key' check box on the
Database Explorer's Content Window. This
value is set to 1 to view none key attributes.
If set to zero (0), none key attributes will not
be shown in the Attributes pane of the
Database Explorer.
ContentNotHidden Set by the 'Not Hidden' check box on the
Database Explorer's Content Window. This
value is set to 1 to view not hidden
attributes. If set to zero (0), not hidden
attributes will not be shown in the Attributes
0
1
1
1
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 57
Settings Edito
pane of the Database Explorer.
ContentNotNullable Set by the 'Not Nullable' check box on the
Database Explorer's Content Window. This
value is set to 1 to view not nullable
attributes. If set to zero (0), not nullable
attributes will not be shown in the Attributes
pane of the Database Explorer.
ContentNotPersistent Set by the 'Not Persistent' check box on the
Database Explorer's Content Window. This
value is set to 1 to view none persistent
attributes. If set to zero (0), none persistent
attributes will not be shown in the Attributes
pane of the Database Explorer.
ContentNullable Set by the 'Nullable' check box on the
Database Explorer's Content Window. This
value is set to 1 to view nullable attributes. If
set to zero (0), nullable attributes will not be
shown in the Attributes pane of the
Database Explorer.
ContentPersistent Set by the 'Persistent' check box on the
Database Explorer's Content Window. This
value is set to 1 to view persistent attributes.
If set to zero (0), persistent attributes will not
be shown in the Attributes pane of the
Database Explorer.
1
1
1
1
ContentPK Set by the 'Primary Key' check box on the
Database Explorer's Content Window. This
value is set to 1 to view primary key
attributes. If set to zero (0), primary key
attributes will not be shown in the Attributes
pane of the Database Explorer.
ContentReal Set by the 'Real' check box on the Database
Explorer's Content Window. This value is set
to 1 to view real attributes. If set to zero (0,
real attributes will not be shown in the
Attributes pane of the Database Explorer.
ContentString Set by the 'String' check box on the
Database Explorer's Content Window. This
value is set to 1 to view string attributes. If
set to zero (0), string attributes will not be
shown in the Attributes pane of the
Database Explorer.
ContentTime Set by the 'Time/Date' check box on the
Database Explorer's Content Window. This
value is set to 1 to view time/date attributes.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
1
1
1
1
Reference Guide
r
p
D5092
11-Dec-2007 - Page 58
If set to zero (0), time/date attributes will not
be shown in the Attributes pane of the
Database Explorer.
CurrentModeCOA ? ?
CurrentModeCOD ? ?
CurrentModeCOO ? ?
CurrentModeCOT ? ?
Settings Edito
LastViewerFolder The last folder used to store user configured
DBX files.
Left-Hand Pane Col 0 Positioning co-ordinates None
Main Window Positioning co-ordinates None
PKAttributeSearchValue Can be used to provide a default value for
the 'Search for Primary Key Attribute' dialog
during runtime. The name of an attribute is
typed into the Data field of this value. When
the Database Explorer is next opened and
the user selects the 'Search for Primary Key
Attribute' menu option, this attribute name
will be already written into the name field on
the 'Search for Primary Key Attribute' dialog.
Read Only ? ?
TableSearchValue Can be used to provide a default value for
the 'Search for Table' dialog during runtime.
The name of a table is typed into the Data
field of this value. When the Database
Explorer is next opened and the user
selects the 'Search for Table' menu option,
this table name will be already written into
the name field on the 'Search for Table'
dialog.
None
Null
Null
Upper-Right-Hand Pane
Row 0
2.6.9.3 Users Key
The Users sub-key of the Database Explorer stores the following values.
Value Name
<UserName> The value name is the name of each user who has logged
in and used the Database Ex
Positioning co-ordinates None
Value Data Default Data
lorer. The data field
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
The name =
the name of
Reference Guide
r
y
D5092
11-Dec-2007 - Page 59
contains the string 'Enabled' the users who
Settings Edito
have logged
on and used
the Database
Explorer. The
data =
'Enabled'.
2.6.10 Database Upgrade Key
Currently there are no values associated with the Database Upgrade key.
2.6.11 DBB Key
The BSI Commstats Import component has settings that are configured through its user interface.
These settings are stored on this key as values. Each value has a name and data component.
Value Name
IncludeSystemSignals A 1 here signifies that the DBB should include
nw3000 System Signals in the build as well.
CWAccolNames When set to any value other than 0 (zero),
ControlWave signal names will be converted to
ACCOL signal name format (i.e.
<BASE>.<EXTENSION>.<ATTRIBUTE>).
CWResolveMSDs When set to any value other than 0 (zero), the
DataBase Builder resolves the Control Wave device
signal addresses, also known as MSD (Master
Signal Directory) numbers.
HideINITDescriptors
SQLAppendAttributes This is a user addable value, which should contain a
When set to any value other than 0 (zero), the Force Init of Descriptors, Areas check box becomes
hidden the next time the NW3000 Database Builder
is opened.
comma separated list identifying the attributes which
have been added to the SignalExtension table. E.g,
if the SignalExtension table has two new attributes
added called 'NewAttribute1' and 'NewAttribute2',
then SqlAppendAttributes should contain the value
"NewAttribute1,NewAttribute2".
Value Data Default
Data
1
Null
Null
0
N/A
SQLAppendValues A user addable value, the data of which should
contain a comma separated list identifying the
default values which should be used by the
Database Builder to apply to each of the new
attributes listed in the SqlAppendAttributes value.
String and date/time attribute values should be
enclosed b
single quotes, numerical values should
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
N/A
Reference Guide
r
p
D5092
11-Dec-2007 - Page 60
have no quotes. E.g. If this value contained the
string "'new1',4.5", then for each signal added by the
Database Builder, two new attributes named
'NewAttribute1' and 'NewAttribute2' would be added
with the respective values of 'new1' and 4.5.
Settings Edito
2.6.12 Event Viewer Key
Currently there are no values associated with the Event Viewer key itself, although it has a sub-key
(Edit Permissions), which has associated values which affect functionality.
2.6.12.1 Edit Permissions Key
This key and its values are configured on installation. They define the fields into which a new value
may be entered by Users with different security profiles when inserting an Event into the Event
Viewer. The actual fields available for users with High, Low or Medium security credentials can be
changed directly using Windows Regedit.
Value
Name
High The Data for this value defines the EventHistory table
attributes that a user having the 'High' security token
for the Alarm View can change when inserting a
message into the Event Viewer.
The default values are
different depending on the
version of Windows on the
host machine.
XP default = C:\Program
Files\Common
Files\BristolBabcock\Help
Vista default = ?
2.6.15 Mail Server Key
The Mail Server key stores the following value.
Value Name
Database The database that the Mail Server should
connect to.
Value Data Default Data
2.6.16 Monitor Key
There are currently no setup values associated with the Monitor key.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
default = rtrdb1
Reference Guide
r
D5092
11-Dec-2007 - Page 62
2.6.17 Notes Client Server Key
The Notes Client Server key stores the following values.
Settings Edito
Value Name
Databases A space separated list of databases that the
Notes Client Server will attempt to connect to
when it is started. This enables the Notes
Client Server to be started and connected to
relevant databases before any Notes View
clients begin requesting alarm or event data.
BatchSize The maximum number of Notes transactions
that will be packaged by the Notes Server
into a single batch before being sent to the
Notes View client.
ShowWindow When set to 1, the Notes Client Server's
User Interface will be displayed on startup.
Minimize When set to 1, the Notes Client Server's
User Interface will be displayed minimized on
the Windows Start bar at startup.
HideOnMinimize Forces the Notes Client Server to be hidden
when it is minimized. A value of 1 mains the
Notes Client Server will be hidden when
minimized, zero (0) means The Notes Client
Server will not be hidden when minimized.
Value Data Default Data
User defined at
installation time.
100
0
0
0
ShowTrayIcon When set to 1, the Notes Client Server icon
will be displayed in the System Tray when it
is running. Double clicking on this icon in the
System Tray will open the Notes Server's
User Interface. If set to zero (0) the Notes
Server icon will no longer appear in the
System Tray when it is running.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
1
Reference Guide
r
D5092
11-Dec-2007 - Page 63
2.6.18 OEArchive File Manager Key
The OEArchiveFileManager key stores the following values.
Settings Edito
Value Name
Log File Type The Data of this value indicates the type of
Log File that is being kept. This value is
changed from the View>Options menu on
the Archive File Manager's user interface.
The options are:-
• No Log File = 0
• Single Log File = 1
• Log File Each Day = 2
Log File Days To
Keep
The Data indicates the number of days
that each new Log File should remain on
disc before the Archive File Manager
deletes it.
Value Data Default Data
1
None
2.6.19 OEBFill Key
The OEBFill key stores the following values. These values are set from the OEBFill configuration
interface, which is accessed as a DLL add-in from the OpenBSI Harvester component.
Value Name
Dataservice The data service that the OEBFill
component should connect to.
Value Data Default Data
Defined at
installation time.
DisableArchiveProcessing The Data indicates whether archive
processing is disabled. A value of
Zero (0) indicates that archive
processing is enabled, 1 indicates
that archive processing is disabled.
DisableAuditProcessing The Data indicates whether audit
processing is disabled. A value of
Zero (0) indicates that audit
processing is enabled, 1 indicates
that audit processing is disabled.
IgnoreNonImportedArchives For an archive to be successfully
imported, its configuration must first
be imported using the NW3000
Archive Configuration tool from the
Toolbox.
If Data for this value is 1, errors
encountered due to lack of archive
configuration information in the
database will be ignored. However
other errors, such as a lack of
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
0
0
0
Reference Guide
r
D5092
11-Dec-2007 - Page 64
Settings Edito
availability of the database will be
reported. Care should be taken
when using this option, since the
user will receive no notification that
the archive data has not been
imported, and the data will be lost. If
the Data has a value of zero (0), the
Converter will report an error when
any lack of archive configuration is
encountered, and will continue
trying to insert the values.
NumberInGroup The Data signifies the number of
values to be inserted by OEBFill into
the database in one transaction.
Possible Data values are:-
• -1 = Insert all column values
from a row of data in one
transaction
• 1 = Inserts one column value
from a row of data per
transaction. All columns from
each row will be inserted.
• A positive integer greater
than one and equal to or
less than the number of
columns in each row of data
= Insert the given number of
columns from each row of
data per transaction. All
columns from each row will
be inserted.
TransDelay The Data signifies the delay, in
milliseconds between each
transaction.
-1
0
2.6.20 OEExcel Plugin Key
The OEExcel Plugin key stores the following values.
Value Name
License
Package
The name of the License Package to which the
OEExcel Plugin belongs.
Value Data Default Data
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reporting
Reference Guide
r
D5092
11-Dec-2007 - Page 65
2.6.21 OEScheduler Key
The OEScheduler key stores the following values.
Settings Edito
Value Name
Log File Type The Data of this value indicates the type of
Log File that is being kept. This value is
changed from the View>Options menu on
the Scheduler's user interface. The options
are:-
• No Log File = 0
• Single Log File = 1
• Log File Each Day = 2
Log File Days To
Keep
The Data indicates the number of days
that each new Log File should remain on
disc before the Scheduler deletes it.
Value Data Default Data
2.6.22 OESecurity Manager Key
The OESecurity Manager key stores the following values.
Value Name
Admin Password The encrypted password of the main
administrator user.
Value Data Default Data
1
None
OED,v1.0,DE
Admin User The name of the main administrator user.
The default Admin User name is coded.
Database The security database to connect to. User configured at
OED01562
installation time.
2.6.23 OEServer Security Manager Key
The OEServer Security Manager key stores the following values.
Value Name
DATABASE The database name that clients
will connect to.
DisableOpenBSISecurityIntegration The Data for this value
determines whether OpenBSI
Security integration is enabled.
Value Data Default Data
rtrdb1
For
OpenEnterprise
installations,
this value will
be set to 1
(Disabled). For
ObjectServer
installations, it
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
p
D5092
11-Dec-2007 - Page 66
2.6.24 OEToolbox Key
The OEToolbox key stores the following values.
Settings Edito
will be set to
zero (0).
Value Name
DisableExportAll If the Data is set to a non-zero value
then the Export All functionality will
not be available.
On standalone OpenEnterprise
Workstations this setting will
automatically be set to 1 during
installation.
DisableModeMenu If the Data is set to a non-zero value
then the Mode menu functionality will
not be available and the user will be
unable to switch the Toolbox between
Tool and Table mode.
DisableSelectDatabase If the Data is set to a non-zero value
then the File>Select Database menu
item will not be available. The user
will be unable to change the database
that the Toolbox is connecting to.
DisableSaveDatabase If the Data is set to a non-zero value
then the File>Save Database menu
option will be disabled.
Value Data Default Data
1 for a Workstation
installation, 0 (zero)
for a Server or
Server/Workstation
installation.
1 for a Workstation
installation, 0 (zero)
for a Server or
Server/Workstation
installation.
1 for a Server or
Server Workstation
installation, 0 (zero)
for a Workstation
installation.
1 for a Workstation
installation, 0 (zero)
for a Server or
Server/Workstation
installation.
Editors The Data is a comma de-limited
string, listing the ProgramIDs of the
Editors that will appear in the
OEToolbox.
This value has been superceded by
the ProgamID value on the key for
each Toolbox Tool.
PostExport This Data of this value is the name of
a post-build file, (e.g. .cmd, .exe,
.bat), that will be triggered as part of
the ‘Export All’ operation. It is set
from the 'Export Configuration' dialog,
which is accessed from the
View>Export Config menu option of
the Toolbox.
Toolbox will
ass the dataservice of
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
The full commaseparated list of the
Program IDs of all
the Tools available
for the OEToolbox.
Reference Guide
r
gg
D5092
11-Dec-2007 - Page 67
Settings Edito
the OpenEnterprise Server upon
which the ‘Export All’ is being
performed, as parameters to the postbuild file. This will allow systems to
support multiple databases.
Whenever a user triggers an ‘Export
All’, Toolbox will first invoke the prebuild file, (e.g. pre_export.cmd). Once
this has completed, then the
applicable Configuration Tools will be
requested to perform their Exports,
and then finally the post-build file will
be invoked, (e.g. post_export.cmd).
Toolbox will inform the user of any
error that is returned by the pre and
post build files.
PostPassDS If the Data is set to 1, Toolbox will
pass the dataservice of the
OpenEnterprise Server upon which
the ‘Export All’ is being performed, as
parameters to the post-build file. This
allows systems to support multiple
databases
PostRunVisible If the Data is set to 1, this specifies
that the pre/post-export command file
will run in hidden mode and, as such,
no user interaction will be possible.
PostTimeout The Data contains the timeout value,
in seconds, for the Post-export
command file. If the value is set to
zero then the process will wait
indefinitely. If the value is not defined
in the registry , then a default value of
30 seconds will be used and stored.
PreExport This Data of this value is the name of
a pre-build file, (e.g. .cmd, .exe, .bat),
that will be triggered as part of the
‘Export All’ operation. It is set from
the 'Export Configuration' dialog,
which is accessed from the
View>Export Config menu option of
the Toolbox.
Toolbox will pass the dataservice of
the OpenEnterprise Server upon
which the ‘Export All’ is being
performed, as parameters to the postbuild file. This will allow systems to
support multiple databases.
Whenever a user tri
ers an ‘Export
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
g
D5092
11-Dec-2007 - Page 68
Settings Edito
All’, Toolbox will first invoke the prebuild file, (e.g. pre_export.cmd). Once
this has completed, then the
applicable Configuration Tools will be
requested to perform their Exports,
and then finally the post-build file will
be invoked, (e.g. post_export.cmd).
Toolbox will inform the user of any
error that is returned by the pre and
post build files.
PrePassDS If the Data is set to 1, Toolbox will
pass the dataservice of the
OpenEnterprise Server upon which
the ‘Export All’ is being performed, as
parameters to the pre-build file. This
allows systems to support multiple
databases
PreRunVisible If the Data is set to 1, this specifies
that the pre/post-export command file
will run in hidden mode and, as such,
no user interaction will be possible.
PreTimeout The Data contains the timeout value,
in seconds, for the Post-export
command file. If the value is set to
zero then the process will wait
indefinitely. If the value is not defined
in the registry , then a default value of
30 seconds will be used and stored.
SQLHistoricalFolder The default historical folder.
The OEToolbox Databases key stores the following values.
Value Name
CurrentDatabase The name of the current default database
that the Toolbox is connecting to when it is
opened.
Database0 A second database that has been
confi
ured for the Toolbox to connect to.
Value Data Default Data
rtrdb1
None.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 69
This and extra databases can be
configured and selected using the
File>Select Database option when it is
enabled. Extra databases will be stored in
new keys called Database<N>, where <N>
is an appended serial number.
2.6.24.2 Editors Key
This is a parent key for all of the individual Editor keys, and has no values of its own.
Warning: All Editor Keys are set at installation time. They should only be modified from the Tool's
own interface. ProgramID and Program values should not be changed by the user.
2.6.24.3 Alarm Conditions Key
The Alarm Conditions key stores the following values.
Settings Edito
Value
Name
Configs Description in progress BristolBabcock.OEProductAlarmConditions
ProgramID The Program ID of the Alarm
Condition Editor.
Editors can be excluded
from the OEToolbox by
placing their ProgramID
string in the Exclude list for a
User or User Group in the
Security Configuration Tool.
2.6.24.4 Alarm Priorities Key
The Alarm Priorities key stores the following values.
Value
Name
ProgramID The Program ID of the Alarm
Priorities Editor.
Editors can be excluded from
the OEToolbox by placing their
ProgramID string in the
Exclude list for a User or User
Group in the Security
Configuration Tool.
Value Data Default Data
BristolBabcock.OEConfigAlarmConditions
Value Data Default Data
BristolBabcock.OEConfigAlarmPriorities
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
y
D5092
11-Dec-2007 - Page 70
2.6.24.5 Archive File Access Key
The Archive File Access key stores the following values for the Archive File Configuration Tool.
Settings Edito
Value
Name
ProgramID The Program ID of the Archive
File Configuration Tool.
Configuration tools can be
excluded from the OEToolbox
by placing their ProgramID
string in the Exclude list for a
User or User Group in the
Security Configuration Tool.
2.6.24.6 Calculations Key
The Calculations key stores the following values.
Value
Name
ProgramID The Program ID of the
Calculations Tool.
Configuration tools can be
excluded from the OEToolbox
by placing their ProgramID
string in the Exclude list for a
User or User Group in the
Security Configuration Tool.
Value Data Default Data
Value Data Default Data
BristolBabcock.OEConfigAlarmPriorities
BristolBabcock.OEConfigAlarmPriorities
Export This value represents the order
in which the Toolbox should
export the Calculation
configuration from the current
database when the 'Export All'
option is chosen from the
Toolbox File menu. If the key is
not present, or has a null value,
then the Tool is not part of the
Export All operation of the
Toolbox.
This number can be changed
by selecting the OEToolbox
View>Export Config... menu.
Should this key be edited by
any other means, e.g. by the
registry editor, then the number
ma
not be assumed to be
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
1
Reference Guide
r
D5092
11-Dec-2007 - Page 71
unique. In the event that one
number exists for multiple
editors, then the ordering will
be made on the order in which
the tools are read from the
registry.
2.6.24.7 Config Generic Table Key
The Config Generic Table key stores the following values.
Settings Edito
Value
Name
ProgramID The Program ID of the
OEToolbox when in Table mode.
This mode can be excluded from
the OEToolbox by placing its
ProgramID string in the Exclude
list for a User or User Group in
the Security Configuration Tool.
The option to enable the
OEToolbox for Table mode can
be disabled by setting the
OEToolbox DisableModeMenu
option to 1.
2.6.24.8 Diaries Key
The Diaries key stores the following values.
Value Name
Value Data Default Data
Value Data Default Data
BristolBabcock.OEConfigGenericTable
ProgramID The Program ID of the Diaries Tool.
Configuration tools can be excluded
from the OEToolbox by placing their
ProgramID string in the Exclude list for
a User or User Group in the Security
Configuration Tool.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
BristolBabcock.OEDiaryConfig
Reference Guide
r
ging
D5092
11-Dec-2007 - Page 72
2.6.24.9 Historical Config Key
The Historical Config Key stores the following values.
Settings Edito
Value Name
ProgramID The Program ID of the Historical
Configuration Tool.
Configuration tools can be excluded
from the OEToolbox by placing their
ProgramID string in the Exclude list for
a User or User Group in the Security
Configuration Tool.
Export The data for this value represents the
order in which the Toolbox should
export the Historical configuration from
the current database when the 'Export
All' option is chosen from the Toolbox
File menu. If the key is not present, or
has a null value, then the Tool is not
part of the Export All operation of the
Toolbox.
This number can be changed by
selecting the OEToolbox View>Export
Config... menu.
Should this key be edited by any other
means, e.g. by the registry editor, then
the number may not be assumed to be
unique. In the event that one number
exists for multiple editors, then the
ordering will be made on the order in
which the tools are read from the
registry.
The NW3000 Advanced Key strores the following values.
Value Name
ProgramID The Program ID of the NW3000
Advanced Config Tool.
Configuration tools can be excluded
from the OEToolbox by placing their
ProgramID string in the Exclude list
for a User or User Group in the
Security Configuration Tool.
IconVisible The data determines whether the
Icon for the NW3000 Advanced
Configuration Tool will be displayed
in the Toolbox. 1 = Icon visible, 0 =
Icon not directly visible.
B
default, it is only available from
Value Data Default Data
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
BristolBabcock.OEConfigNW3000
0
Reference Guide
r
q
D5092
11-Dec-2007 - Page 74
the [Advanced] button of the
NW3000 Setup tool.
2.6.24.13 NW3000 Archives Key
The NW3000 Archives Key stores the following values.
Settings Edito
Value Name
Program The full path and filename
of the NW3000 Archives
Tool. Used by Toolbox
when launching the
application. It is set by the
installation routine.
COMMANDLINE The data for this value
defines the parameters that
will be used when the tool is
started by the Toolbox. It is
set by the installation
routine.
MULTIPLE The data for this value is an
integer which specifies
whether the Tool can have
multiple instances. A nonzero value means multiple
instances are allowed.
Export The data for this value
represents the order in
which the Toolbox should
export the NW3000
Archives configuration from
the current database when
the 'Export All' option is
chosen from the Toolbox
File menu. If the key is not
present, or has a null value,
then the Tool is not part of
the Export All operation of
the Toolbox.
This number can be
changed by selecting the
OEToolbox View>Export
Config... menu.
Should this key be edited by
any other means, e.g. by
the registry editor, then the
number may not be
assumed to be uni
the event that one number
exists for multiple editors,
then the ordering will be
made on the order in which
the tools are read from the
registry.
2.6.24.14 NW3000 Config Key
The NW3000 Config Key stores the following values.
Settings Edito
Value Name
ProgramID The Program ID of the NW3000
Setup Tool.
Configuration tools can be excluded
from the OEToolbox by placing their
ProgramID string in the Exclude list
for a User or User Group in the
Security Configuration Tool.
2.6.24.15 NW3000 Signal Builder Key
The NW3000SignalBuilder Key stores the following values.
Unlock Tool.
Configuration tools can be
excluded from the OEToolbox by
placing their ProgramID string in
the Exclude list for a User or
User Group in the Security
Configuration Tool.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
BristolBabcock.OEConfigObjectUnlock
Reference Guide
r
D5092
11-Dec-2007 - Page 77
2.6.24.18 OPC Client RDI Key
The OPC Client RDI Key stores the following values.
Settings Edito
Value
Name
ProgramID The Program ID of the OPC Client
Config Tool.
Configuration tools can be excluded
from the OEToolbox by placing their
ProgramID string in the Exclude list
for a User or User Group in the
Security Configuration Tool.
Export This value represents the order in
which the Toolbox should export
the OPC Client configuration from
the current database when the
'Export All' option is chosen from
the Toolbox File menu. If the key is
not present, or has a null value,
then the Tool is not part of the
Export All operation of the Toolbox.
This number can be changed by
selecting the OEToolbox
View>Export Config... menu.
Should this key be edited by any
other means, e.g. by the registry
editor, then the number may not be
assumed to be unique. In the event
that one number exists for multiple
editors, then the ordering will be
made on the order in which the
tools are read from the registry.
Value Data Default Data
BristolBabcock.OEOPCClientConfig
3
2.6.24.19 Patterns Key
The Patterns Key stores the following values.
Value Name
ProgramID The Program ID of the Patterns Tool.
Configuration tools can be excluded
from the OEToolbox by placing their
ProgramID string in the Exclude list for
a User or User Group in the Security
Configuration Tool.
2.6.24.20 Reporting Key
The Reporting Key stores the following values.
Value Data Default Data
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
BristolBabcock.PatternConfig
Reference Guide
r
g
D5092
11-Dec-2007 - Page 78
Settings Edito
Value Name
Program The full path and
filename of the Report
Configuration Tool. Used
by Toolbox when
launching the
application. It is set by
the installation routine.
COMMANDLINE The data for this value
defines the parameters
that will be used when
the tool is started by the
Toolbox. It is set by the
installation routine.
MULTIPLE The data for this value is
an integer which
specifies whether the
Tool can have multiple
instances. A non-zero
value means multiple
instances are allowed.
Value Data Default Data
C:\
Program Files\
Bristol\
OpenEnterprise\
bin\
ReportConfigurationTool.exe
-s%Database% -u%User% p%Password%
0
Export The data for this value
represents the order in
which the Toolbox
should export the
NW3000 Archives
configuration from the
current database when
the 'Export All' option is
chosen from the Toolbox
File menu. If the key is
not present, or has a null
value, then the Tool is
not part of the Export All
operation of the Toolbox.
This number can be
changed by selecting the
OEToolbox View>Export
Config... menu.
Should this key be edited
by any other means, e.g.
by the registry editor,
then the number may not
be assumed to be
unique. In the event that
one number exists for
multiple editors, then the
orderin
will be made on
5
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 79
Settings Edito
the order in which the
tools are read from the
registry.
Show Welcome
Page
2.6.24.21 Security Configuration Key
The Security Configuration Key stores the following values.
Value
Name
ProgramID The Program ID of the Security
Configuration Tool.
Configuration tools can be
excluded from the OEToolbox
by placing their ProgramID
string in the Exclude list for a
User or User Group in the
Security Configuration Tool.
The data, if none zero
specifies that the
Welcome page should
be shown when the
Report Configuration
Tool starts up. If set to
zero (0), the Welcome
page will not be shown.
Value Data Default Data
1
BristolBabcock.OEConfigAlarmPriorities
Export This value represents the order
in which the Toolbox should
export the Security
configuration from the current
database when the 'Export All'
option is chosen from the
Toolbox File menu. If the key is
not present, or has a null value,
then the Tool is not part of the
Export All operation of the
Toolbox.
This number can be changed
by selecting the OEToolbox
View>Export Config... menu.
Should this key be edited by
any other means, e.g. by the
registry editor, then the number
must be unique. In the event
that one number exists for
multiple editors, then the
ordering will be made on the
order in which the tools are
read from the registry.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
4
Reference Guide
r
D5092
11-Dec-2007 - Page 80
2.6.24.22 Security Group Privileges Key
The Security Group Privileges Key stores the following values.
Settings Edito
Value Name
PROGRAM The full path and
COMMANDLINE The data for this
MULTIPLE The data for this
Value Data Default Data
filename of the
NW3000 Signal
Builder Tool
value defines the
parameters that
will be used when
the tool is started.
It is set by the
installation routine.
value is an integer
which specifies
whether the Tool
can have multiple
instances. A nonzero value means
multiple instances
are allowed.
The Suppression Group Key stores the following values.
Value
Name
ProgramID The Program ID of the
Suppression Groups Tool.
Configuration tools can be
excluded from the OEToolbox
by placing their ProgramID
string in the Exclude list for a
User or User Group in the
Security Configuration Tool.
2.6.24.24 OEHistorical Config Key
The OEHistorical Config Key contains no values.
Value Data Default Data
BristolBabcock.ConfigSuppressionGroups
2.6.25 Paging Config Key
The Paging Config Key stores the following values.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
ging
D5092
11-Dec-2007 - Page 81
Settings Edito
Value Name
DefaultDatabase The data specifies the database that the
Paging Config Tool should connect to at
startup.
Value Data Default Data
2.6.26 Paging Server Key
The Paging Server Key stores the following values.
Value Name
DataService The data
License Package The data
Value Data Default Data
Set at installation time.
specifies the
data service
from which the
Paging Server
obtains the
Paging setup.
Paging Server
contains the
name of the
license
package
Set at installation time.
DailyLogFile Data specifies
whether a new
log file will be
created for
each day. Set
to 1 to force a
new file to be
generated for
the log each
day.
DebugLogActive Activate (1) or
deactivate (0)
the debug log.
DebugLogDays Number of
days to keep
the debug log.
DisplayLogEnabled Setting the
Data to 0 will
prevent
messages
appearing in
the Pa
0
0
0
1
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 82
Settings Edito
Server
application,
though
messages
may still
appear in the
log
DisplayLogMaxEntries Maximum
number of
lines to show
within the
Paging
Server.
IgnoreStartupAlarms Setting the
Data to 1
causes the
Messaging
Server to not
scan the
Alarm
Summary
table when it
is launched.
This value is
set from the
Overview tab
of the
Messaging
Server.
IncorrectAckJournal Whether the
application will
send an email to a
recipient if
they
incorrectly
ACK an alarm.
0 will be
FALSE any
other value
will be TRUE.
0
0
LineAddressExclusion Semi-colon
delimited list
of lines
(modems) not
to use with the
paging
system.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
None
Reference Guide
r
D5092
11-Dec-2007 - Page 83
Settings Edito
LogFileName Name of the
standard log
file used to
store
messages.
LogFileEnabled Activate (1) or
deactivate (0)
the standard
log file.
ModemDelayBetweenCalls Specifies the
number of
seconds a
modem queue
should wait
after finishing
its call and
before
commencing
the next call.
Optimistic Whether the
application will
be run in
Optimistic
mode. 0 will
be FALSE any
other value
will be TRUE.
XP default: C:\Settings and
Documents\<Username>\<Users>
Documents\Bristol\OpenEnterprise\Output Files
Vista default:
<UserDocuments>\Bristol\OpenEnterprise\Output
Files\
1
None
0
POP3CheckInterval The numbers
of seconds in
between each
check of the
POP3 Inbox
on the POP3
Server.
POP3HostName The Network
Name or IP
address of the
SMTP Server.
POP3HostPort The Port
Number of the
SMTP Server.
POP3Password The Password
to connect to
a POP3
Server with.
15
None
110
None
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 84
Settings Edito
POP3ToAddress The E-mail
address that
will appear in
the ‘From’
field of Alarm
E-mails.
POP3ToName The readable
name that
Alarm E-mails
will be from
POP3Username The
Username for
logging onto
the POP3
Server.
SMTPAuthType Choice of four
Auth types:CRAM, MD5,
AUTH LOGIN
or PLAIN
LOGIN
SMTPFromAddress Email address
that will
represent the
Paging
Server.
None
None
None
None
None
SMTPFromName Readable
name such as
'Project
Paging
Server’
SMTPHostName IP address of
name of the
server that is
running the
SMTP server.
SMTPHostPort Port on which
the SMTP
server is
running.
SMTPPassword Password for
authentication.
SMTPUsername Username for
authentication.
None
None
25
None
None
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
g
D5092
11-Dec-2007 - Page 85
Settings Edito
Wildcard String that will
be interpreted
in Pattern
matching as a
wildcard.
None
2.6.27 RDI3000 Key
The RDI3000 Key stores the following values.
Value Name
EnableBSAUTO Set to 1 to use BSAUTO to start
OpenBSI. Used in conjunction
with BSAUTOFormatString.
When set to 0, the BSIStartSys
API call will be used to start
OpenBSI.
BSAUTOFormatString The format string used as the
BSAUTO command line.
Value Data Default Data
0
"BSAUTO -std
SYSTEM SYSTEM
%s" - without the
quotes.
Where %s represents
the NDF filename
specified within the
nw3000driver.
obsistartndf attribute.
CommStatus The pseudo signal name used
by OpenBSI to identify an
OpenBSI generated
communication status alarm.
CommStatusOnline The ON text associated with an
OpenBSI communication status
alarm.
CommStatusOffline The ON text associated with an
OpenBSI communication status
alarm.
DriverSwitchRtu The pseudo signal name used
to identify an OpenBSI local
alarm that signifies an RTU is
being switched line. Usually
used when backup lines are
being used.
DriverDialStat The pseudo signal name used
to identify an OpenBSI local
alarm that si
nifies an RTU is
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
"COMM.STATUS" without the quotes.
"ONLINE" - without
the quotes.
"OFFLINE" - without
the quotes.
“DriverSwitchRtu” without the quotes.
“DriverDialStat” without the quotes.
Reference Guide
r
D5092
11-Dec-2007 - Page 86
Settings Edito
being dialled.
CollectArchives The signal name of a remote
alarm report that indicates
Archives require collecting by
OpenBSI Harvester.
The receipt of this remote alarm
report will result in rdi3000
requesting an Archive collection
from Harvester.
This functionality is only enabled
when bit x of
nw3000driver.options is set.
EnableCollectAnaAlmStates Enable or disable the collection
of analog alarm states through
template data collection. When
set to 1, the appropriate
columns in the
nw3000realanalog table are
locked for update by the rdi.
When set to 0, the columns are
not locked.
OnDemandFile The name of the application to
execute in order to update a
database using DSN. This is
used to update the Harvester
database to perform an on
demand collection for an RTU.
"system.CollectArch" without the quotes.
0 (disabled).
No default value. If
required then the
“UpdateDSN.exe”
executable can be
used.
OnDemandFormatString The SQL string used to request
an on demand collection within
the Harvester database.
OnDemandFolder The working directory to run the
application named by the
OnDemandFile registry value.
OnDemandDSN The ODBC DSN name for the
Harvester database. This is
used as the –d switch for
UpdateDSN.exe.
OnDemandVerbose When set to 1, the UpdateDSN
application will log messages to
UpdateDSN.txt. This is used to
set the –v switch for
UpdateDSN.exe.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
“UPDATE fields SET
ondemand = true
WHERE node = '%s'”.
Where %s is
substituted for the
RTU name.
See 'OnDemandFile'
None
0 (disabled)
Reference Guide
r
D5092
11-Dec-2007 - Page 87
Settings Edito
ThrottlingScheme Used to set the BSAP request
message throttling scheme to
use.
When set to 0, a BSAP request
message is sent to OpenBSI if
the rdi has not consumed more
than half its available wait
packets. This scheme potentially
uses the highest amount of
OpenBSI resources.
When set to 1, the maximum
number of outstanding requests
for a device is strictly adhered
to. This value is set by the
nw3000driver.reqPerDevice and
has a default value of 5 i.e. only
5 outstanding requests can be
queued at OpenBSI at any one
time – all other pending
requests for the device are
queued within the rdi. Note that
this limit does not apply to write
messages which are always
sent if OpenBSI resources
allow.
0 (disabled)
DeviceStatusOnline When set to 1, the status
attribute within the
nw3000device table will reflect
the communications state of the
RTU. The status attribute will
have a value of 0 when the
device is healthy and 1 when
the rdi cannot communicate with
the device.
When set to 0, the status
attribute will not be updated with
the communications status and
will typically always have a
value of 0.
The online attribute in the
nw3000device table will always
be updated regardless of the
DeviceStatusOnline registry
value.
EnableQuietAlarms When set to 1, the rdi will
attempt to update the following
signal attributes in order to
reflect the current alarm state of
the signal:
inAlarm, acknowledged, cleared,
alarmPriority and alarmType.
None
0 (disabled)
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 88
Settings Edito
This relies upon templates
having been built that collect the
additional alarm states for
remote signals.
This functionality is typically
used when the OpenEnterprise
Server cannot receive remote
alarm reports.
SuppressOpenBSIStatsReset When set to 1, a statistics reset
will only reset local rdi statistics
and not reset OpenBSI
statistics.
When set to 0, OpenBSI
statistics are also reset.
DisableTimestampAdjustment Set to 1 to disable remote alarm
timestamp localtime to UTC
adjustment.
By default, remote alarm
timestamps are in localtime and
database timestamps are UTC.
DSTQDelta The number of seconds
following a System DST change
where a remote alarm
timestamp will be marked as
questionable (when converted
from localtime to UTC).
EnablePWRUPTpls When set to 1, the receipt of a
remote alarm report for the
#PWRUP signal will cause a
template collection to
commence.
0
0
0
None
EnablePWRUPRbe When set to 1, the receipt of a
remote alarm report for the
#PWRUP signal will cause a
RBE collection of initial values to
commence.
TplExclusion When a non-periodic template
collection request occurs, if the
next scheduled collection will
occur within TplExclusion
seconds, the manual request
will be ignored.
EnableSanityAlarmThrottle When set to 1, the OpenBSI
BSIAlmThrottle API call will be
called once every sanity period.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
None
30
0
Reference Guide
r
D5092
11-Dec-2007 - Page 89
Settings Edito
PendingRequestTimeout Specifies a number of seconds
for which any OpenBSI pending
requests are removed if they
have been pending for longer
than the specified time. When
used, the value must be set
greater than the request timeout
value used by OpenBSI.
WaitPacketTimeoutMultiplier The RDI3000 periodically
checks its internal wait packet
queue, looking for RTU requests
for which no response has been
received. If any such requests
are found, they are timed-out
with a completion status of -
1003. The functionality is
enabled by default and the
internal wait packet timeout will
be approximately 3 times the
default RTU message timeout
defined within OpenBSI.
Set to 0 (zero) to disable internal
wait packet timeout checking. A
value greater than zero results
in a wait packet timeout of
(WaitPacketTimeoutMultiplier *
default RTU message timeout)
seconds.
0
3
2.6.28 Report Scheduler Key
The Report Scheduler Key stores the following values.
Value Name
License Package The License Package name. Reporting
Value Data Default Data
2.6.29 Session Manager Key
The Session Manager Key stores the following values.
Value Name
License Package The License Package name. OpenEnterprise
EnableTimestamps Determines whether timestamps
appear in the Session Manager's
events window.
1 = Timestamps enabled, 0 =
Timestamps disabled.
Value Data Default Data
0
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 90
Settings Edito
ArbitratorHeartbeat Determines whether the Session
Manager sends a heartbeat to the
arbitrator.
DisableStopOEWarning Disables the warning message when
the Stop menu option is used on a
redundant system.
Password Sets a password for the dialog that
appears when the Stop option is
selected from the Session menu whilst
a redundant session is running.
0 (for standalone), 1
(for redundant)
Must be set to 1 by
user to disable the
warning.
N/A
2.6.30 Settings Key
The Settings Key stores the following values. They relate to the restore points functionality of the
Settings Editor.
Value Name
LogFileMaxSize The maximum size that the single
Settings Editor Log file should get to
before it begins deleting 10% of the
oldest entries to make way for the
latest entries.
Value Data Default Data
10000 bytes (10K)
LogFileRetentionDays The number of days to keep each
days Log file before deletion. This
option is only available when the
option to create a new Log file each
day is selected.
LoggingMode Toggles Logging mode between Daily
and Single Log file. 1 = Daily mode.
RestorePointIntervalDays Defines an automatic restore point
interval in days.
RetentionDays The number of days to keep each
restore point before deletion.
90
0 (single)
1 (day)
28 (days)
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 91
2.6.30.1 Restore Points Key
This key is the parent key for each restore point that is created. It has no values associated with it
directly.
Each restore point that is created has its own key. The name is a unique number, and is created by
the Settings Editor. These are the values associated with individual restore point keys.
Settings Edito
Value
Name
Description A description of the restore point. "Automatically
Keep Determines whether to keep the restore point permanently.
1 = keep, 0 = do not keep.
Name The name of the restore point file. Format =
RestorePoint<Year><Month><Day>_<HH><MM><SS>.tmp.
Value Data Default Data
created" if
automatically
created.
Otherwise
user provides
the
description.
0
N/A
2.6.31 Settings Editor Key
The Settings Editor Key stores the following values.
Value Name
Value Data Default Data
DoNotShowWarning Determines whether the Settings Editor
shows the warning dialog on startup.
SearchText The text that was last used to search the
Log File Viewer within the Settings
Editor.
Selection The last key that was selected before the
Settings Editor was closed previously.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
1
None
None
Reference Guide
r
D5092
11-Dec-2007 - Page 92
2.6.32 TimeServer Key
The TimeServer Key stores the following values.
Settings Edito
Value Name
Database The database that the TimeServer
connects to.
Time Zone The time zone set for the OpenEnterprise
project.
UseServerSecurity
Value Data Default Data
rtrdb1
GMT
2.6.33 TPB Key
The TPB Key stores the following values. They affect the Poll List Builder component.
Value Name
EnableCollectAlmPriorities The Poll List Builder can be
configured to collect signal alarm
priority data from Bristol RTUs by
setting this value to 1. This is turned
on by checking the appropriate boxes
on the Poll List Builder's interface.
Note:
It is not recommended that remote
alarm collection is mixed with alarm
data template collection on the same
OpenEnterprise Server. Alarm data
collection by template is intended for
use with OpenEnterprise Servers that
cannot receive remote alarm reports.
Value Data Default Data
0
EnableCollectAlmStates The Poll List Builder can be
configured to collect signal alarm
state data from Bristol RTUs by
setting this value to 1. This is turned
on by checking the appropriate boxes
on the Poll List Builder's interface.
Note:
It is not recommended that remote
alarm collection is mixed with alarm
data template collection on the same
OpenEnterprise Server. Alarm data
collection by template is intended for
use with OpenEnterprise Servers that
cannot receive remote alarm reports.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
0
Reference Guide
r
D5092
11-Dec-2007 - Page 93
Settings Edito
2.6.34 Window Manager Key
The Window Manager Key is the parent key for the Child Applications Key and the Commands Key. It
stores the following values, which apply to the OEDesktop component.
Value Name
MultiDesktopEnable Set the value to 1 to enable multiple
configurations and instances of
OEDesktop to be run on the same
Workstation.
Message Delay Set this and the Retry Reply value to
Zero in order to prevent the two OLE
dialogs (Server Busy and Server Not
Responding) from being displayed.
Retry Reply Set this and the Message Delay
value to Zero in order to prevent the
two OLE dialogs (Server Busy and
Server Not Responding) from being
displayed.
Toggle MaxSize MDI Default data value = "Toggle
MaxSize MDI". If this value is present
the OEDesktop toolbar will display an
extra couple of buttons. One button
toggles the selected child window
to/from maximum size (filling the
whole OE Desktop window area
available and hiding the child window
title bar). The other restores the OE
Desktop to maximum size if it is not
currently at maximum screen size.
This is an optional value.
Value Data Default Data
0
1
1
N/A
SuppressFileTokenMessage
2.6.34.1 Child Applications Key
The Child Applications Key has no associated values of its own.
NOTE:
The values on these keys are created and maintained by the OpenEnterprise application. They are
not to be changed manually. To do so could cause the OpenEnterprise HMI to fail. They are listed
here purely for information.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
p
D5092
11-Dec-2007 - Page 94
2.6.34.1.1 Alarm Banner Control Key
The Alarm Banner Control Key stores the following values.
Settings Edito
Value
Name
Description A brief description of the
component.
Document
String
ProgID The Program ID of the
2.6.34.1.2 Alarm Client Control Key
The Alarm Client Control Key stores the following values.
Value
Name
Description A brief description of the
A string expression that defines
the extension and description
used by files created from the
component.
component.
component.
Value Data Default Data
OE Alarm Banner
OE Alarm Banner Displays
(*.abd)|*.abd||
BristolBabcock.OEAlarmBannerCtrl.1
Value Data Default Data
OE Alarm View
Document
String
ProgID The Program ID of the component. BristolBabcock.AlarmClientControl.1
Default
Directory
2.6.34.1.3 Alarm Printer Control Key
The Alarm Printer Control Key stores the following values.
Value
Name
Description A brief
Document
String
A string expression that defines the
extension and description used by
files created from the component.
The default directory where files of
this type are stored.
Value Data Default Data
OE Alarm Printer View
description
of the
component.
A string
ex
ression
OE Alarm Printer Views (*.apc)|*.apc||
OE Alarm View Displays (*.ac)|*.ac||
<OEStore>\AlarmClient
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
p
D5092
11-Dec-2007 - Page 95
that defines
the
extension
and
description
used by
files
created
from the
component.
Settings Edito
ProgID The
Program ID
of the
component.
2.6.34.1.4 Notes Control Key
The Notes Control Key stores the following values.
Value
Name
Description A brief description of the
component.
Document
String
ProgID The Program ID of the component. BristolBabcock.OENotesClientCtrl.1
2.6.34.1.5 Report Selector Control Key
The Report Selector Control Key stores the following values.
A string expression that defines the
extension and description used by
files created from the component.
OEALARMPRINTERCLIENT.OEAlarmPrinterClientCtrl.1
Value Data Default Data
OE Alarm Notes View
OE Notes (*.ncd)|*.ncd||
Value Name
AssemblyLocation The location of the
AssemblyName The name of the
Bitmap The name of the
Value Data Default Data
assembly containing
the required control. If
empty the location is
assumed to be the
installation 'bin'
directory.
assembly containing
the required control.
bitma
, within the
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
<Install>\bin
ReportSelectorThickClient.dll
ReportSelector.bmp
Reference Guide
r
D5092
11-Dec-2007 - Page 96
Settings Edito
assembly, used to
represent the control
type.
Default Directory The default directory
for saving
configuration files.
Default File The name of the
default file to open,
this file will be opened
when a new control is
created.
Description A brief description of
the component.
Document String The filter string used
in the open and save
dialogs
Icon The name of the icon,
within the assembly,
used to represent the
control type.
ProgID The Program ID of the
component.
TypeName The type name of the
control within the
assembly
<OEStore>\Reports
<OEStore>\Reports\rtrdb1.rpv
OE Report Selector
OE Report Selector Files (*.rpv)|*.rpv||
ReportSelector.ico
BristolBabcock.OENotesClientCtrl.1
ReportSelectorCtl
2.6.34.1.6 Signal View Control Key
The Signal View Control Key stores the following values.
Value
Name
Description A brief description of the
component.
Document
String
ProgID The Program ID of the
A string expression that defines
the extension and description
used by files created from the
component.
component.
Value Data Default Data
OE Signal View
OE Signal View Files(*.sgv)|*.sgv||
OESIGNALVIEW.OESignalViewCtrl.1
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 97
2.6.34.1.7 SQL Viewer Control Key
The SQL View Control Key stores the following values.
Settings Edito
Value
Name
Default
Directory
Description A brief description of the
Document
String
ProgID The Program ID of the
2.6.34.1.8 Trend Client Control Key
The Trend Client Control Key stores the following values.
Value
Name
The default directory for files
saved from this component.
component.
A string expression that defines
the extension and description
used by files created from the
component.
component.
Value Data Default Data
<OEStore>\SQLView
OE SQL View
OE Query Definition Views (*.dbx)|*.dbx||
OESQLVIEWER.OESQLViewerCtrl.1
Value Data Default Data
Default
Directory
DefaultFile The default filename to use for this
Description A brief description of the
Document
String
ProgID The Program ID of the component. BristolBabcock.OETrendClientCtrl.1
2.6.34.1.9 Web Client Control Key
The Web Client Control Key stores the following values.
Value
Name
Default
Directory
The default directory for files saved
from this component.
component.
component.
A string expression that defines the
extension and description used by
files created from the component.
Value Data Default Data
The default directory for files
saved from this component.
<OEStore>\Trends
<OEStore>\Trends\<filename>.tvd
OE Trend View
OE Trend Views (*.tvd)|*.tvd||
<OEStore>\SQLView
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 98
Settings Edito
Description A brief description of the
component.
Document
String
ProgID The Program ID of the
2.6.34.2 Commands Key
The Commands Key stores the following value.
Value Name
DllList A list of action dlls.
2.6.34.2.1 OECmdDBUpdate Key
The OECmdDBUpdate Key stores the following values.
Value Name
A string expression that defines
the extension and description
used by files created from the
component.
component.
Value Data Default Data
Value Data Default Data
OE SQL View
OE Query Definition Views (*.dbx)|*.dbx||
OESQLVIEWER.OESQLViewerCtrl.1
ProgID The Program ID of the component. OECmdDbUpdate.OEActionDLL.1
Target
ProgID List
2.6.34.2.2 OECmdLaunchApp Key
The OECmdLaunchApp Key stores the following values.
Value
Name
ProgID The Program ID of the component. OECmdLaunchApp.OEActionDLL.1
Target
ProgID List
2.6.34.2.3 OECmdLoadFile Key
The OECmdLoadFile Key stores the following value.
Value Name
ProgID The Program ID of the component. OECmdLoadFile.OEActionDLL.1
A list of the Progam IDs of the
OEMenus target.
Value Data Default Data
The Progam ID of the target. OECmdLaunchApp.OEActionDLL.1
Value Data Default Data
OECmdDbUpdate.OEActionDLL.1
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 99
2.6.34.2.4 OECmdLoadParamFile Key
The OECmdLoadParamFile Key stores the following value.
Settings Edito
Value
Name
ProgID The Program ID of the
component.
2.6.34.2.5 OECmdLoadTagListFile
The OECmdLoadTagListFile Key stores the following values.
Value
Name
ProgID The Program ID of the component. OECmdLaunchApp.OEActionDLL.1
Source
ProgID List
Target
ProgID List
2.6.34.3 OE Control Displays Key
The OE Control Displays Key has no current values.
The Program ID of the OEMenus
source.
The Progam ID of the OEMenus
target.
Value Data Default Data
OECmdLoadParamFile.OEActionDLL.1
Value Data Default Data
Gwx32.Display
OECmdLaunchApp.OEActionDLL.1
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
r
D5092
11-Dec-2007 - Page 100
Settings Edito
3 Index
A
Actions List ................................................ 31
Alarm Banner Control Key ...................... 110
Alarm Client Control Key......................... 111
Alarm Client Server Key ............................ 50