home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR15 / RG100SW.ZIP / RG.DOC < prev    next >
Text File  |  1993-11-27  |  18KB  |  433 lines
  1.                
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                
  10.                
  11.           Contact Manager Report Generator Version 1.00 Documentation        
  12.                  Copyright (C) 1993, DataTek Computer Services.
  13.                               All Rights Reserved.
  14.                                      
  15.                                
  16.                                
  17.  
  18.  
  19.  
  20.  
  21.                                
  22.                                
  23.                                
  24.                                
  25.                                
  26.                                
  27.                                      Member
  28.  
  29.                                ┌───────┐
  30.                           ┌────┴──┐    │                (R)
  31.                         ──┤       │    ├───────────────────
  32.                           │  ┌────┴──┐ │  Association of
  33.                           │  │       ├─┘  Shareware
  34.                           └──┤   O   │    Professionals
  35.                         ─────┤   │   ├─────────────────────
  36.                              └───┴───┘
  37.  
  38. --- Shareware Concept:
  39.  
  40. Shareware distribution gives users a chance to try software before buying it.
  41. If you try a Shareware program and continue using it, you are expected to
  42. register. Individual programs differ on details -- some request registration
  43. while others require it, some specify a maximum trial period. With
  44. registration, you get anything from the simple right to continue using the
  45. software to a myriad of benefits.
  46.  
  47. Copyright laws apply to both Shareware and commercial software, and the
  48. copyright holder retains all rights, with a few specific exceptions as stated
  49. below. Shareware authors are accomplished programmers, just like commercial
  50. authors, and the programs are of comparable quality. (In both cases, there
  51. are good programs and bad ones!) The main difference is in the method of
  52. distribution. The author specifically grants the right to copy and distribute
  53. the software, either to all and sundry or to a specific group. For example,
  54. some authors require written permission before a commercial disk vendor may
  55. copy their Shareware.
  56.  
  57. Shareware is a distribution method, not a type of software. You should find
  58. software that suits your needs and pocketbook, whether it's commercial or
  59. Shareware. The Shareware system makes fitting your needs easier, because you
  60. can try before you buy. And because the overhead is low, prices are low also.
  61. Shareware has the ultimate money-back guarantee -- if you don't use the
  62. product, you don't pay for it.
  63.  
  64.  
  65. --- Disclaimer / Agreement:
  66.  
  67. Users of Report Generator must accept this disclaimer of warranty:
  68.  
  69. Contact Manager Report Generator is supplied as is.  The author disclaims all
  70. warranties, expressed or implied, including, without limitation, the
  71. warranties of merchantability and of fitness for any purpose. The
  72. author assumes no liability for damages, direct or consequential, which
  73. may result from the use of Report Generator.
  74.  
  75. Report Generator is a "shareware program" and is provided at no charge to the
  76. user for evaluation.  Feel free to share it with your friends, but please do
  77. not give it away altered or as part of another system. The essence of
  78. "user-supported" software is to provide personal computer users with quality
  79. software without high prices, and yet to provide incentive for programmers to
  80. continue to develop new products.  If you find this program useful and find
  81. that you are using Report Generator and continue to use it after a 30 day
  82. trial period, you must make a registration payment to DataTek Computer
  83. Services.  
  84.  
  85. Commercial users of Report Generator must register and pay for their copies
  86. of Report Generator within 30 days of first use or their license is withdrawn.
  87. Site-License arrangements may be made by contacting DataTek Computer Services.
  88.  
  89. Anyone distributing Report Generator for any kind of remuneration must first
  90. contact DataTek Computer Services at the address below for authorization. This
  91. authorization will be automatically granted to distributors recognized by the
  92. (ASP) as adhering to its guidelines for shareware distributors, and such
  93. distributors may begin offering Report Generator immediately. However DataTek
  94. must still be advised so that the distributor can be kept up-to-date with the
  95. latest version of Report Generator.
  96.  
  97. You are encouraged to pass a copy of Report Generator along to your friends
  98. for evaluation.  Please encourage them to register their copy if they find
  99. that they can use it.  All registered users will receive a copy of the latest
  100. version of Report Generator along with other benefits described below.
  101.  
  102.  
  103. --- ASP Ombudsman Statement:
  104.     
  105. "This program is produced by DataTek Computer Services, a member of the 
  106. Association of Shareware Professionals (ASP).  ASP wants to make sure that
  107. the shareware principle works for you. If you are unable to resolve a
  108. shareware-related problem with an ASP member by contacting the member 
  109. directly, ASP may be able to help. The ASP Ombudsman can help you resolve a
  110. dispute or problem with an ASP member, but does not provide technical support
  111. for members' products.  Please write to the ASP Ombudsman at 545 Grover
  112. Road, Muskegon, MI 49442 or send a CompuServe message via CompuServe Mail to
  113. ASP Ombudsman 70007,3536."
  114.  
  115.  
  116. --- Installation:
  117.  
  118. Since Report Generator (RG) is meant to be used as an add-on to Contact
  119. Manager it is necessary that you decompress the distribution file into the CM
  120. directory. For the purpose of example we will assume that the user is copying
  121. the Report Generator.ZIP (RGXXXXX.ZIP) file from drive A to drive C --
  122. sub-directory CM. You will have to substitute whatever drives and path you
  123. intend to use.
  124.  
  125.  
  126. Change to drive C          type    C:     [press Enter]
  127.  
  128. change to the CM
  129. directory                  type   CD\CM   [press Enter]
  130.  
  131. copy the compressed file
  132. to the sub-directory       type   COPY A:\RGXXXXX.ZIP C:   [press Enter]
  133.  
  134. de-compress the file       type   PKUNZIP RGXXXXX.ZIP      [press Enter]
  135.  
  136. delete the .ZIP file       type   DEL RGXXXXX.ZIP          [press Enter]
  137.  
  138.  
  139. That's it!
  140.  
  141.  
  142. --- Overview:
  143.  
  144. Report Generator is a an addon to our popular Contact Manager program. It is
  145. a custom report generator that allows users to create, edit and save custom
  146. reports using the data fields from Contact Manager. These reports can be
  147. changed, saved, recalled, printed and deleted as needs change.
  148.  
  149. --- Starting The Program:
  150.  
  151. Start the program by typing 'RG' at the DOS prompt or accessing it from the
  152. main menu within Contact Manager. When you leave RG it will take you to
  153. Contact Manager whether you launched RG from DOS or not.
  154.  
  155. When launched, RG present a simple 5 item menu. 
  156.  
  157.         F1 - CREATE REPORT
  158.         F2 - EDIT REPORT
  159.         F3 - DELETE REPORT
  160.         F4 - RUN REPORT
  161.         ESC - QUIT
  162.  
  163. You can select any of these options by  using the arrow keys and pressing
  164. 'ENTER' when the option you wish to execute is highlighted or you may
  165. press the appropriate function key or the 'ESC' key or you may double-click
  166. on the menu choice you wish to select.
  167.  
  168.  
  169. --- Create Report:
  170.  
  171. The option allows you to select the row and column that you wish any of
  172. Contact Manager's data fields to appear at when the report is printed.
  173. Create report uses 2 screens to list all of Contact Manager's data fields.
  174. here is a sample of screen 1:
  175.  
  176.                    ROW       COLUMN                        ROW      COLUMN
  177.         Group 31                               Topic 2 36
  178.  Company Name 55                               Topic 3 36
  179.     Address 1 55                             Comment 1 59
  180.     Address 2 55                             Comment 2 59
  181.          City 25                             Comment 3 59
  182.         State  8                             Comment 4 59
  183.  
  184.         Group - Name of the data field -- corresponds to the group name
  185.                 field in Contact Manager
  186.            
  187.            31 - Indicates the length of the field. Therefore GROUP is a
  188.                 31 character field.
  189.  
  190. The ROW and COLUMN fields are for the user to indicate at which row and
  191. column this field should appear on the report. To skip a field, 'ENTER'
  192. through the row and column fields.
  193.  
  194. You can use the arrow keys to move through the row and columns fields for
  195. each of the data field designators.
  196.  
  197. ***NOTE***
  198. You can place more than 1 field on a printer line however, if you wish to
  199. place more than 1 field per line you must be conscience of the field sizes.
  200. For example, if you want to put the Group and the Company Name on line 1, you
  201. could not do it. Group is 31 characters, Company Name is 55 Characters, the
  202. totals in 86 characters which is wider then the 80 columns most printers will
  203. allow you to print per line. So, the total characters per line must add up to
  204. 80 or less.
  205.  
  206. To Cancel the creation of a report press ESC at any field. To move to the next
  207. page of the Create Report, press the F1 function key.
  208.  
  209. Page 2 allows you to continue placing the balance of the data fields and
  210. give a name or description to your report. 
  211.  
  212. To Cancel the creation of a report press ESC at any field. To move back to
  213. page 1, press the F1 function key. To save the report, press the F10 function
  214. key.
  215.  
  216. When you choose F10 to save a report, a short message will flash reporting
  217. that RG is now compiling your report. During this short process, RG is
  218. actually creating the outline for the report that it will send to the printer
  219. when you choose Run Report at some point in the future.
  220.  
  221.  
  222. --- Edit Report:
  223.  
  224. When you choose this option you will see a listing of the description you
  225. entered when you created your reports. The menu is scrollable. You can select
  226. a report by using the arrow keys and pressing 'ENTER' when the report you
  227. want to edit is highlighted or you can use the mouse and double-click on the
  228. report name. To Cancel selection press the 'ESC' key. Once selected you will
  229. be presented with the same screens you saw in the Create Report section 
  230. except that the row and column values entered previously will be displayed.
  231. Again by using the arrow keys you can move around the screen and add, change,
  232. or delete any values you wish to alter.
  233.  
  234. Pressing 'ENTER' will advance the cursor to the next field without changing
  235. the data. Alt-C will clear all the data from the current field and Alt-R will
  236. restore data cleared with Alt-C assuming you have not changed fields between
  237. executing the Alt-C and the Alt-R commands.
  238.  
  239. To Cancel the update of a report press ESC at any field. To move to the next
  240. page of the Edit Report, press the F1 function key.
  241.  
  242. Page 2 allows you to continue editing the balance of the data fields and
  243. either give a new name or description to your report or press 'ENTER' to
  244. keep the report description the same.
  245.  
  246. To Cancel the editing of the report, press ESC at any field. To move back to
  247. page 1, press the F1 function key. To save the report, press the F10 function
  248. key.
  249.  
  250. When you choose F10 to save a report, a short message will flash reporting
  251. that RG is now compiling your report. During this short process, RG is
  252. actually creating the outline for the report that it will send to the printer
  253. when you choose Run Report at some point in the future.
  254.  
  255.  
  256. --- Delete Report:
  257.  
  258. When this option is chosen, again a list of report names is displayed. To
  259. cancel the delete function, press the 'ESC' key. To delete a report, use the
  260. arrow keys to select the report you want to delete and press 'ENTER' or
  261. double-click on the report you want to delete.
  262.  
  263. --- Run Report:
  264.  
  265. This option again displays a list of reports that you have created. To select
  266. a report either use the arrow keys and press 'ENTER' when the report you wish
  267. to print is highlighted or double-click on the report name/description.
  268.  
  269. You may cancel the print selection by pressing 'ESC'. After selecting a report
  270. a list of Contact Manager's groups will appear. The default group is 'ALL' 
  271. indicating that the report will print all records. If you wish to limit the
  272. report to printing only A particular group, use the cursor keys to highlight 
  273. the group the want to print and press 'ENTER' or double-click on the group 
  274. name you want to limit the report to. If you want to print the report for ALL
  275. records, move the cursor to the group name 'ALL' and press enter.
  276.  
  277. After this, RG asks 'Tagged Only?'. Answering 'Y' (Yes) will tell RG to print
  278. only tagged records within the group you have previously selected. Answering
  279. 'N' (No) tells RG to print all records within the group you selected.
  280.  
  281. Next, RG needs to know if you want a 'Form Feed Between Each Record?'. 
  282. Answering 'Y' (Yes) to this question will cause RG to print 1 record per page.
  283. Answering 'N' (No) will cause RG to print multiple records per page.
  284.  
  285. You can cancel the printing at any point by pressing the 'ESC' key.
  286.  
  287. After answering the 'Form Feed' question, there may be a slight delay before
  288. printing starts. This delay will depend on whether you selected a specific
  289. group, all groups, tagged records only or all records.
  290.  
  291.  
  292. --- Quitting Report Generator:
  293.  
  294. By pressing 'ESC' at the Main Menu, you will be returned to Contact Manager.
  295. Even if you started RG from DOS, Contact Manger will be invoked when you
  296. exit.
  297.  
  298. --- Error Codes:
  299.  
  300. Error      Description/Solution
  301.  
  302.  25        Device Fault - Disk write error. Physical problem exists with
  303.            the drive. Contact your service representative.
  304.  
  305.  53        File Not Found - A file that Report Generator needs can't be found.
  306.  
  307.  57        Device I/O Error - An error has occurred between your computer and
  308.            your hard drive. Contact your service representative.
  309.  
  310.  58        File/Path already exists - The path already exists on the drive
  311.            you are trying to install to. Choose another drive.
  312.  
  313.  61        Disk is full - The drive you are working on is full. Choose another
  314.            drive.
  315.  
  316.  71        Disk not ready - Your floppy drive latch is not closed. Close the
  317.            latch.
  318.  
  319.  72        Disk media error - The floppy disk or hard drive has a media
  320.            error. Contact your service representative.
  321.  
  322.  75        Access denied - Your floppy diskette or hard drive is write
  323.            protected. Remove the write protection feature.
  324.  
  325.  76        Path not found - The program is looking for a path on the hard
  326.            drive and cannot find it.
  327.  
  328.  77        Invalid drive spec - The destination drive specified does not
  329.            exist.
  330.  
  331. Call DataTek Technical Support at 215-374-2097 if you are presented with any
  332. other error codes or need help correcting a problem or have any questions
  333. about Report Generator.
  334.  
  335.  
  336. --- Support:
  337.  
  338. DataTek Computer Services in a small company that I run part-time from my
  339. home. Like many people I have a regular job that keeps my family fed. I am
  340. usually available every night between 6:00 pm and 11:00 pm Eastern time and
  341. from 8:00 am to 11:00 pm on weekends. Occasionally I go out for an evening or
  342. go on vacation, but my answering machine is ALWAYS on and I will return your
  343. call assuming you leave a number and the best time to call you.
  344.  
  345. I will be just as happy to help Shareware users as I am to help registered
  346. users, however, assuming there is a list of users for me to call, registered
  347. users will be moved to the top of it. Fair is fair. As far as I'm concerned
  348. support is perpetual.
  349.  
  350. You can contact DataTek in any of the following ways:
  351.  
  352. Phone: (215) 374-2097 during the hours listed above or leave a message at 
  353.        other times.
  354.  
  355. BBS:   (215) 374-3735 24 hours
  356.  
  357. Mail:  Kirk A. Wentzel
  358.        DataTek Computer Services
  359.        547 Wunder Street
  360.        Reading, PA   19602-2005
  361.  
  362.  
  363. --- History:                        
  364.  
  365. Version 1.00 11-25-93
  366. Initial Release
  367.  
  368.                        DATATEK REGISTRATION FORM RG 1.10
  369.  
  370. PROGRAM:                              # COPIES    # DESIRED       AMOUNT
  371.  
  372.               CMRG ($20 per copy)      1 TO 5     _________       $________
  373.                 
  374.               CMRG ($18 per copy)      6 TO 10    _________       $________
  375.               
  376.               CMRG ($16 per copy)     11 TO 25    _________       $________
  377.               
  378.               CMRG ($14 per copy)     26 TO 55    _________       $________
  379.               
  380.               CMRG ($12 per copy)     51 TO 99    _________       $________
  381.        
  382.    100 or more call us, we'll sharpen the pencil! _________       $________
  383.  
  384. - DISK** -   $2 per Disk Handling Fee (add if a disk is requested $________
  385.              A single handling fee is charged regardless of the 
  386.              number of copies registered.)
  387.  
  388.               Specify disk:    360K, 1.2M, 720K, 1.4M:  __________
  389.  
  390.  
  391. -SALES TAX-   Pennsylvania residents add 6.00%                     $________
  392.               (Philadelphia residents add 7.00%)
  393.  
  394. TOTAL         . . . . . . . . . . . . . . . . . . . .              $________
  395.  
  396. PAYMENT BY:
  397.  
  398. Check/Money Order No.___________________ enclosed for $__________
  399.  
  400. MasterCard ___  VISA ___  American Express ___  Optime ___  JCB ___
  401.  
  402. Card # _________________________  Expiration Date: _____________
  403.  
  404. Signature _______________________________
  405.  
  406. Personal Checks: Allow 10 business days for check to clear. 
  407. Purchase Orders: Accepted with prior credit approval.
  408. Credit Card Orders: Charge will appear on your bill from Dragon BBS.
  409.  
  410. MAILING ADDRESS:
  411.  
  412. Name:____________________________________________________________
  413.  
  414. Address:_________________________________________________________
  415.  
  416. City/State/Province:_____________________________________________
  417.  
  418. Country/Postal Code:_____________________________________________
  419.  
  420. Telephone (Voice/FAX/Modem):_____________________________________
  421.  
  422. Would you like us to setup an account for you on our
  423. 24 hour BBS?            __ Yes   __ No
  424.  
  425. If Yes, Password? _________________
  426.  
  427. **   Disks are available at the time of registration only.  Disks
  428. are shipped U.S. Mail First Class in the United States and Airmail
  429. to foreign countries.  Upgrades are available through the DCS BBS. 
  430. Registered Users will be notified by mail whenever upgrades are
  431. available.
  432.  
  433.