burtwb reads values from a snapshot file, then
write them to process variables. This is the restore
counterpart of the backup program burtrb.
burtwb -f SR.snpwhere the contents of the file
SR.snp are
SDDS1 &description &end ¶meter name = SnapType, type = string, &end &column name = ControlType, type = string, &end &column name = ControlName, type = string, &end &column name = Lineage, type = string, &end &column name = Count, type = long, &end &column name = ValueString, type = string, &end &data mode = ascii, no_row_counts=1 &end ! page number 1 Absolute pv S1A:Q1:CurrentAO - 1 300.0 pv S1A:Q2:CurrentAO - 1 400.0
usage: burtwb -f snap1 {snap2 ...} {-l logfile} {-o outfile}
{-c ... comments ...} {-k keyword1 ... keywordn}
{-d} {-v} {-p dep1 ... depn} {-r retry count} {-add} {-replace}
{-sdds or -nosdds}
where
-f snap1 {snap2 ...} - Snapshot filenames. This is the only
switch that is not optional. You must specify at least one
snapshot 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. If any of the snapshot files
read only notify values, this file is created and those values
are placed there. If none of the snapshot files have read only
notify values, then no file is created. The default is stdout.
-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.
-d - Debug. Save the files created by processing the dependency
files with the C preprocessor. The default is to delete these
files.
-v - Verbose. This increases the amount of information displayed
in the logfile.
-p dep1 ... depn - Dependency filenames. The names of the
dependency files containing predicates to be evaluated before
writing the values from the snapshot files.
-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.
-add - Absolute snapshots written as adds. All the absolute
snapshots, i.e., those taken directly off IOCs, will be written
as additions to the values found on the IOCs. The default is
to write the absolute snapshots as replacement values on the
IOCs.
-replace - Relative snapshots written as replacements. All the
relative snapshots, i.e., those generated by adding or
subtracting two snapshots, will be written to prelace the
values on the IOCs. The default is to write the relative
snapshots as additions to the values on the IOCs.
-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 three columns:
- can be used (signifies
a blank string to BURT programs).
Count -- Required long column. Needs to have a value of 1 for PVs and devices
that are single-valued, which is the case here.
SnapType -- Required string parameter describing the snapshot type. Valid
values are Absolute and Relative.
The optional columns are: