home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR2 / DELIM327.ZIP / DELIMIT.TXT < prev    next >
Text File  |  1993-04-27  |  65KB  |  1,705 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                                     D E L I M I T
  17.  
  18.                               A File Conversion Utility
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                             Copyright 1993 Roy G Grosbach
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.                                       April 1993
  50.  
  51.  
  52.                                      Version 3.27
  53.  
  54.  
  55.           TABLE OF CONTENTS
  56.  
  57.  
  58.           WHAT IS SHAREWARE . . . . . . . . . . . . . . . . . . . . . .   3
  59.  
  60.           Why DELIMIT . . . . . . . . . . . . . . . . . . . . . . . . .   3              _______
  61.  
  62.           History of DELIMIT  . . . . . . . . . . . . . . . . . . . . .   4                     _______
  63.  
  64.           FUTURE ENHANCEMENTS . . . . . . . . . . . . . . . . . . . . .   5
  65.  
  66.           QUICK REFERENCE . . . . . . . . . . . . . . . . . . . . . . .   6
  67.  
  68.           Parameter File Format . . . . . . . . . . . . . . . . . . . .   8
  69.                Record Selection . . . . . . . . . . . . . . . . . . . .   8
  70.                     Header Parm . . . . . . . . . . . . . . . . . . . .   8
  71.                     Detail Parm . . . . . . . . . . . . . . . . . . . .   8
  72.                Comment  . . . . . . . . . . . . . . . . . . . . . . . .   8
  73.                File Format: . . . . . . . . . . . . . . . . . . . . . .   9
  74.                     Output File . . . . . . . . . . . . . . . . . . . .   9
  75.                          Separator Parm . . . . . . . . . . . . . . . .   9
  76.                          Record Separator Parm  . . . . . . . . . . . .   9
  77.                     Input file  . . . . . . . . . . . . . . . . . . . .   9
  78.                          Length parm  . . . . . . . . . . . . . . . . .   9
  79.                Data Selection . . . . . . . . . . . . . . . . . . . .    10
  80.                     Character Parm  . . . . . . . . . . . . . . . . .    10
  81.                     Move Parm . . . . . . . . . . . . . . . . . . . .    10
  82.                     Number Parm . . . . . . . . . . . . . . . . . . .    11
  83.                     Signed Numeric Parm . . . . . . . . . . . . . . .    11
  84.  
  85.           EXAMPLES  . . . . . . . . . . . . . . . . . . . . . . . . .    12
  86.                BANK1.PAR  . . . . . . . . . . . . . . . . . . . . . .    13
  87.                BANK2.PAR  . . . . . . . . . . . . . . . . . . . . . .    17
  88.                DATE1.PAR  . . . . . . . . . . . . . . . . . . . . . .    20
  89.                DATE2.PAR  . . . . . . . . . . . . . . . . . . . . . .    22
  90.                DATE2MAC.PAR . . . . . . . . . . . . . . . . . . . . .    25
  91.  
  92.           DISCLAIMER - AGREEMENT  . . . . . . . . . . . . . . . . . .    27
  93.  
  94.           SOFTWARE SUPPORT  . . . . . . . . . . . . . . . . . . . . .    28
  95.  
  96.           HARDWARE REQUIREMENTS . . . . . . . . . . . . . . . . . . .    28
  97.  
  98.           REGISTRATION FORM . . . . . . . . . . . . . . . . . . . . .    29
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.                                           2
  112.  
  113.  
  114.           WHAT IS SHAREWARE?
  115.  
  116.           Shareware distribution gives users a chance to try software
  117.           before buying it. If you try a Shareware program and continue
  118.           using it, you are expected to register.  Individual programs
  119.           differ on details -- some request registration while others
  120.           require it, some specify a maximum trial period.  With
  121.           registration, you get anything from the simple right to continue
  122.           using the software to an updated program with printed manual.
  123.  
  124.           Copyright laws apply to both Shareware and commercial software,
  125.           and the copyright holder retains all rights, with a few specific
  126.           exceptions as stated below.  Shareware authors are accomplished
  127.           programmers, just like commercial authors, and the programs are
  128.           of comparable quality.  (In both cases, there are good programs
  129.           and bad ones!)  The main difference is in the method of
  130.           distribution.  The author specifically grants the right to copy
  131.           and distribute the software, either to all and sundry or to a
  132.           specific group.  For example, some authors require written
  133.           permission before a commercial disk vendor may copy their
  134.           Shareware.
  135.  
  136.           Shareware is a distribution method, not a type of software.  You
  137.           should find software that suits your needs and pocketbook,
  138.           whether it's commercial or Shareware.  The Shareware system makes
  139.           fitting your needs easier, because you can try before you buy.
  140.           And because the overhead is low, prices are low also.  Shareware
  141.           has the ultimate money-back guarantee -- if you don't use the
  142.           product, you don't pay for it.
  143.  
  144.  
  145.           Why DELIMIT?              _______
  146.  
  147.           DELIMIT converts fixed format files into DELIMITed files, that          _______
  148.           data bases and spread sheets can read quickly.  DELIMIT filters                                                          _______
  149.           the file, choosing selected fields, eliminating headers from
  150.           reports, or selecting only summary lines from reports.  DELIMIT                                                                  _______
  151.           can also choose selected fields from fixed-format files easily.
  152.  
  153.           Spread sheets can also parse fixed format files, but not as
  154.           quickly as DELIMIT.  DELIMIT can remove header records, or select                     _______   _______
  155.           detail records, spread sheets can not do this, it must be done
  156.           manually.
  157.  
  158.           Data bases can read fixed format files, but can not choose
  159.           selected fields.  This must be done either manually or by writing
  160.           a program.  A program can be written to exclude headers, or
  161.           include summary records - but building a DELIMIT parameter (parm)                                                   _______
  162.           file is faster and easier than writing an entire program.
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.                                           3
  171.  
  172.  
  173.  
  174.           Microsoft Windows users can cut and paste data from a fixed
  175.           format file, or from a report file, but this is slow and tedious.
  176.           If you need to do more than several screens worth of data,
  177.           building a DELIMIT parm file is faster and easier, because you                     _______
  178.           are replacing the cut & paste process.  Once the parm file is
  179.           created it can be used next time you need data from that report
  180.           again.
  181.  
  182.  
  183.           History of DELIMIT                     _______
  184.  
  185.           DELIMIT was created when a friend needed to do some budget          _______
  186.           analysis.  The accounting reports were 100 pages long, and we
  187.           needed to get the department totals into a spread sheet for
  188.           analysis.  There were 3 choices:
  189.             1) Ask the computer operators to create an ad hoc report in a
  190.                difficult to use report writing system, and import it into
  191.                the spread sheet.  They were back logged, so it would have
  192.                taken a couple of weeks, (and the next time the requirements
  193.                would have been different, and we would have to wait weeks
  194.                again.)
  195.             2) Import the entire report into the spread sheet, and delete
  196.                the detail records.  (the spread sheet couldn't handle that
  197.                many lines).
  198.             3) Use a text editor to delete the detail lines, and then
  199.                import it into the spread sheet.  This would have been very
  200.                tedious!
  201.  
  202.           We tested parsing 1 page of the accounting report in a spread
  203.           sheet program.  Reading the text file was quick, but parsing it
  204.           took a long time - it would have literally taken HOURS to parse
  205.           the hundred pages of data we needed.  We didn't need all the
  206.           columns that were included on the report anyway.
  207.  
  208.           DELIMIT v1.00 was created.  We could INCLUDE the records we          _______
  209.           wanted and ignore the rest (Detail parm).  We could also select
  210.           the columns we wanted and ignore the others.  The data was either
  211.           text - surrounded by double quotes, (Character parm) or numbers
  212.           (Number parm).  What would have taken hours to parse took just a
  213.           few minutes using DELIMIT.  The spread sheet program could read                            _______
  214.           the text file quickly, and the time consuming parse was not
  215.           needed.
  216.  
  217.           Several weeks later, we needed to do the same thing, but wanted
  218.           all the detail records for a 20 page section of the report, not
  219.           just the totals.  There was no unique way to identify the detail
  220.           records, but we could identify the records we didn't want.  This
  221.           is when the Header parm was added, to select records to EXCLUDE
  222.           from the processing, and process the rest.
  223.  
  224.           Somewhere along the line, someone else needed to DELIMIT a file,                                                           _______
  225.           but their destination program didn't want text surrounded by
  226.           double quotes.  This is when the Move parameter was created, to
  227.           select the text, but not surround it with double quotes.
  228.  
  229.                                           4
  230.  
  231.  
  232.           Another person saw this and said, "this is great!, but why do I
  233.           have to print the report first, why can't I just copy the data
  234.           file from the mini computer?"  This represented a two changes.
  235.           The first change was that the source file was no longer a report.
  236.           The data file from the mini was fixed format, with NO record
  237.           separators.  This is when the Length parm was created, to be able
  238.           to read files with no record separators.  The second problem was
  239.           that the records were longer than 255 characters.  The input
  240.           buffers can now work with records up to 4000 bytes.
  241.  
  242.           During another project, we needed to bring a data file from a
  243.           main frame tape, to a Macintosh (Mac).  The Mac doesn't
  244.           understand comma delimited files, it doesn't like double quotes
  245.           or Carriage Return - Line Feed (CR-LF) for the record separator
  246.           either.  This produced the Separator parm, to be able to use any
  247.           other character (or string) as a field separator.  This also
  248.           produced the Record separator parm, in able to use any other
  249.           character (or string) as the record separator.
  250.  
  251.           After explaining the program to someone, they said, "how can you
  252.           understand what all those parm files mean?".  This lead to the *
  253.           comment parm, so parm files can be documented.
  254.  
  255.           The latest project has been to acquire data from many diverse
  256.           sources, and import it into a data base.  One mainframe source
  257.           could only supply data on large reel tape.  The numeric fields
  258.           were signed (the last position not a number it is a letter).
  259.           This produced the Signed Numeric field.
  260.  
  261.           It is faster to create one import program, and many DELIMIT parm                                                              _______
  262.           files to create the format we need, than to continue to write new
  263.           import programs for the data base.  Also the research analysts
  264.           don't want to program, but they love to DELIMIT.                                                  _______
  265.  
  266.  
  267.           FUTURE ENHANCEMENTS
  268.  
  269.             -  A constant parm, to add 'constant' data to every record.
  270.                During one project, data is reformatted from a fixed format
  271.                file to be imported into a spread sheet.  For formatting
  272.                purposes, the user wants to create blank columns.  Currently
  273.                we just select an area we know will be blank to give the
  274.                empty field.
  275.  
  276.             -  A record count parm.  Some data by its nature does not have
  277.                unique keys.  A record count parm could be used to create
  278.                unique keys.  Some data bases require a unique key for
  279.                storage reasons.
  280.  
  281.             -  A prettier user interface.
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.                                           5
  289.  
  290.  
  291.           QUICK REFERENCE
  292.  
  293.           Program        DELIMIT
  294.           Environment    DOS, Turbo Pascal 3.0 - 7.0
  295.           Author         Roy Grosbach
  296.           Copyright      Copyright 1987-1993 Roy Grosbach
  297.           Date           DELIMIT V3.27 TP7.0 04/25/93
  298.  
  299.           Some of DELIMIT's MANY uses:                  _______
  300.  
  301.             -  Convert a print file (report printed to disk) to a file to be
  302.                read into a spread sheet or data base (remove the report headers
  303.                and convert numbers).
  304.  
  305.             -  Convert a fixed format file to a comma (or tab) delimited file.
  306.  
  307.             -  Extract selected fields (i.e. totals from a print file, to be
  308.                read into a spread sheet or data base, disregard all other
  309.                fields).
  310.  
  311.             -  Extract selected fields from a fixed record format (mainframe
  312.                data base) for importing to a data base.
  313.  
  314.             -  Extract selected fields from a fixed format file and create a
  315.                smaller fixed format file.
  316.  
  317.             -  Reformat a fixed format file into a different fixed format file.
  318.                (data conversion from one system to another).
  319.  
  320.           The Numeric fields in comma (or tab) delimited files are expected NOT
  321.           to have commas or other non numeric characters.  The negative sign is
  322.           expected to be in the first position of the field.  Many reports use a
  323.           negative sign at the last position of the field,  DELIMIT will move it                                                            _______
  324.           to the front.  Other reports use parenthesis to inclose negative
  325.           amounts, which DELIMIT removes, and places a negative sign in the                         _______
  326.           first position.
  327.  
  328.           Text fields may be moved as is (Move parameter), or surrounded by
  329.           double quotes (Character parameter).
  330.  
  331.           Fields are separated by commas, or by a user defined character,
  332.           (Separator parameter) or by nothing.  IF fields are separated by NO
  333.           character, the fields are fixed format.  IF fields are separated by
  334.           any 'separator', extra spaces are trimmed from the fields.
  335.  
  336.           Records (lines) are separated by CR-LF (Carriage Return-Line Feed), by
  337.           a user defined character (Record separator parameter), or by nothing.
  338.  
  339.           Command line:
  340.             DELIMIT <parmfile> <input file> <output file>
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.                                              6
  348.  
  349.  
  350.           QUICK REFERENCE
  351.  
  352.           Valid PARAMETER TYPES
  353.           * - comment    *    All text is ignored.
  354.  
  355.           H - Header     H    <position> <length> <text>    {comments}
  356.                     text to be excluded (all lines that match are excluded from
  357.                     conversion).  Up 10 Headers parms.
  358.  
  359.           D - Detail     D    <position> <length> <text>    {Comments}
  360.                     text to be included (ONLY records that match are converted).
  361.                     Up to 10 Detail parms.
  362.  
  363.           N - Numeric    N    <position> <length>           {Comments}
  364.                     Leading zeros and commas are removed.  Formatting for
  365.                     negative numbers is removed and a '-' placed at the
  366.                     beginning of the field.  IF the field separator is Snone or
  367.                     Rnone, then spaces are included to right justify the field.
  368.  
  369.           @ - Signed Numeric  @    <position> <length>      {Comments}
  370.                     Signed fields from the mainframe replace the LAST position
  371.                     with a character that represents the number AND the sign
  372.                     (positive or negative).  Leading zeros are removed.  IF the
  373.                     field separator is Snone or Rnone, then spaces are included
  374.                     to right justify the field.
  375.  
  376.           C - Character  C    <position> <length>           {Comments}
  377.                     Surrounds field with double quotes.  Trailing blanks are
  378.                     removed.
  379.  
  380.           M - Move       M    <position> <length>           {Comments}
  381.                     Does not surround with quotes, trailing spaces are removed.
  382.                     IF the field separator is Snone or Rnone, then trailing
  383.                     spaces are NOT removed.
  384.  
  385.           L - Length     L    <length>                      {Comments}
  386.                     Length of fixed records (that have no CR-LF).  Sometimes
  387.                     data files from main frames have no end of record marker.
  388.                     Can be up to 4000.
  389.  
  390.           S - Separator  S<separator between fields>
  391.                     Change the field separator from a comma to something else.
  392.  
  393.                **   must NOT have a space between the 'S' and the separator
  394.                          S\nnn - nnn = ASCII code
  395.  
  396.           R - Record Sep R<separator between records>
  397.                     Change the record separator from a CR-LF to something else.
  398.  
  399.                **   must NOT have a space between the 'R' and the separator
  400.                          R\nnn - nnn = ASCII code
  401.  
  402.                **   NOTE Snone or Rnone replaces the separator with NOTHING!
  403.  
  404.  
  405.  
  406.                                           7
  407.  
  408.  
  409.  
  410.           Parameter File Format
  411.  
  412.           There are four basic types of parameters (parms), Record Selection,
  413.           File Format, Data Selection, and Comments.  The Record Selection parms
  414.           and Data Selection parms need to know the position, and length of a
  415.           field.  The Record selection parms also need to know the position and
  416.           length of a string, to compare with it's "matching string" field.  The
  417.           File Format parms provide new separator characters for the output
  418.           file, and the length parm denotes if the input file has no record
  419.           separators.  The Comment allows the user to document the parm file.
  420.  
  421.           A.   Record Selection:
  422.                Header Parm:
  423.                     Identifies records to be excluded (don't use a record if it
  424.                     matches one of these strings).  There may be up to 10 header
  425.                     parms in a parm file, and they may appear in any order in
  426.                     the file.
  427.  
  428.                Format:
  429.                     H <position> <length> <String to compare> {comments}
  430.  
  431.  
  432.                Detail Parm:
  433.                     Identifies records to be included (use ONLY the records that
  434.                     match one of these strings).  There may be up to 10 detail
  435.                     parms in a parm file, and they may appear in any order in
  436.                     the file.
  437.  
  438.                Format:
  439.                     D <position> <length> <String to compare>  {comments}
  440.  
  441.           B.   Comment:
  442.                Any line in the parm file that begins with a '*' is considered a
  443.                comment, and is ignored.
  444.  
  445.                Format:
  446.                     *
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.                                              8
  466.  
  467.  
  468.           C.   File Format:   Output File:
  469.                Separator Parm:
  470.                     This defines the field separators.  The default field
  471.                     separator is a comma.  Only one Field Separator is allowed
  472.                     per parm file, and it may appear anywhere in the file.
  473.  
  474.                Format:
  475.                     Snone
  476.                          Snone will allow you to have NO field separators.  This
  477.                          is useful when you are reformatting a file, or need to
  478.                          create a fixed format file.  The MOVE and NUMBER parms
  479.                          will NOT remove leading or trailing spaces when Snone
  480.                          is selected, they will when any other record separator
  481.                          is selected.
  482.  
  483.                     S\nnn\nnn...
  484.                          Where \nnn are ASCII character codes.
  485.  
  486.                     S\009
  487.                          To use a TAB for a separator (useful for the Macintosh)
  488.  
  489.  
  490.                Record Separator Parm:
  491.                     This defines the record separators.  The default record
  492.                     separator is a CR-LF.  Only one Record Separator parm is
  493.                     allowed per parm file, and it may appear anywhere in the
  494.                     file.
  495.  
  496.                Format:
  497.                     Rnone
  498.                          Rnone will allow you to have NO record separators.
  499.                          This is useful when you are reformatting a file for a
  500.                          computer system that does not want record separators.
  501.                          The MOVE and NUMBER parms will NOT remove leading or
  502.                          trailing spaces when Rnone is selected, they will when
  503.                          any other record separator is selected.
  504.  
  505.                     R\nnn\nnn...
  506.                          Where \nnn are the ASCII codes of characters.
  507.                     R\013
  508.                          To use a CR for a separator (useful for a Macintosh)
  509.  
  510.  
  511.           Input file:
  512.                Length parm:
  513.                     This is used to define the length of a fixed format file
  514.                     that does NOT have record separators.  Some computer files
  515.                     do not have record separators.
  516.  
  517.                Format:
  518.                     L n  Where n is an integer less than or equal to 4000.
  519.  
  520.  
  521.  
  522.  
  523.  
  524.                                              9
  525.  
  526.  
  527.           D.   Data Selection:
  528.                There may be up to 255 Data Selection parms.  The order of the
  529.                fields in the output file is determined by the order of the parms
  530.                in the parm file (i.e. the first Data Selection parm will be the
  531.                first field in the output file).  The field is based on the
  532.                position, and the length of the field desired.  <length>
  533.                characters are copied, starting at <position>.
  534.  
  535.                NO error checking is done on the input fields.  If an input line
  536.                is shorter than the expected position of a field, the field is
  537.                ignored, and no delimiter is added.  Characters are processed as
  538.                is - the 'correctness' of the output file is the responsibility
  539.                of the user.  The user must insure that the position and length
  540.                fields are correct.  DELIMIT does not generate any warning                                    _______
  541.                messages.
  542.  
  543.  
  544.                Character Parm:
  545.                     The field is surrounded by double quotes.  Trailing spaces
  546.                     in the field are removed.
  547.  
  548.                Format:
  549.                     C <position> <length>    {Comment}
  550.  
  551.  
  552.                Move Parm:
  553.                     The field is NOT surrounded by double quotes.  Trailing
  554.                     spaces are removed.  IF the record separator is RNONE, then
  555.                     trailing spaces are NOT removed (so you can build fixed
  556.                     format files).
  557.  
  558.                Format:
  559.                     M <position> <length>    {Comment}
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.                                             10
  584.  
  585.  
  586.                Number Parm:
  587.                     The field is reformatted.  All non-numeric characters are
  588.                     removed, commas are removed - because they are normally
  589.                     considered field separators in text files. Formatting for
  590.                     negative numbers are eliminated:  A trailing '-' is moved to
  591.                     the beginning of the field.  A field surrounded by brackets
  592.                     '()' has a '-' placed at the beginning of the field.  IF the
  593.                     record separator is RNONE, the field is LEFT filled with
  594.                     leading spaces (so you can build fixed format files).
  595.  
  596.                     If other non-numeric characters are found, DELIMIT DOES NOT                                                               _______
  597.                     report an error.  It is up to the user to make sure the
  598.                     field is defined correctly.
  599.  
  600.                Format:
  601.                     N <position> <length>    {Comment}
  602.  
  603.  
  604.                Signed Numeric Parm:
  605.                     Signed Numeric data comes from mainframes.  The sign AND the
  606.                     value is contained in the last byte of the field.  "A" is a
  607.                     positive 1, "B" is a positive 2 and so on.  The signed
  608.                     numeric parm does all the same reformatting as the Number
  609.                     parm, AND the conversion of the last byte.
  610.  
  611.                     The field is reformatted.  All non-numeric characters are
  612.                     removed, commas are removed - because they are normally
  613.                     considered field separators in text files. Formatting for
  614.                     negative numbers are eliminated:  The last byte is
  615.                     translated.  If it is negative, a '-' is placed at the
  616.                     beginning of the field.  IF the record separator is RNONE,
  617.                     the field is LEFT filled with leading spaces (so you can
  618.                     build fixed format files).
  619.  
  620.                     If other non-numeric characters are found, DELIMIT DOES NOT                                                               _______
  621.                     report an error.  It is up to the user to make sure the
  622.                     field is defined correctly.
  623.  
  624.                Format:
  625.                     @ <position> <length>    {Comment}
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.                                             11
  643.  
  644.  
  645.           EXAMPLES
  646.  
  647.           The examples are designed to demonstrate the functionality of DELIMIT.                                                                         _______
  648.           The following examples can be seen by running the corresponding .BAT
  649.           files.
  650.  
  651.  
  652.           1.   Using the Heading Parm.
  653.                In this example we will extract fields from a printed report
  654.                (printed to disk).  We want to EXCLUDE the report headings.
  655.                EX1.BAT                                                 BANK1.PAR               EX1.BAT                                                 BANK1.PAR
  656.  
  657.           2.   Using the Detail Parm.
  658.                In this example we will extract fields from a printed report
  659.                (printed to disk).  We will use the same input file as example
  660.                number one, but we will INCLUDE just the detail lines.
  661.                EX2.BAT                                                 BANK2.PAR               EX2.BAT                                                 BANK2.PAR
  662.  
  663.           3.   Reformatting a fixed format file.  Field separator is None.
  664.                In this example we will reformat the date field of a fixed format
  665.                record (from YY/MM/DD to MM/DD/YY).  We will leave the rest of
  666.                the record in the same format for later processing.
  667.                EX3.BAT                                                 DATE1.PAR               EX3.BAT                                                 DATE1.PAR
  668.  
  669.           4.   Convert a fixed format record into a comma delimited file.
  670.                We will take selected fields from a fixed format record, and
  671.                convert it into a comma delimited file.  This example uses the
  672.                output of example 3 as the input of this example.
  673.                EX4.BAT                                                 DATE2.PAR               EX4.BAT                                                 DATE2.PAR
  674.  
  675.           5.   Macintosh Example.
  676.                The Macintosh computer uses TABs to separate fields, and a CR
  677.                (not CR-LF) to separate records.  We will use the output file
  678.                created in example 3 as the input of this example.
  679.                EX5.BAT                                              DATE2MAC.PAR               EX5.BAT                                              DATE2MAC.PAR
  680.  
  681.           6.   Creating files with no record separators.
  682.                This example shows how DELIMIT can create files with no record                                      _______
  683.                separators.  We will use the input file from example 3 and
  684.                convert it into a file with no record separators.
  685.                EX6.BAT                                                 DATE6.PAR               EX6.BAT                                                 DATE6.PAR
  686.  
  687.           7.   Reading Files with no record separators.
  688.                We will extract selected fields from the file without record
  689.                separators created in example 6.  Our output file will be TAB
  690.                delimited.
  691.                EX7.BAT                                                 DATE7.PAR               EX7.BAT                                                 DATE7.PAR
  692.  
  693.  
  694.           Examples 6 and 7 are not in the printed documentation.  The files are
  695.           provided on the distribution disk.
  696.  
  697.  
  698.  
  699.  
  700.  
  701.                                             12
  702.  
  703.  
  704.      Example 1.  BANK1.PAR
  705.  
  706.      You work at a bank, and you need to do some analysis on the Adjustable Rate
  707.      Mortgages that your banking software does not perform.  You have several
  708.      options:
  709.           1)   key in the data you need.
  710.           2)   open a terminal session to your banking system, and cut & paste
  711.                the data.  If the data is not in the proper order, or the block
  712.                is large, this is a very tedious process.
  713.           3)   Use DELIMIT.  If you do this analysis more than once, then the                   _______
  714.                work is done for you for the second time.
  715.  
  716.      What do we need to do to the ARM (Adjustable Rate Mortgage) report to move
  717.      the data into a spread sheet?
  718.        -  Remove the report headings
  719.        -  Identify the account number, branch number, change of rate, and
  720.           remaining balance.
  721.  
  722.      There are two ways to identify the report headings and the data fields:
  723.           1)   Print the first page of the report, and use a forms ruler to
  724.                calculate the positions and lengths of the fields.
  725.           2)   Open BANK.TXT with a text editor or word processor that can read
  726.                and write text files and display the position of the cursor so we
  727.                can determine the length of headers, and fields we want to
  728.                capture.  If your editor can have multiple windows open, you can
  729.                jump back and forth between the data file window and the parm
  730.                file window to create your parm file.
  731.  
  732.                The parm file must be a plain ASCII file, most word processors
  733.                can create a plain ASCII file.
  734.  
  735.      INPUT FILE:         BANK.TXT
  736.  
  737.  
  738.  INT110                       FIRST NATIONAL BANK                      PAGE   1
  739.  TIME 19:25              ADJUSTABLE RATE MORTGAGE CHANGES         DATE 12/31/87
  740.  
  741.  ACCOUNT  BR NAME                  MATURE     OLD    CHANGE   NEW      BALANCE
  742.                                               RATE            RATE
  743.  
  744.  123456   01 MYRON MYERS         12/31/2001  10.250  0.250-  10.000   40,392.25
  745.  123847   02 SUSAN SMITH         12/31/1999  11.500  0.250-  11.250   85,934.65
  746.  129087   02 JOHN Q PUBLIC       08/31/2006   9.785  0.215   10.000   36,900.98
  747.  138264   03 ANDREW ANDERSON     01/31/2010   8.375  0.250    8.626  135,968.99
  748.  149821   03 PAUL PUBLIC         07/30/1998  13.250  0.250-  13.000   56,654.15
  749.  298743   04 LEWIS LEAPYEAR      02/29/2004  12.500  0.250-  12.250   12,125.54
  750.  
  751.  
  752.                             E N D   O F   R E P O R T
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.                                           13
  761.  
  762.  
  763.      First, identify this Parm file, so others can easily identify what we are
  764.      trying to do.  Build a 'flower box' of asterisks, and copy in the first
  765.      several lines of the report.  Then add some text describing what we intend
  766.      to do.
  767.  
  768. ********************
  769. *INT110                       FIRST NATIONAL BANK                      PAGE   1
  770. *TIME 19:25              ADJUSTABLE RATE MORTGAGE CHANGES         DATE 12/31/87
  771. ********************
  772. *EXAMPLE BANK1.PAR
  773. *  Ignore the headers
  774. *  Extract the Account number, Branch, Interest rate change,
  775. *              new interest rate and the loan balance.
  776. ********************
  777.  
  778.      We need to identify every heading line so we can eliminate them.  The first
  779.      line can be identified by the word PAGE.  PAGE will probably be in the same
  780.      position for EVERY report generated by this banking system.  PAGE is
  781.      located at the 71st position of the print line, and is 4 characters long.
  782.      Add the line  "H   71  4 PAGE" to the parameter file.
  783.  
  784.  
  785.  INT110                       FIRST NATIONAL BANK                      PAGE   1
  786.  
  787.  
  788.      The second header line can be identified by the word TIME.  Just as with
  789.      PAGE, TIME will probably be in the same position for EVERY report generated
  790.      by this system.  TIME is located in the 1st position of the print line and
  791.      is 4 characters long.
  792.      Add the line "H   1   4  TIME" to the parameter file.
  793.  
  794.  
  795.  TIME 19:25              ADJUSTABLE RATE MORTGAGE CHANGES         DATE 12/31/87
  796.  
  797.  
  798.  
  799.      The third header line can be uniquely identified by the word "ACCOUNT".  It
  800.      is located at the 1st position of the print line and is 7 characters long.
  801.      Add the line "H   1  7 ACCOUNT" to the parameter file.
  802.  
  803.  
  804.  ACCOUNT  BR NAME                  MATURE     OLD    CHANGE   NEW      BALANCE
  805.  
  806.  
  807.      The fourth header line can be identified by the word RATE.  RATE is located
  808.      in the 46th position of the print line and is 4 characters long.
  809.      Add the line "H  46  4 RATE" to the parameter file.
  810.  
  811.  
  812.                                               RATE            RATE
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.                                           14
  820.  
  821.  
  822.      We must not forget the footer on the report.  If it is not identified, then
  823.      this line will also be processed, with unforeseen consequences.  In this
  824.      case it would be a record with blank numeric fields.  To identify a unique
  825.      sequence of characters we can select the entire phrase:
  826.      "E N D   O F   R E P O R T".
  827.  
  828.      The footer is located at the 28th character of the print line and is 25
  829.      characters long.
  830.      Add the line "H  28 25 E N D   O F   R E P O R T" to the parameter file.
  831.  
  832.  
  833.                             E N D   O F   R E P O R T
  834.  
  835.  
  836.      Now we are ready to identify the data we want for further analysis.
  837.  
  838.      The first field is the Account Number.  The Account Number is numeric, but
  839.      it could also have characters in the field, so we should treat it as a
  840.      character field.  Also, a N parm would remove leading zeros.  Account
  841.      Number begins in the 1st column of the print file.  Currently the Account
  842.      Number is 6 characters, but it could grow to be 7 characters.  Add the line
  843.      "C   1  7 Account Number" to the parameter file.
  844.      ("Account Number" is treated as additional comments)
  845.  
  846.      The second field is the branch.  Branch could also have non-numeric data in
  847.      it so treat it as a character field.  The Branch begins in the 10th
  848.      position on the print line and is 2 characters long.
  849.      Add the line "C  10  2 Branch" to the parameter file.
  850.  
  851.      The third field we want is the Change field.  It will ONLY be numeric, and
  852.      the negative sign must be moved to the beginning of the field.  Change
  853.      starts at position 53 and is 6 characters long (including the negative
  854.      sign).
  855.      Add the line "N  53  6 change" to the parameter file.
  856.  
  857.      The fourth field is the New Rate field.  It starts at position 61 and is 6
  858.      characters long.
  859.      Add the line "N  61  6 new rate" to the parameter file.
  860.  
  861.      The last field is the remaining Balance field.  Leading spaces will be
  862.      ignored by numeric fields.  Be sure to define the field to get the largest
  863.      amounts.  To do this, the balance field starts at position 69 of the print
  864.      line and is 10 characters long.
  865.      Add the line "N  69 10 balance" to the parameter file.
  866.  
  867.     1      2                                           3       4         5
  868.  
  869.  123456   01 MYRON MYERS         12/31/2001  10.250  0.250-  10.000   40,392.25
  870.  123847   02 SUSAN SMITH         12/31/1999  11.500  0.250-  11.250   85,934.65
  871.  129087   02 JOHN Q PUBLIC       08/31/2006   9.785  0.215   10.000   36,900.98
  872.  138264   03 ANDREW ANDERSON     01/31/2010   8.375  0.250    8.625  135,968.99
  873.  149821   03 PAUL PUBLIC         07/30/1998  13.250  0.250-  13.000   56,654.15
  874.  298743   04 LEWIS LEAPYEAR      02/29/2004  12.500  0.250-  12.250   12,125.54
  875.  
  876.  
  877.  
  878.                                           15
  879.  
  880.  
  881.      PARAMETER FILE:     BANK1.PAR
  882.  
  883. ********************
  884. *INT110                       FIRST NATIONAL BANK                      PAGE   1
  885. *TIME 19:25              ADJUSTABLE RATE MORTGAGE CHANGES         DATE 12/31/87
  886. ********************
  887. *EXAMPLE BANK1.PAR
  888. *  Ignore the headers
  889. *  Extract the Account number, Branch, Interest rate change,
  890. *              new interest rate and the loan balance.
  891. ********************
  892. H  71  4 PAGE
  893. H   1  4 TIME
  894. H   1  7 ACCOUNT
  895. H  46  4 RATE
  896. H  28 25 E N D   O F   R E P O R T
  897. M   1  6 Account number
  898. M  10  2 Branch
  899. N  53  6 change
  900. N  61  6 new rate
  901. N  69 10 balance
  902. Snone
  903.  
  904.  
  905.  
  906.      OUTPUT FILE:        BANK1.OUT
  907.  
  908. 12345601 -.25010.000  40392.25
  909. 12384702 -.25011.250  85934.65
  910. 12908702  .21510.000  36900.98
  911. 13826403  .250 8.626 135968.99
  912. 14982103 -.25013.000  56654.15
  913. 29874304 -.25012.250  12125.54
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.                                           16
  938.  
  939.  
  940.      Example 2.  BANK2.PAR
  941.  
  942.      Example 2 uses the same input file as example 1.  Instead of using the
  943.      Header parm to exclude header records, it uses the Detail parm to include
  944.      only the detail lines to process.  We can identify the detail lines by the
  945.      fact they all have a maturity date.  The date field always has a '/' at a
  946.      particular place.  No other line in the file has a slash in that position.
  947.  
  948.      INPUT FILE:         BANK.TXT
  949.  
  950.  
  951.  INT110                       FIRST NATIONAL BANK                      PAGE   1
  952.  TIME 19:25              ADJUSTABLE RATE MORTGAGE CHANGES         DATE 12/31/87
  953.  
  954.  ACCOUNT  BR NAME                  MATURE     OLD    CHANGE   NEW      BALANCE
  955.                                               RATE            RATE
  956.  
  957.  123456   01 MYRON MYERS         12/31/2001  10.250  0.250-  10.000   40,392.25
  958.  123847   02 SUSAN SMITH         12/31/1999  11.500  0.250-  11.250   85,934.65
  959.  129087   02 JOHN Q PUBLIC       08/31/2006   9.785  0.215   10.000   36,900.98
  960.  138264   03 ANDREW ANDERSON     01/31/2010   8.375  0.250    8.626  135,968.99
  961.  149821   03 PAUL PUBLIC         07/30/1998  13.250  0.250-  13.000   56,654.15
  962.  298743   04 LEWIS LEAPYEAR      02/29/2004  12.500  0.250-  12.250   12,125.54
  963.  
  964.  
  965.                             E N D   O F   R E P O R T
  966.  
  967.  
  968.  
  969.      First, identify this Parm file, so others can easily identify what we are
  970.      trying to do.  Build a 'flower box' of asterisks, and copy in the first
  971.      several lines of the report.  Then add some text describing what we intend
  972.      to do.
  973.  
  974.  
  975. ********************
  976. *INT110                       FIRST NATIONAL BANK                      PAGE   1
  977. *TIME 19:25              ADJUSTABLE RATE MORTGAGE CHANGES         DATE 12/31/87
  978. ********************
  979. *EXAMPLE BANK2.PAR
  980. *  Use ONLY records that have a '/' in the 35th position
  981. *  (the slash between MM and DD)
  982. *  Extract the Account number, Branch, Interest rate change,
  983. *              new interest rate and the loan balance.
  984. ********************
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.                                           17
  997.  
  998.  
  999.      We only want records that have a '/' in the 35th position.  This is part of
  1000.      the MATURE DATE field.
  1001.      Add the line "D  35  1 /" to the parameter file.
  1002.  
  1003.                                    *
  1004.  123456   01 MYRON MYERS         12/31/2001  10.250  0.250-  10.000   40,392.25
  1005.  123847   02 SUSAN SMITH         12/31/1999  11.500  0.250-  11.250   85,934.65
  1006.  129087   02 JOHN Q PUBLIC       08/31/2006   9.785  0.215   10.000   36,900.98
  1007.  138264   03 ANDREW ANDERSON     01/31/2010   8.375  0.250    8.626  135,968.99
  1008.  149821   03 PAUL PUBLIC         07/30/1998  13.250  0.250-  13.000   56,654.15
  1009.  298743   04 LEWIS LEAPYEAR      02/29/2004  12.500  0.250-  12.250   12,125.54
  1010.  
  1011.  
  1012.                             E N D   O F   R E P O R T
  1013.  
  1014.  
  1015.  
  1016.  
  1017.      The rest of the parms are exactly the same as example 1.  You can either
  1018.      copy them from that file, or follow the instructions from the example, they
  1019.      should look like this:
  1020.  
  1021.      C   1  6 Account number
  1022.      C  10  2 Branch
  1023.      N  53  6 change
  1024.      N  61  6 new rate
  1025.      N  69 10 balance
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.                                           18
  1056.  
  1057.  
  1058.      INPUT FILE:         BANK.TXT
  1059.  
  1060. INT110                       FIRST NATIONAL BANK                      PAGE   1
  1061. TIME 19:25              ADJUSTABLE RATE MORTGAGE CHANGES         DATE 12/31/87
  1062.  
  1063. ACCOUNT  BR NAME                  MATURE     OLD    CHANGE   NEW      BALANCE
  1064.                                              RATE            RATE
  1065.  
  1066. 123456   01 MYRON MYERS         12/31/2001  10.250  0.250-  10.000   40,392.25
  1067. 123847   02 SUSAN SMITH         12/31/1999  11.500  0.250-  11.250   85,934.65
  1068. 129087   02 JOHN Q PUBLIC       08/31/2006   9.785  0.215   10.000   36,900.98
  1069. 138264   03 ANDREW ANDERSON     01/31/2010   8.375  0.250    8.626  135,968.99
  1070. 149821   03 PAUL PUBLIC         07/30/1998  13.250  0.250-  13.000   56,654.15
  1071. 298743   04 LEWIS LEAPYEAR      02/29/2004  12.500  0.250-  12.250   12,125.54
  1072.  
  1073.  
  1074.                            E N D   O F   R E P O R T
  1075.  
  1076.  
  1077.      PARAMETER FILE:     BANK2.PAR
  1078.  
  1079. ********************
  1080. *INT110                       FIRST NATIONAL BANK                      PAGE   1
  1081. *TIME 19:25              ADJUSTABLE RATE MORTGAGE CHANGES         DATE 12/31/87
  1082. ********************
  1083. *EXAMPLE BANK2.PAR
  1084. *  Use ONLY records that have a '/' in the 35th position
  1085. *  (the slash between MM and DD)
  1086. *  Extract the Account number, Branch, Interest rate change,
  1087. *              new interest rate and the loan balance.
  1088. ********************
  1089. D  35  1 /
  1090. C   1  6 Account number
  1091. C  10  2 Branch
  1092. N  53  6 change
  1093. N  61  6 new rate
  1094. N  69 10 balance
  1095.  
  1096.  
  1097.      OUTPUT FILE:        BANK2.OUT
  1098.  
  1099.      "123456","01",-.250,10.000,40392.25
  1100.      "123847","02",-.250,11.250,85934.65
  1101.      "129087","02",.215,10.000,36900.98
  1102.      "138264","03",.250,8.626,135968.99
  1103.      "149821","03",-.250,13.000,56654.15
  1104.      "298743","04",-.250,12.250,12125.54
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.                                           19
  1115.  
  1116.  
  1117.      Example 3.  DATE1.PAR
  1118.  
  1119.      We have received the employee master file from the company mini computer.
  1120.      The date field is in the format (YY/MM/DD).  To convert this file into a
  1121.      comma DELIMITed file is a two step process.  The first step is to reformat
  1122.      the date to (MM/DD/YY) and leave the rest of the record the same (this
  1123.      example).  The second step is to DELIMIT it (example 4).                                      _______
  1124.  
  1125.      INPUT FILE:    DATE.TXT
  1126.  
  1127.  
  1128.  12345662/05/15MYRON    MYERS        123 S 68TH STREET     AURORA      CO01500
  1129.  12384750/12/12SUSAN    SMITH        1955 W ANY STREET     LITTLETOWN  CO01700
  1130.  12908758/06/25JOHN Q   PUBLIC       123 N AMERICAN        DENVER      CO03300
  1131.  13826467/04/30ANDREW   ANDERSON     5633 E OAK            FT COLLINS  CO10000
  1132.  14982155/03/31PAUL     PUBLIC       8934 MAIN #108        DENVER      CO02000
  1133.  29874360/02/29LEWIS    LEAPYEAR     2929 MAPLE DRIVE      GOLDEN      CO02500
  1134.  
  1135.  
  1136.  
  1137.      First, identify this Parm file, so others can easily identify what we are
  1138.      trying to do.  Build a 'flower box' of asterisks, and copy in the first
  1139.      several lines of the report.  Then add some text describing what we intend
  1140.      to do.
  1141.  
  1142.      *******************
  1143.      *Employee master file - from the mini
  1144.      *******************
  1145.      *EXAMPLE DATE1.PAR
  1146.      *  The master file is in a fixed file format.  The date of birth is stored
  1147.      *  in YY/MM/DD format.  The target program doesn't understand this format.
  1148.      *  1)  Move the employee number (6 bytes)
  1149.      *  2)  Move the month and day
  1150.      *  3)  Move the slash
  1151.      *  4)  Move the year (now at the end of the date)
  1152.      *  5)  Move the rest of the data
  1153.      *  6)  USE NO SEPARATORS - so we can use delimit again to break the
  1154.      *      records into fields.
  1155.      ********************
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.                                           20
  1174.  
  1175.  
  1176.      All we want to do is rearrange the fields, so we will only be using the
  1177.      Move parameters.  We must also specify Snone so that no separators are
  1178.      used.
  1179.  
  1180.      The first field is the Employee number.
  1181.      The second field is the month/day.
  1182.      The third field is the slash (to put between the month/day and the year.
  1183.      The forth field is the year.
  1184.      The fifth field is the rest of the record.
  1185.  
  1186.     1  4 3  2                               5
  1187.          *
  1188.  12345662/05/15MYRON    MYERS        123 S 68TH STREET     AURORA      CO01500
  1189.  12384750/12/12SUSAN    SMITH        1955 W ANY STREET     LITTLETOWN  CO01700
  1190.  12908758/06/25JOHN Q   PUBLIC       123 N AMERICAN        DENVER      CO03300
  1191.  13826467/04/30ANDREW   ANDERSON     5633 E OAK            FT COLLINS  CO10000
  1192.  14982155/03/31PAUL     PUBLIC       8934 MAIN #108        DENVER      CO02000
  1193.  29874360/02/29LEWIS    LEAPYEAR     2929 MAPLE DRIVE      GOLDEN      CO02500
  1194.  
  1195.  
  1196.      PARAMETER FILE:     DATE1.PAR
  1197. *******************
  1198. *Employee master file - from the mini
  1199. *******************
  1200. *EXAMPLE DATE1.PAR
  1201. *  The master file is in a fixed file format.  The date of birth is stored
  1202. *  in YY/MM/DD format.  The target program doesn't understand this format.
  1203. *  1)  Move the employee number (6 bytes)
  1204. *  2)  Move the month and day
  1205. *  3)  Move the slash
  1206. *  4)  Move the year (now at the end of the date)
  1207. *  5)  Move the rest of the data
  1208. *  6)  USE NO SEPARATORS - so we can use delimit again to break the
  1209. *      records into fields.
  1210. ********************
  1211. M   1  6  Employee number
  1212. M  10  5  month and day
  1213. M   9  1  slash
  1214. M   7  2  year
  1215. M  15 63  rest of data
  1216. Snone
  1217.  
  1218.  
  1219.      OUTPUT FILE:        DATE1.OUT
  1220.  
  1221. 12345605/15/62MYRON    MYERS        123 S 68TH STREET     AURORA      CO01500
  1222. 12384712/12/50SUSAN    SMITH        1955 W ANY STREET     LITTLETOWN  CO01700
  1223. 12908706/25/58JOHN Q   PUBLIC       123 N AMERICAN        DENVER      CO03300
  1224. 13826404/30/67ANDREW   ANDERSON     5633 E OAK            FT COLLINS  CO10000
  1225. 14982103/31/55PAUL     PUBLIC       8934 MAIN #108        DENVER      CO02000
  1226. 29874302/29/60LEWIS    LEAPYEAR     2929 MAPLE DRIVE      GOLDON      CO02500
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.                                           21
  1233.  
  1234.  
  1235.      Example 4.  DATE2.PAR
  1236.  
  1237.      Now we want to delimit the fields from Example 3 into a comma delimited
  1238.      file.
  1239.  
  1240.      INPUT FILE:    DATE1.OUT
  1241.  
  1242.  
  1243.  12345605/15/62MYRON    MYERS        123 S 68TH STREET     AURORA      CO01500
  1244.  12384712/12/50SUSAN    SMITH        1955 W ANY STREET     LITTLETOWN  CO01700
  1245.  12908706/25/58JOHN Q   PUBLIC       123 N AMERICAN        DENVER      CO03300
  1246.  13826404/30/67ANDREW   ANDERSON     5633 E OAK            FT COLLINS  CO10000
  1247.  14982103/31/55PAUL     PUBLIC       8934 MAIN #108        DENVER      CO02000
  1248.  29874302/29/60LEWIS    LEAPYEAR     2929 MAPLE DRIVE      GOLDEN      CO02500
  1249.  
  1250.  
  1251.  
  1252.      First, identify this Parm file, so others can easily identify what we are
  1253.      trying to do.  Build a 'flower box' of asterisks, and copy in the first
  1254.      several lines of the report.  Then add some text describing what we intend
  1255.      to do.
  1256.  
  1257.  
  1258.      PARAMETER FILE:     DATE2.PAR
  1259.  
  1260.      *******************
  1261.      *Employee master file - from the mini - AFTER THE DATE HAS BEEN REFORMATTED
  1262.      *******************
  1263.      *EXAMPLE DATE2.PAR
  1264.      *  Break the record into fields:
  1265.      *    Employee number, date of birth, first name, last name, address,
  1266.      *    city, state, monthly salary
  1267.      ********************
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.                                           22
  1292.  
  1293.  
  1294.      The first field is the employee number.  Identification numbers should
  1295.      always be treated as character fields.  It starts in the first column, and
  1296.      is 6 characters long.
  1297.      Add the line "C   1  6  Employee number" to the parameter file.
  1298.  
  1299.      The second field is the date.  It starts at column 7 and is 8 characters
  1300.      long.
  1301.      Add the line "C   7  8  date" to the parameter file.
  1302.  
  1303.      The third fields is the first name.  It starts at column 15 and is 9
  1304.      characters long.
  1305.      Add the line "C  15  9  first name" to the parameter file.
  1306.  
  1307.      The forth field is the last name.  It starts at column 24 and is 13
  1308.      characters long.
  1309.      Add the line "C  24 13  last name" to the parameter file.
  1310.  
  1311.      The fifth field is the street address.  It starts at column 37 and is 22
  1312.      characters long.
  1313.      Add the line "C  37 22  address" to the parameter file.
  1314.  
  1315.      The sixth field is the city.  It starts at column 59 and is 12 characters
  1316.      long.
  1317.      Add the line "C  59 12  city" to the parameter file.
  1318.  
  1319.      The seventh field is the state.  It starts at column 71 and is 2 characters
  1320.      long.
  1321.      Add the line "C  71  2  state" to the parameter file.
  1322.  
  1323.      The eight field is the salary field.  It is numeric, and starts at column
  1324.      73 and is 5 characters long.
  1325.      Add the line "C  73  5  monthly salary" to the parameter file.
  1326.  
  1327.  
  1328.      1    2      3        4                 5                6          7  8
  1329.  
  1330.  
  1331.  12345605/15/62MYRON    MYERS        123 S 68TH STREET     AURORA      CO01500
  1332.  12384712/12/50SUSAN    SMITH        1955 W ANY STREET     LITTLETOWN  CO01700
  1333.  12908706/25/58JOHN Q   PUBLIC       123 N AMERICAN        DENVER      CO03300
  1334.  13826404/30/67ANDREW   ANDERSON     5633 E OAK            FT COLLINS  CO10000
  1335.  14982103/31/55PAUL     PUBLIC       8934 MAIN #108        DENVER      CO02000
  1336.  29874302/29/60LEWIS    LEAPYEAR     2929 MAPLE DRIVE      GOLDEN      CO02500
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.                                           23
  1351.  
  1352.  
  1353.      PARAMETER FILE:     DATE2.PAR
  1354.  
  1355. *******************
  1356. *Employee master file - from the mini - AFTER THE DATE HAS BEEN REFORMATED
  1357. *******************
  1358. *EXAMPLE DATE2.PAR
  1359. *  Break the record into fields:
  1360. *    Employee number, date of birth, first name, last name, address,
  1361. *    city, state, monthly salary
  1362. ********************
  1363. C   1  6  Employee number
  1364. C   7  8  date
  1365. C  15  9  first name
  1366. C  24 13  last name
  1367. C  37 22  address
  1368. C  59 12  city
  1369. C  71  2  state
  1370. N  73  5  monthy salary
  1371.  
  1372.  
  1373.  
  1374.      OUTPUT FILE:   DATE2.OUT
  1375.  
  1376. "123456","05/15/62","MYRON","MYERS","123 S 68TH STREET","AURORA","CO",1500
  1377. "123847","12/12/50","SUSAN","SMITH","1955 W ANY STREET","LITTLETOWN","CO",1700
  1378. "129087","06/25/58","JOHN Q","PUBLIC","123 N AMERICAN","DENVER","CO",3300
  1379. "138264","04/30/67","ANDREW","ANDERSON","5633 E OAK","FT COLLINS","CO",10000
  1380. "149821","03/31/55","PAUL","PUBLIC","8934 MAIN #108","DENVER","CO",2000
  1381. "298743","02/29/60","LEWIS","LEAPYEAR","2929 MAPLE DRIVE","GOLDON","CO",2500
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.                                           24
  1410.  
  1411.  
  1412.      Example 5.  DATE2MAC.PAR
  1413.  
  1414.      In this example we are converting the employee master file to be used on a
  1415.      Macintosh computer.  The Macintosh computer uses TAB delimited files, with
  1416.      a CR (not CR-LF) to denote the end of record.
  1417.  
  1418.      We will use the output file generated in example 3 as our input (example 3
  1419.      reformatted a fixed format file).
  1420.  
  1421.      INPUT FILE:    DATE1.OUT
  1422.  
  1423.  
  1424.  12345605/15/62MYRON    MYERS        123 S 68TH STREET     AURORA      CO01500
  1425.  12384712/12/50SUSAN    SMITH        1955 W ANY STREET     LITTLETOWN  CO01700
  1426.  12908706/25/58JOHN Q   PUBLIC       123 N AMERICAN        DENVER      CO03300
  1427.  13826404/30/67ANDREW   ANDERSON     5633 E OAK            FT COLLINS  CO10000
  1428.  14982103/31/55PAUL     PUBLIC       8934 MAIN #108        DENVER      CO02000
  1429.  29874302/29/60LEWIS    LEAPYEAR     2929 MAPLE DRIVE      GOLDEN      CO02500
  1430.  
  1431.  
  1432.      We will copy the parm file from example 4 (comma delimiting the employee
  1433.      master file) and make a few minor adjustments.
  1434.  
  1435.      *******************
  1436.      *Employee master file - from the mini - AFTER THE DATE HAS BEEN REFORMATTED
  1437.      *  TARGET MACHINE IS THE MACINTOSH
  1438.      *******************
  1439.      *EXAMPLE DATE2MAC.PAR
  1440.      *  Break the record into fields:
  1441.      *    Employee number, date of birth, first name, last name, address,
  1442.      *    city, state, monthly salary.
  1443.      *    S\009 is to change the field separators to a TAB (ASCII char 9)
  1444.      *    R\013 is to change the record separators to a CR (ASCII char 13)
  1445.      ********************
  1446.  
  1447.      The 'standard' text files on a Macintosh are different than on a PC.
  1448.      First, the Mac separates fields with TABs, not commas.  It separates
  1449.      records with a CR, not a CR-LF.  It also does NOT surround fields with
  1450.      double quotes.
  1451.  
  1452.      Add the S\009 (field Separator = TAB), R\013 (Record separator = CR), and
  1453.      change the Character parameters to Move parameters.
  1454.  
  1455.      M   1  6  Employee number
  1456.      M   7  8  date
  1457.      M  15  9  first name
  1458.      M  24 13  last name
  1459.      M  37 22  address
  1460.      M  59 12  city
  1461.      M  71  2  state
  1462.      N  73  5  monthly salary
  1463.      S\009
  1464.      R\013
  1465.  
  1466.  
  1467.  
  1468.                                           25
  1469.  
  1470.  
  1471.  
  1472.      PARAMETER FILE:     DATE2MAC.PAR
  1473.  
  1474. *******************
  1475. *Employee master file - from the mini - AFTER THE DATE HAS BEEN REFORMATED
  1476. *  TARGET MACHINE IS THE MACINTOSH
  1477. *******************
  1478. *EXAMPLE DATE2MAC.PAR
  1479. *  Break the record into fields:
  1480. *    Employee number, date of birth, first name, last name, address,
  1481. *    city, state, monthly salary.
  1482. *    S\009 is to change the field separators to a TAB (ASCII char 9)
  1483. *    R\013 is to change the record separators to a CR (ASCII char 13)
  1484. ********************
  1485. M   1  6  Employee number
  1486. M   7  8  date
  1487. M  15  9  first name
  1488. M  24 13  last name
  1489. M  37 22  address
  1490. M  59 12  city
  1491. M  71  2  state
  1492. N  73  5  monthy salary
  1493. S\009
  1494. R\013
  1495.  
  1496.  
  1497.  
  1498.      OUTPUT FILE:        DATE2MAC.OUT
  1499.  
  1500. 123456 05/15/62 MYRON    MYERS     123 S 68TH STREET  AURORA      CO 1500
  1501. 123847 12/12/50 SUSAN    SMITH     1955 W ANY STREET  LITTLETOWN  CO 1700
  1502. 129087 06/25/58 JOHN Q   PUBLIC    123 N AMERICAN     DENVER      CO 3300
  1503. 138264 04/30/67 ANDREW   ANDERSON  5633 E OAK         FT COLLINS  CO 10000
  1504. 149821 03/31/55 PAUL     PUBLIC    8934 MAIN #108     DENVER      CO 2000
  1505. 298743 02/29/60 LEWIS    LEAPYEAR  2929 MAPLE DRIVE   GOLDON      CO 2500
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.                                           26
  1528.  
  1529.  
  1530.           DISCLAIMER - AGREEMENT
  1531.  
  1532.                Users of DELIMIT must accept this disclaimer of warranty:                        _______
  1533.                "DELIMIT is supplied as is.  The author disclaims all warranties,                _______
  1534.                expressed or implied, including, without limitation, the
  1535.                warranties of merchantability and of fitness for any purpose.
  1536.                The author assumes no liability for damages, direct or
  1537.                consequential, which may result from the use of DELIMIT."                                                               _______
  1538.  
  1539.                DELIMIT is a "shareware program" and is provided at no charge to               _______
  1540.                the user for evaluation.  Feel free to share it with your
  1541.                friends, but please do not give it away altered or as part of
  1542.                another system.  The essence of "user-supported" software is to
  1543.                provide computer users with quality software without high prices,
  1544.                and yet to provide incentive for programmers to continue to
  1545.                develop new products.  If you find this program useful and find
  1546.                that you are using DELIMIT and continue to use DELIMIT after a                                  _______                     _______
  1547.                reasonable trial period, you must make a registration payment of
  1548.                $15 to Grosbach Software.  The $15 registration fee will license
  1549.                one copy for use on any one computer at any one time.  You must
  1550.                treat this software just like a book.  An example is that this
  1551.                software may be used by any number of people and may be freely
  1552.                moved from one computer location to another, so long as there is
  1553.                no possibility of it being used at one location while it's being
  1554.                used at another.  Just as a book cannot be read by two different
  1555.                persons at the same time.
  1556.  
  1557.                Commercial users of DELIMIT must register and pay for their                                   _______
  1558.                copies of DELIMIT within 30 days of first use or their license is                         _______
  1559.                withdrawn.  Site-License arrangements may be made by contacting
  1560.                Grosbach Software.
  1561.  
  1562.                Registered Non-profit organizations may use DELIMIT free of                                                           _______
  1563.                charge.
  1564.  
  1565.                Anyone distributing DELIMIT for any kind of remuneration must                                   _______
  1566.                first contact Grosbach Software at the address below for
  1567.                authorization.  This authorization will be automatically granted
  1568.                to distributors recognized by the Association of Shareware
  1569.                Professionals (ASP) as adhering to its guidelines for shareware
  1570.                distributors, and such distributors may begin offering DELIMIT                                                                      _______
  1571.                immediately (However Grosbach Software must still be advised so
  1572.                that the distributor can be kept up-to-date with the latest
  1573.                version of DELIMIT).                          _______
  1574.  
  1575.                You are encouraged to pass a copy of DELIMIT along to your                                                    _______
  1576.                friends for evaluation.  Please encourage them to register their
  1577.                copy if they find that they can use it.
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.                                             27
  1587.  
  1588.  
  1589.           SOFTWARE SUPPORT
  1590.                You will receive three months free support via U.S. Mail or
  1591.                CompuServe, starting from the date your registration is received.
  1592.  
  1593.                If you believe you have discovered a bug, please send a copy of
  1594.                the parm file and data file and a brief description to:
  1595.  
  1596.                US Mail                       or   CompuServe
  1597.                Grosbach Software                  Roy G Grosbach 71562,3251
  1598.                PO Box 80
  1599.                Lewisville, TX 75067
  1600.  
  1601.  
  1602.           HARDWARE REQUIREMENTS
  1603.                A hard disk is not required.
  1604.                Tested on Monochrome, MCGA, and VGA systems.
  1605.                Tested on DOS version 3.30, 4.00, 5.00 and 6.  Should not have
  1606.                problems with version 2.00 or greater.
  1607.  
  1608.  
  1609.           REGISTRATION
  1610.                If you find DELIMIT useful, and continue to use it for more than                           _______
  1611.                30 days, you are required to register your copy.  Please use the
  1612.                enclosed registration form.  You will be granted the right to
  1613.                continue to use DELIMIT.  You will receive three months free                               _______
  1614.                support via U.S. Mail or CompuServe, starting from the date your
  1615.                registration is received.
  1616.  
  1617.  
  1618.                SINGLE USER REGISTRATION: $15 fee.
  1619.  
  1620.                SITE REGISTRATION/CORPORATE REGISTRATION:
  1621.                     1 copy $15
  1622.                     2-10 copies $12.50 for each additional.
  1623.                     11-100 copies $10.00 for each additional
  1624.                     over 100 copies $7.50 for each additional.
  1625.  
  1626.                EXAMPLE:
  1627.                     You have a small business, with 10 people using computers.
  1628.                     In good faith, you estimate at most, 3 people will be using
  1629.                     DELIMIT on a regular basis.  You also want the latest copy                    _______
  1630.                     of DELIMIT.  Your cost would be $15 for the first copy, and                       _______
  1631.                     2 x $12.50 for the additional copies, and $5.00 for the
  1632.                     latest version of DELIMIT on disk for a total of $45.  If                                      _______
  1633.                     you already have the latest version, the $5.00 will be
  1634.                     refunded, or it may be applied towards shipping of the next
  1635.                     version of DELIMIT.                                _______
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.                                             28
  1646.  
  1647.  
  1648.                                  DELIMIT REGISTRATION FORM                                 _______
  1649.  
  1650.  
  1651.           To register your copy of DELIMIT, mail this form with payment of the                                   _______
  1652.           license fee to the address at the bottom of this form.
  1653.  
  1654.           NAME:               _____________________________________________
  1655.  
  1656.           MAILING ADDRESS:    _____________________________________________
  1657.  
  1658.                               _____________________________________________
  1659.  
  1660.                               _____________________________________________
  1661.  
  1662.           COUNTRY:            _____________________________________________
  1663.  
  1664.           VERSION OF DELIMIT: ________
  1665.  
  1666.           AMOUNT         DESCRIPTION
  1667.             $15.00   1  X $15.00   Single User license for DELIMIT                    ___
  1668.           $_______  ___ X $12.50   Additional licenses of DELIMIT (2-10)
  1669.           $_______  ___ X $10.00   Additional licenses of DELIMIT (11-100)
  1670.           $_______  ___ X  $7.50   Additional licenses of DELIMIT (over 100)
  1671.           $_______  ___ X  $5.00   Latest version of DELIMIT on disk
  1672.                                    ___ 5 1/4    ___ 3 1/2
  1673.                                    ___ refunded if you have current version
  1674.                                    ___ send the NEXT version of DELIMIT                                                                _______
  1675.  
  1676.           $_______       Texas residents add the current sales tax amount (1993
  1677.                          = 7.25%)
  1678.  
  1679.           $_______       Total due.
  1680.  
  1681.           Payment:  Please send a check or money order.  Checks and money orders
  1682.                     must be drawn on a US bank in US dollars.
  1683.  
  1684.                     OR register via the CompuServe shareware registration
  1685.                     service.
  1686.  
  1687.           Mail to:  Grosbach Software
  1688.                     Box 80
  1689.                     Lewisville, TX  75067
  1690.                     USA
  1691.  
  1692.           CompuServe:  Roy G Grosbach 71562,3251
  1693.  
  1694.  
  1695.           Thank you for supporting Shareware and DELIMIT.
  1696.  
  1697.           If you have any comments, or suggestions please include them with
  1698.           this registration.
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.                                             29
  1705.