Archive Viewer

ArchiveViewer

Description

Archive Viewer is a feature rich trend chart for examining different types of channels. The application runs in two different modes: live and history. In history mode the viewer will present the history of the selected channels between the selected dates and when using the live mode, the viewer will show a recent history (defined by the user) and append live data to the trend lines with 2 seconds polling time.

The Archive Viewer allows browsing for the properties and adding different properties/devices to the same trend chart. It can also accepts drop events from other applications or complete channel names from a text-flavored drag. Upon adding, the channel will be added to the list of active trends and data will be loaded from the archive server. The viewer then allows user to use different visualization features to examine the values of the channel. And if the selected channel is a multi-channel, the user can even see the multi-channel array for each particualar timestamp from the trend chart.

Start

Archive Viewer can be started by running the java class.

de.desy.tine.apps.ArchiveViewer

This will start a plain Archive Viewer, with empty charts.

Run the Archive Viewer with Java Webstart (only accessible from DESY internal network).

Start-up parameters

Archive Viewer supports all start-up parameters defined in the common features section. In addition several others parameters can be supplied to preconfigure the application.

The list of start-up parameters tags
  • av.mode - the mode in which the Archive Viewer will be started (sub, local, central)
  • av.machine - the name of the context that will be selected (if it exists)
  • av.availableSubsystems - the list of all subsystems (separated by comma: ',') that will be displayed in the combobox at startup
  • av.subsystem - the name of the subsystem that will be selected (if it exists)
  • av.server - the name of the server that will be selected (if it exists and if in local mode)
  • av.property - the name of the property that will be selected (if it exists)
  • av.device - the name of the device that will be selected (if it exists); this will not add the channel to the chart yet, but only select the name in the selector
  • av.configuration - the name of the configuration that will be selected (if it exists and if in central mode)
  • av.datespan - the span which will be selected at startup. The span is given as a startDate-stopDate: dd.MM.yyyy-dd.MM.yyyy (if no span is defined, the last 24 hours are selected; if the end date is missing, current time is taken)
  • av.live - true if archiver should start in live mode or false if it should start in archive mode
  • -C[remoteName] - the remote name of the channel which will be added to the chart (there can be more than one parameter of this type). If device and property were not explicitely defined with appropriate start-up parameters, this command will also try to select the context, server, device and property extracted from the remote name.
  • -I[remoteName] - the remote name of the channel which will be added to the table, but will not be visible in the chart. Channel can be made visible by selecting its flag in the channels table. There can be more than one parameter of this type.

    Example: we want to start the archiver in the local mode, with selected context DORIS. In addition we want to add several properties. We want the Temp property to be immediately visible on the chart however, the Pressure property should remain hidden until the user decide to show it. We will use system parameters:

    java -Dav.mode=local -Dav.machine=DORIS 
         -D-CDORIS/ARCHIVER/#0/Temp -D-IDORIS/ARCHIVER/#0/Pressure 
         -cp [classpath] de.desy.tine.apps.ArchiveViewer