• Antelope Release 5.5 Mac OS X 10.8.5 2015-04-21

 

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

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
Printer icon