home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 4 Drivers / 04-Drivers.zip / btscsi.zip / readme.txt < prev   
Text File  |  1996-02-28  |  11KB  |  314 lines
  1.  
  2. BusLogic MultiMaster SCSI Host Adapter Driver
  3. For IBM OS/2 2.1x/Warp
  4. Version 1.48
  5.  
  6.  
  7. Introduction
  8. ============
  9.  
  10. BusLogic's MultiMaster SCSI Adapter Driver BTSCSI.ADD Ver 1.48
  11. runs under IBM OS/2 2.1, 2.11 and 3.0 (Warp).  This README file
  12. contains instructions on installing this driver on these OS/2
  13. platforms and describes the various command line switches available
  14. to tailor the device driver to your needs.
  15.  
  16. The installation procedures covered in this README file are as
  17. follows:
  18.  
  19.       I.  Installation 
  20.      II.  Upgrade 
  21.     III.  Installation with IDE as Primary
  22.      IV.  Command Line Switches
  23.       V.  Miscellaneous Notes
  24.  
  25.  
  26.  
  27. I. Installation 
  28. =============== 
  29.  
  30. The BusLogic BTSCSI.ADD driver is embedded in the OS/2 2.1x and
  31. Warp releases.  To upgrade to the new BTSCSI.ADD driver, follow
  32. the upgrade procedure described in section II.
  33.  
  34. The embedded driver, however, may have incompatibility on certain
  35. PCI motherboards and may prevent the initial installation of OS/2.
  36. The following procedure instructs you on how to replace the
  37. embedded driver with the latest driver to do your installation.
  38.  
  39. (   OS/2 2.1x Notes:  Because OS/2 2.1x does not have built-in   )
  40. (   PCI support in OS2LDR, make sure the ISA-compatible port is  )
  41. (   set for Primary or Alternate.                  )
  42.  
  43.     1.  Make a copy of the OS/2 Warp Disk 1.
  44.  
  45.     2.  Replace the BTSCSI.ADD on the new diskette with the
  46.         BusLogic file \OS2\WARP\BTSCSI.ADD from the BusLogic
  47.         driver diskette.  (The driver can be used on both OS/2
  48.     2.1x and Warp.)
  49.  
  50.     3.  When all the packages from the CD-ROM or floppies have
  51.         been extracted, you will be prompted to reboot from the
  52.         hard disk.  At this point, boot the system using the
  53.         OS/2 Warp Installation diskette, and insert Diskette 1
  54.     when prompted.
  55.  
  56.     4.  Press <F3> or <Esc> to go to the command prompt, insert
  57.         the BusLogic SW-191 Software Driver diskette, and copy
  58.         \OS2\WARP\BTSCSI.ADD from the diskette to C:\.
  59.  
  60.     5.  Remove the diskette and reboot the system.
  61.  
  62.  
  63.  
  64. II. Upgrade
  65. ============
  66.  
  67.     1.  Insert the BusLogic SW-191 Software Drivers diskette in
  68.         the floppy drive.
  69.         
  70.     2.  Double-click, in order, the OS/2 System, System Setup,
  71.         and Device Driver Install icons.
  72.         
  73.     3.  Press the Change button in the Source directory.
  74.     
  75.     4.  Select, in order, the OS2 and Warp directories.  On OS/2
  76.         2.1x, select the OS2 and 2.1x directories.
  77.     
  78.     5.  Click on the Install button.
  79.     
  80.     6.  Select the BusLogic MultiMaster driver and press OK.
  81.     
  82.         OS/2 automatically updates the CONFIG.SYS file for
  83.         the new driver.
  84.         
  85.     7.  Eject the driver diskette and reboot the system.
  86.     
  87.     
  88.         
  89. III. Installation with IDE as Primary
  90. =====================================
  91.  
  92. Installation of OS/2 driver can be performed in one of two ways,
  93. depending on whether OS/2 is being installed from diskettes or
  94. CD-ROM. 
  95.  
  96.     Floppy Installation
  97.     -------------------
  98.     
  99.     Install OS/2 using the embedded INT 13 driver.  After
  100.     installation, follow the Upgrade procedure in Section II.
  101.     
  102.     
  103.     CD-ROM Installation
  104.     -------------------
  105.     
  106.     Follow the CD-ROM Installation instruction described
  107.     in Section I.
  108.     
  109.     When OS/2 Installation presents the System Configuration
  110.     window, perform device driver installation as described
  111.     in the Upgrade instruction in Section II above.
  112.     
  113.     Reboot the system using <Ctrl-Alt-Del> without closing
  114.     the System Configuration window.  Upon boot up, you will
  115.     be prompted with the same window with the BusLogic
  116.     MultiMaster driver in the SCSI Adapter Support list box.
  117.     Proceed with the installation.
  118.         
  119.  
  120.  
  121. IV. Command Line Switches
  122. =========================
  123.  
  124. BusLogic's MultiMaster OS/2 Adapter Device Driver supports the
  125. following command line switches:
  126.  
  127. (   Note that the /WD option is no longer necessary for wide     )
  128. (   adapters and the /AT option has been renamed to /TO.     )
  129.  
  130.     I. Global Switches
  131.     ------------------
  132.  
  133.     /V        Verbose switch. This switch enables driver verbosity at 
  134.         initialization time.
  135.  
  136.     /QU     Warning-error suppression switch. When invoked, the driver
  137.             will not complain about references to non-existent targets/
  138.         luns specified on the BusLogic ADD driver command line.
  139.         
  140.     /O        Early Opti chipset work-around switch.  This switch
  141.             provides a work-around for an early version of the Opti
  142.         PCI chipset which can generate spurious interrupts.  Do
  143.         not use this option unless your system hangs at boot-time
  144.         and you are using an Opti chipset.
  145.  
  146.     II. Per-Host Adapter Switches
  147.     -----------------------------
  148.  
  149.     /A:x    Adapter identification switch. x is between 0 and 5 and
  150.         identifies the adapter being referenced. This switch is
  151.         followed by one or more of the switches below.
  152.  
  153.     /<!>DM:xx 
  154.         DASD Manager Support switch. As defined by IBM, this switch
  155.         enables/disables support for this unit by the IBM-supplied
  156.         DASD Manager (OS2DASD.DMD).
  157.  
  158.     /<!>SM:xx 
  159.         SCSI Manager Support switch. As defined by IBM, this switch
  160.         enables/disables support for this unit by the IBM-supplied
  161.         SCSI Manager (OS2SCSI.DMD).
  162.  
  163.     /BON:xx & /BOFF:xx
  164.         Bus On / Bus Off switches. x is between 2 and 15 and
  165.         specifies the desired bus on/bus off time in microseconds.
  166.  
  167.     /TQ        Enable tagged queuing support on ALL targets on the
  168.         specified host adapter (specified by the receding /A:
  169.         switch) that supports tagged queuing. If this switch is
  170.         
  171.             Tagged queuing is an advanced SCSI-II feature that allows
  172.             overlapped commands to a SCSI device, this results in
  173.         enhanced performance. While BusLogic provides support for
  174.         this important SCSI-II feature, not all SCSI devices support
  175.         tagged queuing. The SCSI device must support tagged
  176.         queuing to take advantage of this feature.
  177.  
  178.             BusLogic's OS/2 SCSI Adapter Driver defaults to tagged
  179.         queuing DISABLED on all devices. For devices that support
  180.         tagged queuing, the following command line switches are
  181.         provided to manage tagged queuing support on a finer
  182.         device-specific level.
  183.  
  184.     /TQ:x,y,z,...
  185.         Enable tagged queuing support on a specified list of 
  186.         SCSI targets. x,y,and z is a list of embedded SCSI targets
  187.         separated by commas.  The Logical Unit Number (LUN) is
  188.         presumed to be 0.
  189.  
  190.     /TQ:(a,b), (c,d), ...
  191.         Enable tagged queuing support on a specified list of
  192.         pairs of SCSI targets/LUNs in parenthesies. Each
  193.         parenthesied pair is separated by commas.
  194.  
  195.         Examples:
  196.  
  197.         1)  BASEDEV=BTSCSI.ADD /A:0 /TQ
  198.     
  199.             This example enables tagged queuing on host
  200.             adapter 0 on all targets that support it. Targets
  201.             attached to host adapter 0 that do not support
  202.             tagged queuing are not affected.
  203.  
  204.         2)  BASEDEV=BTSCSI.ADD /A:0 /TQ /A:1 /TQ
  205.     
  206.             This example enables tagged queuing on all
  207.             targets on host adapters 0 and 1 that support it.
  208.             Targets attached to host adapters 0 and 1 that do
  209.             not support tagged queuing are not affected.
  210.  
  211.         3)  BASEDEV=BTSCSI.ADD /A:0 /TQ:0,2,3 /A:2 /TQ:0,1
  212.     
  213.             This example enables tagged queuing on targets
  214.             0, 2, and 3 on host adapter 0 and on targets 0 and
  215.             1 on host adapter 2.  If any of the specified
  216.             targets are not attached or do not support tagged
  217.             queuing, specification of those particular devices
  218.             is ignored.
  219.  
  220.         4)  BASEDEV=BTSCSI.ADD /A:0 /TQ:(0,0),(2,1)
  221.     
  222.             This example enables tagged queuing on target 0
  223.             LUN 0 and target 2 LUN 1 on host adapter 0. If
  224.             any of the specified target/LUN combinations are
  225.             not attached or do not support tagged queuing,
  226.             specification of those particular devices is
  227.             ignored.
  228.  
  229.     /LUNS:xx
  230.         This switch specifies the maximum number of Logical Units
  231.         (LUNs) the host adapter will support (try to detect). If
  232.         the switch is not specified, the default is 8. Valid range
  233.         is from 1 to 64. If the host adapter only has embedded
  234.         SCSI targets attached (that is, all attached devices are
  235.         at LUN 0), it is recommended to set this option value to
  236.         1 to turn off LUN support for LUNS other than 0.  
  237.     
  238.         Examples:
  239.  
  240.         1)  BASEDEV=BTSCSI.ADD /A:0 /LUNS:1   
  241.  
  242.             This example effectively disables lun support on
  243.             host adapter #0.
  244.  
  245.         2)  BASEDEV=BTSCSI.ADD /A:0 /LUNS:4 
  246.  
  247.             This example scans up to 4 LUNS on host adapter #0.
  248.  
  249.     /TO:xx
  250.         Command Timeout switch. This per-host adapter switch
  251.         specifies a timeout on each I/O request in seconds.
  252.         It takes a decimal digit input between 1 and 99. The driver
  253.         default is 15 seconds in this absence of this switch.
  254.         Setting the timeout value to 0 turns off the timeout
  255.         mechanism.
  256.         
  257.         Note:  This switch has no effect on tape requests.
  258.  
  259.         Example: 
  260.         
  261.         BASEDEV=BTSCSI.ADD /A:0 /TO:10
  262.  
  263.             This example causes the driver to wait 10 seconds
  264.         before timing out on an outstanding request.
  265.  
  266.     /MR:xx
  267.         Maximum Request switch.  This per-host adapter switch
  268.         specifies the maximum number of requests that can be
  269.         pending on the host adapter.  Valid range is 1 - 64.
  270.         Default is 32.
  271.         
  272.     /MA:xx
  273.             Maximum Active switch.  This per-host adapter switch
  274.         specifies the maximum number of active requests that
  275.         can be outstanding on each device on the host adapter.
  276.         Valid range is 1 - <Max Requests>.  Default is 8.  This
  277.         value can be adjusted to increase performance.
  278.         
  279.         
  280.         
  281. V. Miscellaneous Notes
  282. ======================
  283.  
  284.     1.  To use a third-party ASPI driver (such as Corel SCSI) on a
  285.         particular SCSI ID, you must disable the OS/2 DASD and SCSI
  286.     managers as follows in the BASEDEV line in CONFIG.SYS:
  287.     
  288.         BASEDEV=BTSCSI.ADD /!DM:3 /!SM:3
  289.     
  290.     The example disables the DASD and SCSI managers on SCSI ID 3.
  291.     
  292.     2.  On Intel and certain motherboards that scan PCI cards from
  293.         high to low PCI bus and device number, you must disable the
  294.     "Use Bus and Device # for PCI Scanning Seq." option in the
  295.     AutoSCSI Advanced Option if you are using multiple BusLogic
  296.     948, 958, or 958D Host Adapters.  To get to the Advanced
  297.     Option, Select the View/Modify Adapter Configuration menu
  298.     option and press <Ctrl-F10>.
  299.             
  300.        
  301.     
  302.     
  303.     
  304.     
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312. ---
  313. Version: $Id: readme.txt 1.5 1996/02/29 04:02:42 awin Exp $
  314.