Application
Options
The Application Options
dialog allows you to set general and data source specific options used in
RTView. Available options and
dialog tabs depend
on which
data sources
are licensed in your RTView application.
For information on Application Options for
your data source, refer to the
Data Sources section of this
documentation.
Options specified in the Application
Options dialog are saved into initialization (.ini) files when you click the Save
button. On startup, these initialization files are read by the Display Builder,
Display Viewer, Display Server, Data Server and Historian to set initial values
for all application options. It is possible to
specify a directory for your initialization files. If no directory is specified and initialization files are not found in the
directory where you started the current
application, then RTView will
search under lib in your
installation directory. NOTE: When
you start an RTView application from the Windows Start menu, it runs
from the demos directory. If initialization files are still not found, RTView
uses the default values in the dialog shown below.
NOTE: Options specified using
command line arguments will override values
saved in initialization files.
The following initialization files are saved from the Application Options dialog
and read by RTView:
- General options are read from
OPTIONS.ini.
- Additional initialization files are
read for Alerts and for data sources that are licensed in your RTView
application. For information on Application Options for your data source,
refer to the Data Sources section of this documentation.
The Application Options dialog can opened within
the Display Builder or run as a stand-alone application on Windows or UNIX.
Setting Options in the Display Builder In the Display Builder, select Tools>Options
to open the Application Options dialog.
Setting Options via Windows or UNIX
To run the dialog stand-alone, you will need to use the Configuration Utility. NOTE: When running stand-alone, Java options specified in
RTV_JAVAOPTS will be
used by the run_configutil scripts. However, these options will not be used when
the Configuration Utility is started from the Windows Start menu.
By default, the
Configuration Utility
does not require a login. Login can be
enabled at setup to support role
based security. The default user name and password are:
|
User Name: admin
Password: admin |
NOTE: It is possible that your system administrator
may have configured another user name and password. In
this case, you may also need to
select a role.
On Windows: To run stand-alone on Windows, you can open the
dialog from either the Windows Start Menu or an initialized command window.
From the Windows Start Menu select: Start-->Programs-->RTView-->Configuration Utility
NOTE: When you start the
Configuration Utility from the Windows Start menu, it runs from the demos
directory. The Configuration Utility will try to read initialization (.ini)
files and resolve XML sources containing relative paths from that directory. To
start the Configuration Utility in another directory, you must run RTView from a command window. NOTE: It is possible to
specify a directory for your initialization
files.
In an initialized command window type: run_configutil
On UNIX: In an initialized terminal window type:
run_configutil
Application Options Dialog
Select a category from the left frame to display
corresponding dialog tabs in the main window. Click the Save button to
record the new application options in an initialization file. NOTE: Do not close
the dialog without first saving your changes.
A
confirmation dialog will appear to verify in which directory you would
like to save the initialization file. If you
specified a directory for your initialization files
, all initialization (.ini)
files will be saved to, and read from, that directory.
If you select the lib directory,
the initialization file will be available from any directory where you
run RTView. If you do not select the lib directory, the initialization
file will be saved in the directory where you started the current session
and will only be available when you run RTView from that particular
directory.
NOTE: If no
initialization file is found, RTView will use the defaults
shown above.
The following describes Application
Options dialog commands:
Command |
Description |
OK |
Applies
values and closes the dialog. NOTE: Do not close the dialog until you have saved
your changes. |
Apply |
Applies
values without closing the dialog. |
Cancel |
Closes
the dialog with last values applied. |
Save |
Applies values, saves them
to an initialization file, and closes the dialog. |
General Options
|
 |
Update Period |
Enter
an integer value indicating the number of milliseconds at which RTView will update data. On each update, all synchronous data sources are
updated after which all displays are redrawn. Default is 2000 milliseconds.
|
Enable Data |
Check
to enable data updates. When not enabled, incoming data is ignored. The
default is enabled.
|
Redraw After Data Update |
Check
to specify data-driven redraws. Data from an asynchronous data source can
arrive at any time between update periods. This means there could be a delay
between the time an asynchronous data source receives a data update and when
the display showing this data is updated. If selected, displays containing
data from asynchronous data sources that have changed since the last update
will be redrawn at the rate specified in the Max Data Redraw Rate. Displays where
no data has changed will only be redrawn on the update. If not selected,
displays are only redrawn based on the update period.
|
Max Data Redraw Rate |
Enter
the maximum data redraw rate when data is updated. The default is 500
milliseconds.
|
Confirm Commands |
Set the
confirm policy for all commands. Overrides confirm policies set on
individual objects. For more information on commands see the Object Commands section.
Policy |
Description |
Do not confirm |
Indicates that no commands require confirmation (regardless of each object's confirmation
status). |
Confirm
all |
Indicates that
all commands require confirmation (regardless of each object's confirmation
status). |
Use
Object Confirm flag |
Indicates that
the confirmation status of each object will determine whether confirmation
is required. This is the default policy. |
|
Drill Down Windows Always
on Top |
Drill
down displays will permanently remain in front of the main display until
drill down windows are closed. When this setting is changed, the new
settings won't apply to windows opened before the change was made.
|
Enable Antialiasing |
Smooth graphics in the display. Default is enabled |
Single-Click for Drill
Down and Commands |
Open drill down windows or execute commands in the Display Viewer with a
single click. NOTE: This option does not apply while working in the
Display Builder. |
Maximum Displays in Composite Object Cache |
Sets the maximum number of display (.rtv) files with composite objects to cache.
Default is 5. If value is set to 0, no
displays are cached. This is a performance
optimization option for the composite object. Of course the higher you set this
value, the more memory the cache will require. The impact of increasing the
value of this option depends on your application. For example if you have
an object grid with 100 objects showing the same display (.rtv) file, then that
file can be cached and cloned for each composite object in the grid. However in
a situation where you have 100 composite objects showing different display (.rtv)
files, caching the files would not significantly optimize performance.
|
Window Resize Mode |
Globally controls object layout when a display window is
resized. It is also possible to set a specific Resize Mode for each particular display (.rtv) file
using the
Background Properties dialog. In the Display Builder, the selected Resize Mode is only applied to
drill down windows. The main window of the Display Builder is always in Crop mode.
All three resize modes support zooming the display (right-click -> zoom). In
both Scale and Layout modes if
the window is resized while the display is zoomed, then the resize will further
zoom the display.
NOTE: If you already have windows open and change
the resize mode, the new setting will only apply to new windows that are opened
(i.e. windows already open will not change.)
Select from the
following options:
Default |
Use application
level default mode. Defaults are: Scale for for the Display Builder,
Display Viewer Application and Display Viewer Applet and Crop for the
Thin Client, |
Crop |
When the window is
resized, the display stays the same size. If the window is bigger than the
display, empty space will show around the display. If the window is smaller
than the display, scrollbars will be added. The window is not forced to
maintain its aspect ratio. This is the default for the Thin Client.
|
Scale |
When the window is
resized, the display and all of the objects in it are scaled to fit the
available space. The window is forced to maintain its aspect ratio. This is
the default for the Display Builder, Display Viewer Application and Display
Viewer Applet. |
Layout |
When the window is
resized, the display is resized to fit the available space. The objects in
the display are positioned according to their anchor and dock
properties. The window is not forced to maintain its aspect ratio.
Objects that are not docked or anchored will
move relative to their offset from the top left corner of the display. For
example, if the object is centered on the display, the object will move 50%
of the resize amount. If the object is centered at 3/4 of the display, it
will move 75% of the resize amount.
NOTE: To prevent objects from overlapping,
set resizeWidthMin and
resizeHeightMin. If a panel containing a
display is resized, the display will not reduce smaller than the specified
minimum size. |
|
Custom
Window Title |
Specify a custom window title. To specify an empty window title, enter
a single space. By default, window titles contain the
name of the application followed by the name of the display (.rtv)
file (e.g. RTView mydisplay.rtv).
A Custom Window Title:
NOTE: If you already have windows open and
enter a Custom Window Title, the setting will only apply to new windows that are opened
(i.e. titles of windows already open will not change). |
Substitutions
Add, edit or remove substitutions.
NOTE: The substitution string $value is reserved for internal use.
Add - Enter a String
and a Value. Click Add to insert the substitution into the listing.
NOTE: Substitution
strings cannot contain the following:
:
|
|
|
.
|
tab
|
space
|
,
|
;
|
=
|
<
|
>
|
'
|
"
|
& |
/ |
\ |
{ |
} |
[ |
] |
( |
) |
Edit - Select a substitution
from the list and edit the String or Value. Click Add to replace
the substitution currently listed.
Remove - Select a
substitution from the list and click Remove.
|