Changing parameter values

Complete the following steps to change parameter values in a .pf file:

Step

Action

1

Modify the value in the corresponding .par file.

2

Initialize the NaturalAccess PRM service so the binary parameter file is loaded.

3

Parse the .par file.

4

Do one of the following:

  • 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 NaturalAccess.)

  • Use the ctdaemon program to set the system-wide parameters. See the Dialogic® NaturalAccess™ Software Developer’s Manual  for more information.

  • Call ctaLoadParameterFile from within your application.

Parameter modification must take place before nccStartProtocol is called to start the TCP (as described in Starting a TCP on a context). When the function call is made, the TCP is programmed as specified by the parameters.

The following tables list the parameters in the nccxidsn.pf parameter file. Changing these parameters directly affects call control messages (for example, messages associated with NCC API functions). To change these parameters correctly, you must have knowledge of the ISDN specifications for the target country. See Using extended parameters for more information.

NCC.X.ADI_ISDN.ACCEPTCALL_EXT

Dependent function:

nccAcceptCall

Field name

Default

Units

Description

uui

""

char

User-to-user information (up to 132 characters).

cause

0

integer

Q.931 accept cause.

progressdescriptor

0

integer

Q.931 PROGRESS description in PROGRESS message.

NCC.X.ADI_ISDN.ANSWERCALL_EXT

Dependent function:

nccAnswerCall

Field name

Default

Units

Description

uui

""

char

User-to-user information (up to 132 characters).

NCC.X.ADI_ISDN.DISCONNECTCALL_EXT

Dependent function:

nccDisconnectCall

Field name

Default

Units

Description

uui

""

char

User-to-user information (up to 132 characters).

cause

0

integer

Q.931 disconnect cause.

pad

0

integer

Pad.

NCC.X.ADI_ISDN.PLACECALL_EXT

Dependent function:

nccPlaceCall

Field name

Default

Units

Description

uui

""

char

User-to-user information (up to 132 characters).

CALLEDNUM.plan

0

integer

Q.931 numbering plan of called address. (If supported. Possible values for this field are defined in isdnval.h.)

CALLEDNUM.type

0

integer

Q.931 numbering type of called address. (If supported. Possible values for this field are defined in isdnval.h.)

CALLINGNUM.plan

0

integer

Q.931 numbering plan of calling address. (If supported. Possible values for this field are defined in isdnval.h.)

CALLINGNUM.type

0

integer

Q.931 numbering type of calling address. (If supported. Possible values for this field are defined in isdnval.h.)

CALLINGNUM.screen

0

integer

Q.931 screening indicator. (If supported. Possible values for this field are defined in isdnval.h.)

CALLINGNUM.presentation

0

integer

Q.931 presentation indicator for calling address. (If supported. Possible values for this field are defined in isdnval.h.)

getcallid

0

integer

Set to 1 to request callid on call setup.

REDIRECTINGNUM.digits

""

char

The redirecting address. (If supported. Possible values for this field are defined in isdnval.h.)

REDIRECTINGNUM.pad

3

integer

Pad

REDIRECTINGNUM.plan

0

integer

Q.931 numbering plan of redirecting address. (If supported. Possible values for this field are defined in isdnval.h.)

REDIRECTINGNUM.type

0

integer

Q.931 numbering type of redirecting address. (If supported. Possible values for this field are defined in isdnval.h.)

REDIRECTINGNUM.screen

0

integer

Q.931 redirecting number screening indicator. (If supported. Possible values for this field are defined in isdnval.h.)

REDIRECTINGNUM.presentation

0

integer

Q.931 presentation indicator for redirecting address. (If supported. Possible values for this field are defined in isdnval.h.)

REDIRECTINGNUM.reason

0

integer

Q.931 reason for redirection. (If supported. Possible values for this field are defined in isdnval.h.)

REDIRECTINGNUM.pad1

0

integer

Pad1

service

0

integer

Q.931 service.

nsf_present

0

integer

Network-specific facilities (NSF):

1 = present
0 = not present

nsf_service_feature

0

integer

NSF service or feature:

1 = SERVICE
0 = FEATURE

nsf_facility_coding

0

integer

NSF service or feature ID.

NCC.X.ADI_ISDN.REJECTCALL_EXT

Dependent function:

nccRejectCall

Field name

Default

Units

Description

uui

""

char

User-to-user information (up to 132 characters).

cause

0

integer

Q.931 reject cause

pad

0

integer

Pad

NCC.X.ADI_ISDN.SENDDIGITS_EXT

Dependent function:

nccSendDigits

Field fame

Default

Units

Description

CALLEDNUM.plan

0

integer

Q.931 number plan of called address

CALLEDNUM.type

0

integer

Q.931 numbering type of called address

Note: Possible values for these fields are defined in isdnval.h.

NCC.X.ADI_ISDN.START_EXT

Dependent function:

nccStartProtocol

Field name

Default

Units

Description

exclusive

1

integer

Determines if this TCP runs in exclusive mode or non-exclusive mode. For details, see B channel assignment overview.

0 - Non-exclusive mode
1 - Exclusive mode

direction

0

integer

Determines if the channel is inbound, outbound, or bidirectional. See B channel assignment overview.

0 - bidirectional (default)
1 - inbound
2 - outbound

networkstream

0xFFFF

integer

Determines the stream to use for outbound calls. See B channel assignment overview.

networkslot

0xFFFF

integer

Determines the timeslot to use for outbound calls. See B channel assignment overview.

defaulttone

2

integer

Determines the tone to play when rejecting on timeout:

0 - reorder
1 - ringing
2 - busy

startCP

1

integer

If this parameter is set to 1, the TCP starts call progress when it receives a SETUP ACKNOWLEDGED, PROCEEDING, or ALERTING message, which contains a progress descriptor field or PROGRESS message, whichever comes first. If none of the listed messages arrive, call progress is started when CONNECTION CONFIRMATION is received, if the application does not want to connect on signal.

If this parameter is set to 2, the TCP starts call progress on the first call establishment message (SETUP ACKNOWLEDGMENT, PROCEEDING, ALERTING, or PROGRESS) received back from the network, regardless of the progress descriptor.

If this parameter is set to 0, call progress is not started.

flags

0x1121

mask

Flags (defined in nccxisdn.h) that determine when to send PROGRESS, CALL PROCEEDING, or ALERTING messages. The values can be ORed for cumulative effect. See Flags field settings.

blockrejectmode

0

integer

How to reject calls when the channel is blocked with BLOCK_REJECTALL mode:

0 - reject immediate
1 - play busy tone

blockwaittime

3000

ms

Sets the maximum time to wait for the application to respond for an incoming call, before playing a default tone.

ISDNeventmask

0x0000

mask

ISDN informational event mask (defined in nccxisdn.h).

ISDN_REPORT_PROGRESS indicates that ISDN progress messages are being received.

For more information about how parameter files are installed, see the Dialogic® NaturalAccess™ ISDN Software Installation Manual.

Flags field settings

Flags (defined in nccxisdn.h) that determine when to send PROGRESS, CALL PROCEEDING, or ALERTING messages. The values can be ORed for cumulative effect.

This bit...

Causes protocol to send...

PROCEEDING_MASK

PROCEEDING on incoming call

PROGRESS_MASK_ANSWER

PROGRESS on nccAnswerCall

ALERTING_MASK_ANSWER

ALERT on nccAnswerCall

PROCEEDING_MASK_ANSWER

PROCEEDING on nccAnswerCall

PROGRESS_MASK_ACCEPT

PROGRESS on nccAcceptCall

ALERTING_MASK_ACCEPT

ALERT on nccAcceptCall

PROCEEDING_MASK_ACCEPT

PROCEEDING on nccAcceptCall

PROGRESS_MASK_REJECT

PROGRESS on nccRejectCall

ALERTING_MASK_REJECT

ALERT on nccRejectCall

PROCEEDING_MASK_REJECT

PROCEEDING on nccRejectCall