home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / clarion / brokcode.zip / ADREC.EXE / ADDREC.HLP (.txt) < prev    next >
Clarion Help  |  1991-11-30  |  11KB  |  181 lines
  1.  Type in the new statement (string) that you want to use
  2.  with this procedure.
  3.  This statement will either be added or used as a replace-  
  4.  ment using the left margin you enter here.
  5.  Press F2 to abort.
  6. . Press Enter 
  7.  Type in a 2nd new statement (string) that you want to use  
  8.  with this procedure. (or leave blank)
  9.  This statement will either be added or used as a replace-  
  10.  ment using the left margin you enter here.
  11.  Press F2 to abort.
  12. . Press Enter 
  13.  Type in a 3rd new statement (string) that you want to use  
  14.  with this procedure. (or leave blank)
  15.  This statement will either be added or used as a replace-  
  16.  ment using the left margin you enter here.
  17.  Press F2 to abort.
  18. . Press Enter 
  19.  Press F9 to accept the fields and continue with the pro-
  20.  gram.
  21.  Need to adjust records size?  Press F8 from the main pgm.  
  22.  Press F2 to abort or ESC to restart.
  23. . Press Enter 
  24.  Type in a 'Y' if you wish to replace records with line 1.  
  25. Always defaults to 'N'
  26.  Leave blank and press Enter if you are planning to add
  27. but NOT replace records to the file.
  28.  Press F2 to abort or ESC to restart.
  29. . Press Enter 
  30.  Type in the line# that you wish replaced by the string in  
  31.  field #1 or 
  32.  Type in the line# that you wish the string in field #1 to  
  33.  be added after.  The action is set by the 'Y' or 'N' above.
  34.  Press F2 to abort or ESC to restart.
  35. . Press Enter 
  36. MAIN2   
  37.  File sizes here
  38.  -Record pointer
  39.  (before/after)
  40.  .and byte size
  41.  Line or Record No
  42.  +of access here
  43.   appears here
  44. (before/after read) 
  45.  The source lines appear here as they are read 
  46.  Changes are scolled downward from this area 
  47.   1.  Ignore the yes/no field (to be used later by Map Reader).
  48.   2.  Type in the file to process as < filename.cla > or < filename >.
  49.   3.  Include the extension if different than: < .cla >.
  50.   4.  The Map Reader, available soon, will process the entire map structure.  
  51.   5.  Program replaces or adds records by line# and/or InString using the
  52. Ctrl-A and F8 keys and replaces Clarion Error statements with ChkErr(). 
  53. A message appears here at the end of processing
  54. asking if you wish to keep the backup file <filename.old>
  55. You will also be notified if the old and new files
  56. Records to be
  57. do not match total record count
  58. processed
  59. manually
  60. A completed statement appears here
  61. shown here
  62.  1Record
  63.  ;Count
  64. Max No:12
  65.  CSAD (c) 1991 
  66.  Press Enter 
  67. 0O>>11
  68. MAIN3   
  69.   Notes:
  70. The file that you list is read until a change is required.  This record
  71. is then processed and added to a temporary file.  You request changes
  72. with the Ctrl-A Key and set the record length with the F8 Key.  The
  73. ChkErr replacement is done automatically.  See the last Help Page.  The  
  74. temporary file is renamed to the original and a backup file is left in
  75. the directory with the extension of 'OLD'.
  76. You can step through the records by pressing any key multiple times until  
  77. you wish to return to normal by pressing the F3 Key.
  78. If you are hardcoding, place < CHKERR('NAME/LINE#') > AFTER any disk/file  
  79. activity that might error.  EX. IF ERROR() THEN CHKERR('Test01/235').
  80. We were inspired by Mike Hanson's SuperModel and wanted to have this
  81. ability included when hardcoding an application.  Thanks Mike!
  82. Mike's SuperModel already has this capability so you won't need it there.  
  83. If you are a true Designer Buff, try the BoxSoft's Model.  Once it is
  84. mastered you will have many procedures and settings at your finger tips. 
  85. > Press Enter 
  86. e MAIN4   
  87. Installation for Designer:
  88. See the enclosed Test.app.  Include the listed Other Procedures,
  89. verify that DOS1.bin is in your path or directory, process the source,
  90. call AddRec.exe < AddRec >, type in the filename < test.cla > ,
  91. run AddRec, then compile the new *.Cla file(s) and you are finished.
  92. We have also included a single Test2.Pro* that you can run for a sample. 
  93. When the form is entered a Get tries to access record #500 which will
  94. induce an error and pop up the error sign.  This info is then logged
  95. in a file: SaveErr.log that you will find on your disk.  The message
  96. shows the source file, line number of the error, time & date.  A phone
  97. call from a client informing you of the log file info could help solve
  98. his difficulty.
  99. * Test2.pro needs access to DOS1.bin and ChkErr.Pro
  100. The only missing item is a map reader to automate the process for a group  
  101. of *.cla files.  We are working on that as time permits but until then
  102. you could use a batch file with * and ? wildcards to run AddRec.exe.
  103. Important:  The AddRec.exe will make a backup copy to use should
  104. problems occur.
  105. Look for < filename.old >.  Also a
  106. SaveErr.Log file is created for the client for his refer-
  107. ence when calling about a problem.
  108. > Press Enter 
  109. Update Notes dtd 11-30-91
  110. Summary:
  111. 1.  Press F8 at the beginning or end (pause).
  112. 2.  Type in a new length (bytes) for the write .
  113. 3.  Press F9 to accept this change or ESC to abort.
  114. 4.  Press Ctrl-A and type in a replacement string
  115. with the line# or InString you want added/changed.
  116. 5.  Run the AddRec Program.
  117. 5.  Don't forget that you will have a backup copy
  118. in the directory should you need it. (file.old)
  119. String Replacement:  With the Ctrl-A procedure you can specify: add or
  120. replace a record (string) with the string you have
  121. entered in the first field.
  122. ChkErr:
  123. Clarion's standard stop(error()) lines are replaced
  124. automatically with ChkErr.  See the enclosed Readme
  125. file.
  126. Gary Iverson CSAD
  127. 165 Bluffview Dr.
  128. Dakota, Mn. 55925
  129. *A disk cache like smartdrive or pc-cache will speed  
  130. (507)643-6868
  131.      up this program.
  132. > Press Enter 
  133.  The measurement of 80 bytes can be adjusted at will 
  134.  prior to processing.  The normal size of a Designer 
  135.  module is 80.  To see the effect load the module
  136.  with the Editor and check the end of record (lines) 
  137.  If the source code lines are cut short add to this  
  138.  number.  If you have excessive space to the right
  139.  of the records, reduce this number.
  140.  Space clipping begins with this setting.
  141.  The setting is saved in the control file.
  142. & Press Enter 
  143.  Press the F9 Key to accept this length.
  144.  Press F2 to abort or ESC to restart.
  145. . Press Enter 
  146.  Type in the search string that you wish the program to use 
  147.  to identify a record (string).  The action for this search 
  148.  is set by the above 'Y' or 'N'.  You may combine the line# 
  149.  and search string and have action taken using both field
  150.  criterea as a requirement.
  151.  As an example:  If you wished to add < ALERT(F5_KEY) > &
  152. the < ALERT(F6_KEY)
  153. 1. Type ALERT(F5_KEY) in line 1. of this screen.
  154. 2. Type ALERT(F6_KEY) in line 2.  (you could enter
  155. these two together on one line with a ';' separator). 
  156. Add a statement preceeded by a '!' if you wish.
  157. Type these statements with any left margin as this
  158. is how it will be added.  (col 1 is a label)
  159. 3. Set action to 'N' under line one (for add).
  160. 4. Leave line 2. blank.
  161. 5. Enter < ALERT(ACCEPT_KEY) > on line 3.(be specific)
  162. 6. ALERT(F5_KEY) & ALERT(F6_KEY) will be placed
  163. after any line that includes 'ALERT(ACCEPT_KEY)' in
  164. the source module that you are running.
  165. 7. Compile the source.  Try it!
  166.  Press F2 to abort or ESC to restart.
  167. . Press Enter 
  168. ADDLINE 
  169. ADDLINE27
  170. ADDLINE3z
  171. ADD_REC 
  172. DEL_FLAG
  173. LINE_NO 
  174. MAIN    
  175. MAIN2   1
  176. MAIN3   
  177. MAIN4   
  178. MEAS    
  179. PAUSE   
  180. SEARCH  b#
  181.