home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 5 / 05.iso / a / a040 / 2.ddi / SHRWARE4.ARC / MSAREAD.INC < prev    next >
Encoding:
Text File  |  1988-06-08  |  11.8 KB  |  349 lines
  1. <<* MSAREAD.INC *>>
  2.  
  3. <<procedure GenReadBody>>
  4. <<begin>>
  5.                          MSA_1 TEMPLATES
  6.         COPYRIGHT (C) 1987-1988 BY MicroSearch Associates.
  7.                   ALL RIGHTS RESERVED WORLDWIDE
  8.  
  9.           FOR USE WITH FOXVIEW/VIEWGEN PROGRAM GENERATOR 
  10.                  ON IBM COMPUTERS AND COMPATABLES
  11.  
  12.           This README file contains the system notes and
  13.                        SOFTWARE AGREEMENT.
  14.  
  15.  
  16.  
  17.  
  18. USE CTRL-S TO STOP AND START THE SCROLLING PROCESS AS YOU READ
  19. THIS FILE.
  20.  
  21. You may print this file by using either PRINT.COM (a DOS
  22. utility), your text processor, or use the DOS COPY command as
  23. follows:
  24.  
  25.               A>COPY README.TXT PRN <ENTER>
  26.  
  27. ___________________________________________________________________________
  28. Viewgen is a registered trademark of Software Tools, Inc.
  29. FoxBASE+ is a registered trademark of Fox Software
  30. IBM is a registered trademark of International Business Machines
  31. Corp.
  32.  
  33.  
  34.                            INTRODUCTION
  35.  
  36. Thank you for taking time to examine the MSA_1 templates. The
  37. template and source code are distributed as shareware (see
  38. SOFTWARE AGREEMENT at the end of this document).  Registration
  39. allows continued enhancement of the system and thereby saves all
  40. of us time when developing systems.  The code is based on the
  41. original APPS1 template written by Louis Castro, the creator of
  42. Viewgen.  A large portion of the original system has been
  43. rewritten.
  44.  
  45. Special features of the file system include:
  46.  
  47.      - Use of latest Foxbase+ 2.10 commands.
  48.      - "Pull-down" and "Pop-up" menus.
  49.      - "Pop-up" calendar.
  50.      - User-defined installation.
  51.      - Directory searches.
  52.      - Backup and restore option.
  53.      - Ability to "RUN" external programs.
  54.  
  55.  
  56. Wherever possible, the new commands and features of FOXBASE+
  57. have been implemented to demonstrate their use.  The programs
  58. provide a "MAC"-like interface for the generated programs, which
  59. has become one of the more popular interfaces.  Due to time
  60. constraints, not all features (such as the "pop-up" calculator,
  61. Export and help system) are available and there are a number of
  62. enhancements yet to be made.  Registration will insure that you
  63. receive timely notification of future updates of these templates.
  64.  
  65. Any suggestions you may have to improve the system are
  66. appreciated.
  67.  
  68.  
  69.                            SYSTEM NOTES
  70.  
  71. GENERAL
  72.  
  73. SAMPLE APPLICATION USE:  Included with the templates and their
  74. source code is a sample application.  The files SAMPLE.FV,
  75. SAMPLE.CFG and SAMPLE.DBF can be used to "try-out" the templates
  76. and FOXVIEW. 
  77.  
  78. To run the templates with the sample application you must first
  79. execute the FoxView program.  Press <Esc> once in FoxView to
  80. activate the pull down menus and select the LOAD menu section.  
  81.  
  82. The configuration file is loaded separately by selecting the New
  83. Config option.  The CFG file can also be renamed FoxView.CFG
  84. (VIEWGEN.CFG if you are using a copy of VIEWGEN) after which it
  85. will be automatically loaded in each time the FoxView is run. 
  86. This configuration file has the default screen colors set to
  87. white on blue, which is the setting used when designing the
  88. sample template.  As you become familiar with the system the
  89. colors can be changed to reflect your own preferences.  
  90.  
  91. The FoxView table SAMPLE.FV file must also be loaded by selecting
  92. the Load Table option and entering "Sample".  
  93.  
  94. To generate code move to the GEN menu and select Template Prgs. 
  95. FoxView will display a directory of templates.  Select MSA_1
  96. template.  (If not listed check the path.)  Enter "Sample" when
  97. prompted with the program name and enter "N" to writing only
  98. selected program files.  After the program files are created you
  99. may quit out of FoxView and run the program files by entering "DO
  100. Sample" from within FoxBASE+.
  101.  
  102. COMPILATION:  For people new to FOXBASE+, the best performance is
  103. achieved through compilation of the programs.  If, for instance,
  104. your program were named Maillist.prg, it is possible to compile
  105. all files produced by the MSA_1 templates by entering--
  106.  
  107.                 foxpcomp mai*.prg
  108.  
  109. The new program files will be have a "fox" extension.  For
  110. security, encryption is performed when the -e option is invoked.
  111.  
  112.                 foxpcomp -e mai*.prg
  113.  
  114. For further information try reading the manual!  Warning: this
  115. may be considered an unnatural act in many states and will
  116. subject you to fines and ridicule by your peers.
  117.  
  118.  
  119. PROGRAM NOTES
  120.  
  121. Menus:  I have made extensive use of menus in the system.
  122. There may be an occasion when a menu may block information
  123. already on the screen; simply press <Esc> to make the menu
  124. disappear.  Pressing any key will pop it back.
  125.  
  126. ADD INS:  The menus have space for add-in applications.  If you
  127. wish to include a custom report as a menu option, two files must
  128. be altered--{fileprefix}_mbar and {fileprefix}_repo.  The menu
  129. bar program ({fileprefix}_mbar.prg) must have the name entered. 
  130. Also, the case statement of the report section (Case Choice_Y =
  131. 4) must have the program name inserted.  The same process is
  132. followed should any of the pull-down menus be changed.
  133.  
  134.  
  135. SECTION DETAILS
  136.  
  137. Logo section:
  138.     You will need to modify this template for your own sign-on.
  139. It can be eliminated by removing the call for it from
  140. MSAMAIN.INC.
  141.  
  142. Install section:
  143.  
  144.     The information placed in this section is stored in a memvar
  145. file {fileprefix}_inst.mem.  Each time the program is executed
  146. this file is used to configure the program to the following
  147. values:
  148.  
  149.     Company name:  Used for customizing the promptbar.  Company
  150. extension code at present is not used and may be left blank.
  151.  
  152.     Printer codes:  Allows the system to be configured to any
  153. printer.  These codes are used in the report and label section. 
  154. Check the FoxBASE+ and printer manuals for more information.
  155.  
  156.      Colors:  A very personal matter.  The sample system supplied
  157. has a screen and CFG file set using blue as a backround with
  158. white as a foreground color.
  159.  
  160.      Data Drive:  This is used to set the Default drive where the
  161. dbf files reside.
  162.  
  163.      Backup and Restore:  The program request the names of either
  164. a program or batch file which will run backup/restore operations.
  165. If the computer does not have a specialized backup system (such
  166. as a tape system), use a word processor to create two simple BAT
  167. files. 
  168.  
  169.                         Backup#.BAT
  170. echo off
  171. cls
  172. echo :
  173. echo :
  174. echo :
  175. echo   WARNING ! Make sure you have enough formatted diskettes
  176. ready.
  177. echo :
  178. echo                  to abort press (CNTL) C
  179. echo :
  180. pause
  181. echo   Copying Files.  Please wait...'
  182. backup c:\[sub directory]\*.dbf a:
  183. cls
  184. echo   Files Copied
  185. echo :
  186. echo :
  187. pause
  188. cls
  189. echo on
  190.  
  191.                         Restore#.BAT
  192. echo off
  193. cls
  194. echo :
  195. echo :
  196. echo :
  197. echo   WARNING ! Make sure you have your backup diskettes ready.
  198. echo :      The backup files will write over the hard disk
  199. files!!
  200. echo :
  201. echo                  to abort press (CNTL) C
  202. echo :
  203. pause
  204. echo   Copying Files.  Please wait...'
  205. RESTORE A: C:\[subdirectory]\*.DBF
  206. cls
  207. echo   Files Copied
  208. echo :
  209. echo :
  210. pause
  211. cls
  212. echo on
  213.  
  214.  
  215. The program assumes that the path has been set to the DOS
  216. subdirectory so that BACKUP and RESTORE commands are available. 
  217. Consult your DOS manual on these commands.
  218.  
  219.      Typical Problems: If the memory file is damaged so that the
  220. install section is not operating properly, quit from the program
  221. and erase the memory file ({fileprefix}_inst.mem ).  Then
  222. re-start the program and the system will automatically create a
  223. new file.
  224.  
  225.  
  226. Condition section:
  227.  
  228. To de-select a filter, use "Select" option from menu and enter
  229. 0 for the record number.
  230.  
  231. Notes/headings allows you to comment your filters and these
  232. notes are printed on the headings of reports when run.
  233.  
  234. If the conditions file {fileprefix}_COND.DBF is damaged, it
  235. is necessary to leave the system and erase the conditions file.
  236. Once the system is restarted, a new file will automatically be
  237. created.  However, all of the filter conditions will need to be
  238. re-entered.
  239.  
  240. Report section:
  241.  
  242. The deleted records report lists to the screen all records
  243. which are marked for deletion.  When the Index and Pack option is
  244. chosen, all records shown will be removed from the file.  
  245.  
  246. The Run Reports option will give a directory of all FRM files
  247. which begin with the {fileprefix} of the program (i.e. the first
  248. three letters of the program.
  249.  
  250. Several problems can occur in the report section because it is
  251. dependent on the data in two other files besides the report
  252. form itself.  First, if the conditions file {fileprefix}_COND.DBF
  253. is damaged, trying to use a condition could lead to error
  254. messages.  See condition section for details.  Second, should the
  255. print section not operate properly, check the printer codes in
  256. the install section of the program.  Re-read the above notes on
  257. the "Install" section should you encounter problems with entering
  258. the print codes.
  259.  
  260. Refer to the "ADD-IN" section under "General Notes" (above) to
  261. change the add-in program listing.
  262.  
  263. Label (same procedure as Report)
  264.  
  265. Index and Pack Section:
  266.  
  267. It is recommended that you first run the deleted records report
  268. which will list on the screen all records (if any) marked for
  269. deletion.  Once the reindex is run, the records are gone forever
  270. --so caution is recommended.  When you are in browse or
  271. edit, the <Del> key is used to change the status of the record
  272. (i.e. deleted on or off).
  273.  
  274.  
  275.  
  276.                         TECHNICAL SUPPORT
  277.  
  278.     TECHNICAL SUPPORT IS AVAILABLE FOR REGISTERED USERS ONLY!
  279.  
  280.  
  281.  
  282.             OTHER PRODUCTS FROM MICROSEARCH ASSOCIATES
  283.  
  284. MicroSearch Associates is a consulting firm that specializes in
  285. database management systems.  In addition to consulting,
  286. MicroSearch Associates also engages in contract programming.
  287.  
  288.  
  289.                            REGISTRATION
  290.  
  291.  
  292. All users registered with the developer will automatically
  293. receive notification of the next release.  If you use this
  294. template, its code, or a modified version of it, please print a
  295. copy of the registration form, complete it, and mail the form
  296. along with a registration fee of $35.00 to:
  297.  
  298.  
  299.                       MicroSearch Associates
  300.                        520 S.E. 44th Avenue
  301.                         Ocala, FL   32671
  302.  
  303. You may print the registration form by using either PRINT.COM (a
  304. DOS utility), your text processor, or use the DOS COPY command as
  305. follows:
  306.  
  307.               A>COPY SIGNUP.TXT PRN <ENTER>
  308.  
  309.  
  310.                         SOFTWARE AGREEMENT
  311.  
  312. License:  Registration grants the user unlimited usage of the
  313. templates for the production of program code on one machine.
  314. You may not use the software on more than one single machine
  315. without the written consent of MicroSearch Associates even if you
  316. own or lease all of them.
  317.  
  318. Site License:  Site License for unlimited usage of the templates
  319. on more than one machine, or on a network, is available for
  320. corporate accounts.
  321.  
  322. Ownership:  MicroSearch Associates retains title and ownership to
  323. template code, templates and all routines and procedures produced
  324. by the templates.
  325.  
  326. Restrictions:  You may not resell the templates, template code or
  327. any portion thereof to third parties.  However, as a registered
  328. user you are free to use, sell, or distribute any programs
  329. produced by the templates.
  330.  
  331. Liabilities:  The product is provided "as is" without warranty of
  332. any kind.  Further, MicroSearch does not warrant, guarantee, or
  333. make any representations regarding the use of these programs.  No
  334. suitability for any particular use is claimed, since you are free
  335. to test the product and determine its merits on your own before
  336. registration.
  337.  
  338. Updates:  MicroSearch Associates may create, from time to time,
  339. updated versions of the software Templates.  These will be made
  340. available to registered users who have paid the update fee.
  341.  
  342. Warning:  Distribution or use of programs (or any portion)
  343. produced by these templates without registration constitutes
  344. theft.
  345.  
  346. <<end>>
  347.  
  348. <<* EOF() MSAREAD.INC *>>
  349.