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


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.5 1994/03/01 16:18:07 rommel Exp $
$Revision: 1.5 $


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 (VASPI) 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 der VASPI-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 in Wirklichkeit aus zwei Treibern:

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 (solche Treiber enden
immer in .ADD).

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

Achten Sie darauf, dass beim Start Ihres Systems alle SCSI-Gerte am
Rechner korrekt angeschlossen und auch eingeschaltet sind. Die OS/2-
Treiber fr die meisten SCSI-Hostadapter und der OS/2-ASPI-Manager
prfen beim Laden nach, ob berhaupt Gerte zu verwalten sind. Ist
dies nicht der Fall, so laden sich die Treiber mglicherweise nicht.

Prfen Sie bitte auch, ob die Terminierung des SCSI-Bus korrekt
installiert ist. Ein hufig auftretender Fehler ist, da sowohl intern
als auch extern am SCSI-Hostadapter Gerte 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 Fllen werden unter Umstnden angeschlossene Gerte 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 Gerte vom SCSI-Hostadapter erkannt
wurden (falls das BIOS Ihres Hostadapters nicht schon beim Selbsttest
ein Liste der gefundenen Gerte ausgibt) knnen 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 Gerte.

Laden alle Treiber korrekt, so knnen Sie schlielich mit den
mitgelieferten Testprogrammen (siehe unten) die Liste der verfgbaren
Gerte ausgeben.


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.
Die Voreinstellung (OFF) kann global auf ON geaendert werden, indem
sie auf der Zeile DEVICE=C:\OS2\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.


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
bersetzt 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 erfolgreich auf
Kompatibilitt getestet:

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

- NovaStore NovaBack 3.57
- CorelSCSI Tape Backup (DOS-Version 1.22, Windows-Version 1.14)
- GNU-tar (GTAK 1.00)
- GNU-tar (ASPI-TAR)

b) SCSI-Scanner-Software

- HP DeskScan fr Windows, Versionen 1.51 und 2.0
- Calera WordScan+ fr 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-Gertetreiber fr 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 fr Windows, Version 3.1, Scanner: Siemens ST-400
- Agfa PC View Color, Version 1.02, Scanner: Agfa Arcus Plus

Sollten Sie andere Software mit dem VASPI-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

- 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. Diese Einschrnkung sollte jedoch
  kein Problem darstellen, da in der Regel ohnehin nur eine Anwendung
  zu einem Zeitpunkt auf einen Scanner oder ein Bandlaufwerk zugreifen
  kann.

- 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. Dies tritt dann ebenso
  auf, wenn nur OS2ASPI.DMD, nicht aber der VASPI-Treiber installiert
  wird. Es handelt sich also nicht um einen Fehler im VASPI-Treiber,
  sondern um das Problem, dass der OS/2-ASPI-Manager (OS2ASPI.DMD)
  denselben Gertenamen (SCSIMGR$) verwendet wie die ASPI- 
  Schnittstelle unter normalem DOS.

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-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.
