home *** CD-ROM | disk | FTP | other *** search
/ ftp.whtech.com / ftp.whtech.com.tar / ftp.whtech.com / club100 / utl / casutl.doc < prev    next >
Text File  |  2006-10-19  |  3KB  |  83 lines
  1.   CASUTL is a file save and load program.  It also verifies what has been saved.
  2.  
  3.   It records time and date on files, and file size on any file.  Date and file
  4.  size are visible only on the files that had been saved previously with CASUTL.
  5.  
  6.   It is downloaded as a Basic program
  7.  listing.  Run it and specify an
  8.  execution address to create the program file CASUTL.CO.
  9.  
  10. Run the program(HIMEM needs to be changed first, if the execution address is
  11.  below HIMEM) and do one of the following:
  12.  
  13.  
  14. ::: Save :::
  15.  
  16. Full file name - 
  17.   The file extension, no matter what it is, is restored when loaded back.
  18.  
  19. A semicolon (;) - 
  20.   Writes a 5 second silence, followed by one byte ;.CO file.  This is
  21.  identified as "gap", when loading and verifying.  Consequently, do not use a
  22.  semicolon as the first character of file names.
  23.  
  24. An asterisk (*) - 
  25.   Saves all files in ram, excluding CASUTL itself.  There is a 3 second silence
  26.  between each file.  After the last file, a one byte ;;.CO file is saved, to
  27.  indicate end of batch, so that the program can know where to stop when
  28.  loading/verifying a batch.
  29.  
  30.  
  31. ::: Load :::
  32.  
  33.  ; -
  34.   Looks for the file name ;.CO, and stops the cassette and prints the message
  35.  "Found - Gap" when it is encountered.
  36.  
  37.  . -
  38.   Loads whatever file comes next, excluding the gap(;.CO)
  39.  
  40.  * - 
  41.   Batch load.  Loads every file on cassette, until file name ;;.CO is
  42.  encountered, or memory runs out.
  43.  
  44.  ? - 
  45.   Looks for text file blocks, and loads  it as file ?.DO.  By adding a file
  46.  name to ?, the text file blocks can be name as, or appended if that file
  47.  already exists.  For example, enter ?MYF to load them as MYF.DO, or append to
  48.  MYF.DO.  This would be useful in recovering parts of a text file lost due to
  49.  IO error in one of the file blocks - if IO error occurs while trying to load
  50.  a text file, the rest of file blocks that come after the point of error cannot
  51.  be loaded, without some trickery.
  52.  
  53.  
  54. ::: Verify :::
  55.  
  56.  ?
  57.   Displays text file blocks until the last block is encountered.
  58.  
  59.  . -
  60.   Verify whatever file comes next.
  61.  
  62.  * -
  63.   Verify all files until ;;.CO is encountered.
  64.  
  65.   Verify is successful if OK message appears, else is not and you will get an
  66.  IO error.
  67.   When verifying text files, its content is echoed on the screen.
  68.  
  69.  
  70.  
  71.   During any of the above three operations, SHIFT-BREAK aborts the current
  72.  operation, reports IO error, and returns to the program menu.
  73.  
  74.   Press ENTER to exit the program - returns to where it was called from.
  75.  
  76.   CASUTL can be called to do a single operation and return, by calling its Top
  77.  location+3.  When calling its Top+3, the parameters are:
  78.  
  79.   CALL N+3,ASC(C$),VARPTR(F$)
  80.  
  81.  N is the Top, C$ is a single command character(F,S,L, or V), and F$ is the
  82.  file name ending with a CHR$(0) - F$=F$+CHR$(0).
  83.