If...	Set DigitalMode as follows...
Trunk will carry D channel	`DigitalMode=PRI` This setting routes D channel information on the trunk to the HDLC controllers, and routes B channel information to DSP resources.
Trunk will NOT carry D channel	`DigitalMode=RAW` This setting routes B channel information only.

(Page 1 of 1 in this chapter)

Chapter 3

Editing Your AG Configuration File

3.1 Introduction

3.2 Creating an AG Configuration File For Your Setup

3.3 Configuring On-Board Software

3.4 Configuring Data Routing

3.5 Setting Up NFAS Groups

: 3.5.1 About NFAS
: 3.5.2 Specifying NFAS Groups in ag.cfg

3.6 Sample AG Configuration Files

: 3.6.1 Sample ag.cfg for a Single AG-T1 Board
: 3.6.2 Sample ag.cfg for Two AG-E1 Boards With MVIP Connectivity
: 3.6.3 Sample ag.cfg for a Single AG Quad T Board
: 3.6.4 Sample ag.cfg for a Configuration Involving NFAS Groups
: 3.6.5 Sample ag.cfg for isdndemo NFAS Demonstration

3.1 Introduction

The AG configuration file lists the types, locations, and roles of each of your AG boards. It also describes what software modules should be loaded to the AG board's memory. The AG board initialization utility agmon interprets this file when it is invoked, and configures your board as described in the file.
This chapter describes how to edit your AG configuration file so agmon configures your boards properly for the AG ISDN software you are using. For more information on the AG configuration file, see the AG Runtime Configuration and Developer's Manual.

3.2 Creating an AG Configuration File For Your Setup

AG ISDN and CT Access include a set of example AG configuration files for different setups. To create an AG configuration file for your setup, modify or combine the example files installed on your system, in one of the following locations: UNIX: /opt/nms/ag/cfg/*.cfg Windows NT: \nms\ag\cfg\*.cfg
The sample configuration files installed with AG ISDN software each contain settings for a specific board type and geographic region. These files are named agixyyzz.cfg, where: x is the AG board type: q if Quad board, s if AG-T1 or AG-E1, 4 if AG 4000 yy is the region for the AG ISDN package you installed: us for US, eu for Europe, as for Asia, qs for QSIG zz is the line type (needed for Asia and QSIG packages only): e1 or t1
Here are some example file names: File Description File Name (AG-T1/E1) File Name (AG Quad) File Name (AG 4000) US agisus.cfg agiqus.cfg agi4us.cfg Europe agiseu.cfg agiqeu.cfg agi4eu.cfg Asia, E1 agisase1.cfg agiqase1.cfg agi4ase1.cfg Asia, T1 agisast1.cfg agiqast1.cfg agi4ast1.cfg QSIG, E1 agisqse1.cfg agiqqse1.cfg agi4qse1.cfg QSIG, T1 agisqst1.cfg agiqqst1.cfg agi4qst1.cfg
The file you create should be named ag.cfg. This is the file name agmon looks for by default. agmon uses the following algorithm to search for this file: UNIX: agmon searches in the current working directory, and then in the directory /opt/nms/ag/cfg. Windows NT: agmon searches in the current working directory, and then in the directories specified in the AGLOAD environment variable.
The following sections describe the statements and settings specific to AG ISDN software installations: Settings to configure on-board software. These settings are mandatory. A setting to configure data routing. This setting is mandatory for AG ISDN installations. Settings to configure Non-Facility Associated Signaling (NFAS) groups. These settings are optional.
In addition to the statements described below, you will need other statements in the AG configuration file to configure your hardware. To learn more about these statements, see the Installation and Developer's Manual for your AG board, and the AG Runtime Configuration and Developer's Manual.

File Description	File Name (AG-T1/E1)	File Name (AG Quad)	File Name (AG 4000)
US	`agisus.cfg`	`agiqus.cfg`	`agi4us.cfg`
Europe	`agiseu.cfg`	`agiqeu.cfg`	`agi4eu.cfg`
Asia, E1	`agisase1.cfg`	`agiqase1.cfg`	`agi4ase1.cfg`
Asia, T1	`agisast1.cfg`	`agiqast1.cfg`	`agi4ast1.cfg`
QSIG, E1	`agisqse1.cfg`	`agiqqse1.cfg`	`agi4qse1.cfg`
QSIG, T1	`agisqst1.cfg`	`agiqqst1.cfg`	`agi4qst1.cfg`

3.3 Configuring On-Board Software

To configure the software on your AG boards, include the following statements in your file:

Use this file...	For these regions...
`isdnusa.leo`	USA
`isdneur.leo`	Europe: Austria, Belgium, Denmark, France, Finland, Germany, Greece, Iceland, Ireland, Italy, Liechtenstein, Luxembourg, Netherlands, Norway, Portugal, Spain, Sweden, UK. Also China, Singapore.
`isdnasa.leo`	Asia: Japan, Australia, Hong Kong, Korea.
`isdnqsi.leo`	QSIG

TCP

The TCP statement specifies a trunk control program (TCP) to be transferred to the AG board by agmon. For AG ISDN installations, specify one of the following, depending upon at what layer the application will access ISDN services: Specify this... If... TCP=isd0.tcp You are configuring the AG ISDN protocol stack to run in NCC configuration (that is, standard Natural Call Control) TCP=nocc.tcp You are configuring the software to run in ACU configuration or LAPD configuration. nocc.tcp is distributed with CT Access. It sets up your system so call control is handled by the host application instead of by the TCP.
This statement normally applies to all boards in an AG ISDN system. For this reason, it is usually specified in the COMMON section of the AG configuration file.
For more information about the TCP, see Section 1.3.7.
Note: (AG Quad boards only) If you include a CCMode statement in your AG configuration file, when you call adiStartProtocol in the application, make sure to change the mediamask parameter passed in the call so the AG Quad board's DSP resources are allocated properly. For more information, see the AG Quad Installation and Developer's Manual, AG ISDN Messaging API Developer's Reference Manual or AG ISDN for Natural Call Control Developer's Manual.

Specify this...	If...
`TCP=isd0.tcp`	You are configuring the AG ISDN protocol stack to run in NCC configuration (that is, standard Natural Call Control)
`TCP=nocc.tcp`	You are configuring the software to run in ACU configuration or LAPD configuration`.` `nocc.tcp` is distributed with CT Access. It sets up your system so call control is handled by the host application instead of by the TCP.

3.4 Configuring Data Routing

Use the DigitalMode statement to configure routing of voice and signaling information between trunks and DSPs. Set DigitalMode as follows: If you are not setting up NFAS groups, set DigitalMode=PRI for each board in your system. This setting routes D channel information on each trunk to the HDLC controllers, and routes B channel information to DSP resources. If you are setting up NFAS groups (as described in Section 3.5), include a single DigitalMode statement in the Trunk section of each trunk in each NFAS group. In each case, set DigitalMode as follows: If... Set DigitalMode as follows... Trunk will carry D channel DigitalMode=PRI This setting routes D channel information on the trunk to the HDLC controllers, and routes B channel information to DSP resources. Trunk will NOT carry D channel DigitalMode=RAW This setting routes B channel information only. Note: If MVIP switching is enabled (EnableMVIP=YES), routing does not take place regardless of the DigitalMode setting. Instead, your application must make the appropriate MVIP switch settings, as described in the AG ISDN for Natural Call Control Developer's Manual and AG ISDN Messaging API Developer's Reference Manual.

3.5 Setting Up NFAS Groups

In setups with multiple T1 ISDN trunks, a Non-Facility Associated Signaling (NFAS) configuration can be used. This section describes NFAS, and how to configure NFAS groups in your AG configuration file.

3.5.1 About NFAS

ISDN is transmitted over standard T1 and E1 carriers. T1 and E1 are typically four-wire digital transmission links.
Data on a T1 or E1 trunk is transmitted in channels. For primary rate ISDN, T1 carries 24 channels. E1 carries 32 channels. With primary-rate ISDN, the channels are usually used as follows: On a T1 trunk, 23 of the 24 channels carry data: voice, audio, data and/or video signals. These channels are called bearer channels (B channels). On an E1 trunk, 30 of the 32 channels are bearer channels. On a T1 or E1 trunk, one channel carries signaling for all B channels. This is called the D channel. On T1 trunks, the D channel is typically carried in channel 24. On E1 trunks, channel 16 is used as the D channel. Figure 1. AG Quad T1 (Standard Configuration)
NFAS configurations are supported on T1 trunks only; not on E1 trunks. In an NFAS configuration, trunks are grouped into one or more NFAS groups. One of the trunks in each group has a D channel carrying the signaling for all of the B channels on all of the trunks in the group. This leaves channel 24 free on all other trunks in the NFAS group. This extra channel can be used as another B channel. (See Figure 2.) Figure 2. Sample NFAS Configuration
A single NFAS group can contain trunks from multiple boards. (See Figure 3.) Figure 3. Sample NFAS Configuration (Multiple Boards) Note: If your application will use the AG ISDN software in NCC configuration, all trunks in an NFAS group must be on the same board; an NFAS group cannot contain trunks from multiple boards. Note that this restriction does not apply to the ACU configuration or the LAPD configuration. Note: NFAS groups and Hot Swap configurations: If an NFAS group spans multiple boards in a Hot Swap system, and you remove or insert a board while the system is running, the AG ISDN protocol stacks on the other boards are not affected. If you remove a board containing only B channels, the stack on the D channel board does not sense that the board is missing. It is the application's responsibility to sense this change and take appropriate action (i.e., not access B channels on that board).

3.5.2 Specifying NFAS Groups in ag.cfg

An example listing of an ag.cfg file containing NFAS information appears in Section 3.6.4.
To group T1 trunks into NFAS groups, edit the Board x sections of your AG configuration file. In each Board x section, create a separate Trunk x section for each trunk on the board, each containing the statements listed below. Note: These statements are all optional unless you set up NFAS groups. Note: If you set up NFAS groups, make sure to set the DigitalMode statement correctly for each trunk, as described in Section 3.4.

NFAS_Group

This statement assigns a trunk to an NFAS group. All trunks in an NFAS group will have the same NFAS_Group number.
To assign a trunk to a group, include the NFAS_Group statement in the Trunk section specifying the trunk in the AG configuration file. Include the statement as follows:
NFAS_Group= group_no
... where group_no is the NFAS group number.

D_channel

In each NFAS group, one (and only one) trunk must carry the D channel. Use the D_channel statement to specify which trunk carries the D channel in a group. Include this statement in the Trunk section specifying the trunk in the AG configuration file. Include the statement as follows:
D_channel= YES
Note that if D_channel is set to YES for a trunk, the DigitalMode statement (described in Section 3.4) must be PRI for that trunk. If a trunk is part of an NFAS group but does not carry a D channel, specify DigitalMode=RAW in the Trunk section for the trunk.

NAI

In each NFAS group, individual trunks are identified using network access identifier (NAI) numbers. Use the NAI statement to assign an NAI to a trunk. Include the statement in the Trunk section specifying the trunk in the AG configuration file, as follows:
NAI= nai
... where nai is the NAI of the trunk.
This statement is mandatory if the trunk section also contains an NFAS_Group statement.
The NAI of each trunk in an NFAS group must be unique. In addition, if a particular board supports the D-channel trunks for more than one NFAS group, the NAIs of all trunks in each of these groups must be unique.

3.6 Sample AG Configuration Files

The following are listings of sample ag.cfg files for AG ISDN configurations.

3.6.1 Sample ag.cfg for a Single AG-T1 Board

The following sample ag.cfg file describes a single AG-T1 configured for ISDN (USA variant), on a T1 trunk using extended superframe framing (ESF). The application is designed to access ISDN services in NCC configuration (using the Natural Call Control API). [AGBOARD] The AG configuration file must begin with this statement. #- COMMON section - Any statements in this section of the file will apply to all boards listed in the Board x sections below. Interrupt = 12 The interrupt you specify here will be used by all AG boards in your system. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. DspFile = voice.dsp DspFile = dtmf.dsp DspFile = callp.dsp DspFile = tone.dsp These statements install DSP program files. They are installed on all boards listed in this file, since they appear in the COMMON section of this file. For this configuration, you need at least the statements shown. You can add others also, if you wish. These files are for µ-law encoding. If your setup calls for A-law encoding, add _a to each file name. RunFile = systn.run Defines the runfile to be used. It is board- and protocol-specific. For AG-T1 boards using ISDN, use systn.run. If you have more than one board, and the AG boards require different runfiles, include this line in a Board x section instead of the COMMON section. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. RunModule=isdnusa.leo Defines the downloadable object module to be used. It is region- and protocol-specific. For ISDN in the US, use isdnusa.leo. TCP = isd0.tcp Indicates the TCP to load to the AG board. To configure the software so that call control is accessible directly by the CT Access API, specify isd0.tcp. BufferSize = 12000 Sets the size (in bytes) of the DSP voice buffer used to play and record files. For all AG ISDN installations, set BufferSize to 12000. This reduces the size of the voice buffer, to allow enough space to accommodate AG ISDN. This change will not perceptively affect the quality of voice processing. #- BOARDS section - Board 0 Indicates the beginning of a description of a particular board. The number appearing here will be used to refer to the AG board in software. Address = 2C0 This is the AG board's I/O address. Each board must have a unique address. The address is set here and on the AG board's face using switches. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. ClockRef = NET1 Configures the clock. NET1 causes the AG board to derive the local clock using the clock extracted from the T1 or E1 trunk. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. EnableMVIP = NO Enables or disables MVIP switching. When set to NO, MVIP switching is disabled. Note that certain switch connections are automatically made by default when EnableMVIP=NO, to route voice and signaling information to appropriate on-board resources. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. DigitalMode=PRI Determines how voice and signaling information is routed to and from the T1 or E1 trunk and processing resources. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. LineCode = B8ZS Specifies the trunk coding algorithm the AG board is to expect. The setting made here is Binary 8 Zero Suppression (the default for AG-T1 boards when DigitalMode is PRI or RAW). For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. FrameType = ESF Specifies the framing method the AG board is to expect. The setting made here configures the AG board for Extended SuperFrame for USA. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. End Board Indicates the end of the description of Board 0.

`[AGBOARD]`	The AG configuration file must begin with this statement.
`#- COMMON section -`	Any statements in this section of the file will apply to all boards listed in the `Board` x sections below.
`Interrupt = 12`	The interrupt you specify here will be used by all AG boards in your system. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`DspFile = voice.dsp` `DspFile = dtmf.dsp` `DspFile = callp.dsp` `DspFile = tone.dsp`	These statements install DSP program files. They are installed on all boards listed in this file, since they appear in the `COMMON` section of this file. For this configuration, you need at least the statements shown. You can add others also, if you wish. These files are for µ-law encoding. If your setup calls for A-law encoding, add `_a` to each file name.
`RunFile = systn.run`	Defines the runfile to be used. It is board- and protocol-specific. For AG-T1 boards using ISDN, use `systn.run`. If you have more than one board, and the AG boards require different runfiles, include this line in a `Board` x section instead of the `COMMON` section. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`RunModule=isdnusa.leo`	Defines the downloadable object module to be used. It is region- and protocol-specific. For ISDN in the US, use `isdnusa.leo`.
`TCP = isd0.tcp`	Indicates the TCP to load to the AG board. To configure the software so that call control is accessible directly by the CT Access API, specify `isd0.tcp`.
BufferSize = 12000	Sets the size (in bytes) of the DSP voice buffer used to play and record files. For all AG ISDN installations, set `BufferSize` to `12000`. This reduces the size of the voice buffer, to allow enough space to accommodate AG ISDN. This change will not perceptively affect the quality of voice processing.
`#- BOARDS section -`
`Board 0`	Indicates the beginning of a description of a particular board. The number appearing here will be used to refer to the AG board in software.
`Address = 2C0`	This is the AG board's I/O address. Each board must have a unique address. The address is set here and on the AG board's face using switches. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`ClockRef = NET1`	Configures the clock. `NET1` causes the AG board to derive the local clock using the clock extracted from the T1 or E1 trunk. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`EnableMVIP = NO`	Enables or disables MVIP switching. When set to `NO`, MVIP switching is disabled. Note that certain switch connections are automatically made by default when `EnableMVIP=NO`, to route voice and signaling information to appropriate on-board resources. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`DigitalMode=PRI`	Determines how voice and signaling information is routed to and from the T1 or E1 trunk and processing resources. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`LineCode = B8ZS`	Specifies the trunk coding algorithm the AG board is to expect. The setting made here is Binary 8 Zero Suppression (the default for AG-T1 boards when `DigitalMode` is `PRI` or `RAW`). For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`FrameType = ESF`	Specifies the framing method the AG board is to expect. The setting made here configures the AG board for Extended SuperFrame for USA. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`End Board`	Indicates the end of the description of Board 0.

3.6.2 Sample ag.cfg for Two AG-E1 Boards With MVIP Connectivity

The following sample ag.cfg file describes two AG-E1 boards configured for ISDN (European variant). They are connected to one another over the MVIP bus. The application accesses ISDN services in ACU configuration (using the Messaging API). [AGBOARD] The AG configuration file must begin with this keyword. #- COMMON section - Any statements in this section of the file will apply to all boards listed in the Board x sections below. Interrupt = 12 The interrupt you specify here will be used by all AG boards in your system. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. DspFile = voice_a.dsp DspFile = dtmf_a.dsp DspFile = callp_a.dsp DspFile = tone_a.dsp These statements install DSP program files. They are installed on all boards listed in this file, since they appear in the COMMON section of this file. For this configuration, you will need at least the statements shown. You can add others also, if you wish. The _a following each file name indicates that these files are for A-law encoding. If your setup calls for µ-law encoding, remove the _a from each file name. RunFile = systn.run Defines the runfile to be used. It is board- and protocol-specific. For AG-E1 boards using ISDN, use systn.run. If you have more than one board, and the AG boards require different runfiles, include this line in a Board x section instead of the COMMON section. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. RunModule=isdneur.leo Defines the downloadable object module to be used. It is region- and protocol-specific. For ISDN in Europe, use isdneur.leo. TCP = nocc.tcp Indicates the TCP to load to the AG board. When using the ISDN Messaging API, specify nocc.tcp. This TCP file is distributed with CT Access. It sets up your system so all call control is handled by the host application instead of the TCP. BufferSize = 12000 Sets the size (in bytes) of the DSP voice buffer used to play and record files. For all AG ISDN installations, set BufferSize to 12000. This reduces the size of the voice buffer, to allow enough space to accommodate AG ISDN. This change will not perceptively affect the quality of voice processing. #- BOARDS section - Board 0 Indicates the beginning of a description of Board 0, the first AG-E1 board. The number appearing here will be used to refer to the AG board in software. Address = 2C0 This is the AG board's I/O address. Each board must have a unique address. The address is set here and on the AG board's face using switches. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. ClockRef = NET1 Configures the clock. NET1 causes the AG board to derive the local clock using the clock extracted from the E1 trunk. This AG-E1 board is the clock master, since its ClockRef is set to NET1, and the other board is set to MVIP. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. EnableMVIP = YES Enables or disables MVIP switching. When set to YES, MVIP switching is enabled. Note that when EnableMVIP=YES, no switch connections are automatically made to route voice and signaling information to appropriate on-board resources. Your application must make these connections. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. DigitalMode=PRI Determines how voice and signaling information is routed to and from the T1 or E1 trunk and processing resources. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. LineCode = HDB3 Defines the trunk line coding algorithm. The setting made here is high-density bipolar 3, which is the default setting for the AG-E1. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. End Board Indicates the end of the description for Board 0. Board 1 Indicates the beginning of a description of Board 1, the second AG-E1 board. The number appearing here will be used to refer to the AG-E1 board in software. Address = 22C0 This is the AG board's I/O address. Each board must have a unique address. The address is set here and on the AG board's face using switches. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. ClockRef = MVIP Configures the clock. MVIP causes the AG-E1 board to derive the local clock from the MVIP bus. Board 0 is driving the clock in this case, so Board 1 is the clock slave. The other AG-E1 is the clock master, since its ClockRef is set to NET1, and this board is set to MVIP. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual EnableMVIP = YES Enables or disables MVIP switching. When set to YES, MVIP switching is enabled. Note that when EnableMVIP=YES, no switch connections are automatically made to route voice and signaling information to appropriate on-board resources. Your application must make these connections. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. DigitalMode=PRI Determines how voice and signaling information is routed to and from the T1 or E1 trunk and processing resources. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. LineCode = HDB3 Defines the trunk line coding algorithm. The setting made here is "high-density bipolar 3", which is the default setting for the AG-E1. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. End Board Indicates the end of the description for Board 1.

`[AGBOARD]`	The AG configuration file must begin with this keyword.
`#- COMMON section -`	Any statements in this section of the file will apply to all boards listed in the `Board` x sections below.
`Interrupt = 12`	The interrupt you specify here will be used by all AG boards in your system. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`DspFile = voice_a.dsp` `DspFile = dtmf_a.dsp` `DspFile = callp_a.dsp` `DspFile = tone_a.dsp`	These statements install DSP program files. They are installed on all boards listed in this file, since they appear in the `COMMON` section of this file. For this configuration, you will need at least the statements shown. You can add others also, if you wish. The `_a` following each file name indicates that these files are for A-law encoding. If your setup calls for µ-law encoding, remove the `_a` from each file name.
`RunFile = systn.run`	Defines the runfile to be used. It is board- and protocol-specific. For AG-E1 boards using ISDN, use `systn.run`. If you have more than one board, and the AG boards require different runfiles, include this line in a `Board` x section instead of the `COMMON` section. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`RunModule=isdneur.leo`	Defines the downloadable object module to be used. It is region- and protocol-specific. For ISDN in Europe, use `isdneur.leo`.
`TCP = nocc.tcp`	Indicates the TCP to load to the AG board. When using the ISDN Messaging API, specify `nocc.tcp`. This TCP file is distributed with CT Access. It sets up your system so all call control is handled by the host application instead of the TCP.
BufferSize = 12000	Sets the size (in bytes) of the DSP voice buffer used to play and record files. For all AG ISDN installations, set `BufferSize` to `12000`. This reduces the size of the voice buffer, to allow enough space to accommodate AG ISDN. This change will not perceptively affect the quality of voice processing.
`#- BOARDS section -`
`Board 0`	Indicates the beginning of a description of Board 0, the first AG-E1 board. The number appearing here will be used to refer to the AG board in software.
`Address = 2C0`	This is the AG board's I/O address. Each board must have a unique address. The address is set here and on the AG board's face using switches. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`ClockRef = NET1`	Configures the clock. `NET1` causes the AG board to derive the local clock using the clock extracted from the E1 trunk. This AG-E1 board is the clock master, since its `ClockRef` is set to `NET1`, and the other board is set to `MVIP`. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`EnableMVIP = YES`	Enables or disables MVIP switching. When set to `YES`, MVIP switching is enabled. Note that when `EnableMVIP=YES`, no switch connections are automatically made to route voice and signaling information to appropriate on-board resources. Your application must make these connections. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`DigitalMode=PRI`	Determines how voice and signaling information is routed to and from the T1 or E1 trunk and processing resources. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`LineCode = HDB3`	Defines the trunk line coding algorithm. The setting made here is high-density bipolar 3, which is the default setting for the AG-E1. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`End Board`	Indicates the end of the description for Board 0.
`Board 1`	Indicates the beginning of a description of Board 1, the second AG-E1 board. The number appearing here will be used to refer to the AG-E1 board in software.
`Address = 22C0`	This is the AG board's I/O address. Each board must have a unique address. The address is set here and on the AG board's face using switches. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`ClockRef = MVIP`	Configures the clock. `MVIP` causes the AG-E1 board to derive the local clock from the MVIP bus. `Board 0` is driving the clock in this case, so `Board 1` is the clock slave. The other AG-E1 is the clock master, since its `ClockRef` is set to `NET1`, and this board is set to `MVIP.` For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual
`EnableMVIP = YES`	Enables or disables MVIP switching. When set to `YES`, MVIP switching is enabled. Note that when `EnableMVIP=YES`, no switch connections are automatically made to route voice and signaling information to appropriate on-board resources. Your application must make these connections. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`DigitalMode=PRI`	Determines how voice and signaling information is routed to and from the T1 or E1 trunk and processing resources. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`LineCode = HDB3`	Defines the trunk line coding algorithm. The setting made here is "high-density bipolar 3", which is the default setting for the AG-E1. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`End Board`	Indicates the end of the description for Board 1.

3.6.3 Sample ag.cfg for a Single AG Quad T Board

The following sample ag.cfg file describes a single AG Quad T configured for ISDN (USA variant), on a T1 trunk using extended superframe framing (ESF). The application is designed to access ISDN services in NCC configuration (using the Natural Call Control API). [AGBOARD] The AG configuration file must begin with this keyword. #- COMMON section - Any statements in this section of the file will apply to all boards listed in the Board x sections below. DspFile = voice.dsp DspFile = dtmf.dsp DspFile = callp.dsp DspFile = tone.dsp These statements install DSP program files. They are installed on all boards listed in this file, since they appear in the COMMON section of this file. For this configuration, you will need at least the statements shown. You can add others also, if you wish. These files are for µ-law encoding. If your setup calls for A-law encoding, add an _a to each file name. RunFile = sysqn.run Defines the runfile to be used. It is board- and protocol-specific. For AG Quad boards using ISDN, use sysqn.run. If you have more than one board, and the AG boards require different runfiles, include this line in a Board x section instead of the COMMON section. For more information, see the AG Quad Installation and Developer's Manual. RunModule=isdnusa.leo Defines the downloadable object module to be used. It is region- and protocol-specific. For ISDN in the US, use isdnusa.leo. TCP = isd0.tcp Indicates the TCP to load to the AG board. To configure the software so that call control is accessible directly by the CT Access API, specify isd0.tcp. BufferSize = 12000 Sets the size (in bytes) of the DSP voice buffer used to play and record files. For all AG ISDN installations, set BufferSize to 12000. This reduces the size of the voice buffer, to allow enough space to accommodate AG ISDN. This change will not perceptively affect the quality of voice processing. #- BOARDS section - Board 0 Indicates the beginning of a description of a particular board. The number appearing here will be used to refer to the AG board in software. Address = 2C0 This is the AG board's I/O address. Each board must have a unique address. The address is set here and on the AG board's face using switches. For more information, see the AG Quad Installation and Developer's Manual. PCIbus = 0 Defines the PCI bus location of the AG board. For more information, see the AG Quad Installation and Developer's Manual. PCIslot = 1 Defines the slot location of the AG board on the PCI bus. For more information, see the AG Quad Installation and Developer's Manual. CCMode = NONE Defines the call control resource allocation for the AG Quad. For more information, see the AG Quad Installation and Developer's Manual. EnableMVIP = NO Enables or disables MVIP switching. When set to NO, MVIP switching is disabled. Note that certain switch connections are automatically made by default when EnableMVIP=NO, to route voice and signaling information to appropriate on-board resources. For more information, see the AG Quad Installation and Developer's Manual. DigitalMode=PRI Determines how voice and signaling information is routed to and from the T1 or E1 trunk and processing resources. For more information, see the AG Quad Installation and Developer's Manual. LineCode = B8ZS Specifies the trunk coding algorithm the AG board is to expect. The setting made here is binary 8 zero suppression. For more information, see the AG Quad Installation and Developer's Manual. FrameType = ESF Specifies the framing method the AG board is to expect. The setting made here configures the AG board for Extended SuperFrame for USA. For more information, see the AG Quad Installation and Developer's Manual. End Board Indicates the end of the description of Board 0.

`[AGBOARD]`	The AG configuration file must begin with this keyword.
`#- COMMON section -`	Any statements in this section of the file will apply to all boards listed in the `Board` x sections below.
`DspFile = voice.dsp` `DspFile = dtmf.dsp` `DspFile = callp.dsp` `DspFile = tone.dsp`	These statements install DSP program files. They are installed on all boards listed in this file, since they appear in the `COMMON` section of this file. For this configuration, you will need at least the statements shown. You can add others also, if you wish. These files are for µ-law encoding. If your setup calls for A-law encoding, add an `_a` to each file name.
`RunFile = sysqn.run`	Defines the runfile to be used. It is board- and protocol-specific. For AG Quad boards using ISDN, use `sysqn.run`. If you have more than one board, and the AG boards require different runfiles, include this line in a `Board` x section instead of the `COMMON` section. For more information, see the AG Quad Installation and Developer's Manual.
`RunModule=isdnusa.leo`	Defines the downloadable object module to be used. It is region- and protocol-specific. For ISDN in the US, use `isdnusa.leo`.
`TCP = isd0.tcp`	Indicates the TCP to load to the AG board. To configure the software so that call control is accessible directly by the CT Access API, specify `isd0.tcp`.
BufferSize = 12000	Sets the size (in bytes) of the DSP voice buffer used to play and record files. For all AG ISDN installations, set `BufferSize` to `12000`. This reduces the size of the voice buffer, to allow enough space to accommodate AG ISDN. This change will not perceptively affect the quality of voice processing.
`#- BOARDS section -`
`Board 0`	Indicates the beginning of a description of a particular board. The number appearing here will be used to refer to the AG board in software.
`Address = 2C0`	This is the AG board's I/O address. Each board must have a unique address. The address is set here and on the AG board's face using switches. For more information, see the AG Quad Installation and Developer's Manual.
`PCIbus = 0`	Defines the PCI bus location of the AG board. For more information, see the AG Quad Installation and Developer's Manual.
`PCIslot = 1`	Defines the slot location of the AG board on the PCI bus. For more information, see the AG Quad Installation and Developer's Manual.
`CCMode = NONE`	Defines the call control resource allocation for the AG Quad. For more information, see the AG Quad Installation and Developer's Manual.
`EnableMVIP = NO`	Enables or disables MVIP switching. When set to `NO`, MVIP switching is disabled. Note that certain switch connections are automatically made by default when `EnableMVIP=NO`, to route voice and signaling information to appropriate on-board resources. For more information, see the AG Quad Installation and Developer's Manual.
`DigitalMode=PRI`	Determines how voice and signaling information is routed to and from the T1 or E1 trunk and processing resources. For more information, see the AG Quad Installation and Developer's Manual.
`LineCode = B8ZS`	Specifies the trunk coding algorithm the AG board is to expect. The setting made here is binary 8 zero suppression. For more information, see the AG Quad Installation and Developer's Manual.
`FrameType = ESF`	Specifies the framing method the AG board is to expect. The setting made here configures the AG board for Extended SuperFrame for USA. For more information, see the AG Quad Installation and Developer's Manual.
`End Board`	Indicates the end of the description of Board 0.

3.6.4 Sample ag.cfg for a Configuration Involving NFAS Groups

The following sample ag.cfg file describes three boards, each configured for ISDN (USA variant), on a T1 trunk using extended superframe framing (ESF). The application is designed to access ISDN services in NCC configuration (using the Natural Call Control API). Board 0 is an AG Quad T; the other boards are AG-T1 boards. They are connected via the MVIP bus.
There is one NFAS group, containing AG Quad T trunks 0, 1, and 2. Trunk 0 carries the D channel for this group. Trunk 3 on this board, and each of the trunks on the two AG-T1 boards carry their own D-channels. [AGBOARD] The AG configuration file must begin with this keyword. #- COMMON section - Any statements in this section of the file will apply to all boards listed in the Board x sections below. Interrupt = 12 The interrupt you specify here will be used by all AG boards in your system. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. DspFile = voice.dsp DspFile = dtmf.dsp DspFile = callp.dsp DspFile = tone.dsp These statements install DSP program files. They are installed on all boards listed in this file, since they appear in the COMMON section of this file. For this configuration, you will need at least the statements shown. You can add others also, if you wish. These files are for µ-law encoding. If your setup calls for A-law encoding, add an _a to each file name. RunModule=isdnusa.leo Defines the downloadable object module to be used. It is region- and protocol-specific. For ISDN in the US, use isdnusa.leo. TCP = isd0.tcp Indicates the TCP to load to the AG board. To configure the software so that call control is accessible directly by the CT Access API, specify isd0.tcp. BufferSize = 12000 Sets the size (in bytes) of the DSP voice buffer used to play and record files. For all AG ISDN installations, set BufferSize to 12000. This reduces the size of the voice buffer, to allow enough space to accommodate AG ISDN. This change will not perceptively affect the quality of voice processing. #- BOARDS section - Board 0 Indicates the beginning of a description of board 0, the AG Quad T. The number appearing here will be used to refer to this board in software. Address = 2C0 This is the AG board's I/O address. Each board must have a unique address. The address is set here and on the AG board's face using switches. For more information, see the AG Quad Installation and Developer's Manual. RunFile = sysqn.run Defines the runfile to be used. It is board- and protocol-specific. For AG Quad boards using ISDN, use sysqn.run. If you have more than one board, and the AG boards require different runfiles, include this line in a Board x section instead of the COMMON section. For more information, see the AG Quad Installation and Developer's Manual. PCIbus = 0 Defines the PCI bus location of the AG board. For more information, see the AG Quad Installation and Developer's Manual. PCIslot = 1 Defines the slot location of the AG board on the PCI bus. For more information, see the AG Quad Installation and Developer's Manual. CCMode = NONE Defines the call control resource allocation for the AG Quad. For more information, see the AG Quad Installation and Developer's Manual. EnableMVIP = YES Enables or disables MVIP switching. When set to YES, MVIP switching is enabled. Note that when EnableMVIP=YES, no switch connections are automatically made to route voice and signaling information to appropriate on-board resources. Your application must make these connections. For more information, see the AG Quad Installation and Developer's Manual. ClockRef = NET1 Configures the clock. NET1 causes this board to derive the local clock using the clock extracted from T1 trunk 1. For more information, see the AG Quad Installation and Developer's Manual. LineCode = B8ZS Specifies the trunk coding algorithm the AG board is to expect. The setting made here is binary 8 zero suppression. For more information, see the AG Quad Installation and Developer's Manual. FrameType = ESF Specifies the framing method the AG board is to expect. The setting made here configures the AG board for Extended SuperFrame for USA. For more information, see the AG Quad Installation and Developer's Manual. Trunk 0 Indicates the beginning of a description for trunk 0 on board 0. NFAS_Group=1 Assigns trunk 0 to NFAS group 1. NAI=0 Assigns NAI 0 to trunk 0. DigitalMode=PRI Determines how voice and signaling information is routed to and from the T1 or E1 trunk and processing resources. Since this trunk will carry the D channel for NFAS group 1, DigitalMode is set to PRI. For more information, see the AG Quad Installation and Developer's Manual. D_channel=YES Specifies that trunk 0 carry the D channel for NFAS group 1. End Trunk Indicates end of the set of trunk specific statements for trunk 0. Trunk 1 Indicates the beginning of a description for trunk 1 on board 0. NFAS_Group=1 Assigns trunk 1 to NFAS group 1. NAI=1 Assigns NAI 1 to trunk 1. DigitalMode=RAW Determines how voice and signaling information is routed to and from the T1 or E1 trunk and processing resources. Since trunk 0 will carry the D channel, DigitalMode is set to RAW for trunk 1. For more information, see the AG Quad Installation and Developer's Manual. End Trunk Indicates end of the set of trunk specific statements for trunk 1. Trunk 2 Indicates the beginning of a description for trunk 2 on board 0. NFAS_Group=1 Assigns trunk 2 to NFAS group 1. NAI=2 Assigns NAI 2 to trunk 2. DigitalMode=RAW Determines how voice and signaling information is routed to and from the T1 or E1 trunk and processing resources. Since trunk 0 will carry the D channel, DigitalMode is set to RAW for trunk 2. For more information, see the AG Quad Installation and Developer's Manual. End Trunk Indicates end of the set of trunk specific statements for trunk 2. Trunk 3 Indicates the beginning of a description for trunk 3 on board 0. NAI=3 Assigns NAI 3 to trunk 3. DigitalMode=PRI Determines how voice and signaling information is routed to and from the T1 or E1 trunk and processing resources. Since this trunk will carry the D channel for itself, DigitalMode is set to PRI. For more information, see the AG Quad Installation and Developer's Manual. End Trunk Indicates end of the set of trunk specific statements for trunk 3. End Board Indicates the end of the description of Board 0. Board 1 Indicates the beginning of a description of board 1, one of the AG-T1 boards. The number appearing here will be used to refer to this board in software. Address = 2D0 This is the AG-T1 board's I/O address. Each board must have a unique address. The address is set here and on the AG board's face using switches. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. ClockRef = MVIP Configures the clock. MVIP causes this board to derive the local clock from the MVIP bus. Board 0 is driving the clock in this case, so this board is a clock slave. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual EnableMVIP = YES Enables or disables MVIP switching. When set to YES, MVIP switching is enabled. Note that when EnableMVIP=YES, no switch connections are automatically made to route voice and signaling information to appropriate on-board resources. Your application must make these connections. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. RunFile = systn.run Defines the runfile to be used. It is board- and protocol-specific. For AG-T1 boards using ISDN, use systn.run. If you have more than one board, and the AG boards require different runfiles, include this line in a Board x section instead of the COMMON section. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. LineCode = B8ZS Specifies the trunk coding algorithm the AG board is to expect. The setting made here is Binary 8 Zero Suppression (the default for AG-T1 boards when DigitalMode is PRI or RAW). For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. FrameType = ESF Specifies the framing method the AG board is to expect. The setting made here configures the AG board for Extended SuperFrame for USA. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. NAI=4 Assigns NAI 4 to this trunk. DigitalMode=PRI Determines how voice and signaling information is routed to and from the T1 or E1 trunk and processing resources. Since this trunk will carry the D channel for itself, DigitalMode is set to PRI. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. End Board Indicates the end of the description of Board 1. Board 2 Indicates the beginning of a description of board 2, an AG-T1. The number appearing here will be used to refer to this board in software. Address = 2E0 This is this AG-T1 board's I/O address. Each board must have a unique address. The address is set here and on the AG board's face using switches. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. ClockRef = MVIP Configures the clock. MVIP causes this board to derive the local clock from the MVIP bus. Board 0 is driving the clock in this case, so this board is a clock slave. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual EnableMVIP = YES Enables or disables MVIP switching. When set to YES, MVIP switching is enabled. Note that when EnableMVIP=YES, no switch connections are automatically made to route voice and signaling information to appropriate on-board resources. Your application must make these connections. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. LineCode = B8ZS Specifies the trunk coding algorithm the AG board is to expect. The setting made here is Binary 8 Zero Suppression (the default for AG-T1 boards when DigitalMode is PRI or RAW). For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. RunFile = systn.run Defines the runfile to be used. It is board- and protocol-specific. For AG-T1 boards using ISDN, use systn.run. If you have more than one board, and the AG boards require different runfiles, include this line in a Board x section instead of the COMMON section. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. FrameType = ESF Specifies the framing method the AG board is to expect. The setting made here configures the AG board for Extended SuperFrame for USA. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. NAI=5 Assigns NAI 5 to this trunk. DigitalMode=PRI Determines how voice and signaling information is routed to and from the T1 or E1 trunk and processing resources. Since this trunk will carry the D channel for itself, DigitalMode is set to PRI. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. End Board Indicates the end of the description of Board 2.

`[AGBOARD]`	The AG configuration file must begin with this keyword.
`#- COMMON section -`	Any statements in this section of the file will apply to all boards listed in the `Board` x sections below.
`Interrupt = 12`	The interrupt you specify here will be used by all AG boards in your system. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`DspFile = voice.dsp` `DspFile = dtmf.dsp` `DspFile = callp.dsp` `DspFile = tone.dsp`	These statements install DSP program files. They are installed on all boards listed in this file, since they appear in the `COMMON` section of this file. For this configuration, you will need at least the statements shown. You can add others also, if you wish. These files are for µ-law encoding. If your setup calls for A-law encoding, add an `_a` to each file name.
`RunModule=isdnusa.leo`	Defines the downloadable object module to be used. It is region- and protocol-specific. For ISDN in the US, use `isdnusa.leo`.
`TCP = isd0.tcp`	Indicates the TCP to load to the AG board. To configure the software so that call control is accessible directly by the CT Access API, specify `isd0.tcp`.
BufferSize = 12000	Sets the size (in bytes) of the DSP voice buffer used to play and record files. For all AG ISDN installations, set `BufferSize` to `12000`. This reduces the size of the voice buffer, to allow enough space to accommodate AG ISDN. This change will not perceptively affect the quality of voice processing.
`#- BOARDS section -`
`Board 0`	Indicates the beginning of a description of board 0, the AG Quad T. The number appearing here will be used to refer to this board in software.
`Address = 2C0`	This is the AG board's I/O address. Each board must have a unique address. The address is set here and on the AG board's face using switches. For more information, see the AG Quad Installation and Developer's Manual.
`RunFile = sysqn.run`	Defines the runfile to be used. It is board- and protocol-specific. For AG Quad boards using ISDN, use `sysqn.run`. If you have more than one board, and the AG boards require different runfiles, include this line in a `Board` x section instead of the `COMMON` section. For more information, see the AG Quad Installation and Developer's Manual.
`PCIbus = 0`	Defines the PCI bus location of the AG board. For more information, see the AG Quad Installation and Developer's Manual.
`PCIslot = 1`	Defines the slot location of the AG board on the PCI bus. For more information, see the AG Quad Installation and Developer's Manual.
`CCMode = NONE`	Defines the call control resource allocation for the AG Quad. For more information, see the AG Quad Installation and Developer's Manual.
`EnableMVIP = YES`	Enables or disables MVIP switching. When set to `YES`, MVIP switching is enabled. Note that when `EnableMVIP=YES`, no switch connections are automatically made to route voice and signaling information to appropriate on-board resources. Your application must make these connections. For more information, see the AG Quad Installation and Developer's Manual.
`ClockRef = NET1`	Configures the clock. `NET1` causes this board to derive the local clock using the clock extracted from T1 trunk 1. For more information, see the AG Quad Installation and Developer's Manual.
`LineCode = B8ZS`	Specifies the trunk coding algorithm the AG board is to expect. The setting made here is binary 8 zero suppression. For more information, see the AG Quad Installation and Developer's Manual.
`FrameType = ESF`	Specifies the framing method the AG board is to expect. The setting made here configures the AG board for Extended SuperFrame for USA. For more information, see the AG Quad Installation and Developer's Manual.
`Trunk 0`	Indicates the beginning of a description for trunk 0 on board 0.
`NFAS_Group=1`	Assigns trunk 0 to NFAS group 1.
`NAI=0`	Assigns NAI 0 to trunk 0.
`DigitalMode=PRI`	Determines how voice and signaling information is routed to and from the T1 or E1 trunk and processing resources. Since this trunk will carry the D channel for NFAS group 1, `DigitalMode` is set to `PRI`. For more information, see the AG Quad Installation and Developer's Manual.
`D_channel=YES`	Specifies that trunk 0 carry the D channel for NFAS group 1.
`End Trunk`	Indicates end of the set of trunk specific statements for trunk 0.
`Trunk 1`	Indicates the beginning of a description for trunk 1 on board 0.
`NFAS_Group=1`	Assigns trunk 1 to NFAS group 1.
`NAI=1`	Assigns NAI 1 to trunk 1.
`DigitalMode=RAW`	Determines how voice and signaling information is routed to and from the T1 or E1 trunk and processing resources. Since trunk 0 will carry the D channel, `DigitalMode` is set to `RAW` for trunk 1. For more information, see the AG Quad Installation and Developer's Manual.
`End Trunk`	Indicates end of the set of trunk specific statements for trunk 1.
`Trunk 2`	Indicates the beginning of a description for trunk 2 on board 0.
`NFAS_Group=1`	Assigns trunk 2 to NFAS group 1.
`NAI=2`	Assigns NAI 2 to trunk 2.
`DigitalMode=RAW`	Determines how voice and signaling information is routed to and from the T1 or E1 trunk and processing resources. Since trunk 0 will carry the D channel, `DigitalMode` is set to `RAW` for trunk 2. For more information, see the AG Quad Installation and Developer's Manual.
`End Trunk`	Indicates end of the set of trunk specific statements for trunk 2.
`Trunk 3`	Indicates the beginning of a description for trunk 3 on board 0.
`NAI=3`	Assigns NAI 3 to trunk 3.
`DigitalMode=PRI`	Determines how voice and signaling information is routed to and from the T1 or E1 trunk and processing resources. Since this trunk will carry the D channel for itself, `DigitalMode` is set to `PRI`. For more information, see the AG Quad Installation and Developer's Manual.
`End Trunk`	Indicates end of the set of trunk specific statements for trunk 3.
`End Board`	Indicates the end of the description of Board 0.
`Board 1`	Indicates the beginning of a description of board 1, one of the AG-T1 boards. The number appearing here will be used to refer to this board in software.
`Address = 2D0`	This is the AG-T1 board's I/O address. Each board must have a unique address. The address is set here and on the AG board's face using switches. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`ClockRef = MVIP`	Configures the clock. `MVIP` causes this board to derive the local clock from the MVIP bus. `Board 0` is driving the clock in this case, so this board is a clock slave. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual
`EnableMVIP = YES`	Enables or disables MVIP switching. When set to `YES`, MVIP switching is enabled. Note that when `EnableMVIP=YES`, no switch connections are automatically made to route voice and signaling information to appropriate on-board resources. Your application must make these connections. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`RunFile = systn.run`	Defines the runfile to be used. It is board- and protocol-specific. For AG-T1 boards using ISDN, use `systn.run`. If you have more than one board, and the AG boards require different runfiles, include this line in a `Board` x section instead of the `COMMON` section. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`LineCode = B8ZS`	Specifies the trunk coding algorithm the AG board is to expect. The setting made here is Binary 8 Zero Suppression (the default for AG-T1 boards when `DigitalMode` is `PRI` or `RAW`). For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`FrameType = ESF`	Specifies the framing method the AG board is to expect. The setting made here configures the AG board for Extended SuperFrame for USA. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`NAI=4`	Assigns NAI 4 to this trunk.
`DigitalMode=PRI`	Determines how voice and signaling information is routed to and from the T1 or E1 trunk and processing resources. Since this trunk will carry the D channel for itself, `DigitalMode` is set to `PRI`. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`End Board`	Indicates the end of the description of Board 1.
`Board 2`	Indicates the beginning of a description of board 2, an AG-T1. The number appearing here will be used to refer to this board in software.
`Address = 2E0`	This is this AG-T1 board's I/O address. Each board must have a unique address. The address is set here and on the AG board's face using switches. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`ClockRef = MVIP`	Configures the clock. `MVIP` causes this board to derive the local clock from the MVIP bus. `Board 0` is driving the clock in this case, so this board is a clock slave. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual
`EnableMVIP = YES`	Enables or disables MVIP switching. When set to `YES`, MVIP switching is enabled. Note that when `EnableMVIP=YES`, no switch connections are automatically made to route voice and signaling information to appropriate on-board resources. Your application must make these connections. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`LineCode = B8ZS`	Specifies the trunk coding algorithm the AG board is to expect. The setting made here is Binary 8 Zero Suppression (the default for AG-T1 boards when `DigitalMode` is `PRI` or `RAW`). For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`RunFile = systn.run`	Defines the runfile to be used. It is board- and protocol-specific. For AG-T1 boards using ISDN, use `systn.run`. If you have more than one board, and the AG boards require different runfiles, include this line in a `Board` x section instead of the `COMMON` section. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`FrameType = ESF`	Specifies the framing method the AG board is to expect. The setting made here configures the AG board for Extended SuperFrame for USA. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`NAI=5`	Assigns NAI 5 to this trunk.
`DigitalMode=PRI`	Determines how voice and signaling information is routed to and from the T1 or E1 trunk and processing resources. Since this trunk will carry the D channel for itself, `DigitalMode` is set to `PRI`. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`End Board`	Indicates the end of the description of Board 2.

3.6.5 Sample ag.cfg for isdndemo NFAS Demonstration

The following sample ag.cfg file describes the configuration that the Messaging API demonstration program, isdndemo, is hard-coded to use when run in NFAS demonstration mode. (For more information about this program, see your AG ISDN Messaging API Developer's Reference Manual.) This sample file describes a three-board system. The trunks on board 0, an AG Dual T, are configured in an NFAS group. The trunks on boards 1 and 2, both AG-T1 boards, are configured together in another NFAS group. All three boards are configured for ISDN (USA variant), using extended superframe framing (ESF). They are not connected to one another over the MVIP bus. The application accesses ISDN services in ACU configuration (using the Messaging API). [AGBOARD] The AG configuration file must begin with this keyword. #- COMMON section - Any statements in this section of the file will apply to all boards listed in the Board x sections below. Interrupt = 12 The interrupt you specify here will be used by all AG boards in your system. For details, see the AG Quad Installation and Developer's Manual. DspFile = voice.dsp DspFile = dtmf.dsp DspFile = callp.dsp DspFile = tone.dsp These statements install DSP program files. They are installed on all boards listed in this file, since they appear in the COMMON section of this file. For this configuration, you will need at least the statements shown. You can add others also, if you wish. These files are for µ-law encoding. If your setup calls for A-law encoding, add an _a to each file name. RunModule=isdnusa.leo Defines the downloadable object module to be used. It is region- and protocol-specific. For ISDN in the U.S., use isdnusa.leo. TCP = nocc.tcp Indicates the TCP to load to the AG boards. When using the ISDN Messaging API, specify nocc.tcp. This TCP file is distributed with CT Access. It sets up your system so all call control is handled by the host application instead of the TCP. BufferSize = 12000 Sets the size (in bytes) of the DSP voice buffer used to play and record files. For all AG ISDN installations, set BufferSize to 12000. This reduces the size of the voice buffer, to allow enough space to accommodate AG ISDN. This change will not perceptively affect the quality of voice processing. LineCode = B8ZS Specifies the trunk coding algorithm the AG board is to expect. The setting made here is Binary 8 Zero Suppression (the default for AG-T1 and AG Quad T boards when DigitalMode is PRI or RAW). For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. FrameType = ESF Specifies the framing method the AG board is to expect. The setting made here configures the AG boards for Extended SuperFrame for USA. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. EnableMVIP = NO Enables or disables MVIP switching. When set to NO, MVIP switching is disabled. Note that certain switch connections are automatically made by default when EnableMVIP=NO, to route voice and signaling information to appropriate on-board resources. For more information, see the AG Quad Installation and Developer's Manual and the AG-T1 and AG-E1 Installation and Developer's Manual. #- BOARDS section - Board 0 Indicates the beginning of a description of Board 0, the AG Dual T board. The number appearing here will be used to refer to this AG board in software. Address = 2C0 This is the AG board's I/O address. Each board must have a unique address. The address is set here and on the AG board's face using switches. For more information, see the AG Quad Installation and Developer's Manual. ClockRef = OSC Configures the clock. OSC causes the AG board to drive the T1 transmit clock, using the on-board oscillator. One of the boards in the system must drive this clock, since the system is not connected to the public network. For more information, see the AG Quad Installation and Developer's Manual. RunFile = sysqn.run Defines the runfile to be used. It is board- and protocol-specific. For AG Quad boards using ISDN, use sysqn.run. For more information, see the AG Quad Installation and Developer's Manual. Trunk 0 Indicates the beginning of a description for trunk 0 on board 0. NFAS_Group=1 Assigns trunk 0 to NFAS group 1. NAI=0 Assigns NAI 0 to trunk 0. DigitalMode=PRI Determines how voice and signaling information is routed to and from the T1 or E1 trunk and processing resources. Since this trunk will carry the D channel for this NFAS group, DigitalMode is set to PRI. For more information, see the AG Quad Installation and Developer's Manual. D_channel=YES Specifies that trunk 0 carry the D channel for NFAS group 1. End Trunk Indicates end of the set of trunk specific statements for trunk 0. Trunk 1 Indicates the beginning of a description for trunk 1 on board 0. NFAS_Group=1 Assigns trunk 1 to NFAS group 1. NAI=1 Assigns NAI 1 to trunk 1. DigitalMode=RAW Determines how voice and signaling information is routed to and from the T1 or E1 trunk and processing resources. Since trunk 0 will carry the D channel, DigitalMode is set to RAW for trunk 1. For more information, see the AG Quad Installation and Developer's Manual. End Trunk Indicates end of the set of trunk specific statements for trunk 1. End Board Indicates the end of the description for Board 0. Board 1 Indicates the beginning of a description of Board 1, the first AG-T1 board. The number appearing here will be used to refer to this AG-T1 board in software. Address = 22C0 This is the AG board's I/O address. Each board must have a unique address. The address is set here and on the AG board's face using switches. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. ClockRef = NET1 Configures the clock. NET1 causes the AG board to derive the local clock using the clock extracted from the T1 trunk. In this configuration, this causes the AG-T1 board to derive its clock from the AG Quad T board. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. RunFile = systn.run Defines the runfile to be used. It is board- and protocol-specific. For AG-T1 boards using ISDN, use systn.run. If you have more than one board, and the AG boards require different runfiles, include this line in a Board x section instead of the COMMON section. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. NFAS_Group=2 Assigns this trunk to NFAS group 2. NAI=0 Assigns NAI 0 to this trunk. DigitalMode=PRI Determines how voice and signaling information is routed to and from the T1 or E1 trunk and processing resources. Since this trunk will carry the D channel for this NFAS group, DigitalMode is set to PRI. For more information, see the AG Quad Installation and Developer's Manual. D_channel=YES Specifies that this trunk carry the D channel for NFAS group 1. End Board Indicates the end of the description for Board 1. Board 2 Indicates the beginning of a description of Board 2, the second AG-T1 board. The number appearing here will be used to refer to this AG-T1 board in software. Address = 2E0 This is the AG board's I/O address. Each board must have a unique address. The address is set here and on the AG board's face using switches. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. ClockRef = NET1 Configures the clock. NET1 causes the AG board to derive the local clock using the clock extracted from the T1 trunk. In this configuration, this causes the AG-T1 board to derive its clock from the AG Quad T board. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. RunFile = systn.run Defines the runfile to be used. It is board- and protocol-specific. For AG-T1 boards using ISDN, use systn.run. If you have more than one board, and the AG boards require different runfiles, include this line in a Board x section instead of the COMMON section. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual. NFAS_Group=2 Assigns this trunk to NFAS group 2. NAI=1 Assigns NAI 1 to this trunk. DigitalMode=RAW Determines how voice and signaling information is routed to and from the T1 or E1 trunk and processing resources. Since the trunk on the other AG-T1 board will carry the D channel, DigitalMode is set to RAW for the trunk on this board. For more information, see the AG Quad Installation and Developer's Manual. End Board Indicates the end of the description for Board 1.

`[AGBOARD]`	The AG configuration file must begin with this keyword.
`#- COMMON section -`	Any statements in this section of the file will apply to all boards listed in the `Board` x sections below.
`Interrupt = 12`	The interrupt you specify here will be used by all AG boards in your system. For details, see the AG Quad Installation and Developer's Manual.
`DspFile = voice.dsp` `DspFile = dtmf.dsp` `DspFile = callp.dsp` `DspFile = tone.dsp`	These statements install DSP program files. They are installed on all boards listed in this file, since they appear in the `COMMON` section of this file. For this configuration, you will need at least the statements shown. You can add others also, if you wish. These files are for µ-law encoding. If your setup calls for A-law encoding, add an `_a` to each file name.
`RunModule=isdnusa.leo`	Defines the downloadable object module to be used. It is region- and protocol-specific. For ISDN in the U.S., use `isdnusa.leo`.
`TCP = nocc.tcp`	Indicates the TCP to load to the AG boards. When using the ISDN Messaging API, specify `nocc.tcp`. This TCP file is distributed with CT Access. It sets up your system so all call control is handled by the host application instead of the TCP.
BufferSize = 12000	Sets the size (in bytes) of the DSP voice buffer used to play and record files. For all AG ISDN installations, set `BufferSize` to `12000`. This reduces the size of the voice buffer, to allow enough space to accommodate AG ISDN. This change will not perceptively affect the quality of voice processing.
`LineCode = B8ZS`	Specifies the trunk coding algorithm the AG board is to expect. The setting made here is Binary 8 Zero Suppression (the default for AG-T1 and AG Quad T boards when `DigitalMode` is `PRI` or `RAW`). For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`FrameType = ESF`	Specifies the framing method the AG board is to expect. The setting made here configures the AG boards for Extended SuperFrame for USA. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`EnableMVIP = NO`	Enables or disables MVIP switching. When set to `NO`, MVIP switching is disabled. Note that certain switch connections are automatically made by default when `EnableMVIP=NO`, to route voice and signaling information to appropriate on-board resources. For more information, see the AG Quad Installation and Developer's Manual and the AG-T1 and AG-E1 Installation and Developer's Manual.
`#- BOARDS section -`
`Board 0`	Indicates the beginning of a description of Board 0, the AG Dual T board. The number appearing here will be used to refer to this AG board in software.
`Address = 2C0`	This is the AG board's I/O address. Each board must have a unique address. The address is set here and on the AG board's face using switches. For more information, see the AG Quad Installation and Developer's Manual.
`ClockRef = OSC`	Configures the clock. `OSC` causes the AG board to drive the T1 transmit clock, using the on-board oscillator. One of the boards in the system must drive this clock, since the system is not connected to the public network. For more information, see the AG Quad Installation and Developer's Manual.
`RunFile = sysqn.run`	Defines the runfile to be used. It is board- and protocol-specific. For AG Quad boards using ISDN, use `sysqn.run`. For more information, see the AG Quad Installation and Developer's Manual.
`Trunk 0`	Indicates the beginning of a description for trunk 0 on board 0.
`NFAS_Group=1`	Assigns trunk 0 to NFAS group 1.
`NAI=0`	Assigns NAI 0 to trunk 0.
`DigitalMode=PRI`	Determines how voice and signaling information is routed to and from the T1 or E1 trunk and processing resources. Since this trunk will carry the D channel for this NFAS group, `DigitalMode` is set to `PRI`. For more information, see the AG Quad Installation and Developer's Manual.
`D_channel=YES`	Specifies that trunk 0 carry the D channel for NFAS group 1.
`End Trunk`	Indicates end of the set of trunk specific statements for trunk 0.
`Trunk 1`	Indicates the beginning of a description for trunk 1 on board 0.
`NFAS_Group=1`	Assigns trunk 1 to NFAS group 1.
`NAI=1`	Assigns NAI 1 to trunk 1.
`DigitalMode=RAW`	Determines how voice and signaling information is routed to and from the T1 or E1 trunk and processing resources. Since trunk 0 will carry the D channel, `DigitalMode` is set to `RAW` for trunk 1. For more information, see the AG Quad Installation and Developer's Manual.
`End Trunk`	Indicates end of the set of trunk specific statements for trunk 1.
`End Board`	Indicates the end of the description for Board 0.
`Board 1`	Indicates the beginning of a description of Board 1, the first AG-T1 board. The number appearing here will be used to refer to this AG-T1 board in software.
`Address = 22C0`	This is the AG board's I/O address. Each board must have a unique address. The address is set here and on the AG board's face using switches. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`ClockRef = NET1`	Configures the clock. `NET1` causes the AG board to derive the local clock using the clock extracted from the T1 trunk. In this configuration, this causes the AG-T1 board to derive its clock from the AG Quad T board. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`RunFile = systn.run`	Defines the runfile to be used. It is board- and protocol-specific. For AG-T1 boards using ISDN, use `systn.run`. If you have more than one board, and the AG boards require different runfiles, include this line in a `Board` x section instead of the `COMMON` section. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`NFAS_Group=2`	Assigns this trunk to NFAS group 2.
`NAI=0`	Assigns NAI 0 to this trunk.
`DigitalMode=PRI`	Determines how voice and signaling information is routed to and from the T1 or E1 trunk and processing resources. Since this trunk will carry the D channel for this NFAS group, `DigitalMode` is set to `PRI`. For more information, see the AG Quad Installation and Developer's Manual.
`D_channel=YES`	Specifies that this trunk carry the D channel for NFAS group 1.
`End Board`	Indicates the end of the description for Board 1.
`Board 2`	Indicates the beginning of a description of Board 2, the second AG-T1 board. The number appearing here will be used to refer to this AG-T1 board in software.
`Address = 2E0`	This is the AG board's I/O address. Each board must have a unique address. The address is set here and on the AG board's face using switches. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`ClockRef = NET1`	Configures the clock. `NET1` causes the AG board to derive the local clock using the clock extracted from the T1 trunk. In this configuration, this causes the AG-T1 board to derive its clock from the AG Quad T board. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`RunFile = systn.run`	Defines the runfile to be used. It is board- and protocol-specific. For AG-T1 boards using ISDN, use `systn.run`. If you have more than one board, and the AG boards require different runfiles, include this line in a `Board` x section instead of the `COMMON` section. For more information, see the AG-T1 and AG-E1 Installation and Developer's Manual.
`NFAS_Group=2`	Assigns this trunk to NFAS group 2.
`NAI=1`	Assigns NAI 1 to this trunk.
`DigitalMode=RAW`	Determines how voice and signaling information is routed to and from the T1 or E1 trunk and processing resources. Since the trunk on the other AG-T1 board will carry the D channel, `DigitalMode` is set to `RAW` for the trunk on this board. For more information, see the AG Quad Installation and Developer's Manual.
`End Board`	Indicates the end of the description for Board 1.

(Page 1 of 1 in this chapter)

¹ Substitute dtmfe.dsp or dtmfe_a.dsp if you are using echo canceling.

tech_support@nmss.com

Chapter 3

Editing Your AG Configuration File

3.1 Introduction

3.2 Creating an AG Configuration File For Your Setup

3.3 Configuring On-Board Software

BufferSize

DspFile

RunModule

TCP

3.4 Configuring Data Routing

3.5 Setting Up NFAS Groups

3.5.1 About NFAS

3.5.2 Specifying NFAS Groups in ag.cfg

NFAS_Group

D_channel

NAI

3.6 Sample AG Configuration Files

3.6.1 Sample ag.cfg for a Single AG-T1 Board

3.6.2 Sample ag.cfg for Two AG-E1 Boards With MVIP Connectivity

3.6.3 Sample ag.cfg for a Single AG Quad T Board

3.6.4 Sample ag.cfg for a Configuration Involving NFAS Groups

3.6.5 Sample ag.cfg for isdndemo NFAS Demonstration