November 1993   ASPI NLM software

This NLM requires a software NLM for Netware that works with ASPI using
the standard ASPI Entry points.  We have tested with several Tape NLM
products and with Opti-Net from On Line for CD-ROMs.  Corel uses a .DSK
entry instead of a standard ASPI entry and won't work with this NLM.

Note that ONLY the T130, T160 and T358 MiniSCSI EPP are supported with
these NLMs.  The older T128 is incompatible in architecture with Novell
3.xx and 4.xx and will not be supported.
***********************************************************************

NLM Software Installation

This chapter details Trantor's ASPI Manager Modules for the Novell
NetWare 386 v3.11 or later platforms. These modules are called NetWare
Loadable Modules or NLMs.

NLM Introduction

An ASPI manager is included with NetWare 386 (3.11, 3.12, and 4.0).

Given the flexibility of ASPI, many companies are currently providing
server-based CD-ROM and tape backup solutions through ASPI. There are
other ASPI modules already developed or under development.


The following is a check list of what you need to get started:

	IBM PC AT-compatible system or EISA system

	Trantor's PC/XT/AT-compatible boards (T130, T160, T358)

        SCSIworks! diskettes

	Novell NetWare 386 v3.11 or later

	One or more Local Area Network (LAN) cards  

	SCSIworks! Users Guide (this document)

Other manuals that may help you:

        Trantor Hardware Installation Guide

        386 Installation, SFT NetWare Manuals (provided by Novell)

NLM  Files

NetWare Loadable Module files are located in the NLM directory on the
SCSIworks! diskettes. These files include:

ASPITRAN.DSK--The device driver that provides one entry point for any
ASPI application.

MA13B.NLM--The NLM for the T130 SCSI host adapter.

MA160.NLM--The NLM for the T160 SCSI host adapter.

MA358.NLM--The NLM for the T358 SCSI host adapter.


NLM Installation

The following is a quick overview for installing Trantor NLMs:

1. Make one (1) backup copy of each Novell and Trantor supplied
diskettes using the DOS DISKCOPY command and use these backup copies as
your working diskettes.

2. Use the NetWare 386 file SERVER.EXE to start the installation
process. When you are prompted for a file server name and an IPX
internal network number, consult the NetWare User Manual for the
information.

3. Boot your NetWare 386 file server. Consult the NetWare User Manual
for the information.

4. Load the NLM into NetWare 386 using of the LOAD console command. See
Loading the NLM for details.

5. Make sure the module ASPITRAN.DSK is in the same [path] or in the
SYSTEM directory of SYS: Volume.

Parameters

The following is a list of the parameters available for the Trantor
T130, T160 and T358 host adapters. The table identifies the syntax and
parameter options.

Command line parameters must be separated by spaces; however, they can
be in upper or lower case.

PORT--The I/O port address for the host adapter. This parameter is
mandatory, and if a port is not specified at the command line, the
software prompts you for a port. The syntax is PORT=xxx.

INT--The interrupt setting. This parameter is mandatory, and if an
interrupt is not specified at the command line, the software prompts you
for an interrupt. The syntax is INT=y.

RESET--Performs a SCSI bus reset upon module load. This parameter is
optional. The syntax is RESET.

MODE--The mode configuration switch for the T358 host adapter only. The
syntax is MODE=mn and the default is 00. Some parallel ports require
additional delays to the read and write cycles of the device. The amount
of additional time the T358 read and write cycles are delayed is
controlled by the value of n. n may be set to any value between 0 to 7.
0 (the default) inserts no cycle delays (runs at highest throughput
rate) and 7 adds 875 ns of delay to the T358 read and write cycles. This
parameter is optional.

        Allowable values for m
        0       Auto-port detect (default).
        2       Force unidirectional.
        4       Force non-EPP; auto detect unidirectional or bidirectional.
        6       Force non-EPP and force unidirectional.
        8       Force EPP.

Parameters Syntax       T130             T160             T358

PORT     PORT=xxx      350, 340        250, 240, 230   3BC, 378, 278
                       250, 240        360, 350, 340
                                       330, 260

INT      INT=y         3, 5, 7         3, 5, 7,        5, 7 10, 12, 14,15

RESET    RESET        no options

MODE     MODE=mn        na                na            m=0,2,4,6,8
                                                      n=0,1,2,3,4,5,6,7


Loading the NLM

The module must be loaded for each host adapter in the system. For
example, if you have three host adapters, you need to load the module
three times. If installing more than one host adapter, each host adapter
should have its own SCSI bus. For example, no two T130s should be
connected to the same SCSI cable.

Note that only one image of the module (MA13B.NLM, MA160.NLM, or
MA358.NLM) remains in memory. Consult the NetWare Installation Manual
for information on installing other NLMs. If an error message appears
when attempting to load the driver, consult the end of this section for
a description of the error messages.

When you load the driver, you need to tell it which host adapter you are
loading the driver for, i.e. LOAD MA13B. If you do not specify
parameters, you are prompted for those that are mandatory. To avoid
NetWare software prompting, type the parameters after the NLM name.

NetWare software determines if loading the driver causes any conflicts
(i.e., port or interrupt channel already in use). If there is a
possibility of a conflict, the driver does not load. 

At the NetWare 386 software prompt (:), use the LOAD command to install
the driver. The correct syntax to load the driver for the T130B is:

	LOAD [PATH]MA13B [PARAMETERS]

For the T160:

	LOAD [PATH]MA160 [PARAMETERS]

For the T358:

	LOAD [PATH]MA358 [PARAMETERS]

For a T130, assuming the SCSIworks! diskette is in drive A and you
have a tape backup and CD-ROM drive connected to the T130, the screen
looks similar to below (the software prompts you for mandatory
parameters when not selected):

:load a:\nlm\ma13b  [Enter] Loading module MA13B.NLM
	
------------------------------------------------------------
Trantor ASPI Manager for NetWare, version 1.01 Copyright (C) 1993,
Trantor Systems Limited. All rights reserved.

--- For The T130B SCSI Host Adapter ---

Supported I/O port values are 350, 340, 250, 240 I/O port: 350  [Enter]
Supported interrupt number values are 3, 5, 7 Interrupt number: 3
[Enter]

SCSI Host Adapter detected at address 350h.

Device 0, Sequential Access Device (Removable Media) Device 1, Read-Only
Optical Device (Removable media)
------------------------------------------------------------


Note that the port and IRQ values which would cause a conflict with
another device do NOT display.


:load a:\nlm\ma13b port=350 int=3 reset [Enter] Loading module MA13B.NLM

------------------------------------------------------------
Trantor ASPI Manager for NetWare, version 1.01 Copyright (C) 1993,
Trantor Systems Limited. All rights reserved.

--- For The T130B SCSI Host Adapter ---

SCSI Host Adapter detected at address 350h.

Device 0, Sequential Access Device (Removable Media) Device 1, Read-Only
Optical Device (Removable media)
-----------------------------------------------------------


Loading the NLM When Server Boots

To automatically load the NLM when the server boots, you need to add a
line to the STARTUP.NCF file. This file is created or modified from the
NetWare INSTALL.NLM program. Load INSTALL.NLM and select System Options.
Next, select from the Available System Options. 

Then, select from the STARTUP.NCF. Add a line in the STARTUP.NCF similar
to the one below:

	LOAD MA13B PORT 350 INT=3 RESET

In order for startup to properly execute, the module ASPITRAN.DSK must
be in the same [path] as the module or in the SYSTEM subdirectory of the
SYS: Volume.

Unloading the NLM

To unload the NLM, at the prompt enter UNLOAD MA13B (or other module).



Warning Messages

The following is a list of warning messages and the recommended
solutions.

Warning: No devices respond on this SCSI host adapter The device is not
connected to the SCSI host adapter, it is not turned on, or not
terminated correctly.

Warning: Invalid option 'X' included in command line

The first letter of the option is displayed here. You entered an invalid
parameter which has been ignored. You may have to unload and re-load the
module, entering the correct parameter.

Error Messages

The following is a list of error messages and the recommended solutions.
Note that when an error occurs, the software displays the error and then
displays these two lines:

Module initialization failed. Module XXXXX.NLM NOT loaded.

ERROR:  Host adapter not found at XXX.

The software cannot find the host adapter at the port address. Be sure
you have specified the correct port selection.

Device X: Unable to read device status.

The device is failing for some unknown reason. Check the device for
proper termination.

ERROR: Unable to allocate INTERRUPT resource. or ERROR: Unable to
allocate IOREGISTRATION resource. or ERROR: Unable to allocate AES
resource.

Server would not allow the NLM to allocate resources for operation;
possibly too many NLMs were being loaded at the same time.  Consult the
NetWare User Manual.

ERROR:  NLM Hardware Registration failed.

Novell would not allow NLM to register hardware selections with server.
Consult the NetWare User Manual.

ERROR:  SetHardwareInterrupt() failure.  Retcode = x. 	

Novell would not allow NLM to register interrupt with server. Consult
the NetWare User Manual.

ERROR:  Unable to register with ASPITRAN module. 	

Error in the ASPITRAN module.  Either the module did not load or it was
not in the correct path for automatic load.

