• Antelope Release 5.5 Linux 2.6.32-220.el6.x86_64 2015-04-21

 

NAME

cnsn_pick - mail_parser handler for CNSN pick/hypocenter mail messages

SYNOPSIS

cnsn_pick_handler( $message, $pfarray );

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 cnsn_pick handler is intended to be launched by the mail_parser(1) utility. The cnsn_pick handler takes email from the Canadian National Seismic Network about single-array event locations, and converts them to an output CSS database. The database is specified in the mail_parser.pf parameter file. The database may be specified with epoch2str(3) percent-escapes, in which case the parameter will be fed as a template to epoch2str against the origin time of the earthquake to decide the name of the output database. An additional table in the mail_parser.pf parameter file translates different types of message-labels into corresponding "auth" fields for the database.

PARAMETER FILE

nordic% cat mail_parser.pf
Handlers	&Tbl{
    &Arr{
	database	testdb_%Y_%m
	handler		cnsn_pick
	sender		somesource@somenet.net
	subject		YKA event
	authors	&Arr{
	  "LARGE EVENT NOTIFICATION" yk_large_event
	}
    }
}
nordic%

SEE ALSO

mail_parser(1)

BUGS AND CAVEATS

There may be an official name for this format but I've not seen it referenced anywhere. If there is, the name of this handler should be changed to reflect the format of the messages rather than one particular source that uses it. There are a couple more fields in the mail messages which need to be explained to the author; at the moment they are ignored. The email-message format was reverse-engineered by inspection for the conversion. Sometimes multiple source queues will deliver the same email message. cnsn_pick puts the first one received in the database, and ignores the rest (by relying on the dbaddv(3) duplicate-primary-key check, then trapping the run-time error).

AUTHOR

Kent Lindquist
Antelope User Group Contributed Software
Printer icon