home *** CD-ROM | disk | FTP | other *** search
/ PC-Test Pro / PCTESTPRO.iso / scsi / adaptec / os2 / org / vasp.exe / README.TXT < prev    next >
Encoding:
Text File  |  1994-06-22  |  8.9 KB  |  198 lines
  1. 06/22/94
  2.  
  3. This is the fourth BETA release of virtual ASPI for OS/2 2.1 that includes
  4. support for the ASPI for Windows specification. It is a minor improvement
  5. of the previous release, mostly to support scanners better.
  6.  
  7. The following ASPI access methods are now supported:
  8.  
  9.         1) DOS ASPI in a VDM.
  10.         2) DOS ASPI in a DOS boot image.
  11.         3) ASPI for Windows if a Win-OS/2 session.
  12.         4) DOS ASPI in a Win-OS/2 session.
  13.  
  14. Fixes since the last (06/14/94) release:
  15.  
  16. 1) VASPI.SYS will now work with more scanners. Many scanners apparently
  17.    report their device type as 3 (processor) instead of 6 (scanner);
  18.    the drivers now take this into consideration.
  19.  
  20. 2) VASPI.SYS now takes the hardware limitations of the SCSI adapter
  21.    into consideration when issuing requests. If the adapter hardware
  22.    cannot handle the transfer based on length of scatter/gather list
  23.    or size of CDB transfer, it will fail without being issued.
  24.  
  25. 3) OS2ASPI.DMD will now interact correctly with filters.
  26.  
  27. The following files are included as part of this BETA release:
  28.  
  29. 1) VASPI.SYS - The virtual ASPI device driver
  30. 2) VDPX.SYS - A replacement virtual DPMI extended driver
  31. 3) OS2ASPI.DMD - An OS/2 ASPI manager that support VASPI.SYS
  32. 4) ASPISTUB.SYS - A stub driver for accessing VASPI.SYS from a DOS
  33.                   boot image.
  34. 5) WINASPI.DLL - This DLL allows Win-OS/2 applications to make requests
  35.                  using the ASPI for Windows convention. It is a replacement
  36.                  for the DLL shipped with EZ-SCSI and is intended for OS/2
  37.                  2.1 only.
  38.  
  39.  
  40. Current limitations:
  41.  
  42. 1) VASPI works best with OS/2 2.11 (OS/2 2.1 with Service Pack).
  43.  
  44. 2) DOS ASPI (with posting) in a Win-OS/2 session does NOT work with 
  45.    OS/2 2.99 (Performance Beta). This problem appears to be very similar
  46.    to the limitation that was present in the previous beta. If you are
  47.    running Deskscan, you will have to use OS/2 2.11.
  48.  
  49. 3) Seamless Windows applications may crash on OS/2 2.1. If this occurs,
  50.    try updating to OS/2 2.11. Certain applications (i.e. Central Point
  51.    Backup for Windows) work best with the ASPI for Windows interface.
  52.    If you select ASPI for DOS, they may crash, regardless of the version
  53.    of OS/2 you are running.
  54.  
  55. Introduction to ASPI
  56.  
  57. ASPI is an application interface that allows easier access to SCSI
  58. devices. When running DOS, users typically load an ASPI manager that
  59. routes all requests directly to the hardware. ASPI drivers (such as ASPIDISK
  60. and ASPICD) send requests to the ASPI manager which then sends the command
  61. on to the appropriate device.
  62.  
  63. The device driver model used by OS/2 is layered (similar to ASPI) so that
  64. an adapter device driver (ADD) is responsible for knowing about the hardware
  65. dependencies of a particular SCSI adapter. Applications that wish to send 
  66. ASPI requests do so by routing them to a device manager (OS2ASPI.DMD) which
  67. converts them into requests recognizable to any ADD.
  68.  
  69. The ASPI support currently embedded within OS/2 2.1 allows any OS/2 
  70. application to send commands to a SCSI device. However there are 
  71. a large number of DOS and Windows applications that are could be
  72. supported if there commands were routed to OS2ASPI.DMD.
  73.  
  74. VASPI.SYS is a virtual device driver that will allow DOS applications
  75. to issue SCSI commands that will be handled by OS2ASPI.DMD. If you
  76. have an existing DOS ASPI application it should now be able to run
  77. in a virtual DOS session under OS/2 2.1. 
  78.  
  79. *** IMPORTANT ***
  80. Since VASPI.SYS acts just like an ASPI manager, there is no reason to load
  81. a standard MS-DOS ASPI manager, such as ASPI4DOS.SYS. In fact, loading
  82. such a driver is NOT possible and will conflict with the ADD that has
  83. already initialized the adapter.
  84.  
  85. Installation Instructions for VASPI Support
  86.  
  87. 1) Install OS/2 2.1 on your system
  88. 2) Make a backup copy of the file OS2ASPI.DMD. This should be found
  89.    in the \OS2 directory on your boot drive.
  90. 3) Copy the new VDD aware version of OS2ASPI.DMD into the \OS2 directory.
  91. 4) Copy the file VASPI.SYS into the directory \OS2\MDOS on your boot drive.
  92. 5) Make a backup copy of the file VDPX.SYS. This should be found in
  93.    the \OS2\MDOS directory on your boot drive.
  94. 6) Copy the new BETA version of VDPX.SYS into the \OS2\MDOS directory.
  95. 7) Copy the file WINASPI.DLL into the \OS2\MDOS\WINOS2 directory. 
  96. 5) Update CONFIG.SYS as follows:
  97.         a) Make sure the line BASEDEV=OS2ASPI.DMD is present somewhere
  98.            in the file.
  99.  
  100.         b) Add the line DEVICE=C:\OS2\MDOS\VASPI.SYS to the bottom of
  101.            the file. If your boot drive is NOT C:, use the appropriate 
  102.            letter instead.
  103.  
  104. 6) Shutdown your system and reboot.
  105. 7) Open a DOS window or DOS fullscreen and run your ASPI application.
  106.  
  107. Installation Instructions for DOS Boot Image Support
  108.  
  109. 1) Follow all the instructions for VDM Support.
  110. 2) Read the instructions for creating an image diskette in the OS/2
  111.    Master Help Index.
  112. 3) Create the boot disk with all the files that you will require for 
  113.    other applications.
  114. 4) Add the file ASPISTUB.SYS to this boot disk and add the line 
  115.    DEVICE=\ASPISTUB.SYS to CONFIG.SYS on the boot disk.
  116. 5) Complete the boot image creation.
  117. 6) Open the image.
  118.  
  119.  
  120. Device Allocation
  121.  
  122. OS/2 2.1 requires a device to be allocated by a device manager, such as
  123. OS2ASPI.DMD or OS2DASD.DMD before it can be accessed. Device managers can
  124. handle this in one of two ways: wait for a device driver to issue an 
  125. allocation request (OS2SCSI.DMD does this) or permanently allocate the
  126. device during system boot (OS2DASD.DMD and OS2CDROM.DMD do this).
  127.  
  128. The ASPI specification has no concept of device allocation and this really
  129. leaves it up to the implementation to decide what to do. Typically OS2ASPI
  130. will NOT allocate a device until the first execute I/O command is issued.
  131. This allows it to scan for devices and not interfere with them until an
  132. application decides to issue a command. However, once this allocation takes
  133. place OS2ASPI will not release the device because it can never be sure
  134. when the application is finished with it.
  135.  
  136. Most people can use OS2ASPI.DMD without any command line switches, but
  137. there are typically two situations that can arise which OS2ASPI has to 
  138. deal with :
  139.  
  140. 1) A user wishes to use two applications via different interfaces
  141. (i.e. OS2ASPI and OS2SCSI) and both need to access the device. 
  142. If the application using OS2SCSI is well behaved, it will release the device
  143. when it is finished and OS2ASPI will be able to allocate it. Unfortunately
  144. if OS2ASPI does not release the device, the OS2SCSI application will not
  145. be able to access the device until the system is rebooted and the device
  146. allocation information is reset.
  147.  
  148. 2) A user wishes to access a device that has been permanently allocated
  149. by another device manager. A good example of this would be a diagnostic
  150. that wants to report information about the system configuration. If the
  151. devices are allocated to another manager though, the application will
  152. never be able to see them.
  153.  
  154.  
  155. These two problems can be overcome by the use of optional command line
  156. switches.
  157.  
  158.         /ALL - This switch will instruct OS2ASPI.DMD to allow commands to
  159.                be issued to ANY device on the SCSI bus, even those allocated
  160.                by other managers.
  161.  
  162. *** WARNING *** Commands should be issued to devices under the control
  163. of other managers with extreme caution. If you are using the /ALL 
  164. switch and plan to issue commands to devices that are shared with another
  165. manager, try and limit them to non destructive commands like Inquiry and
  166. Test Unit Ready.
  167.  
  168.         /SHARE - This switch will instruct OS2ASPI.DMD to release any target
  169.                  after each command, allowing multiple managers to access
  170.                  a target (at different times). Since this requires more
  171.                  commands to be issued to the driver, there will be a slight
  172.                  performance penalty when this switch is used.
  173.  
  174.  
  175. *** WARNING *** When sharing devices and sending multiple concurrent requests
  176. it is possible that the allocation/deallocation of the device will cause a 
  177. command to be rejected. This switch is best suited for use when you have
  178. applications that require different managers but will not be used 
  179. simultaneously.
  180.  
  181. Examples:
  182. BASEDEV=OS2ASPI.DMD /SHARE
  183. BASEDEV=OS2ASPI.DMD /ALL
  184. BASEDEV=OS2ASPI.DMD /ALL /SHARE
  185.  
  186. When you find a problem with VASPI.SYS, please send a description of
  187. it to Adaptec so that we can attempt to reproduce it. Please describe 
  188. the exact steps  required to reproduce your problem and include any 
  189. screen dumps from the system where the problem occurred.
  190.  
  191. There are several methods available for reporting problems:
  192.  
  193. 1) The Adaptec BBS. The BBS can be reached at (408) 945-7727 and supports
  194.    upto 14.4K baud with 8 data bits, no parity and 1 stop bit. Please send
  195.    a PRIVATE message to the user VASPI_BETA.
  196.  
  197. 2) Internet. You can send problem reports to the user vaspi@adaptex.cirr.com.
  198.