burtrb reads values of process variables and writes them to a file.
An input file lists the process variables to be read.
The output file (also called a snapshot file) can be used by program burtwb
to restore the process variables.
burtrb -f SR.req -o SR.snpwhere the contents of the file
SR.req are
SDDS1 &column name = ControlType, type = string, &end &column name = ControlName, type = string, &end &data mode = "ascii", no_row_counts=1 &end pv S1A:Q1:CurrentAO pv S1A:Q2:CurrentAO ...Note that the header contain the minimal amount of information. There may be situations where more columns need to be defined, as described elswhere in this manual.
usage: burtrb -f req1 {req2 ...} {-l logfile} {-o outfile} {-d} {-v}
{-c ... comments ...} {-k keyword1 ... keywordn}
{-r retry count} {-sdds or -nosdds} {-Dname{=def}}
{-Ipathname}
where
-f req1 {req2 ...} - Request filenames. This is the only switch
that is not optional. You must specify at least one request
file.
-l logfile - Log filename. The name of the file where all logging
messages (e.g. error messages, reports of process variables
that were not found) go. The default is stderr.
-o outfile - Snapshot filename. The name of the file where the
snapshot information goes. The default is stdout.
-d - Debug. Save the files created by processing the request
files with the C preprocessor. The default is to delete these
files.
-v - Verbose. This increases the amount of information displayed
in the logfile.
-c ... comments ... - Comments. Adds comments to the header of
the snapshot file.
-k keyword1 ... keywordn - Keywords. Adds keywords to the header
of the snapshot file.
-r retry count - Number of additional attempts to wait for
connections. The program will attempt to find all the process
variables. If it is unsuccessful, it will try this many more
times to establish connections. The default value is 0.
-sdds or -nosdds - SDDS/non-SDDS snapshot file. Explicitly
specifying that the generated snapshot file will be
SDDS/non-SDDS compliant. The default is to adopt the SDDS
type from the input(s). If there is a heterogeneous set of
inputs (some SDDS and some non-SDDS), the default is to produce
and SDDS compliant snapshot file.
The input file is an SDDS file with at least two columns:
The output file contains the same columns as the input file plus additional ones:
burtrb will expand the composite device in its atomic devices, and
write one row per atomic device in the output file with the same Lineage
value for each. If the control name in the input file was a process variable or
an atomic device then the lineage is the character ``-''. (A quirk of program
burtrb is the use of the character ``-'' for the equivalent of the empty
string. A preferred way to specify a empty string would be simply ``'', but this
hasn't been implemented in burtrb.)