home *** CD-ROM | disk | FTP | other *** search
/ CD-ROM Aktief 1995 #3 / CDA3.iso / comm / ts3m.zip / GATHER.TXT < prev    next >
Text File  |  1995-03-03  |  24KB  |  572 lines
  1.  
  2.  
  3.                      The GATHER.TXT           Page 1
  4.  
  5.  
  6.  
  7.  
  8.                      Version 3.01      March, 1995
  9.  
  10.  
  11.                              _______
  12.                         ____|__     |               (R)
  13.                      --|       |    |-------------------
  14.                        |   ____|__  |  Association of
  15.                        |  |       |_|  Shareware
  16.                        |__|   o   |    Professionals
  17.                      -----|   |   |---------------------
  18.                           |___|___|    Member
  19.  
  20.  
  21.  
  22.  
  23.           Gather gathers specified files from specified directories and
  24.           copies, archives, or moves, them to a destination directory.
  25.           This allows one to collect copies of crucial files, such as
  26.           the AUTOEXEC.BAT, or database files, into a central directory
  27.           for transfer to another computer as a backup and for ongoing
  28.           remote maintenance and diagnosis.  You can also use gather as
  29.           a form of ongoing BACKUP, MOVE, or ERASE program by running it
  30.           as a TSR or resident program.  When run as a TSR you can
  31.           direct GATHER to periodically gather files as specified in a
  32.           response file, or on the command line, to a specified
  33.           directory and/or a diskette.  You may discover that gather
  34.           occupies too much ram to be generally kept resident.  If so,
  35.           consider periodically using it in a batch file instead, you
  36.           should find that it is MUCH faster than other software that
  37.           you use for similar purposes.  Gather is command line
  38.           oriented, but the telemenu remote menu program provides a
  39.           mousy menuing (SAA/CUA if you prefer) alternate interface.  If
  40.           you use the resident or tsr option with the remote menu
  41.           program, you can be in a very large program like dBASE IV and
  42.           the menu program will swap dBASE out of RAM and swap itself in
  43.           when you use its hotkey.  See the TELEMENU.TXT for information
  44.           on the remote menu programs.
  45.  
  46.           Please also note that gather is designed so it CAN copy files
  47.           over themselves, which effectively destroys them.  If you wish
  48.           to avoid destroying files, do not copy them over themselves.
  49.           Please note that you can use the Query switch to make gather
  50.           ask before it acts.
  51.  
  52.  
  53.           The Gather command line:
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                      The GATHER.TXT           Page 2
  61.  
  62.  
  63.  
  64.             Usage  Gather  -time -show -clock -tsr @name -fname -d\A_DIR\ ...
  65.  
  66.            -ARCHIVE Archive by default, instead of copying.
  67.            -CLOCK   to display the time.
  68.            -DAYS10  to gather files within the given number of days.
  69.            -D\DIR\  the destination directory (and file when archiving).
  70.            -ERASE   Erases files.  See also Move.
  71.            -Fname   to copy the NAMEd file.  You may use * as in *.dbf.
  72.            -H       this help.  See also the GATHER.TXT.
  73.            -MOVE    Move instead of copy files.
  74.            -N       reName copied files by inserting a number.
  75.            -PATH    to search for files along the PATH.
  76.            -Q       Query.  Ask before acting.  -Q- avoids a query.
  77.            -REDIR   for screen REDIRection to a file.
  78.            -SCATTER to (re)install a list of files, used with @filelist.
  79.            -SHOW    to show filenames during processing.
  80.            -TIME60  the repeat time or delay in seconds between file copying.
  81.            -TSR     to run as a TSR or resident program.
  82.            -UNLOAD  to unload the TSR from RAM.
  83.            [S] [R]  Send or Receive files by serial connection.
  84.            @some_file  use a response file listing the files to copy/move...
  85.  
  86.           If there is 'extra' material left on the command line after
  87.           the above checks, gather tries to use it as a destination
  88.           directory.  You can use "GATHER @FILELIST C:\SOMEDIR\".  If
  89.           you are archiving you can use "GATHER @FILELIST
  90.           C:\SOMEDIR\BACKUP" to specify that the archive filename will
  91.           be "BACKUP".
  92.  
  93.  
  94.           Gather also accepts / as the switch character instead of -.
  95.  
  96.  
  97.  
  98.           These switches are explained further below:
  99.  
  100.           -ARCHIVE to force the default behaviour to archiving instead
  101.           of copying.  This allows you to supply a response file without
  102.           [archive] at the top of the file and have gather archive
  103.           instead of trying to copy the files.  Gather actually also
  104.           accepts -ARCH.
  105.  
  106.           -DAYS10 the number of days to the oldest file to gather.  If a
  107.           file was last changed 9 days ago, and gather is run with
  108.           -DAYS10, the file will be gathered.
  109.  
  110.           -D\dir\ the destination directory.  This tells gather to copy
  111.           the file(s) to that directory.  Its a good idea to include the
  112.  
  113.  
  114.  
  115.  
  116.  
  117.                      The GATHER.TXT           Page 3
  118.  
  119.  
  120.  
  121.           drive as in -dD:\TRANSFER\.  It will yell and quit if the
  122.           destination directory does not exist.  It will also yell if
  123.           the destination file is write protected, hidden, or a system
  124.           file.  Also, if there is 'extra' material left on the command
  125.           line after checking for other switches, it will be checked for
  126.           a destination directory (and filename when archiving).
  127.  
  128.           -Fname to copy the named file.  You may use * as in *.dbf.
  129.           Use this to copy a specific file, such as -fADDRESS.DBF, or a
  130.           group of files, as in -f*.DBF.  Use the @response_file method
  131.           when you want to gather more files or be more specific.  If
  132.           the source file does not exist, gather will silently continue
  133.           to the next file.
  134.  
  135.           -H this help. You may also use /H -?  and ?, or even a blank
  136.           command line.
  137.  
  138.           -N to reName copied files to minimise overwriting previous
  139.           copies.  The renaming inserts a number into the file name,
  140.           with consecutive files having a consecutive number inserted.
  141.           The seed number is based on the current second at the time of
  142.           the start of the copying.  Files ROSTER, SALARY.DBF, and
  143.           WORKS.WKS will be renamed to ROSTER.20, SALARY21.DBF, and
  144.           WORKS22.WKS if copying starts at 11:30:20.  If LASTNAME.DBF
  145.           was the 180th file copied, it would become LASTN200.DBF, since
  146.           20+180 = 200.  Numbers above 999 restart at 0.  Using this
  147.           scheme might appear attractive but it can consume disk space
  148.           rapidly.
  149.  
  150.           -PATH to search along the PATH for one or more files.  This
  151.           instruction tells gather to look through every directory along
  152.           your machine's current path for the file(s).  Some uses of
  153.           this switch are incompatible with other switches, with the
  154.           idea that if you use *.* or the like, then you do not really
  155.           mean to copy every file along the path to the destination
  156.           directory.
  157.  
  158.           -REDIR DOS screen display, to allow redirection to a file.  If
  159.           you are also using -clock, the clock will continue to write
  160.           using the bios, with the program dynamically changing screen
  161.           drivers back to dos after each time update.  A side effect of
  162.           this setting may be a change in gather colours.  The default
  163.           is to use bios output.
  164.  
  165.           -SCATTER can be considered a form of uninstall, reinstall, or
  166.           install.  For example, you might GATHER the AUTOEXEC.BAT,
  167.           CONFIG.SYS, and all the various .INI files in a computer to
  168.           one directory before installing some trial software.  The
  169.  
  170.  
  171.  
  172.  
  173.  
  174.                      The GATHER.TXT           Page 4
  175.  
  176.  
  177.  
  178.           trial software might alter one or more files, but -SCATTER can
  179.           be used to replace the original files.  Gather uses a
  180.           @response_file that indicates the file's original drive and
  181.           directory with the SCATTER command.  Such a file is easily
  182.           created with DIRDBF (as in DIRDBF -path -xf