Enterprise RTView® 
User Guide


Application Options

To access the Application Options dialog, in the Display Builder select Tools>Options.

Options specified on Alerts tabs can be saved in an initialization file (ALERTOPTIONS.ini). On startup, the initialization file is read by the Display Builder, Display Viewer, Display Server, Data Server and Historian to set initial values. If no directory has been specified for your initialization files and ALERTOPTIONS.ini is not found in the directory where you started the application, then Enterprise RTView will search under lib in your installation directory. NOTE: When you start an Enterprise RTView application from the Windows Start menu, it runs from the demos directory.  

NOTE: Options specified using command line arguments will override values set in initialization files.

There are three Application Options tabs for Alerts: Alerts, Alert Definitions and Self Service Alerts.

 


Alerts
The Alerts tab allows you to set alert options.

 

 
Alert History Depth Sets the number of rows that are stored in the AlertTable.
Rate To Remove Cleared Alerts Enter the time, in seconds, to control how often RTView will remove all cleared alerts from the Alert data source. NOTE: This rate is evaluated during each update pass, so the amount of time elapsed between removing cleared alerts may be longer than the value entered. For example, if the update period is two seconds and the Rate to Remove Cleared Alerts is five seconds, the cleared alerts will be removed every six seconds.


Alert Definitions
This tab allows you to to enable alerts, set options for your alert definitions, and add, remove or refresh your Alert Definition files. Once you have added an Alert Definition file and, optionally, entered a corresponding substitution, click Apply to execute. The Alert Definition file will be added to the data source. The Alert Variables Table updates with all active alerts from the Alert Definition file and the alerts begin executing. NOTE: Alerts without names or with duplicate names will not be added.
 
 
Enable Alerts Enables/disables all alerts in all active Alert Definition files.
Initial Delay Duration (in seconds) to wait after startup before evaluating alerts.
Alert Definition File File(s) that contain alert definitions. See Alerts for information on creating Alert Definition files.
Substitutions Optionally specify substitutions for this Alert Definition File. Substitutions must use the following syntax:

$subname:subvalue $subname2:subvalue2

If a substitution value contains a single quote, it must be escaped using a / :

$filter:Plant=/'Dallas/'

If a substitution value contains a space, it must be enclosed in single quotes. Do not escape these single quotes:

$subname:subvalue $subname2:'sub value 2'

A substitution string cannot contain the following:
:
|
.
tab
space
,
;
=
<
>
'
"
& / \ { } [ ] ( )

Add Click Add and select a (.rtv) file to include in Alert Definition File list.

NOTE: Alert definitions are only added after you click OK, Apply or Save.

Remove Selection Remove the selected Alert Definition file. Alerts in this Alert Definition file will no longer execute and the alert data for these alerts will no longer be available in the Alert data source. NOTE: Alert definitions are only removed after you click OK, Apply or Save.
Refresh Selection Reload the selected Alert Definition file immediately. This option allows the data source to re-read an Alert Definition file without restarting the Display Builder. NOTE: Refresh Selection is enabled when you select an Alert Definition file that has already been added and applied.


Self Service Alerts
Self Service Alerts make it easy to set and persist threshold, duration and enabled settings for your alerts in a database. For details, see Alerts>Self Service Alerts.
 
 

Enable Self Service Alerts Select to enable self service alerts. NOTE: If this option is selected, no alerts will be loaded into the system unless the specified Self Service Alerts Database is configured and connected.
Self Service Alerts Data Server Enter name of a named data server connection or leave blank to use the default data server connection, if specified. This data server will be used when connecting to the Self Service Alerts Database.
Self Service Alerts Database Name Name of SQL Database connection defined in the SQL tab of the Application Options dialog.
Alert Settings Table Name Name of table where your alert settings will be stored. See below for a description of the schema for this table.
Audit Table Name Name of the table where a record of all changes to the Alert Settings Table will be stored. This value is optional. If not specified, no record of changes will be stored.
Clean Alert Settings Table on Start Select to delete entries from the Alert Settings Table for alert names that are not defined in RTView. NOTE: This is done at startup after alert configuration files are processed and all of the alerts are loaded.
 

 
Enterprise RTView contains components licensed under the Apache License Version 2.0.

 

Treemap Algorithms v1.0  is used without modifications and licensed by MPL Version 1.1. Copyright © 2001 University of Maryland, College Park, MD

 

Datejs is licensed under MIT. Copyright © Coolite Inc.

 

JCalendar 1.3.2 is licensed under LGPL. Copyright © Kai Toedter.

 

jQuery is licensed under MIT. Copyright © John Resig,

 
JMS, JMX and Java are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries. They are mentioned in this document for identification purposes only. 

 
SL, SL-GMS, GMS, Enterprise RTView, SL Corporation, and the SL logo are trademarks or registered trademarks of Sherrill-Lubinski Corporation in the United States and other countries. Copyright © 1998-2011 Sherrill-Lubinski Corporation. All Rights Reserved.