home *** CD-ROM | disk | FTP | other *** search
/ Piper's Pit BBS/FTP: ibm 0020 - 0029 / ibm0020-0029 / ibm0028.tar / ibm0028 / LAN-UTIL.ZIP / SCOPY.ZIP / SCOPY.DOC < prev    next >
Encoding:
Text File  |  1989-11-21  |  5.7 KB  |  162 lines
  1.  
  2.                               SCOPY Documentation
  3.                               -------------------                  11/20/89
  4.                         (C) Copyright 1989 ARTISOFT, Inc.
  5.  
  6. Description
  7. -----------
  8. SCOPY is a DOS file copy program that allows multiple users on a network,
  9. with SHARE installed, to copy a file at the same time.  Concurrent file
  10. coping is useful in situations where there is a master copy of a file and
  11. many people on the network need to make there own personal copy of the file.
  12.  
  13. SCOPY performs a Sharable COPY of a file by opening the source file in SHARED
  14. mode allowing multiple reads but denying writes to the file during the copy
  15. procedure.  If another program or database has already opened the source file
  16. in a non-shared mode, (default for DOS is that files are opened in
  17. compatibility mode, which prevents all other opens on the file) then SCOPY
  18. will NOT be able to access the file.
  19.  
  20.  
  21. Running SCOPY
  22. -------------
  23. The SCOPY command line is as follows:
  24.  
  25.         Usage is: SCOPY source_file(s)  destination_directory_spec
  26.                   SCOPY @indirect_file  destination_directory_spec
  27.                   Comment characters in indirect file can be !#;'
  28.  
  29. The source file(s) may be specified either as a single file specification
  30. with or without wildcard characters or via an indirect command file containing
  31. a list of file specifications.
  32.  
  33. The destination directory is optional and if omitted will default to the
  34. current drive and directory. A destination file name is not allowed.
  35. SCOPY will use the original source file name for the destination file name.
  36. If the file already exists in the destination directory, it will be
  37. overwritten.
  38.  
  39. The indirect_file must be an ASCII file with one file specification per line.
  40. This file may contain blank lines and comment lines.  Comment lines are
  41. designated by a line that starts with either a ! # ; or '.  That is either
  42. a "bang", "pound_sign", "semicolon" or "single_quote" character.
  43.  
  44.  
  45. Example indirect file FOO.CMD:
  46.  
  47.     ! This is a list of source files for SCOPY
  48.     !
  49.     \DOS\*.COM
  50.     \UTIL\*.EXE
  51.     \DATA\FOO.DAT
  52.  
  53. Then the command: "SCOPY @FOO.CMD  \MYDIR" would copy all files specified
  54. by the three filespecs given in FOO.CMD into "\MYDIR" directory.
  55.  
  56.  
  57. Informative Messages
  58. --------------------
  59. A list of files copied will be displayed as SCOPY processes each one.
  60. If the file is "large", a percentage complete message will be displayed. 
  61.  
  62.  
  63.         SCOPYing...
  64.         .
  65.         . (List of file being copied and percentage complete.)
  66.         .
  67.         SCOPY copied nn file(s)
  68.  
  69.  
  70. Error Messages
  71. --------------
  72. Message: "SCOPY-Error: Incorrect number of arguments"
  73.  
  74. Explanation: There must be one or two arguments specified for SCOPY to run.
  75.  
  76.  
  77. Message: "SCOPY-Error: Destination file name not allowed"
  78.  
  79. Explanation: SCOPY will not change the name of files. Only a directory
  80.              location can be specified.
  81.  
  82.  
  83. Message: "SCOPY-Source file 'FOO.BAZ'"
  84.          "SCOPY-Error: Invalid source file specification"
  85.  
  86. Explanation: Syntax error in source file name.
  87.  
  88.  
  89. Message: "SCOPY-Error: Cannot copy a file to itself"
  90.  
  91. Explanation: A file cannot be copied to itself.  Due to the way files are
  92.              buffered in SCOPY, the file could be truncated if allowed.
  93.  
  94.  
  95. Message: DOS-error "SCOPY-Error: Open failure on source file" or
  96.          DOS-error "SCOPY-Error: Open failure on destination file"
  97.  
  98. Explanation: A DOS-error was detected during the open attempt on the file.
  99.              'DOS-error' is expanded to the actual DOS error message.
  100.  
  101.  
  102. Message: DOS-error "SCOPY-Error: Read error" or
  103.          DOS-error "SCOPY-Error: Write error"
  104.  
  105. Explanation: A DOS-error was detected during a disk read or write operation.
  106.              'DOS-error' is expanded to the acutal DOS error message.
  107.  
  108.  
  109. Message: "SCOPY-Error: READ/WRITE mismatch (Out of Space)"
  110.  
  111. Explanation: The number of bytes read verses written were not the same.
  112.              Most likely the destination device is full.
  113.  
  114.  
  115. Message: DOS-error "SCOPY-Error: Cannot update date/time on output file"
  116.  
  117. Explanation: SCOPY attempts to maintain the source date and time for each
  118.              file.  SCOPY detected a DOS error during this operation.
  119.  
  120.  
  121. Message: DOS-error "SCOPY-Error: Close error on destination file" or
  122.          DOS-error "SCOPY-Error: Close error on source file"
  123.  
  124. Explanation: A DOS error was detected during a DOS file close operation.
  125.              'DOS-error' is expanded to the acutal DOS error message.
  126.  
  127.  
  128. Message: SCOPY-Warning: Output file 'FOO.BAZ' not overwritten
  129.          File 'FOO.BAZ' will not fit on output device.
  130.          Blocks Available: xxxxx
  131.          Blocks Needed: yyyyy
  132.          A-bort SCOPY or R-etry with new media [A,R]:
  133.  
  134. Explanation: SCOPY detected that there was not enough free space including
  135.              the old copy of the file (if it existed) to successfully copy
  136.              the source file to the destination device.  At this time, you
  137.              can abort SCOPY at this point in the file copies or if your
  138.              destination device is a removable media then you could replace
  139.              the floppy/disk with one that has enough free space and have
  140.              SCOPY retry the copy and continue. 
  141.  
  142.  
  143. Message: DOS-error "SCOPY-Error: Can not access destination device"
  144.  
  145. Explanation: SCOPY detected a DOS error while attempting to get amount
  146.               of free space on the destination device.
  147.  
  148.  
  149. Message: "SCOPY-Error: Indirect file 'FOO.CMD'"
  150.          DOS-error "Could not open indirect file"
  151.  
  152. Explanation: A DOS error was detected while attempting to open the indirect
  153.              file.
  154.  
  155.  
  156. Note: The string "DOS-error" is not output, but is expanded to the
  157.       actual DOS error message via 'C'.
  158.  
  159.  
  160.  
  161.  
  162.