IRIS DMS Newsletter

IRIS » DMS Newsletter » vol11 no3

Program Spotlight

Batch Requesting Data from the DMC

Tips, Tricks, and How-to's

The following guidelines will help in submitting a BREQ_FAST request for data.


Use the correct format http://www.iris.edu/manuals/breq_fast.htm

Include Header Information so we can find you correctly
• .NAME, .INST, .MAIL, .EMAIL, .PHONE, .MEDIA, .LABEL, .END
• The .END line indicates to the parser that what follows is the data being requested, so without it the request will fail.

No line breaks within a request line

• correct:

GNI IU 2004 03 26 19 30 00.0 2004 03 26 20 45 00.0 1 ???


• incorrect:

GNI IU 2004 03 26 19 30 00.0

2004 03 26 20 45 00.0 1 ???


Remember to ALWAYS left-justify all the lines, particularly the token lines beginning with “.”

Keep it simple

Be sparing with wildcards
• The more requested, the longer it takes to process

Keep your email simple, plain text, and free of any attachments or special effects: animations or signatures

Make sure your email server does not add additional characters or attachments to your request

IRIS automated mail is not SPAM

Enable your email server to recognize incoming IRIS mail(s), otherwise choose another email address in the .EMAIL token that will enable pass-through

Some institutions impose numeric limits to how many emails can be sent to distinct users by configuring mail servers to block excessive messages over fixed time domains. REMEMBER: IRIS will send you TWO automated emails for each request, the first being an acknowledgement that it was received, the second indicating that the data is ready for download.

Rejected emails get returned to IRIS and can clog up the IRIS mail queue causing delays to your request(s) and other’s request(s)

How To Track the Status of Your Requests

There is a cyclic nature to the submission of breq_fast requests for a variety of reasons. Most of the time, requests are processed within minutes of being received. However, since the community
of researchers who access data from the DMC is globally distributed, you may want to be able to see who your are competing with should there be unexpected slowness. See below for tips on how to check the condition of the request queue and more importantly, the status of your requests specifically.

How to Check the Status of a Request http://www.iris.edu/data/

Click on ‘Mail Queue’ to check the status of new requests waiting to be processed

Click on ‘request status’ to check the status of your request as it is being processed

Click on ‘recent shipments’ to view recently completed requests

 

More Information

BREQ_FAST Request Manual

Requesting Data from the DMC (pdf)

 

Submitted by Un Joe, IRIS DMC

The Incorporated Research Institutions for Seismology is a consortium of over 100 research institutions with major commitments to research in seismology and related fields. IRIS operates a facilities program in observational seismology and data management sponsored by the National Science Foundation through its Division of Earth Sciences. IRIS logo
link to index