trar - an ASCII Archiving Tool for EPICS Process Variables

Copyright (C) , TRIUMF 1999, 2000, ...

Updated:  23-Nov-2005

Disclaimer:

This document was developed from source code comments in the file trar.c. In case of discrepancies, comments in the source code of trar.c are deemed to be closer to reality   than any information in this document.

Functionality:

Limitations:

 

Request File Format:

 

 

Archive File Format:

Data are archived in "samples". Each sample consists of:

  1. a sample header line of the form:

    [sample] <date> <time> <long time>

    where:
    <date> is yyyymmdd
    <time> is hhmmss
    <long time> as returned by the C time function.

  2. one line per PV in the format:
Archiver revisions before 1.14:
  <pv name> <pv value> <pv min> <pv max> <monitor count>
Archiver revisions after 1.14:
  <pv name> <pv value> <pv min> <pv max> <monitor count> <min timestamp> <max timestamp>

The timestamps are in the format  HHMMSS.mmm, where mmm is milliseconds. Timestamp is the time when a monitor was received by the archiver, NOT the EPICS timestamp.

 

Information File:

In addition to the archive file, trar writes an information file:

<archive directory><yyyymmdd>.info.

The information file contains a list of all archive groups, tags and archive files, as well as start time and process ID info. A copy of the information file is written to <archive directory>trar.info.

 

Miscellaneous:

trar terminates if it receives a SIGTSTP or a SIGTERM signal. Termination time info is written to the archive file and the information file. The file trar.info is deleted.


Archive Retrieval:

A Perl/Tk script trarinfo.pl displays the information about the current archiving configuration form the information file.

A Perl/Tk script trarextkc.pl allows retrieval of up to eight process variables from the archive files and plots them using Gnuplot.

A Perl/CGI script trarexweb.pl allows retrieval of up to eight process variables from the archive files from a web browser and plots them using Gnuplot.

Both retrieval scripts use a compiled retrieval tool for more efficient extraction of data from the ASCII archives.