home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR9 / S3DSIZ21.ZIP / S3DSIZ21.DOC < prev   
Text File  |  1993-08-24  |  6KB  |  140 lines
  1. Program:        S3 Delimitted Field Size Utility (DSIZE)
  2. Version:        2.1
  3. Author:         George Spafford
  4. Date:           08/24/93
  5.  
  6. Purpose:
  7.  
  8. To identify the number of records in a file, the maximum and minimum number
  9. of fields in the records encountered as well as the maximum and minimum size
  10. of each field that is encountered.
  11.  
  12. Procedure:
  13.  
  14. There are two .EXE files, DSIZE21.EXE and DSIZE386.EXE.  The first one is aimed
  15. at users with 8088 and 80286 systems.  DSIZE386 is optimized for use with 80386
  16. and above systems.
  17.  
  18. Usage:  DSIZE file.nam delim LogTo
  19.  
  20.                 File.nam        This is the file you want to check.
  21.                 Delim           This is the field delimitter that you want to
  22.                                 use.
  23.                 LogTo           This is the device or file that you want
  24.                                 to log the results to.  It is an optional
  25.                                 parameter.  Devices supported are:  LPT1, LPT2,
  26.                                 LPT3, COM1, COM2, COM3, COM4, SCRN.
  27.                                 Files are opened from scratch each time.  In
  28.                                 other words, the files are created each time -
  29.                                 not appended to.
  30.  
  31.         Example:        DSIZE TEST.FIL ,
  32.  
  33.                         TEST.FIL will be processed using the comma as a field
  34.                         separator.  No Logging will occur.
  35.  
  36.                         DSIZE TEST.FIL , LPT1:
  37.  
  38.                         This will process TEST.FIL using commas as delimitters
  39.                         and will log the results to printer port one.
  40.  
  41.         -----------------------------------------------------------------------
  42.         SPECIAL!  IF YOU SPECIFY THE VERTICAL PIPE ( | ) AS A DELIMITTER ON
  43.         THE COMMAND LINE YOU MUST SPECIFY A LOG TO DEVICE OR FILE.  OTHERWISE,
  44.         DOS WILL INTERPRET THE PIPE AS INDICATING A REDIRECTION!  IF YOU
  45.         ABSOLUTELY DO NOT WANT TO LOG THE DATA, DO NOT RUN THE PROGRAM FROM
  46.         THE COMMAND LINE.
  47.         -----------------------------------------------------------------------
  48.  
  49. If you run DSIZE without any command line options, the program will ask you
  50. for the data file, delimitter and where to log the results to.  Pressing
  51. ENTER alone on the data file will end the program.  Pressing ENTER alone when
  52. specifying where to log data to will disable the logging routine.  Remember,
  53. the screen can only show 36 fields.
  54.  
  55. DSIZE expects records to be terminated with the standard DOS carriage return
  56. (Decimal 10) and line feed (Decimal 13) characters.  You will get an overflow
  57. error message if the records are not thusly delimitted.
  58.  
  59. The program can identify on the screen up to 36 fields per record.  This is a
  60. limitation of the screen size.  The program can handle a theoretical limit of
  61. 1,000 fields per record.
  62.  
  63. For each record that is processed, the program will display the field specs.
  64. At the bottom of the screen, you will see a maximum and minimum field count
  65. spec.  This will tell you if the data file has a variable number of fields.
  66. When customers send me these, it is a hanging offense.  If the MAX and MIN
  67. counts are equal, then you know there is always an equal number of fields.
  68.  
  69. For each field, a minimum and maximum size in bytes is given.  The format:
  70.  
  71.         Field Number:  Min: nnnn  Max: nnnn
  72.  
  73. For some reason, people always change field sizes without telling anybody.
  74. If nothing else, you can use this program to determine the maximum number
  75. of fields and the maximum size for each field rather than importing blindly.
  76.  
  77. History:
  78.  
  79.         v2.1    08/24/93
  80.  
  81.                 Oooops.  For those of you that had more than 36 fields and
  82.                 were getting an Invalid Function message, it was an error in
  83.                 the video routine that I wrote.
  84.  
  85.                 New:    -  The program can handle up to 1,000 fields.
  86.                         -  Results can be logged to a data file or device.
  87.                         -  Corrected the program logic to track fields that
  88.                            are dropped at the end of records.  v2.0 ignored
  89.                            fields that were dropped at the end.
  90.  
  91.         v2.0    08/14/93
  92.  
  93.                 I have completely rewritten the program.
  94.  
  95.         v1.0    Written sometime in the deep, dark past.
  96.  
  97. ============================
  98. Please Register This Program
  99. ============================
  100.  
  101.  
  102. The S3 DSIZE program is distributed as SHAREWARE. It is not Public Domain.
  103. If you find that this program aids you in your work, it must be registered
  104. within 30 days of your first usage of it. Continued use of the program without
  105. paying for it is a violation of the site license and constitutes software
  106. piracy. This product is priced at $10 US per concurrently used copy.
  107.  
  108. Registration of this product will allow me to continue developing
  109. specialized software for you, the consumer, at shareware prices.
  110. Payments (please do not send cash) can be sent to:
  111.  
  112.           George Spafford
  113.           3003 Lakeshore Drive, #216
  114.           St. Joseph, MI 49085
  115.           USA
  116.     
  117.  
  118. I can also be reached on the EXEC-PC BBS and the Channel One BBS.
  119.  
  120. SHAREWARE DISTRIBUTORS:
  121.  
  122. You may distribute this program as long as it is made clear that you are
  123. only a distributor and that the program is not registered until they make
  124. payment to me.  Please do not charge more than $5 per disk to distribute 
  125. SFP to your customers.
  126.  
  127. ::::: Legal :::::
  128.      
  129. DSIZE IS DISTRIBUTED AS IS.  THE AUTHOR (GEORGE SPAFFORD) MAKES
  130. NO WARRANTIES OF APPROPRIATENESS, MERCHANTABILITY OR FITNESS FOR A
  131. PARTICULAR PURPOSE.  THE AUTHOR ASSUMES NO LIABILITY FOR ANY DAMAGES
  132. (INCLUDING LOST PROFITS, WAGES OR ANY OTHER CONSEQUENTIAL OR INCIDENTAL
  133. DAMAGES) ARISING OUT OF THE MISUSE OR INABILITY TO USE THIS PRODUCT.
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.