home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD2.mdf / c / library / os2 / os2x2 / ox2.doc < prev    next >
Encoding:
Text File  |  1989-06-21  |  2.6 KB  |  81 lines
  1.                   README.DOC
  2.                  for
  3.                  OX2
  4.  
  5. Description
  6. -----------
  7. OX2 is an OS/2 device driver which directs output to the AUX
  8. device to the monochrome monitor in a two-monitor system.  
  9.  
  10. You must have the following hardware to use this driver:
  11.  
  12.     - An AT-bus machine that runs OS/2
  13.     - A CGA, EGA, or VGA,    *and*
  14.     - An MDA, Hercules mono or clone adapter.
  15.  
  16. Unlike the standard AUX device in DOS, OX2 does not take input from
  17. anywhere, just because it would be really hard to do.  Therefore,
  18. attempting to read from the AUX device causes an error.
  19.  
  20. The main use of this driver is to direct messages to the
  21. secondary monitor from a program which otherwise doesn't have a
  22. console-like device at its disposal.
  23.  
  24. Usage
  25. -----
  26. You install the driver by adding a line to your CONFIG.SYS file:
  27.  
  28.     DEVICE=d:\path\OX2.SYS
  29.  
  30. Some uses of OX2:
  31.  
  32. - Your PM programs can use file I/O to the AUX device for debugging
  33.   messages on the second monitor:
  34.  
  35.       aux = fopen("AUX", "w");
  36.     fprintf(aux, "got this far...\n");
  37.  
  38. - You can redirect the output from MAKE to AUX to watch its progress
  39.   from any session, including the DOS mode session:
  40.  
  41.       make > AUX
  42.  
  43. - You can place directories and other listings on the second monitor
  44.   for reference while you're working on the main monitor:
  45.  
  46.       dir /w > AUX
  47.     type foo.txt > AUX
  48.  
  49. Notes and Restrictions
  50. ----------------------
  51. This is not the most robust driver you'll ever come across.  For
  52. starters, at present OS/2 crashes if a DOS mode program attempts to
  53. write to it.  Although an OS/2 program can write to it while the DOS
  54. box is in the foreground, the DOS box should not use it.  It is
  55. probably trivial to fix this problem, involving a semaphore here and
  56. there.  If I can figure it out I will post an update.
  57.  
  58. This driver does all that's asked of it at task time, which is 
  59. generally a no-no under multitasking OS's.  I did it this way because
  60. the writes usually don't take very long, and I wanted to keep it
  61. simple.
  62.  
  63. OS/2 doesn't appear to have an AUX device like DOS does, so this
  64. driver should not be supplanting any existing AUX.
  65.  
  66. Acknowledgements
  67. ----------------
  68. The idea for this driver, and in fact a chunk of its code, comes
  69. directly from the DOS device driver OX.SYS, written by the inimitable
  70. Mike Geary.
  71.  
  72. Like Geary's offering, this driver and source is also in the public
  73. domain.  If you have any ideas on how to improve it, please let me
  74. know or feel free to make your own modifications.
  75.  
  76. Me:         John W. Cocula
  77. Phone:      (202) 667-7530
  78. Genie:      J.COCULA
  79. BIX:        watou
  80. CompuServe: 72317,2513
  81.