home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / lan / pm231.arj / PMSWAP.ZIP / README.TXT < prev   
Text File  |  1991-08-25  |  8KB  |  188 lines
  1. ┌──────────────────────────────────────────────────────┐
  2. │                                                      │
  3. │   Pmswap.exe - a context switcher for Pegasus Mail,  │
  4. │   (c) 1991, David Harris, Dunedin, New Zealand.      │
  5. │                                                      │
  6. └──────────────────────────────────────────────────────┘
  7.  
  8. PLEASE READ THIS FILE VERY CAREFULLY!
  9.  
  10. Pmswap allows you to use Pegasus Mail almost as if it were a TSR: it
  11. swaps out part of the foreground application, then loads Pegasus Mail
  12. into the freed memory. When you leave Pegasus Mail, the original
  13. application is restored, and you pick up where you left off.
  14.  
  15. Pmswap will swap the foreground application to EMS memory, XMS
  16. memory, or to disk, and occupies from 1.5KB to 6KB of RAM depending
  17. on the swapping mechanism used.
  18.  
  19. Like Pegasus Mail, Pmswap is free, copyrighted software. It is not
  20. Shareware, nor is it in the Public domain. You may use and distribute
  21. Pmswap freely and without restriction provided it is not sold, or
  22. modified in any way.
  23.  
  24. ┌─────────────────────────────────────────────────────────────────────────┐
  25. │ ┌──────────────────────────────────────────────────────────────────────┐│
  26. │ │ *** NOTE *** PMSWAP will NOT work if you are using the Novell XMSNET ││
  27. │ │ shell in your system.                                                ││
  28. │ └──────────────────────────────────────────────────────────────────────┘│
  29. └─────────────────────────────────────────────────────────────────────────┘
  30.  
  31.  
  32. Installing Pmswap
  33.  
  34. To install Pmswap, copy the file Pmswap.exe to your fileserver, or
  35. local hard disk. Since Pmswap may be freely distributed, you can
  36. install it on as many machines as you wish. Of course, Pegasus Mail
  37. should already be installed on your server (or else there's very
  38. little point in having Pmswap!).
  39.  
  40.  
  41. Running Pmswap
  42.  
  43. Running Pmswap is a little trickier: you will probably want to create
  44. a batch file to do this, since there are several parameters which
  45. must be passed on the command line. Normally, you will invoke Pmswap
  46. as follows:
  47.  
  48.    pmswap /ttemporary_dir /ppmail_dir
  49.  
  50. Both the /t and /p switches MUST be supplied on the command line.
  51. If you are using QEMM-386 by Quarterdeck systems, you CAN load Pmswap
  52. into high memory.
  53.  
  54. /t is used to indicate a directory in which Pmswap can create
  55. temporary files if necessary. This directory should preferably be on
  56. a local hard disk, but can be on a network path provided you have
  57. full rights and at least 360KB available disk in that path. Do NOT
  58. use a path to a floppy disk! This can have disastrous results. /t CAN
  59. point to a RAM disk, which will result in huge performance gains.
  60. The RAM disk must have at least 360KB available at all times.
  61.  
  62. /p is used to tell Pmswap where to find Pegasus Mail: provide a path
  63. to the directory which contains Pmail.exe, but do not include
  64. Pmail.exe itself in the path.
  65.  
  66. Note that both the /p and /t switches require fully-qualified paths
  67. (that is, paths including a drive letter, starting at the root
  68. directory and working down to the target directory). Both switches
  69. also must NOT have spaces between the switch letter and the path.
  70.  
  71. Confused? Perhaps an example will help; say you store Pmail.exe in a
  72. directory called \public\utils, which is always accessible from the
  73. Y: drive, and you have a local drive with a directory called \scratch
  74. where you create temporary files: you will invoke Pmswap as follows:
  75.  
  76.       pmswap /tc:\scratch /py:\public\utils
  77.  
  78.  
  79. Other switches:
  80.  
  81. When loading Pmswap, there are two other switches you can use, to
  82. control the sort of memory Pmswap will use.
  83.  
  84.    /E   - tells Pmswap NOT to use EMS memory if present.
  85.    /X   - tells Pmswap NOT to use XMS memory if present.
  86.  
  87. By default, Pmswap will use XMS if it can find it, then EMS if it can
  88. find it, or lastly, it will swap to disk. Note that you MUST provide
  89. the /t and /p switches even if you have either EMS or XMS.
  90.  
  91.  
  92. Invoking Pmswap
  93.  
  94. After you have loaded Pmswap, you can tell it to load Pegasus Mail
  95. for you at any time by pressing <Alt-.> (Hold down the Left Alt key
  96. and press the full-stop character). Pegasus Mail always starts as if
  97. freshly loaded, on the main menu. When you quit from Pegasus Mail
  98. (either by selecting "Quit" from the main menu, or by pressing
  99. <Alt-F10>) you will be returned to the foreground application.
  100.  
  101.  
  102. Gotchas!
  103.  
  104. Well, there always have to be a few problems! Here are some things
  105. you should watch for when using Pmswap.
  106.  
  107. *  Don't switch to Pmail when the foreground application is a
  108. connection-oriented program like or Procomm Plus: the result
  109. will almost certainly hang your computer. I have tested PMSWAP with
  110. NCSA Telnet, and it appears to work OK.
  111.  
  112. *  Pmswap will NOT pop up over Microsoft Windows in any mode. Run
  113. Pegasus Mail in a DOS session from Windows instead.
  114.  
  115. *  Pmswap will probably not work well over programs which run in
  116. Graphics modes.
  117.  
  118. *  Do NOT switch to Pmail when the foreground application is Pmail!
  119. Although this won't crash the machine, it can have surprising and
  120. unpredictable effects.
  121.  
  122. *  You will probably not be able to use an external editor from a
  123. TSR-loaded version of Pmail (unless it is quite small).
  124.  
  125. *  If absolutely nothing happens when you press <Alt-.>, check that
  126. the directories you gave on the command line are still valid - in
  127. particular, make sure that you haven't deleted the drive mapping to
  128. Pmail.exe.
  129.  
  130. *  ALWAYS use the /E switch with Pmswap (that is, disable the use of
  131. Expanded memory) if you are using Novell's EMSNETx shell. Pmswap
  132. and the shell do not agree if they both attempt to use the same type
  133. of memory.
  134.  
  135.  
  136. About Pmswap
  137.  
  138. Pmswap is contructed from a TSR toolkit sold by Microsystems Software
  139. Inc, called CodeRunneR. This set of libraries for Turbo-C and MSC is
  140. one of the slickest and most impressive I have seen, and provides
  141. everything you could possibly need to build almost any type of TSR,
  142. including BCD math, Multiple hot keys, task scheduling, full DOS
  143. access from TSRs, and incredibly small TSR size. CodeRunneR costs
  144. from US$195 to US$495 depending on the accessory kits you buy. The
  145. actual process of building Pmswap using CodeRunneR only took a few
  146. hours (mostly spent reading the documentation).
  147.  
  148.      Microsystems Software Inc,
  149.      600 Worcester Road,
  150.      Framingham, MA 01701.
  151.      Ph: (508) 626-8511, Fax: (508) 626-8515.
  152.  
  153.  
  154. Pmswap is NOT Public Domain software, nor is it Shareware: like
  155. Pegasus Mail, it is a fully-copyrighted program which the author
  156. chooses to give away. All rights to Pmswap are reserved by the
  157. author. Pmswap may not be sold, either on its own, or as part of any
  158. other package.
  159.  
  160.  
  161. Contacting the author:
  162.  
  163. The author can be reached on the internet as david@otago.ac.nz. To
  164. mail from CompuServe, send to internet:david@otago.ac.nz. On BIX, I
  165. can be reached as dave_h.
  166.  
  167.  
  168. Disclaimer
  169.  
  170. Pmswap has been tested on as many machines as I have been able to
  171. find, under as many situations as possible. Despite this, and because
  172. of both the program's nature, and its free distribution, no warranty
  173. of fitness for any purpose is provided, and the author accepts no
  174. liability for any disasters resulting from its use. By using Pmswap,
  175. you accept this disclaimer in full.
  176.  
  177.  
  178. Enjoy!
  179.  
  180. -- David Harris --
  181. PC Consultant, Computing Services Centre, 
  182. University of Otago, Dunedin, New Zealand
  183.  
  184. Note: Pmswap, Pegasus Mail and associated programs are not products
  185. of, nor are endorsed by the University of Otago, although the author
  186. gratefully acknowledges the support the University has given.
  187.  
  188.