The Display Server is instrumented with JMX to allow you to manage and monitor the display cache and application settings. To enable JMX, you must run the Display Server using the -jmxport command line option:

    -jmxport:(port number)

The JMX Monitor demo, located in demos\jmxmonitor in your RTView installation, shows how to use RTView to monitor the Display Server using JMX. NOTE: Java 1.5.0_06+ is required.

The Display Server contains one MBean named RTViewDisplayServer:name=Manager with the following methods:
 

Method/Attribute	Type	Description
DisplayData	TabularData	One row for each cached display containing: Display Name - The name of the .rtv file for the display. Display Number - The display number. These values always range from 1 to N, where N is the number of displays currently in the cache. This number is not tied to a particular display (i.e. display name + substitutions), and can change as displays are automatically removed from the cache. Last Reference Time - The amount of time that has elapsed since the display was last requested by a client.  When this time exceeds the Display Timeout, the display is eligible for automatic removal from the cache. Substitutions - The substitution string for the display.
DisplayTimeout	int	The current display timeout setting.
ImageQuality	float	The current image quality setting.
MaximumDisplayCount	int	The current maximum display count setting.
NumberOfDisplays	int	The number of cached displays.
Sessions	TabularData	One row for each active client session. Typically, there is one client session for each browser instance that is currently viewing a Thin Client display. The Sessions table contains the following columns: Session ID - A unique ID for the client session. The Session ID is also a column in the mbean's DisplayData table, which contains one row for each display that is currently open in a Thin Client. The Session ID is a unique string assigned to a session by RTView and is not the same value as the session identifier assigned by the webapp manager (e.g. Tomcat). Client Address - The IP address of the client. The Client Address will be in IPv4 (e.g. x.x.x.x) or IPv6 (x:x:x:x:x:x:x:x) notation, depending on which protocol the client browser used to connect to the rtvdisplay servlet. For example, if the client is on localhost then the client address could be shown as 127.0.0.1 for IPv4, or 0:0:0:0:0:0:0:1 for IPv6. Duration - The elapsed time since this client session was created. The Duration column and the Last Reference Time column show elapsed time as "d hh:mm:ss" where d = days, hh = hours, mm = minutes and ss = seconds. By default, a session expires and is removed from the table after about 10 or 11 minutes of inactivity (that is, when the elapsed time shown in the Last Ref Time column is "0 00:11:00" or more). If the Display Server's display_timeout property has been set, then the session expiration is 10 times the display_timeout value. (The default display_timeout is 60 seconds). Last Reference Time - The elapsed time since this client opened or refreshed a display. User - The login user name. The User and Role columns will be blank if the login feature of the rtvdisplay servlet is disabled. Role - The login user role. The User and Role columns will be blank if the login feature of the rtvdisplay servlet is disabled.

The RTViewDisplayServer:name=Manager MBean also supports the following commands:
 

Method/Attribute	Description
clearDisplayCache	Clears the cached displays as well as preloaded displays.
setDisplayTimeout	Set the display timeout.
setImageQuality	Set the image quality.
setMaximumDisplayCount	Set the maximum display count.