home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / database / datamage.arj / HELPFILS.ZIP / AM_INPT.HLP < prev    next >
Encoding:
Text File  |  1991-09-25  |  8.2 KB  |  174 lines
  1. APPLICATIONS MAKER - INPUT SCREEN HELP
  2.  
  3. APPLICATIONS  MAKER is a program that supports the implementation  of
  4. user-designed screens and/or reports.  These APPLICATIONS may be very
  5. simple, or quite complex.
  6.  
  7. With  APPLICATIONS MAKER you are the programmer.  Most  people  don't
  8. know any programming languages and don't want to learn.  That's  why,
  9. within  APPLICATIONS  MAKER, there's no syntax to learn and  no  text
  10. file to write.  Everything is done by simply locating your cursor and
  11. pressing your return (enter) key.
  12.  
  13. The program executes your APPLICATION just like you are reading  this
  14. text.   It  starts at the upper left corner of the INPUT  SCREEN  and
  15. executes each item it finds, moving from left to right and down.   If
  16. you can read this help screen you already understand the format.
  17.  
  18. You  may  divide your INPUT and REPORT screens into  sub-screens  and
  19. multiple  reports.  For information on how to do so see the help  for
  20. the  MISC items on the INPUT screen.  To get this help  screen  press
  21. return on any blank space on the INPUT screen, select MISC item  type
  22. and then press your H key.
  23.  
  24. THE DIALOG BOX and THE DATA DISPLAY AREA:
  25.  
  26. The  DIALOG BOX at the bottom of your screen holds a  mini-menu.   On
  27. it,  you  will see items such as: Scrn, Write, Quit etc.   To  select
  28. these options you press the first letter of their names.
  29.  
  30. The  upper, larger screen area displays your APPLICATION.   When  you
  31. begin an APPLICATION this area is blank.  As you place your items  on
  32. the screen it becomes "populated."  All items necessary to  implement
  33. your APPLICATIONS, both data and control, appear in the data  display
  34. area.  The placement of your items controls when they will execute.
  35.  
  36. INITIALIZING YOUR SCREENS:
  37.  
  38. The  size of both screens is specified during the definition  of  the
  39. application,  but they are initialized a little differently one  from
  40. another.   The INPUT sub-screens are of a fixed width:  seventy-eight
  41. characters.   You  may  use up to one  hundred  sub-screens  in  your
  42. application, and direct control into any of them.
  43.  
  44. The  REPORT,  however, does not have a fixed width.  You may  have  a
  45. wide-carriage  printer; you may opt to use different  print  pitches.
  46. If  your printer supports fifteen characters per inch and your  paper
  47. is  eight  inches  wide  your report  could  be  one  hundred  twenty
  48. characters  in width.  The report width can be set to whatever  value
  49. you desire.
  50.  
  51. When you begin a new application you will be prompted for the  number
  52. of SUB-SCREENS comprising the INPUT screen, and the number of COLUMNS
  53. on the report screen.  These may be INCREASED at any time by  editing
  54. the application, but the screens can never get any smaller.
  55.  
  56. In  order  to quickly display and use your screens they  are  created
  57. when  the application starts.  This necessitates the provision  of  a
  58. space  to store the screens.  Storage of screens is usually  done  in
  59. the computer's memory in order to provide quick access to the data.
  60.  
  61. The  screens may be up to 7,800 characters in width and  1,900  lines
  62. tall.  Simple multiplication of these two numbers gives us 14,820,000
  63. bytes  of storage space for EACH screen.  Since PC  hardware  running
  64. MS-DOS  provides only 65,536 bytes of memory it is easy to  see  that
  65. storing the screens in memory is impossible.
  66.  
  67. When  you begin a new application you must enter a path/filename  for
  68. the  screen  files,  which will be kept on disk.   Suggested  is  the
  69. /MAGE/DBSEFILE directory created by the DATAMAGE installation process
  70. to hold data imported from dBase formatted datafiles.
  71.  
  72. As  of  version 4.0 DATAMAGE does NOT have  multi-user  capabilities.
  73. This  means  that the system runs on ONE computer  and  the  programs
  74. within the system can NOT handle the access of datafiles by more than
  75. one  user  in  a simultaneous manner.   Multi-user  capabilities  are
  76. planned for version 4.4.
  77.  
  78. For  now,  all of your applications can use the  same  screen  files.
  79. These  files will be of the size of your largest application, and  if
  80. they  are used by an application that requires less disk  space  then
  81. only  the first part of the file will be used.  Doing this will  save
  82. you lots of disk space if you run several applications.
  83.  
  84. NAVIGATING ON THE SCREENS:
  85.  
  86. The four arrow keys will move your cursor one space in any direction,
  87. as you would expect.  Holding the shift key down and hitting an arrow
  88. key  will  move approximately one quarter screen  in  any  direction;
  89. holding  the  control  key down will move an  entire  screen  in  any
  90. direction,  provided your screen was defined larger than  one  screen
  91. wide and/or 19 rows tall.
  92.  
  93. HOT KEYS:
  94.  
  95. Pressing  the insert key will place a blank line into your screen  at
  96. the  current cursor position, provided there's no items on  the  last
  97. line of your application.
  98.  
  99. Pressing  the delete key will remove the line at the  current  cursor
  100. position, provided there are no items on that line.
  101.  
  102. Pressing  S (or s) will change the display to the other  screen.   If
  103. your  are viewing the INPUT screen you will go to the REPORT  screen,
  104. and  vice-versa.   The screens look EXACTLY the same, but  the  first
  105. item  in the DIALOG BOX will inform you of the current  display.   Be
  106. certain to check which screen you're on before taking action!
  107.  
  108. Pressing T will test-execute your application.  During test-execution
  109. you will have debugging options not available during execution of the
  110. screen  via  menu option 1, execute.  You may opt  to  redirect  your
  111. normal  disk  output  to the printer, and to  list  any  new  records
  112. written to the printer.
  113.  
  114. Pressing  N will renew the current screen.  If you are  testing  your
  115. application the data you entered will remain in place after your test
  116. is completed.  Press N to get rid of it.
  117.  
  118. Pressing D will open a window in which you will see the user  numeric
  119. array,  or  the user string array.  From this window you  may  assign
  120. names  to your variables and view the data they hold.  The names  are
  121. saved with the application.
  122.  
  123. Pressing P will print the details of the current screen.
  124.  
  125. Pressing Q will terminate processing of the application.
  126.  
  127. Pressing W will record the application to disk.
  128.  
  129. Pressing H will display this help file.
  130.  
  131. INITIALIZING INPUT ITEMS:
  132.  
  133. To   place an item on the input screen you locate the cursor  at  the
  134. position  on the screen where you wish the item to appear, then press
  135. return.   Prompts guide you through the many types of items that  you
  136. may  implement on the screens.  On-screen help is available  for  the
  137. items you will be using.
  138.  
  139. To  edit/move/delete (etc.) an item already on the input  screen  you
  140. place  the   cursor  in any space occupied by  that  item  and  press
  141. return/enter.   You  may also view the status of any screen  item  in
  142. this manner.
  143.  
  144. TESTING YOUR APPLICATIONS:
  145.  
  146. Pressing T or t when in edit mode will test-execute the  application.
  147. The  Test-execution will proceed as if the screen were being used  in
  148. entry  mode.   You  will then have an opportunity  to  re-direct  the
  149. normal   disk  output  to  your  printer,  in  order  to   facilitate
  150. applications testing.
  151.  
  152. It is EXTREMELY important that you create a test environment for your
  153. new  APPLICATIONS.   If you fail to do so you are almost  certain  to
  154. ruin  your datafiles.  Please see the APCNMAKR.DOC file for  detailed
  155. instructions on making/using a test environment.
  156.  
  157. APPLICATION REPORTS:
  158.  
  159. To   help  you keep  track of your applications the   program  prints
  160. reports detailing INPUT screen if activated from the input screen, or
  161. the  REPORT  screen if activated from there.  This  printout  details
  162. each  of the items you have selected, in the order found.   The  data
  163. for  each is the same that is displayed when you place the cursor  on
  164. that item and opt for the item's status.
  165.  
  166. ON-SCREEN HELP:
  167.  
  168. APPLICATIONS MAKER offers on-screen help in several places within the
  169. program.   You  will know when the help is available  by  seeing  the
  170. words  PRESS YOUR H KEY FOR ON-SCREEN HELP centered in the last  line
  171. of  the  dialog box, or seeing the word Help in the dialog  box.   In
  172. either  case  you simply press the H (or h) key.  The  help  will  be
  173. displayed and then you will return to the place in the program  where
  174. you were when you opted for help.