(Page 3 of 6 in this chapter)

3.2 Installing Under OS/2

To install the AG Connect driver software under OS/2, run the installation program and edit your config.sys file, as described in this procedure: If you plan to install SwitchPath, do so before installing the AG Connect driver software. To learn how to install SwitchPath, see your SwitchPath documentation. Insert the AG Connect software installation disk into your floppy drive. Open a system prompt 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 AG Connect 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 select it. 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 prompts you to choose an encoding scheme. Press 1 for µ-law, or 2 for A-law. Then 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.agx containing these changes. config.agx 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.agx and config.sys. Change your config.sys file as directed in config.agx. The following is a sample config.agx file (for a one-board installation), with the changes to make to the config.sys file underlined. The contents of your config.agx file may be different. The syntax of the set AGCX= line is as follows: set AGCX={!}[m|a]:addr,addr,addr,addr ...where: ! (Optional) if included, a status message will appear whenever the driver DLL loads. (NOTE: This message may NOT appear under certain circumstances. For details, see section 3.2.1.) m is µ-law, a is a-law (choose one only). Each addr is the base address of one of your AG Connect boards. The order you list them here determines the board number by which the software will refer to them later: the first board listed will be Board 0, the second will be Board 1, and so on. Exit the text editor, saving changes. Reboot your system to make your changes effective.

3.2.1 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 your application 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: RUN=c:\nms\bin\swdaemon.exe agcxsw
"agcxsw" is the name of the AG Connect device driver. Note: If more than one driver is being used, make sure that their names are all included in this line in your config.sys file: RUN=c:\nms\bin\swdaemon.exe agcxsw agcfsw
For more information about SWDAEMON.EXE, see the SwitchPath Technical Reference Manual. Note: Note: When you run SWDAEMON with agcxsw as a command line argument, SWDAEMON loads the driver DLL into memory. If you start SWDAEMON in config.sys, you will not see a startup status message even if you have included the ! symbol in the set AGCX = line in config.sys (see section 3.2).

3.2.2 Changing The Configuration After Installation (OS/2)

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 set AGCX= statement in config.sys to reflect your changes. The syntax of this line is shown in section 3.2. Reboot your system to make the changes effective.

(Page 3 of 6 in this chapter)

Tech_Support@nmss.com