Create a Custom Report

The batch reporting capability in Monitor requires writing a Tcl script to describe the elements of the report and some work with the command line. The Tcl script generates HTML code that can be displayed in the browser, provided that the report is stored in a subdirectory of licmon.swd/html/reports. Example scripts are available in $VOVDIR/training/lm. The reporting script is processed by the ftlm_batch_report utility.

  1. Make a local copy of the standard report script, which is provided as an example: 
    % mkdir -p $VOVDIR/local/lm/reports
% cp $VOVDIR/etc/lm/reports/report_tag.tcl $VOVDIR/local/lm/reports/.
  2. Go to the directory where the report output is generated: 
    % cd `vovserverdir -p html/reports`
  3. Choose a tag and run the report for that tag.
    In this example, assume the tag name is "EDA":
    % ftlm_batch_report -script report_tag.tcl -tag EDA -interval 201006 > EDA_2010_06.html
    Note: Depending on the size of your database, the report may take several minutes.
If the report contains images, such as plots or pie charts, the generated HTML must refer to the image with an appropriate URL. The URL depends on whether or not the read-only port in the vovserver is enabled.

If the readonly port is open, the URL is complete and includes http://HOST:READ_ONLY_PORT/gif/file.gif. For example, http://lmsrv:5556/gif/plot12345.gif. The host is the value of VOV_HOST_HTTP_NAME, if defined, or of VOV_HOST_NAME. These settings are defined in the licmon.swd/setup.tcl configuration file. The port number is the read-only port. The reason for using a complete URL is to allow the report to be embedded into external web pages.

If the readonly port is not open, then the URL is relative to the current vovserver, as in the following example: /gif/plot12345.gif