DB_IMPORT                                           db_import  Ver.  2001.01.03

  Program  DB_IMPORT  downloads database files from the IVS Data     
Center to the incoming directory in according with specifications  
from the configuration file.                                       
                                                                   
DB_IMPORT makes the following steps:                               
  1) reads configuration file and checks its parameters            
  2) retrieves list of the database files in the IVS Data Center   
     for the specified period;                                     
  3) gets the list of database files which are in the current      
     catalogue system;                                             
  4) gets the list of database files which are in the incoming     
     directory and may necessarily in the catalogue system;        
  5) reads get_lists and notget_lists which specifies which        
     databases should be downloaded and which databases should not 
     be downloaded. Both lists may contains (and usually contains) 
     wildcard symbols;                                             
  6) generates lists of the databases which are to be downloaded:  
     -- in the IVS Data Center database list  AND                  
     -- not in the current catalogue system   AND                  
     -- not in the incoming directory         AND                  
     -- in the get_list                       AND                  
     -- not in the noget_list.                                     
  7) if this list is empty then end of work. If not then URL list  
     of the databases to be downloaded is build and written in the 
     temporary file. These files are downloaded by using wget      
     program. If database files are compressed by gzip they are    
     uncompressed.                                                 
  8) e-mail message is sent about successful downloading database  
     files to the user specified in the configuration file. End of 
     work.                                                         
                                                                   
     Usage: db_import [-h] -c <config_file> [-v <verbosity>]       
                                                                   
  Options:                                                            
                                                                      
  -h -- if specified then a short help file is printed on the screen. 
  -c -- file name of the configuration file. Refer to                 
        geo_import_01.txt for specifications of the configuration file.
  -v -- (optional) specifies verbosity level. If 1 then               
        informational messages about progress appear on the screen.   
        0 turns on silent mode -- only error messages will be printed.
                                                                      
  DB_IMPORT returns error code 0 if it successfully reach the end of  
  work: successfully downloads files and send e-mail message or it    
  finds that no files should be downloaded. Otherwise it returns      
  non-zero error code and prints the error message on the screen.     


  History:

   pet  1.0   2001.10.19  -- Release of the first version.

   pet  1.1   2001.01.03  -- Corrected subroutine  GET_IVS_DBLIST  in order to 
                             allow it to survive a bug in the IVS Data Center 
                             software discovered on 2001.01.03 -- a dummy file
                             placeholder appeared sometimes in the directories
                             where only database files should appear. This file
                             is certainly not a database and GET_IVS_DBLIST
                             bypasses it without an attempt to interpret.

