home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / proglang / sak150.arj / SAK.DOC < prev    next >
Text File  |  1992-02-28  |  20KB  |  576 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                          ShareWare Authors Kit
  9.                                  (SAK)
  10.  
  11.                                Ver. 1.50
  12.  
  13.                                    by
  14.  
  15.                           (C)opyright 1991-1992
  16.                                GroupWare
  17.  
  18.  
  19.  
  20.  
  21.          Ismail Arslangiray
  22.  
  23.  
  24.      MCI Mail : GroupWare
  25.           BIX : Iarslangiray
  26.    Compuserve : 70274,423
  27.           FAX : 206-588-1588
  28.         Voice : 206-588-6305
  29.      Fido-Net : 1:138/116 or 1:138/120
  30.           BBS : 206-581-9088
  31.  
  32.       US Mail : PO BOX 300
  33.                 Dupont, WA 98327-0300
  34.                              USA
  35.  
  36.  
  37.  
  38.  
  39.                            Table of Contents
  40.  
  41. About GroupWare
  42.  
  43. Introduction
  44.  
  45. Shareware Notice
  46.  
  47. About SAK
  48.  
  49. Getting Started
  50.   Packing list
  51.   Hardware and software requirements
  52.   Installing the system
  53.  
  54. Running The System
  55.   The Main Menu
  56.   Vendor List
  57.   Printing Menu
  58.  
  59. Appendix A - Error Messages
  60. Appendix B - Bugs
  61. Appendix C - Technical Support
  62. Appendix D - Suppliers
  63.  
  64.  
  65.                           ┌─────────────────┐
  66.                           │ About GroupWare │
  67.                           └─────────────────┘
  68.  
  69. GroupWare was founded by Ismail Arslangiray to develope and provide
  70. applications for the computing world.
  71.  
  72. GroupWare has a team of contributing programmers and consultants that
  73. assist the computing tasks of developers and end-users.
  74.  
  75.  
  76.                 ┌─────────────────────────────────────┐
  77.                 │  Shareware(User Supported Software) │
  78.                 └─────────────────────────────────────┘
  79.  
  80. SAK is distributed as "Shareware" or "User Supported Software" and is
  81. fully copyrighted.  You may have received a copy of SAK free from a a
  82. public bulletin board, shareware library or user's group library. You
  83. are encouraged to make as many copies of the software and this
  84. documentation as you like and distribute it to anyone you want, as long
  85. as you do not charge a fee (other than to cover your own distribution
  86. cost) and distribute only complete, unaltered copies of the package,
  87. exactly as you received it. If after trying the program for 2 weeks, you
  88. find it useful and use it regularly, you must register your copy by
  89. completing registration form printed using <F9> option from the main
  90. menu. Please read the registering information at the end this
  91. documentation review your options.
  92.  
  93.  
  94.                         ┌──────────────────────┐
  95.                         │ShareWare Authors Kit │
  96.                         └──────────────────────┘
  97.  
  98. I realized the need for this program in the process of my own program
  99. distribution. After mailing, some of my diskettes to several vendors
  100. came back with messages such as "NO SUCH ADDRESS" , "POSTAL CUSTOMER
  101. MOVED WITH NO FORWARDING ADDRESS", "FORWARDING ORDER IS EXPIRED". Of
  102. course, we, developers need the minimize the hassle of distributing our
  103. programs in order to devote more time to develope them. By starting with
  104. this idea, I have updated, improved my vendor mailing list. While being
  105. only human, and therefore subject to make mistakes. I have done my best
  106. to validate every entry in this list by numerous means and believe it to
  107. be accurate.
  108.  
  109.  
  110.                            ┌────────────────┐
  111.                            │Getting Started │
  112.                            └────────────────┘
  113.  
  114. Packing List
  115. ------------
  116.  
  117. PKG      LST    Packing List
  118. READ     ME     How to be listed in this directory
  119. SETUP    DAT    Set-up data file
  120. SW       DAT    Shareware Vendor data file
  121. SYSTEM   DAT    System information data file
  122. SAK      DOC    This document
  123. SW       K01    Shareware vendor data file key
  124. SW       K02    Shareware vendor data file key
  125. SETUP    MEM    Set-up file memo (binary file)
  126. SW       MEM    Shareware vendor memo (binary file)
  127. SAK      EXE    Main executable file
  128. SAK      HLP    Main help file
  129.  
  130.  
  131. Hardware & Software Requirements
  132. --------------------------------
  133.  
  134.      Operating System:
  135.  
  136.       SAK requires MS-DOS 2.0 or higher to run. It has been tested under
  137.       Deskview and Taskview and should operate reliably under them.
  138.  
  139.      RAM and Network drives:
  140.  
  141.       SAK may be run on a RAM drive. Network drives are not supported in
  142.       this version, but are available by special request.
  143.  
  144.  
  145. Installation
  146. ------------
  147.  
  148. This section provides step by step instructions for running
  149. SAK on any drive of a standard IBM PC, XT, AT, PS/2 or compatibles
  150. under MSDOS 2.0, or higher.
  151.  
  152.      1. Backup your original or shareware copy before you start.
  153.         Use the DOS DISKCOPY command to create a duplicate of your disk
  154.         and keep the original intact. Use the backup copy during
  155.         installation and/or as a work copy.
  156.  
  157.      2. Set the number of files in your CONFIG.SYS to 50 or more.
  158.  
  159.      3. SAK does not require any special installation procedure. You
  160.         may run SAK from the backup floppy disk or from a hard drive
  161.         If you wish to run SAK from a hard drive, create a directory and
  162.         copy the files from the diskette to that directory.
  163.  
  164.      4. Laptop users:
  165.  
  166.         If you are running SAK on a laptop computer, you may feel very
  167.         comfort with it. Because most of the parts of the program were
  168.         written on a laptop.
  169.  
  170.      5. Virtual Memory
  171.         Configure SAK Virtual Memory, by setting the environment
  172.         variables CLAVM0, CLAVM1, CLAVM2. These variables control the
  173.         allocation priority and placement of virtual memory.
  174.         Environment variables are specified with the SET command and
  175.         usually reside in the AUTOEXEC.BAT file.
  176.  
  177.         To allocate virtual memory for a RAM drive or a hard disk, the
  178.         following SET command format is used:
  179.  
  180.         SET CLAWMx=path,size,ram-indicator
  181.  
  182.         x       --->  is 0 to 2
  183.         path    --->  is the drive and directory path of the RAM drive
  184.                       or hard disk
  185.         size    --->  is the maximum number of kilobytes to assign
  186.         ram-indicator ---> use M if you are using a RAM drive
  187.  
  188.         Examples:
  189.         SET CLAVM0=E:\,512,M         use 512K on RAM disk E:
  190.         SET CLAVM1=MEMORY,64         use 64K conventional memory
  191.         SET CLAVM2=D:\VIRTUAL,512    use 512K on subdirectory D:\Virtual
  192.                 as memory swap disk.
  193.  
  194.         Be sure you reboot the system after changing or creating new
  195.         CONFIG.SYS and AUTOEXEC.BAT files.
  196.  
  197.  
  198. IMPORTANT NOTE:
  199.  This program has a built-in screen saving. In the event of idling more
  200.  than 10 minutes, screen will be cleared and saved.
  201.  
  202.                          ┌────────────────────┐
  203.                          │ Running The System │
  204.                          └────────────────────┘
  205.  
  206. The Main Menu
  207. -------------
  208. When you first start the program MAIN MENU will be displayed. The menu
  209. offers the following items.
  210.  -List           : List of the shareware vendors by name
  211.  -Print          : Displays a pulldown menu of listing of reports
  212.  -Update (F2 Key): Brings up an entry screen to the input data for your
  213.                    program.
  214.  
  215.  -Registration(F9 Key): Call the registering option. Available only in
  216.                         unregistered versions.
  217.  -Exit           : Terminates the program and returns to DOS
  218.  
  219. Accessing the menu:
  220. ------------------
  221.  
  222. - The cursor keys will move the highlight bar between the menu items
  223. - Pressing the <ENTER> key will execute the highlighted menu item.
  224. - The <ESC> key will exit the menu and return you back to the operating
  225.   system.
  226. - <F1> will display any help text available.
  227.  
  228. Update option (F2 key):
  229. ----------------------
  230. By selecting this option, you will get an input section where you may
  231. enter data to be put into your reports. This data simply will merge with
  232. your other information into your reports.
  233.  
  234. List of the vendors
  235. -------------------
  236. This section of the program will display the names of the vendors by
  237. placing the cursor over an item and pressing the enter key. This will
  238. display the information about the vendor. In the professional versions
  239. you may update, add or delete the records.
  240.  
  241. Dialer (F3):
  242. ------------
  243. In the registered and professional versions, this selection will call
  244. the dialer module to allow you to use your modem as a dialer. Currently
  245. only COM1 and COM2 supported.
  246.  
  247.  
  248. Terminal program (F4):
  249. ---------------------
  250. In the registered and professional versions, this selection will call
  251. terminal program to allow you to access to full featured communication
  252. program to call the Vendor's BBS or other BBS'. Currently COM1 thru COM4
  253. are supported.
  254.  
  255. Print menu (F10):
  256. ----------------
  257. Print menu can be called from this section by simply pressing to F10
  258. key.
  259.  
  260. Print the reports
  261. -----------------
  262. By selecting this option from the Main Menu or Vendor List section (via
  263. F10 key) a menu of different printing choices will be displayed. Output
  264. maybe directed to a printer, screen or to a file.
  265.  
  266. Reports: If you select a file as the output, you will be asked for a
  267. file name. If the file already exists, it will ask whether to overwrite
  268. it or not. This option is very useful if you like to  utilize your word
  269. processor to do a final touch up before printing an hard copy.
  270.  
  271. Labels: Labels selection will take you to a selection menu where you may
  272. do a test print to align your labels prior to printing. Formatting is
  273. for standard (3 1/2 X 15/16)" continuous labels.
  274.  
  275.   Best Products: #PL
  276.   MOORE        : 5J28977
  277.  
  278. 3 1/2 X 6 Cards: This is the actual size of 3 1/2 x 6 cards.
  279.  
  280.   AVERY : List & Mail #4167
  281.  
  282. Envelops: These are tractor feed, carrier mounted   4 1/8" X 9" on a
  283. 10" wide paper envelops.
  284.  
  285.   MOORE : 39J13367
  286.  
  287. Letters: This option uses blank 9 1/2 x 11" continuous feed printer paper
  288.  
  289.   BEST : #PP
  290.   MOORE: 5J11387
  291.  
  292.  This is the sample of a letter
  293.  ------------------------------
  294.  
  295.  --------------------------------------------------------------------
  296. |                                                                    |
  297. |                                                                    |
  298. |                                                            7/20/91 |
  299. |                                                                    |
  300. |                                                                    |
  301. |                                                                    |
  302. |                                                                    |
  303. |                                                                    |
  304. |       Dear Shareware Vendor,                                       |
  305. |                                                                    |
  306. |       Please find enclosed a copy of our latest product, ORG 3.02  |
  307. |       for your review and inclusion in your library. The following |
  308. |       information describes the program.                           |
  309. |                                                                    |
  310. |       Sincerely,                                                   |
  311. |                                                                    |
  312. |                                                                    |
  313. |                                                                    |
  314. |                                                                    |
  315. | -----------------------------------------------------------------  |
  316. |                                                                    |
  317. |  Program Name............:  ORG 3.02                               |
  318. |                                                                    |
  319. |  Registration Fee........:   30.00                                 |
  320. |                                                                    |
  321. |  Minimum CRT.............:  MGA                                    |
  322. |                                                                    |
  323. |  Minimum DOS.............:  3.1                                    |
  324. |                                                                    |
  325. |  Minimum RAM.............:  384                                    |
  326. |                                                                    |
  327. |  Printer requirement.....:  NO                                     |
  328. |                                                                    |
  329. |  Hard drive requirement..:  YES                                    |
  330. |                                                                    |
  331. |  Mouse Support...........:  NO                                     |
  332. |                                                                    |
  333. |  Modem Support...........:  NO                                     |
  334. |                                                                    |
  335. |                                                                    |
  336. |  Program Description.....:  Hard disk defragmanter                 |
  337. |                                                                    |
  338. |                                                                    |
  339. |                                                                    |
  340. |                                                                    |
  341. |                                                                    |
  342. |                                                                    |
  343. |                                                                    |
  344. |                                                                    |
  345.  --------------------------------------------------------------------
  346.  
  347.  
  348. Registered Versions Of SAK
  349. --------------------------
  350.  
  351. Registered ($45):
  352.             - Will come customized to your company name
  353.             - Biannual update data will be supplied free of charge
  354.               for one year
  355.             - Additional User Groups DataBase
  356.             - Additional Module to write your own custom mail-merge
  357.               letter
  358.             - Dialer
  359.             - Terminal program
  360.  
  361.  
  362. Professional($99):
  363.             - All above
  364.             Plus
  365.             - Will come with a user definable company name
  366.  
  367. Report Writer Option($250):
  368.             - All above
  369.             - A Commercial Report Writer registered to your name
  370.             - Dialer
  371.             - Terminal program
  372.  
  373. Customizing The Registered User Letters ($10)
  374.             - Letter output will be customized with your own letter
  375.             - Only $10 per customization
  376.  
  377. Shareware Version On Disk($3) to cover shipping and handling.
  378.  
  379.  
  380.  
  381.                              ┌──────────┐
  382.                              │ APPENDIX │
  383.                              └──────────┘
  384.  
  385.  
  386.    APPENDIX A - ERROR MESSAGES
  387.    ---------------------------
  388.  
  389.           If an error occurs, SAK will generate one of ERROR.DMP file
  390.           in the subdirectory where it is residing. Please include this
  391.           files in any bug report to GroupWare.
  392.  
  393.           User Errors:
  394.           ------------
  395.  
  396.            1. Insufficient DOS memory for SAK to run. Remove resident
  397.                programs to increase available memory.
  398.  
  399.            2. "Request for Expanded Memory failed". SAK requires at least
  400.                16K LIM 3.2 Expanded Memory per megabyte of data on your
  401.                disk to run. It will also auto detect EMS.
  402.  
  403.            3. "Corrupted key files". Delete all of the files with the
  404.               extension .K** and rerun SAK. They will be rebuilt
  405.               automatically.
  406.  
  407.            4. "The sector size of this disk is not 512 bytes. Under DOS
  408.                versions 2, SAK works only on disks with 512-byte sectors."
  409.  
  410.            5. If you find a particular software is conflicting with
  411.               SAK, please let us know.
  412.  
  413.  
  414.    APPENDIX B - Bug Reports
  415.    ------------------------
  416.       If an error occurs , SAK will generate an ERROR.DMP file in the
  417.       subdirectory where it is residing. Please send the contents of
  418.       this file along with your comments by filling up the form provided
  419.       at below.
  420.  
  421. -------------------------------------------------------------------------------
  422.  
  423.  
  424.      Name ____________________________________________________________
  425.  
  426.      Address _________________________________________________________
  427.  
  428.      Company _________________________________________________________
  429.  
  430.      City ________________________ State ____________ ZIP ____________
  431.  
  432.      Voice Phone Number   (_____) ____________________________________
  433.      
  434.      Phone (_____)______________  Business Phone (_____)______________
  435.  
  436.      FAX (_____)_______________      BBS Number (_____)_______________
  437.  
  438.      MCI-Mail:____________ Compuserve:______________Bix:______________
  439.  
  440.      Type: PC___ XT___ AT___ 386___ 486___ Others___ Not Sure___
  441.  
  442.      Amount of RAM __________
  443.  
  444.      Monitor type:   MGA___ CGA___ EGA___ VGA___ Multi-sync___ Others___
  445.                      NotSure____
  446.  
  447.      Display adapter type:  MGA___ CGA___ EGA___ VGA___ Others___
  448.                             Not Sure___
  449.  
  450.      Disk drive type: (Check all that applies)
  451.                        5.25"
  452.                        1.2Meg___ 360k___ Not Sure___
  453.  
  454.                        3.5"
  455.                        1.44Meg___ 720k___ Not Sure___
  456.  
  457.      Hard disk: Yes___ No___ Not Sure___, if yes, Size__________
  458.  
  459.      Printer: Yes___ No___ Not Sure___,
  460.               if yes, Dot Matrix___ and/or Laser Printer___
  461.               80 column___ 132 column___ Not Sure___
  462.  
  463.      Modem: Yes___ No___ Not Sure___,
  464.             If yes, Baud Rate__________, External___ Internal___,
  465.             is it a FAX/Modem: Yes___ No___ Not Sure___
  466.  
  467.      Input device: (Check all that applies)
  468.                    Joystick___ Mouse___ Scanner___ Others___ Not Sure___
  469.  
  470.       Do you use a network? Which one?
  471.  
  472.       _________________________________________________________________
  473.  
  474.  
  475.       Your comments:
  476.  
  477.  
  478.       -----------------------------------------------------------------
  479.  
  480.  
  481.       -----------------------------------------------------------------
  482.  
  483.  
  484.       -----------------------------------------------------------------
  485.  
  486.  
  487.  
  488.    APPENDIX C - TECHNICAL SUPPORT
  489.    ------------------------------
  490.  
  491.    If you need further assistance please write to:
  492.  
  493.    GroupWare
  494.    Att: Ismail Arslangiray
  495.    PO BOX 300
  496.    Dupont, WA 98327-0300
  497.  
  498.    On-line support:
  499.    ----------------
  500.  
  501.    BBS:        If you have access to a Hayes compatible modem you may call
  502.                GroupWare BBS @ 24hrs/day 206-581-9088 and you may leave a
  503.                message. You may also download the latest version of this
  504.                program too. (Fido Net 1:138/116 and 1:138/120)
  505.  
  506.    BIX:       If you have access to BIX, you can contact GroupWare under the
  507.               "Iarslangiray:.
  508.  
  509.    CIS:       If you have access to Compuserve you can contact GroupWare
  510.               under the Compuserve ID: 70274,423
  511.  
  512.  
  513.    MCI-Mail : If you have access to MCI Mail, you may contact GroupWare at
  514.               GROUPWARE.
  515.  
  516.    FAX:       If you have an access to fax, you may contact us at
  517.               206-588-1588.
  518.  
  519.   APPENDIX D - Suppliers
  520.   ----------------------
  521.   This list of suppliers are recommended by GroupWare due to good
  522.   reputations, very reasonable prices and professional services.
  523.  
  524.   Diskette-Mailing-Copying-Duplicating-Labels:
  525.  
  526.      BEST COMPUTER SUPPLIES
  527.      PO BOX 1826
  528.      Oakdale, CA 95361
  529.  
  530.      (800) 544-3472
  531.  
  532.      BRAUN MEDIA SERVICES
  533.      7600 Golden Triangle Dr.
  534.      Eden Praire, MN 55344
  535.  
  536.      (612) 943-4033
  537.      (800) 433-DUPE
  538.      (612) 943-4036 FAX
  539.  
  540.  
  541.      CORPORATE DISK COMPANY
  542.      435 Bennett Road
  543.      Elk Grove Village, IL  60007
  544.  
  545.      (708) 439-DISK
  546.      (800) 634-DISK
  547.  
  548.  
  549.      MEI
  550.      4115 Leap Road
  551.      Hillard OH 43026
  552.  
  553.  
  554.      MOORE BUSINESS PRODUCTS DIVISION
  555.      PO BOX 5000
  556.      Vernon Hills, IL 60061
  557.  
  558.      (800) 323-6230
  559.  
  560.  
  561.      NEBS NEW ENGLAND BUSINESS SERVICE INC.
  562.      500 Main St.
  563.      Groton, MA 01471
  564.  
  565.      (800) 225-6380
  566.  
  567.      SOFTWARE PRODUCTION INC.
  568.      13312 SE 30th St
  569.      Bellevue, WA 98005
  570.  
  571.      (206) 746-7467
  572.      (800) 359-0953
  573.      (206) 641-6357 FAX
  574.  
  575.  
  576.