FLAGS:
-q -- quiet mode. Request for confirmation of the operation is
not issued.
-qq -- the quietest mode. No request for confirmation of the
operation no information about the progress is printed on
the screen.
-p -- to send a ping to the Data Center in order to check whether
it is still running. Arguments data type and database names
are ignored and can be omitted if this flag is on.
-h -- help information is printed in stdout.
data_type -- supported data types:
dclient -t DBH -c $MK4/local.GSFC.dbs -f /diskA1/data1/99JUL01XA_V004 dclient -t DBH -c $MK4/local.GSFC.dbs -f 99JUL19SH_V002 dclient -t DBH -c $MK4/local.GSFC.dbs -f 99JUN14XH dclient -q -t EOPS -c $MK4/local.GSFC.eops -f $SAVE_DIR/last.eops dclient -h dclient -p -c $MK4/local.GSFC.dbsDclient reads configure file, checks its syntax. Further work depends on a data type. If the data_type is DBH then dclient checks a item_name argument and determines its mode. In the case of modes "b" and "c" dclient asks catalogue and finds filename(s) of the database(s) with absolute path(s). If the data_type is EOPS, EOPI, DESC or DSNX then dclient copies EOP series or technical description or solution listing file to the directory and filename which specified in the configuration file. Dclient processes data types EOPS and EOPI, DESC, DSNX similar way. Then it creates a temporary file with e-mail message to dserver and creates a temporary file with C-Shell program which copies the data file(s) to a local ftp-directory and gzips them on the fly. Finally a e-mail message is sent to dserver which should initiate retrieving the databases or EOP series from the host where dclient has been launched (Operating Center) to a a host where dserver is running (Data Center). E-mail messages from dserver with confirmation of a request or denying it and successful termination of retrieving (or error during retrieving) will be sent to user(s) in according specifications in config_file. Dclient doesn't check data contents, but dserver does. Dclient also doesn't check whether filename is legal (follows IVS datafile convention), but dserver checks.
Supported keywords:
############################################################################# ## ## ## dclient configuration file for submitting databases from GSFC (GSF) ## ## ## ## 11-OCT-2000 17:05:53 ## ## ## ############################################################################# # DATA_CENTER: CDDISA, NASA/GSFC # DSERVER_EMAIL: dserver@ivscc.gsfc.nasa.gov # FTP_DIR: /home/ftp/pub/databases # URL_PREFIX: ftp://gemini.gsfc.nasa.gov/pub/databases/ # MAIL_COMMAND: mailx # CONFIRM_EMAIL: NO # SUCCESS_EMAIL: . cav@gemini.gsfc.nasa.gov dgg@leo.gsfc.nasa.gov # SUBMIT_LOG: /data1/save_files/dbs_GSF.log # TMP_DIR: /tmp/ # DO_PURGE: YES # DO_LINK: NO #!
Example 2:
############################################################################# ## ## ## dclient configuration file for submitting EOP series from VLBI ## ## NEOS Intensive experiments from GSFC (GSF) ## ## ## ## 20-NOV-2000 17:07:12 ## ## ## ############################################################################# # DATA_CENTER: CDDISA, NASA/GSFC # DSERVER_EMAIL: dserver@ivscc.gsfc.nasa.gov # FTP_DIR: /home/ftp/pub/eop/ # URL_PREFIX: ftp://gemini.gsfc.nasa.gov/pub/eop/ # EOP_SUFFIX: gsfint01 # MAIL_COMMAND: mailx # CONFIRM_EMAIL: NO # SUCCESS_EMAIL: . # TMP_DIR: /tmp/ # DO_PURGE: YES #!
${MK4_ROOT}/support/make_progsor
cd ${MK4_ROOT}/progs/dclient/ makeInstallation process consists of compiling and linking dclient and creating three executable c-shell programs which facilitate using dclient. They are put in ${MK4_ROOT}/bin directory:
All these programs has syntax: {program name} {file_name}.
These programs are created on the basis of prototype scripts
$MK4_ROOT/local/{analysis_center}.dbs, $MK4_ROOT/local/{analysis_center}.eops,
$MK4_ROOT/local/{analysis_center}.eopi . These files should exist before
installing dclient.
History
1999.09.30 v 0.0 | Beginning of development. |
1999.10.01 v 0.5 | First working version. |
1999.10.04 v 1.0 | First version was released. |
2000.09.21 v 2.0 | Support of EOPS solution type submission was added |
2000.11.20 v 2.1 | Support of EOPI solution type submission was added |
2001.01.10 v 2.2 | Support of -qq flag was added. A bug related to uiseing -q flag was fixed. |
2001.01.16 v 2.3 | Support of -p flag was added |
2002.06.11 v 2.4 | Support of solution types DESC and DSNX is added |
Dclient was developed by Leonid Petrov ( pet@leo.gsfc.nasa.gov ).