home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR2 / DELIM327.ZIP / QUICKREF.TXT < prev    next >
Text File  |  1993-04-25  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.           QUICK REFERENCE
  8.  
  9.           Program        DELIMIT
  10.           Environment    DOS, Turbo Pascal 3.0 - 7.0
  11.           Author         Roy Grosbach
  12.           Copyright      Copyright 1987-1993 Roy Grosbach
  13.           Date           DELIMIT V3.27 TP7.0 04/25/93
  14.  
  15.           Some of DELIMIT's MANY uses:                  _______
  16.  
  17.             -  Convert a print  file (report printed  to disk) to  a file to  be
  18.                read into  a spread sheet or data base (remove the report headers
  19.                and convert numbers).
  20.  
  21.             -  Convert a fixed format file to a comma (or tab) delimited file.
  22.  
  23.             -  Extract selected  fields (i.e.  totals from a  print file,  to be
  24.                read  into a  spread  sheet  or data  base,  disregard all  other
  25.                fields).
  26.  
  27.             -  Extract selected  fields from  a fixed  record format  (mainframe
  28.                data base) for importing to a data base.
  29.  
  30.             -  Extract selected  fields from  a fixed format  file and  create a
  31.                smaller fixed format file.
  32.  
  33.             -  Reformat a fixed format file  into a different fixed format file.
  34.                (data conversion from one system to another).
  35.  
  36.           The Numeric fields in comma (or  tab) delimited files are expected NOT
  37.           to have commas or other non numeric characters.  The negative  sign is
  38.           expected to be in the first position of the field.  Many reports use a
  39.           negative sign at the last position of the field,  DELIMIT will move it                                                            _______
  40.           to  the front.   Other  reports  use parenthesis  to inclose  negative
  41.           amounts,  which DELIMIT  removes, and  places a  negative sign  in the                          _______
  42.           first position.
  43.  
  44.           Text  fields may  be moved as  is (Move  parameter), or  surrounded by
  45.           double quotes (Character parameter).
  46.  
  47.           Fields  are separated  by  commas,  or by  a  user defined  character,
  48.           (Separator parameter) or  by nothing.  IF  fields are separated by  NO
  49.           character, the  fields are fixed  format.  IF fields  are separated by
  50.           any 'separator', extra spaces are trimmed from the fields.
  51.  
  52.           Records (lines) are separated by CR-LF (Carriage Return-Line Feed), by
  53.           a user defined character (Record separator parameter), or by nothing.
  54.  
  55.           Command line:
  56.             DELIMIT <parmfile> <input file> <output file>
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.           QUICK REFERENCE
  74.  
  75.           Valid PARAMETER TYPES
  76.           * - comment    *    All text is ignored.
  77.  
  78.           H - Header     H    <position> <length> <text>    {comments}
  79.                     text to be excluded (all  lines that match are excluded from
  80.                     conversion).  Up 10 Headers parms.
  81.  
  82.           D - Detail     D    <position> <length> <text>    {Comments}
  83.                     text to be included (ONLY records that match are converted).
  84.                     Up to 10 Detail parms.
  85.  
  86.           N - Numeric    N    <position> <length>           {Comments}
  87.                     Leading  zeros and  commas  are  removed.    Formatting  for
  88.                     negative  numbers  is  removed  and  a  '-'  placed  at  the
  89.                     beginning  of the field.  IF the field separator is Snone or
  90.                     Rnone, then spaces are included to right justify the field.
  91.  
  92.           @ - Signed Numeric  @    <position> <length>      {Comments}
  93.                     Signed fields from  the mainframe replace the  LAST position
  94.                     with a  character that  represents the number  AND the  sign
  95.                     (positive or negative).  Leading  zeros are removed.  IF the
  96.                     field separator is Snone or  Rnone, then spaces are included
  97.                     to right justify the field.
  98.  
  99.           C - Character  C    <position> <length>           {Comments}
  100.                     Surrounds field  with double  quotes.   Trailing blanks  are
  101.                     removed.
  102.  
  103.           M - Move       M    <position> <length>           {Comments}
  104.                     Does  not surround with quotes, trailing spaces are removed.
  105.                     IF  the field  separator is  Snone or  Rnone, then  trailing
  106.                     spaces are NOT removed. 
  107.  
  108.           L - Length     L    <length>                      {Comments}
  109.                     Length of  fixed records  (that have  no CR-LF).   Sometimes
  110.                     data files  from main frames  have no end of  record marker.
  111.                     Can be up to 4000.
  112.  
  113.           S - Separator  S<separator between fields> 
  114.                     Change the field separator from a comma to something else.
  115.  
  116.                **   must NOT have a space between the 'S' and the separator
  117.                          S\nnn - nnn = ASCII code
  118.  
  119.           R - Record Sep R<separator between records>
  120.                     Change the record separator from a CR-LF to something else.
  121.  
  122.                **   must NOT have a space between the 'R' and the separator
  123.                          R\nnn - nnn = ASCII code
  124.  
  125.                **   NOTE Snone or Rnone replaces the separator with NOTHING!
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.