home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / CLIPPER / DATABASE / S3DATA10.ZIP / L2R10.DOC < prev    next >
Encoding:
Text File  |  1992-02-27  |  5.4 KB  |  127 lines
  1. Program:        L2R - Line to Record
  2. Version:        1.0
  3. Author:         George Spafford
  4. Date:           February 27, 1992
  5.  
  6. Purpose:
  7.  
  8. To convert 1 line:1 field data to either fixed length or delimitted format.
  9.  
  10. Procedure:
  11.  
  12. To convert a single file:
  13.  
  14. Run L2R and the answer the prompts concerning the input and output file names.
  15. The output file name can be a device if so desired.  The program will then
  16. prompt you for the number of lines to a record.  If it takes eight lines of
  17. source data to make a record, then answer eight to this prompt.
  18.  
  19. The program then asks if you wish to create a delimitted or fixed length ASCII
  20. file.  If you want a fixed length, the program will prompt you for the maximum
  21. length of each field (all fields must be equal to or less than this number) and
  22. it will the process the data.  L2R will display the size of the fixed length
  23. record that it is creating.  If you do not know the length of your longest
  24. field, put a 0 (Zero) in for the record length and L2R will determine the
  25. longest length required.
  26.  
  27. Delimitted asks for a little bit information.
  28.  
  29. One of the first things required for a delimitted file to be created is the
  30. delimitter symbol itself.  This is frequently a comma (,) a pipe (|) or the
  31. colon (:) character.  It can be whatever you want.  This is what will separate
  32. data fields.
  33.  
  34. 0123|BOB|ARLLEY|33 PALM GROVE ROAD|AUGUSTA|MI|49015
  35.  
  36. In this example, the vertical pipe serves as the field delimitter.
  37.  
  38. The next thing it asks is if you want literals or not.  "Literals" occur when
  39. you place text in double quotes thus exempting encapsulated data from any
  40. misinterpretation during the importation process.  For example, if your
  41. delimitter is a comma, and you have a comma in one of your fields, then that
  42. field should be enclosed in double quotes.  Example
  43.  
  44.       9999,Bob,Herowitz,"30001 Rivershore, Apt 339",etc
  45.  
  46. Because of the quotes around the fourth field, the internal comma will be
  47. ignored.  This does depend on your software however.
  48.  
  49.  
  50. The last thing asked, involves the trimming of leading and trailing spaces.  If
  51. you want the spaces removed, answer yes to this prompt.
  52.  
  53. BATCH PROCESSING:
  54.  
  55. L2R can use the L2R.CFG file to store predefined options.  The input and the
  56. output file names can be specified on the command line along with a /B that
  57. tells L2R to do unattended processing.
  58.  
  59.         L2R Input.Dat Output.fix [/B] [/B:Config.fil]
  60.      
  61.  
  62. If /B is used, then L2R.CFG is assumed to be the configuration file.
  63. The L2R.CFG is made up of the following lines:
  64.  
  65.         1.      Lines per record
  66.         2.      Maximum field width or (0) to let the software determine
  67.                 the maximum field length.
  68.         3.      The Delimitter character  (!,|~@# etc)
  69.         4.      L if you want literals or blank if you do not.
  70.         5.      C if you want to compress trailing/Leading spaces or
  71.                 blank if you do not.
  72.  
  73. L2R reads the first 5 bytes of each line of the .CFG file.  If it does not find
  74. the info then it will not process it.  If a delimitter is not found, then the
  75. record format will be assumed to be fixed length.
  76.  
  77. Example:
  78.  
  79. 8        :Lines per input record that will be combined into 1 output rec
  80. 0        :Fixed label width for fixed length records
  81. |        :Field Delimitter (if this field doesn't exist, fixed len is assumed)
  82. L        :Encapsulate Fields with double quotes? (if not fixed len)
  83. C        :Compress leading/trailing blanks from input fields.
  84.  
  85. The above will process 8 field records, NOT fixed length, it will use the
  86. vertical pipe for the delimitter, it will enclose fields with double quotes and
  87. it will compress leading and trailing spaces.
  88.  
  89. /B:config.fil
  90.  
  91. This is for when you may need to process several different types of files.
  92. Config.fil is the name of the configuration file that you want to use.  The
  93. configuration files follow the data format laid out for L2R.CFG.
  94.  
  95. Remember, even if you do not use all 5 lines in the config file, you MUST HOLD
  96. THE LINE OPEN EVEN IF IT IS BLANK.  I recommend just having the first five
  97. characters blank if you do not need the field.
  98.  
  99.         I hope this program helps you evaluate some of your problems
  100.         or even makes some solutions/benefits clear.  This program is
  101.         released as shareware.  Its price is $5 for each concurrently
  102.         used copy.  If you have any suggestions or comments, I'd REALLY
  103.         like to hear those too.
  104.  
  105.                 Sincerely,
  106.  
  107.                 George Spafford
  108.                 3001 LakeShore Drive, #329
  109.                 St. Joseph, MI 49085
  110.  
  111.         Data:  (616) 468-5026  Queued Access BBS 14.4Kb USR Dual HST
  112.                                FIDOnet: 1:2340/0 NEC/NC Site.
  113.                                Sysop:  Tim Akright
  114.  
  115.         And now for the unpleasantries:
  116.  
  117.         Code CopyRight:  February 1992
  118.         
  119.         L2R IS DISTRIBUTED AS IS.  THE AUTHOR (GEORGE SPAFFORD) MAKES NO
  120.         WARRANTY OF ANY KIND, EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED
  121.         TO WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE,
  122.         WITH RESPECT TO THIS SOFTWARE AND DOCUMENTATION. IN NO EVENT SHALL
  123.         THE AUTHOR BE LIABLE FOR ANY DAMAGES, INCLUDING LOST PROFITS, LOST
  124.         SAVINGS, OR ANY OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
  125.         OUT OF THE USE OF OR THE INABILITY TO USE THIS PROGRAM.
  126.         ----------------------------------------------------------------
  127.