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

- Vorlufige Dokumentation -


ARS Computer und Consulting GmbH
Frankfurter Ring 193a                   Tel. 0 89 / 3 23 66 30-0
D-80807 Muenchen                        Fax  0 89 / 3 24 45 24


$Id: manual.txt,v 1.1 1994/02/03 09:32:54 rommel Exp $
$Revision: 1.1 $

$Log: manual.txt,v $
Revision 1.1  1994/02/03 09:32:54  rommel
Initial revision



Inhalt:

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


1. berblick

OS/2 2.x enthlt eine Treiberarchitektur fr SCSI-Host-Adapter und
Peripherie-Gerte. Diese besteht aus einem Host-Adapter-spezifischen
Treiber (ADD) sowie darauf aufbauenden Gerte-Managern (DMD), die
entweder spezifisch fr Gerteklassen sind (Festplatten,
CD-ROM-Laufwerke) oder mit einer universellen Schnittstelle fr
weitere, anwendungsspezifische Gertetreiber versehen sind.

Einer dieser universellen Gerte-Manager von OS/2 2.x implementiert
die von Adaptec entwickelte ASPI-Programmierschnittstelle fr
OS/2. ASPI (Advanced SCSI Programming Interface) erlaubt die
Entwicklung von Anwendungen, die unabhngig vom eingesetzten
SCSI-Host-Adapter mit angeschlossenen Peripherie-Gerten kommunizieren
knnen. ASPI-Definitionen existieren fr 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-
Gerte-Manager OS2ASPI.DMD (siehe Online-Dokumentation von OS/2). In
dieser Form werden nur OS/2-Gerte-Treiber untersttzt, die auf der
ASPI-Schnittstelle aufbauen. Es knnen 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-Gerten ASPI verwenden (z.B. Backup-Software fr SCSI-Band-
laufwerke oder Scanner-Software fr SCSI-Scanner), konnten solche
Anwendungen bisher nicht unter OS/2 2.x eingesetzt werden.

Der vorliegende virtuelle ASPI-Treiber fr OS/2 2.x implementiert eine
ASPI-Schnittstelle fr DOS-Anwendungen (und Windows-Anwendungen, die
die DOS-ASPI-Schnittstelle benutzen) fr DOS- und Win-OS/2-Sessions
unter OS/2 2.x. Eine ASPI-Schnittstelle nach Adaptec's Windows-ASPI-
Definition (d.h. fr Win-OS/2) wird nicht implementiert. Auerdem
enthlt dieser Treiber eine ASPI-Schnittstelle fr OS/2-Anwendungen,
da diese sonst nicht direkt auf das OS/2-ASPI zugreifen knnen und
jeweils eigene Gerte-Treiber bentigen wrden.


2. Installation

Der virtuelle ASPI-Treiber besteht aus zwei Teilen:

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

b) dem virtuellen VASPI-Treiber, der die ASPI-Schnittstelle fr DOS-
   und Win-OS/2-Sessions implementiert, dieser Treiber heit
   VASPI.SYS.

Zur Installation werden beide Treiber in der CONFIG.SYS wie folgt
eingetragen (wir empfehlen, beide Treiber in das \OS2-Verzeichnis auf
Ihrem Boot-Laufwerk zu kopieren):

  DEVICE=C:\OS2\VASPIDD.SYS
  DEVICE=C:\OS2\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.

Die genaue Position dieser beiden Zeilen in CONFIG.SYS ist nicht
wichtig, wir empfehlen jedoch, beide Zeilen direkt nach der Zeile
BASEDEV=OS2ASPI.DMD einzutragen. Falls sich eine solche Zeile noch
nicht in Ihrer CONFIG.SYS befindet, lesen Sie bitte in der
OS/2-Dokumentation nach und fgen diese Zeile nach der BASEDEV=-Zeile
mit dem Treiber Ihres SCSI-Host-Adapters ein (dieser Treiber endet
immer in .ADD).

Damit ist die Installation abgeschlossen, Sie mssen Ihr System jedoch
neu starten, damit die nderungen wirksam werden.


3. DOS-Einstellungen

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


4. Programmier-Schnittstelle

Wenn Sie eigene DOS-Anwendungen fr ASPI entwickeln wollen, so knnen
Sie dies entsprechend der von Adaptec verfgbaren Dokumentation tun.
Wollen Sie OS/2-Anwendungen entwickeln, die auf ASPI zugreifen, wollen
jedoch keinen eigenen Gerte-Treiber dafr schreiben, so knnen Sie
auf die Programmierschnittstelle von VASPIDD.SYS zugreifen.

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

Das DOS-Beispielprogramm kann mit Microsoft C, Version 6.00 oder neuer
bersetzte werden. Fr andere Compiler sind nderungen notwendig, da
das Beispiel den Inline-Assembler fr den Zugriff auf die
DOS-ASPI-Schnittstelle benutzt. Dieses Beispielprogramm funktioniert
natrlich 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. Fr andere
OS/2-Compiler sollten nur minimale nderungen notwendig sein, da fr
den Zugriff auf VASPIDD.SYS die Standard-I/O-Control-Schnittstelle
verwendet wird.


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 knnen. 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-Peripheriegerte, sofern sie nicht bereits
(im Falle von Festplatten und CD-ROM-Laufwerken) von einem anderen
Gerte-Manager verwaltet werden. Bei allen gefundenen Gerten werden
Typ und Hersteller- bzw. Gerte-Name ausgegeben.


6. Kompatibilitt

Folgende DOS- bzw. Windows-Anwendungen wurden bisher auf
Kompatibilitt getestet:

- NovaStore NovaBack (SCSI-Backup-Software)
- GNU-tar (GTAK 1.00) (SCSI-Backup-Software)
- GNU-tar (ASPI-TAR) (SCSI-Backup-Software)

- HP DeskScan 2.0 (Scanner-Software), siehe unten

Sollten Sie andere Software mit diesem Treiber einsetzen, die hier
nicht aufgefhrt ist, bitten wir Sie um eine kurze Mitteilung, damit
wir Ihre Software in unsere Kompatibilitts-Liste aufnehmen knnen.


7. Bekannte Probleme

- HP DeskScan 2.0: die Software scannt zwar eine Seite ordnungsgem
  ein, gibt am Ende jedoch, statt des Bildes, eine Fehlermeldung aus.

- Derzeit kann zu einem Zeitpunkt nur eine Anwendung auf den
  virtuellen ASPI-Treiber zugreifen. Greift mehr als eine Anwendung
  darauf zu, fhrt dies zu einem Crash. Dieses Problem wird in einer
  spteren Version behoben sein.


8. Test-Berichte

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

- genaue Art, Bezeichnung, Version und Hersteller der Software
- Typ und Hersteller des SCSI-Peripherie-Gertes
- Typ und Hersteller des SCSI-Hostadapters
- Ursprung, Name und Datum/Gre des Host-Adapter-Treibers (.ADD)
- Ursprung, Name und Datum/Gre 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.
