home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 4 Drivers / 04-Drivers.zip / os2cam.zip / os2.txt next >
Text File  |  1995-02-03  |  15KB  |  479 lines
  1. **********************************************************
  2.             OS2.TXT
  3. **********************************************************
  4.  
  5.  
  6.  
  7.    INSTALLATION GUIDE FOR THE SDMS OS/2 DRIVER V3.03.00
  8.  
  9.  
  10.  
  11. This file describes the features and use of the NCR SDMS 
  12. device driver for the OS/2 operating system environment.
  13. It is divided into the following sections:
  14.  
  15. Introduction
  16.     Features of the SDMS OS/2 Driver
  17.     Description of the SDMS OS/2 Driver
  18. Installing Your SDMS OS/2 Driver
  19.     Command Line Options
  20.     Troubleshooting
  21.  
  22.  
  23.  
  24.  
  25. ******************** Introduction ***********************
  26.  
  27.  
  28. The OS/2 operating systems version 2.X and later provide 
  29. an integrated platform featuring a graphical windowing 
  30. interface, called Presentation Manager, that allows 
  31. multiple applications to be viewed at the same time. 
  32. Multitasking is also supported, enabling several different 
  33. programs to run at the same time in different windows. 
  34. Presentation Manager allows the user to switch between 
  35. programs, start other programs, and maintain files and 
  36. directories. These versions of OS/2 require an 80386 or 
  37. higher microprocessor. Other hardware requirements include 
  38. a minimum of 4 megabytes of RAM (8 megabytes or more is 
  39. recommended) and a minimum hard disk drive size of 40 
  40. megabytes. NCR SDMS provides the necessary SCSI device 
  41. driver for OS/2. We recommend reviewing the OS/2 manual 
  42. prior to proceeding.
  43.  
  44.  
  45. * Features of the SDMS OS/2 Driver *
  46.  
  47. Enhances host bus adapter performance
  48. Supports synchronous negotiation (including fast SCSI)
  49. Supports Wide SCSI (single-ended and differential)
  50. Supports multiple host adapters
  51. Supports Disconnect/Reselect
  52. Supports scatter/gather
  53. Allows tagged command queuing
  54.  
  55.  
  56. * Description of the SDMS OS/2 Driver *
  57.  
  58. Although the NCR SCSI controller's firmware can access 
  59. the SCSI hard disk drives attached to the computer 
  60. independently, the SCSI device driver OS2CAM.ADD acts 
  61. as an enhanced interface between the computer system and 
  62. the SCSI BIOS firmware. Use of the device driver 
  63. increases the abilities of the SCSI controller firmware 
  64. and fully utilizes the advancements and improvements of 
  65. 80386 and higher microprocessors. 
  66.  
  67. The device driver is also necessary to support the use of 
  68. SCSI tape drives and CD-ROM drives with an OS/2 system. 
  69. The NCR OS2CAM.ADD device driver is written in compliance 
  70. with the IBM OS/2 ADD (Adapter Device Driver) 
  71. specification, and will work with third party applications 
  72. that comply with the same specification.
  73.  
  74.  
  75.  
  76.  
  77. *********** Installing Your SDMS OS/2 Driver ************
  78.  
  79.  
  80.  
  81. These installation instructions are specific and accurate 
  82. for the SDMS OS/2 driver OS2CAM.ADD V3.03.00. You may have 
  83. a more recent version of this driver. You should refer to 
  84. the text file OS2.TXT located on the SDMS diskette for a 
  85. version of these instructions guaranteed to match your 
  86. driver.
  87.  
  88.  
  89. * Installing OS2CAM.ADD (with OS/2 already installed) *
  90.  
  91. The NCR device driver floppy diskette contains two files, 
  92. the device driver OS2CAM.ADD and a text file, OS2CAM.DDP. 
  93. When the device driver installation utility under OS/2 is 
  94. activated, it looks for a file with the DDP extension. The 
  95. DDP file contains the necessary information to install the 
  96. SCSI device driver.
  97.  
  98. 1) At the OS/2 Desktop, open the System Setup folder, and 
  99.    double-click on the Device Driver Install icon.
  100.  
  101. 2) Insert the floppy disk containing the NCR device driver 
  102.    in the source drive.
  103.  
  104. 3) If installing a 2.X version of OS/2, go to step six.
  105.  
  106. 4) If installing a Warp version of OS/2, click on the change 
  107.    button for the destination directory. Double click on the 
  108.    OS2 directory, double click on the boot directory, and 
  109.    click on the set button.
  110.  
  111. 5) Click the install button.
  112.  
  113. 6) Choose the NCR OS2CAM.ADD driver from the list provided 
  114.    by clicking on it once. The choice will be highlighted. 
  115.    Then click the OK button, then the EXIT button.
  116.  
  117. 7) To make sure that the installation was successful, open 
  118.    the productivity folder on the OS/2 Desktop, then 
  119.    double-click the OS/2 System Editor to start the editor. 
  120.    Open the CONFIG.SYS file and find the line:
  121.  
  122.     BASEDEV=OS2CAM.ADD /V
  123.  
  124.    Then check that the file OS2CAM.ADD is in the 
  125.    appropriate directory on the boot drive.
  126.  
  127.  
  128. * Installing OS2CAM.ADD and OS/2 
  129.     (from a floppy) to a SCSI Hard Drive *
  130.  
  131. In this case, since OS/2 will be installed from a floppy 
  132. disk, it is not required that the driver be present to 
  133. install the operating system (as is the case when 
  134. installing from a CD-ROM).
  135.  
  136. 1) After the installation of OS/2 is complete and the 
  137.    WorkPlace Shell desktop is built, open the system 
  138.    setup folder and double click on the Device Driver 
  139.    Install icon.
  140.  
  141. 2) Insert the floppy disk containing the NCR device 
  142.    driver in the source drive.
  143.  
  144. 3) If installing a 2.X version of OS/2, go to step six.
  145.  
  146. 4) If installing a Warp version of OS/2, click on the 
  147.    change button for the destination directory. Double-
  148.    click on the OS2 directory, double-click on the boot 
  149.    directory, and click on the SET button.
  150.  
  151. 5) Click the install button.
  152.  
  153. 6) Choose the NCR OS2CAM.ADD driver from the list 
  154.    provided by clicking on it once. The choice will be 
  155.    highlighted. Then click the OK button, then the EXIT 
  156.    button.
  157.  
  158. 7) To make sure that the installation was successful, 
  159.    open the productivity folder on the OS/2 Desktop, then 
  160.    double-click the OS/2 System Editor to start the editor. 
  161.    Open the CONFIG.SYS file and find the line:
  162.  
  163.     BASEDEV=OS2CAM.ADD /V
  164.  
  165.    Then check that the file OS2CAM.ADD is in the 
  166.    appropriate directory on the boot drive.
  167.  
  168. 8) Continue with the OS/2 installation process as 
  169.    documented in the OS/2 Installation Guide.
  170.  
  171.  
  172.  
  173. * Installing OS2CAM.ADD and OS/2 
  174.     (from a SCSI CD-ROM) to a SCSI Hard Drive *
  175.  
  176.  
  177. To install OS/2 from a SCSI CD-ROM attached to an NCR host 
  178. adapter, the SCSI driver must be present in order to 
  179. access the CD-ROM. The following steps allow installation 
  180. of OS/2 from a SCSI CD-ROM.
  181.  
  182. 1) Make copies of the two floppy disks used for 
  183.    installation that are included with the CD-ROM version 
  184.    of OS/2. These disks are labeled "Installation Diskette" 
  185.    and "Diskette 1".
  186.  
  187. 2) Copy the file OS2CAM.ADD from the NCR distribution disk 
  188.    to the copy of "Diskette 1".
  189.  
  190. NOTE: OS/2 Warp versions of "Diskette 1" do not contain 
  191.       enough available space to copy OS2CAM.ADD. A file 
  192.       must be deleted in order to copy the driver file 
  193.       onto the diskette. If the target installation system 
  194.       DOES NOT contain a Microchannel system bus, delete 
  195.       the file named "IBM2FLPY.ADD". If the target 
  196.       installation system DOES contain a Microchannel bus, 
  197.       delete the file named "IBM1FLPY.ADD". Alternatively, 
  198.       any unused .ADD driver(s) may also be deleted.
  199.  
  200.       When any .ADD drivers are deleted from "Diskette 1", 
  201.       make certain to delete or remark out the corresponding 
  202.       BASEDEV= statement in CONFIG.SYS. Otherwise, error 
  203.       messages will show up during installation.
  204.  
  205. 3) Edit the file CONFIG.SYS on the copy of "Diskette 1" 
  206.    by adding the following line at the end of the file:
  207.  
  208.     BASEDEV=OS2CAM.ADD /v
  209.  
  210. 4) Place the copy of "Installation Diskette" in the A: drive 
  211.    and reboot the computer.
  212.  
  213. 5) Proceed with the OS/2 installation process as 
  214.    documented in the OS/2 Installation Guide.
  215.  
  216.  
  217.  
  218. * Driver Order in the CONFIG.SYS File *
  219.  
  220.  
  221. Because of the way OS/2 assigns drive letters, the order 
  222. in which drivers appear in the CONFIG.SYS file is 
  223. important. The drivers must appear in the order in which 
  224. the drive letters are to be assigned. In particular:
  225.  
  226.    - OS/2 Warp will install the BASEDEV= line at the 
  227.      beginning of the target system's CONFIG.SYS file 
  228.      regardless of where the line is located in that file 
  229.      on "Diskette 1". You may need to rearrange the order 
  230.      in which drivers appear in the CONFIG.SYS file for 
  231.      the target system.
  232.  
  233.    - If the system is to boot from a hard drive attached 
  234.      to an IDE bus, the IDE driver must appear before 
  235.      OS2CAM.ADD in CONFIG.SYS. 
  236.  
  237. Refer to the OS/2 documentation to fully understand this 
  238. requirement.
  239.  
  240.  
  241. * Command Line Options *
  242.  
  243.  
  244. The OS2CAM.ADD driver has several embedded functions 
  245. which can be accessed via switches on the command line 
  246. in the CONFIG.SYS file. These options are described 
  247. below.
  248.  
  249.  
  250. Using the /V Option
  251.  
  252. This option appears on the command line by default. 
  253. It enables display of a banner, version number, and 
  254. SCSI bus information during start up of the system. 
  255. The command line in CONFIG.SYS should look like this:
  256.  
  257.     BASEDEV=OS2CAM.ADD /V
  258.  
  259. To disable this feature, remove this switch from the 
  260. command line.
  261.  
  262.  
  263. Using the /!SN Option
  264.  
  265. This option means "no synchronous". Synchronous transfers 
  266. are typically faster than asynchronous, so this option 
  267. should only be used if synchronous transfers cause a 
  268. problem with your system. To disable synchronous 
  269. operations, the command line in CONFIG.SYS should look 
  270. like this:
  271.  
  272.     BASEDEV=OS2CAM.ADD /!SN
  273.  
  274.  
  275. Using the /!Q Option
  276.  
  277. This option means "no queue tag support". Queue tagging is 
  278. used to allow more than one outstanding command per SCSI 
  279. device. To disable queue tag support, the command line in 
  280. CONFIG.SYS should look like this:
  281.  
  282.     BASEDEV=OS2CAM.ADD /!Q
  283.  
  284.  
  285. Using the /ET Option
  286.  
  287. This option is used to enable Embedded Targets (LUNs). 
  288. LUNs are used by high end systems, such as disk arrays, 
  289. to address certain portions of a SCSI ID. Most standard 
  290. SCSI devices do not use LUNs, and default to LUN 0. This 
  291. option should be used only for devices that use multiple 
  292. embedded targets with LUNs other than 0. To enable LUN 
  293. support, the command line in CONFIG.SYS should look like 
  294. this:
  295.  
  296.     BASEDEV=OS2CAM.ADD /ET
  297.  
  298.  
  299. Using the /DM Option
  300.  
  301. This option enables use of the IBM-supplied DASD manager 
  302. (OS2DASD.DMD) for the devices listed. The DASD manager is 
  303. used to support direct access devices such as hard drives. 
  304. To enable DASD manager support, the command line in 
  305. CONFIG.SYS looks like this:
  306.  
  307.     BASEDEV=OS2CAM.ADD /DM:S|((S,L),[S|(S,L)])
  308.  
  309. Where:
  310.  
  311. S represents a SCSI target ID. Do not use a leading zero 
  312. when specifying target IDs. The LUN for the specified ID 
  313. is assumed to be zero.
  314.  
  315. (S,L) represents a SCSI target/LUN ID pair.
  316.  
  317. "|" means "or".
  318.  
  319. For example, the /DM statement:
  320.  
  321.     BASEDEV=OS2CAM.ADD /DM:3|((2,1),[4|(5,1)])
  322.  
  323. reads "SCSI ID 3 LUN 0 or SCSI ID 2 LUN 1 and SCSI ID 4 
  324. LUN 0 or SCSI ID 5 LUN 1".
  325.  
  326. This statement is evaluated as "SCSI ID 4 LUN 0 or SCSI 
  327. ID 5 LUN 1" first. Whichever is true is then combined 
  328. with "SCSI ID 2 LUN 1". This "and" combination is then 
  329. "or"ed with "SCSI ID3 LUN 0". The IBM DASD manager is 
  330. then used with the result.
  331.  
  332.  
  333. Using the /!DM Option
  334.  
  335. This option disables use of the IBM-supplied DASD manager 
  336. (OS2DASD.DMD) for the devices listed. The DASD manager is 
  337. used to support direct access devices such as hard drives. 
  338. To disable DASD manager support, the command line in 
  339. CONFIG.SYS looks like this:
  340.  
  341.     BASEDEV=OS2CAM.ADD /!DM:S|((S,L),[S|(S,L)])
  342.  
  343. Where:
  344.  
  345. S represents a SCSI target ID. Do not use a leading zero 
  346. when specifying target IDs. The LUN for the specified ID 
  347. is assumed to be zero.
  348.  
  349. (S,L) represents a SCSI target/LUN ID pair.
  350.  
  351. "|" means "or".
  352.  
  353. For example, the /!DM statement:
  354.  
  355.     BASEDEV=OS2CAM.ADD /!DM:3,5
  356.  
  357. disables OS2DASD.DMD on devices at target IDs 3 and 5 
  358. (both at LUN 0).
  359.  
  360.  
  361. Using the /SM Option
  362.  
  363. This option enables use of the IBM-supplied SCSI manager 
  364. (OS2SCSI.DMD) for the devices listed. To enable SCSI manager 
  365. support, the command line in CONFIG.SYS looks like this:
  366.  
  367.     BASEDEV=OS2CAM.ADD /SM:S|((S,L),[S|(S,L)])
  368.  
  369. Where:
  370.  
  371. S represents a SCSI target ID. Do not use a leading zero 
  372. when specifying target IDs. The LUN for the specified ID 
  373. is assumed to be zero.
  374.  
  375. (S,L) represents a SCSI target/LUN ID pair.
  376.  
  377. "|" means "or".
  378.  
  379.  
  380. Using the /!SM Option
  381.  
  382. This option disables use of the IBM-supplied SCSI manager 
  383. (OS2SCSI.DMD) for the devices listed. To disable SCSI 
  384. manager support, the command line in CONFIG.SYS looks 
  385. like this:
  386.  
  387.     BASEDEV=OS2CAM.ADD /!SM:S|((S,L),[S|(S,L)])
  388.  
  389. Where:
  390.  
  391. S represents a SCSI target ID. Do not use a leading zero 
  392. when specifying target IDs. The LUN for the specified ID 
  393. is assumed to be zero.
  394.  
  395. (S,L) represents a SCSI target/LUN ID pair.
  396.  
  397. "|" means "or".
  398.  
  399.  
  400.  
  401. * Troubleshooting *
  402.  
  403.  
  404. YOU CANNOT ACCESS THE SCSI DEVICE(S).
  405.  
  406. Make sure the SCSI device driver is installed properly.
  407.  
  408. Make sure each hard drive has power.
  409.  
  410. Verify that a BASEDEV = OS2CAM.ADD /V line exists in the 
  411. CONFIG.SYS file. 
  412.  
  413. Verify that OS2CAM.ADD has been placed in the appropriate 
  414. directory for your version of OS/2.
  415.  
  416. Check the cable connections and the host bus adapter 
  417. installation.
  418.  
  419.  
  420. THE COMPUTER HANGS OR LOCKS UP WHEN BOOTING AND THE SCSI 
  421. DEVICES ATTACHED ARE NOT SEEN BY THE COMPUTER SYSTEM.
  422.  
  423. Make sure that all the SCSI devices are configured at 
  424. different ID numbers (the boot drive should have the 
  425. lowest ID).
  426.  
  427. Make sure both, but only, the ends of the SCSI bus are 
  428. terminated.
  429.  
  430. Make sure the device driver is listed in CONFIG.SYS (and 
  431. loaded when booting).
  432.  
  433. THE DEVICE DRIVER DOES NOT SEE ONE OF THE SCSI DEVICES.
  434.  
  435. Reboot the computer.
  436.  
  437. Make sure the SCSI devices have different ID numbers (the 
  438. boot drive should have the lowest ID).
  439.  
  440. Make sure both, but only, the ends of the SCSI bus are 
  441. terminated.
  442.  
  443. Check the cable and power connections.
  444.  
  445. OS/2 INSTALLS TO AN IDE DRIVE IN THE SYSTEM INSTEAD OF 
  446. INSTALLING TO THE SCSI DRIVE.
  447.  
  448. The IDE drive must be physically disconnected and disabled 
  449. in the CMOS setup before attempting to install to a SCSI 
  450. drive.
  451.  
  452. NCR ADD ERROR: ONE OR MORE OF YOUR HOST ADAPTERS IS 
  453. MALFUNCTIONING.
  454.  
  455. This is typically an interrupt problem. The system BIOS 
  456. may not be assigning interrupts properly. Since some 
  457. mainboard vendors require specific jumper settings to enable 
  458. the IRQ set by the CMOS, check your manufacturer's 
  459. documentation for proper jumper configurations. Then check 
  460. that the PCI slot setup in the CMOS is assigned and not in 
  461. conflict. If it is not assigned, it will show as NA. Assign 
  462. it a value. The only way to verify that it is in conflict 
  463. is to change the interrupt assigned to the slot in which the 
  464. NCR adapter is placed. If you no longer get the error, the 
  465. conflict is verified and you have successfully fixed the 
  466. problem.
  467.  
  468. THE COMPUTER HANGS OR LOCKS UP DURING INSTALLATION, HAS 
  469. SLOW INSTALLATION (7 hours), OR SLOW BOOT (35 minutes).
  470.  
  471. Some peripheral devices do not properly support the queue 
  472. tag feature for SCSI. This can cause failure of the 
  473. installation process. Add the /!Q option in CONFIG.SYS as 
  474. follows:
  475.  
  476.         BASEDEV=OS2CAM.ADD /V /!Q
  477.  
  478.  
  479.