(Page 4 of 7 in this chapter)

2.3 Installing Under OS/2

This section provides instructions for installing AG Access on the OS/2 operating system. You will complete the following steps:

2.3.1 Running the Installation Script (OS/2)

To install the AG Access software:

  1. Insert the first AG Access installation disk into your floppy drive. 

    

  2. Open an OS/2 command window.
    

    

  3. Make the floppy drive your active drive and enter:
    

       INSTALL

    
Follow the instructions displayed by the AG Access installation program.






2.3.2	 Editing config.sys (OS/2)





After installation is complete, use a text editor to modify your config.sys file as described in the following steps (replace c: with the destination drive that you selected in the installation):


    


  1. Add \nms\bin to your PATH statement. For example:
    

       PATH=c:\os2\;...;c:\nms\bin

    

  2. Add c:\nms\dll to your LIBPATH statement. For example:
    

       LIBPATH=.;c:\os2\dll;c:\;c:\nms\dll

    

  3. Set the environment variable AGLOAD to point to the \nms\ag\load and \nms\ag\cfg directories by adding the following line to config.sys:
    

       SET AGLOAD=c:\nms\ag\load;c:\nms\ag\cfg

    

  4. Install the AG driver ag.sys by adding the following line to config.sys:
    

       DEVICE = driver-file  [/o:maxopens] [/y:DTI address]




  where:


driver-file   is the complete path name of ag.sys;

maxopens  is the maximum number of device opens permitted 
  at one time.

DTI address is the base I/O address of the DTI-48 or DTI-60 board. If there is a DTI-48 or DTI-60 installed which is going to be
the clock master, the AG driver needs this to start the DTI-48's or DTI-60's MVIP clock. Otherwise, omit this option.

The following example assumes that AG Access is installed on the c: drive:
    DEVICE=c:\nms\ag\sys\ag.sys

    


  1. If there is a DTI-48 or a DTI-60 installed, enable I/O privileges by adding (or editing) the IOPL statement as follows:
    

        IOPL=yes

    

  2. If your compiler's include file search path is specified by an environment variable (for example, include), add c:\nms\include; to the appropriate statement. For example:
    

        SET INCLUDE=c:\ibmcpp\include;c:\nms\include;

    

  3. If your linker's library file search path is specified by an environment variable (for example, lib), append c:\nms\lib; to the appropriate statement. For example:
    

        SET LIB=c:\ibmcpp\lib;c:\nms\lib;

    

  4. Save the modified config.sys and exit the editor.
    

    

  5. You must shut down and restart your system in order for the changes to config.sys to take effect.
    







2.3.3	 Creating the AG Configuration File (OS/2)





The AG loader/monitor program, agmon, interprets the AG configuration file to determine the interrupt, the I/O address, and other characteristics of an AG board, and uses it to download the firmware to a board. The AG configuration file is an ASCII file named \nms\ag\cfg\ag.cfg.


Note:  c:\nms\ag is the default directory to which the AG runtime software is installed. If you modified your software installation, replace the default directory with the path that you specified for your system.


There are several sample configuration files that were copied to your \nms\ag\cfg directory during installation. The sample files include: 





 File Name



 Description




 ag8.cfg



 For AG-8 running µ-law




 ag8a.cfg



 For AG-8 running A-Law




 ag8did.cfg



 For AG-8 DID




 ag24.cfg



 For AG-24 and AG-24+




 ag30.cfg



 For AG-30




 ag48.cfg



 For AG-48




 ag60.cfg



 For AG-60




 age1test.cfg



 For AG-E1




 agt1.cfg



 For AG-T1
















Each of these sample files configures one board at a default I/O address 0x2C0 and interrupt 12, and should work with an AG board of the appropriate type as it is shipped. The I/O addresses and interrupt that you chose during the installation of the AG boards must be entered into the AG configuration file. (The sample configuration files use the default values.) There are commented-out lines in the sample files for additional boards. If you are using two or more AG boards, refer to Section 4.4, Using Multiple AG Boards for instructions.



You must have an AG configuration file in order to run agmon. See Chapter 5 for detailed information about agmon. See Chapter 4 for details about modifying the contents of the AG configuration file.








 
    (Page 4 of 7 in this chapter)









Tech_Support@nmss.com



Copyright © 1996, Natural MicroSystems, Inc.   All rights
reserved.