home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / driver / graphic / echomon / echomon.doc < prev    next >
Encoding:
Text File  |  1992-05-20  |  10.9 KB  |  299 lines
  1.  
  2. EchoMon 1.02 Wed  05-20-1992
  3. ----------------------------
  4.  
  5. New features:
  6.  
  7.  - If you have an Tseng Labs ET4000 based SVGA card,  you may wish to
  8.    use EM_4000.SYS in place of EchoMon.Sys.   This will force your VGA
  9.    card into 16 bit mode,  except when accessing the monochrome adaptor.
  10.  
  11.    Most VGA cards (good ones) will auto-sense that you have a monochrome
  12.    adapter installed,  and kick into 8 bit mode.  This is necessary
  13.    because of the way the IBM ATs (and clones) were designed.  This
  14.    slows down video performance considerably.  ET_4000.SYS will toggle
  15.    ET4000 based vga cards back and forth as required.   Thanks to Gerry
  16.    Rozema for the idea (and the code example).
  17.  
  18.  - Mouse/Key stuffing support.  I added this the day after I released
  19.    1.00 then promptly forgot about it (about 18 months ago).  Sorry.
  20.    Look in STUFF.LZH for instructions.
  21.  
  22.  - M2.CMD is a sample batch file you may wish to use.  It launches
  23.    a background program on your second monitor.  For example,
  24.    if you would normally start a program thus:
  25.  
  26.      PBW help.c
  27.  
  28.    Simply stick 'M2' (for "2nd Monitor") in front,  thus:
  29.  
  30.      M2 PBW help.c
  31.  
  32. New Comments:
  33. ------------
  34.  
  35.  - There was some confusion with the "MODE MONO" command.  You do not
  36.    need to ever use this command with echomon.  In fact,  it is strongly
  37.    suggested that you do not tell OS/2's INSTALL that you have a second
  38.    monitor.  If you already have,  change the "VIDEO_DEVICES" (in
  39.    config.sys), as desbribed later,  to remove references to VIO_IBMMPA.
  40.  
  41.  - Real Herculese cards,  and many clone Herc cards,  will not function
  42.    as plain IBM compatible MPA cards.  They may not work with echomon
  43.    correctly.  This is not a shotcomming of echomon,  but rather the way
  44.    some herc cards clash with VGA cards.
  45.  
  46.  - Echomon does not run DOS programs on the monochrome monitor.
  47.  
  48.  - Echomon 1.01 was an internal release.
  49.  
  50. EchoMon 1.00 beta, Wed  11-07-1990
  51. ----------------------------------
  52.  
  53. OS/2 does not support two monitors very well.  If you type "MODE
  54. MONO", you may indeed switch over to the monochrome monitor,  but
  55. your colour monitor remains dormant until you switch back to it.
  56. Furthermore,  any program you start while using the monochrome
  57. monitor will only display information when it is the foreground
  58. process.  So what OS/2 supplies you with is the ability to use
  59. either monitor,  but not both at the same time.
  60.  
  61. EchoMon solves this problem by precisely echoing the contents of one
  62. full screen colour session to the monochrome monitor.  Therefore,
  63. this one session is (when it is in the foreground) running on BOTH
  64. monitors.  The advantage is that this session continues to display
  65. on the monochrome monitor after it looses focus and another screen
  66. group is made active,  including Presentation Manager.  The result
  67. is simultaneous output to both monitors.
  68.  
  69. Because of OS/2's design,  EchoMon can not redirect an OS/2 windowed
  70. session,  only full screen sessions.
  71.  
  72. Any full screen application will run under EchoMon.  You could, for
  73. example,  run a BBS program (such as BinkleyTerm/Maximus) in the
  74. echoed session,  so you could always keep an eye on it.  Or you may
  75. choose to run large jobs in that session (such as a compile),  so
  76. that you can visually monitor it while working on something else on
  77. your colour screen.
  78.  
  79. EchoMon requires OS/2 1.20 (csd level WR4051 or greater).
  80.  
  81. EchoMon is shareware.  It is not "CrippleWare" or "DemoWare".  The copy
  82. you have is 100% functional and will not stop working no matter how many
  83. times you use it,  and it does not have an expiry date.  If, however,
  84. you decide to continue using it,  you must pay for it.
  85.  
  86. INSTALLATION
  87. ------------
  88.  
  89. EchoMon is three files:
  90.  
  91.     EchoMon.DLL  -  Must be placed in one of the directories listed
  92.                     in the config.sys LIBPATH statement.  If you're
  93.                     unsure, copy echomon.dll to C:\OS2\DLL.
  94.  
  95.     EchoMon.SYS  -  Must be installed in config.sys,  thus:
  96.  
  97.                        DEVICE=C:\path\ECHOMON.SYS
  98.  
  99.                     Where "path" is the directory where echomon.sys
  100.                     is located.
  101.  
  102.                     You must restart your computer before this part
  103.                     of EchoMon is installed in memory.
  104.  
  105.     EchoMon.Exe  -  This file can be located anywhere.  You may wish
  106.                     to place it on your PATH,  so that it is always
  107.                     accessible.
  108.  
  109. OPERATION
  110. ---------
  111.  
  112. After installation, simply run the EchoMon.EXE program.  You will
  113. notice your monochrome screen jump to life,  with the standard OS/2
  114. command prompt.
  115.  
  116. Any parameters given to EchoMon.exe will be passed directly to the
  117. command interpreter defined by COMSPEC (probably CMD.EXE),  except
  118. as noted below.  You can therefore,  have EchoMon automatically
  119. start a program from a batch file or the Desktop Manager.  For
  120. example,  to "launch" CHKDSK on the monochrome monitor,  you could
  121. use this in a batch file:
  122.  
  123.  start /N EchoMon /C CHKDSK
  124.  
  125. The /N and /C cause the session to close automatically when CHKDSK
  126. is done (the monochrome screen will retain the output from chkdsk
  127. after the session has closed).  If you replace /C with /K,  the
  128. session will remain open after chkdsk completes.
  129.  
  130. To "launch" a program from the PM desktop,  add a new program and
  131. fill in "Properties" dialog in this manner:
  132.  
  133.   Program Title     :  <appropriate tittle>
  134.   Path and File Name:  C:\path\ECHOMON.EXE
  135.   Parameters        :  /C CHKDSK
  136.  
  137.   Run Program       :  Full Screen
  138.  
  139. One possibly undesirable side effect of this is that the Program
  140. Starter will bring this session to the foreground when you start it
  141. -- so both monitors will be running the same program.  To avoid
  142. this,  start EchoMon with a first parameter of "/B".  This will
  143. cause EchoMon to start in the background.  The /B parameter is NOT
  144. passed to the target program.  Modifying the second example (above)
  145. to start in the background would result in:
  146.  
  147.   Program Title     :  <appropriate tittle>
  148.   Path and File Name:  C:\path\ECHOMON.EXE
  149.   Parameters        :  /B /C CHKDSK
  150.  
  151.   Run Program       :  Full Screen
  152.  
  153.  
  154. NOTE: With OS/2 2.00,  it is possible to start a full screen session
  155. "minimized" (ie: the session is started in the background),  so the
  156. /B parameter need not be used.
  157.  
  158. CAVEATS
  159. -------
  160.  
  161.  - There can only be one copy of EchoMon running at any one time.
  162.  
  163.  - The /B parameter does not actually start EchoMon in the
  164.    background.  What it really does is start EchoMon in the
  165.    foreground,  then switch to the Task Manager right after
  166.    initialization,  thus leaving EchoMon in the background.
  167.  
  168.  - If any programs are STARTed or DETACHed from the EchoMon session,
  169.    they must be ended before EchoMon can be restarted.  For example,
  170.    the following sequence of events will cause EchoMon to report an
  171.    error:
  172.  
  173.    EchoMon              (simply start an echoed command prompt)
  174.    DETACH QH            (detach a background process)
  175.    EXIT                 (end the echoed command prompt)
  176.    EchoMon              (error: "EchoMon can only run in one session")
  177.  
  178.    Before EchoMon can be restarted, the QH process would have to be
  179.    terminated.  Had the QH program been loaded in an unrelated
  180.    session, or had been DETACHed before EchoMon was first loaded,
  181.    this problem would not have occurred.
  182.  
  183.  - When installing OS/2,  you DO NOT have to tell the OS/2 install
  184.    program that you have a monochrome monitor installed.  If you
  185.    have already done so,  you may have something like this in your
  186.    config.sys:
  187.  
  188.     SET VIDEO_DEVICES=VIO_IBMVGA,VIO_IBMMPA
  189.     SET VIO_IBMVGA=DEVICE(BVHVGA)
  190.     SET VIO_IBMMPA=DEVICE(BVHMPA)
  191.  
  192.    You may wish to remove the support for your monochrome screen and
  193.    leave just:
  194.  
  195.     SET VIDEO_DEVICES=VIO_IBMVGA
  196.     SET VIO_IBMVGA=DEVICE(BVHVGA)
  197.  
  198.  - EchoMon MAY work with later versions of OS/2 1.10 (let me know).
  199.  
  200.  - EchoMon does NOT work with early versions of both OS/2 1.10 and
  201.    1.20.  The symptom:  All output sent via "stdout" and VioWrtTTY()
  202.    will not be visible.
  203.  
  204.  - EchoMon works with MS OS/2 1.21.
  205.  
  206.  - EchoMon has been tested and works with OS/2 2.00 (GA).
  207.  
  208.  
  209. DISCLAIMER
  210. ----------
  211.  
  212. The Program is supplied "AS IS" without any warranty of any kind,
  213. either expressed or  implied,  including, but not limited to, the
  214. implied warranties of merchantabilty and fitness for a particular
  215. purpose.
  216.  
  217. In  no  event  shall A:WARE INC be liable for any damages, either
  218. direct or  consequential,  caused by the use, or inability to use,
  219. this program, even  if A:WARE INC has been advised of the
  220. possibility of such damages.
  221.  
  222. LICENSE
  223. -------
  224. You are granted the right to use,  at no obligation,  EchoMon for a
  225. period of 30 days.  After that period,  you must either stop using
  226. EchoMon or register it with A:WARE Inc.
  227.  
  228. You are free distribute, with no obligation, the EchoMon package
  229. provided that:
  230.  
  231.      a) you distribute only verbatim copies of the EchoMon package
  232.         as you receive it; and
  233.      b) it is accompanied by unmodified copies of this documentation.
  234.  
  235. You MAY:
  236.  
  237.      a) Use a different compression tool to re-package the unmodified
  238.         EchoMon files before distribution.
  239.  
  240. You may NOT:
  241.  
  242.      a) distribute the contents of the EchoMon package in a modified
  243.         form.  This includes adding files and/or comments to the EchoMon
  244.         package/archive.  The EchoMon archive contains exactly 8 files:
  245.  
  246.         ECHOMON.SYS
  247.         ECHOMON.EXE
  248.         ECHOMON.DLL
  249.         ECHOMON.DOC
  250.         ECHOMON.REG
  251.         STUFF.LZH
  252.         EM_4000.SYS
  253.         M2.CMD
  254.  
  255.         If you distribute an EchoMon package with more or less than
  256.         the above listed files,  you are in violation of this
  257.         license agreement.   If you add an ARC/ZIP/ZOO/LZH/PAK
  258.         "comment" to the EchoMon package,  you are in violation of
  259.         this license agreement.
  260.  
  261.      b) distribute EchoMon in connection with any other product, service
  262.         or "value added" package,  without prior written permission from
  263.         A:WARE Inc.
  264.  
  265.      c) distribute EchoMon for general use within a company or
  266.         institution without first purchasing a site license.
  267.  
  268.      d) distribute EchoMon for any consideration or 'disk fee'.
  269.  
  270. Electronic Bulletin Board operators are encouraged to post EchoMon
  271. for downloading by their users,  provided that all of the above
  272. conditions are met.
  273.  
  274. ACKNOWLEDGMENTS
  275. --------------
  276. The author would like to thank Gerry Rozema for testing EchoMon,
  277. and for providing the "/B" idea.
  278.  
  279.  
  280. REGISTRATION
  281. ------------
  282. The registration fee is US$20 (CDN$24).  Please see the EchoMon.reg
  283. file for more information.
  284.  
  285. EchoMon is Copyright (c) 1990 A:Ware Inc.
  286.  
  287. A:WARE Inc.
  288. 6056 Cayeswood Court, Ste 100.
  289. Mississauga Ontario
  290. Canada
  291. L5V 1B1
  292.  
  293. Voice: (416)858-3222  (Peter Fitzsimmons.  Inquiries only).
  294.  
  295. The most recent version of EchoMon will always be posted for
  296. downloading on RT Lab bbs, (416)-867-9663 and 9664.  FidoNet node
  297. number 1:250/628 (Magic FileREQuest name is ECHOMON).
  298.  
  299.