NAME
orbdlstat2xml - Convert datalogger status packets from an orb to XML
SYNOPSIS
orbdlstat2xml [-v] [-a after] [-m match] orbname dir
SUPPORT
Contributed code: NO BRTT support.
THIS PIECE OF SOFTWARE WAS CONTRIBUTED BY THE ANTELOPE USER COMMUNITY. BRTT DISCLAIMS ALL OWNERSHIP, LIABILITY, AND SUPPORT FOR THIS PIECE OF SOFTWARE.
FOR HELP WITH THIS PIECE OF SOFTWARE, PLEASE CONTACT THE CONTRIBUTING AUTHOR.
DESCRIPTION
The
orbdlstat2xml program reads packets of type
.*/pf/st
from an Antelope orbserver, converts them to a simple eXtensible
Markup Language (XML) representation, and places the results in the
specified directory
dir.
OPTIONS
-
-a after
This option takes a string interpretable by the str2epoch(3) command
and rewinds the orbserver packet stream to the time specified. If this option
is omitted, acquisition starts as of the newest packet on the orb.
-
-m match
This option specifies the match expression to use against orb source names.
If left unspecified, the match expression defaults to .*/pf/(st|vtw)
-
-v
verbose
FILES
Regular packets are converted to XML files named after the packet
sourcenames (without the
.*/pf/st suffix/subcode extension).
Stash packets for each source name are saved under the same name
with
_stash appended.
orbdlstat2xml creates temporary files of the xml output under the
target names with '+' signs appended, then moves them to the final
target names when the files are complete. This back-buffering is intended
to prevent partially built files from corrupting the web interfaces built
on them.
EXAMPLE
% orbdlstat2xml anfops.ucsd.edu:status /scr/day &
% ls /scr/day
/scr/day:
pretadata.xml
pretadata_stash.xml
tadataAG.xml
tadataAG_stash.xml
tadataHN.xml
tadataHN_stash.xml
tadataOU.xml
tadataOU_stash.xml
tadataV2.xml
tadataV2_stash.xml
SEE ALSO
pf2xml(1), dlmon(1)
BUGS AND CAVEATS
orbdlstat2xml will translate the string field
opt, if present in the input
parameter file, into the five fields
acok,
api,
isp1,
isp2,
and
ti. If any of those string fields are present in the value of
opt,
the corresponding added parameter will be assigned a value of 1. If
opt is present
and non-null but does not contain the name of the new parameter, the newly added
parameter will be assigned a value of 0. If
opt is missing or null ("-") for
a given station in an input parameter file, these five new parameters will be set to
"-".
AUTHOR
Kent Lindquist
Lindquist Consulting, Inc.
Antelope User Group Contributed Software