home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / BCOPY050.ZIP / BBSCOPY.DOC next >
Encoding:
Text File  |  1993-08-07  |  9.6 KB  |  219 lines
  1.  
  2.                                     BBSCOPY
  3.  
  4.                        (From) RA 2.0 FileBase File Copier
  5.  
  6.                                   Version 0.50
  7.  
  8.               Copyright (C) 1992-1993 by Chief Data Recovery Ltd.
  9.  
  10.  
  11.  
  12.                                 IMPORTANT NOTICE
  13.  
  14.             THIS VERSION OF BBSCOPY UTILITY IS A BETA TEST VERSION.
  15.           IF YOU HAVE ANY COMMENTS OR BUG REPORTS ABOUT THIS VERSION
  16.                      PLEASE INFORM THE AUTHOR ABOUT THEM.
  17.  
  18.  
  19.  
  20.   INTRODUCTION
  21.   ▀▀▀▀▀▀▀▀▀▀▀▀▀
  22.      It's been a  long  time now  that i'm  looking for  an idea  for a  new
  23.      program and a  few days ago i talked with a friend who gave me the idea
  24.      of a program which  will make life easier for RemoteAccess SysOps.  The
  25.      idea was simple; Let the  sysop copy  files from  his  BBS file base in
  26.      the easiest way. That's when BBSCopy was born.
  27.  
  28.      The idea behind BBSCopy is very simple. Instead of forcing the sysop to
  29.      look in all his  file  areas  for a specific file,  BBSCopy searches it
  30.      for him.
  31.  
  32.  
  33.   SYSTEM REQUIREMENTS
  34.   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  35.      BBSCopy requires DOS version 2.1 or higher,  about 70KB of free memory,
  36.      PC/XT/286/386/486 or  any  other DOS  compatible machine  and ofcourse,
  37.      RemoteAccess 2.00 BBS with the environment variable RA=  set correctly.
  38.      It is also  recommended  that  SHARE.EXE  will  be  loaded  if  running
  39.      under DesqView.
  40.  
  41.  
  42.   AUTHENTIC VERIFICATION
  43.   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  44.  
  45.     To check if your copy of BBSCopy utility is intact, please use  McAfee's
  46.     VALIDATE utility to check BBSCopy.
  47.     The VALIDATE program should output the following:
  48.  
  49.                             File Name:  BBSCOPY.EXE
  50.                                  Size:  17,541
  51.                                  Date:  8-7-1993
  52.                   File Authentication:
  53.                        Check Method 1 - 0389
  54.                        Check Method 2 - 09F2
  55.  
  56.     If the output of your BBSCopy defers,  please do not use this  copy  and
  57.     inform the author about it as soon as possible.
  58.  
  59.   USAGE
  60.   ▀▀▀▀▀
  61.      BBSCopy requires some  command line parameters to operate.  The command
  62.      line usage for BBSCopy is as follows:
  63.  
  64.      BBSCOPY [@]filemast.ext [destination] [/options]
  65.  
  66.      The 'filemask.ext' parameter specify the file,  or files,  to be copied
  67.      from the BBS file base. This parameter may contain any DOS wildcards.
  68.      If a @ is specified before the file name,  it will be used as a list of
  69.      files to copy. This list must exist and be plain ASCII text and include
  70.      one file name per line. No wildcards are allowed in the @ list.
  71.  
  72.      'destination' is a DOS directory to copy the files to.
  73.  
  74.      '/options' select the operation mode of BBSCopy.  The following options
  75.      are available:
  76.  
  77.      /P   - BBSCopy will pause in each file, displaying it's name and prompt
  78.             if to copy, not copy or quit the program.
  79.      /A   - BBSCopy will list file areas names with each file.
  80.      /S   - Simulate only. BBSCopy will not copy any file.
  81.      /O   - Overwrite target without prompt.  By default BBSCopy will prompt
  82.             before overwriting target files.
  83.      /NC  - Create NOTFOUND.BCP list of not copied files. Active only when
  84.             using a response file and simulation is off.
  85.      /DVn - BBSCopy  will  give 'n' ticks  to DesqView  before each  read or
  86.             write of file  block.  The  'n' may  range  from 0 to  9 where 0
  87.             specifies that  no  ticks  will  be  given  to  DesqView  and  9
  88.             indicates maximum ticks given to DesqView.  The higher the value
  89.             of this number is, the slower BBSCopy will operate. BBSCopy uses
  90.             a default of 1 tick per block.
  91.             This parameter have no effect if running outside DesqView.
  92.  
  93.      The command line parameters are  NOT  case sensitive  and may appear in
  94.      any order  as long as  the destination is specified  anywhare after the
  95.      filemask.
  96.  
  97.      BBSCopy will also  search for an environment variable BBSCOPY= and will
  98.      add it's content to it's command line parameter.
  99.      This may be used  to put a /DVn or /A into BBSCopy command line without
  100.      the need to write  it again  and again.  No  spaces are  allowed in the
  101.      argument of the BBSCOPY variable. For example, to set 5 ticks to DV and
  102.      to list file areas by default,  you must type SET BBSCOPY=/DV5/A before
  103.      running BBSCopy.  The BBSCOPY variable may be override from the command
  104.      line.
  105.  
  106.      HINT: Typing 'BBSCOPY  *.* /S' will actually count all the files on the
  107.            BBS and will also display their total size.
  108.  
  109.      During the copy process,  BBSCopy may be paused by pressing the 'SPACE'
  110.      key, or aborted  by  pressing the  'ESC' key.  In both  cases the  copy
  111.      operation of  the  current  file  will be  completed before  pausing or
  112.      aborting.
  113.  
  114.      BBSCopy will also  copy files  that are  not listed  in the  FILES.BBS.
  115.      Actually, BBSCopy does not use the FILES.BBS in it's operation.
  116.  
  117.      If you need access to DOS from within BBSCopy, you may press '!' at any
  118.      of the program's prompts. BBSCopy will then save the current status and
  119.      will shell to the operating system.  Typeing  EXIT  from  the DOS shell
  120.      will restore the screen and status and will bring you back to the point
  121.      BBSCopy was in.  The '!' key may also be pressed at any time during the
  122.      copy process. BBSCopy will then finish the copy of the current file and
  123.      will shell to DOS.
  124.  
  125.   FEATURES
  126.   ▀▀▀▀▀▀▀▀
  127.      BBSCopy is  fully  DesqView and  SHARE aware,  and  will not  cause any
  128.      sharing  violation  when   operating  under   multitasking  environment
  129.      (provided SHARE.EXE is loaded).
  130.  
  131.      The current version,  0.50, is  a beta  test version  and so it may not
  132.      operate smoothly.  Please inform  the author about any problems or bugs
  133.      you find in it.
  134.  
  135.  
  136.   LEGAL STUFF
  137.   ▀▀▀▀▀▀▀▀▀▀▀
  138.      DOS is copyright of International Business Machines.
  139.      RemoteAccess is copyright of Andrew Milner.
  140.      DesqView is copyright of Quarterdeck Office Systems.
  141.  
  142.  
  143.   WARRANTY
  144.   ▀▀▀▀▀▀▀▀
  145.      The Author of  BBSCopy is  not providing  any warranty whatsoever.  Use
  146.      BBSCopy at your own risk.
  147.  
  148.  
  149.   REGISTRATION
  150.   ▀▀▀▀▀▀▀▀▀▀▀▀
  151.      If you find BBSCopy  of any  use,  and you continue using it,  you must
  152.      register it. BBSCopy registration is for USD $18.
  153.      Please refer to the REGISTER.DOC for more information.
  154.  
  155.  
  156. SUPPORT
  157. ▀▀▀▀▀▀▀
  158.      The author of BBSCopy may be reached in one of the following ways:
  159.  
  160.      ■ Net mail to FidoNet 2:403/138.
  161.  
  162.      ■ BBS: +972-3-966-7562  14.4K V32b/V42b
  163.             +972-3-967-3919  14.4K V32b/V42b
  164.             +972-3-967-3499  14.4K V32b/V42b
  165.  
  166.      ■ FAX: +972-8-403295.
  167.  
  168.      ■ Compuserve ID: 100274,73
  169.  
  170.      ■ P.O.Box 8394
  171.        Rishon Le-Zion 75253
  172.        ISRAEL.
  173.  
  174.  
  175.   HISTORY
  176.   ▀▀▀▀▀▀▀
  177.      Version 0.10 - Jan  2nd, 1992 - Initial Release.
  178.      Version 0.20 - Jan  3ed, 1992 - Removed some delays under DesqView.
  179.                                      Added Total bytes  at end of file list.
  180.                                      Typing a file mask  without   wildcards
  181.                                      will automatically add the propper wild
  182.                                      cards.
  183.                                      A '.' as the    file mask    will    be
  184.                                      translated   to    a   standard   '*.*'
  185.                                      file mask.
  186.                                      Added pause and abort options by
  187.                                      pressing 'SPACE' for pause and 'ESC' to
  188.                                      abort.
  189.                                      Added more error trappings.
  190.      Version 0.30 - Jan  8th, 1992 - Added option to set the ticks  given to
  191.                                      DesqView by   the   /DV  command   line
  192.                                      parameter.
  193.                                      Added option to  copy files  by a  file
  194.                                      list by using  the  @ sign  before  the
  195.                                      list file name.
  196.                                      Added BBSCOPY  environment  variable to
  197.                                      add parameters  to  the  command  line.
  198.                                      Added option to  replace diskettes when
  199.                                      not enough disk space is available.
  200.      Version 0.32 - Jan  8th, 1992 - If  a  target  file  is  already  exist
  201.                                      BBSCopy prompt if to replace it.
  202.                                      Added /O parameter to allow Overwriting
  203.                                      of target files.
  204.                                      DV Delays inserted in all prompts.
  205.                                      BBSCopy will now change the  motor  off
  206.                                      delay to the  maximum  of 14 seconds to
  207.                                      avoid delays under DV. BBSCopy restores
  208.                                      the motor off timer before exiting.
  209.      Version 0.40 - Jan 16th, 1992 - Added option to shell to DOS from any
  210.                                      prompt by pressing the '!' key (Shift-1).
  211.      Version 0.41 - Aug 17th, 1992 - Added /NC option to create a list of not
  212.                                      copied files.
  213.      Version 0.42 - Mar 04th, 1993 - Updated for RA 2.00 file structure.
  214.      Version 0.50 - Aug 07th, 1993 - Fixed bug with copied files were stamped
  215.                                      with current date/time.
  216.  
  217.  
  218.                                  -=≡ EOF ≡=-
  219.