(Page 1 of 1 in this chapter)

Appendix B

ISDN TCP Parameters

Introduction

This appendix describes the parameters exposed to the user by AG ISDN for CT Access.
When you install AG ISDN software, parameter files are installed. The parameters in these files configure the TCP.
Some parameters determine the amplitude, frequency, length and pattern of the busy tone, ring tone and reorder tone. Since the tones differ from country to country, these parameters are country-specific, and should not be modified. Other parameters determine the service to request when placing an outbound call, the mode the TCP runs in, the channel direction, and the signal sending mask. These parameters can be modified to suit your application. Note: These files are useful only if you are configuring the AG ISDN software in NCC configuration (as documented in this manual). For more information, see Section 3.6.2, Starting a TCP on a CTA Context.
Two types of parameter files are installed with each package: A binary parameter file, containing the complete set of AG ISDN parameters, including parameters with country-specific values. This file is named isdcty.pf, where cty is the three character code of the target country. For example, the code for Australia is aus. Thus the version of this file for Australia is isdaus.pf. When you install a European or Asian package, you specify a "default" country. The binary file for the country you specify is duplicated and named adiisd.pf. This file defines the parameter category ADIISD. CT Access loads this file to the TCP when it is initialized. An ASCII parameter file, containing a list of AG ISDN parameters which the user can change without affecting the regulatory approvals in the target country. This file is named adiisd.par. To learn how to change parameters, see Section 3.6.1, Loading Parameters
For more information about how parameter files are installed, see the AG ISDN Installation Manual.

Country-Specific Parameters

Country-specific parameters are contained in the following files: Operating System Path and File Name Windows NT · \nms\agaccess\cfg\country\isd.pf · \nms\agaccess\cfg\country\isdxxx.pf (where xxx is the three-character code of the target country (aus for Australia, for example). UNIX · opt/nms/agaccess/cfg/country/isd.pf · opt/nms/agaccess/cfg/country/isdxxx.pf
To install these parameters, make sure the .pf file is in a directory that is contained in the list of directories specified by the AGLOAD environment variable. Then initialize the CT Access Parameter Management (PRM) service using ctaInitialize. This service will load the parameters in the file to CT Access. For more information, see your CT Access Developers Reference Manual.
When the TCP is initialized using adiStartProtocol, it is configured as described by the parameters.

WARNING:

Changing the values of most of the parameters in the country-specific .pf files may affect the regulatory approvals in the target country.
Modifiable country-specific AG ISDN parameters are:

Operating System	Path and File Name
Windows NT	· `\nms\agaccess\cfg\country\isd.pf` · `\nms\agaccess\cfg\country\isd`xxx`.pf` (where xxx is the three-character code of the target country (`aus` for Australia, for example).
UNIX	· `opt/nms/agaccess/cfg/country/isd.pf` · `opt/nms/agaccess/cfg/country/isd`xxx`.pf`

WARNING:	Changing the values of most of the parameters in the country-specific .pf files may affect the regulatory approvals in the target country.

Parameter

Description

Default

Units

`ADI.ISD.busyampl`

Determines the amplitude of the busy tone.

`45`

internal

`ADI.ISD.busytimeoff`

Sets the length of the "quiet" period of the busy tone.

`500`

ms

`ADI.ISD.busytimeon`

Sets the length of the "on" period in the busy tone, when playing busy.

`500`

ms

`ADI.ISD.flags`

Flags which determine when to send `PROCEEDING` or `ALERTING` messages:
1 Send a `CALL PROCEEDING` on incoming
messages
2 Automatically send `PROGRESS` when
adiAnswerCall is called.
3 Automatically send `ALERTING` when
adiAnswerCall is called.
4 Automatically send `PROGRESS` when
adiAcceptCall is called.
5 Automatically send `ALERTING` when
adiAcceptCall is called.
6 Automatically send `PROGRESS` when
adiRejectCall is called.
7 Automatically send `ALERTING` when
adiRejectCall is called.
Note: The settings of bits 6 and 7 are overridden when adiRejectCall is called with `ADI_REJECT_ FORCE_IMMEDIATE.`

`0x1121`

mask

`ADI.ISD.freqbusyhigh`

Sets the high frequency of the busy tone.

`620`

Hz

`ADI.ISD.freqbusylow`

Sets the low frequency of the busy tone.

`480`

Hz

`ADI.ISD.freqreorderhigh`

The high frequency of the reorder tone.

`620`

Hz

`ADI.ISD.freqreorderlow`

The low frequency of the reorder tone.

`480`

Hz

`ADI.ISD.freqringhigh`

Sets the high frequency for the ring when playing ring back.

`480`

Hz

`ADI.ISD.freqringlow`

Sets the low frequency for the ring when playing ring back.

`440`

Hz

`ADI.ISD.reordertimeoff`

Sets the length of the "off" period when playing a reorder tone.

`250`

ms

`ADI.ISD.reordertimeon`

Sets the length of the "on" period when playing a reorder tone.

`250`

ms

`ADI.ISD.ringampl`

Sets the amplitude of the ring tone.

`79`

internal

`ADI.ISD.ringofftime1`

Determines the length of the first quiet period in the ring back.

`3000`

ms

`ADI.ISD.ringofftime2`

Determines the length of the second quiet period in the ring back.

`0`

ms

`ADI.ISD.ringontime`

Sets the time for the ring in the ring cycle, when playing ring back.

`1000`

ms

Modifiable Parameters

Parameter	Description	Default	Units
`ADI.ISD.busyampl`	Determines the amplitude of the busy tone.	`45`	internal
`ADI.ISD.busytimeoff`	Sets the length of the "quiet" period of the busy tone.	`500`	ms
`ADI.ISD.busytimeon`	Sets the length of the "on" period in the busy tone, when playing busy.	`500`	ms
`ADI.ISD.flags`	Flags which determine when to send `PROCEEDING` or `ALERTING` messages: 1 Send a `CALL PROCEEDING` on incoming messages 2 Automatically send `PROGRESS` when adiAnswerCall is called. 3 Automatically send `ALERTING` when adiAnswerCall is called. 4 Automatically send `PROGRESS` when adiAcceptCall is called. 5 Automatically send `ALERTING` when adiAcceptCall is called. 6 Automatically send `PROGRESS` when adiRejectCall is called. 7 Automatically send `ALERTING` when adiRejectCall is called. Note: The settings of bits 6 and 7 are overridden when adiRejectCall is called with `ADI_REJECT_ FORCE_IMMEDIATE.`	`0x1121`	mask
`ADI.ISD.freqbusyhigh`	Sets the high frequency of the busy tone.	`620`	Hz
`ADI.ISD.freqbusylow`	Sets the low frequency of the busy tone.	`480`	Hz
`ADI.ISD.freqreorderhigh`	The high frequency of the reorder tone.	`620`	Hz
`ADI.ISD.freqreorderlow`	The low frequency of the reorder tone.	`480`	Hz
`ADI.ISD.freqringhigh`	Sets the high frequency for the ring when playing ring back.	`480`	Hz
`ADI.ISD.freqringlow`	Sets the low frequency for the ring when playing ring back.	`440`	Hz
`ADI.ISD.reordertimeoff`	Sets the length of the "off" period when playing a reorder tone.	`250`	ms
`ADI.ISD.reordertimeon`	Sets the length of the "on" period when playing a reorder tone.	`250`	ms
`ADI.ISD.ringampl`	Sets the amplitude of the ring tone.	`79`	internal
`ADI.ISD.ringofftime1`	Determines the length of the first quiet period in the ring back.	`3000`	ms
`ADI.ISD.ringofftime2`	Determines the length of the second quiet period in the ring back.	`0`	ms
`ADI.ISD.ringontime`	Sets the time for the ring in the ring cycle, when playing ring back.	`1000`	ms

Default values for modifiable AG ISDN parameters are stored in the binary parameter files. You can safely change the values of these parameters to suit your applications, without risking violation of regulatory approvals. To change these parameters, edit one of these ASCII parameter files: Operating System Path and File Name Windows NT \nms\agaccess\cfg\country\adiisd.par UNIX opt/nms/agaccess/cfg/country/adiisd.par
To load values specified in these files, your application must first initialize the CT Access PRM service so the binary parameter file is loaded. Then your application must:
1. Parse adiisd.par.
2. Call ctaSetParmByName for each parameter specified in the file, to set a new default value.
For an example of this, see the DemoLoadParameters function in the demonstration library supplied with CT Access.
Any parameter modification must take place before adiStartProtocol is called. When the TCP is initialized using adiStartProtocol, it is configured as described by the parameters.
An alternate method of loading parameter changes is to use the ctdaemon program to set the parameters system-wide. See the CT Access Developer's Reference Manual for more information.
The following is a list of the modifiable AG ISDN parameters: Parameter Description Default Units ADI.ISD.defaulttone Determines the tone to play when rejecting on timeout: 0: reorder 1: ringing 2: busy 2 integer ADI.ISD.direction Determines if the channel is inbound, outbound or bidirectional. For details, see Chapter 5. 0: bidirectional 1: inbound 2: outbound 0 integer ADI.ISD.exclusive Determines whether this TCP runs in Exclusive Mode or Non-Exclusive Mode. For details, see Chapter 5. 0: Non-Exclusive Mode 1: Exclusive Mode 1 mask ADI.ISD.networkslot Determines the timeslot to use for outbound calls. For details, see Chapter 5. 0xFF integer ADI.ISD.networkstream Determines the stream to use for outbound calls. For details, see Chapter 5. 0xFF integer ADI.ISD.waitforpctime Sets the maximum time to wait for application to respond for an incoming call, before playing a default tone. 10000 ms

Operating System	Path and File Name
Windows NT	`\nms\agaccess\cfg\country\adiisd.par`
UNIX	`opt/nms/agaccess/cfg/country/adiisd.par`

Parameter	Description	Default	Units
`ADI.ISD.defaulttone`	Determines the tone to play when rejecting on timeout: 0: reorder 1: ringing 2: busy	`2`	integer
`ADI.ISD.direction`	Determines if the channel is inbound, outbound or bidirectional. For details, see Chapter 5. 0: bidirectional 1: inbound 2: outbound	`0`	integer
`ADI.ISD.exclusive`	Determines whether this TCP runs in Exclusive Mode or Non-Exclusive Mode. For details, see Chapter 5. 0: Non-Exclusive Mode 1: Exclusive Mode	`1`	mask
`ADI.ISD.networkslot`	Determines the timeslot to use for outbound calls. For details, see Chapter 5.	`0xFF`	integer
`ADI.ISD.networkstream`	Determines the stream to use for outbound calls. For details, see Chapter 5.	`0xFF`	integer
`ADI.ISD.waitforpctime`	Sets the maximum time to wait for application to respond for an incoming call, before playing a default tone.	`10000`	ms

(Page 1 of 1 in this chapter)

tech_support@nmss.com