SYM8XX.ADD

From EDM2
Jump to: navigation, search
Product Support
OS/2 1.3
OS/2 2.0 S
OS/2 2.1 S
OS/2 2.11 SMP S
OS/2 Warp 3 S
OS/2 Warp Connect S
OS/2 Warp 4 S
OS/2 Warp Server for e-Business S

LSI Logic/Symbios Logic/NCR SCSI Host bus adapter cards driver. 

BASEDEV=SYM8XX.ADD <parameters>

Supported Symbios Logic host adapters:

  • SYM53C810, SYM53C810A, SYM53C810AE (SYM8100S, SYM8100ASP, SYM20810)
  • SYM53C815 (SYM815XS, SYM8150SP)
  • SYM53C825, 53C825A (SYM8250S, SYM8251S, SYM8251D, SYM8250ASP,
  • SYM8251ASP,SYM8251AD)
  • SYM53C860, SYM53C860AE (SYM8600SP, SYM20860)
  • SYM53C875, SYM53C875E (SYM8750SP, SYM8751SP, SYM8751D)
  • SYM53C876 (SYM22801, SYM22802)
  • SYM53C885
  • SYM53C895 (SYM8951U, SYM8952U)
  • SYM53C895A (SYM8953U)
NOTE
If the drive does not support synchronous or tagged command queing. Use /!SN or /!Q on the driver. e.g. BASEDEV=SYMC8XX.ADD /V /!SN /!Q
This driver is also named "SYM538XX OS/2 Adapter Device Driver".

Parameters

  • /VERBOSE or /V - appears on the command line by default. It enables display of a banner, version number, and SCSI bus information during startup of the system.
  • /!DM <Option> - disables use of the IBM-supplied DASD manager (OS2DASD.DMD) for the devices listed. The DASD manager supports direct access devices such as hard drives.
Usage: /!DM[,]*
For example, to disable OS2DASD.DMD for devices on host adapter 0 at target IDs 3 and 5, the line in the CONFIG.SYS file that loads SYM8XX.ADD should look like this: BASEDEV=SYM8XX.ADD /!DM<0:3>,<0:5>
  • /!SM - disables use of the IBM-supplied SCSI manager (OS2SCSI.DMD) for the devices listed. The SCSI manager supports SCSI tape drives.
Usage: /!SM[,]*
For example, to disable OS2SCSI.DMD for devices on host adapter 0 at target IDs 3 and 5, the line in the CONFIG.SYS file that loads SYM8XX.ADD should look like this: BASEDEV=SYM8XX.ADD /!SM<0:3>,<0:5>
  • /EXCLUDE or /X - disables a host adapter so that it is not seen by the SDMS OS/2 device drivers. This allows a host adapter to be ignored without physically removing the board from the system. This may be necessary if the adapter in question is causing a resource conflict.
Note: If you exclude the adapter to which the boot device is attached, then you will not be able to boot.
Usage: /EXCLUDE[,]*
Where:
chip is a unique identifier that indicates the LSI Logic board type. The Verbose option displays a table with this value appearing in the "CHIP" column.
bus represents the PCI bus number into which the adapter is plugged. The Verbose option displays a table with this value appearing in the "BUS" column.
dev/func is the number derived by combining the PCI device and function numbers and serves as a unique board identifier in conjunction with the PCI bus. The Verbose option displays a table with this hexadecimal value appearing in the "DEV/FUNC" column. It may contain an A, B, C, D, E, or F as part of its value.
For example, to exclude a host adapter with chip type F, PCI bus number 0 and dev/func number A0, the line in the CONFIG.SYS file that loads SYM8XX.ADD should look like this: BASEDEV=SYM8XX.ADD /EXCLUDE or BASEDEV=SYM8XX.ADD /X
  • /SYNCH_RATE or /SR - sets the maximum synchronous transfer rate (in Mbyte transfers per second) to negotiate with a particular device. The allowable values for this setting are 0, 5, 10, 20, and 40 Mbyte transfers per second, if the adapter is capable of the specified speed. All host adapters in the LSI Logic family support at least 10 Mbyte transfers per second; some support 20 or 40 Mbyte transfers per second. To turn off synchronous transfers for a particular device, specify 0 (zero). The value set by this option only defines the maximum transfer rate negotiated. The actual rate also depends on the device's capability. The default value is the fastest transfer rate that is supported by a particular host adapter.
Note: The maximum synchronous transfer rates effectively double when the adapter and device permit wide transfers (See the /WIDTH option). For example, a synchronous transfer rate setting of 40 Mbyte transfers per second will actually produce a transfer rate of 80 Mbyte transfers per second if the adapter and device both allow and are set to perform wide transfers.
Usage: /SYNCH_RATE=n[,n]*
Where: n = 0, 5, 10, 20, or 40.
Two examples illustrate how to use this option:
  1. To turn off synchronous transfers to ID 3 on host adapter 0, the line in the CONFIG.SYS file that loads SYM8XX.ADD should look like this: BASEDEV=SYM8XX.ADD /SYNCH_RATE=0<0:3>
  2. To set synchronous transfers to 10 Mbyte transfers per second on all devices on host adapter 1, the line in the CONFIG.SYS file that loads SYM8XX.ADD should look like this: BASEDEV=SYM8XX.ADD /SR=10<1>
  • /SYNCH_OFFSET or /SO - sets the maximum synchronous offset to negotiate with a particular device. The allowable values for this setting are 0 to the maximum synchronous offset supported by the specified adapter. The LSI Logic controller chips support offsets up to 31. Refer to your host adapter user's guide for information on the maximum offset supported by your host adapter. If 0 (zero) is specified for the synchronous offset value, synchronous transfers are turned

off for any specified device. The value set by this option only defines the maximum offset that is negotiated. The resulting rate also depends on the device's capability. The default value is the maximum offset that is supported by a particular host adapter. 

Usage: /SYNCH_OFFSET=n[,n]*

Where: n = 0 up to maximum synchronous offset for the adapter.

For example, to change the synchronous offset to 6 for ID 3 on host adapter 0, the line in the CONFIG.SYS file that loads SYM8XX.ADD should look like this: 

BASEDEV=SYM8XX.ADD /SYNCH_OFFSET=6<0:3>

or 

BASEDEV=SYM8XX.ADD /SO=6<0:3>
  • /TIMEOUT or /T

The SDMS device drivers use a timeout mechanism to detect certain errors. When the driver issues a command to a SCSI device, a timer is started. If the timer expires before the command completes, the driver assumes that something is wrong with the device, and takes steps to recover. The default value for this is 10 seconds. If you set the value to be less than the system has allocated for a particular device, your value will be ignored. To turn off the timeout mechanism for a particular device, set the value to 0 (zero). 

Usage: /TIMEOUT=n[,n]*

Where: n = timeout value in seconds for device (0-65535).

For example, if you have a particularly slow device at ID 3 on host adapter 0 and you wish to extend the timeout on this device to 60 seconds, then the line in the CONFIG.SYS file that loads SYM8XX.ADD should look like this: 

BASEDEV=SYM8XX.ADD /TIMEOUT=60<0:3>

or 

BASEDEV=SYM8XX.ADD /T=60<0:3>
  • /DISCONNECT or /DC

SCSI devices have the ability to disconnect from the bus during an I/O transfer. This option allows (or does not allow) a device to disconnect during an I/O transfer. If a particular adapter has parity checking disabled, then you must use this option to disable disconnects for all devices on that adapter that do not generate parity. Refer to the /PARITY option for more information. 

Usage: /DISCONNECT=n[,n]*

Where: n = ON is the default value for all devices, which allows disconnects. OFF does not allow disconnects.

For example, to disable disconnects on the device at ID 2 on host adapter 0, then the line in the CONFIG.SYS file that loads SYM8XX.ADD should look like this: 

BASEDEV=SYM8XX.ADD /DISCONNECT=OFF<0:2>

or 

BASEDEV=SYM8XX.ADD /DC=OFF<0:2>
  • /PARITY or /P

The LSI Logic chips are capable of enabling or disabling the SCSI bus data integrity checking feature known as parity. Some non-compliant SCSI devices sold as SCSI devices do not generate parity. You can use this option to disable parity checking. The LSI Logic chips always generate parity (for outputs), but may optionally check the parity (for inputs).

Note: When disabling parity checking, you must disable disconnects for any device that does not generate parity, as the LSI Logic chips cannot disable parity checking for that device during the reselection phase. If a device does not generate parity and it disconnects, the I/O never completes as the reselection never completes. Refer to using the /DISCONNECT option for more information about disabling disconnects for a device. 

Usage: /PARITY=n[,n]*

Where: n = ON is the default value for all devices, which enables parity checking. OFF disables parity checking.

For example, to turn off parity checking on host adapter 0, the line in the CONFIG.SYS file that loads SYM8XX.ADD should look like this: 

BASEDEV=SYM8XX.ADD /PARITY=OFF<0>

or 

BASEDEV=SYM8XX.ADD /P=OFF<0>
  • /QTAG or /QT

Queue tagging allows more than one outstanding command per SCSI device. Some non-compliant SCSI devices sold as SCSI devices do not allow queue tags, in which case queue tagging needs to be disabled. The value given in the command line will be the depth of the queue for queue tags for the device(s) indicated. To disable queue tag support, a value of 0 or 1 should be given. 

Usage: /QTAG=n[,n]*

Where: n = the number of queue tags allowed for a device (0-256).

Two examples illustrate how to use this option:

  1. To turn off queue tagging for ID 3 on host adapter 0, the line in the CONFIG.SYS file that loads SYM8XX.ADD should look like this: 
BASEDEV=SYM8XX.ADD /QTAG=0<0:3>
  1. To set the queue depth to 5 for all devices on host adapter 2, the line in the CONFIG.SYS file that loads SYM8XX.ADD should look like this: 
BASEDEV=SYM8XX.ADD /QT=5<2>
  • /WIDTH or /W

Devices attached to a SCSI bus are narrow or wide devices. Narrow devices transfer data one byte (or 8 bits) at a time. Wide devices transfer two bytes (or 16 bits) at a time. The value given in the command line option will determine the size of data transfers. 

Usage: /WIDTH=n[,n]*

Where: n = 8 or 16.

Two examples illustrate how to use this option:

  1. To have the device at ID 3 on host adapter 0 treated as a narrow device, the line in the CONFIG.SYS file that loads SYM8XX.ADD should look like this: 
BASEDEV=SYM8XX.ADD /WIDTH=8<0:3>
  1. To have all devices on host adapter 2 treated as 8-bit devices, the line in

the CONFIG.SYS file that loads SYM8XX.ADD should look like this: 

BASEDEV=SYM8XX.ADD /W=8<2>
Retrieved from "http://www.edm2.com/index.php?title=SYM8XX.ADD&oldid=79542"