OS/2 Shareware BBS: 4 Drivers/04-Drivers.zip/vaspi.zip/vaspi.inf

OS/2 Help File | 1994-09-14 | 30KB | 635 lines

ΓòÉΓòÉΓòÉ 1. Copyright ΓòÉΓòÉΓòÉ


    Virtual ASPI driver for OS/2 2.x
    (C) 1994 ARS Computer und Consulting GmbH


    ARS Computer und Consulting GmbH

    Frankfurter Ring 193a
    D-80807 Muenchen

    Germany


    Telephone:    +49 89 / 3 23 66 30-0
    Fax:          +49 89 / 3 24 45 24
    CompuServe:   100265,2651


ΓòÉΓòÉΓòÉ 2. Deutsche Dokumentation ΓòÉΓòÉΓòÉ

Virtueller ASPI driver fБr OS/2 2.x
(C) 1994 ARS Computer und Consulting GmbH

Inhalt:

   1. Ъberblick
   2. Installation
   3. DOS-Einstellungen
   4. Programmier-Schnittstelle
   5. Test-Programme
   6. KompatibilitДt
   7. Bekannte Probleme
   8. Test-Berichte


═══ 2.1. Ъberblick ═══

OS/2 2.x enthДlt eine Treiberarchitektur fБr SCSI-Host-Adapter und
Peripherie-GerДte. Diese besteht aus einem Host-Adapter-spezifischen Treiber
(ADD) sowie darauf aufbauenden GerДte-Managern (DMD), die entweder spezifisch
fБr GerДteklassen sind (Festplatten, CD-ROM-Laufwerke) oder mit einer
universellen Schnittstelle fБr weitere, anwendungsspezifische GerДtetreiber
versehen sind.

Einer dieser universellen GerДte-Manager von OS/2 2.x implementiert die von
Adaptec entwickelte ASPI-Programmierschnittstelle fБr OS/2. ASPI (Advanced SCSI
Programming Interface) erlaubt die Entwicklung von Anwendungen, die unabhДngig
vom eingesetzten SCSI-Host-Adapter mit angeschlossenen Peripherie-GerДten
kommunizieren kФnnen. ASPI-Definitionen existieren fБr DOS, Windows, OS/2 sowie
Novell NetWare 3.x und 4.x (Server).

Die in OS/2 2.x enthaltene ASPI-Schnittstelle befindet sich im Basis-
GerДte-Manager OS2ASPI.DMD (siehe Online-Dokumentation von OS/2). In dieser
Form werden nur OS/2-GerДte-Treiber unterstБtzt, die auf der ASPI-Schnittstelle
aufbauen. Es kФnnen weder OS/2-Anwendungsprogramme noch unter OS/2 2.x
ablaufende DOS/Windows-Anwendungen direkt auf die ASPI-Schnittstelle von OS/2
2.x zugreifen.

Da viele existierende DOS/Windows-Anwendungen zur Kommunikation mit
SCSI-GerДten ASPI verwenden (z.B. Backup-Software fБr SCSI-Band- laufwerke oder
Scanner-Software fБr SCSI-Scanner), konnten solche Anwendungen bisher nicht
unter OS/2 2.x eingesetzt werden.

Der vorliegende virtuelle ASPI-Treiber (VASPI) fБr OS/2 2.x implementiert eine
ASPI-Schnittstelle fБr DOS- und Windows-Anwendungen in den DOS- und
Win-OS/2-Sessions unter OS/2 2.x. Sowohl die ASPI-Definition fБr DOS als auch
die ASPI-Definition fБr Windows wurden implementiert. Auсerdem enthДlt der
VASPI-Treiber eine ASPI- Schnittstelle fБr OS/2-Anwendungen, da diese sonst
nicht direkt auf das OS/2-ASPI zugreifen kФnnen und jeweils eigene
GerДte-Treiber benФtigen wБrden.


ΓòÉΓòÉΓòÉ 2.2. Installation ΓòÉΓòÉΓòÉ

Der virtuelle ASPI-Treiber besteht aus vier Treiber-Dateien:

   1. dem physikalischen VASPI-Treiber, der die Verbindung zum OS/2-ASPI (das
      mit BASEDEV=OS2ASPI.DMD installiert wird) herstellt, dieser Treiber heiсt
      VASPIDD.SYS, sowie

   2. dem virtuellen VASPI-Treiber, der die ASPI-Schnittstelle fБr
      DOS-Sitzungen implementiert, dieser Treiber heiсt VASPI.SYS,

   3. dem Hilfs-Treiber fБr spezifische DOS-Sitzungen (unter OS/2 von
      DOS-Diskette oder Image-Datei gestartet), VASPISTB.SYS und

   4. der Windows-DLL, die die ASPI-Schnittstelle fБr Windows implementiert,
      WINASPI.DLL.

 Zur automatischen Installation des VASPI-Treibers befindet sich eine
 GerДtetreiber-Konfigurationsdatei auf der VASPI-Diskette. Bitte benutzen Sie
 das GerДtetreiber-Installationsprogramm im Ordner "System-Konfiguration" zur
 Installation des VASPI-Treibers. Dadurch wird auch, falls notwendig, der
 OS/2-ASPI-Treiber (OS2ASPI.DMD) in CONFIG.SYS geladen. Diese Installation
 setzt allerdings voraus, daс der Basis-GerДtetreiber fБr Ihren
 SCSI-Hostadapter bereits installiert wurde (siehe unten fБr nДhere
 Informationen). Bitte lesen Sie auch den folgenden Text, fБr Hinweise zur
 eventuellen Fehlersuche. Nachdem die Installation beendet wurde, mБssen Sie
 den Rechner neu starten, damit die Оnderungen wirksam werden.

 Zur manuellen Installation werden die beiden OS/2-Treiber in der CONFIG.SYS
 wie folgt eingetragen (wir empfehlen, die Treiber in die \OS2- bzw.
 \OS2\MDOS-Verzeichnisse auf Ihrem Boot-Laufwerk zu kopieren):

    DEVICE=C:\OS2\VASPIDD.SYS
    DEVICE=C:\OS2\MDOS\VASPI.SYS

 Falls Sie die Treiber auf einem anderen Laufwerk oder in einem anderen
 Verzeichnis installiert haben oder Ihr System von einem anderen Laufwerk als
 C: startet, korrigieren Sie bitte die Zeilen sinngemДс.

 ZusДtzlich zu den VASPI-Treibern mБssen auch in jedem Fall der Basis-Treiber
 des SCSI-Hostadapters (mit Endung .ADD) und der OS/2-ASPI-Treiber
 (OS2ASPI.DMD) geladen sein. Eine Reihe von Hostadaptern wird von OS/2 direkt
 unterstБtzt, fБr viele weitere Hostadapter sind OS/2-Treiber (.ADD) vom
 Hersteller verfБgbar. FБr den von OS/2 bereits unterstБtzten Hostadapter vom
 Typ Adaptec AHA-1542 sind in CONFIG.SYS zum Beispiel zu laden:

    BASEDEV=AHA154X.ADD /V
    BASEDEV=OS2ASPI.DMD

 FБr andere Hostadapter ist AHA154X.ADD durch den entsprechend passenden
 Treiber zu ersetzen. Weitere Informationen Бber OS2ASPI.DMD und die mit OS/2
 mitgelieferten ADD-Treiber sowie deren Optionen finden sie in der
 OS/2-(Online-)Dokumentation unter dem Thema BASEDEV.

 Die genaue Position der beiden Zeilen mit VASPIDD.SYS und VASPI.SYS in der
 CONFIG.SYS ist nicht wichtig, wir empfehlen jedoch, beide Zeilen direkt nach
 der Zeile BASEDEV=OS2ASPI.DMD einzutragen.

 Die Windows-DLL (WINASPI.DLL) ist in das Win-OS/2-System-Verzeichnis zu
 kopieren, in der Regel C:\OS2\MDOS\WINOS2\SYSTEM oder, bei OS/2 fБr Windows,
 C:\WINDOWS\SYSTEM.

 Der Hilfs-Treiber VASPISTB.SYS sollte in das Verzeichnis C:\OS2\MDOS kopiert
 werden. Er wird nur benФtigt, wenn eine spezielle Original-DOS-Version von
 Diskette oder Disketten-Image unter OS/2 gestartet werden soll und darin ASPI
 benФtigt wird. In diesem Fall muс VASPISTB.SYS in der CONFIG.SYS dieser
 DOS-Sitzung (nicht der CONFIG.SYS von OS/2) geladen werden.

 Damit ist die Installation abgeschlossen, Sie mБssen Ihr System jedoch neu
 starten, damit die Оnderungen wirksam werden.

 Achten Sie darauf, dass beim Start Ihres Systems alle SCSI-GerДte am Rechner
 korrekt angeschlossen und auch eingeschaltet sind. Die OS/2- Treiber fБr die
 meisten SCSI-Hostadapter und der OS/2-ASPI-Manager prБfen beim Laden nach, ob
 Бberhaupt GerДte zu verwalten sind. Ist dies nicht der Fall, so laden sich die
 Treiber mФglicherweise nicht.

 PrБfen Sie bitte auch, ob die Terminierung des SCSI-Bus korrekt installiert
 ist. Ein hДufig auftretender Fehler ist, daс sowohl intern als auch extern am
 SCSI-Hostadapter GerДte angeschlossen wurden, die Terminierung auf dem
 Hostadapter selbst aber nicht entfernt wurde (die Terminierung des SCSI-Bus
 darf nur an den beiden Enden erfolgen). In solchen FДllen werden unter
 UmstДnden angeschlossene GerДte nicht erkannt. Die Terminierung auf dem
 Hostadapter wird in der Regel durch Modifikation von Jumpern, DIP-Schaltern
 oder steckbaren Widerstandsleisten oder per Software eingestellt.

 Um festzustellen, ob und welche GerДte vom SCSI-Hostadapter erkannt wurden
 (falls das BIOS Ihres Hostadapters nicht schon beim Selbsttest ein Liste der
 gefundenen GerДte ausgibt) kФnnen Sie dem BASEDEV-Treiber Ihres Hostadapters
 in der CONFIG.SYS die Option /V angeben. Die meisten OS/2-ADD-Treiber kennen
 diese Option und reagieren darauf meist mit Ausgabe von Versionsnummern, ggf.
 Hardware- Versionen sowie einer Liste der gefundenen GerДte.

 Laden alle Treiber korrekt, so kФnnen Sie schlieсlich mit den mitgelieferten
 Testprogrammen (siehe unten) die Liste der verfБgbaren GerДte ausgeben. Diese
 Liste ist oft kuerzer als die vom ADD-Treiber ausgegebene, da einige GerДte
 bereits von anderen GerДte-Managern als dem ASPI-Manager verwaltet werden und
 daher nicht fuer ASPI verfБgbar sind.


ΓòÉΓòÉΓòÉ 2.3. DOS-Einstellungen ΓòÉΓòÉΓòÉ

Wenn Sie die Treiber korrekt installiert haben und Ihr System neu gestartet
haben, werden Sie in den DOS-Einstellungen fБr Ihre DOS-Programm-Objekte einen
neuen Eintrag finden, ASPI_AVAILABLE. Dieser Parameter legt fest, ob fБr die
durch dieses Objekt gestartete Session das ASPI-Interface verfБgbar ist oder
nicht. Die Voreinstellung ist OFF, d.h. das ASPI-Interface ist NICHT verfБgbar.
Оndern Sie diesen Parameter fБr alle Programm-Objekte, mit denen Sie Ihre
ASPI-Anwendungen (DOS bzw. Win-OS/2) starten, auf ON.

Die Voreinstellung (OFF) kann global auf ON geaendert werden, indem sie auf der
Zeile DEVICE=C:\OS2\MDOS\VASPI.SYS in CONFIG.SYS die Option /ON angeben. In
diesem Fall haben alle DOS- bzw. Win-OS/2-Sessions automatisch ASPI verfuegbar,
jedoch koennen Sie ASPI fuer jede Session bei Bedarf immer noch getrennt
abschalten.


ΓòÉΓòÉΓòÉ 2.4. Programmier-Schnittstelle ΓòÉΓòÉΓòÉ

Wenn Sie eigene DOS-oder Windows-Anwendungen fБr ASPI entwickeln wollen, so
kФnnen Sie dies entsprechend der von Adaptec verfБgbaren Dokumentation tun.
Wollen Sie OS/2-Anwendungen entwickeln, die auf ASPI zugreifen, wollen jedoch
keinen eigenen GerДte-Treiber dafБr schreiben, so kФnnen Sie auf die
Programmierschnittstelle von VASPIDD.SYS zugreifen.

Beispiele fБr DOS- und OS/2-Anwendungen dieser Art finden Sie auf der
mitgelieferten Diskette, im Verzeichnis \SAMPLES. Darin befinden sich die
Quelltexte der unten erwДhnten DOS- bzw. OS/2-Testprogramme fБr ASPI sowie eine
C-Header-Datei mit den ASPI-Definitionen fБr DOS- und OS/2-Anwendungen.

Das DOS-Beispielprogramm kann mit Microsoft C, Version 6.00 oder neuer
Бbersetzt werden. FБr andere Compiler sind Оnderungen notwendig, da das
Beispiel den Inline-Assembler fБr den Zugriff auf die DOS-ASPI-Schnittstelle
benutzt. Dieses Beispielprogramm funktioniert natБrlich auch unter normalem DOS
mit ASPI-Treibern.

Das OS/2-Beispielprogramm kann als 16-bit-Anwendung mit Microsoft C, Version
6.00 oder Watcom C/C++ 16, Version 9.5 Бbersetzt werden. Zur Erzeugung einer
32-bit-Anwendung kann IBM C Set++, Watcom C/C++ 32, Version 9.5, oder der
GNU-C-Compiler verwendet werden. FБr andere OS/2-Compiler sollten nur minimale
Оnderungen notwendig sein, da fБr den Zugriff auf VASPIDD.SYS die
Standard-I/O-Control-Schnittstelle verwendet wird.

Die Programmier-Schnittstelle fБr OS/2-Anwendungen kennt zwar wie die DOS- und
Windows-ASPI-Definitionen auch einen "posting" und "non- posting" Modus (siehe
Adaptec-Dokumentation fБr ASPI), jedoch ist unter OS/2 aufgrund der
Systemarchitektur ein "posting" nur fБr GerДtetreiber mФglich. SCSI-Requests,
die Бber die Programmier- Schnittstelle in VASPIDD.SYS aufgerufen werden,
werden immer im "posting"-Modus abgearbeitet, jedoch befindet sich die
Post-Routine innerhalb dieses Treibers und es kann keine Post-Routine in der
Anwendung definiert werden. Das bedeutet, daс Aufrufe Бber diese
Programmier-Schnittstelle erst zur Anwendung zurБckkehren, wenn der gewБnschte
SCSI-Request vollstДndig abgearbeitet wurde, die Anwendung blockiert also in
diesem Aufruf fБr diese Zeit. Dies betrifft jedoch nur den aufrufenden Thread.
Wenn die Anwendung also zur gleichen Zeit noch andere Aufgaben erledigen soll,
muс sie "multi-threaded" geschrieben sein.

Das "posting" fБr die DOS- und Windows-ASPI- Schnittstellen funktioniert
jedoch, es wird vom virtuellen ASPI-Treiber simuliert, da dies von
existierenden DOS- und Windows- Anwendungen verwendet wird.

Es kФnnen mehrere Anwendungen bzw. Threads gleichzeitig auf die Schnittstelle
zugreifen, der Treiber VASPIDD.SYS ist reentrant.


ΓòÉΓòÉΓòÉ 2.5. Test-Programme ΓòÉΓòÉΓòÉ

Auf der Diskette befinden sich zwei Test-Programme, ASPI.EXE (eine
DOS-Anwendung) und ASPI2.EXE (eine OS/2-Anwendung), die zur Diagnose verwendet
werden kФnnen. Dies sind zugleich Beispielprogramme (siehe oben) und werden
auch als Quelltext mitgeliefert.

Beide Programme, sowohl DOS- als auch OS/2-Version, verwenden ASPI, um alle im
System vorhandenen SCSI-Host-Adapter anzuzeigen sowie alle an diese
angeschlossenen SCSI-PeripheriegerДte, sofern sie nicht bereits (im Falle von
Festplatten und CD-ROM-Laufwerken) von einem anderen GerДte-Manager verwaltet
werden. Bei allen gefundenen GerДten werden Typ und Hersteller- bzw.
GerДte-Name ausgegeben.


═══ 2.6. KompatibilitДt ═══

Folgende DOS- bzw. Windows-Anwendungen wurden bisher erfolgreich auf
KompatibilitДt getestet:

   1. SCSI-Tape-Backup-Software (mit einem Tandberg TDC-4100)

          NovaStore NovaBack, Version 3.57
          CorelSCSI Tape Backup fБr DOS, Version 1.22
          CorelSCSI Tape Backup fБr Windows, Version 1.14
          Cheyenne ARCserve/Solo fБr DOS, Version 2.11
          GNU-tar (GTAK 1.00)
          GNU-tar (ASPI-TAR)

   2. SCSI-Scanner-Software

          HP DeskScan fБr Windows, Versionen 1.51 und 2.0
          Calera WordScan+ fБr Windows (OCR-Software mit Scanner-Interface)
          Caere OmniPage 2.10 fБr Windows (OCR software mit Scanner-Interface)
          ImpOS/2 1.10 (Bildbearbeitungs-Software mit Scanner-Interface)
           Diese OS/2-Software kann Бber ein Hilfsprogramm auf einen
           DOS-GerДtetreiber fБr HP-Scanner in einer DOS-Session zugreifen.

 (Diese Programme wurden mit einem HP ScanJet IIcx und dessen mitgeliefertem
 ASPI-kompatiblen DOS-Treiber SJIIX.SYS getestet.)

          HighScan fБr Windows, Version 3.1, Scanner: Siemens ST-400
          Agfa PC View Color, Version 1.02, Scanner: Agfa Arcus Plus
          Agfa FotoLook, Version 1.26E, Scanner: Agfa Arcus Plus
          egsSoft Keyfile ScanServer, Scanner: Fujitsu M3096G

 Die Programme HP DeskScan und Agfa FotoLook stellen auch eine
 TWAIN-Schnittstelle zur VerfБgung, so daс damit und den entsprechenden
 Scannern auch andere Windows-Programme funktionieren, die Scanner Бber eine
 TWAIN-Schnittstelle ansprechen kФnnen, z.B. Adobe PhotoStyler, Picture
 Publisher oder Corel PhotoPaint (aus Corel Draw 4.0 fБr Windows).

 Sollten Sie andere Software mit dem VASPI-Treiber einsetzen, die hier nicht
 aufgefБhrt ist, bitten wir Sie um eine kurze Mitteilung, damit wir Ihre
 Software in unsere KompatibilitДts-Liste aufnehmen kФnnen.


ΓòÉΓòÉΓòÉ 2.7. Bekannte Probleme ΓòÉΓòÉΓòÉ

     Wird fuer eine DOS-Session das ASPI-Interface abgeschaltet, so kann
      eventuell manche ASPI-kompatible Software irrtuemlich annehmen, es sei
      dennoch eine ASPI-Schnittstelle vorhanden. Alle ASPI-AuftrДge werden
      jedoch in diesem Fall fehlschlagen.

     Werden Windows-Programme, die ASPI benutzen, in WIN-OS/2-Sitzungen vom
      Gesamt-Bildschirmtyp eingesetzt, so ist es normal, wenn sich wДhrend der
      Wartezeit bei lang dauernden SCSI-Befehlen (zum Beispiel Band
      zurБckspulen usw.) der Mauszeiger nicht bewegen lДсt. Das ist darauf
      zurБckzufБhren, daс diese Sitzung wДhrend dieser Zeit im ASPI-Treiber
      blockiert ist.

     Der Betrieb der Central Point Backup-Programme in den DOS- (8.0, 9.0) und
      Windows-Versionen (2.0) von PC-TOOLS mit dem VASPI-Treiber ist nicht
      zuverlДssig mФglich. Zwar kФnnen diese Programme auf SCSI-Bandlaufwerke
      zugreifen, jedoch treten in unregelmДсigen AbstДnden AbstБrze auf, die
      eine Beendigung der jeweiligen DOS- bzw. WIN-OS/2-Sitzung zur Folge
      haben.


ΓòÉΓòÉΓòÉ 2.8. Test-Berichte ΓòÉΓòÉΓòÉ

Sollten Sie mit einer ASPI-kompatiblen DOS- oder Windows-Software Probleme beim
Einsatz mit dem VASPI-Treiber haben, bitten wir um Ъbersendung eines
Fehler-Berichtes mit folgenden Angaben:

     Version und Seriennummer des VASPI-Treibers
     genaue Art, Bezeichnung, Version und Hersteller der Software
     Typ und Hersteller des SCSI-Peripherie-GerДtes
     Typ und Hersteller des SCSI-Hostadapters
     Ursprung, Name und Datum/GrФсe des Host-Adapter-Treibers (.ADD)
     Ursprung, Name und Datum/GrФсe des OS/2-ASPI-Treibers (OS2ASPI.DMD)
     Betriebssystem-Version (falls Sie nicht OS/2 2.1 einsetzen)
     Computer-Architektur (ISA, EISA, MCA, PCI)

 sowie Ihrer Anschrift, Telefon- und Fax-Nummer.


ΓòÉΓòÉΓòÉ 3. English Documentation ΓòÉΓòÉΓòÉ

Virtual ASPI driver for OS/2 2.x
(C) 1994 ARS Computer und Consulting GmbH

Contents:

   1. Overview
   2. Installation
   3. DOS Settings
   4. Programmer's API
   5. Test Programs
   6. Compatibility
   7. Known Problems
   8. Test/Problem Reports


ΓòÉΓòÉΓòÉ 3.1. Overview ΓòÉΓòÉΓòÉ

OS/2 2.x contains a driver architecture for SCSI host adaptors and peripheral
devices. It consists of a host adaptor specific driver (ADD) and, based on
this, device managers (DMD) which are either specific for common classes of
devices (hard disks, CD-ROM drives) or which provide a universal interface for
additional application specific device drivers.

One of these universal device managers in OS/2 2.x implements Adaptec's ASPI
programming interface for OS/2. ASPI (Advanced SCSI Programming Interface)
allows development of applications, which can communicate with peripheral
devices, independent of the actual SCSI host adaptor. ASPI definitions exist
for DOS, Windows, OS/2 and Novell NetWare 3.x and 4.x servers.

The ASPI programming interface in OS/2 2.x resides in the base device manager
OS2ASPI.DMD (please refer to the OS/2 online documentation for more information
about it). In this implementation, it supports only OS/2 device drivers which
build upon the ASPI interface. Neither can OS/2 applications nor can DOS and
Windows applications running under OS/2 2.x access the ASPI interface of OS/2
2.x directly.

Since many existing DOS and Windows applications use ASPI to communicate with
SCSI devices (for example, backup software for SCSI tape devices or image
scanning software for SCSI scanners), such applications could not be used under
OS/2 2.x so far.

The included virtual ASPI driver (VASPI) for OS/2 2.x implements an ASPI
interface for DOS and Windows applications running in DOS and WIN-OS/2 sessions
under OS/2 2.x. Both the ASPI definition for DOS and the ASPI definition for
Windows are implemented. In addition the driver contains an ASPI interface for
OS/2 applications, since they can otherwise not directly access the OS/2 ASPI
and would thus need their own device drivers for this purpose.


ΓòÉΓòÉΓòÉ 3.2. Installation ΓòÉΓòÉΓòÉ

The virtual ASPI driver consists of four drivers modules:

   1. the physical VASPI driver which connects to the OS/2 ASPI driver (which
      is installed with BASEDEV=OS2ASPI.DMD), this module is named VASPIDD.SYS,

   2. the virtual VASPI driver which implements the ASPI definition for DOS
      sessions, named VASPI.SYS,

   3. the stub device driver for specific DOS sessions (booted from a DOS
      floppy or image file under OS/2), VASPISTB.SYS and

   4. the Windows DLL which implements the ASPI definition for Windows, named
      WINASPI.DLL.

 For automatic installation, a device driver profile is included. Use the
 "Device Driver Install" object in the "System Setup" folder to install the
 VASPI driver. This procedure also takes care to add the reference to the OS/2
 ASPI driver (OS2ASPI.DMD) to your CONFIG.SYS, if necessary. However, this
 installation method assumes that the base device driver for your SCSI host
 adaptor is already installed (see below for more information). Please also
 read the text below on trouble shooting. After installation is completed, you
 have to reboot your system for the changes to take effect.

 For manual installation, the two core device drivers are loaded in CONFIG.SYS
 as follows (we suggest copying both drivers into the \OS2 and \OS2\MDOS
 directories on your system boot drive):

    DEVICE=C:\OS2\VASPIDD.SYS
    DEVICE=C:\OS2\MDOS\VASPI.SYS

 If you install the drivers on another drive or directory or your system boots
 from a different drive than C:, please correct the two lines as needed.

 In addition to the VASPI drivers there must also two additional drivers always
 be loaded: the base device driver for the SCSI host adaptor (with extension
 .ADD) and the OS/2 ASPI driver (OS2ASPI.DMD). A number of host adaptors is
 directly supported by OS/2 and for many other host adaptors there are OS/2
 drivers (.ADD) available from the manufacturer. For the Adaptec AHA-1542 host
 adaptor, which is directly supported by OS/2, the following drivers are to be
 loaded in CONFIG.SYS, for example:

    BASEDEV=AHA154X.ADD /V
    BASEDEV=OS2ASPI.DMD

 For other host adaptors AHA154X.ADD has to be replaced by the appropriate
 driver. More details about OS2ASPI.DMD, the ADD drivers included with OS/2 and
 their options are available in the OS/2 (online) documentation under the topic
 BASEDEV.

 The exact position of the two lines loading VASPIDD.SYS and VASPI.SYS in
 CONFIG.SYS is not significant, but we suggest putting them directly after the
 BASEDEV=OS2ASPI.DMD line.

 The Windows DLL (WINASPI.DLL) must be copied into the WIN-OS/2 system
 directory, usually C:\OS2\MDOS\WINOS2\SYSTEM, or, in the case of OS/2 for
 Windows, C:\WINDOWS\SYSTEM.

 The stub device driver VASPISTB.SYS should be copied to C:\OS2\MDOS. It will
 only be needed if a real (original) DOS version is started under OS/2 from a
 DOS floppy or a floppy image and ASPI is needed. In this case, VASPISTB.SYS
 must be loaded in the CONFIG.SYS of that DOS session (and not in the OS/2
 CONFIG.SYS).

 With these steps, the installation is completed, but you have to restart
 (reboot) your system to make the changes active.

 Please ensure that during boot of your system all SCSI peripherals are
 correctly connected to the compuer and are also turned on. The OS/2 drivers
 for most SCSI host adaptore and the OS/2 ASPI device manager check at load
 time, if there are devices to manage at all. If that is not the case, these
 drivers perhaps don't even load.

 Please check also, if the SCSI bus termination is installed correctly. A
 common error is that both internal and external devices are connected to the
 SCSI host adaptor but the termination on the host adaptor itself was not
 removed (the SCSI bus must be terminated only on both ends). In such cases
 some or all connected devices may not be detected and data transfer errors can
 occur. The termination on the host adaptor is usually configured with jumpers,
 DIP switches, removable resistor packs or even via software.

 To determine if and which devices are recognized by the host adaptor (if that
 feature is not already provided by your host adaptors BIOS during the power on
 self test) you can add the /V option to your host adaptors BASEDEV driver in
 CONFIG.SYS. Most OS/2 ADD drivers recognize this option and respond by
 displaying version numbers, perhaps hardware revisions and most often a list
 of found SCSI devices.

 If all drivers load correctly, you can finally use the included test programs
 (see below) to retrieve a list of available devices for ASPI applications.
 This list will often be shorter that the ADD drivers list, because some
 devices may already be in use by other device managers and are thus not
 available to the ASPI manager.


ΓòÉΓòÉΓòÉ 3.3. DOS Settings ΓòÉΓòÉΓòÉ

After you have installed the driver(s) correctly and have restarted your
system, you will find a new entry in the DOS settings of DOS program objects,
ASPI_ENABLE. This parameter defines, if ASPI is available in the session
started from this object. The default is OFF, i.e. the ASPI interface is NOT
available. Please change this parameter for all those program objects which you
use to start your (DOS and WIN-OS/2) ASPI applications to ON.

The default (OFF) can be changed globally to ON by adding the option /ON to the
line DEVICE=C:\OS2\MDOS\VASPI.SYS in your CONFIG.SYS. In this case all DOS and
WIN-OS/2 sessions have ASPI available automatically, but you can still disable
ASPI for each program object individually.


ΓòÉΓòÉΓòÉ 3.4. Programmer's API ΓòÉΓòÉΓòÉ

If you want to develop own DOS or Windows applications for ASPI, you can use
the documentation and sample code available from Adaptec. If you want to
develop OS/2 ASPI applications but want to avoid writing your own device driver
interfacing with OS/2's ASPI manager, you can use the API included in
VASPIDD.SYS.

You can find sample DOS and OS/2 ASPI applications in the \SAMPLES directory in
the distribution of this driver. It contains the source code for the DOS and
OS/2 test programs for ASPI (as mentioned below) and a C header file with the
ASPI definitions for DOS and OS/2 ASPI applications.

The DOS test program can be compiled with Microsoft C, version 6.00 or newer.
For other compilers, changes are required because inline assembly language
statements are used for access to the DOS ASPI interface. This sample program
does of course also work under plain DOS with standard ASPI drivers.

The OS/2 test program can be compiled as 16-bit application with Microsoft C,
version 6.00 or Watcom C/C++ 16, version 9.5 or higher. To generate a 32-bit
version, IBM C Set++, Watcom C/C++ 32, version 9.5 or higher or the GNU C
compiler can be used. For other compilers only minimal changes should be
required, since the standard I/O control interface is used for access to
VASPIDD.SYS.

This API for OS/2 ASPI applications knows a "posting" and a "non- posting"
mode, just like the DOS and Windows versions (see Adaptec ASPI documentation
for an explanation what posting means). However, because of the proteced
architecture of OS/2, postimg mode is only possible for device drivers
interfacing directly with the OS/2 ASPI manager. SCSI requests via the API in
VASPIDD.SYS are always processed in posting mode, but the post routine is
contained in this driver and there is no way to define a post routine in the
calling application. That means that a request via this API does only return to
the calling application when it was completely processed, the application will
be blocked until this is the case. However, this blocking only affects the
calling thread. If the application has to do other work during this time, it
must be multithreaded.

Posting for DOS and Windows ASPI applications works, it is simulated by the
virtual ASPI driver, because existing DOS and Windows applications use that
feature.

There can be more than one application or thread accessing the API at a time,
the VASPIDD.SYS driver is reentrant.


ΓòÉΓòÉΓòÉ 3.5. Test Programs ΓòÉΓòÉΓòÉ

In the distribution there are two test programs, ASPI.EXE (a DOS application)
and ASPI2.EXE (an OS/2 application), that can be used for diagnostic purposes.
They are sample programs too (see above) and their source code is included.

Both programs, DOS and OS/2 version, use ASPI to list all SCSI host adaptors in
the system and all SCSI peripheral devices connected to them, as long as they
are not yet in use by other device managers (as it is the case with hard disks
and CD-ROM drives). For all devices found the device type, vendor name and
device name are listed.


ΓòÉΓòÉΓòÉ 3.6. Compatibility ΓòÉΓòÉΓòÉ

The following DOS and Windows applications were testes successfully for
compatibility:

   1. SCSI tape backup software (with a Tandberg TDC-4100 streamer)

          NovaStore NovaBack, version 3.57
          CorelSCSI Tape Backup for DOS, version 1.22
          CorelSCSI Tape Backup for Windows, version 1.14
          Cheyenne ARCserve/Solo for DOS, version 2.11
          GNU tar (GTAK 1.00)
          GNU tar (ASPI-TAR)

   2. SCSI image scanning software

          HP DeskScan for Windows, versions 1.51 and 2.0
          Calera WordScan+ for Windows (OCR software with scanner interface)
          Caere OmniPage 2.10 for Windows (OCR software with scanner
           interface)
          ImpOS/2 1.10 (image processing software with scanner interface)
           This OS/2 software cann access a DOS HP scanner device driver via a
           auxiliary program in a DOS session.

 (These applications were tested with a HP ScanJet IIcx and the included ASPI
 compatible DOS device driver SJIIX.SYS.)

          HighScan for Windows, version 3.1, scanner: Siemens ST-400
          Agfa PC View Color, version 1.02, scanner: Agfa Arcus Plus
          Agfa FotoLook, version 1.26E, scanner: Agfa Arcus Plus
          egsSoft Keyfile ScanServer, Scanner: Fujitsu M3096G

 The HP DeskScan and Agfa FotoLook applications also provide a TWAIN interface
 for Windows applications and let thus other Windows applications access the
 scanner if they support TWAIN, for example, Adobe PhotoStyler, Picture
 Publisher or Corel PhotoPain (part of Corel Draw 4.0 for Windows).

 If you use other software with this VASPI driver which is not listed here,
 please send us a short notice to allow us adding it to this compatibility
 list.


ΓòÉΓòÉΓòÉ 3.7. Known Problems ΓòÉΓòÉΓòÉ

     If the ASPI interface is turned off for a DOS session (via the DOS
      settings), some ASPI compatible software may still detect the
      availability of an ASPI interface. However, all further ASPI requests
      will fail in any case.

     If you run Windows ASPI applications in fullscreen WIN-OS/2 sessions, it
      is normal if during processing of SCSI requests which take rather long to
      complete (tape rewinding, for example) the mouse pointer cannot be moved.
      This is caused by the fact that the session is blocked in the ASPI driver
      during this time.

     The Centrol Point backup programs in the DOS (8.0, 9.0) and Windows (2.0)
      versions of the PC-TOOLS packages do not work reliably with this VASPI
      driver. While these programs can access SCSI tape devices, they may crash
      at random occasions, causing the affected DOS or WIN-OS/2 session to be
      terminated.


ΓòÉΓòÉΓòÉ 3.8. Test/Problem Reports ΓòÉΓòÉΓòÉ

If you should have problems using an ASPI compatible DOS or Windows software
with this VASPI driver, please send a report with the following items included:

     version and serial number of the VASPI driver
     exact type, name, version and vendor of the affected software
     type and manufacturer of the SCSI peripheral device
     type and manufacturer of the SCSI host adaptor
     source, name and date/size of the host adaptor driver (.ADD)
     source, name and date/size of the OS/2 ASPI manager (OS2ASPI.DMD)
     operating system version (if not OS/2 2.1)
     computer bus architecture (ISA, EISA, MCA, PCI)

 and your address, phone and fax number.