home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / database / pc_comma.zip / PC-COMMA.DOC next >
Text File  |  1987-04-21  |  8KB  |  145 lines
  1.                          PC-COMMA    Version 1.0
  2.                               April 21, 1987
  3.                       Fred Willshaw Software (c) 1987
  4.  
  5.                                Fred Willshaw
  6.                                P.O. Box 32414
  7.                                Charlotte, NC  28232
  8.  
  9.                                CIS 73075,321
  10.  
  11. PC-COMMA is a utility program used to generate a comma delimited file from
  12. an ASCII or Direct file stored on the PC.  Through the use of a control file,
  13. hereafter called a profile, the program outputs a file in comma delimited
  14. format for importation into other software.  This program is useful in
  15. creating input for 1-2-3, Paradox, PC/Datacom, Ideal Escort, etc.  An
  16. example would be to creating a report print file (PRN) in 1-2-3 and then use
  17. this program to create a data file for another program from the PRN file.
  18.  
  19.                           The PROFILE Structure
  20.                           ---------------------
  21.  
  22. The Profile which describes the input and output files is constructed using
  23. the following formats:
  24.  
  25. PROFILE KEY             PROFILE BODY DESCRIPTION                     REQUIRED/
  26.   cc 1-3                       cc 4-80                                DEFAULT
  27. ----------- -------------------------------------------------------- ---------
  28.    DSN     |cc 4-42  Drive\Path\DSN of the input file               |Yes/None
  29.            |cc 43-80 Drive\Path\DSN of the output file              |
  30.        |                                |
  31.            |EX: DSNC:\TEST1\TEST2\FILEA.DAT    DSNA:FILEA.CMA       |
  32.            |    DSNC:\TEST1\TEST2\FILEB.DAT    DSNC:\TEST3\FILEB.CMA|
  33.        |                                |
  34.            |note: you may have up to as many as 50 files which will |
  35.            |      be processed under the same format specifications |
  36.            |      in the group (see the GO command)                 |
  37.        |                                |
  38.    INP     |cc 4-6  Indicates input file type where ASCII files are |No/ASC
  39.            |        indicated with ASC and direct files DIR         |
  40.        |                                   |
  41.            |EX:    INPDIR                                           |
  42.        |                                    |
  43.    HDR     |No additional input required - this card causes PC-COMMA|No/No
  44.            |to produce the first output record with labels created  |
  45.            |from the field label section of the FLD card described  |
  46.            |later.  This is useful when building files for such     |
  47.            |programs as PC/Datacom                                  |
  48.        |                                     |
  49.    LRL     |cc 4-6  Indicates the length of the input records which |No (for
  50.            |        to be processed.  For ASCII files this is       |ASCII)
  51.            |        useful in extracting specific records.  For DIR |Yes (for
  52.            |        files it is required in order for the program   |DIR)/
  53.            |        to read and process the input file              |Actual
  54.            |                                                        |length 
  55.            |                                                        |for ASC
  56.        |                                  |
  57.            |EX:    LRL095                                           |
  58.        |                                  |
  59.    SKP     |cc 4-6  Indicates the number of records to be bypassed  |No/None
  60.            |        when first reading the input file.  Used for    |
  61.            |        such instances as dropping header records, etc. |
  62.        |                                  |
  63.            |EX:    SKP005                                           |
  64.        |                                  |
  65.    DRP     |cc 4-80 Causes records which include the search field   |No/None
  66.            |        in 4-80 to be bypassed.  You may have up to     |
  67.            |        200 DRP entries for each execution group (see   |
  68.            |        the GO command)                                 |
  69.        |                                  |
  70.            |EX:    DRPRALPH NADER                                   |
  71.        |                                    |
  72.    CHG     |cc 4-80 Indicates global search and replace values      |No/None
  73.            |        which are separated by a tilde (~).  You may    |
  74.            |        have up to 200 CHG entries for each execution   |
  75.            |        group (see the GO command).                     |
  76.        |                                 |
  77.            |EX:    CHG~LOSER ~WINNER~                               |
  78.        |                                  |
  79.    ZRO     |No additional input required - indicates whether        |No/blank
  80.            |numeric output fields are output as blank or 0.  If     |
  81.            |this card is present then the output will be 0, if not  |
  82.            |then a blank will be output                             |
  83.        |                                  |
  84.            |EX:    ZRO                                              |
  85.            |                                                        |
  86.    DLM     |CC 4     Indicates the delimiter character to be used   |No/,
  87.            |         if something other than the default comma      |
  88.            |         is used.  If entered and you want the delimiter|
  89.            |         to be a blank enter a blank, it will be        |
  90.            |         interpreted properly                           |
  91.            |                                                        |
  92.            |EX:    DLM#                                             |
  93.        |                                    |
  94.    FLD     |cc 4     Indicates field type for output, C for         |Yes/None
  95.            |         character which will be enclosed with quotes   |
  96.            |         or N for numeric which will not be enclosed    |
  97.            |cc 5-7   Indicates the input record starting position   |
  98.            |         for this field                                 |
  99.            |cc 8-10  Indicates the length of the field in both the  |
  100.            |         input and output record for this field         |
  101.            |cc 11    Indicates with a Y or an N if the field is to  |
  102.            |         have leading and trailing blanks removed       |
  103.            |cc 12-80 Label to be used in conjunction with the HDR   |
  104.            |         card described above                           |
  105.        |                                  |
  106.            |EX:    FLDC001025YLABEL 1                               |
  107.            |       FLDN026007NLABEL 2                               |
  108.        |                                   |
  109.            |         note: you may have up to 200 FLD cards per     |
  110.            |               group (see GO command)                   |
  111.        |                                  |
  112.    GO      |Tells the program to execute all of the Profile commands|Yes/None
  113.            |processed to this point and then clear all internal     |
  114.            |arrays and try to read another set.  If no more sets    |
  115.            |are found the program returns to DOS.  The program does |
  116.            |NOT process the input and output file commands until    |
  117.            |the GO card is encountered.  You must have at least one |
  118.            |GO card, as you can see it must also come at the end of |
  119.            |any group of command cards which describe a different   |
  120.            |file input or output structure.                         |
  121.        |                                  |
  122.            |EX:    GO                                               |
  123.       
  124.                           EXECUTING PC-COMMA
  125.                           ------------------
  126.  
  127. In order to execute PC-COMMA simply enter the DOS command PC-COMMA.  You
  128. will then be asked to supply the Profile dataset name containing the control
  129. cards described above.  If you do not supply a dataset name and depress
  130. ENTER the program will search for the default profile dataset PC-COMMA.PRO.
  131. From there on the program will run without intervention.  Should you desire
  132. to abort the program depress the ESC key.
  133.  
  134. Included in this ARC file are the following modules:
  135.  
  136.                     PC-COMMA.EXE   The executable module
  137.                     PC-COMMA.DOC   This file
  138.                     PC-COMMA.PRO   A sample PROFILE
  139.                     SAMPLE.ASC     A sample ASCII input file
  140.                     SAMPLE.DIR     A sample DIRect input file
  141.  
  142. In order to run the samples, enter the DOS command PC-COMMA and then depress
  143. ENTER when asked for the profile name.  The resulting files created will be
  144. SAMPLE1.CMA and SAMPLE2.CMA. 
  145.