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. If no directory has been specified for initialization files 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 Socket (Direct or via HTTP/HTTPS)

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 Socket (Direct or via HTTP/HTTPS)

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.

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.

Connection Mode (Direct or via HTTP/HTTPS):

Connect Directly to Socket
Redirect data requests to the Data Server and receive data directly via socket or through an intermediary Data Servlet. Using the servlet requires a separate installation process, see the Data Servlet section for details.

To connect directly via socket you must specify a host and port, unless the Data Server is running on the same host as Enterprise RTView and using the default port (3278). This information must correspond with the Data Server Configuration dialog, including host name and port number. 

Data Server Host - host
Data Server Port - 8722

NOTE: When running the Display Viewer Applet, the Data Server must run on the same host as the applet.

Once you select Read Data from Socket, direct access to data sources will be disabled when you save your options and restart Enterprise RTView. NOTE: By default Do Not Redirect XML Data Source is selected. This enables you to connect directly to the XML data source while redirecting other data sources.

  Connect via Data Servlet using HTTP or HTTPS
To connect via the Data Servlet, enter the full URL for the servlet (where host is web server hosting the servlet and port is port used by the web server). NOTE: Using HTTPS requires Java 1.5.0_01+ and the host must be configured for HTTPS.

When running the Display Viewer Applet, the servlet must run on the same host as the applet. Once you select Read Data from Socket, direct access to data sources will be disabled when you save your options and restart Enterprise RTView.

NOTE: By default Do Not Redirect XML Data Source is selected. This enables you to connect directly to the XML data source while redirecting other data sources.

Data Server URL - http://host:port/rtvdata
Or to use secure HTTPS:
Data Server URL - https://host:port/rtvdata

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

NOTE: 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.

 

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.
Connection Mode Choose Connect Directly to Socket or Connect via Data Servlet using HTTP or HTTPS.
 

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

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