home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / CLIPPER / DATABASE / S3DATA10.ZIP / CUT20.DOC < prev    next >
Encoding:
Text File  |  1991-09-02  |  4.0 KB  |  98 lines
  1.                        CUTIt 2.0
  2.  
  3.                   By:  George Spafford
  4.  
  5.                     September 2, 1991
  6.  
  7. Purpose:
  8.  
  9. To convert streamed length record formats to fixed length
  10. record formats by having the user specify the desired fixed
  11. length and then cutting that length sequentially out of the
  12. input record.
  13.  
  14. Procedure:
  15.  
  16. With Version 2.0, users have a much wider range of options available
  17. to them on the command line.  CUT can be invoked as follows:
  18.  
  19. CUT /S:source /T:target /L:nnn /D /N /R
  20.  
  21.     /S:source   "source" is the source file
  22.  
  23.     /T:target   "target" is the destination file
  24.                 You can bypass this if you specify the /R switch.
  25.  
  26.                 If /S: and /T: have the same file names, the /R replace
  27.                 option is assumed.  See /R for further details.
  28.  
  29.     /L:nnn      Here, the user can specify the record length.  This is handy
  30.                 when the user needs a record length that is longer than any
  31.                 of the source records.  "nnn" is the desired length of the
  32.                 output records in terms of bytes (characters).
  33.  
  34.                 /L:nnn must be specified on the command line or the
  35.                 menu will appear and ask you which you want to do.
  36.  
  37.     /D          This switch will cause the program to delete the source file
  38.                 once the destination file has been created (completely, in
  39.                 other words, for a while both files will exist on the disk).
  40.  
  41.     /N          This switch will cause data records to be streamed to the
  42.                 disk.  In other words, CR/LF record delimitters will be
  43.                 bypassed and the records will be written sequentially to the
  44.                 output file.
  45.  
  46.     /R          This switch will instruct the program to replace the source
  47.                 data with the new data once the program has finished.  What
  48.                 happens is that CUT writes a temporary file "CUT$$$.TMP" to
  49.                 the disk with all of the converted records, it then deletes
  50.                 the source file, copies the temporary file to the source file
  51.                 and it then deletes the temporary file.
  52.  
  53. Examples:
  54.  
  55.         The next example modifies the source file with a user-defined length
  56.         of 128 bytes.  (Actually, it writes first to a temporary file and then
  57.         it overwrites the source file with the temporary file).
  58.  
  59.         CUT /S:FIXED.TXT  /R /L:128
  60.  
  61.         The next example will read FIXED.TXT in by 215 byte increments.  It
  62.         will then write to the output file and delete the source file.
  63.  
  64.         CUT /S:FIXED.TXT /T:FIXED.FIX /L:215 /D
  65.  
  66. The program can still be invoked by typing only CUT and then answering the
  67. questions as to the filenames and how you wish to set the record lengths.
  68. However, the menus do not have the file manipulation options that the command
  69. line does.  Note, you can mix command line options and menus.
  70.  
  71. I hope this program helps you evaluate some of your problems
  72. or even makes some solutions/benefits clear.  This program is SHAREWARE.
  73. IT IS NOT PUBLIC DOMAIN.  If you find that this program aids you, you are
  74. required ethically and legally to register it after a 30 day evaluation period.
  75. This software is priced at $5 for each concurrently used copy in an
  76. organization.
  77.  
  78.           Sincerely,
  79.  
  80.           George Spafford
  81.           3001 LakeShore Drive, #329
  82.           St. Joseph, MI 49085
  83.  
  84.          Data:    (616) 468-5026  Queued Access BBS 19200-8-N-1
  85.                   FIDOnet:  1:227/250
  86.  
  87.           And now for the unpleasantries:
  88.  
  89.  
  90.           CUTIT IS DISTRIBUTED AS IS.  THE AUTHOR (GEORGE SPAFFORD)
  91.       MAKES NO WARRANTY OF ANY KIND, EXPRESSED OR IMPLIED,
  92.       INCLUDING BUT NOT LIMITED TO TO WARRANTIES OF MERCHANTABILITY
  93.       OR FITNESS FOR A PARTICULAR PURPOSE, WITH RESPECT TO THIS
  94.       SOFTWARE AND DOCUMENTATION. IN NO EVENT SHALL THE AUTHOR BE
  95.       LIABLE FOR ANY DAMAGES, INCLUDING LOST PROFITS, LOST SAVINGS,
  96.       OR ANY OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT
  97.       OF THE USE OF OR THE INABILITY TO USE THIS PROGRAM.
  98.