home *** CD-ROM | disk | FTP | other *** search
/ norge.freeshell.org (192.94.73.8) / 192.94.73.8.tar / 192.94.73.8 / pub / computers / pcjr / utility / SWAP170.LZH / SDOC70.COM / SWAP.DOC < prev    next >
Text File  |  1990-06-01  |  65KB  |  1,683 lines
  1.  
  2.  
  3.                           The SWAP Utilities(TM)
  4.  
  5.  
  6.                          Version 1.70 -- 04/25/90
  7.  
  8.  
  9.  
  10.                         SWAPSK(TM) -- For SideKick
  11.                       SWAPSP(TM) -- For SideKick Plus
  12.                          SWAPTN(TM) -- For Tornado
  13.                           SWAPMT(TM) -- For Metro
  14.                        SWAPMM(TM) -- For MemoryMate
  15.                       SWAPSH(TM) -- For PCTools Shell
  16.                      SWAPDT(TM) -- For PCTools Desktop
  17.                     SWAPNG(TM) -- For The Norton Guides
  18.  
  19.  
  20.      The SWAP Utilities(TM) and this Documentation are:
  21.  
  22.      Copyright 1989-90, Innovative Data Concepts
  23.      All Rights Reserved.
  24.  
  25.  
  26.      Innovative Data Concepts
  27.      1657 The Fairways
  28.      Suite 101
  29.      Jenkintown, PA 19046
  30.      1-215-884-3373
  31. This  document;   other  accompanying  written  and  disk-based  notes  and
  32. specifications; and  all referenced  and related program files accompanying
  33. this document are copyrighted by Innovative Data Concepts.
  34.  
  35. Licensing  and  distribution  requirements  are  described  later  in  this
  36. document.  For ordering information, see the included ORDER.DOC file.
  37.  
  38.  
  39.  
  40.                   _______
  41.              ____|__     |               (R)
  42.           --|       |    |-------------------
  43.             |   ____|__  |  Association of
  44.             |  |       |_|  Shareware
  45.             |__|   o   |    Professionals
  46.           -----|   |   |---------------------
  47.                |___|___|    MEMBER
  48.  
  49.  
  50. The SWAP  Utilities are  distributed as  shareware --  this means  that  we
  51. encourage  users,   subject  to   restrictions  described  in  the  License
  52. Agreement, to  share copies  of this  program with  friends, associates and
  53. bulletin boards.   You  may not  share the  registered version  of The SWAP
  54. Utilities;   however, you  may request  a free shareware disk by completing
  55. the form in ORDER.DOC.
  56.  
  57. If you make copies of The SWAP Utilities, you must include all files in the
  58. original distribution files, as well as the documentation archive.  You are
  59. not permitted  to distribute  The SWAP Utilities without this documentation
  60. (normally stored as SWAPDO.COM).
  61.  
  62. Innovative Data  Concepts is  a member  of  the  Association  of  Shareware
  63. Professionals.   ASP has  established stringent  standards for its members.
  64. ASP wants  to make sure that the shareware principle works for you.  If you
  65. are unable  to resolve  a problem  with an ASP member (other than technical
  66. support), ASP  may be  able to  help.  Please write to the ASP Ombudsman at
  67. P.O. Box 5786, Bellevue, WA 98006.
  68.  
  69.                          Documentation Conventions
  70.  
  71. Throughout this documentation, the individual SWAP Utility programs will be
  72. referred to  collectively by  the term,  SWAP??.  The installation programs
  73. will be  referred to  as TEST??.   If  something applies  specifically to a
  74. single SWAP Utility program, the full name of the program will be used.
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89. Page 2                                    SWAP Utilities 1.70 Documentation
  90.                       About the Version 1.70 Release
  91.  
  92. Version 1.70  was primarily  designed to  add support  for PC  Tools Deluxe
  93. Version 6.0.   SWAPDT now supports Desktop Macros and Alarms.  SWAPSH works
  94. with the  new 4DOS  3.0, as  well as  supporting all  the new  features  of
  95. PCShell Version 6.0.
  96.  
  97. For the other utilities, the changes were not so obvious.  Primarily, we've
  98. added the  /P command-line  option, which gives you direct control over the
  99. size of  the internal  paste buffer  SWAP??  uses.    In  addition,  memory
  100. requirements for most utilities have been reduced.
  101.  
  102. Support for  EGA/VGA cards  has been enhanced.  DESQview 2.26 is now fully-
  103. supported.   ^C is  now  passed  through  to  applications  that  use  that
  104. keystroke.
  105.  
  106. SWAPMM now  supports the  ^P key  for pasting,  and functions  in the  same
  107. fashion that  MEMO does  (only ONE  paste permitted).   SWAPMT  has minimal
  108. support for MetroKernal 1.0, and enhanced support for macros.
  109.  
  110. SWAPNG will  now correctly change all hotkeys if the defaults are not used.
  111. SWAPSP will  now load  correctly if  an alarm is scheduled to go off during
  112. the loading process.
  113.  
  114. There were  no obvious changes for either SWAPSK and SWAPTN, other than the
  115. general changes mentioned above.
  116.  
  117.  
  118.                              Acknowledgements
  119.  
  120. Without Anne Marie, none of this would be possible.  Thanks, Love .....
  121.  
  122. Once again, my beta testers were terrific.  Last time, I got in trouble for
  123. not mentioning  everyone, so  i think  I'll just tell them ALL that they're
  124. about the best beta-test team a person could ask for.
  125.  
  126. Special thanks  to Marilyn  Ratcheson for  her assistance in preparing this
  127. documentation.
  128.  
  129. Many thanks to J.D. Hildebrand, Jim Kyle and Computer Language Magazine for
  130. their wonderful support of my on-line beta testing.
  131.  
  132.  
  133.                                 TradeMarks
  134.  
  135.      SWAPSK, SWAPSP,  SWAPTN, SWAPMT,  SWAPMM, SWAPSH,  SWAPDT, SWAPNG  and
  136.           The SWAP Utilities are trademarks of Innovative Data Concepts.
  137.      SideKick and  SideKick  Plus  are  registered  trademarks  of  Borland
  138.           International, Inc.
  139.      Tornado is a trademark of Micro Logic Corp.
  140.      Metro and Express are trademarks of Lotus Development Corporation.
  141.      MemoryMate is a trademark of Broderbund Software.
  142.      TesSeRact is a trademark of the TesSeRact Development Team.
  143.      DESQview and QEMM-386 are trademarks of Quarterdeck Office Systems.
  144.      Software Carousel is a trademark of SoftLogic Solutions, Inc.
  145.      386Max is a trademark of Qualitas, Inc.
  146.  
  147.  
  148. SWAP Utilities 1.70 Documentation                                    Page 3
  149.                              Table of Contents
  150.      Introductory Notes..............................................2
  151.      Documentation Conventions.......................................2
  152.      About the Version 1.70 Release..................................3
  153.      Acknowledgements................................................3
  154.      TradeMarks......................................................3
  155.  What are The SWAP Utilities?........................................5
  156.  Installation........................................................6
  157.      Running TEST??.COM..............................................6
  158.      DESQview........................................................6
  159.          If your Shift-Keys "stick"..................................6
  160.  Quick Start.........................................................7
  161.      Loading SWAP?? into "high" memory...............................7
  162.  The SWAP?? Command-Line.............................................8
  163.      Detailed Explanation of Command Line Options....................9
  164.      Selecting Hot Keys.............................................11
  165.      Sample Command Lines...........................................11
  166.  How The SWAP Utilities use memory..................................12
  167.      Expanded Memory................................................12
  168.      Extended Memory................................................12
  169.      Disk Virtual Memory............................................12
  170.  IMPORTANT NOTES....................................................13
  171.      General Notes for All Utilities................................13
  172.      Note for Microsoft Word Users..................................13
  173.      Technical Information about SWAP?? TSRs........................14
  174.      Notes for Specific SWAP Utilities..............................15
  175.          SWAPSK.....................................................15
  176.          SWAPSP.....................................................15
  177.          SWAPTN.....................................................15
  178.          SWAPMT.....................................................15
  179.          SWAPSH.....................................................16
  180.          SWAPDT.....................................................17
  181.          SWAPNG.....................................................17
  182.          SWAPMM.....................................................17
  183.      Supported Versions.............................................17
  184.  If Something Goes Wrong............................................18
  185.      Technical Support..............................................18
  186.      Common Questions & Answers.....................................19
  187.      Error Message Descriptions.....................................19
  188.  COPYRIGHT NOTICE AND LICENSE.......................................21
  189.      Warranty.......................................................21
  190.      Registration...................................................21
  191.      Bulletin Boards, Users Groups and Disk Vendors.................21
  192.  About Innovative Data Concepts.....................................23
  193.  The Rest of The SWAP Utilities.....................................23
  194.      Introducing SWAPDOS............................................24
  195.      For Task-Switching Use ........................................26
  196.  Association of Shareware Professionals.............................28
  197.      Standards for the Association of Shareware Professionals.......28
  198.          PROGRAMMING................................................28
  199.          DOCUMENTATION..............................................28
  200.          SUPPORT....................................................28
  201.          GENERAL....................................................29
  202.  
  203.  
  204.  
  205.  
  206.  
  207. Page 4                                    SWAP Utilities 1.70 Documentation
  208.                        What are The SWAP Utilities?
  209.  
  210. The SWAP  Utilities  intercept  certain  DOS  calls  made  by  ram-resident
  211. applications, and  "swap" the entire resident portion of the application to
  212. extended or expanded memory, or to disk files.  For most applications, this
  213. will greatly decrease the amount of "real" RAM needed to load these popular
  214. resident programs.
  215.  
  216. When used  in conjunction  with a  memory manager  with "high  DOS  memory"
  217. capabilities, The  SWAP Utilities will permit you to run these TSRs in zero
  218. bytes of  low DOS  memory.   Some examples  of these  memory  managers  are
  219. Qualitas' 386Max  and Move-Em  products, or  Quarterdeck's  QEMM  and  QRAM
  220. products.
  221.  
  222. The memory  requirements (excluding environment space) for the various SWAP
  223. Utilities are:
  224.  
  225.      SWAPDT -- 7644 bytes
  226.      SWAPSH -- 6816 bytes
  227.      SWAPSP -- 6944 bytes
  228.      SWAPSK -- 6608 bytes
  229.      SWAPTN -- 6512 bytes
  230.      SWAPMM -- 6656 bytes
  231.      SWAPNG -- 6480 bytes
  232.      SWAPMT -- 7936 bytes
  233.  
  234. If swapping  to disk,  two swapfiles are created in the drive and directory
  235. specified with  command line option /D or the TEMP environment variable.  A
  236. third swapfile is created no matter what swapping method you have selected.
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266. SWAP Utilities 1.70 Documentation                                    Page 5
  267.                                Installation
  268.  
  269.                             Running TEST??.COM
  270.  
  271. Before running  each swap  utility for  the first  time, you  must run  its
  272. matching TEST??.COM  program.   TEST??.COM will  detect your  hotkeys,  and
  273. otherwise  configure   SWAP??  to   match  your   individual  copy  of  the
  274. application.
  275.  
  276. Copy the  appropriate SWAP??.COM and TEST??.COM files to the directory that
  277. contains your  application.  If, for example, you are installing SWAPSP.COM
  278. to swap  Borland International's  SideKick+, copy SWAPSP.COM and TESTSP.COM
  279. to the  directory on  which your SKPLUS files are stored.  While at the DOS
  280. prompt in that directory, type the following:
  281.  
  282.      TESTSP[ENTER]
  283.  
  284. TEST?? takes  no command-line  parameters, and  will  display  a  group  of
  285. hexadecimal addresses.   If  you  have  any  problems  with    SWAP??,  the
  286. information provided  by TEST??.COM  will  help  Innovative  Data  Concepts
  287. identify and correct them.
  288.  
  289. Once TEST??  has been  run, it is only necessary to run it again if you re-
  290. install your  application, change  operating  parameters  as  with  SKPLUS'
  291. INSTALL program, or otherwise change the configuration or hotkeys.
  292.  
  293. If you make any such changes, it is essential that you run TEST?? again.
  294.  
  295. WARNING!!   If you  use a program that compresses executable files, such as
  296. LZEXE, you must decompress them before running TEST??.
  297.                                  DESQview
  298.  
  299. In order to successfully use any of The SWAP Utilities loaded globally with
  300. DESQview, you must run TESTDV.COM first.
  301.  
  302. Copy TESTDV.COM and T2-PIF.DVP into your DESQview directory. If you already
  303. have a  T2-PIF.DVP, re-name  the one  provided with The SWAP Utilities to a
  304. different filename.   Select  Add a  Program, and  add the  "SWAP Utilities
  305. Configuration" to  your program  list.  Then, open the window, jot down the
  306. options specified  by TESTDV,  and add them to your SWAP?? command line(s).
  307. Once you  run TESTDV,  it is  only needed again if you change the TSRs that
  308. you load globally with DV.
  309.  
  310. If the  application program  you're using has multiple memory size options,
  311. as do  SK+, Desktop,  Metro, then  you must install that program to use the
  312. maximum resident size possible, since these programs are not DV aware.
  313.  
  314. Version 1.70  of The  SWAP Utilities has added support for DV 2.26 and QEMM
  315. 5.0.  Previous versions of DESQview may conflict with The SWAP Utilities on
  316. 386 machines.
  317.                         If your Shift-Keys "stick"
  318.  
  319. DESQview 2.26 added a new DVSETUP option for keyboards:  "Maintain Separate
  320. Shift States."   TSR  users who  have this option set YES may find that the
  321. shift keys  (ctrl, alt,  shift) may  "stick" after  popping down from a TSR
  322. such as The SWAP Utilities.  Re-running DVSETUP, and setting this option to
  323. NO will solve this problem.
  324.  
  325. Page 6                                    SWAP Utilities 1.70 Documentation
  326.                                 Quick Start
  327.  
  328. After installing your SWAP?? program, re-boot your computer without loading
  329. the companion  program.   Change to  the directory  where your  program  is
  330. located, and type:
  331.  
  332.      SWAP?? [ENTER]
  333.  
  334. You will  see the SWAP Utility sign-on messages, and then you will see your
  335. application loaded  into memory.   Immediately  thereafter,  you  will  see
  336. additional messages  explaining what  kind of memory was used for swapping,
  337. and how  much memory is really available, rather than what your program may
  338. have reported.   Note  that this memory value is in Kilobytes of RAM -- 10K
  339. is 10,240 bytes, not 10,000.
  340.  
  341. Once you've seen how the SWAP?? program operates, you will probably want to
  342. add it  to your  AUTOEXEC.BAT file,  and have  it automatically  load  your
  343. program when you boot your computer.
  344.  
  345. To do  this, add  the following line to your AUTOEXEC.BAT file, immediately
  346. before the line in the file that loads your application program:
  347.  
  348.      SWAP?? /N [ENTER]
  349.  
  350. The "/N"  option, more  fully-described below,  tells the SWAP Utility that
  351. you will  load the  application program through a batch file, and it should
  352. not attempt to load it when you return to the DOS prompt.
  353.  
  354. The SWAP  utility memory  report may  differ from  what is reported by your
  355. application.   For ethical reasons, it is not possible to change the signon
  356. screen of  your application,  to reflect  the correct  memory usage.    The
  357. memory report  you will  see from  your application  is pessimistic  -- the
  358. value that the SWAP utility displays is correct.
  359.  
  360. The display  will also  tell you  what kind  of memory  was  used  for  the
  361. swapping; extended memory, expanded memory, or disk virtual memory.  If for
  362. any  reason  the  SWAP  utility  was  unable  to  correctly  swap  out  the
  363. application, a  message will be displayed notifying you of that occurrence,
  364. and both the SWAP utility and the application will be removed from memory.
  365.  
  366. You may  load any or all of the SWAP utilities sequentially into RAM at the
  367. same time or load each one as needed.
  368.  
  369.                      Loading SWAP?? into "high" memory
  370.  
  371. If you  have a  hardware/software  combination  that  allows  you  to  load
  372. resident programs  into "high" DOS memory, such as QEMM-386 or 386Max, then
  373. The SWAP Utilities may be loaded to take up zero low DOS memory.
  374.  
  375. If your  software uses  a program  such as  "LOADHI.COM" or  "386LOAD.COM",
  376. simply follow  the syntax  for loading SWAP?? into high memory.  Be sure to
  377. use the  /N switch!  Then load your application program into normal memory.
  378. SWAP?? will take care of removing your application from RAM.
  379.  
  380.  
  381.  
  382.  
  383.  
  384. SWAP Utilities 1.70 Documentation                                    Page 7
  385.                           The SWAP?? Command-Line
  386.  
  387. The command syntax for SWAP?? programs is:
  388.  
  389.   SWAP?? [options]
  390.  
  391.   Where:
  392.  
  393.   Options are one or more of the options listed below.  Options may be
  394.   preceded by either a '-' or '/' as a switch character.
  395.  
  396.   Valid options are:
  397.  
  398.   /H /? ? -- Display a help screen
  399.   /N      -- When used in a batch file
  400.   /U      -- Remove SWAP?? and application from RAM
  401.   /Dpath  -- FULL  PATHNAME to store swap files on (if not enough EMS is
  402.                present)
  403.   /Sx     -- Set Swapping type (0=Auto, 1=Disk, 2=EMM, 3=XMS)
  404.               SwapType  = 0  is the  default;  if  selected  type  fails
  405.                (i.e.,no XMS is available with /S3), auto-check is done.
  406.   /G      -- Enable popping up over graphics modes
  407.   /Tx     --  Pasting  Throttle  (0=slow,  1=medium,  2=fast,  3=compat)
  408.                [default=2]
  409.   /Px     -- Paste  Buffers (0=minimum,  9=Maximum; Each buffer uses 256
  410.                bytes)
  411.   /Vx     -- Special DESQview Options
  412.  
  413.   FOR SWAPMT ONLY
  414.   /E      -- Special switch for Lotus Express users
  415.  
  416.   FOR SWAPEX ONLY
  417.   /Pxxx   -- xxx  is the  number of minutes between automatic polling of
  418.                MCIMAIL.
  419.   /Ay     -- y = letter of your Lotus Express Comm_Manager application
  420.  
  421.   To set the hotkey
  422.      /A -- Use Alt-Key for hotkey shift state
  423.      /C -- Use Ctl-Key for hotkey shift state
  424.      /L -- Use Left-Shift-Key for hotkey shift state
  425.      /R -- Use Right-Shift-Key for hotkey shift state
  426.      /Kxx -- Scan code for hotkey to use (see chart in documentation)
  427.               requires two HEX digits following the /K
  428.  
  429.  
  430. All utilities except SWAPTN automatically default to the hotkey combination
  431. that you  are currently using for the application.  SWAPTN defaults to ALT-
  432. J, because this is only configurable on the TN command-line.
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443. Page 8                                    SWAP Utilities 1.70 Documentation
  444.                Detailed Explanation of Command Line Options
  445.  
  446. /N --  If the  /N switch  is used,  The SWAP utility will not automatically
  447. place the  appropriate keystroke  combination to  load the application into
  448. the keyboard  buffer when  it goes resident.  This option must be used when
  449. loading The  SWAP Utilities  from a  batch file.  After loading SWAP?? with
  450. the /N switch from within a batch file, then loading the application, using
  451. the appropriate  hotkey will call the application in the same fashion as if
  452. the application  had been  loaded from the DOS command line and was already
  453. resident.
  454.  
  455. /U --  Use this  option to  cleanly remove SWAP?? and your application from
  456. RAM. If  disk swapping  is in  use, the  swap files  will be deleted before
  457. freeing memory.   If  the application also uses expanded memory, it will be
  458. freed as  well.   If the  application uses  disk-based swap  files (such as
  459. those SideKick Plus uses) they will not be deleted.
  460.  
  461. In general,  do not  attempt to  use a  particular applications "unload" or
  462. "remove from  memory" feature.   It  won't work, and will in all likelihood
  463. crash your machine.  Use the /U feature of the SWAP utility instead.
  464.  
  465. /Sx --  The /S  parameter determines  the type  of swapping to use.  In the
  466. default Autodetect  mode,  The  SWAP  Utility  will  attempt  to  allocated
  467. expanded memory,  using EMS  version level  3.2 or  later.   If EMS  is not
  468. available, the  utility  will  attempt  to  use  Extended  Memory  that  is
  469. available, using  Microsoft's eXtended Memory Specification (XMS) (See note
  470. about XMS below).
  471.  
  472. If neither  EMS or  XMS is  available, two swap files will  be created, and
  473. SWAP?? will use disk (default, C:\) for swapping.  The /S  parameter can be
  474. used to override the default mode, and force swapping to  XMS, EMS or Disk.
  475. If the  swapping method  specified with  /S is not valid, then Auto mode is
  476. used.   Note that  the third  swapfile (SWAP??.SW3)  is created in the path
  477. specified by  the /D parameter, or the TEMP environment variable, no matter
  478. what swapping method is chosen.
  479.  
  480. /G -- Because there are so many video adapters, and no standard way to deal
  481. with popping  up TSRs  over various  graphics modes, the SWAP Utilities, by
  482. default, inhibit  popping up  over graphics modes.  An exception to this is
  483. Microsoft Word;  The SWAP  Utilities will  always pop  up over MS Word (See
  484. note  about  Microsoft  Word  below)  on  systems  with  standard  graphics
  485. adapters.   Many TSR  applications,  however,  have  built-in  support  for
  486. graphics modes,  so using  the /G switch will enable the application to pop
  487. up, if possible.
  488.  
  489. We recommend you avoid popping up SWAP utilities over graphics modes.  This
  490. is because  no resident  program can  guarantee that it will be safe to use
  491. over all  graphics modes, and on all graphics adapters.  There are just too
  492. many possibilities,  combinations, incompatibilities, etc.  That is why The
  493. SWAP Utilities default to not popping up over graphics modes.
  494.  
  495. /Dpath --  The /D  parameter tells  the SWAP  utility  in  what  drive  and
  496. directory to  store   the swap files.  The default is the root directory on
  497. drive C  (C:\).  The pathname is limited to 30 characters, and must contain
  498. a   valid drive  specification, and  path.   The trailing  backslash is not
  499. necessary. If  the /D parameter is not the last option on the command-line,
  500.  
  501.  
  502. SWAP Utilities 1.70 Documentation                                    Page 9
  503. there must  be a  space character following the pathname and before another
  504. slash option.
  505.  
  506. Note that  at least one disk-based swap file will always be created on this
  507. path.  An example path is: /DC:\TEMP
  508.  
  509. /Tx --  This option may be used to "throttle" down the pasting speed of the
  510. SWAP utility  you are using.  Some applications, such as the Norton Editor,
  511. cannot handle  characters as  fast as  SWAP?? can  feed them,  requiring  a
  512. slower speed  to be  used.   The valid  values here are 0, 1, 2 or, ranging
  513. from slowest  (0) to  fastest (2).   The  /T3 switch is for "compatibility"
  514. mode.   Use this  switch if you are using a program that relocates the BIOS
  515. keyboard buffer,  or expands  the keyboard  type-ahead buffer.  This is the
  516. slowest option,  but pasting  will work  in all cases.  The default is fast
  517. (/T2).
  518.  
  519. /Px --  This option  may  be  used  to  reduce  the  "bounce"  or  "hiccup"
  520. associated with  pasting large  blocks of  text into  an application.   The
  521. default value of '0' gives a 128-byte internal buffer, which is enough room
  522. for  SWAP??   to  paste  64  characters  before  "hiccuping"  back  to  the
  523. application to  get more  keys.  The maximum value of /P9 will allow you to
  524. have more than 1000 additional characters stored in the internal buffer, at
  525. the cost of more than 2K of additional RAM.
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561. Page 10                                   SWAP Utilities 1.70 Documentation
  562.                             Selecting Hot Keys
  563.  
  564. The SWAP Utilities allow the use of more hotkeys than most applications do;
  565. for example,  they will  accept F11  (/K57), or  Ctl-LShift-Q (/C /L /K10).
  566. The following  table can be used to determine the scan codes of the key you
  567. wish to  use with  the /K  parameter; this  is not  a complete table, it is
  568. intended simply as a guide:
  569.  
  570.  
  571.    KEY      CODE     KEY      CODE
  572.   ---------------------------------
  573.     A        1E       B        30
  574.     C        2E       D        20
  575.     E        12       F        21
  576.     G        22       H        23
  577.     I        17       J        24
  578.     K        25       L        26
  579.     M        32       N        31
  580.     O        18       P        19
  581.     Q        10       R        13
  582.     S        1F       T        14
  583.     U        16       V        2F
  584.     W        11       X        2D
  585.     Y        15       Z        2C
  586.     0        0b       1        02
  587.     2        03       3        04
  588.     4        05       5        06
  589.     6        07       7        08
  590.     8        09       9        0A
  591.     -        0C       =        0D
  592.     F1       3B       F2       3C
  593.     F3       3D       F4       3E
  594.     F5       3F       F6       40
  595.     F7       41       F8       42
  596.     F9       43       F10      44
  597.     F11      57       F12      58
  598.  
  599.                            Sample Command Lines
  600.  
  601.      SWAPSP /K58 /T1 /S1 /DE:\ [ENTER]
  602.  
  603. This command would load SWAPSP, swapping to the root directory of drive E:,
  604. using a hotkey of F12, and a paste speed of medium.
  605.  
  606.      SWAPMT/l/a/k25/df:\swappath [ENTER]
  607.  
  608. This would  load  SWAPMT,  swapping  to  EMS  if  available,  otherwise  to
  609. F:\SWAPPATH, with a hotkey of Left-Shift-Alt-K.
  610.  
  611.      SWAPTN /dD:\ /A/k14/S1 [ENTER]
  612.  
  613. This would load SWAPTN, swapping to D:\, with a hotkey of Alt-T.
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620. SWAP Utilities 1.70 Documentation                                   Page 11
  621.                      How The SWAP Utilities use memory
  622.  
  623. The  SWAP  Utilities  are  designed  to  use  your  system's  resources  as
  624. efficiently as  possible.   It is  most efficient to swap to Expanded (EMS)
  625. memory, rather than to use Extended Memory or a Virtual Disk.  Since EMS is
  626. treated as  a part  of the computer's "real-mode" address space, the SWAP??
  627. programs can read and write a single memory location in one fast loop.
  628.  
  629. Unless you  specify which  type of  memory to  use via  the /S command-line
  630. option, SWAP??  will first  attempt to allocate enough EMS for swapping; if
  631. that fails,  XMS will be used; finally, disk-based files will be created in
  632. the swapping drive/directory.
  633.  
  634.                               Expanded Memory
  635.  
  636. When using  EMS for  swapping, the  total amount  of EMS  required  is  the
  637. resident size of your application + its environment area, rounded up to the
  638. nearest 16K boundary.
  639.  
  640. NOTE:   A 4096-byte  disk file  with the  extension ".SW3"  will always  be
  641. created in your swapping path.  This file is required for correct operation
  642. of the  SWAP Utilities, and is created even if you are using EMS or XMS for
  643. swapping.
  644.  
  645.                               Extended Memory
  646.  
  647. To use  extended memory with The SWAP Utilities, you must use a driver that
  648. supports Microsoft's  "eXtended Memory  Specification (XMS),  Version 2.0",
  649. such as  Microsoft's HIMEM.SYS.   The  current versions  of 386MAX and QEMM
  650. both support  XMS on  386 machines;  alternatively, the latest official XMS
  651. driver may  be gotten  free from Microsoft, either through their Compuserve
  652. Forum (GO MSSYS), or by calling Microsoft customer service at (800)426-9400
  653. and asking  for a  copy of  the "XMS  Specification and  it's  supplemental
  654. diskette."
  655.  
  656. If your  computer supports  both XMS  and EMS,  EMS memory is the preferred
  657. choice; using XMS requires almost twice the amount of memory.
  658.  
  659.                             Disk Virtual Memory
  660.  
  661. The third  possibility is  to swap  to a  disk drive.  If your computer has
  662. extended memory,  you may  use either  XMS or  a virtual disk for swapping.
  663. The memory  usage is  virtually the  same  in  either  case,  although  XMS
  664. swapping is  marginally faster  (we're talking fractions of a second on 286
  665. machines, so its nothing to worry about).
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679. Page 12                                   SWAP Utilities 1.70 Documentation
  680.                               IMPORTANT NOTES
  681.  
  682.                       General Notes for All Utilities
  683.  
  684. If you  are swapping  to disk,  two swapfiles  are created in the specified
  685. drive and  directory.   A third swapfile is created no matter what swapping
  686. method you have selected.
  687.  
  688. These swapfiles  must not  be deleted  while the  SWAP utility  is  loaded.
  689. Doing so will cause your machine to crash if you attempt to popup!
  690.  
  691. You must  load The  SWAP Utilities  after all  network drivers,  disk cache
  692. programs, and other programs that require background processing or hook the
  693. device driver  chain.   With these exceptions, load order is not important.
  694. You can  load The  SWAP Utilities  at any  point, early or late in your TSR
  695. order.   You can  also load  The SWAP  Utilities in  "high" DOS memory with
  696. 386Max, QEMM, or other similar programs.
  697.  
  698. You  may  safely  load  a  SWAP  utility  inside  a  Software  Carousel(TM)
  699. partition, or  as a  global SC utility.  You may notice a period of a blank
  700. screen when attempting to swap partitions after having used a SWAP utility,
  701. but be patient, and the partition will change normally.
  702.  
  703. When pasting  large blocks into an application, you will occasionally see a
  704. "hiccup" with the SWAP message on the display -- this is caused by swapping
  705. your application  in and  out,  to  read  the  next  set  of  keys.    Most
  706. applications support virtually unlimited paste buffers, and the memory used
  707. by The SWAP Utilities is limited.
  708.  
  709. In general,  do not  attempt to  use a particular application's "unload" or
  710. "remove from  memory" feature.   It  won't work, and will in all likelihood
  711. crash your machine.  Use the /U feature of the SWAP utility instead.
  712.  
  713. When creating  swap files  for  disk-based  swapping,  The  SWAP  Utilities
  714. default to  the root  directory of  Drive C:.  If you create an environment
  715. string called TEMP with the SET command, the utilities will instead default
  716. to the  directory specified  by that command, and the use of /D will not be
  717. necessary.
  718.  
  719. An example of setting an environment string would be:
  720.  
  721.      SET TEMP=G:\ [ENTER]
  722.  
  723. where G  is a fast RAM disk.  This would cause disk-swapping  to take place
  724. in the  root directory of Drive G:.  The environment variable TEMP must, be
  725. set prior  to loading your SWAP utility.  The programs will attempt to swap
  726. in the  following sequence: 1) Try to swap to  EMS; 2) If /D specified, try
  727. to swap to specified path; 3) Try to find environment variable named "TEMP"
  728. and if  it exists,  swap to  the specified path; 4) Try to swap to the root
  729. directory of  Drive C:;  or, 5)  abort, and remove both the application and
  730. the SWAP utility from memory.
  731.  
  732.                        Note for Microsoft Word Users
  733.  
  734. When using  The SWAP  Utilities with Microsoft Word, you should not use the
  735. /G switch,  even if  you plan  to use  Word in  graphics modes.   The  SWAP
  736. Utilities automatically  detect the  presence of  MS Word  4.0 and 5.0, and
  737.  
  738. SWAP Utilities 1.70 Documentation                                   Page 13
  739. will switch  between text  and graphics modes as needed.  This switch works
  740. on CGA,  EGA VGA  and Hercules  systems with  Word 4.0,  except in Hercules
  741. 90x43 mode.
  742.  
  743. Word 5.0  users who  work in  graphics mode will need to do an extra bit of
  744. setup.  In order for the switch between text and graphics to work, you must
  745. set both text and graphic display modes in the Word 5.0 Options menu.
  746.  
  747. Load Word  5.0, and bring up the Options menu.  Select the appropriate text
  748. display mode  for your system.  Return immediately to the Options menu, and
  749. now select  the graphics display mode you wish to work in. Test the results
  750. by pressing  Alt-F9, to  toggle between text and graphics modes.  Exit from
  751. Word, and you're all set!
  752.  
  753.                   Technical Information about SWAP?? TSRs
  754.  
  755. This product   uses the TesSeRact(TM) Ram-Resident Library and supports the
  756. TesSeRact  Standard for  Ram-Resident Program  Communication.  As a part of
  757. the TesSeRact  standard, it  is possible  for an external program to access
  758. information about a complying TSR.
  759.  
  760. STACKEY, from  CtrlAlt Associates  (call 1-800-872-4768 or 1-301-387-4500),
  761. has a  built-in capability  to "popup"  a  TesSeRact  TSR.    To  use  this
  762. capability, you  need two  pieces of  information:  The TesSeRact ID String
  763. for the particular TSR, as well as the "Hotkey Code" used by the particular
  764. key you're trying to emulate.  The following chart may be used to popup the
  765. various SWAP?? programs:
  766.  
  767.   Product        ID String    Hotkey Code
  768.  
  769.   SWAPSK         SWAPSK15     0
  770.   SWAPSP         SWAPSP15     0 (popup)
  771.                               1 (paste)
  772.                               2 (cut)
  773.                               4 (dial)
  774.   SWAPSH         SWAPSH15     0
  775.   SWAPDT         SWAPDT15     0 (popup)
  776.                               1 (paste)
  777.                               2 (cut)
  778.                               3 (dial)
  779.   SWAPMM         SWAPMM15     0 (popup)
  780.                               1 (paste)
  781.   SWAPTN         SWAPTN15     0
  782.   SWAPNG         SWAPNG15     1
  783.   SWAPMT         SWAPMT15     0
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797. Page 14                                   SWAP Utilities 1.70 Documentation
  798.                      Notes for Specific SWAP Utilities
  799.  
  800.                                 SWAPSK
  801.  
  802. Calculator Paste does not work with SWAPSK.  However, Calculator Paste will
  803. work when  SideKick is popped up, so you can paste from the calculator into
  804. the notepad, and then paste from the notepad into your application.
  805.  
  806.                                 SWAPSP
  807.  
  808. Background communication must be disabled to use SWAPSP.
  809.  
  810. If you're  using Super  PC-Kwik in  EMS, do  not  use  the  /Q+  parameter.
  811. Returning quickly to the DOS prompt will cause problems with SWAPSP.
  812.  
  813. If you  change the Services menu text for "Paste from Clipboard" or "Screen
  814. to Clipboard",  TESTSP will  not be  able to locate the addresses it needs.
  815. These two options must be set to their factory defaults in order for TESTSP
  816. and SWAPSP to run.
  817.  
  818. The Ctrl-Center  key works  as the  default "Display  Dial"  shortcut  key.
  819. However, TESTSP  is unable  to detect  that this  key has been changed as a
  820. shortcut key,  so in  order to  use this  feature, you must use the default
  821. key.
  822.  
  823.                                 SWAPTN
  824.  
  825. You will not be able to load Tornado using the "repeat" option.
  826.  
  827. If you  do not  use the  /N switch,  SWAPTN will load Tornado as "TN 99" to
  828. allow you  the maximum  "pile" size.   There  is no  cost in "real" RAM for
  829. this, so  we recommend you load TN that way yourself, if you are loading it
  830. in a batch file.
  831.  
  832.                                 SWAPMT
  833.  
  834. Some  users   have  found   keyboard  compatibility   problems  when  using
  835. MetroKernal 1.0.   If you have conflicts of this type, please contact Lotus
  836. Development Corp for an upgrade.
  837.  
  838. If you  load METRO  in a  batch file that loads multiple utilities, such as
  839. the EXPRESS.BAT  file that  is created, you must add the following lines to
  840. the batch file to correctly swap out the entire application:
  841.  
  842.   At the beginning of the batch file, before the call to METRO, add:
  843.  
  844.      SWAPMT /N /E  <and any other cmd-line switches you want> [ENTER]
  845.  
  846.   At the end of the batch file, after loading everything, add:
  847.  
  848.      SWAPEX [ENTER]
  849.  
  850. This will ensure that all the METRO applications are correctly swapped.
  851.  
  852.  
  853.  
  854.  
  855.  
  856. SWAP Utilities 1.70 Documentation                                   Page 15
  857. SWAPEX.COM has two command-line switches:
  858.  
  859.   /Pxxx   -- xxx  is the  number of minutes between automatic polling of
  860.                MCIMAIL.
  861.   /Ay     --  y  is  the  letter  of  your  Lotus  Express  Comm_Manager
  862.                application.
  863.  
  864. For example, if you load:
  865.  
  866.      SWAPEX /P60 /AX [ENTER]
  867.  
  868. This tells  SWAPMT to  poll MCIMAIL  every hour, and that Express is "X" on
  869. the METRO  Menu.   Approximately one  minute after  loading SWAPMT, Express
  870. will be popped up and be given the command to manually poll MCIMAIL.
  871.  
  872. This automatic  polling will  not occur  if the underlying application is a
  873. communications program, and if communications interrupts are "hot". If this
  874. situation occurs,  SWAPMT will  attempt to  pop up  at 10 second intervals,
  875. waiting for the communications program to finish.
  876.  
  877. Also, if  a key has been hit within 10 seconds of the scheduled popup time,
  878. SWAPMT will  not pop up, but will attempt to pop up at 10 second intervals.
  879. This will prevent an unwanted popup while you're typing in another program.
  880.  
  881. Any background processing will not take place as scheduled.  You must popup
  882. METRO first.  This includes Express.
  883.  
  884. Alt-Shift-Enter works  as a  paste key,  and all  keyboard  macros  in  the
  885. currently loaded macro file are operational at the DOS prompt.
  886.  
  887.      Use S_RUNKM.COM instead of RUNKM.EXE to run macros from a batch file.
  888.      Use S_LOADKM.COM  instead of  LOADMAC.EXE to  run macros  from a batch
  889.           file.
  890.      The syntax for these programs is the same as their Metro counterparts.
  891.  
  892.                                 SWAPSH
  893.  
  894. DO NOT  USE PC-CACHE.SYS  with SWAPSH, unless you actually have a Bernoulli
  895. Box installed.  PC-CACHE.COM works fine.
  896.  
  897. You must  add the PC Shell's /R switch to the command-line when loading the
  898. program in  a batch  file.   Without the  /R switch, the program loads, but
  899. does not go resident.
  900.  
  901. You may  now execute programs when PCED is active, or when using 4DOS.  You
  902. still must  be at the command-line, but SWAPSH will detect the command-line
  903. with these additional environments.
  904.  
  905. PCRUN.COM must be in your PATH in order to execute programs correctly.
  906.  
  907. The  SWAP  Utilities  can  swap  memory  in  and  out  faster  than  Shell.
  908. Therefore, if you do not use the /N switch, SWAPSH will load Shell with the
  909. /RLARGE parameter, forcing Shell to use as much memory as possible.
  910.  
  911.  
  912.  
  913.  
  914.  
  915. Page 16                                   SWAP Utilities 1.70 Documentation
  916.                                 SWAPDT
  917.  
  918. You must  add PC  Desktop's /R  switch to the command-line when loading the
  919. program in  a batch  file.   Without the  /R switch, the program loads, but
  920. does not go resident.
  921.  
  922. Alarms are  fully-functional.   Keyboard macros work both inside DT as well
  923. as inside your applications.
  924.  
  925.                                 SWAPNG
  926.  
  927. No special instructions.
  928.  
  929.                                 SWAPMM
  930.  
  931. You must  add MemoryMate's  /R switch  to the command-line when loading the
  932. program in  a batch  file.   Without the  /R switch, the program loads, but
  933. does not go resident.
  934.  
  935.                             Supported Versions
  936.  
  937. The following  versions of  the applications  are known  to work  with  the
  938. SWAP?? programs.   Earlier  versions may  work, but we do not support them.
  939. If a new version of your program comes out that is not listed here, contact
  940. IDC directly.
  941.  
  942.      SideKick:      Versions 1.52A through 1.58B.
  943.  
  944.      SideKick Plus: All Versions shipped as of 4/1/90
  945.  
  946.      Tornado:       Versions 1.70 through 1.80
  947.  
  948.      Memory Mate:   Versions 3.01 and 3.02
  949.  
  950.      PCTools:       Versions 5.5 & 6.0
  951.  
  952.      Norton Guides: All Versions shipped as of 4/1/90
  953.  
  954.      Metro/Express: MetroKernal 1.0, 1.1 and 1.11.
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974. SWAP Utilities 1.70 Documentation                                   Page 17
  975.                           If Something Goes Wrong
  976.  
  977. If you  have a  problem loading your SWAP?? program, it will normally issue
  978. an error message with an attempt to describe the problem.  If you encounter
  979. an  error   message,  please   check  the  section  titled  "Error  Message
  980. Descriptions".   Most message descriptions include a probable cause to help
  981. you to quickly identify the problem.
  982.  
  983. If, however,  your SWAP??  program will not load correctly, or crashes when
  984. you try  to access  the application,  there might  be a  conflict with your
  985. system.  Try the following steps to help us identify the problem:
  986.  
  987.      Check to make sure that TEST?? has been run, and did not abort.
  988.  
  989.      Check the version number of the program you are using against the
  990.      section, "Supported Versions".
  991.  
  992.      Make sure  you are  using the  /N option if you're loading SWAP??
  993.      through a batch file or a shell program's autoload feature.
  994.  
  995.      Use the  /S1 option  to force  SWAP?? to  write to disk.  If this
  996.      solves the  problem, the  conflict might  be with  your  expanded
  997.      memory manager, or with other parts of your hardware.
  998.  
  999.      Rename  your  AUTOEXEC.BAT  and  CONFIG.SYS  files,  reboot  your
  1000.      computer, and  try to  recreate the problem.  If the problem does
  1001.      not occur  during this  test, then  there is  probably a conflict
  1002.      between SWAP??  and a  TSR (Terminate  and Stay Resident program)
  1003.      loaded by  your AUTOEXEC.BAT  or a  device driver  loaded in your
  1004.      CONFIG.SYS.   To determine  which one  is causing  the  conflict,
  1005.      reintroduce the  commands in your AUTOEXEC.BAT and CONFIG.SYS one
  1006.      at a  time, and  reboot and  rerun SWAP?? after each change until
  1007.      the  problem  occurs.    This  should  pinpoint  the  conflicting
  1008.      program.   Sometimes rearranging  the order  in  which  TSRs  are
  1009.      loaded will eliminate the conflict.
  1010.  
  1011.  
  1012.  
  1013.                              Technical Support
  1014.  
  1015. Direct telephone  support is  only guaranteed  for registered  users.  Non-
  1016. registered users will be supported directly only as time permits.
  1017.  
  1018. The quickest  and easiest  way to get technical support, registered or not,
  1019. is to  contact Chip Rabinowitz at Compuserve 70731,20, MCIMAIL 315-5415, or
  1020. FAX 1-215-886-4225.   You may also write to Innovative Data Concepts at the
  1021. address above, or call 1-215-884-3373.
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033. Page 18                                   SWAP Utilities 1.70 Documentation
  1034.                         Common Questions & Answers
  1035.  
  1036.   Why should I use SWAP??
  1037.  
  1038. The most  obvious answer  to this  is to  save memory.  However, the SWAP??
  1039. programs have  additional benefits.   You  can load  your TSR into high DOS
  1040. memory, if  available; you  generally have  a greater  choice of hotkeys to
  1041. use; and  the SWAP?? swapping routines are usually faster than the swapping
  1042. used by  the applications.   Plus,  since the  SWAP?? programs  support the
  1043. TesSeRact Standard  for TSR  Communication, there  are documented  ways  to
  1044. access them, something which is NOT available without them.
  1045.  
  1046.   How often do I run TEST??
  1047.  
  1048. You should  run TEST??  the first  time you  install a  new version  of the
  1049. SWAP?? program.   This writes information into the .COM file that describes
  1050. the exact copy of your application.
  1051.  
  1052. The only  time you  should need  to re-run  TEST?? is  if  you  change  the
  1053. configuration of  the program  -- give  it new  hotkeys, change  the memory
  1054. allocation, re-build the executable (as with SK+), etc.
  1055.  
  1056.   When do I need to run TESTDV?
  1057.  
  1058. TESTDV is  used to  determine the  RUN-TIME  parameters  of  your  DESQview
  1059. environment.  This MUST be re-run if you add an additional TSR to be loaded
  1060. before DV,  if you  add a  network, or even if you add a new device driver.
  1061. All can affect the way DV configures itself for your machine.
  1062.  
  1063.   What is the optimal load order for the various SWAP?? programs?
  1064.  
  1065. If you  use more  than one  SWAP?? program, you should load them in reverse
  1066. order of  most common  use.  If you want to pop up one SWAP?? over another,
  1067. you'll need  to load  the last  program to  pop up first.  For example, you
  1068. should load  SWAPSH, followed  by SWAPDT;  this will permit you to bring up
  1069. PCShell from the Desktop menu.
  1070.  
  1071.  
  1072.                         Error Message Descriptions
  1073.  
  1074.   Invalid Command-Line Parameter!  Please check your documentation!!
  1075.  
  1076. The most  frequent cause  for this  message is  not adding  the appropriate
  1077. numeric parameters to a command-line option (such as /T3).
  1078.  
  1079.   Not enough Free Space on Selected Swap Drive
  1080.  
  1081. This message  is followed  by the  drive letter  of your  current  swapping
  1082. drive.   There  is  currently  not  enough  free  space  on  the  drive  to
  1083. successfully swap out your application.  Use the /D command-line parameter,
  1084. or modify the TEMP environment variable to fix this problem.
  1085.  
  1086.   SWAP?? already installed
  1087.  
  1088. This message  is issued  if you  attempt to  load a SWAP?? program a second
  1089. time.  It may also appear if you attempt to load your application program a
  1090. second time, if it has already been swapped.
  1091.  
  1092. SWAP Utilities 1.70 Documentation                                   Page 19
  1093.  
  1094.   SWAP?? has successfully loaded ....
  1095.   Swapping to ....
  1096.  
  1097. These messages  are issued  by SWAP??  AFTER  successful  loading  of  your
  1098. application program, and indicate the name of the program you are swapping,
  1099. as well as the type of memory being used.
  1100.  
  1101.   SWAP?? is not installed!  Please run TEST??!
  1102.  
  1103. You must run TEST?? before you can load SWAP??
  1104.  
  1105.   SWAP?? is not loaded -- cannot be removed
  1106.  
  1107. You cannot remove SWAP?? from memory when it is not installed.
  1108.  
  1109.   SWAP?? installed
  1110.  
  1111. This message is given when the SWAP?? program installs and "goes resident",
  1112. but before the application program is loaded.
  1113.  
  1114.   SWAP?? Removed from Memory
  1115.  
  1116. When you  load SWAP??  with the  /U switch,  you'll get this message.  Note
  1117. this does  not mean  that the  SWAP?? program is immediately released -- if
  1118. another TSR  has been  loaded after  SWAP??,  it  may  be  using  the  same
  1119. interrupt vectors,  which  will  keep  SWAP??  from  successfully  removing
  1120. itself.   As soon as the second TSR is removed, SWAP?? will disappear.  You
  1121. will also be unable to access SWAP?? during this time.
  1122.  
  1123.   Unable to Access Selected Swap Drive:
  1124.  
  1125. This message  is followed  by the  drive letter  of your  current  swapping
  1126. drive.   The most  likely cause of this message is that the specified drive
  1127. does not  exist.   Use the  /D command-line  parameter, or  modify the TEMP
  1128. environment variable to fix this problem.
  1129.  
  1130.   Unable to Auto-Detect Memory for Swapping
  1131.  
  1132. This is  a serious  error message  that should  never occur.  It means that
  1133. SWAP?? was  unable to  determine what  kind of  memory should  be used  for
  1134. swapping.
  1135.  
  1136.   Unable to load SWAP?? -- Bad Swap File Name:
  1137.  
  1138. This message  is given  when SWAP??  could not  create a swap file with the
  1139. specified pathname.   A  possible reason  is that a swapfile with that name
  1140. already exists, and is read-only.
  1141.  
  1142.   Error accessing XMS Memory
  1143.   Error accessing EMS Memory
  1144.   Error accessing Disk-Based Swapping Files
  1145.  
  1146. Contact IDC immediately if you receive one of these messages.
  1147.  
  1148.  
  1149.  
  1150.  
  1151. Page 20                                   SWAP Utilities 1.70 Documentation
  1152.                        COPYRIGHT NOTICE AND LICENSE
  1153.  
  1154. Innovative Data  Concepts, the  copyright owner  for  The  SWAP  Utilities,
  1155. hereby licenses  you to:  use the  software; make  as many  copies  of  the
  1156. shareware version  of this  software and  documentation as  you wish;  give
  1157. exact copies  of the  original shareware  version to anyone; and distribute
  1158. the shareware  version of  the software and documentation in its unmodified
  1159. form via electronic means. There is no charge for any of the above.
  1160.  
  1161. This is  not free  software.   This license allows you to use this software
  1162. without charge for a period of 30 days.  Any use of The SWAP Utilities past
  1163. this 30-day  period is  in violation  of federal copyright laws and will be
  1164. prosecuted.
  1165.  
  1166. No copy  of the  software may  be distributed  or given  away without  this
  1167. accompanying documentation;  this notice  must not be removed.  ONLY COPIES
  1168. OF THE  SHAREWARE VERSION MAY BE DISTRIBUTED IN ANY FORM.  IDC will provide
  1169. disks with  the shareware  versions of  ALL SWAP  Utilities  programs  upon
  1170. written request.
  1171.  
  1172.  
  1173.                                  Warranty
  1174.  
  1175. There is  no warranty  of any  kind associated  with this software, and the
  1176. copyright owner  is not  liable for  damages of  any kind.   By  using this
  1177. software, you  agree to this. Every effort has been made by Innovative Data
  1178. Concepts to  make this  product bug-free.   However, the nature of software
  1179. development is  that it  is impossible to guarantee bug-free software. If a
  1180. registered user  reports a  verifiable bug,  the user  will receive  a free
  1181. upgrade to the next version of The SWAP Utilities.
  1182.  
  1183.  
  1184.                                Registration
  1185.  
  1186. Upon receipt  of the appropriate registration fee, Innovative Data Concepts
  1187. will send  the user a printed copy of this documentation, a disk containing
  1188. a version  of SWAPDOS  without the  shareware registration  screen,  and  a
  1189. registration number entitling the user to upgrades and telephone support.
  1190.  
  1191. Registered users  will also  be given  a toll-free  number that will permit
  1192. them to receive a free Compuserve Intro-Pak, along with a $15 usage credit.
  1193.  
  1194.  
  1195.               Bulletin Boards, Users Groups and Disk Vendors
  1196.  
  1197. Bulletin Board  Sysops and  User Groups are encouraged to fill out the form
  1198. below, which will automatically place them on a mailing list to receive the
  1199. latest version  of all IDC shareware products as they are released, as well
  1200. as upgrades  to already  existing programs.   There  is  no  fee  for  this
  1201. service.
  1202.  
  1203. Disk Vendors  who wish to distribute The SWAP Utilities must satisfy one of
  1204. the following requirements:
  1205.  
  1206. 1)   The vendor  must have  been accepted  as an  associate member  of  the
  1207. Association of Shareware Professionals; or
  1208.  
  1209.  
  1210. SWAP Utilities 1.70 Documentation                                   Page 21
  1211. 2)   The vendor  must agree  to abide by the standards for disk vendors, as
  1212. set forth by the Association of Shareware Professionals.
  1213.  
  1214. Disk vendors  who do  not meet  these requirements  are  NOT  PERMITTED  TO
  1215. DISTRIBUTE THE SWAP UTILITIES UNDER ANY CIRCUMSTANCES!
  1216.  
  1217. For information on obtaining ASP-approved status, contact:
  1218.  
  1219.      Vendor Membership Coordinator
  1220.      Association of Shareware Professionals
  1221.      P.O. Box 5786
  1222.      Bellevue, WA 98006
  1223.  
  1224. UNDER NO  CIRCUMSTANCES MAY  THE SWAP  UTILITIES BE DISTRIBUTED WITHOUT ALL
  1225. ACCOMPANYING  DOCUMENTATION  FILES  (INCLUDING  THIS  COMPLETE  FILE),  ALL
  1226. PROGRAMS, AND  OTHER MATERIALS  PROVIDED  WITH  THE  OFFICIAL  COPIES  FROM
  1227. INNOVATIVE DATA  CONCEPTS.   ANY SUCH DISTRIBUTION OF THE SWAP UTILITIES OR
  1228. ITS RELATED  FILES, EXCEPT  AS PROVIDED  FOR  IN  THIS  LICENSE,  SHALL  BE
  1229. DETERMINED TO  BE IN  VIOLATION OF  FEDERAL  COPYRIGHT  LAWS  AND  WILL  BE
  1230. PROSECUTED.
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269. Page 22                                   SWAP Utilities 1.70 Documentation
  1270.                       About Innovative Data Concepts
  1271.  
  1272. Innovative Data  Concepts is  a consulting  firm owned and operated by Chip
  1273. Rabinowitz,  specializing   in   Ram-Resident   programs,   communications,
  1274. printing, video and more.
  1275.  
  1276. Rabinowitz is an Assistant Sysop on the Computer Language Magazine Forum on
  1277. CompuServe Information  Service and  also provides  technical  support  for
  1278. Borland International  as a  member of  "Team Borland"  on their Compuserve
  1279. Forums, in  the areas  of Turbo  C, Turbo  Assembler, Turbo  Debugger,  and
  1280. SideKick Plus.   He is also the leader of the TesSeRact Development Team, a
  1281. group pushing for Ram-Resident Programming Standards.
  1282.  
  1283. The technique  used to  swap these  applications may  be applied  to  other
  1284. resident programs  as well,  and  Innovative  Data  Concepts  is  currently
  1285. investigating  other   possible  SWAP??   programs.     If  you   have  any
  1286. suggestions/comments, please contact IDC.
  1287.  
  1288. A similar  technique  may  also  be  directly  incorporated  into  resident
  1289. programs; for more information, please contact IDC directly.
  1290.  
  1291.  
  1292.   This product  uses the TesSeRact(TM) Ram-Resident Library and supports
  1293.   the TesSeRact  Standard for  Ram-Resident Program  Communication.  For
  1294.   information about  TesSeRact, contact  the TesSeRact  Development Team
  1295.   at:
  1296.  
  1297.      TesSeRact Development Team
  1298.      1657 The Fairways
  1299.      Suite 101
  1300.      Jenkintown, PA 19046
  1301.      1-215-884-3373
  1302.  
  1303.      Compuserve: 70731,20
  1304.      MCIMAIL:    315-5415
  1305.  
  1306.   This MCIMAIL  Account has  been provided  to the TesSeRact Development
  1307.   Team by Borland International, Inc.  The TesSeRact Development Team is
  1308.   in no  way associated with Borland International, Inc.  TesSeRact is a
  1309.   trademark of the TesSeRact Development Team.
  1310.  
  1311.  
  1312.  
  1313.  
  1314.                       The Rest of The SWAP Utilities
  1315.  
  1316. At the  present time,  customized versions  of The SWAP Utilities ship with
  1317. GOfer 2.0,  from MicroLytics, Inc., and Info Select, from Micro Logic Corp.
  1318. Other companies  are interesting in similar arrangements, and IDC will keep
  1319. its users posted about future developments.
  1320.  
  1321. Now for some of our other products ....
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328. SWAP Utilities 1.70 Documentation                                   Page 23
  1329.                             Introducing SWAPDOS
  1330.  
  1331. In March,  Innovative Data Concepts released SWAPDOS, another memory-saving
  1332. utility, this time focused on non-TSR applications.
  1333.  
  1334. With SWAPDOS, you can run one large application while you're already inside
  1335. another program.   SWAPDOS  expands your  existing  RAM  by  re-using  your
  1336. computer's  memory  when  a  program  is  not  active.    Simply  use  your
  1337. application's "Shell  to DOS"  capability, and  then  use  SWAPDOS  to  run
  1338. another program, regaining all the memory used by the FIRST program.
  1339.  
  1340. Imagine using  the dBase  "RUN" command to write a letter with WordPerfect!
  1341. Or bringing  up Microsoft Word while examining your 1-2-3 spreadsheet!  You
  1342. can even  take your TSRs out of memory along with the program, and put them
  1343. back again later!
  1344.  
  1345.                We'll let our users speak for themselves ...
  1346.  
  1347.      "Because I  load a  TSR spell-checker  before running  TAPCIS,  I
  1348.      normally have  only 140K  available after  shelling from  TAPCIS.
  1349.      SWAPDOS makes  more than  580K of  memory free when shelling from
  1350.      TAP, allowing  me to  run Brief, Norton Commander, or MSGVU, from
  1351.      within TAPCIS.   I  also use it to run Brief when shelling out of
  1352.      QuickBasic." --  John P. Wexler, MD, PhD, Asst Dean of Scientific
  1353.      Computing, Albert Einstein College of Medicine
  1354.  
  1355.      "SWAPDOS fills  more than  the obvious  need to  re-claim  memory
  1356.      while shelled from an application program.  Standard DOS commands
  1357.      like DISKCOPY  and XCOPY  operate more  efficiently when  SWAPDOS
  1358.      temporarily  frees  even  one  TSR."  --  Robert  J.    Rucinski,
  1359.      Audiovisual Services, Detroit Public Schools
  1360.  
  1361.      "I run  a very  complex system  with many TSRs loaded most of the
  1362.      time.   Still, occasionally, I run applications which require all
  1363.      or most  of DOS'  640K.  SWAPDOS has enabled me to define command
  1364.      synonyms (or  batch files) that can unload all the TSRs, load the
  1365.      memory intensive  application such as Ventura Publisher, and then
  1366.      reload my  TSRs.  I used to solve this by having numerous sets of
  1367.      AUTOEXEC.BAT's  and   CONFIG.SYS',  and  rebooting  the  computer
  1368.      constantly.   Now I  can get  in and  out of  these  applications
  1369.      quickly, and  have the  TSRs reloaded  IN THEIR  PREVIOUS  STATE!
  1370.      Imagine running Ventura from a dBase shell!  If SideKick Plus had
  1371.      five files  loaded that  I was  editing, they're all still there!
  1372.      SWAPDOS is  a concept  whose time has come!" -- Robert K. Blaine,
  1373.      Owner, ECONO-SOFT
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387. Page 24                                   SWAP Utilities 1.70 Documentation
  1388.      "SWAPDOS is  a great  utility which  uses much  less memory  than
  1389.      similar commercial  products.  We use it in my law office to swap
  1390.      out of  Microsoft Word  to run  other programs.  With SWAPDOS, my
  1391.      secretary does not have to save her work, then quit Word, run the
  1392.      next program,  reload word,  reload the  document she was working
  1393.      on, and  then find her place within that document.  Instead, with
  1394.      SWAPDOS, executing  just one  command swaps Word and the document
  1395.      she was  working on to memory and just one command returns her to
  1396.      Word in  the document  EXACTLY  where  she  left  off,  with  all
  1397.      glossaries and  other macros,  etc., still loaded!!  Like all The
  1398.      SWAP Utilities,  SWAPDOS is  a must  have!!" --  Gary  L.  Britt,
  1399.      Attorney at Law, Houston, Texas
  1400.  
  1401.               Even if you use an alternate command-shell ...
  1402.  
  1403. ... such  as 4DOS  or FlexShell,  or if  you use a command-line enhancement
  1404. utility such  as PCED,  DOSEDIT or ALIAS, SWAPDOS can save you RAM and move
  1405. you between applications with ease.
  1406.  
  1407. SWAPDOS provides  an  application  independent  method  for  one  PC/MS-DOS
  1408. application to  run another,  even if both would normally not fit in memory
  1409. at the  same time.   A typical use is to temporarily swap out dBASE to make
  1410. room for your text editor, or to swap out a text editor so that you can run
  1411. memory hungry  compilers, linkers,  or even  debuggers without  losing your
  1412. place in an editing session.
  1413.  
  1414. SWAPDOS works  by copying conventional memory used by the currently running
  1415. application to expanded memory, extended memory, or to a disk file, thereby
  1416. freeing conventional memory used by the application.  SWAPDOS then runs the
  1417. desired program before restoring the original environment.
  1418.  
  1419.                            Attention Developers!
  1420.  
  1421. A recent  advertisement in  Dr. Dobb's  Journal from one of our competitors
  1422. made several  interesting points  about their  product.  Since most of them
  1423. apply to  SWAPDOS as well, at less than HALF the price, we thought we'd let
  1424. their ad sell our product:
  1425.  
  1426.      "... the  incredible memory management utility that allows you to
  1427.      push stand-alone  and RAM  resident programs out of the way while
  1428.      you compile, link and test even the largest programs."
  1429.  
  1430.      "... reduces  the  overhead  of  Microsoft  Make  and  Polytron's
  1431.      PolyMake from  over 100K  to a  mere 4k <B>[SWAPDOS requires less
  1432.      than 3K!]<D>, giving you the memory you need to run your compiler
  1433.      and linker more efficiently.
  1434.  
  1435.                                  Just $25!
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446. SWAP Utilities 1.70 Documentation                                   Page 25
  1447.                         For Task-Switching Use ...
  1448.  
  1449. "... The  world's most popular operating system still has some life left in
  1450. it, thanks  in part to task-switching utilities like Progressive Solutions'
  1451. Back & Forth." -- PC Magazine First Looks, May 15, 1990.
  1452.  
  1453. IDC's objective  is to  help users make the most of their available memory.
  1454. IDC has  planned for  some time  to develop  a top-quality, small-footprint
  1455. task-switching program,  for those  who need  to run multiple applications.
  1456. Back &  Forth fulfills these requirements.  In just a few short months, B&F
  1457. has garnered reviews in PC Magazine, PC Week, InfoWorld and PC World.  Back
  1458. & Forth  supports UltraVision,  4DOS, and  several  other  DOS  enhancement
  1459. programs.
  1460.  
  1461. IDC has  added Back  & Forth to its product family, under an agreement with
  1462. Progressive Solutions,  IDC will  be marketing  Back  &  Forth.    IDC  and
  1463. Progressive  Solutions   plan  to  conduct  joint  product  and  technology
  1464. development.  Please note that Progressive Solutions is NOT a member of the
  1465. Association of Shareware Professionals.
  1466.  
  1467.                         How Does Back & Forth Work?
  1468.  
  1469. Back &  Forth is a program management tool that allows you to load up to 20
  1470. programs at  once and  instantly switch  between them.   Now you can switch
  1471. between your  word processor,  spreadsheets, databases,  and  utilities  at
  1472. will, without having to wait.  This eliminates the need to exit one program
  1473. to open  and use  another --  which lets you concentrate on the reasons why
  1474. you are using your software in the first place.
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505. Page 26                                   SWAP Utilities 1.70 Documentation
  1506.                         Back & Forth features ....
  1507.  
  1508.   Delivers a  flexible  task  management  environment  where  up  to  20
  1509.      programs may be open in memory, each has as much memory as needed.
  1510.  
  1511.   Occupies only  12-15K of  memory (0K  Version if  "high" DOS memory is
  1512.      available due soon).
  1513.  
  1514.   Easy-to-use, flexible environment.
  1515.  
  1516.   Supports CGA, VGA, EGA and Super-VGA graphics screens.
  1517.  
  1518.   Microsoft-compatible mouse
  1519.  
  1520.   Uses expanded  or conventional  memory, RAM  disks and  hard disks for
  1521.      swapping. (XMS support coming soon!)
  1522.  
  1523.   Executes programs at the touch of a key.
  1524.  
  1525.   50 programs can be defined for use in the program.
  1526.  
  1527.   User definable Hot Keys for program selection.
  1528.  
  1529.   Defines all aspects of program use including:
  1530.  
  1531.      Program description
  1532.      Name and path
  1533.      Work path
  1534.      Command-line options (whether pre-defined or user-specified)
  1535.      Amount of memory needed
  1536.      Hotkey
  1537.      Flexible color customization.
  1538.  
  1539.   Provides DOS  environments for  executing programs,  utilities or  DOS
  1540.      commands.
  1541.  
  1542.   And much, much more ....
  1543.  
  1544.                                For just $50!
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564. SWAP Utilities 1.70 Documentation                                   Page 27
  1565.                   Association of Shareware Professionals
  1566.  
  1567. Innovative Data  Concepts is  a member  of  the  Association  of  Shareware
  1568. Professionals (ASP), an organization formed in April 1987 to strengthen the
  1569. future  of   shareware  (user-supported  software)  as  an  alternative  to
  1570. commercial software.    Its  members,  all  of  whom  are  programmers  who
  1571. subscribe to a code of ethics, are committed to the concept of shareware as
  1572. a method of marketing.
  1573.  
  1574. ASP has established stringent standards for its members.  ASP wants to make
  1575. sure that  the shareware  principle works  for you.   If  you are unable to
  1576. resolve a  problem with  an ASP  member (other than technical support), ASP
  1577. may be  able to  help.  Please write to the ASP Ombudsman at P.O. Box 5786,
  1578. Bellevue, WA 98006.
  1579.  
  1580. The primary goals of the ASP are:
  1581.      To inform  users about  shareware programs  and about  shareware as  a
  1582.           method of distributing and marketing software;
  1583.      To encourage broader distribution of shareware through user groups and
  1584.           disk dealers  who agree  to identify  and explain  the nature  of
  1585.           shareware;
  1586.      To assist members in marketing their software;
  1587.      To provide  a forum  through which  ASP members may communicate, share
  1588.           ideas, and learn from each other; and
  1589.      To foster  a high degree of professionalism among shareware authors by
  1590.           setting programming,  marketing, and  support standards  for  ASP
  1591.           members to follow.
  1592.  
  1593.  
  1594.          Standards for the Association of Shareware Professionals
  1595.  
  1596. PROGRAMMING STANDARDS:
  1597.  
  1598.      The program  meets the  ASP's definition of "shareware" (i.e., it
  1599.      is not a commercial demo with major feature disabled, nor a time-
  1600.      limited program).
  1601.  
  1602.      The program  has been  thoroughly tested by the author and should
  1603.      not be harmful to other files or hardware if used properly.
  1604.  
  1605. DOCUMENTATION STANDARDS:
  1606.  
  1607.      Sufficient documentation is provided to allow the average user to
  1608.      try all the major functions of the program.
  1609.  
  1610.      Any discussion  of the  shareware  concept  and  of  registration
  1611.      requirements is done in a professional and positive manner.
  1612.  
  1613. SUPPORT STANDARDS:
  1614.  
  1615.      The member will respond to people who send registration payments,
  1616.      as promised  in the  program's documentation.   At a minimum, the
  1617.      member will acknowledge receipt of all payments.
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623. Page 28                                   SWAP Utilities 1.70 Documentation
  1624.      The member  will establish  a procedure  for users to report, and
  1625.      have acknowledged, matters such as bug reports, and will describe
  1626.      such means  in the documentation accompanying all versions of the
  1627.      programs.   The author  will respond  to written bug reports from
  1628.      registered users when the user provides a self-addressed, stamped
  1629.      envelope.
  1630.  
  1631.      Known incompatibilities with other software or hardware and major
  1632.      or unusual  program limitations  are noted  in the  documentation
  1633.      that comes with the shareware (evaluation) program.
  1634.  
  1635. GENERAL:
  1636.  
  1637.      Members will keep the ASP apprised of changes in mailing address;
  1638.      which shareware  programs they  have published  and are currently
  1639.      supporting; the  current version  numbers; and  of any changes in
  1640.      the status of their programs.
  1641.  
  1642.      If a  user has  a dispute with an ASP member-author, the user may
  1643.      appeal to the ASP to mediate for arbitration of the dispute.
  1644.  
  1645. For more  information about  the Association  of  Shareware  Professionals,
  1646. contact George  Abbot, Membership  Coordinator of  the ASP,  at  Compuserve
  1647. 72617,1266, or write the ASP at P.O. Box 5786, Bellevue, WA 98006.
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.  
  1663.  
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682. SWAP Utilities 1.70 Documentation                                   Page 29
  1683.