
Subject: Symbios Logic SDMS (TM) V3.0 NetWare Drivers

Last update of this document: 08/21/95
                      
Files Included In This Release
-----------------------------
    NETASPI3.NLM     Symbios Logic ASPI Driver for NetWare 3.12.
    NETASPI4.NLM     Symbios Logic ASPI Driver for NetWare 4.xx.
    NETWARE.TXT      Electronic version of SDMS User's Guide.
                     Includes specific information pertaining to
                     this set of drivers.
    PMMAKE.NLM       Power Management Schedule Creation Utility.
    PMSCHED.NLM      Power Management Schedule Utility.
    README.TXT       This file.
    SDMSNET3.DDI     DDI file for NetWare 4.xx installation.
                     (for information only).
    SDMSNET4.DDI     DDI file for NetWare 4.xx installation.
    SDMSNET3.DSK     Symbios Logic SDMS DDFS Driver for NetWare 3.12.
    SDMSNET4.DSK     Symbios Logic SDMS DDFS Driver for NetWare 4.xx.

Symbios Logic SDMS Driver Versions
----------------------------------

 Please note that since the last release of SDMS drivers, the names of 
 the drivers have changed as follows:
       NCRSDMS3.DSK --> SDMSNET3.DSK
       NCRSDMS4.DSK --> SDMSNET4.DSK
       ASPICAM3.NLM --> ASPICAM3.NLM
       ASPICAM4.NLM --> ASPICAM4.NLM

 GCA (General Customer Availability) Information:

    Current -GCA- NetWare Driver Versions 
      Product Label:  SDMSNET-3.06.00
        NetWare Device Drivers             (7/29/95, NWv3.06):
          File Name:  SDMSNET3.DSK         (for NetWare Version 3.12)
          File Name:  SDMSNET4.DSK         (for NetWare Version 4.xx)

        NetWare Power Management Utilities (8/23/95, NWv1.00)
          File Name:  PMSCHED.NLM          (Scheduling Utility)
          File Name:  PMMAKE.NLM           (Schedule Compilation Utility)

    Current -GCA- NetWare ASPI Support NLM (7/31/95, NWv3.04):
      Product Label:  NETASPI-3.04.00
          File Name:  NETASPI3.NLM         (ASPI support for NW 3.12)
          File Name:  NETASPI4.NLM         (ASPI support for NW 4.xx)


    The specific version of the driver you are using can be obtained 
    by executing the:
        MODULES
    command at the NetWare server console.

    The above is applicable only for NetWare DDFS drivers version 
    3.05.00 or later and NetWare SDMS ASPI drivers versions 3.04.00
    and later.  In prior versions of the SDMS drivers, you need to 
    note the driver version which is displayed on the NetWare
    system console at the time the SDMS NetWare driver loads.

NetWare 3.11
------------
    The SDMSNET3.DSK driver should be compatible with the NetWare 
    3.11 operating system.  However, this driver has not been tested 
    with NetWare 3.11 nor is it supported in NetWare 3.11 environments. 

NetWare Tuning Guide
--------------------
    A NetWare tuning guide, tuneguid.txt, was distributed with the 
    NetWare SDMS 3.05.00 GCA version.  This document is no longer
    being distributed with the NetWare drivers.  Instead, the 
    information contained in the tuning guide has been incorporated 
    in the Symbios Logic SDMS User's Guide. An electronic version 
    of the SDMS User's guide, netware.txt, is included in this 
    GCA distribution.

SDMSNET Driver Error Logging
----------------------------
    As of SDMS NetWare driver versions 3.05.00, error logging has
    been added to the driver.  If, for any reason, a device I/O
    cannot be completed successfully (or experiences unusual
    problems), a message will appear both on the NetWare system
    console display and in the SYS:SYSTEM/SYS$LOG.ERR file.

    When contacting support, you may want to check for the
    existence and content of this file.

    There are several ways of accessing this SYS$LOG.ERR file.  

    1.) The simplest way to view this file is to simply log into 
        your Novell NetWare server from a client.  Map and
        change to the SYS:SYSTEM directory, then use your
        favorite text editor or utility to view the contents of
        the SYS$LOG.ERR file.
    
    2.) Login to the NetWare server from a client and use the 
        NetWare administrator's tools available under NetWare: 
            SYSCON for 3.1x,
            NETADMIN for 4.x under DOS,
            NWADMIN for 4.x under MS Windows
        select the "View File Server Error Log" option.   
        (This option is found under "Supervisor Options" under
         3.1x or "Manage Objects", followed by selecting the
         server name under 4.x) 
        Use PgUp/PgDn to examine the file, ESC to exit.
        An option will be given on exit to "Clear Error Log".
        The default is NO.  Select YES only if you want to
        wipe out all current information in the log file.

    3.) The following method is available, therefore could be used,
        however WE STRONGLY RECOMMEND THAT YOU *NOT* USE IT!
        From the NetWare console:
            LOAD EDIT SYS:SYSTEM\SYS$LOG.ERR
        or
            LOAD EDIT
        and specify (as the file to be edited):
                SYS:SYSTEM\SYS$LOG.ERR
        If the error log file is small, you can use PgUp/PgDn to
        view the messages.  This method is NOT recommended because
        (apparently) the NetWare EDIT utility has a small buffer
        and NetWare (at least in NetWare 3.1x) truncates the file
        WITHOUT WARNING.  The result is that the most recently
        logged error messages will NOT be visible.  Worse yet, when
        you attempt to exit the EDIT utility, NetWare thinks YOU
        changed the file (even though NetWare did) and the default
        option will be to SAVE the truncated file, in which case
        the most recently logged errors will be lost.

SDMSNETx Driver Command Line Options
------------------------------------
    The following information is available by loading either the
    SDMSNET3.DSK (for NetWare 3.12) or SDMSNET4.DSK (for NetWare 4.xx)
    driver, as appropriate, with the "-h" (or "/h") option:
        load sdmsnet_ -h
    in which case the driver will NOT load but will display the
    following information:
----
Symbios Logic SDMS (TM) V3.0 DDFS SCSI Driver for NetWare X.XX
Copyright 1995 Symbios Logic Inc.  All rights reserved.
SDMSNET-3.06.00
 Driver - Usage/Help   Valid cmd line options and valid ranges:
  -v      Instruct driver to verbosely display all driver option values.
  qtags=disable/enable       Disable/[enable] SCSI tagged cmd queueing.
  qdepth=0-128               Set number of qtags; default=[10].
       NOTE: Setting qdepth=0 DISABLES tagged command queueing.
  qtag_type=simple|ordered   Set type of qtag; default=[simple].
  wide=disable|enable        Disable|[enable] wide SCSI support.
  sort=disable|enable        Disable|[enable] IO sorting.
  share_int=disable|enable   Enable|[disable] shared interrupts.
  max_hbas=1-8               Set maximum host adapters; default=[8].
  max_id=8-32                Set max SCSI IDs per adapter; default=[32].
  max_lun=1-8                Set max LUNs per SCSI ID; default=[4].
  timeout=30-999999999       Set IO timeout in seconds; default=[30].
  max_retry=0-50             Set max # of times to retry IO; default=[5].
  max_kb=0-32767             Set max IO concat size in Kbytes; default=[32676].
  Log_ScsiErrors=off|console|syslog|[both]
                             Controls logging of serious SCSI errors.
  xcl=B[,I[,L]][:B[,I[,L]][...]  Exclude Bus,ID,LUN devices.
----


=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

Release Version Notes
---------------------

    The following enhancements have been made to the Symbios Logic
    SDMS DDFS NetWare drivers since the release of version 3.05.00.

      - Support for NetWare 4.10 SFT-III
  
      - Removable Media Device Support, including:
           + Magneto Optical Devices
           + Bernoulli Disks
           + CD-ROM Devices (previously supported)

      - Support for large capacity devices (greater than 4 GB)

      - Improved error handling, including:
           + Retries added for failed IOs
           + Displaying of Additional Sense Codes and Qualifiers 
             in response to a check condition
           + Improved ASPI-CAM error translation when using the
             NETASPI interface
    
      - Command line option so that the user may specify where 
        SCSI errors should be logged, if anywhere

      - Support of ordered queue tags

      - Improved multi-LUN support, including support of 
           + Non-contiguous LUNs
           + Systems which do not have a configured LUN 0

      - Improved real mode (DOS Access) support

      - Support for MINICAM.SYS DOS driver

      - Support for Target Initiated Wide and Sync Negotiations

      - Support for PCI Bridge Systems

      - Fast 20 Support

      - Autodection of Symbios Logic BIOS and DOS 3.XX CAM Drivers

      - Power Management Support

    In addition, initial support for the Symbios Logic 4.XX Boot ROM,
    in default configuration only (No NVRAM or DOS driver support)  
    has been incorporated in the driver.  Limited testing of 4.XX 
    Boot ROM support has been performed with pre-released versions 
    of the 4.XX Boot ROM.  Since the Boot ROM is still in 
    development, a released version was not available at the time of 
    testing and release of the SDMSNETx.DSK drivers, and as such, 
    compatability with the released version cannot be assured. 
    
    The following known issues in the NetWare 3.05.00 disk drivers 
    have been addressed and/or corrected in this release of the 
    drivers:
    
      - Fix for potential Wide data corruption problem.
    
      - Fix for potential DOS access hang when a DOS partition exists 
        on a wide device and DOSCAM.SYS was not loaded.
    
      - Fix to prevent double scan of a SYM53C815 based controller
        when an SYM53C825 based controller is present.  Resulted
        in devices on the SYM53C815 based controller being detected
        and registered twice.
        
      - No longer wait for the server to be in a quiescent state 
        before allowing the server to be downed.  
    
      - Support for devices with capacity greater than 4 GB.
     
      - Explicit checks on IOs entering via external entry points to
        ensure they cannot cause problems to occur in the driver, 
        e.g. issueing non-disconnecting I/Os when disconnecting IOs 
    	are pending on the device.
    
      - Fix for "Board Count = 1" message bing printed twice followed
        by driver hang while scanning a non-existent path.
    
      - Work around for non SCSI-2 compliant devices which issue a 
        check condition to a Request Sense on an inquiry to a non
        supported LUN.
    
      - Fix to scan for all LUNs on a device.  Previously, the  
        LUN scan was halted as soon as an unconfigured LUN was 
        encountered.
    
      - Fix to not register unconfigured LUNs with the NetWare OS.
    
      - Fix to prevent NETASPI from returning a CAM status to an
        ASPI request.
    
      - Fix to prevent the driver from returning a Selection Timeout
        to an IO to an unconfigured/unsupported LUN of a device which
        is present and has a configured LUN.
    
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
{end of nwreadme.txt}
