home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / clarion / brokcode.zip / ADREC.EXE / README.1ST < prev    next >
Text File  |  1991-12-01  |  6KB  |  147 lines
  1.  
  2.               NOTE:      FORMERLY DOERROR.EXE
  3.  
  4.                ==================================
  5.                THE AddRec.exe  AND THE ChkErr.CLA
  6.                ==================================
  7.  
  8.  
  9.     To see a sample of what the chkerr module can do, use the enclosed two
  10.     pro modules (with dos1.bin in path or directory).  Select the test.pro
  11.     and run it under the processor.  The chkerr.pro must also be in the same
  12.     directory as test.pro.
  13.  
  14.     To see how the designer portion was set up check the test.app.  3 Other-
  15.     Procedures are all that is needed there.
  16.  
  17.     From start to finish:
  18.  
  19.                For Designer
  20.  
  21.      1.  Create the application in designer
  22.      2.  Add the 3 Other procedures as in the example
  23.      3.  Create the source code but do not compile yet
  24.      4.  Call the AddRec program by typing < AddRec >
  25.      5.  Type in the filename to process (Ex. Test.cla or Test)
  26.      6.  After this process is finished go back to Clarion and NOW
  27.          compile the Cla module(s).
  28.      7.  The program defaults to *.cla but you may specify any extension.
  29.      8.  That is all.
  30.  
  31.                For HardCode
  32.  
  33.      1.  Type in < If error() then ChkErr('test/432'). >    after any
  34.          disk activity or any ???.
  35.      2.  'test' is the name of the module and '432' is the line number
  36.      3.  Make sure you include the quotes around the 'test/432'.
  37.      4.  To replace the < stop(error") >  use:  < ChkErr('test/432') >
  38.      4.  Include the map entries:
  39.  
  40.        ┌──────────────────────────┐
  41.        │   MODULE('CHKERR')          │       !Module Name
  42.        │     PROC(CHKERR)          │       !Shows error location-source/exe
  43.        │     PROC(SAVEERR)          │       !Saves errors in file(log)
  44.        │   .              │
  45.        │   MODULE('DOS1'),BINARY  │       !Clarion DOS1
  46.        │     PROC(GODOS)          │
  47.        │   .              │
  48.        └──────────────────────────┘
  49.  
  50.      4.  Compile the source code
  51.      5.  You are finished.
  52.  
  53.  
  54.     This is a line taken out of the test.cla example that was installed by
  55.     the AddRec.exe :
  56.  
  57.               IF ERROR() THEN CHKERR('TEST/544').
  58.  
  59.   **AddRec replaces < IF ERROR() THEN STOP(ERROR()). >     &  < STOP(ERROR") >
  60.  
  61.     Now this is not really a new item as Mike Hanson's SuperModel and others
  62.     have been doing this for some time.     But I thought it would be nice to
  63.     have it available for those who are not using these models.     It isn't
  64.     much extra work to include the ChkErr function when HardCoding compared
  65.     to the benefits received.
  66.  
  67.     If a program breaks down in the field the error information will be very
  68.     helpful for the programmer trying to determine the cause.  The SaveErr.log
  69.     has the time, date, the error statement, the error code and the source
  70.     file with the line number for the client's reference, when calling.
  71.  
  72.     --------------------------------------------------------------------------
  73.     IMPORTANT NOTE:
  74.  
  75.     AddRec will now allow the user to add or replace 1-3 strings (records) in
  76.     the module being processed.     New records are added after your specified
  77.     line# and/or after the search string you enter with the Ctrl-A procedure.
  78.     Or..... records will be replaced using the same criteria.  A backup file
  79.     will be generated with the extension of 'OLD' and placed into the active
  80.     directory.
  81.  
  82.     Space clipping of the new records will begin with the setting in the
  83.     Control file.  You may change the default of 80 by pressing F8.
  84.  
  85.     You may 'step' through the records by pressing any key after processing
  86.     begins or return to normal with the F3 key.
  87.  
  88.     After processing you will be asked if you wish to view the new file.
  89.     You have many options here if you do.  Just follow the prompts.  You
  90.     can step through the file, line by line, run normally with F3, run slowly
  91.     with F4 or run a dual function with F5.  The dual function scrolls the
  92.     old and the new files and provides an option with the up and down keys
  93.     to adjust the records being scrolled in each window.  We call this the
  94.     Full Screen Mode and messages at the top will help you along. We would
  95.     encourage you to register and obtain the next updated version that will
  96.     have many more options and no restrictions.     See below.
  97.  
  98.     The AddRec.exe/hlp are copyrighted(c) CSAD material.   All rights are
  99.     reserved.
  100.  
  101.     The ChkErr and SaveErr are hereby given out to "public domain" with no
  102.     attachments by CSAD.  If you pass it on please include all of the files
  103.     as you received them:  Errors.Zip
  104.                    
  105.             ControlA.dat (control file)
  106.             ChkErr.cla   (includes SavErr)
  107.             Readme.1st   (this file)
  108.             SaveErr.log  (the log created)
  109.             DoError.exe  (installation program)
  110.             DoError.hlp  (help)
  111.             Test.app     (sample app)
  112.              ┌──Master.dat   (sample pgm)
  113.         These run├──Master.k01    "     "
  114.         together ├──Test.pro    "     "
  115.              └──ChkErr.pro    "     "
  116.  
  117. ===============================================================================
  118.     Gary Iverson, CSAD                     November 25, 1991
  119.       RR 1, Box 10B
  120.       165 BluffView Dr.                     Last Update:
  121.       Dakota, MN.  55925                 12/01/91 vs 3.0
  122.       (507)643-6868/6431
  123.  
  124.       Please register:
  125.  
  126.       For the latest updated version with bug fixes, many more options and
  127.       details; send a check or money order of $49.00 incl s/h to the above
  128.       address.    Specify the disk size that you require and include a full
  129.       address and a phone number, please.  You may also include some ideas
  130.       of your own which we might include in a later version.  You will be
  131.       given credit for any suggestions that we use.
  132.  
  133.       Options included in our next release include adding or changing records
  134.       while in the file viewer, a map reader for processing, memory tables
  135.       for additional speed, and other enhancements.
  136.  
  137.       We thank you.
  138. -------------------------------------------------------------------------------
  139. END OF FILE
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.