(Page 4 of 6 in this chapter)

3.3 Installing Under OS/2 Warp

To install the MC1 software under OS/2 Warp, run the installation program and edit your config.sys file, as described in the following procedure. Note: Install your MC1 boards in your system before installing the software. (See Chapter 2 to learn how to do this.) Make a note of the base I/O addresses at which you installed the boards. The installation program will prompt you for these addresses. If you plan to install SwitchPath, do so before installing the MC1 driver software. To learn how to install SwitchPath, see your SwitchPath documentation. Insert the MC1 software installation disk into your floppy drive. Open a system command window. Make the drive containing your installation disk the default drive by entering A: or B: at the system prompt. Enter: install The installation program starts up, and displays its welcome and information screens. It then prompts you for a destination drive. Use the arrow keys to select the drive to install on, and press Enter. The install program prompts you to enter the number of MC1 boards you are installing. Enter the number of boards you are installing, and press Enter. The program displays a menu containing a list of base I/O addresses. Use the arrow keys to highlight the address of one of your boards, and press the space bar to toggle the board selection. The default address is already selected. Repeat this step until the addresses of all of your boards are highlighted. When you have selected the addresses of all of your boards, press Enter. The install program begins copying the files from the installation disk to the NMS subdirectory tree on the specified drive. If the installation program detects previously installed files that are newer than the versions contained in the package, it asks you whether to install or skip the files in question. Typically, you should not overwrite newer files. When the installation program finishes copying files, it displays a list of changes to make to your config.sys file. It outputs the file config.mc1 containing these changes. config.mc1 is stored in the root directory of the drive on which the software is being installed. Press Enter to exit the install program. Using a text editor, open config.mc1 and config.sys. Change your config.sys file as directed in config.mc1. The following is a sample config.mc1 file (for a one-board installation), with the changes to make to the config.sys file underlined. The contents of your config.mc1 file may be different. Exit the text editor, saving changes. Reboot your system so that the new configuration takes effect.

3.3.1 Installing swdaemon.exe

In OS/2, SwitchPath uses a detached daemon process to maintain its database of connections, group names, and handles even when an application using SwitchPath is not running. In order for this process to work, swdaemon.exe should start up before SwitchPath loads.
To allow swdaemon.exe to start up whenever OS/2 starts up, make sure the following line is included in your config.sys file for the 16-bit MC1 wrapper DLL: RUN=c:\nms\bin\swdaemon.exe mc1sw16
There are two wrapper DLLs provided. They are mc1sw16.dll and mc1sw32.dll. They provide a 16-bit and 32-bit interface to the driver respectively.
Not all NMS device drivers support 32-bit data structures. This means that a system may have boards that require 16-bit data structures. It is recommended that the mc1sw16.dll be used in systems with boards that require 16-bit data structures. If you are using the 32 bit MC1 wrapper DLL, include the following line: RUN=c:\nms\bin\swdaemon.exe mc1sw32 Note: If more that one driver is being used, make sure that all are included in your config.sys file. This example uses the 16-bit MC1 wrapper DLL and the AG Conference board driver: RUN=c:\nms\bin\swdaemon.exe mc1sw16 agcfsw
For more information about swdaemon.exe, see the SwitchPath Technical Reference Manual.

3.3.2 Changing the Driver Configuration After Installation

You may need to modify your driver configuration after you have completed the install process. For example, you may wish to add additional boards to your system, or you may need to change the base I/O address of a board.
To change your driver configuration, do the following: Modify the "device=c:\nms\mc1\sys\mc1.sys /a:addr,...,addr" statement in your config.sys file to reflect your changes. The syntax of this line is shown in Section 3.3, Installing Under OS/2 Warp. Reboot your system to make the changes effective.

(Page 4 of 6 in this chapter)

Tech_Support@nmss.com