Introduction

Parameter Files

NCC Service Parameters

ADI Service Parameters

Loading Parameter Files

QX-Specific Parameter Information

DIAL 148

DTMF 150

DTMFDETECT 151

ENERGY 152

FSKRECEIVE 153

FSKSEND 154

PLACECALL 155

PLACECALL.callprog 156

PLAY 158

RECORD 159

START 160

START.callproggenerate 161

START.callctl 163

START.cleardown 164

START.dial 165

START.dtmfdet 167

START.echocancel 168

TONE 169

TONEDETECT 170

LPS 171

Enabling Caller ID

Enabling Caller ID (NCC Service)

Enabling Caller ID (ADI Service)

Introduction

This appendix:

• Summarizes the organization of parameters under the NCC and ADI services

• Lists QX-specific attributes for each parameter

Parameter Files

To adapt your configuration to a specific country or installation (for example, special PBXs or network), a default set of parameters is automatically loaded when initializing the ADI or NCC services on a QX board. Depending on the default country selected on your system, the QXLOAD environment variable contains the directory path of the country configuration files.

Most of the parameters specified in the parameter files must not be changed. However, you can add or modify some parameters (specifying digit handling, debugging operation, and miscellaneous options) based on the needs of your application.

WARNING:

Changing the default parameters in country-specific parameter files may affect the regulatory approvals in the target country, and can cause the application to malfunction.

NCC Service Parameters

The parameters in NCC service parameter files govern call control. The default NCC parameter file appears under the filename nccxxxx.par, where xxxx is the the name of the corresponding set of parameters (for example, nccstart for NCC.START parameters or nccxlps for NCC.X.ADI_LPS parameters).

Note: All the configuration files of the selected countries are stored at installation time in the destination directory (for example, c:\nms\qx\ctry\usa).

Parameters in these files fall into the following categories:

Category	Description
NCC.START	Used when a protocol is started with nccStartProtocol.
NCC.X.ADI_START	Used when a protocol is started with nccStartProtocol. (Specific to ADI implementation of NCC.)
NCC.X.ADI_PLACECALL	Used when a call is placed using nccPlaceCall or nccAutomaticTransfer.
NCC.X.ADI_PLACECALL.callprog	Subset of the NCC.X.ADI_PLACECALL parameters that affect call progress.
NCC.X.ADI_LPS	Parameter settings specific to the loop start protocol.

ADI Service Parameters

ADI service parameters govern:

• Dialing

• Voice playing and recording

• DTMF (and other tones) generation and detection

• Frequency Shift Key (FSK) data sending and receiving

In addition, there are parameters which govern call control, when performed using ADI service call control functions. ADI call control is deprecated by the NCC service. You should use the NCC service instead of ADI for call control. The parameters in the ADI call control categories have the same names as corresponding NCC service parameters.

The default parameter file appears under the filename adilps.par in the destination directories \nms\qx\ctry\xxx, where xxx is the three-character ISO 3166 code of the target country (for example, aut for Austria, deu for Germany, fra for France, gbr for United Kingdom, jpn for Japan, usa for United States).

Parameters in these files fall into the categories listed in the following table:

Category	Description
ADI.DIAL	Used when dialing is started with adiStartDial.
ADI.DTMF	Used with the adiStartDTMF function.
ADI.DTMFDETECT	Used with the adiStartDTMFDetector function.
ADI.ENERGY	Used with the adiStartEnergyDetector function.
ADI.FSKRECEIVE	Used with the adiStartReceivingFSK function.
ADI.FSKSEND	Used with the adiStartSendingFSK function.
ADI.PLACECALL	Used with a call is placed with the adiPlaceCall, adiPlaceSecondCall, or adiTransferCall functions1.
ADI.PLACECALL.callprog	Subset of the ADI.PLACECALL parameters that affect call progress.
ADI.PLAY	Used when audio is played with the adiStartPlaying, adiPlayFromMemory, or adiPlayAsync functions.
ADI.RECORD	Used when audio is recorded with the adiStartRecording, adiRecordToMemory, or adiRecordAsync functions.
ADI.START.callctl	Subset of the ADI.START parameters used with adiStartProtocol. These parameters govern basic call control.1
ADI.START.cleardown	Subset of the ADI.START parameters used with adiStartProtocol. These parameters govern call clearing.1
ADI.START.dial	Subset of the ADI.START parameters used with adiStartProtocol. These parameters govern dialing.1
ADI.START.dtmfdet	Subset of the ADI.START parameters used with adiStartProtocol. These parameters govern DTMF detection.1
ADI.START.echocancel	Subset of the ADI.START parameters used with adiStartProtocol. These parameters govern echo cancellation.1
ADI.TONE	Subset of the ADI.START parameters used with adiStartProtocol. These parameters govern tone generation.1
ADI.TONEDETECT	Subset of the ADI.START parameters used with adiStartProtocol. These parameters govern tone detection.1

1 ADI call control functions have been deprecated by NCC service functions. Whenever possible, you should use the NCC service for call control operations, instead of the ADI service call control functions. For details, refer to the NCC Service Developer's Reference Manual.

Loading Parameter Files

The country-specific parameters in the file follow the standard NMS API parameter syntax.

Depending on the needs of your application (use of global default parameters or local process parameters), you can load the parameters either with ctdaemon or with the ctaLoadParameterFile function.

Refer to CT Access Developer's Reference Manual for detailed information.

QX-Specific Parameter Information

Certain parameters operate slightly differently when used in QX applications. The following sections list the parameters in the files shipped with your QX software. Parameters are grouped by category. Listed with each category is:

• The complete category name

• Functions that depend on the parameter settings

• The manual in which the category is documented

• The parameters in the category, and any QX-specific information about each parameter