home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / ECHOMON.ZIP / ECHOMON.DOC < prev    next >
Text File  |  1990-11-07  |  9KB  |  247 lines
  1.  
  2. EchoMon 1.00 beta, Wed  11-07-1990
  3. ----------------------------------
  4.  
  5. OS/2 does not support two monitors very well.  If you type "MODE
  6. MONO", you may indeed switch over to the monochrome monitor,  but
  7. your colour monitor remains dormant until you switch back to it.
  8. Furthermore,  any program you start while using the monochrome
  9. monitor will only display information when it is the foreground
  10. process.  So what OS/2 supplies you with is the ability to use
  11. either monitor,  but not both at the same time.
  12.  
  13. EchoMon solves this problem by precisely echoing the contents of one
  14. full screen colour session to the monochrome monitor.  Therefore,
  15. this one session is (when it is in the foreground) running on BOTH
  16. monitors.  The advantage is that this session continues to display
  17. on the monochrome monitor after it looses focus and another screen
  18. group is made active,  including Presentation Manager.  The result
  19. is simultaneous output to both monitors.
  20.  
  21. Because of OS/2's design,  EchoMon can not redirect an OS/2 windowed
  22. session,  only full screen sessions.
  23.  
  24. Any full screen application will run under EchoMon.  You could, for
  25. example,  run a BBS program (such as BinkleyTerm/Maximus) in the
  26. echoed session,  so you could always keep an eye on it.  Or you may
  27. choose to run large jobs in that session (such as a compile),  so
  28. that you can visually monitor it while working on something else on
  29. your colour screen.
  30.  
  31. EchoMon requires OS/2 1.20 (csd level WR4051 or greater).
  32.  
  33. EchoMon is shareware.  It is not "CrippleWare" or "DemoWare".  The
  34. copy you have is 100% functional and will not stop working no matter
  35. how many times you use it,  and it does not have an expiry date.
  36.  
  37. INSTALLATION
  38. ------------
  39.  
  40. EchoMon is three files:
  41.  
  42.     EchoMon.DLL  -  Must be placed in one of the directories listed
  43.                     in the config.sys LIBPATH statement.  If you're
  44.                     unsure, copy echomon.dll to C:\OS2\DLL.
  45.  
  46.     EchoMon.SYS  -  Must be installed in config.sys,  thus:
  47.  
  48.                        DEVICE=C:\path\ECHOMON.SYS
  49.  
  50.                     Where "path" is the directory where echomon.sys
  51.                     is located.
  52.  
  53.                     You must restart your computer before this part
  54.                     of EchoMon is installed in memory.
  55.  
  56.     EchoMon.Exe  -  This file can be located anywhere.  You may wish
  57.                     to place it on your PATH,  so that it is always
  58.                     accessible.
  59.  
  60. OPERATION
  61. ---------
  62.  
  63. After installation, simply run the EchoMon.EXE program.  You will
  64. notice your monochrome screen jump to life,  with the standard OS/2
  65. command prompt.
  66.  
  67. Any parameters given to EchoMon.exe will be passed directly to the
  68. command interpreter defined by COMSPEC (probably CMD.EXE),  except
  69. as noted below.  You can therefore,  have EchoMon automatically
  70. start a program from a batch file or the Desktop Manager.  For
  71. example,  to "launch" CHKDSK on the monochrome monitor,  you could
  72. use this in a batch file:
  73.  
  74.  start /N EchoMon /C CHKDSK
  75.  
  76. The /N and /C cause the session to close automatically when CHKDSK
  77. is done (the monochrome screen will retain the output from chkdsk
  78. after the session has closed).  If you replace /C with /K,  the
  79. session will remain open after chkdsk completes.
  80.  
  81. To "launch" a program from the PM desktop,  add a new program and
  82. fill in "Properties" dialog in this manner:
  83.  
  84.   Program Title     :  <appropriate tittle>
  85.   Path and File Name:  C:\path\ECHOMON.EXE
  86.   Parameters        :  /C CHKDSK
  87.  
  88.   Run Program       :  Full Screen
  89.  
  90. One possibly undesirable side effect of this is that the Program
  91. Starter will bring this session to the foreground when you start it
  92. -- so both monitors will be running the same program.  To avoid
  93. this,  start EchoMon with a first parameter of "/B".  This will
  94. cause EchoMon to start in the background.  The /B parameter is NOT
  95. passed to the target program.  Modifying the second example (above)
  96. to start in the background would result in:
  97.  
  98.   Program Title     :  <appropriate tittle>
  99.   Path and File Name:  C:\path\ECHOMON.EXE
  100.   Parameters        :  /B /C CHKDSK
  101.  
  102.   Run Program       :  Full Screen
  103.  
  104.  
  105. NOTE: With OS/2 2.00,  it is possible to start a full screen session
  106. "minimized" (ie: the session is started in the background),  so the
  107. /B parameter need not be used.
  108.  
  109. CAVEATS
  110. -------
  111.  
  112.  - There can only be one copy of EchoMon running at any one time.
  113.  
  114.  - The /B parameter does not actually start EchoMon in the
  115.    background.  What it really does is start EchoMon in the
  116.    foreground,  then switch to the Task Manager right after
  117.    initialization,  thus leaving EchoMon in the background.
  118.  
  119.  - If any programs are STARTed or DETACHed from the EchoMon session,
  120.    they must be ended before EchoMon can be restarted.  For example,
  121.    the following sequence of events will cause EchoMon to report an
  122.    error:
  123.  
  124.    EchoMon              (simply start an echoed command prompt)
  125.    DETACH QH            (detach a background process)
  126.    EXIT                 (end the echoed command prompt)
  127.    EchoMon              (error: "EchoMon can only run in one session")
  128.  
  129.    Before EchoMon can be restarted, the QH process would have to be
  130.    terminated.  Had the QH program been loaded in an unrelated
  131.    session, or had been DETACHed before EchoMon was first loaded,
  132.    this problem would not have occurred.
  133.  
  134.  - When installing OS/2,  you DO NOT have to tell the OS/2 install
  135.    program that you have a monochrome monitor installed.  If you
  136.    have already done so,  you may have something like this in your
  137.    config.sys:
  138.  
  139.     SET VIDEO_DEVICES=VIO_IBMVGA,VIO_IBMMPA
  140.     SET VIO_IBMVGA=DEVICE(BVHVGA)
  141.     SET VIO_IBMMPA=DEVICE(BVHMPA)
  142.  
  143.    You may wish to remove the support for your monochrome screen and
  144.    leave just:
  145.  
  146.     SET VIDEO_DEVICES=VIO_IBMVGA
  147.     SET VIO_IBMVGA=DEVICE(BVHVGA)
  148.  
  149.  - EchoMon MAY work with later versions of OS/2 1.10 (let me know).
  150.  
  151.  - EchoMon does NOT work with early versions of both OS/2 1.10 and
  152.    1.20.  The symptom:  All output sent via "stdout" and VioWrtTTY()
  153.    will not be visible.
  154.  
  155.  - EchoMon works with MS OS/2 1.21.
  156.  
  157.  - EchoMon has been tested and works with SDK OS/2 2.00,  release
  158.    6.78.
  159.  
  160.  
  161. DISCLAIMER
  162. ----------
  163.  
  164. The Program is supplied "AS IS" without any warranty of any kind,
  165. either expressed or  implied,  including, but not limited to, the
  166. implied warranties of merchantabilty and fitness for a particular
  167. purpose.
  168.  
  169. In  no  event  shall A:WARE INC be liable for any damages, either
  170. direct or  consequential,  caused by the use, or inability to use,
  171. this program, even  if A:WARE INC has been advised of the
  172. possibility of such damages.
  173.  
  174. LICENSE
  175. -------
  176. You are granted the right to use,  at no obligation,  EchoMon for a
  177. period of 30 days.  After that period,  you must either stop using
  178. EchoMon or register it with A:WARE Inc.
  179.  
  180. You are free distribute, with no obligation, the EchoMon package
  181. provided that:
  182.  
  183.      a) you distribute only verbatim copies of the EchoMon package
  184.         as you receive it; and
  185.      b) it is accompanied by unmodified copies of this documentation.
  186.  
  187. You MAY:
  188.  
  189.      a) Use a different compression tool to re-package the unmodified
  190.         EchoMon files before distribution.
  191.  
  192. You may NOT:
  193.  
  194.      a) distribute the contents of the EchoMon package in a modified
  195.         form.  This includes adding files and/or comments to the
  196.         EchoMon package.  The EchoMon contains exactly 5 files:
  197.  
  198.         ECHOMON.SYS
  199.         ECHOMON.EXE
  200.         ECHOMON.DLL
  201.         ECHOMON.DOC
  202.         ECHOMON.REG
  203.  
  204.         If you distribute an EchoMon package with more or less than
  205.         the above listed files,  you are in violation of this
  206.         license agreement.   If you add an ARC/ZIP/ZOO/LZH/PAK
  207.         "comment" to the EchoMon package,  you are in violation of
  208.         this license agreement.
  209.  
  210.      b) distribute EchoMon in connection with any other product,
  211.         service or "value added" package.
  212.  
  213.      c) distribute EchoMon for general use within a company or
  214.         institution.
  215.  
  216.      d) distribute EchoMon for any consideration or 'disk fee'.
  217.  
  218. Electronic Bulletin Board operators are encouraged to post EchoMon
  219. for downloading by their users,  provided that all of the above
  220. conditions are met.
  221.  
  222. ACKNOWLEDGMENTS
  223. --------------
  224. The author would like to thank Gerry Rozema for testing EchoMon,
  225. and for providing the "/B" idea.
  226.  
  227.  
  228. REGISTRATION
  229. ------------
  230. The registration fee is US$20 (CDN$24).  Please see the EchoMon.reg
  231. file for more information.
  232.  
  233. EchoMon is Copyright (c) 1990 A:Ware Inc.
  234.  
  235. A:WARE Inc.
  236. P.O Box 670
  237. Adelaide St Postal Stn.
  238. Toronto Canada
  239. M5C 2J8
  240.  
  241. Voice: (416)271-8900  (Peter Fitzsimmons.  Inquiries only).
  242.  
  243. The most recent version of EchoMon will always be posted for
  244. downloading on RT Lab bbs, (416)-867-9663 and 9664.  FidoNet node
  245. number 1:250/628 (Magic FileREQuest name is ECHOMON).
  246.  
  247.