(Page 11 of 12 in this chapter)


3.10 Protocol-Specific Parameters

This section describes protocol-specific parameters that have a direct effect on the call control events and functions. For a complete list of AG Access parameters, refer to the AG Access Function Reference Manual.

3.10.1 Loop-Start Parameters

Loop-start supports transferring calls with a parameterized digit string. You can specify the string to be dialed when adiTransferCall is called from the application. This allows you to specify extensions when transferring to an outside line from a PBX.

The following loop-start parameters are contained in the ADI_LPS_PARMS structure:

Parameter

Description

cidsupport

Indicates whether caller ID is enabled.

connstring

Dial string for reconnect.

nodialtoneaction

Defines behavior when no dial tone is present.

When placing calls on loop-start lines, loop-start glare is detected by the absence of dial tone which is handled in the following manner:

- If nodialtoneaction is set to ADI_LPS_NO_DT_PROCEED, AG Access begins dialing and generates an ADIEVN_PLACING_CALL event.

- If nodialtoneaction is set to ADI_LPS_NO_DT_DISCONNECT, AG Access hangs up and generates an ADIEVN_CALL_DISCONNECTED event.

- If nodialtoneaction is set to ADI_LPS_NO_DT_OFFERCALL, AG Access generates an ADIEVN_INCOMING_CALL event. If the application chooses to answer (adiAnswerCall), the call is immediately connected.

- If the application rejects the call (adiRejectCall), AG Access hangs up the line and generates an ADIEVN_CALL_RELEASED event.

numrings

Configures when the incoming call event for loop-start protocols is generated. If this parameter is 0, the event is generated on the leading edge of the first ring tone. Otherwise, the event is generated on the trailing edge of the ring specified by numrings.

Note: If caller ID is enabled, there will always be at least one ring before the incoming call is reported.

xferstring

Prefix of feature code for transfer operation. The default is the string "!;". It generates a flash hook and then waits for a dialtone.

xfersupport

Indicates whether call transfer functions are supported.

3.10.2 Wink-Start and DID Parameters

The following wink-start and DID parameters are contained in the ADI_WNK_PARMS and ADI_DID_PARMS parameter structures, respectively.

Parameter

Description

waitforPCtime

Defines the maximum time during which the application can wait to accept or reject an incoming call. Failure to respond in this period causes AG Access to automatically reject the call. The call will be rejected in the manner specified by the defaulttone parameter.

defaulttone

Dictates the tone played when AG Access rejects incoming calls due to application response timeout, as follows:

defaulttone
0
1
2

Tone Played
Reorder (fast busy)
Ringing
Busy

waitfordigitstime

The maximum time to wait for each incoming digit after the first one.

numdigits

The expected number of digits for incoming calls.

Wink-start is able to accept calls with digit strings of varying length. If an incoming call is detected with fewer digits than what is specified in the adi.wnk.numdigits parameter, ADIEVN_INCOMING_CALL will be sent up to the host after the wait-for-digits timer (adi.wnk.waitfordigitstime) has expired. At least one digit must be detected for this to occur.

The application must then parse the digit string and decide whether or not to accept the call. Calls with a number of digits equal to or greater than the number in adi.wnk.numdigits behave normally.



(Page 11 of 12 in this chapter)


tech_support@nmss.com
Copyright © 1997, Natural MicroSystems, Inc. All rights reserved.