doc/applications/arclinktool

arclinktool

arclinktool is a simple client for testing ArcLink servers. It is possible to send all types of requests directly to a specified server. Routing is not supported.

Commandline options

--version
Show program’s version number and exit.
-h, --help
Show this help message and exit.
-u USER, --user=USER
User’s e-mail address.
-i INST, --institution=INST
User’s institution.
-o OUTF, --output-file=OUTF
File for the downloaded data.
-c DECOMP, --decompress=DECOMP
Compression type for decompression.
-r REQUEST_FILE, --submit=REQUEST_FILE
Submit request.
-s STATUS_ID, --status=STATUS_ID
Check status.
-d DOWNLOAD_ID, --download=DOWNLOAD_ID
Download product.
-p PURGE_ID, --purge=PURGE_ID
Delete product from the server.

Examples

Example of a request file named “req.txt”:

REQUEST WAVEFORM format=MSEED
2008,06,04,06,00,00 2008,06,04,06,10,00 GE CART BHZ .
2008,06,04,06,00,00 2008,06,04,06,10,00 GE MAHO BHZ .
END

Submit the request to the ArcLink server.

> arclinktool -u andres -r req.txt localhost:18001
Connected to ArcLink v0.4 (2006.276) at GITEWS
Request successfully submitted
Request ID: 91

Check the status.

> arclinktool -u andres -s 91 localhost:18001
Connected to ArcLink v0.4 (2006.276) at GITEWS
Request ID: 91, Type: WAVEFORM, Args: format=MSEED
Status: READY, Size: 37376, Info:
Volume ID: local, Status: OK, Size: 37376, Info:
Request: 2008,06,04,06,00,00 2008,06,04,06,10,00 GE CART BHZ .
Status: OK, Size: 18432, Info:
Request: 2008,06,04,06,00,00 2008,06,04,06,10,00 GE MAHO BHZ .
Status: OK, Size: 18944, Info:

Download data.

> arclinktool -u andres -d 91 -o data.mseed localhost:18001
Connected to ArcLink v0.4 (2006.276) at GITEWS
Download successful

Delete request from server.

> arclinktool -u andres -p 91 localhost:18001
Connected to ArcLink v0.4 (2006.276) at GITEWS
Product successfully deleted