IBM Wide Area Connector (WAC) V2.30 Installation Tips March 10, 1994 This information is intended to be a supplement to the booklet "IBM Wide Area Connector Installation and Testing Instructions" which was shipped with your adapter. As of this printing, this is the latest information available to help users with hardware or device driver installation. ____________________________________________________________________ CONTENTS: Obtaining the Latest Device Drivers .......................Page-1 WAC Hardware Installation on ISA bus personal computers ...Page-2 Device Driver Installation With OS/2 Machines Preparation for Driver Installation (OS/2) .............Page-3 Installation of Device Driver (OS/2) ...................Page-4 Configuration of Device Driver (OS/2) ..................Page-5 Device Driver Installation With DOS Machines ..............Page-7 Device Driver Installation on a NetWare Server.............Page-8 Locating the Memory Window (ISA) ..........................Page-11 Trademarks and Service Marks ..............................Page-12 _____________________________________________________________________ Page-1 Obtaining the Latest Device Drivers ___________________________________ The latest version of the "IBM Wide Area Connector Installation and Diagnostics Diskette" which includes the device drivers can be obtained from the IBM PCC BBS (Phone: 919-517-0001) in directory 27. The REF DISK command must be used to access directory 27. Use the "Search for files" command to search for files matching the description: WAC*.DSK Use the "HELP" command from the main menu if you are unfamiliar with how to use .DSK files. _____________________________________________________________________ Page-2 Hardware Installation on ISA bus personal computers ___________________________________________________ The ISA WAC card may be put into any free 16-bit slot. It is important, however, that the I/O address range settings (switches 4-7) of the WAC adapter not duplicate those addresses of any other device in your system. If further assistance is required to set the switch positions, your local systems coordinator should be consulted. When configuring the ISA WAC card, find the Logical Card Number in the chart below which corresponds to your card's switch or address settings. MAKE A NOTE OF THIS LOGICAL CARD NUMBER. I/O Logical Dip Switch Address (Hex) Card Number 4 5 6 7 ================================================= 0120 - 013F 15 ON ON ON ON 0140 - 015F 14 OFF ON ON ON 0180 - 019F 13 ON OFF ON ON 01A0 - 01BF 12 OFF OFF ON ON 0220 - 023F 11 ON ON OFF ON 0240 - 025F 10 OFF ON OFF ON 0280 - 029F 9 ON OFF OFF ON 0280 - 029F 8 OFF OFF OFF ON 0520 - 053F 7 ON ON ON OFF 0540 - 055F 6 OFF ON ON OFF 0580 - 059F 5 ON OFF ON OFF 05A0 - 05BF 4 OFF OFF ON OFF 0620 - 063F 3 ON ON OFF OFF 0640 - 065F 2 OFF ON OFF OFF 0680 - 069F 1 ON OFF OFF OFF 0680 - 069F 0 OFF OFF OFF OFF Note: In OS/2(*) applications you will need to use the LAPS(*) configuration utility to configure the card. Enter the the Logical Card Number in the LAPS configuration field titled "Card Number". Note: In a NetWare(**) server the Logical Card Number is specified by the SLOT parameter on the LOAD line for WACSDLC. See Page-9. WARNING: When the WAC adapter is used in IBM PS300 models 657x and 658x (where x can be any number), the adapter must be set to use Interrupt-9 only. The use of any other interrupt may cause erratic behavior due to lost interrupts. _____________________________________________________________________ Page-3 Device Driver Installation With OS/2 Machines Preparation for Driver Installation (OS/2) The following instructions will allow you to install the OS/2 device driver for the Media Access Control (MAC) communications layer. The information provided here is for assistance and is not intended to duplicate other product documentation. Where applicable, additional references are provided for assistance. Changes in the products described below due to new versions may result in some inaccuracies in the steps below. If additional assistance is needed on a specific product, contact your local customer service representative. The following pre-installation of software must be performed before proceeding to the device driver installation. Note that version numbers mentioned are minimums. -- The OS/2 Version 2.0 Base system must be installed on your system. -- OS/2 LAN Adapter and Protocol Support (LAPS) V2.2 must be available. This is distributed as a part of "Network Transport Services/2" or is often shipped as part of several program products. Some of the earlier protocol products shipped a previous release of LAPS which will cause errors if used. Avoid using earlier versions. If you are not sure what software versions are installed on your personal computer, run the OS/2 utility SYSLEVEL which is usually found in the C:\OS2 directory. APPLICATION NOTE: Some applications are shipped with the WAC V2.0 driver. If this is the case with your application, you do NOT require the driver from this diskette. Your application installation will handle this for you. _____________________________________________________________________ Page-4 Installation of Device Driver (OS/2) The OS/2 device driver conforms to the IBM extensions of the 3Com**/Microsoft** Local Area Network (LAN) Manager Network Driver Interface Specifications (NDIS) Version 2.01 (Final). ________________________________________________________________ The following procedure will install the driver: 1) Open an OS/2 window for full screen. 2) Run the LAPS installation and configuration program by changing to the directory where the LAPS.EXE file resides (typically in C:\IBMCOM). 3) Enter LAPS at the command prompt. 4) Insert the WAC Installation and Testing Diskette into your diskette drive. Select "Install" from the LAPS main menu. 5) Select "Additional Network Drivers" from the Installation menu, select "Continue..." and press ENTER. 6) Modify the screen to match your diskette drive letter and the path to the OS/2 MAC driver. Typically, this is "A:\OS2" 7) Select "OK" and press ENTER. LAPS will now copy the OS/2 device driver onto your hard drive a:\os2\IBMWAC.OS2 into C:\IBMCOM\MACS directory a:\os2\IBMWAC.NIF into C:\IBMCOM\MACS directory a:\os2\WAC.MSG into C:\IBMCOM directory a:\os2\WACH.MSG into C:\IBMCOM directory 8) After the device driver files have been successfully transferred, exit to the LAPS main menu. The WAC driver is now installed. In most cases, your next step will be to install or configure your specific communications application. Refer to your application support documentation to accomplish this. _____________________________________________________________________ Page-5 Configuration of Device Driver (OS/2) Configuration varies with different applications. The following steps outline how to configure the IBM Wide Area Connector as a network adapter under LAPS. 1) Select "Configure" from the LAPS main menu or from your application's configuration screen as appropriate and press ENTER. 2) Follow the LAPS procedure for selecting network adapters and protocols and adding them to the Current Configuration list. 3) Select "IBM Wide Area Connector" from the Network Adapters list and press ADD to add this to the Current Configuration list. 4) Select the Protocol required and press "Add". 5) Select "IBM Wide Area Connector ......." from the Current Configuration list and press "EDIT" to supply the IBM WAC communication parameters. 6) Enter the Slot or Card number to match the WAC Adapter installation in your system. For Micro Channel machines, this corresponds to the physical card slot number. CAUTION: with ISA bus machines, this is a LOGICAL number which corresponds with the adapter's switch settings and has no relation to the physical card location. For ISA systems, refer to the previous section titled "Hardware Installation on ISA bus personal computers" to obtain the card number. 7) Set the Port number to that which corresponds to the link over which communications will occur (i.e. "0"= Link A; "1"= Link B) Physically, the "0" refers to the daughterboard which is located farthest from the bus tab pins on the adapter. 8) Select a memory window (RAMADDRESS) for the adapter. Micro Channel machine users may ignore this step, since this is automatically resolved using the .ADF file. For ISA bus machines, the default value of the 16KB shared memory address is D0000. This may or may not be acceptable depending on the specific ISA system and the other adapters that may be installed. If you require help in locating available address space, refer to Page-11. ...continued _____________________________________________________________________ Page-6 9) In many cases you will be able to accept the remaining default values. However, your application, specific system or network configuration, may require other values to be altered. Online help is available for the remaining defaulted values. The configuration parameters are listed in the TECHREF.FIL which is also on this diskette. APPLICATION NOTES: If your application supports switched DCE's (via V.25bis dialing), you should set CONNTYPE = 1. Applications which use Port Connection Manager (PCM) to manage the ports should also set PCMSUPPORT = 1 on the LAPS configuration screen. 10) Select "OK" and press ENTER to save these parameters. 11) Exit completely from the LAPS installation and configuration program. In most cases you will need to shutdown OS/2 and reboot for the configuration changes to take effect. _____________________________________________________________________ Page-7 Device Driver Installation With DOS Machines The DOS device driver (Version 1.0) can be found in the DOS directory of the Installation and Testing Diskette. It consists of the following files: a:\dos\IBMWACD.DOS a:\dos\WAC.MSG a:\dos\WACH.MSG Refer to your application's documentation for device driver installation and configuration procedures. APPLICATION NOTE: Some applications are shipped with the WAC DOS driver. If this is the case with your application, you do NOT require the driver from this diskette. Your application installation will handle this for you. _____________________________________________________________________ Page-8 Device Driver Installation on a NetWare Server The NETWARE directory of the this diskette contains WACSDLC.LAN, a WAC ODI driver for use with the NetWare for SAA(**) V1.3B workgroup-to-host connectivity application, which runs on both the NetWare 3.x and the NetWare 4.x servers. To install the WACSDLC.LAN driver insert this diskette in drive A of the NetWare server and type 'LOAD INSTALL' and press enter. -- For NetWare 3.x servers: Select 'Product Options' from the menu. After the 'Product Options' window appears press the insert key and then follow the directions on the screen. -- For NetWare 4.x servers: Select 'Maintenance/Selective Install' from the menu, then select 'Product Options' from the next menu. After the 'Product Options' window appears press the insert key and then follow the directions on the screen. Once the WACSDLC.LAN driver is installed it can be loaded directly from the NetWare server System Console or the load command can be included in the AUTOEXEC.NCF file. The format of the LOAD command is: LOAD WACSDLC NAME=xxxxxxxx SLOT=x CHANNEL=x MEM=xxxxx RS232MODE=x X21MODE=x SPEED=xxxx NOTE: The following parameters MUST be included for a ISA Bus server: NAME, SLOT, CHANNEL, and MEM. The following parameters MUST be included for a Micro Channel(*) server: NAME, SLOT, and CHANNEL. The following is a description of each parameter: NAME=xxxxxxxx specifies the eight-character logical adapter name. This name must match the logical adapter name specified when configuring NetWare for SAA using the CSCON utility. Note: The logical adapter name is also used on the command line when the CSLOAD command is entered on the NetWare server. (CSLOAD xxxxxxxx) ...continued _____________________________________________________________________ Page-9 SLOT=x identifies the card to be used by the driver. For an ISA Bus server, this number is a logical card number (see the table on Page-2), and the valid range of values is 0 - 15. For a Micro Channel(*) server, this number is a physical card number, and the valid range of values is 1 - 8. CHANNEL=x identifies the physical channel (or port) on the WAC Adapter to be used by the driver. Channel 0 is the port on the WAC Adapter furthest from the bus connector. Channel 1 is the port closest to the bus connector. MEM=xxxxx specifies the starting address for the 16KB shared memory on the card. This address is required for an ISA Bus server ONLY. (For Micro Channel(*) servers the memory address range is obtained automatically by the driver from the POS registers.) The address must be on a 16KB (4000 hexidecimal) boundary. The valid range of values is: C0000 - FC000. RS232MODE=x specifies clocking modes if the RS232/V.24 port is used. Normally this value is 0. The valid values are: 0: Normal DTE mode, used when connected to a modem that generates clocking. This is the default (normal) value. 1: DTE mode with pin 24 clocking, used when connected to a modem that requires the DTE to generate Tx clock on pin 24. Normally this value is not used. 2: DCE mode, used when the WAC provides both Rx and Tx clocks. DCE mode requires the use of a crossover adapter described in the TECHREF.FIL file. Normally this value is not used. X21MODE=x Specifies clocking modes if the RS422/X.21 port is used. Normally this value is 0 or 3. The valid values are: 0: RS422 DTE mode. This requires an RS422 cable. 1: X.21 DCE TxC_Echo mode. With this mode, the attached DTE must echo the clock back on the B line to be used for clocking data into the Wide Area Connector. Normally this value is not used. 2: Normal X.21 DCE mode. Normally this value is not used. 3: Normal X.21 DTE mode. This is the default value. ...continued _____________________________________________________________________ Page-10 4: X.21 DTE TxC_Echo mode. In this mode, the clock received on the S line is echoed by the WAC card on the B line to eliminate Tx clocking skew on long cables. Normally this value is not used. Note: X21MODE=1 and X21MODE=2 require a Crossover Connector as described in the TECHREF.FIL file. SPEED=xxxxx specifies the speed (in bit per second) to be used when the port generates the clocking signal. Normally this parameter is not used. The valid speed values are: 2M, 1.5M, 1M, 768K, 512K, 256K, 64K, 19200, 9600, 4800, 2400, and 1200. The default value is 9600. Note: The speeds values of 2M, 1.5M, 1M, 768K, 512K, 256K, and 64K correspond to actual speeds of 1.843M, 1.474M, 983.040K, 776.084K, 508.468K, 254.234K and 63.833K respectively. When in normal DTE mode, the clocking is generated by the modem or DSU/CSU, and this parameter is ignored. The port generates clocking in all DCE modes and in the RS232/V.24 Pin 24 mode (see above for the RS232/V.24 Mode parameter). NOTE: The encoding mode (NRZ or NRZI) and the RTS mode (CONTINUOUS or SWITCHED) are specified when configuring NetWare for SAA using the CSCON utility from the SUPERVISOR (NW 3.x) or ADMIN (NW 4.x) userids. _____________________________________________________________________ Page-11 Locating the Memory Window (ISA) For ISA bus machines, the default value of the 16KB shared memory address is D0000. This may or may not be acceptable depending on the specific ISA Bus computer system and the other adapters that may be installed. If you are not sure that this address is available, you can boot the machine with the Wide Area Connector Installation and Diagnostic diskette inserted in drive A. This will run the diagnostic program that is capable of detecting a memory conflict. After the machine reboots, select option "[1] Run tests one time" from the WAC Test Control Menu. You will next see instructions on installing the cable and wrap plug. Press ENTER after following these directions. You will then be shown a menu with the configuration information and the RAM window address. To change the RAM window address to the one you plan to use with LAPS, press N. On the Adapter Select & Test Control menu, select "[3] Move and or size the RAM window". Use [1] or [2] to move the RAM window to match the desired address for LAPS. When done, press ESC and then Y. On the next menu, again press Y to run all tests. If there is a memory conflict, the diagnostics will report a 6580 error and a text explanation of the problem. You can then try repeating this test with different RAM window addresses until there are no more conflicts. _____________________________________________________________________ Page-12 TRADEMARKS AND SERVICE MARKS ____________________________ The following terms, denoted by a single asterisk in this file(*), are trademarks of the IBM Corporation in the United States and/or other countries: IBM OS/2 LAPS Micro Channel The following terms, denoted by a double asterisk (**) in this file, are trademarks of other companies as follows: 3Com 3Com Corporation. Microsoft Microsoft Corporation. NetWare and NetWare for SAA Novell Corporation