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