Enterprise RTView® 
User Guide


Application Options

Data Server

This Options tab allows you to redirect data requests to the Data Server. Once you select to read Data Server data, direct access to data sources will be disabled. Enterprise RTView clients (Display Builder, Display Viewer Application, Display Viewer Applet) can read Data Server data from a file, directly via socket or through the Data Servlet using HTTP/HTTPS requests.

NOTE: Settings made in this Application Options dialog must correspond with information entered in the Data Server Configuration dialog.

Options selected on the Data Server tab cannot be applied to the current session of Enterprise RTView. Click the Save button to record all Application Options in an  initialization (DATASERVER.ini) file that will be used to apply settings when Enterprise RTView is restarted. It is possible to specify a directory for your initialization files. If no directory is specified and DATASERVER.ini is not found in the directory where you started the Data Server, 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.  

Data Server Modes
By default Enterprise RTView reads directly from data sources and not from the Data Server. To configure your default Data Server, select one of the following three options on this tab. Select Named Data Servers to configure connections to additional data servers.

  • Do Not Read Data from Data Server
  • Read Data from File
  • Read Data from Server

Do Not Read Data from Data Server
Reads directly from data sources without redirecting data requests to the Data Server.
 


Read Data from File
Redirect data requests to the Data Server and read XML file output by the Data Server. Once you select Read Data from File, direct access to data sources, except the XML data source, will be disabled when you save your options and restart Enterprise RTView. NOTE: The XML data source is never redirected through the Data Server when you read data from a file.

Viewer Only - Select this checkbox if the Display Viewer should read data from the Data Server, but the Display Builder should read directly from data sources.

File Name - Enter name (including path or URL base) of the Data Server output file. Default file name is rtvdata.xml. NOTE: This information must correspond with the Data Server Configuration dialog, including name and location of Data Server output file.

Named Data Servers - Open the Named Data Servers dialog to configure connections to additional data servers.
 


Read Data from Server
When you choose to Read Data from Server, a primary and a backup server can be specified for the default Data Server and also for each Named Data Server. At startup, Enterprise RTView clients will connect to the primary server if available, otherwise to the backup server. If neither server is available, clients will periodically retry connecting to both. If a connection is made to either server and later that connection is lost, then an attempt will be made to connect to the other server. If a connection is made to the backup server and later the primary server becomes available, clients will not switch to the primary server unless the connection to the backup server is lost.

NOTE: All servers specified should use the same initialization files (*OPTIONS.ini) and should have access to the same external data sources, so that displays will appear the same regardless of which server is connected.

Viewer Only - Select this checkbox if the Display Viewer should read data from the Data Server, but the Display Builder should read directly from data sources.

Primary Server - Enter host:port for direct connection to Data Server or enter URL for connection via Data Servlet.

Backup Server - Enter host:port for direct connection to Data Server or enter URL for connection via Data Servlet. If Primary Server is unavailable the client will transfer over the to the specified Backup Server.

Redirect XML Data Source - This option only applies once you select Read Data from Socket. Select from the following options:
Do Not Redirect XML Data Source - XML data is not redirected through the Data Server. Enterprise RTView will connect to the XML data source directly. 

Redirect XML Sources Without HTTP Prefix - Redirect XML sources that don't start with http: or https:.

Redirect All XML Sources - Redirect all XML sources through the Data Server.

NOTE: Use the Get Data Server Connection Status function to access information about the status of connections from the Display Builder and Display Viewer Application to the default Data Server and any Named Data Servers.

Named Data Servers - Opens the Named Data Servers dialog where connections to additional data servers can be configured.

Data Servers are configured by the DATASERVER.ini file, which is generated from the Data Server, in addition to all *OPTIONS.ini files, which are generated when you click Save in the Application Options dialog. When additional Data Servers are configured you should specify a directory in which you can store their respective initialization files so they will not be overwritten. NOTE: All servers specified should use the same initialization files (*OPTIONS.ini) and should have access to the same external data sources, so that displays will appear the same regardless of which server is connected.

 

Named Data Servers New Select New to enter the Name of a Data Server to add to the list.
Remove Select a Data Server from the list and click Remove to delete.
Viewer Only Select this checkbox if the Display Viewer should read data from the specified Data Server, but the Display Builder should read directly from data sources.
Name Click the New button and enter the name of the Data Server. When you attach an object to data or define a command, this name will appear in Data Server drop down menu.
Primary Server Enter host:port for direct connection to Data Server or enter URL for connection via Data Servlet.
Backup Server Enter host:port for direct connection to Data Server or enter URL for connection via Data Servlet. If Primary Server is unavailable the client will transfer over the to the specified Backup Server.
 

 
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-2009 Sherrill-Lubinski Corporation. All Rights Reserved.