Enterprise RTView® 
User Guide


Application Options

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

Options specified in JMX tabs can be saved in an initialization file (JMXOPTIONS.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 JMXOPTIONS.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 two Application Options tabs for JMX: JMX Connections and JMX Administration.

JMX Connections
This tab allows you to add or remove connections and set your default connection.

When you add a JMX connection to the list it will be highlighted in yellow indicating that Enterprise RTView has not connected to it. To attempt to connect to a JMX connection, click OK, Apply or Save. If the background remains yellow, then Enterprise RTView was unable make a connection. Check that your JMX connection was setup correctly and that the JMX instrumented application is running. NOTE: Regardless of which tab you are currently working from in the Application Options dialog, each time you click OK, Apply, or Save Enterprise RTView will attempt to connect to all unconnected connections.
 

Default Connection - Name of connection used as the default for data attachments. Select from drop down menu to change default setting.

Add Connection - Click to open the Add JMX Connection dialog. To edit, select a connection from the JMX Connections list and double-click.
 
 
Connection Name Name to use when referencing this JMX connection in your data attachments. 
Host or IP Host name or IP address of the MBean server.
Port Port that your JMX instrumented application is using to expose MBean methods.
Enter URL Select to enter the URL (below) that should be used to create this connection. Otherwise, the Host/IP and Port specified will be used to construct a URL for this connection.
URL URL that should be used to create this connection. Select Enter URL to enable this field. Enter local to make a local connection to an in-process MBean server.
Use Client Credentials If selected, the User Name and Password from the Enterprise RTView login will be used instead of the User Name and Password entered in the Add JMX Connection dialog. Connections to this database will only be made when you are running with login enabled.

If you will be using the Data Server or the Display Server with a JMX connection that has this option enabled, you must enable Use Client Credentials for Database Login in these applications. In both of these deployments, a connection will be made for each client login, as the users log in. Once all of the clients for a login have closed, the connection for that login is removed.

User Name User name to use when creating this connection. This parameter is optional.
Password Password to use when creating this connection. This parameter is optional.

Remove Connection - Select a connection from the list and click Remove Connection to delete.

Remove All Connections - Removes all connections.



JMX Administration
 

 
Expand Composite Attributes Select to expand composite attributes so that you display one column for each item when a composite attribute is displayed in a table with other attributes.

The column name will be compositename.itemname.

Default Poll Interval Enter the time in milliseconds to control how often MBean attributes are polled or operations in data attachments are executed if no Poll Interval is specified in the data attachment. Default is 0, which polls MBean attributes and operations according to the General Update Period specified in Application Options on the General tab.

NOTE: Because the Default Poll Interval is superseded by the
General Update Period, the amount of time elapsed between MBean polls may be longer than the value entered. For example, if the General Update Period is 2000 milliseconds and the Default Poll Interval is 5000 milliseconds, MBean attributes and operations will be polled every six seconds.

 
   

 
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.