QuakeWatch Cube Output Client



     The QuakeWatch Cube Output Client
("QWCubeOutClient") connects to a QWServer, receives messages, converts them to CUBE format and outputs them to individual files (one file per message).  This client may be used as a functional equivalent to the QDDS program (operating as a "leaf").
     The "conf/QWCubeOutClientConfig.xml" file contains the configuration parameters for the program, including the parameters described below and the connection parameters for the client.  See
the "QWConnParams.html" file for a description of the QuakeWatch Connection Parameters.  The QuakeWatch Cube Output Client distribution contains the following files:

QWCubeOutClient.jar - Program "jar" file for the client.
startClient - Unix script for starting the client.
stopClient - Unix script for stopping the client.
startStopClient - Unix script for starting/stopping the client.
run - Unix script for running the client interactively.
run.bat - Windows batch file for running the client.
conf/QWCubeOutClientConfig.xml - Sample configuration file for the client.
doc/QWCubeOutClient.html - This documentation file.
doc/QWConnParams.html - Documentation for the "QuakeWatch Connection Parameters".
test/TestLoginInfoFile.txt - Test file for client-server login authorization.
QWCubeOutClientSrc.zip - Source code for the client.

     The program jar file "QWCubeOutClient.jar" contains all the resources needed to operate (except for the
"conf/QWCubeOutClientConfig.xml" file).

     The CUBE format is used by the QDDS program, for which the following documentation is available:

USGS NEIC Documentation for QDDS:  http://neic.usgs.gov/neis/qdds/
Distribution Site for QDDS (FTP):  ftp://ehzftp.wr.usgs.gov/QDDS
CUBE Format Documentation:  CUBE.html



Cube Output Client Parameters

     The following parameters are specified in the "<Settings>" element of the "conf/QWCubeOutClientConfig.xml" configuration file for the QuakeWatch Cube Output Client (in addition to the QuakeWatch Connection Parameters).

outputMsgFilesDir = "dirname"

     The output directory for message files.  The filenames will be in the form "out.#", where "#" is the message number for the message.  Additional characters may be added to the filename to make it unique.  When a message is received, it contents are written to a file in the "processMsgFilesDir" directory, and then the file is moved to the "outputMsgFilesDir" directory.
  If this parameter is not specified then the value will default to "msgOutput".

processMsgFilesDir = "dirname"
     The process directory for message files.  When a message is received, it contents are written to a file in the "processMsgFilesDir" directory, and then the file is moved to the "outputMsgFilesDir" directory.
  If this parameter is not specified then the value will default to "msgProcess".

lastMessageFileName = "fileName"
     Specifies the name of the file used to store a copy of the last message received by the client.  When the client starts up, it uses the message data from the file (if found) to request messages from the server that the client has missed.  If this parameter is not specified then the value will default to "qwLastMessage.dat"
.

Note:  For this client, the 'maxServerEventAgeDays' parameter defaults to 0.000001.  This value effectively disables the fetching (at startup) of old server messages if none were previously received, while still enabling the fetching of messages sent since last previously-received message.


10/27/2006 - Eric Thomas, Instrumental Software Technologies, Inc. - info@isti.com