home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / p.lbr / PPIP.HZP / PPIP.HLP
Encoding:
Text File  |  1991-11-18  |  8.4 KB  |  247 lines
  1. ;
  2.                                    PPIP.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5.                5k (37)   EEC7  1.9        Rick Charnes 11/88       Z3COM7
  6.  
  7.   1- Syntax/Options  2- Notes  3- Error Messages  4- Examples of Use          
  8.  
  9.  
  10.  
  11.    PPIP  is  a file copy  program  for  use  across  user  areas,  written  to
  12. supplement SWEEP,  NSWP,  and PIP.  PPIP is best used to copy or backup just a
  13. few files (eliminating the wait for SWEEP,  VFILER,  etc. to load  and start).
  14. Version 1.0 (12/85) by David Jewett, III.
  15. :1
  16.  
  17.   Syntax:  PPIP [du: or dir]<source.typ>[ [du: or dir:][<dest.typ>][ /options]
  18.  
  19.       or   PPIP [[du: or dir:]<dest.typ>=][du: or dir:]<source.typ>[ /options]
  20.  
  21.  
  22.  Options:  /A (off)  <-- copy only unarchived files
  23. (default)  /C (off)  <-- print the CRC value
  24.            /E (off)  <-- delete (Erase) R/W files without asking
  25.            /M (off)  <-- move a file (erase source file after copy)
  26.            /V (off)  <-- do CRC verification
  27.            /W (off)  <-- delete (Wipe) R/W & R/O files without asking
  28.  
  29.    When the 'move' mode is endabled, the /V option is forced on to provide CRC
  30. verification.   If the /V or /M switch is on and the CRC fails,  the copy will 
  31. be retried.
  32. :2
  33.  
  34.  
  35. PPIP Notes:
  36.  
  37.    a. Vs 1.5 has optional DateStamper support to copy datestamp of source file
  38.       to destination.   This is noted in  the  built-in help screen and in the
  39.       verify 'OK' message.
  40.  
  41.    b. Vs 1.8 adds Z80DOS support.  Vs 1.9 provides an interface with the ZCPR3
  42.       error handler.  Aborting with Ctrl-C will set the ZCPR3 error flag to 7,
  43.       if the destination disk is full, the ZCPR3 flag will be set to 8, and if
  44.       the  directory on the destination disk is full,  PPIP will set the error
  45.       flag to 9. 
  46.  
  47.    c. The following patch points are for the NON-ZCPR3 version of PPIP vs 1.8.
  48.       For ZCPR3 versions, add 08H to all addresses.
  49.  
  50.  
  51.     LABEL     LOCATION          PURPOSE         DEFAULT
  52.     ------------------------------------------------------------------------
  53.     TRIGGER equate    specifies the trigger you want to use to     '~'
  54.     in source code      in enter literal control character from the
  55.                         CON:  Note, don't use '^; as trigger since
  56.                      doing so will prevent you from entering
  57.                     the control character '^^'.
  58.  
  59.     SWID            equateyour screen width in characters          80
  60.  
  61.     RETRY  0103H    the number of retrys you want PPIP to attempt      3
  62.                 if CRC verification fails.
  63.  
  64.     MAXDRV 0104h    your maximum accessible drive letter in caps     'P'
  65.  
  66.     MAXUSR 0105H    your maximum accessible user number          15
  67.  
  68.  
  69.  
  70.     SWITCH 0106H    specifies the character to be used to activate     '/'
  71.                  options in the command line
  72.                 line
  73.  
  74.     VERIFY 0108H    the CRC verification option            V - off
  75.  
  76.     REPORT 010AH    the CRC report option (shows value in hex)    C - off
  77.  
  78.     ARCHIV 010CH    the archive option                A - off
  79.  
  80.     EMEND 010EH            the option to allow overwriting R/W  files    E - off
  81.                 without asking
  82.  
  83.     WIPE 0110H            the option to allow erasing of all files    W - off
  84.                 (both R/W and R/O) without asking
  85.  
  86.     MOVF 0112H          the move option                        M - off
  87.  
  88.  
  89.     OPTIONS
  90.     ------------------------------------------------------------------------
  91.     A note regarding the options:  The options table is terminated
  92.     with a zero in the options-character position.  If you want to
  93.     "hard-wire" the options, you can simply terminate the table at
  94.     the appropriate place.  The options status bytes must remain
  95.     intact and must be set the way you want.  For instance, to turn
  96.     the EMEND and WIPE options off permanently, you would substitute
  97.     a zero for the 'E' at 0110H.
  98. :3
  99.  
  100. Error Messages
  101.  
  102.         MESSAGE                  MEANING
  103. --------------------------------   ------------------------------
  104. "<?> - unrecognized option"       you have used an option
  105.                    character that is invalid
  106.  
  107. "Archived"               a copy operation is being
  108.                    skipped because a file has
  109.                    already been archived
  110.  
  111. "bad drive/user spec in <filename>" either the drive or the user
  112.                    area you have specified is out
  113.                    of bounds
  114.  
  115. "Can't close destination"       the destination file has been
  116.                    written but can't be closed
  117.  
  118.  
  119. Error Messages (continued):
  120.  
  121. "Can't copy to same drive/user"    an attempt has been made to
  122.                    write the destination file on
  123.                    top of the source file
  124.  
  125. "can't open source"           the source file has been
  126.                    located but can't be opened
  127.  
  128. "Directory is full"           there is no room left for
  129.                    another entry in the disk
  130.                    directory
  131.  
  132. "Disk full. Deleting file."       the destination file is too
  133. "Disk full. Copy deleted."       big to fit on the specified
  134.                    disk. The partial file will be
  135.                    deleted.
  136.  
  137.  
  138. Error Messages (continued):
  139.  
  140. "Duplicate!"               a copy operation is being
  141.                    skipped because it will over-
  142.                    write the file just written
  143.  
  144. "Exists! Delete?"           the file about to be written
  145. "R/O! Delete?"               exists. You should enter the
  146.                    single character 'Y' or 'N' to
  147.                    indicate whether the file
  148.                    should be deleted.
  149.  
  150. "Ignoring:"               the program will list and
  151.                    ignore all arguments other
  152.                    than the source and
  153.                    destination file names and
  154.                    options.
  155.  
  156.  
  157. Error Messages (continued):
  158.  
  159. "invalid characters in <filename>" you have used an illegal
  160.                    character in the file name.
  161.                    Unacceptable characters are
  162.                    the comma, semi-colon, colon,
  163.                    equals sign, and single and
  164.                    double quotes
  165.  
  166. "No destination file specified"    issued only when CON: is the
  167.                    source file and a destination
  168.                    file name must be specified
  169.  
  170. "no file <filename>"           the file name you have used
  171.                    cannot be found on the
  172.                    specified drive and user area
  173.  
  174.  
  175. Error Messages (continued):
  176.  
  177. "Ok"                   tells you how the CRC check
  178. "failed"               came out
  179.  
  180. "Out of memory"            PPIP puts all the expanded
  181.                    source file names in memory
  182.                    and uses all memory above that
  183.                    for disk buffering. If no
  184.                    memory is left after the
  185.                    source file name is expanded
  186.                    you will get this error
  187.                    message
  188.  
  189. "Please check your disk"       CRC has failed retry + 1 times
  190.                    so something is seriously
  191.                    wrong
  192.  
  193.  
  194. Error Messages (continued):
  195.  
  196. "User abort"               you have used control-C to
  197.                    abort the copy process
  198.  
  199. "verify file open error"       the destination file has been
  200.                    written but can't be reopened
  201.                    for verification
  202.  
  203. "Verifying"               tells you that CRC
  204.                    verification is being done
  205.  
  206. "Wildcards not allowed"        issued only when CON: is the
  207.                    source file. The destination
  208.                    file name must be unambiguous
  209. :4
  210.  
  211.  
  212. Examples of Use:
  213.  
  214.    a. A0>PPIP                           <-- print help menu
  215.  
  216.    b. A0>PPIP B0:*.*                    <-- copy all files on B0: to A0:
  217.  
  218.    c. C8>PPIP A:*.COM 5:*.OBJ           <-- (MS-DOS) copy all .COM files on
  219.                                             A8: to .OBJ files with the same
  220.                                             names on C5:
  221.  
  222.    d. A0>PPIP B15:X*.* C0:Z*.*          <-- (MS-DOS) copy all files on B15:
  223.                                             that start with 'X' to files with
  224.                                             the same names, except starting
  225.                                             with 'Z', on C0:
  226.  
  227.  
  228.  
  229. Examples of Use (continued):
  230.  
  231.    e. B14>PPIP *.* C0:?????BAK.*        <-- (MS-DOS) copy all files on B14:
  232.                                             to C0: and insert the letters
  233.                                             'BAK' at the end of the filename
  234.  
  235.    f. B8>PPIP D0:=A0:KMD.COM            <-- copy the KMD.COM file on A0: to
  236.                                             D0:
  237.  
  238.    g. A0>PPIP D0:=B11:*.?Q?             <-- copy all files with a 'Q' in the
  239.                                             extension that appear on B11: to
  240.                                             D0:
  241.  
  242.    h. A15>PPIP COPY.COM=0:PPIP.COM      <-- copy PPIP.COM on A0: to COPY.COM
  243.                                             on A15:
  244.  
  245.    i. D5>PPIP B0:MYFILE.DOC=CON:        <-- copy console input to MYFILE.DOC
  246.                                             on B0:
  247.