NAME
ims2dmc - send IMS1.0 short bulletin files to DMC and track in database
SYNOPSIS
ims2dmc
[-v]
[-V]
[-C product_dir]
[-s subject]
{-m email1,email2,... | -o orb}
file database
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
ims2dmc uses
rtmail or
orbxfer2 to transfer IMS1.0 short
bulletin files to the DMC. It also updates a
dmcbull table
that tracks when the file was transferred to the DMC and some information about
the content of those files. If transferring via orbxfer2, the
dmcfiles table
is also updated.
As of early 2008, the DMC requests that the files be sent to phasemail@iris.washington.edu
with the subject line of "PICKS". This address should be included with any others
who might need to be informed of the file availability using the -m option. Except for
test purposes, there should be no reason to change the subject line.
OPTIONS
-
-v
Verbose log messages
-
-V
Overwhelmingly verbose log messages. Useful for debugging purposes only.
-
-s subject
Subject for the email if -m option is used. The DMC requests that the subject line be "PICKS".
You should not have to change this. Ignored if -m is not used.
-
-m email1,email2,...
Email addresses for those who will receive bulletin files. The DMC requests
that phase picks be sent to phasemail@iris.washington.edu. Either the -m or
the -o option must be selected.
-
-o orb
Output/transmit orb for orbxfer2(1). File will be transferred to this orb that
the DMC (or others) watch with orbxfer2 in receiver mode. See BUGS and CAVEATS for
potential changes needed for orbxfer2.pf. Either the -m or the -o option must be selected.
-
-C product_dir
Top level directory underneath which the IMS files reside. The phase pick files generated
by db2ims reside in an ims_dir as specified in db2ims.pf. This could include a
full path name that you do not want to transfer when using orbxfer. The product_dir is
the top level directories that you wish to strip off when transferring the file via orbxfer2,
the -o option. Using this option with -o, if the file to be transferred is stored in
the product_dir/ims_dir, the orbxfer2 receiver receives the file as
ims_dir/2008_01_01_ANF_IMS for example.
-
file
Name of the file containing IMS1.0 short file format phase and origin information.
-
database
Database which contains the dmcbull table (and optionally dmcfiles table).
FILES
The IMS1.0 short file format with DMC modifications is described in the
man page for
db2ims.
ENVIRONMENT
ims2dmc requires that the dmcbull and dmcfiles css3.0 schema extensions be installed.
EXAMPLE
Transfer phase picks from December 2007 to the DMC and send a copy to
jeakins@ucsd.edu recording the file sent in dbops/anf.dmcbull
% ims2dmc -m jeakins@ucsd.edu,phasemail@iris.washington.edu
2007_12_ANF_IMS dbops/anf
Transfer phase picks from December 2007 to the DMC using orbxfer,
record information on the file sent in dbops/anf.dmcbull and to
db/anf.dmcfiles
% ims2dmc -o anfexport.ucsd.edu:meta -d db/anf
2007_12_ANF_IMS dbops/anf
SEE ALSO
db2ims(1)
orbxfer2(1)
mk_dmc_files(1)
dmcbull(5)
dmcfiles(5)
BUGS AND CAVEATS
All bets are off if the file you attempt to transfer is not of the proper format.
The dmcbull table is reviewed by the db2ims(1) program for duplicate filenames. Duplicates
are given a file name incremented by one.
Sending of duplicate files is allowed.
No checks are made on the size of the file you are trying to send. Note that
some mailservers may limit the size of an attachment and this program will likely
fail silently if that limit is exceeded. If file size is going to be "too large"
use the orbxfer2 transfer mechanism (-o option).
When using the default orbxfer2.pf file, if there is no reader attached to the
specified output orb with -o, the program will hang until a reader is attached.
To avoid this behavior, the wait_match parameter in the orbxfer2.pf file must be blank.
AUTHOR
Jennifer Eakins
Univ. of California, San Diego
Antelope User Group Contributed Software