.* $Id: german.txt,v 1.13 1994/09/14 12:37:47 rommel Exp rommel $
.* $Revision: 1.13 $

:h1 res=001.Deutsche Dokumentation
:p.Virtueller ASPI driver fr OS/2 2.x
.br
(C) 1994 ARS Computer und Consulting GmbH

:p.Inhalt:

:ol compact.
:li.:link reftype=hd res=1001 viewport.berblick:elink.
:li.:link reftype=hd res=1002 viewport.Installation:elink.
:li.:link reftype=hd res=1003 viewport.DOS-Einstellungen:elink.
:li.:link reftype=hd res=1004 viewport.Programmier-Schnittstelle:elink.
:li.:link reftype=hd res=1005 viewport.Test-Programme:elink.
:li.:link reftype=hd res=1006 viewport.Kompatibilitt:elink.
:li.:link reftype=hd res=1007 viewport.Bekannte Probleme:elink.
:li.:link reftype=hd res=1008 viewport.Test-Berichte:elink.
:eol.

:h2 res=1001.berblick
:p.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.

:p.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).

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

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

:p.Der vorliegende virtuelle ASPI-Treiber (VASPI) fr OS/2 2.x
implementiert eine ASPI-Schnittstelle fr DOS- und Windows-Anwendungen
in den DOS- und Win-OS/2-Sessions unter OS/2 2.x. Sowohl die
ASPI-Definition fr DOS als auch die ASPI-Definition fr Windows
wurden 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.

:h2 res=1002.Installation
:p.Der virtuelle ASPI-Treiber besteht aus vier Treiber-Dateien:
:ol.
:li.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
:li.dem virtuellen VASPI-Treiber, der die ASPI-Schnittstelle fr 
DOS-Sitzungen implementiert, dieser Treiber heit VASPI.SYS,
:li.dem Hilfs-Treiber fr spezifische DOS-Sitzungen (unter OS/2 von
DOS-Diskette oder Image-Datei gestartet), VASPISTB.SYS und
:li.der Windows-DLL, die die ASPI-Schnittstelle fr Windows
implementiert, WINASPI.DLL.
:eol.
:p.Zur automatischen Installation des VASPI-Treibers befindet sich
eine Gertetreiber-Konfigurationsdatei auf der VASPI-Diskette. Bitte
benutzen Sie das Gertetreiber-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-Gertetreiber fr Ihren SCSI-Hostadapter bereits installiert
wurde (siehe unten fr nhere Informationen). Bitte lesen Sie auch den
folgenden Text, fr Hinweise zur eventuellen Fehlersuche. Nachdem die
Installation beendet wurde, mssen Sie den Rechner neu starten, damit
die nderungen wirksam werden.

:p.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):
:xmp.
  DEVICE=C&colon.\OS2\VASPIDD.SYS
  DEVICE=C&colon.\OS2\MDOS\VASPI.SYS
:exmp.
:p.Falls Sie die Treiber auf einem anderen Laufwerk oder in einem anderen
Verzeichnis installiert haben oder Ihr System von einem anderen
Laufwerk als C&colon. startet, korrigieren Sie bitte die Zeilen
sinngem.

:p.Zustzlich zu den VASPI-Treibern mssen 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 untersttzt, fr viele weitere
Hostadapter sind OS/2-Treiber (.ADD) vom Hersteller verfgbar. Fr
den von OS/2 bereits untersttzten Hostadapter vom Typ Adaptec
AHA-1542 sind in CONFIG.SYS zum Beispiel zu laden:
:xmp.
  BASEDEV=AHA154X.ADD /V
  BASEDEV=OS2ASPI.DMD
:exmp.
:p.Fr 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.

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

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

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

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

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

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

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

:p.Laden alle Treiber korrekt, so knnen Sie schlielich mit den
mitgelieferten Testprogrammen (siehe unten) die Liste der verfgbaren
Gerte ausgeben. Diese Liste ist oft kuerzer als die vom ADD-Treiber
ausgegebene, da einige Gerte bereits von anderen Gerte-Managern als
dem ASPI-Manager verwaltet werden und daher nicht fuer ASPI verfgbar
sind.

:h2 res=1003.DOS-Einstellungen
:p.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.

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

:h2 res=1004.Programmier-Schnittstelle
:p.Wenn Sie eigene DOS-oder Windows-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.

:p.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 den ASPI-Definitionen fr DOS- und
OS/2-Anwendungen.

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

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

:p.Die Programmier-Schnittstelle fr OS/2-Anwendungen kennt zwar wie die
DOS- und Windows-ASPI-Definitionen auch einen "posting" und "non-
posting" Modus (siehe Adaptec-Dokumentation fr ASPI), jedoch ist
unter OS/2 aufgrund der Systemarchitektur ein "posting" nur fr
Gertetreiber mglich. 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 zurckkehren, wenn der
gewnschte SCSI-Request vollstndig abgearbeitet wurde, die Anwendung
blockiert also in diesem Aufruf fr 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.

:p.Das "posting" fr 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.

:p.Es knnen mehrere Anwendungen bzw. Threads gleichzeitig auf die
Schnittstelle zugreifen, der Treiber VASPIDD.SYS ist reentrant.

:h2 res=1005.Test-Programme
:p.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.

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

:h2 res=1006.Kompatibilitt
:p.Folgende DOS- bzw. Windows-Anwendungen wurden bisher erfolgreich auf
Kompatibilitt getestet:
:ol.
:li.SCSI-Tape-Backup-Software (mit einem Tandberg TDC-4100)
:ul compact.
:li.NovaStore NovaBack, Version 3.57
:li.CorelSCSI Tape Backup fr DOS, Version 1.22
:li.CorelSCSI Tape Backup fr Windows, Version 1.14
:li.Cheyenne ARCserve/Solo fr DOS, Version 2.11
:li.GNU-tar (GTAK 1.00)
:li.GNU-tar (ASPI-TAR)
:eul.
:li.SCSI-Scanner-Software
:ul compact.
:li.HP DeskScan fr Windows, Versionen 1.51 und 2.0
:li.Calera WordScan+ fr Windows (OCR-Software mit Scanner-Interface)
:li.Caere OmniPage 2.10 fr Windows (OCR software mit Scanner-Interface)
:li.ImpOS/2 1.10 (Bildbearbeitungs-Software mit Scanner-Interface)
.br
Diese OS/2-Software kann ber ein Hilfsprogramm auf einen
DOS-Gertetreiber fr HP-Scanner in einer DOS-Session zugreifen.
:eul.
:lp.(Diese Programme wurden mit einem HP ScanJet IIcx und dessen
mitgeliefertem ASPI-kompatiblen DOS-Treiber SJIIX.SYS getestet.)
:ul compact.
:li.HighScan fr Windows, Version 3.1, Scanner: Siemens ST-400
:li.Agfa PC View Color, Version 1.02, Scanner: Agfa Arcus Plus
:li.Agfa FotoLook, Version 1.26E, Scanner: Agfa Arcus Plus
:li.egsSoft Keyfile ScanServer, Scanner: Fujitsu M3096G
:li.Umax Magic Scan fr Windows, Scanner: Umax Power Look
:li.PhotoShop 2.5.5 fr Windows, Scanner: Microtek IISPX
:eul.
:lp.Die Programme HP DeskScan, Agfa FotoLook und Umax Magic Scan
stellen auch eine TWAIN-Schnittstelle zur Verfgung, so da damit und
den entsprechenden Scannern auch andere Windows-Programme
funktionieren, die Scanner ber eine TWAIN-Schnittstelle ansprechen
knnen, z.B. Adobe PhotoStyler, Picture Publisher oder Corel
PhotoPaint (aus Corel Draw 4.0 fr Windows).
:li.Sonstige SCSI-Software
:ul compact.
:li.DataStore fr Windows, Reflection Systems MOD-Laufwerk 7030e
:eul.
:eol.
:p.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.

:h2 res=1007.Bekannte Probleme
:ul.
:li.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-Auftrge werden
jedoch in diesem Fall fehlschlagen.

:li.Werden Windows-Programme, die ASPI benutzen, in WIN-OS/2-Sitzungen
vom Gesamt-Bildschirmtyp eingesetzt, so ist es normal, wenn sich
whrend der Wartezeit bei lang dauernden SCSI-Befehlen (zum Beispiel
Band zurckspulen usw.) der Mauszeiger nicht bewegen lt. Das ist
darauf zurckzufhren, da diese Sitzung whrend dieser Zeit im
ASPI-Treiber blockiert ist.

:li.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 zuverlssig mglich. Zwar knnen diese Programme auf
SCSI-Bandlaufwerke zugreifen, jedoch treten in unregelmigen
Abstnden Abstrze auf, die eine Beendigung der jeweiligen DOS-
bzw. WIN-OS/2-Sitzung zur Folge haben.
:eul.

:h2 res=1008.Test-Berichte
:p.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:
:ul compact.
:li.Version und Seriennummer des VASPI-Treibers
:li.genaue Art, Bezeichnung, Version und Hersteller der Software
:li.Typ und Hersteller des SCSI-Peripherie-Gertes
:li.Typ und Hersteller des SCSI-Hostadapters
:li.Ursprung, Name und Datum/Gre des Host-Adapter-Treibers (.ADD)
:li.Ursprung, Name und Datum/Gre des OS/2-ASPI-Treibers (OS2ASPI.DMD)
:li.Betriebssystem-Version (falls Sie nicht OS/2 2.1 einsetzen)
:li.Computer-Architektur (ISA, EISA, MCA, PCI)
:eul.
:p.sowie Ihrer Anschrift, Telefon- und Fax-Nummer.
