[asr]

defaultengine

ASR Engine Default

The engine specified here will be used to load a default engine when using the log metrics to ASR configuration. An application using a different name should override this using the Request URI configuration or asrengine property.

Valid values

The engine name must be a string.

Default value

default

Takes effect Immediately/session

delay_for_dtmf

ASR Delay for DTMF

The amount of delay, in milliseconds, for starting the next ASR recognition after the last DTMF input from the previous field.

Valid values

asr.delay_for_dtmf should be an integer that is greater than or equal to 0 and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

Default value

250

Takes effect Immediately

load_once_per_call

ASR Load once per call

When this parameter is set to Enable, there will be only one VRM session for the entire call which could have multiple recognition sessions. If the parameter value is set to Disable, a VRM session is opened for each recognition request. The VRM session is closed when the recognition request is completed successfully or unsuccessfully (such as no match). As a result, there could be multiple VRM sessions in a call. Having multiple VRM sessions in a call could make the ASR server license usage more efficient. However, this configuration could have the following consequences:
1. There will be longer delays on speech barge in.
2. The save utterance data could be deleted by some recognizer servers after each VRM session. In that case, the VoiceXML application cannot refer to the saved utterance file after the recognition session.

Valid values

  • 1
  • 0

Default value

1

Takes effect Immediately/session

log_metrics_to_asr

ASR Log Metrics to ASR

This parameter is only for ScanSoft Open Speech Recognizer. When set to Enable the MCP will log certain call metrics including Call Starts and Call Ends to the OSR server for the purposes of tuning

Valid values

  • 0
  • 1

Default value

0

Takes effect Immediately/session

reserve

ASR Resource Reservation

When set to true, the MCP will attempt to reserve an ASR resource prior to accepting the call. This resource will be available until an explicit release of the resource, or until the end of the call. The call will be rejected if the resource is not successfully reserved.

Valid values

  • false
  • true

Default value

false

Takes effect Immediately/session

[calllog]

directory

Full Call Recording Directory

Specifies the default full call recording file path if it is not specified in the VXML page.

Valid values

Path to the full call recording directory

Default value

$InstallationRoot$/callrec/

Takes effect At start/restart

[callmgr]

Dynamic Loading of Line Managers and Media Transports
The Media Control Platform can dynamically load line manager and media transport modules at startup. The following configuration parameters enable the SIP line manager, and MPC media transport module. The configuration parameters can be modified to load a different combination of line managers and media transports. These parameters should be already set properly by the installation process.

fips_enabled

FIPS Mode Enabled

Specifies whether to enable FIPS mode in MCP. When FIPS mode is enabled, only FIPS 140-2 approved ciphers and algorithms can be used in SSL connections.

Valid values

  • true
  • false

Default value

false

Takes effect At start/restart

hrtimerresolution

High Resolution Timer

Sets the resolution of the high resolution system timer in msec.

Valid values

A valid resolution should be an integer from 1 to 20 inclusive

Default value

4

Takes effect At start/restart

silent_shutdown

Silent Shutdown

Specifies whether or not to shutdown silently, i.e. no core or logs during shutdown. This parameter works only on Linux.

Valid values

  • 0
  • 1

Default value

0

Takes effect Immediately

usehrtimerforregulartimer

High Resolution Timer Used for All Timers

Specifies whether or not the high resolution timer should be used for all timers. This is a Windows only configuration. Enabling this configuration will improve the regularity of media transmissions from a conference, but overall capacity of the MCP will be affected.

Valid values

  • true
  • false

Default value

false

Takes effect At start/restart

[conference]

Conferencing Configuration Parameters

active_speaker_update_time

Conference Active Speaker Update Time

The conference active speaker is updated periodically to the currently loudest input. The input with the highest average audio level during the update period is selected as the loudest. This parameter sets the time period (in msec) for this function. The default value is 2000.

Valid values

conference.active_speaker_update_time must be a non-negative integer and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

Default value

2000

Takes effect At start/restart

callrec_default_type

Conference Recording Default Type (MSML Only)

The default recording type for MSML conference recording. Example formats: audio/wav, audio/wav;codec=ulaw . If left empty, the MCP will use wave file with the default platform codec.

Default value

(blank)

Takes effect Immediately/session

confdir

Default Conference Direction

Default conference direction of the participant.

Valid values

  • 0
  • 1
  • 2

Default value

2

Takes effect At start/restart

gain_control_enabled

Conference Gain Control Enabled

When gain control is enabled, various configurations used to set gain levels will be respected fully. When gain control is disabled, gains of 0 will result in muted streams, while gains greater than 0, will result in streams that remain at their current level.

Valid values

  • true
  • false

Default value

true

Takes effect At start/restart

highest_input

Conference Highest Input

This value will determined the number of highest inputs used for mixing output. If 0 is set, all inputs will be used.

Valid values

The number must be a non-negative integer and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

Default value

3

Takes effect At start/restart

initial_gain

Conference Initial Gain

Gain in db when talking to the conference.

Valid values

The number must be a non-negative integer and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

Default value

0

Takes effect At start/restart

novideoimage

Conference No Video Image File

Specifies the jpeg file to use for the image to be displayed in video mixed conferences for participants that do not provide video input. Setting this parameter to blank will disable the no video image feature. This parameter is only active when the conference.video_output_type parameter is set to "mixed".

The file must be in the installation root video directory or a sub-directory of this.

A directory can be specified (for example "images/filename.jpg"), and the path will be taken relative to the installation root video directory."

Default value

Genesys_Logo.jpg

Takes effect Immediately/session

record_chan1source

Conference Call Recording Channel 1 Source

Specifies the source to use for Call Recording channel 1. Setting this to recorddnsays selects the audio input of the record dn (or the first conference participant), setting to otherdnhears selects the conference audio output of the other dn (or second conference participant). The primary purpose is to control whether the repeating conference tone is included in the recorded audio of the record dn. If set to recorddnsays the tone will not be recorded, setting to otherdnhears will cause the tone to be recorded. The default valuse is recorddnsays.

Valid values

  • recorddnsays
  • otherdnhears

Default value

recorddnsays

Takes effect Immediately/session

record_chan2source

Conference Call Recording Channel 2 Source

Specifies the source to use for Call Recording channel 2. Setting this to otherdnsays selects the audio input of the other dn (or the second conference participant), setting to recordndhears selects the conference audio output of the record dn (or the first conference participant). The primary purpose is to control whether the repeating conference tone is included in the recorded audio of the other dn. If set to otherdnsays the tone will not be recorded, setting to recorddnhears will cause the tone to be recorded. The default valuse is otherdnsays.

Valid values

  • otherddnsays
  • recorddnhears

Default value

otherdnsays

Takes effect Immediately/session

record_otherdnhearstone

Conference Call Recording Other DN Hears Tone

Specifies whether the other dn (or the second conference participant), hears the repeating tone that indicates the call is being recorded. The default value is Yes.

Valid values

  • 0
  • 1

Default value

1

Takes effect Immediately/session

record_recorddnhearstone

Conference Call Recording Record DN Hears Tone

Specifies whether the record dn (or the first conference participant), hears the repeating tone that indicates the call is being recorded. The default value is Yes.

Valid values

  • 0
  • 1

Default value

1

Takes effect Immediately/session

silence_fill

Conference Silence Fill

Whether to silence fill the output when no data.

Valid values

  • 0
  • 1

Default value

0

Takes effect At start/restart

suppress_silence

Conference Suppress Silence

Whether to suppress silence on input.

Valid values

  • 0
  • 1

Default value

0

Takes effect At start/restart

threadedoutputs

Conference Threaded Outputs

Enable threaded transcoding to conference outputs. Enabling this option can result in conferences that make better use of the available processors on a system.

Valid values

  • true
  • false

Default value

false

Takes effect At start/restart

video_mixer_layouts

Conference Video Mixer Layouts

Specifies the layouts that will be used by the conference video mixer when the layouts to use are not specified by the application. This parameter is only active when the conference.video_output_type parameter is set to "mixed".

This parameter has the following format:
n1,layout1|n2,layout2|n3,layout3...
where each "n,layout" pair, "layout" specifies the layout name to use when the number of conference participants is greater than or equal to "n" and less than the "n" value of any other pair.

The following layouts as described in ITEF document "draft-ietf-mediactrl-mixer-control-package" are supported:
single-view: displays the video from one participant
dual-view: displays two participants horizontally arranged
dual-view-crop: same as dual-view but video streams are cropped so as to fully fill the frame
dual-view-2x1: displays participants vertically arranged
dual-view-2x1-crop: same as dual-view-2x1 but video streams are cropped so as to fully fill the frame
quad-view: displays four participants in a 2x2 grid
multiple-5x1: displays five participants arranged along the right side and bottom, with the current active speaker displayed in a larger frame at the top left
multiple-3x3: displays 9 participants in a 3x3 grid
multiple-4x4: displays 16 participants in a 4x4 grid

For example: "1,dual-view|3,multiple-5x1", would select the dual-view layout when the number of participants is less than 3, and the multiple-5x1 layout for 3 or more participants.

If this parameter is not included or set to "", the following default value will be used:
1,dual-view|3,quad-view|5,multiple-5x1|6,multiple-3x3|10,multiple-4x4

Default value

1,dual-view|3,quad-view|5,multiple-5x1|6,multiple-3x3|10,multiple-4x4

Takes effect Immediately/session

video_output_algorithm

Conference Video Output Algorithm

Specifies how the conference chooses the video output. Note if "Select the first conference participant" is selected, the first participant should provide video input otherwise no video will be seen for the conference. This parameter is only active when conference.video_output_type is set to single.

Valid values

  • confrole
  • fixed
  • loudest
  • none

Default value

confrole

Takes effect At start/restart

video_output_type

Conference Video Output Type

Specifies the type of video output for conferences. If set to "single", a single stream output is enabled, where the video stream from one conference participant is sent to each conference participant. If set to "mixed", a video mixed output is enabled, where the video streams from multiple conference participants are combined into one frame and sent to each participant.

Note, if this parameter is set to "mixed" the conference.video_output_algorithm configuration parameter will not be used. Similarly, the control of video_output_algorithm by the application will be ignored.

Valid values

  • single
  • mixed

Default value

single

Takes effect Immediately/session

[cpa]

gateway.events

Supported Gateway CPA Events

The supported Gateway CPA events. The ones listed here will be requested to the Gateway.

Valid values

  • AMD
  • CPT
  • FAX
  • PVD
  • PTT

Default value

AMD CPT FAX PVD

Takes effect Immediately/session

outbound.method

The CPA method used for outbound calls

This configuration option controls the Call Progress Analysis method used when making outbound calls. If 'NONE' is selected, no methods will be supported.

Valid values

  • AUDIOCODES
  • PSTNC
  • NATIVE
  • NONE

Default value

NONE

Takes effect Immediately/session

outbound.native.ignoreconnectevent

Outbound calls with native CPA – ignore call connect event

When native CPA is used for outbound calls, this option specifies whether the CPA algorithm should ignore or handle the call connect event. If not ignored, the native CPA algorithm will switch to the postconnect state when received the call connect event. This option can be used for fine tuning the CPA detection algorithm to improve accuracy and applies only if the outbound.native.initialstate option is set to preconnect.

Valid values

  • true
  • false

Default value

false

Takes effect Immediately/session

outbound.native.initialstate

Outbound calls with native CPA - initial state

When native CPA is used for outbound calls, this option specifies the initial CPA state. preconnect - detection will start as soon as the call is initiated, and detection of preconnect and postconnect events will be enabled. postconnect - detection will start when the call is connected, and only detection of postconnect events will be enabled.

Valid values

  • preconnect
  • postconnect

Default value

preconnect

Takes effect Immediately/session

[email]

fromAddr

Maintainer Email From Address

On Windows, this is the "From" header for maintainer e-mails. On Linux, it appears as the first line of the message body.

Default value

nobody@example.com

Takes effect At start/restart

smtpAddr

Maintainer Email SMTP Address

SMTP server address for sending maintainer e-mails

Default value

localhost

Takes effect At start/restart

[ems]

dc.default.logfilter

Default Upstream Log Filter for Data Collection Sink

Specifies the filter for logs to be delivered "upstream" to the Reporting Server for Call Events reporting. The format is 'levels|moduleIDs|specifierIDs' (repeated if necessary). The values between the pipes can be in the format: 'm-n,o,p' (ie "0-4, 5,6"). The wildcard character '*' can also be used to indicate all valid numbers. Example: '*|*|*' indicates that all log messages should be sent to the sink. Alternatively, '0,1|0-10|*|4|*|*' inidcates that CRITICAL(0) and ERROR(1) level messages with module IDs in the range 0-10 wil be sent to the sink; and all INFO(4) level messages will be sent as well.

Valid values

Pipe delimited ranges for log levels, module IDs and specifier IDs. Ranges can be comma separated integers or range of integers or '*'.

Default value

0-2|*|*

Takes effect At start/restart

dc.default.metricsfilter

Default Metrics Filter for Data Collection Sink

Specifies the default filter for metrics to be delivered "upstream" to the Reporting Server for Call Events reporting. '*' indicates that all metrics will be sent to the sink. Alternatively, '5-10,50-55,70,71' indicates that metrics with IDs 5,6,7,8,9,10,50,51,52,53,54,55,70 and 71 will be sent to the Reporting Server. This filter will be used unless the default has been overridden in the tenant or IVR Application profile to which the given call has been associated.

Valid values

Comma separated list of metric values or ranges. A metric value must be between 0 and 141 inclusive. The values '*' and blank are also allowed.

Default value

0-16,18,25,35,36,41,52-55,74,128,136-141

Takes effect At start/restart

dc.enableSQA

SQA Enable Flag

This flag determines if the Data Collection Sink is configured to perform Service Quality analysis.

Valid values

  • true
  • false

Default value

true

Takes effect At start/restart

dc.servicequality.AudioGap.threshold

Audio Gap Latency Threshold

This parameter indicates the largest acceptable audio gap (in ms) that the platform can have while playing back audio to the user.

Valid values

An integer greater than 0.

Default value

2000

Takes effect At start/restart

dc.servicequality.CallAnswer.threshold

Call Answer Latency Threshold

This parameter indicates the maximum acceptable time (in ms) that the platform can take to answer a call.

Valid values

An integer greater than 0.

Default value

3000

Takes effect At start/restart

dc.servicequality.CallReject.threshold

Call Reject Latency Threshold

This parameter indicates the maximum acceptable time (in ms) that the platform can take to reject a call.

Valid values

An integer greater than 0.

Default value

3000

Takes effect At start/restart

dc.servicequality.CumulativeResponse.threshold

Cumulative Resposne Latency Threshold

This parameter indicates the maximum acceptable time (in ms) that the platform can take to play a prompt following user interaction.

Valid values

An integer greater than 0.

Default value

4000

Takes effect At start/restart

dc.servicequality.FirstPromptInbound.threshold

First Prompt Inbound Latency Threshold

This parameter indicates the maximum acceptable time (in ms) that the platform can take to play the first prompt on an inbound call.

Valid values

An integer greater than 0.

Default value

3000

Takes effect At start/restart

dc.servicequality.FirstPromptOutbound.threshold

First Prompt Outbound Latency Threshold

This parameter indicates the maximum acceptable time (in ms) that the platform can take to play the first prompt on an outbound call.

Valid values

An integer greater than 0.

Default value

3000

Takes effect At start/restart

dc.servicequality.InboundRejectNoFailureCodes

This parameter specifies incall_reject reason codes which should not be flagged as call failures.

Valid values

This is a '|' delimited list.

Default value

decline

Takes effect At start/restart

dc.servicequality.InterPrompt.threshold

Inter Prompt Latency Threshold

This parameter indicates the maximum acceptable time (in ms) that the platform can take to play a prompt after a previous prompt when no user interaction has taken place inbetween the 2 prompts.

Valid values

An integer greater than 0.

Default value

4000

Takes effect At start/restart

dc.servicequality.OutboundRejectNoFailureCodes

This parameter specifies outcall_reject reason codes which should not be flagged as call failures.

Valid values

This is a '|' delimited list.

Default value

busy|decline|fax|noanswer|hangup

logconfig.DATAC

Data Collection Sink Log Filter

Controls the log messages that are sent to the Data Collection sink. The format is 'levels|moduleIDs|specifierIDs' (repeated if necessary). The values between the pipes can be in the format: 'm-n,o,p' (ie "0-4, 5,6"). The wildcard character '*' can also be used to indicate all valid numbers. Example: '*|*|*' indicates that all log messages should be sent to the sink. Alternatively, '0,1|0-10|*|4|*|*' inidcates that CRITICAL(0) and ERROR(1) level messages with module IDs in the range 0-10 wil be sent to the sink; and all INFO(4) level messages will be sent as well.

Valid values

Pipe delimited ranges for log levels, module IDs and specifier IDs. Ranges can be comma separated integers or range of integers or '*'.

Default value

0-2,4|*|*

Takes effect Immediately

logconfig.MFSINK

MF Sink Log Filter

Controls the log messages that are sent to the MF sink. The format is 'levels|moduleIDs|specifierIDs' (repeated if necessary). The values between the pipes can be in the format: 'm-n,o,p' (ie "0-4, 5,6"). The wildcard character '*' can also be used to indicate all valid numbers. Example: '*|*|*' indicates that all log messages should be sent to the sink. Alternatively, '0,1|0-10|*|4|*|*' inidcates that CRITICAL(0) and ERROR(1) level messages with module IDs in the range 0-10 wil be sent to the sink; and all INFO(4) level messages will be sent as well.

Valid values

Pipe delimited ranges for log levels, module IDs and specifier IDs. Ranges can be comma separated integers or range of integers or '*'.

Default value

*|*|*

Takes effect Immediately

metricsconfig.DATAC

Data Collection Sink Metrics Filter

Specifies the metrics that are delivered to the Data Collection sink. '*' indicates that all metrics will be sent to the sink. Alternatively, '5-10,50-55,70,71' indicates that metrics with IDs 5,6,7,8,9,10,50,51,52,53,54,55,70 and 71 will be sent to the Data Collection sink.

Valid values

Comma separated list of metric values or ranges. A metric value must be between 0 and 141 inclusive. The values '*' and blank are also allowed.

Default value

*

Takes effect Immediately

metricsconfig.MFSINK

MF Sink Metrics Filter

Specifies the metrics that are delivered to the MF Sink. '*' indicates that all metrics will be sent to the sink. Alternatively, '5-10,50-55,70,71' indicates that metrics with IDs 5,6,7,8,9,10,50,51,52,53,54,55,70 and 71 will be sent to the MF sink.

Valid values

Comma separated list of metric values or ranges. A metric value must be between 0 and 141 inclusive. The values '*' and blank are also allowed.

Default value

0-16,18-41,43,52-56,72-74,76-81,127-129,130,132-141,146-152

Takes effect Immediately

ors.reportinginterval

OR reporting interval

Interval (seconds) accumulated operational reports are submitted to the Reporting Server

Valid values

An integer between 1-299 inclusive.

Default value

60

Takes effect At start/restart

rc.batch_size

Upstream Batch Size

The number of upstream log events queued up by the reporting client before sending them up to the reporting server. A higher batch size (e.g. 50 records) may improve performance at the cost of sending upstream data less frequently.

Valid values

An integer between 1-5000 inclusive.

Default value

500

Takes effect At start/restart

rc.cdr.batch_size

CDR Batch Size

The number of CDR messages queued up by the reporting client before sending them up to the reporting server. A higher batch size (e.g. 50 records) may improve performance at the cost of sending CDR data less frequently.

Valid values

An integer between 1-5000 inclusive.

Default value

500

Takes effect At start/restart

rc.cdr.local_queue_max

Maximum Records in the Persisted Local DB File for CDR data

This option specifies the maximum number of data items to the local database for CDR reporting. Queuing to the local database will occur either when the Reporting Server is unavailable, or when data is being provided to the Client faster than the Server can consume it. A value of -1 indicates an "unlimited" number of records will be allowed. A value of 0 indicates that no records will be persisted locally and data will be discarded if the RS is unavailable.

Valid values

An integer greater or equal to -1.

Default value

1000000

Takes effect At start/restart

rc.cdr.local_queue_path

Persistent DB File for CDR Data

The full path of the local database file used to locally persist data for CDRs.

Valid values

Path to the DB file.

Default value

cdrQueue_mcp.db

Takes effect At start/restart

rc.cdr.max_throughput

Maximum Throughput of CDR data sent to the RS

This option specifies the maximum rate at which CDR data, in bytes per second, is sent to the Reporting Server. A value of 0 (default) indicates that CDR data will be sent as quickly as possible.

Valid values

An integer greater or equal to 0.

Default value

0

Takes effect At start/restart

rc.certificate

TLS Certificate for Reporting Client

The file name of the TLS certificate in "PEM" format. Required to connect to the Reporting Server (ActiveMQ) over TLS.

Valid values

File path

Default value

(blank)

Takes effect at start/restart

rc.local_queue_max

Maximum Records in the Persisted Local DB File for Upstream Logging

This option specifies the maximum number of data items to the local database for Upstream Logging. Queuing to the local database will occur either when the Reporting Server is unavailable, or when data is being provided to the Client faster than the Server can consume it. A value of -1 indicates an "unlimited" number of records will be allowed. A value of 0 indicates that no records will be persisted locally and data will be discarded if the RS is unavailable.

Valid values

An integer greater or equal to -1.

Default value

5000000

Takes effect At start/restart

rc.local_queue_path

Persistent DB File for Upstream Logging

The full path of the local database file used to locally persist data for upstream logging to the GVP Reporting Client.

Valid values

Path to the DB file.

Default value

reportingClientQueue.db

Takes effect At start/restart

rc.max_throughput

Maximum Throughput of Upstream Logging data sent to the RS

This option specifies the maximum rate at which Upstream Logging data, in bytes per second, is sent to the Reporting Server. A value of 0 (default) indicates that Upstream Logging data will be sent as quickly as possible.

Valid values

An integer greater or equal to 0.

Default value

0

Takes effect At start/restart

rc.ors.local_queue_max

Maximum Records in the Persisted Local DB File for OR data

This option specifies the maximum number of data items to the local database for Operational Reporting. Queuing to the local database will occur either when the Reporting Server is unavailable, or when data is being provided to the Client fdaster than the Server can consume it. A value of -1 indicates an "unlimited" number of records will be allowed. A value of 0 indicates that no records will be persisted locally and data will be discarded if the RS is unavailable.

Valid values

An integer greater or equal to -1.

Default value

1000000

Takes effect At start/restart

rc.ors.local_queue_path

Persistent DB File for OR Data

The full path of the local database file used to locally persist data for Operational Reporting.

Valid values

Path to the DB file.

Default value

orsQueue_mcp.db

Takes effect At start/restart

rc.sqa.batch_size

SQA Batch Size

The number of SQA messages queued up by the reporting client before sending them up to the reporting server. For SQA messages, this option has little effect.

Valid values

An integer between 1-5000 inclusive.

Default value

1

Takes effect At start/restart

rc.sqa.local_queue_max

Maximum Records in the Persisted Local DB File for SQA data

This option specifies the maximum number of data items to the local database file for SQA reporting. Queuing to the local database will occur either when the Reporting Server is unavailable, or when data is being provided to the Client fdaster than the Server can consume it. A value of -1 indicates an "unlimited" number of records will be allowed. A value of 0 indicates that no records will be persisted locally and data will be discarded if the RS is unavailable.

Valid values

An integer greater or equal to -1.

Default value

3000

Takes effect At start/restart

rc.sqa.local_queue_path

Persistent DB File for SQA Data

The full path of the local database file used to locally persist data for SQA dats.

Valid values

Path to the DB file.

Default value

sqaQueue_mcp.db

Takes effect At start/restart

[fm]

cachemaxentrycount

Maximum Cache Entry Count

The maximum number of cache entries that can be stored in the cache.

Valid values

Must be an integer greater than or equal to 0.

Default value

1000

Takes effect At start/restart

cachemaxentrysize

Maximum Cache Entry Size

The maximum size of each cache entry in bytes.

Valid values

Must be an integer greater than or equal to 0.

Default value

20000000

Takes effect At start/restart

cachemaxsize

Maximum Cache Size

The maximum total size of the cache in bytes.

Valid values

Must be an integer greater than or equal to 0.

Default value

200000000

Takes effect At start/restart

enable100continue

Enable 100-continue

Enable or disable the "Expect: 100-continue" header in HTTP 1.1 requests.

Valid values

  • 0
  • 1

Default value

0

Takes effect At start/restart

http_proxy

HTTP Proxy

The HTTP proxy to be used for HTTP requests.

Default value

localhost:3128

Takes effect At start/restart

https_proxy

HTTPS Proxy

The HTTPS proxy to be used for HTTPS requests.

Default value

(blank)

Takes effect At start/restart

interface

Outgoing Interface

This sets the network interface IP address to be used for outgoing HTTP requests. If this parameter is empty, it will automatically select the network interface to be used. If the Squid HTTP proxy is used, it has to be configured to accept HTTP requests from the interface specified. Otherwise, Squid by default would only accept HTTP requests from the localhost.

Default value

(blank)

Takes effect At start/restart

localfile_maxage

Maxage for Local Files

Maxage for cached local files in seconds. Caching of local files can be turned off by setting this to 0.

Default value

10

Takes effect At start/restart

maxredirections

Maximum Redirections

The maximum number of times to follow the Location: header in the HTTP response. Set to 0 to disable HTTP redirection.

Valid values

Must be an integer from 0 to 99 inclusive.

Default value

5

Takes effect At start/restart

no_cache_url_substring

No Cache URL Substring

If a URL contains any one of the sub-strings in this comma-delimited list, it will not be cached.

Default value

cgi-bin,jsp,asp,?

Takes effect At start/restart

portrange

HTTP Port Range

The local port range to be used for HTTP requests. If this parameter is not specified, MCP will let the OS choose the local port.

Default value

(blank)

Takes effect At start/restart

sleeptimems

Sleep Time (in ms)

The amount of time in ms to sleep between gathering data during a fetch. It is recommended to keep this at the default of 10ms to not needlessly process data, but can be reduced if fetches take too long.

Valid values

Must be an non-negative integer.

Default value

10

Takes effect At start/restart

ssl_ca_info

SSL CA Info

The file name holding one or more certificates to verify the peer with.

Default value

(blank)

Takes effect At start/restart

ssl_ca_path

SSL CA Path

The path holding multiple CA certificates to verify the peer with. The certificate directory must be prepared using the openssl c_rehash utility.

Default value

(blank)

Takes effect At start/restart

ssl_cert

SSL Certificate

The file name of your certificate. The default format is "PEM" and can be changed with the configuration parameter ssl_cert_type

Default value

(blank)

Takes effect At start/restart

ssl_cert_type

SSL Certificate Type

The format of the certificate.

Valid values

  • PEM
  • DER

Default value

PEM

Takes effect At start/restart

ssl_cipher_list

SSL Cipher List

The list of ciphers to use for the SSL connection. The list must be syntactically correct, it consists of one or more cipher strings separated by colons. Commas or spaces are also acceptable separators but colons are normally used, , - and + can be used as operators. Valid examples of cipher lists include 'RC4-SHA', 'SHA1+DES', 'TLSv1' and 'DEFAULT'. More details about cipher lists can be found on this URL: http://www.openssl.org/docs/apps/ciphers.html.

Default value

(blank)

Takes effect At start/restart

ssl_key

SSL Key

The file name of the private key. The default format for the key is "PEM" and may be changed by the parameter ssl_key_type.

Default value

(blank)

Takes effect At start/restart

ssl_key_password

SSL Key Password

The password required to use the ssl_key.

Default value

(blank)

Takes effect At start/restart

ssl_key_type

SSL Key Type

The format of the private key.

Valid values

  • PEM
  • DER

Default value

PEM

Takes effect At start/restart

ssl_random_file

SSL Random File Seed

The path to a file which is read from to seed the random engine for SSL.

Default value

(blank)

Takes effect At start/restart

ssl_verify_host

SSL Verify Host

Specifies how the Common name from the peer certificate should be verified during the SSL handshake

Valid values

  • 0
  • 1
  • 2

Default value

0

Takes effect At start/restart

ssl_verify_peer

Verify Peer Certificate

Whether or not to verify the peer's certificate. When this option is set, one of ssl_ca_info or ssl_ca_path should be set.

Valid values

  • 0
  • 1

Default value

0

Takes effect At start/restart

ssl_version

SSL Version

Set what version of SSL to attempt to use. By default, the SSL library will automatically detect the correct version. This parameter can be used to override this automatic detection, for situations where the wrong version is chosen.

Valid values

  • 0
  • 1
  • 2
  • 3

Default value

0

Takes effect At start/restart

[log]

all

Output for level all

Specifies the outputs to which an application sends all log events. The log output types must be separated by a comma when more than one output is configured.

Valid values

  • stdout Log events are sent to the Standard output (stdout).
  • stderr Log events are sent to the Standard error output (stderr).
  • network Log events are sent to Message Server, which can reside anywhere on the network. Message Server stores the log events in the Log Database. Setting the all log level option to the network output enables an application to send log events of the Standard, Interaction, and Trace levels to Message Server. Debug-level log events are neither sent to Message Server nor stored in the Log Database.
  • memory Log events are sent to the memory output on the local disk. This is the safest output in terms of the application performance.
  • [filename] Log events are stored in a file with the specified name. If a path is not specified, the file is created in the application's working directory.
  • Default value

    ../logs/MCP

    Takes effect Immediately

    check-point

    Check point interval

    Specifies, in hours, how often the application generates a check point log event, to divide the log into sections of equal time. By default, the application generates this log event every hour. Setting the option to 0 prevents the generation of check-point events.

    Valid values

    0 - 24

    Default value

    1

    Takes effect Immediately

    compatible-output-priority

    Enable 6.X compatible log output priority

    Specifies whether the application uses 6.x output logic.

    Valid values

  • true The log of the level specified by "Log Output Options" is sent to the specified output.
  • false The log of the level specified by "Log Output Options" and higher levels is sent to the specified output.
  • Default value

    false

    Takes effect Immediately

    debug

    Output for level debug

    Specifies the outputs to which an application sends the log events of the Debug level and higher (that is, log events of the Standard, Interaction, Trace, and Debug levels). The log output types must be separated by a comma when more than one output is configured.

    Valid values

  • stdout Log events are sent to the Standard output (stdout).
  • stderr Log events are sent to the Standard error output (stderr).
  • network Log events are sent to Message Server, which can reside anywhere on the network. Message Server stores the log events in the Log Database. Setting the all log level option to the network output enables an application to send log events of the Standard, Interaction, and Trace levels to Message Server. Debug-level log events are neither sent to Message Server nor stored in the Log Database.
  • memory Log events are sent to the memory output on the local disk. This is the safest output in terms of the application performance.
  • [filename] Log events are stored in a file with the specified name. If a path is not specified, the file is created in the application's working directory.
  • Default value

    ../logs/MCP

    Takes effect Immediately

    expire

    Log Expiration

    Determines whether log files expire. If they do, sets the measurement for determining when they expire, along with the maximum number of files (segments) or days before the files are removed.

    Valid values

  • false No expiration; all generated segments are stored.
  • [number] file or [number] Sets the maximum number of log files to store. Specify a number from 1-100.
  • [number] day Sets the maximum number of days before log files are deleted. Specify a number from 1-100.
  • Default value

    10

    Takes effect Immediately

    interaction

    Output for level interaction

    Specifies the outputs to which an application sends the log events of the Interaction level and higher (that is, log events of the Standard and Interaction levels). The log outputs must be separated by a comma when more than one output is configured.

    Valid values

  • stdout Log events are sent to the Standard output (stdout).
  • stderr Log events are sent to the Standard error output (stderr).
  • network Log events are sent to Message Server, which can reside anywhere on the network. Message Server stores the log events in the Log Database. Setting the all log level option to the network output enables an application to send log events of the Standard, Interaction, and Trace levels to Message Server. Debug-level log events are neither sent to Message Server nor stored in the Log Database.
  • memory Log events are sent to the memory output on the local disk. This is the safest output in terms of the application performance.
  • [filename] Log events are stored in a file with the specified name. If a path is not specified, the file is created in the application's working directory.
  • Default value

    ../logs/MCP

    Takes effect Immediately

    keep-startup-file

    Keep startup log file

    Specifies whether a startup segment of the log, containing the initial configuration, is to be kept. If it is, this option can be set to true or to a specific size. If set to true, the size of the initial segment will be equal to the size of the regular log segment defined by the segment option. The value of this option will be ignored if segmentation is turned off (that is, if the segment option set to false).

    Valid values

  • false No startup segment of the log is kept.
  • true A startup segment of the log is kept. The size of the segment equals the value of the segment option.
  • [number] KB Sets the maximum size, in kilobytes, for a startup segment of the log.
  • [number] MB Sets the maximum size, in megabytes, for a startup segment of the log.
  • Default value

    true

    Takes effect After restart

    memory

    Memory snapshot file name

    Specifies the name of the file to which the application regularly prints a snapshot of the memory output, if it is configured to do this. The new snapshot overwrites the previously written data. If the application terminates abnormally, this file will contain the latest log messages. Memory output is not recommended for processors with a CPU frequency lower than 600 MHz.

    Valid values

    [string] (memory file name)

    Default value

    (blank)

    Takes effect Immediately

    memory-storage-size

    Memory output buffer size

    Specifies the buffer size for log output to the memory, if configured.

    Valid values

  • [number] KB or [number] The size of the memory output, in kilobytes. The minimum value is 128 KB.
  • [number] MB The size of the memory output, in megabytes. The maximum value is 64 MB
  • Default value

    (blank)

    Takes effect When memory output is created

    message_format

    Log messages format

    Specifies the format of log record headers that an application uses when writing logs in the log file. Using compressed log record headers improves application performance and reduces the log file's size. With the value set to short:
  • A header of the log file or the log file segment contains information about the application (such as the application name, application type, host type, and time zone), whereas single log records within the file or segment omit this information.
  • A log message priority is abbreviated to Std, Int, Trc, or Dbg, for Standard, Interaction, Trace, or Debug messages, respectively.
  • The message ID does not contain the prefix GCTI or the application type ID.
    A log record in the full format looks like this:
    2002-05-07T18:11:38.196 Standard localhost cfg_dbserver GCTI-00-05060 Application started
    A log record in the short format looks like this:
    2002-05-07T18:15:33.952 Std 05060 Application started
  • Valid values

    • short
    • full
  • short An application uses compressed headers when writing log records in its log file.
  • full An application uses complete headers when writing log records in its log file.
  • Default value

    short

    Takes effect Immediately

    messagefile

    Message file

    Specifies the file name for application-specific log events. The name must be valid for the operating system on which the application is running. The option value can also contain the absolute path to the application-specific *.lms file. Otherwise, an application looks for the file in its working directory.

    Valid values

    [string].lms (message file name)

    Default value

    (blank)

    Takes effect Immediately, if an application cannot find its *.lms file at startup

    print-attributes

    Enable printing extended attributes

    Specifies whether the application attaches extended attributes, if any exist, to a log event that it sends to log output. Typically, log events of the Interaction log level and Audit-related log events contain extended attributes. Setting this option to true enables audit capabilities, but negatively affects performance. Genesys recommends enabling this option for Solution Control Server and Configuration Server when using audit tracking. For other applications, refer to Genesys 7.5 Combined Log Events Help to find out whether an application generates Interaction-level and Audit-related log events; if it does, enable the option only when testing new interaction scenarios.

    Valid values

  • true Attaches extended attributes, if any exist, to a log event sent to log output.
  • false Does not attach extended attributes to a log event sent to log output.
  • Default value

    false

    Takes effect Immediately

    segment

    Log Segmentation

    Specifies whether there is a segmentation limit for a log file. If there is, sets the mode of measurement, along with the maximum size. If the current log segment exceeds the size set by this option, the file is closed and a new one is created.

    Valid values

  • false No segmentation is allowed.
  • [number] KB or [number] Sets the maximum segment size, in kilobytes. The minimum segment size is 100 KB.
  • [number] MB Sets the maximum segment size, in megabytes.
  • [number] hr Sets the number of hours for the segment to stay open. The minimum number is 1 hour.
  • Default value

    10000

    Takes effect Immediately

    spool

    Folder for the temporary network log output files

    Specifies the folder, including full path to it, in which an application creates temporary files related to network log output. If you change the option value while the application is running, the change does not affect the currently open network output.

    Valid values

    [path] (the folder, with the full path to it)

    Default value

    (blank)

    Takes effect Immediately

    standard

    Output for level standard

    Specifies the outputs to which an application sends the log events of the Standard level. The log output types must be separated by a comma when more than one output is configured.

    Valid values

  • stdout Log events are sent to the Standard output (stdout).
  • stderr Log events are sent to the Standard error output (stderr).
  • network Log events are sent to Message Server, which can reside anywhere on the network. Message Server stores the log events in the Log Database. Setting the all log level option to the network output enables an application to send log events of the Standard, Interaction, and Trace levels to Message Server. Debug-level log events are neither sent to Message Server nor stored in the Log Database.
  • memory Log events are sent to the memory output on the local disk. This is the safest output in terms of the application performance.
  • [filename] Log events are stored in a file with the specified name. If a path is not specified, the file is created in the application's working directory.
  • Default value

    ../logs/MCP_standard

    Takes effect Immediately

    time_convert

    Time generation for log messages

    Specifies the system in which an application calculates the log record time when generating a log file. The time is converted from the time in seconds since the Epoch (00:00:00 UTC, January 1, 1970).

    Valid values

    • local
    • utc
  • local The time of log record generation is expressed as a local time, based on the time zone and any seasonal adjustments. Time zone information of the application's host computer is used.
  • utc The time of log record generation is expressed as Coordinated Universal Time (UTC).
  • Default value

    local

    Takes effect Immediately

    time_format

    Time format for log messages

    Specifies how to represent, in a log file, the time when an application generates log records.
    A log record's time field in the ISO 8601 format looks like this:
    2001-07-24T04:58:10.123

    Valid values

    • time
    • locale
    • ISO8601
  • time The time string is formatted according to the HH:MM:SS.sss (hours, minutes, seconds, and milliseconds) format.
  • locale The time string is formatted according to the system's locale.
  • ISO8601 The date in the time string is formatted according to the ISO 8601 format. Fractional seconds are given in milliseconds.
  • Default value

    ISO8601

    Takes effect Immediately

    trace

    Output for level trace

    Specifies the outputs to which an application sends the log events of the Trace level and higher (that is, log events of the Standard, Interaction, and Trace levels). The log outputs must be separated by a comma when more than one output is configured.

    Valid values

  • stdout Log events are sent to the Standard output (stdout).
  • stderr Log events are sent to the Standard error output (stderr).
  • network Log events are sent to Message Server, which can reside anywhere on the network. Message Server stores the log events in the Log Database. Setting the all log level option to the network output enables an application to send log events of the Standard, Interaction, and Trace levels to Message Server. Debug-level log events are neither sent to Message Server nor stored in the Log Database.
  • memory Log events are sent to the memory output on the local disk. This is the safest output in terms of the application performance.
  • [filename] Log events are stored in a file with the specified name. If a path is not specified, the file is created in the application's working directory.
  • Default value

    ../logs/MCP

    Takes effect Immediately

    verbose

    Verbose Level

    Determines whether a log output is created. If it is, specifies the minimum level of log events generated. The log events levels, starting with the highest priority level, are Standard, Interaction, Trace, and Debug.

    Valid values

    • all
    • debug
    • trace
    • interaction
    • standard
    • none
  • all All log events (that is, log events of the Standard, Trace,Interaction, and Debug levels) are generated.
  • debug The same as all.
  • trace Log events of the Trace level and higher (that is, log events of the Standard, Interaction, and Trace levels) are generated, but log events of the Debug level are not generated.
  • interaction Log events of the Interaction level and higher (that is, log events of the Standard and Interaction levels) are generated, but log events of the Trace and Debug levels are not generated.
  • standard Log events of the Standard level are generated, but log events of the Interaction, Trace, and Debug levels are not generated.
  • none No output is produced.
  • Default value

    interaction

    Takes effect Immediately

    [mpc]

    Media Processing Component Parameters

    amr.enable_dtx

    AMR Enable DTX

    This parameter controls whether the AMR transcoder will generate comfort noise frames when transcoding data to AMR format for which the voice activity detector indicates no speech.

    Valid values

    • 0
    • 1

    Default value

    1

    Takes effect At start/restart

    amr.fmtp

    AMR FMTP

    Specifies the AMR SDP RTP payload configurations offered and accepted by the MCP. Set to one or more fmtp text values separated by the '|' character. The fmtp text is the same as would appear in the SDP negotiation (see RFC 4867). Each "|" separated value configures an AMR payload type. There are two fmtp parameters that can be set for each payload type, octet-align and mode-set.

    Setting octet-align=0 or octet-align=1 disables or enables octet align mode for the payload.

    Setting mode-set restricts the AMR modes for the payload. For example, setting "mode-set=0,1" only allows modes 0 and 1. If mode-set is not set, all modes are allowed unless the mode-set is restricted by the remote end. Valid modes are inclusively 0 to 7.

    For example, setting this parameter to "octet-align=1" enables one payload type with octet aligned mode enabled and any mode allowed, and setting it to "octet-align=0 | octet-align=1" enables two payload types, one with bandwidth efficient mode enabled and any mode allowed, and one with octet aligned enabled and any mode allowed.

    Note, the mode-set parameter can cause transcoding to be required. For example, if a prompt to be played is in AMR format mode 5, but only mode 0 is allowed in the payload, a transcoder will be invoked to transcode from AMR mode 5 to AMR mode 0.

    Some AMR implementations may specify a fmtp options that are not actually activated for the payload. To work around this, the mpc.amr.fmtp can be set to "*". For this setting, all fmtp content in an SDP offer will be ignored and "octet-align=0" will be returned in the SDP answer. Similarly, an offer for this configuration will be set to "octet-align=0", and all fmtp content in the answer will be ignored.

    Default value

    octet-align=0 | octet-align=1

    Takes effect At start/restart

    amr.maxptime

    AMR maxptime

    If the MCP is offering the SDP, or answering the SDP where the offer does not have the maxptime, the maxptime attribute will be set according to this configuration. If this configuration does not exist, or is disabled, the maxptime attribute will not be sent unless the SDP offer had the maxptime attribute. In the case where other codecs in the SDP also specify maxptime, the configuration of the codec listed before this codec will take precedence.

    Valid values

    • 0
    • 20
    • 40
    • 60
    • 80
    • 100

    Default value

    0

    Takes effect Immediately

    amr.preferred_mode

    AMR Preferred Mode

    Specifies the AMR Preferred Codec Mode. This is the value that the MCP sends to the remote end as the preferred mode for AMR data sent to the MCP.

    Valid values

    • 0
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 15

    Default value

    15

    Takes effect Immediately

    amr.ptime

    AMR ptime

    If the MCP is offering the SDP or answering the SDP where the offer does not have the ptime, the ptime attribute will be set according to this configuration. This configuration is also used as the transmission rate of this codec when the remote SDP does not specify the ptime attribute. Note that transmission rate will default to 20ms if this configuration is disabled. If disabled, ptime attribute will not be sent unless the SDP offer had the ptime attribute. In the case where the other codecs in the SDP also specify the configured ptime, the configuration of the codec listed before this codec will take precedence.

    Valid values

    • 0
    • 20
    • 40
    • 60
    • 80
    • 100

    Default value

    20

    Takes effect Immediately

    amr_wb.maxptime

    AMR-WB maxptime

    If the MCP is offering the SDP, or answering the SDP where the offer does not have the maxptime, the maxptime attribute will be set according to this configuration. If this configuration does not exist, or is disabled, the maxptime attribute will not be sent unless the SDP offer had the maxptime attribute. In the case where other codecs in the SDP also specify maxptime, the configuration of the codec listed before this codec will take precedence.

    Valid values

    • 0
    • 20
    • 40
    • 60
    • 80
    • 100

    Default value

    0

    Takes effect Immediately

    amr_wb.ptime

    AMR-WB ptime

    If the MCP is offering the SDP or answering the SDP where the offer does not have the ptime, the ptime attribute will be set according to this configuration. This configuration is also used as the transmission rate of this codec when the remote SDP does not specify the ptime attribute. Note that transmission rate will default to 20ms if this configuration is disabled. If disabled, ptime attribute will not be sent unless the SDP offer had the ptime attribute. In the case where the other codecs in the SDP also specify the configured ptime, the configuration of the codec listed before this codec will take precedence.

    Valid values

    • 0
    • 20
    • 40
    • 60
    • 80
    • 100

    Default value

    20

    Takes effect Immediately

    amr_wbpayload

    AMR-WB Payload

    Default payload type number to use for the AMR-WB codec

    Valid values

    A valid AMR-WB Payload can only be an integer from 96 to 127 inclusive

    Default value

    112

    Takes effect At start/restart

    amrpayload

    AMR Payload

    Default payload type number to use for the AMR codec

    Valid values

    A valid AMR Payload can only be an integer from 96 to 127 inclusive

    Default value

    105

    Takes effect At start/restart

    amrwb.enable_dtx

    AMR-WB Enable DTX

    This parameter controls whether the AMR-WB transcoder will generate comfort noise frames when transcoding data to AMR-WB format for which the voice activity detector indicates no speech.

    Valid values

    • 0
    • 1

    Default value

    1

    Takes effect At start/restart

    amrwb.fmtp

    AMR-WB FMTP

    Specifies the AMR-WB SDP RTP payload configurations offered and accepted by the MCP. Set to one or more fmtp text values separated by the '|' character. The fmtp text is the same as would appear in the SDP negotiation (see RFC 4867). Each "|" separated value configures an AMR-WB payload type. There are two fmtp parameters that can be set for each payload type, octet-align and mode-set.

    Setting octet-align=0 or octet-align=1 disables or enables octet align mode for the payload.

    Setting mode-set restricts the AMR-WB modes for the payload. For example, setting "mode-set=0,1" only allows modes 0 and 1. If mode-set is not set, all modes are allowed unless the mode-set is restricted by the remote end. Valid modes are inclusively 0 to 8.

    For example, setting this parameter to "octet-align=1" enables one payload type with octet aligned mode enabled and any mode allowed, and setting it to "octet-align=0 | octet-align=1" enables two payload types, one with bandwidth efficient mode enabled and any mode allowed, and one with octet aligned enabled and any mode allowed.

    Note, the mode-set parameter can cause transcoding to be required. For example, if a prompt to be played is in AMR-WB format mode 5, but only mode 0 is allowed in the payload, a transcoder will be invoked to transcode from AMR-WB mode 5 to AMR-WB mode 0.

    Some AMR-WB implementations may specify a fmtp options that are not actually activated for the payload. To work around this, the mpc.amrwb.fmtp can be set to "*". For this setting, all fmtp content in an SDP offer will be ignored and "octet-align=0" will be returned in the SDP answer. Similarly, an offer for this configuration will be set to "octet-align=0", and all fmtp content in the answer will be ignored.

    Default value

    octet-align=0 | octet-align=1

    Takes effect At start/restart

    amrwb.preferred_mode

    AMR-WB Preferred Mode

    Specifies the AMR-WB Preferred Codec Mode. This is the value that the MCP sends to the remote end as the preferred mode for AMR-WB data sent to the MCP.

    Valid values

    • 0
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 15

    Default value

    15

    Takes effect Immediately

    answerwithonecodec

    Single codec in SDP answer per media-line

    When an SDP offer contains more than one codec per media line, this can be used to limit the codecs in the answer to one (the most preferred) when enabled. If disabled (the default), all the negotiated codecs will be returned in the answer.

    Valid values

    • 0
    • 1

    Default value

    0

    Takes effect Immediately

    appendrejcodec

    Append Rejected Codecs

    When set to Enable, the MCP will advertise all supported codecs when generating an SDP answer or SDP offer. Even if codecs are rejected or not presented in the caller's SDP, the MCP will still support receiving these codecs. The MCP will not send for those SDPs unless a payload is presented by the caller.

    Valid values

    • 0
    • 1

    Default value

    0

    Takes effect Immediately/session

    asr.codec

    ASR Codec

    Specifies the ASR codec to be used.

    Valid values

    • pcmu telephone-event
    • pcma telephone-event
    • g722 telephone-event
    • g726 telephone-event
    • g729 telephone-event
    • gsm telephone-event
    • amr telephone-event
    • amr-wb telephone-event
    • tfci telephone-event

    Default value

    pcmu telephone-event

    Takes effect At start/restart

    asr.preferredipinterface

    ASR Preferred IP Interface

    Specifies the preferred IP interface to use (IPv4 or IPv6) for ASR when performing SDP negotiation. In particular, this will be used to set the root connection attribute in SDP answers, and set the connection attribute in SDP offers.

    Valid values

    • V4
    • V6

    Default value

    V4

    Takes effect At start/restart

    asr.srtp.cryptomethods

    ASR SRTP Crypto Methods

    List of crypto suites corresponding to advertised capabilities offered by the MCP to the ASR server using SDP. See RFC4568 for the description of the suites. Methods can only contain alphanumeric characters.

    Valid values

    • AES_CM_128_HMAC_SHA1_80
    • AES_CM_128_HMAC_SHA1_32
    • none

    Default value

    AES_CM_128_HMAC_SHA1_80

    Takes effect At start/restart

    asr.srtp.mode

    ASR SRTP Mode

    Specifies the srtp mode for the MCP to use for ASR sessions.

    Valid values

    • none
    • offer
    • offer_strict
    none: No SRTP supported: the MCP will ignore the crypto
    offer: SRTP supported in outgoing SDP offers. If the other side ignores SRTP, the MCP will fall back to non SRTP mode.
    offer_strict: Same as offer, however if the other side doesn't use SRTP, negotiation will fail

    Default value

    none

    Takes effect At start/restart

    asr.srtp.sessionparamsoffer

    ASR SRTP Offered Session Parameters

    List of session parameters that the MCP will include in its SDP offers to the ASR server. See RFC4568 for their description. Note that RFC4568 doesn't allow unauthenticated srtcp.

    Valid values

    • UNENCRYPTED_SRTP
    • UNENCRYPTED_SRTCP
    • UNAUTHENTICATED_SRTP
    • none

    Default value

    none

    Takes effect At start/restart

    codec

    Codecs

    List of codec corresponding to advertised capabilities offered by the MCP using SDP. The offered codec list will control the codecs that are offered by the MCP to the remote party for media sent from the remote party to Genesys. telephone-event is mandatory if RFC2833 DTMF relay is required. If the telephone-event is not set then the mpc.rtp.dtmf.send and mpc.rtp.dtmf.receive will control the DTMF relay method.

    Valid values

    • pcmu
    • pcma
    • g722
    • g726
    • g729
    • gsm
    • amr
    • amr-wb
    • tfci
    • h263
    • h263-1998
    • h264
    • vp8
    • telephone-event

    Default value

    pcmu pcma g722 g726 g729 gsm amr amr-wb h263 h263-1998 h264 vp8 telephone-event

    Takes effect Immediately/session

    codecpref

    Codec Preference

    Specify whether remote or local preferences will be used to interpret the accept codec list. If remote preferences are used, then the effective accept list will be the format list offered by the remote entity, filtered to include only those entries also on the locally configured list. If local preferences are used, then the local accept list will be used, but only including those capabilities offered by the remote entity. The "mpc.codecpref" parameter will be used to control this, and can be set to either Remote, or Local; the default value will be Remote.

    Valid values

    • r
    • l

    Default value

    r

    Takes effect Immediately/session

    conference.allowloudestvideoecho

    Allow loudest speaker to see oneself for conference loudest video selection algorithm

    Only applicable if the conference.video_output_algorithm is loudest or confrole where it falls back to the loudest. This parameter controls who the loudest speaker will see as the video. If true, the loudest speaker will see oneself. If false, the loudest spaker will see the previously selected video who was not oneself (if no previous, then no video).

    Valid values

    • 0
    • 1

    Default value

    0

    Takes effect Immediately/session

    cpa.busy

    Busy pattern

    Specifies tones for CPA's busy pattern. Default tone value is builtin North American busy (NA busy). Value "Disable" disables busy detection. Valid tones include builtins and Custom tone 1 to Custom tone 10.
    The builtin North American busy has three segments. All segments are the same and are defined as follows:
    Segment f1 min-max (Hz) f2 min-max (Hz) ontime min-max (ms) offtime min-max (ms)
    1 460-500 600-640 360-640 360-640
    2 460-500 600-640 360-640 360-640
    3 460-500 600-640 360-640 360-640

    Valid values

    • na_ringback
    • na_busy
    • na_fastbusy
    • na_sit_nocircuit
    • na_sit_vacantcircuit
    • na_sit_operatorintercept
    • na_sit_reorder
    • standard_fax
    • tone1
    • tone2
    • tone3
    • tone4
    • tone5
    • tone6
    • tone7
    • tone8
    • tone9
    • tone10
    • none

    Default value

    na_busy

    Takes effect At start/restart

    cpa.custom1

    Custom 1 pattern

    Specifies tones for CPA's custom 1 pattern. Default tone value is "Disable" which disables custom 1 detection. Valid tones include builtins and Custom tone 1 to Custom tone 10.

    Valid values

    • na_ringback
    • na_busy
    • na_fastbusy
    • na_sit_nocircuit
    • na_sit_vacantcircuit
    • na_sit_operatorintercept
    • na_sit_reorder
    • standard_fax
    • tone1
    • tone2
    • tone3
    • tone4
    • tone5
    • tone6
    • tone7
    • tone8
    • tone9
    • tone10
    • none

    Default value

    none

    Takes effect At start/restart

    cpa.custom2

    Custom 2 pattern

    Specifies tones for CPA's custom 2 pattern. Default tone value is "Disable" which disables custom 2 detection. Valid tones include builtins and Custom tone 1 to Custom tone 10.

    Valid values

    • na_ringback
    • na_busy
    • na_fastbusy
    • na_sit_nocircuit
    • na_sit_vacantcircuit
    • na_sit_operatorintercept
    • na_sit_reorder
    • standard_fax
    • tone1
    • tone2
    • tone3
    • tone4
    • tone5
    • tone6
    • tone7
    • tone8
    • tone9
    • tone10
    • none

    Default value

    none

    Takes effect At start/restart

    cpa.custom3

    Custom 3 pattern

    Specifies tones for CPA's custom 3 pattern. Default tone value is "Disable" which disables custom 3 detection. Valid tones include builtins and Custom tone 1 to Custom tone 10.

    Valid values

    • na_ringback
    • na_busy
    • na_fastbusy
    • na_sit_nocircuit
    • na_sit_vacantcircuit
    • na_sit_operatorintercept
    • na_sit_reorder
    • standard_fax
    • tone1
    • tone2
    • tone3
    • tone4
    • tone5
    • tone6
    • tone7
    • tone8
    • tone9
    • tone10
    • none

    Default value

    none

    Takes effect At start/restart

    cpa.custom4

    Custom 4 pattern

    Specifies tones for CPA's custom 4 pattern. Default tone value is "Disable" which disables custom 4 detection. Valid tones include builtins and Custom tone 1 to Custom tone 10.

    Valid values

    • na_ringback
    • na_busy
    • na_fastbusy
    • na_sit_nocircuit
    • na_sit_vacantcircuit
    • na_sit_operatorintercept
    • na_sit_reorder
    • standard_fax
    • tone1
    • tone2
    • tone3
    • tone4
    • tone5
    • tone6
    • tone7
    • tone8
    • tone9
    • tone10
    • none

    Default value

    none

    Takes effect At start/restart

    cpa.enable_log_param

    CPA configuration parameter logging enabled

    Enable CPA configuration parameters logging

    Valid values

    • true
    • false

    Default value

    false

    cpa.enable_log_result

    CPA result logging enabled

    Enable CPA result logging

    Valid values

    • true
    • false

    Default value

    true

    cpa.fastbusy

    Fast busy pattern

    Specifies tones for CPA's fast busy pattern. Default tone value is builtin North American fast busy (NA fast busy). Value "Disable" disables fast busy detection. Valid tones include builtins and Custom tone 1 to Custom tone 10.
    The builtin North American fast busy has three segments. All segments are the same and are defined as follows:
    Segment f1 min-max (Hz) f2 min-max (Hz) ontime min-max (ms) offtime min-max (ms)
    1 460-500 600-640 160-320 180-320
    2 460-500 600-640 160-320 180-320
    3 460-500 600-640 160-320 180-320

    Valid values

    • na_ringback
    • na_busy
    • na_fastbusy
    • na_sit_nocircuit
    • na_sit_vacantcircuit
    • na_sit_operatorintercept
    • na_sit_reorder
    • standard_fax
    • tone1
    • tone2
    • tone3
    • tone4
    • tone5
    • tone6
    • tone7
    • tone8
    • tone9
    • tone10
    • none

    Default value

    na_fastbusy

    Takes effect At start/restart

    cpa.fax

    Fax pattern

    Specifies tones for CPA's fax pattern. Default tone value is builtin standard fax (Standard fax). Value "Disable" disables fax detection. Valid tones include builtins and Custom tone 1 to Custom tone 10.
    The builtin standard fax has only one segment and is defined as follows:
    Segment f1 min-max (Hz) f2 min-max (Hz) ontime min-max (ms) offtime min-max (ms)
    1 2090-2110 0-0 cpa.faxdur n/a

    Valid values

    • na_ringback
    • na_busy
    • na_fastbusy
    • na_sit_nocircuit
    • na_sit_vacantcircuit
    • na_sit_operatorintercept
    • na_sit_reorder
    • standard_fax
    • tone1
    • tone2
    • tone3
    • tone4
    • tone5
    • tone6
    • tone7
    • tone8
    • tone9
    • tone10
    • none

    Default value

    standard_fax

    Takes effect At start/restart

    cpa.faxdur

    Fax duration

    Specifies fax duration (msec) for CPA. Fax signal must be greater than or equal to this length to be detected.

    Valid values

    A valid fax duration must be a non-negative numeric

    Default value

    160

    Takes effect At start/restart

    cpa.keptdur_before_statechange

    Duration kept upon state modification

    Specifies maximum most recent buffer duration (msec) to be kept when CPA is requested to move from one state to another.

    Valid values

    A valid duration kept upon state modification must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.maxbeepdettime

    CPA maximum beepdetect time

    Specifies maximum duration (msec) for CPA beep detection state before a timeout event is thrown.

    Valid values

    A valid beepdetect time must be a numeric not less than 20

    Default value

    30000

    Takes effect At start/restart

    cpa.maxpostconntime

    CPA maximum postconnect time

    Specifies maximum duration (msec) for CPA postconnect state before a timeout event is thrown.

    Valid values

    A valid postconnect time must be a numeric not less than 20

    Default value

    20000

    Takes effect At start/restart

    cpa.maxpreconntime

    CPA maximum preconnect time

    Specifies maximum duration (msec) for CPA preconnect state before a timeout event is thrown.

    Valid values

    A valid preconnect time must be a numeric not less than 20

    Default value

    30000

    Takes effect At start/restart

    cpa.maxrings

    Maximum ringbacks

    Specifies maximum ringbacks before a no answer event is thrown by CPA. Zero disables ringback count.

    Valid values

    A valid maximum ringback must be a non-negative numeric

    Default value

    9

    Takes effect At start/restart

    cpa.preconn_tones_det_mode

    Preconnect tones detection mode

    Specifies the mode for the detection of preconnect tones. By default, the preconnect tones will only be detected in preconnect state. Optionally, the detection can be configured to operate in preconnect and postconnect state.

    Valid values

    • 0
    • 1

    Default value

    0

    Takes effect At start/restart

    cpa.priority_machine_machinegreetingdur

    Machine-favored machine greeting duration

    Specifies machine-favored machine greeting duration (msec) for CPA.

    Valid values

    A valid machine-favored machine greeting duration must be a non-negative numeric

    Default value

    1500

    Takes effect At start/restart

    cpa.priority_machine_maxvoicesigdur

    Machine favored maximum voice signal duration

    Specifies machine-favored maximum voice signal duration (msec) for CPA.

    Valid values

    A valid machine-favored maximum voice signal duration must be a non-negative numeric

    Default value

    600

    Takes effect At start/restart

    cpa.priority_machine_voicepausedur

    Machine favored voice pause duration

    Specifies machine-favored voice pause duration (msec) for CPA.

    Valid values

    A valid machine-favored voice pause duration must be a non-negative numeric

    Default value

    1100

    Takes effect At start/restart

    cpa.priority_normal_machinegreetingdur

    Normal machine greeting duration

    Specifies normal machine greeting duration (msec) for CPA.

    Valid values

    A valid normal machine greeting duration must be a non-negative numeric

    Default value

    1800

    Takes effect At start/restart

    cpa.priority_normal_maxvoicesigdur

    Normal maximum voice signal duration

    Specifies normal maximum voice signal duration (msec) for CPA.

    Valid values

    A valid normal maximum voice signal duration must be a non-negative numeric

    Default value

    800

    Takes effect At start/restart

    cpa.priority_normal_voicepausedur

    Normal voice pause duration

    Specifies normal voice pause duration (msec) for CPA.

    Valid values

    A valid normal voice pause duration must be a non-negative numeric

    Default value

    1000

    Takes effect At start/restart

    cpa.priority_voice_machinegreetingdur

    Voice-favored machine greeting duration

    Specifies voice-favored machine greeting duration (msec) for CPA.

    Valid values

    A valid voice-favored machine greeting duration must be a non-negative numeric

    Default value

    2000

    Takes effect At start/restart

    cpa.priority_voice_maxvoicesigdur

    Voice-favored maximum voice signal duration

    Specifies voice-favored maximum voice signal duration (msec) for CPA.

    Valid values

    A valid voice-favored maximum voice signal duration must be a non-negative numeric

    Default value

    1100

    Takes effect At start/restart

    cpa.priority_voice_voicepausedur

    Voice-favored voice pause duration

    Specifies voice-favored voice pause duration (msec) for CPA.

    Valid values

    A valid voice-favored voice pause duration must be a non-negative numeric

    Default value

    850

    Takes effect At start/restart

    cpa.ringback

    Ringback pattern

    Each of the result pattern types ringback, busy, fax, sit nocircuit, sit reorder, sit operatorintercept, sit vacantcircuit, custom1, custom2, custom3, and custom4, has a configuration parameter that sets the list of one or more tone definition names that are mapped to the type. Some pattern types have default tone settings. Specifying "Disable" for a pattern type will disable detection of the type.
    The list of tone definition names consist of a set of builtin standard tones and a number of configured custom tones. The builtin tones include NA ringback (North American ringback), NA busy, NA fast busy, Standard fax, NA SIT no circuit, NA SIT vacant circuit, NA SIT operator intercept, NA SIT reorder. Configuration for up to 10 custom tones, named Custom tone 1 through Custom tone 10, each containing one to three segments is supported.
    The configuration for each segment includes frequency range for one or two frequencies, on time range, off time range. Specifying zero to min and max for f1 and f2 implicitly disables the segment. Specifying f2 values implicitly enables a second frequency for the segment. Specifying segment2 values implicitly enables a second segment for the tone and so on for segment3. Any not set tone parameters will default to null/disabled values.
    In this case, cpa.ringback then specifies tones for CPA's ringback type. Default tone value is builtin North American ringback (NA ringback). Value "Disable" disables ringback detection. Valid tones include builtins and Custom tone 1 to Custom tone 10.
    The builtin North American ringback is composed of three different ringback tones. Each of them has only one segment and is defined as follows:
    Tone Desc f1 min-max (Hz) f2 min-max (Hz) ontime min-max (ms) offtime min-max (ms)
    NA RINGBACK 1 420-445 475-500 720-1280 1440-2560
    NA RINGBACK 2 420-445 475-500 720-1280 2160-3840
    NA RINGBACK 3 420-445 475-500 1440-2560 2880-5120

    Valid values

    • na_ringback
    • na_busy
    • na_fastbusy
    • na_sit_nocircuit
    • na_sit_vacantcircuit
    • na_sit_operatorintercept
    • na_sit_reorder
    • standard_fax
    • tone1
    • tone2
    • tone3
    • tone4
    • tone5
    • tone6
    • tone7
    • tone8
    • tone9
    • tone10
    • none

    Default value

    na_ringback

    Takes effect At start/restart

    cpa.sit_nocircuit

    SIT no circuit pattern

    Specifies tones for CPA's SIT no circuit pattern. Default tone value is builtin North American SIT no circuit (NA SIT nocircuit). Value "Disable" disables SIT no circuit detection. Valid tones include builtins and Custom tone 1 to Custom tone 10.
    The builtin North American sit no circuit has three segments. Each segment is defined as follows:
    Segment f1 min-max (Hz) f2 min-max (Hz) ontime min-max (ms) offtime min-max (ms)
    1 950-1020 0-0 320-440 0-60
    2 1400-1450 0-0 320-440 0-60
    3 1740-1850 0-0 320-440 0-100

    Valid values

    • na_ringback
    • na_busy
    • na_fastbusy
    • na_sit_nocircuit
    • na_sit_vacantcircuit
    • na_sit_operatorintercept
    • na_sit_reorder
    • standard_fax
    • tone1
    • tone2
    • tone3
    • tone4
    • tone5
    • tone6
    • tone7
    • tone8
    • tone9
    • tone10
    • none

    Default value

    na_sit_nocircuit

    Takes effect At start/restart

    cpa.sit_operatorintercept

    SIT operator intercept pattern

    Specifies tones for CPA's SIT operator intercept pattern. Default tone value is builtin North American SIT operator intercept (NA SIT operator intercept). Value "Disable" disables SIT operator intercept detection. Valid tones include builtins and Custom tone 1 to Custom tone 10.
    The builtin North American sit operator intercept has three segments. Each segment is defined as follows:
    Segment f1 min-max (Hz) f2 min-max (Hz) ontime min-max (ms) offtime min-max (ms)
    1 874-955 0-0 160-300 0-60
    2 1310-1430 0-0 160-300 0-60
    3 1740-1850 0-0 320-440 0-100

    Valid values

    • na_ringback
    • na_busy
    • na_fastbusy
    • na_sit_nocircuit
    • na_sit_vacantcircuit
    • na_sit_operatorintercept
    • na_sit_reorder
    • standard_fax
    • tone1
    • tone2
    • tone3
    • tone4
    • tone5
    • tone6
    • tone7
    • tone8
    • tone9
    • tone10
    • none

    Default value

    na_sit_operatorintercept

    Takes effect At start/restart

    cpa.sit_reorder

    SIT reorder pattern

    Specifies tones for CPA's SIT reorder pattern. Default tone value is builtin North American SIT reorder (NA SIT reorder). Value "Disable" disables SIT reorder detection. Valid tones include builtins and Custom tone 1 to Custom tone 10.
    The builtin North American sit reorder has three segments. Each segment is defined as follows:
    Segment f1 min-max (Hz) f2 min-max (Hz) ontime min-max (ms) offtime min-max (ms)
    1 874-955 0-0 160-300 0-60
    2 1400-1450 0-0 320-440 0-60
    3 1740-1850 0-0 320-440 0-100

    Valid values

    • na_ringback
    • na_busy
    • na_fastbusy
    • na_sit_nocircuit
    • na_sit_vacantcircuit
    • na_sit_operatorintercept
    • na_sit_reorder
    • standard_fax
    • tone1
    • tone2
    • tone3
    • tone4
    • tone5
    • tone6
    • tone7
    • tone8
    • tone9
    • tone10
    • none

    Default value

    na_sit_reorder

    Takes effect At start/restart

    cpa.sit_vacantcircuit

    SIT vacant circuit pattern

    Specifies tones for CPA's SIT vacant circuit pattern. Default tone value is builtin North American SIT vacant circuit (NA SIT vacantcircuit). Value "Disable" disables SIT vacant circuit detection. Valid tones include builtins and Custom tone 1 to Custom tone 10.
    The builtin North American sit vacant circuit has three segments. Each segment is defined as follows:
    Segment f1 min-max (Hz) f2 min-max (Hz) ontime min-max (ms) offtime min-max (ms)
    1 950-1020 0-0 320-440 0-60
    2 1310-1430 0-0 160-300 0-60
    3 1740-1850 0-0 320-440 0-100

    Valid values

    • na_ringback
    • na_busy
    • na_fastbusy
    • na_sit_nocircuit
    • na_sit_vacantcircuit
    • na_sit_operatorintercept
    • na_sit_reorder
    • standard_fax
    • tone1
    • tone2
    • tone3
    • tone4
    • tone5
    • tone6
    • tone7
    • tone8
    • tone9
    • tone10
    • none

    Default value

    na_sit_vacantcircuit

    Takes effect At start/restart

    cpa.tone1.segment1.f1max

    Maximum frequency 1 of segment 1 of tone 1

    Specifies maximum frequency 1 of segment 1 of tone 1 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone1.segment1.f1min

    Minimum frequency 1 of segment 1 of tone 1

    Specifies minimum frequency 1 of segment 1 of tone 1 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone1.segment1.f2max

    Maximum frequency 2 of segment 1 of tone 1

    Specifies maximum frequency 2 of segment 1 of tone 1 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone1.segment1.f2min

    Minimum frequency 2 of segment 1 of tone 1

    Specifies minimum frequency 2 of segment 1 of tone 1 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone1.segment1.offtimemax

    Maximum offtime of segment 1 of tone 1

    Specifies maximum offtime of segment 1 of tone 1 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone1.segment1.offtimemin

    Minimum offtime of segment 1 of tone 1

    Specifies minimum offtime of segment 1 of tone 1 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone1.segment1.ontimemax

    Maximum ontime of segment 1 of tone 1

    Specifies maximum ontime of segment 1 of tone 1 (msec) for CPA. Setting the value to zero disables checking the ontime against a maximum value, so that any time greater than the minimum ontime will be matched.

    Valid values

    A valid ontimemin must be a greater than or equal to 0 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone1.segment1.ontimemin

    Minimum ontime of segment 1 of tone 1

    Specifies minimum ontime of segment 1 of tone 1 (msec) for CPA.

    Valid values

    A valid ontimemin must be a greater than or equal to 20 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone1.segment2.f1max

    Maximum frequency 1 of segment 2 of tone 1

    Specifies maximum frequency 1 of segment 2 of tone 1 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone1.segment2.f1min

    Minimum frequency 1 of segment 2 of tone 1

    Specifies minimum frequency 1 of segment 2 of tone 1 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone1.segment2.f2max

    Maximum frequency 2 of segment 2 of tone 1

    Specifies maximum frequency 2 of segment 2 of tone 1 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone1.segment2.f2min

    Minimum frequency 2 of segment 2 of tone 1

    Specifies minimum frequency 2 of segment 2 of tone 1 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone1.segment2.offtimemax

    Maximum offtime of segment 2 of tone 1

    Specifies maximum offtime of segment 2 of tone 1 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone1.segment2.offtimemin

    Minimum offtime of segment 2 of tone 1

    Specifies minimum offtime of segment 2 of tone 1 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone1.segment2.ontimemax

    Maximum ontime of segment 2 of tone 1

    Specifies maximum ontime of segment 2 of tone 1 (msec) for CPA. Setting the value to zero disables checking the ontime against a maximum value, so that any time greater than the minimum ontime will be matched.

    Valid values

    A valid ontimemin must be a greater than or equal to 0 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone1.segment2.ontimemin

    Minimum ontime of segment 2 of tone 1

    Specifies minimum ontime of segment 2 of tone 1 (msec) for CPA.

    Valid values

    A valid ontimemin must be a greater than or equal to 20 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone1.segment3.f1max

    Maximum frequency 1 of segment 3 of tone 1

    Specifies maximum frequency 1 of segment 3 of tone 1 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone1.segment3.f1min

    Minimum frequency 1 of segment 3 of tone 1

    Specifies minimum frequency 1 of segment 3 of tone 1 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone1.segment3.f2max

    Maximum frequency 2 of segment 3 of tone 1

    Specifies maximum frequency 2 of segment 3 of tone 1 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone1.segment3.f2min

    Minimum frequency 2 of segment 3 of tone 1

    Specifies minimum frequency 2 of segment 3 of tone 1 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone1.segment3.offtimemax

    Maximum offtime of segment 3 of tone 1

    Specifies maximum offtime of segment 3 of tone 1 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone1.segment3.offtimemin

    Minimum offtime of segment 3 of tone 1

    Specifies minimum offtime of segment 3 of tone 1 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone1.segment3.ontimemax

    Maximum ontime of segment 3 of tone 1

    Specifies maximum ontime of segment 3 of tone 1 (msec) for CPA. Setting the value to zero disables checking the ontime against a maximum value, so that any time greater than the minimum ontime will be matched.

    Valid values

    A valid ontimemin must be a greater than or equal to 0 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone1.segment3.ontimemin

    Minimum ontime of segment 3 of tone 1

    Specifies minimum ontime of segment 3 of tone 1 (msec) for CPA.

    Valid values

    A valid ontimemin must be a greater than or equal to 20 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone10.segment1.f1max

    Maximum frequency 1 of segment 1 of tone 10

    Specifies maximum frequency 1 of segment 1 of tone 10 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone10.segment1.f1min

    Minimum frequency 1 of segment 1 of tone 10

    Specifies minimum frequency 1 of segment 1 of tone 10 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone10.segment1.f2max

    Maximum frequency 2 of segment 1 of tone 10

    Specifies maximum frequency 2 of segment 1 of tone 10 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone10.segment1.f2min

    Minimum frequency 2 of segment 1 of tone 10

    Specifies minimum frequency 2 of segment 1 of tone 10 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone10.segment1.offtimemax

    Maximum offtime of segment 1 of tone 10

    Specifies maximum offtime of segment 1 of tone 10 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone10.segment1.offtimemin

    Minimum offtime of segment 1 of tone 10

    Specifies minimum offtime of segment 1 of tone 10 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone10.segment1.ontimemax

    Maximum ontime of segment 1 of tone 10

    Specifies maximum ontime of segment 1 of tone 10 (msec) for CPA. Setting the value to zero disables checking the ontime against a maximum value, so that any time greater than the minimum ontime will be matched.

    Valid values

    A valid ontimemin must be a greater than or equal to 0 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone10.segment1.ontimemin

    Minimum ontime of segment 1 of tone 10

    Specifies minimum ontime of segment 1 of tone 10 (msec) for CPA.

    Valid values

    A valid ontimemin must be a greater than or equal to 20 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone10.segment2.f1max

    Maximum frequency 1 of segment 2 of tone 10

    Specifies maximum frequency 1 of segment 2 of tone 10 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone10.segment2.f1min

    Minimum frequency 1 of segment 2 of tone 10

    Specifies minimum frequency 1 of segment 2 of tone 10 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone10.segment2.f2max

    Maximum frequency 2 of segment 2 of tone 10

    Specifies maximum frequency 2 of segment 2 of tone 10 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone10.segment2.f2min

    Minimum frequency 2 of segment 2 of tone 10

    Specifies minimum frequency 2 of segment 2 of tone 10 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone10.segment2.offtimemax

    Maximum offtime of segment 2 of tone 10

    Specifies maximum offtime of segment 2 of tone 10 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone10.segment2.offtimemin

    Minimum offtime of segment 2 of tone 10

    Specifies minimum offtime of segment 2 of tone 10 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone10.segment2.ontimemax

    Maximum ontime of segment 2 of tone 10

    Specifies maximum ontime of segment 2 of tone 10 (msec) for CPA. Setting the value to zero disables checking the ontime against a maximum value, so that any time greater than the minimum ontime will be matched.

    Valid values

    A valid ontimemin must be a greater than or equal to 0 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone10.segment2.ontimemin

    Minimum ontime of segment 2 of tone 10

    Specifies minimum ontime of segment 2 of tone 10 (msec) for CPA.

    Valid values

    A valid ontimemin must be a greater than or equal to 20 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone10.segment3.f1max

    Maximum frequency 1 of segment 3 of tone 10

    Specifies maximum frequency 1 of segment 3 of tone 10 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone10.segment3.f1min

    Minimum frequency 1 of segment 3 of tone 10

    Specifies minimum frequency 1 of segment 3 of tone 10 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone10.segment3.f2max

    Maximum frequency 2 of segment 3 of tone 10

    Specifies maximum frequency 2 of segment 3 of tone 10 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone10.segment3.f2min

    Minimum frequency 2 of segment 3 of tone 10

    Specifies minimum frequency 2 of segment 3 of tone 10 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone10.segment3.offtimemax

    Maximum offtime of segment 3 of tone 10

    Specifies maximum offtime of segment 3 of tone 10 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone10.segment3.offtimemin

    Minimum offtime of segment 3 of tone 10

    Specifies minimum offtime of segment 3 of tone 10 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone10.segment3.ontimemax

    Maximum ontime of segment 3 of tone 10

    Specifies maximum ontime of segment 3 of tone 10 (msec) for CPA. Setting the value to zero disables checking the ontime against a maximum value, so that any time greater than the minimum ontime will be matched.

    Valid values

    A valid ontimemin must be a greater than or equal to 0 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone10.segment3.ontimemin

    Minimum ontime of segment 3 of tone 10

    Specifies minimum ontime of segment 3 of tone 10 (msec) for CPA.

    Valid values

    A valid ontimemin must be a greater than or equal to 20 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone2.segment1.f1max

    Maximum frequency 1 of segment 1 of tone 2

    Specifies maximum frequency 1 of segment 1 of tone 2 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone2.segment1.f1min

    Minimum frequency 1 of segment 1 of tone 2

    Specifies minimum frequency 1 of segment 1 of tone 2 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone2.segment1.f2max

    Maximum frequency 2 of segment 1 of tone 2

    Specifies maximum frequency 2 of segment 1 of tone 2 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone2.segment1.f2min

    Minimum frequency 2 of segment 1 of tone 2

    Specifies minimum frequency 2 of segment 1 of tone 2 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone2.segment1.offtimemax

    Maximum offtime of segment 1 of tone 2

    Specifies maximum offtime of segment 1 of tone 2 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone2.segment1.offtimemin

    Minimum offtime of segment 1 of tone 2

    Specifies minimum offtime of segment 1 of tone 2 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone2.segment1.ontimemax

    Maximum ontime of segment 1 of tone 2

    Specifies maximum ontime of segment 1 of tone 2 (msec) for CPA. Setting the value to zero disables checking the ontime against a maximum value, so that any time greater than the minimum ontime will be matched.

    Valid values

    A valid ontimemin must be a greater than or equal to 0 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone2.segment1.ontimemin

    Minimum ontime of segment 1 of tone 2

    Specifies minimum ontime of segment 1 of tone 2 (msec) for CPA.

    Valid values

    A valid ontimemin must be a greater than or equal to 20 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone2.segment2.f1max

    Maximum frequency 1 of segment 2 of tone 2

    Specifies maximum frequency 1 of segment 2 of tone 2 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone2.segment2.f1min

    Minimum frequency 1 of segment 2 of tone 2

    Specifies minimum frequency 1 of segment 2 of tone 2 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone2.segment2.f2max

    Maximum frequency 2 of segment 2 of tone 2

    Specifies maximum frequency 2 of segment 2 of tone 2 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone2.segment2.f2min

    Minimum frequency 2 of segment 2 of tone 2

    Specifies minimum frequency 2 of segment 2 of tone 2 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone2.segment2.offtimemax

    Maximum offtime of segment 2 of tone 2

    Specifies maximum offtime of segment 2 of tone 2 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone2.segment2.offtimemin

    Minimum offtime of segment 2 of tone 2

    Specifies minimum offtime of segment 2 of tone 2 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone2.segment2.ontimemax

    Maximum ontime of segment 2 of tone 2

    Specifies maximum ontime of segment 2 of tone 2 (msec) for CPA. Setting the value to zero disables checking the ontime against a maximum value, so that any time greater than the minimum ontime will be matched.

    Valid values

    A valid ontimemin must be a greater than or equal to 0 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone2.segment2.ontimemin

    Minimum ontime of segment 2 of tone 2

    Specifies minimum ontime of segment 2 of tone 2 (msec) for CPA.

    Valid values

    A valid ontimemin must be a greater than or equal to 20 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone2.segment3.f1max

    Maximum frequency 1 of segment 3 of tone 2

    Specifies maximum frequency 1 of segment 3 of tone 2 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone2.segment3.f1min

    Minimum frequency 1 of segment 3 of tone 2

    Specifies minimum frequency 1 of segment 3 of tone 2 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone2.segment3.f2max

    Maximum frequency 2 of segment 3 of tone 2

    Specifies maximum frequency 2 of segment 3 of tone 2 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone2.segment3.f2min

    Minimum frequency 2 of segment 3 of tone 2

    Specifies minimum frequency 2 of segment 3 of tone 2 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone2.segment3.offtimemax

    Maximum offtime of segment 3 of tone 2

    Specifies maximum offtime of segment 3 of tone 2 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone2.segment3.offtimemin

    Minimum offtime of segment 3 of tone 2

    Specifies minimum offtime of segment 3 of tone 2 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone2.segment3.ontimemax

    Maximum ontime of segment 3 of tone 2

    Specifies maximum ontime of segment 3 of tone 2 (msec) for CPA. Setting the value to zero disables checking the ontime against a maximum value, so that any time greater than the minimum ontime will be matched.

    Valid values

    A valid ontimemin must be a greater than or equal to 0 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone2.segment3.ontimemin

    Minimum ontime of segment 3 of tone 2

    Specifies minimum ontime of segment 3 of tone 2 (msec) for CPA.

    Valid values

    A valid ontimemin must be a greater than or equal to 20 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone3.segment1.f1max

    Maximum frequency 1 of segment 1 of tone 3

    Specifies maximum frequency 1 of segment 1 of tone 3 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone3.segment1.f1min

    Minimum frequency 1 of segment 1 of tone 3

    Specifies minimum frequency 1 of segment 1 of tone 3 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone3.segment1.f2max

    Maximum frequency 2 of segment 1 of tone 3

    Specifies maximum frequency 2 of segment 1 of tone 3 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone3.segment1.f2min

    Minimum frequency 2 of segment 1 of tone 3

    Specifies minimum frequency 2 of segment 1 of tone 3 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone3.segment1.offtimemax

    Maximum offtime of segment 1 of tone 3

    Specifies maximum offtime of segment 1 of tone 3 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone3.segment1.offtimemin

    Minimum offtime of segment 1 of tone 3

    Specifies minimum offtime of segment 1 of tone 3 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone3.segment1.ontimemax

    Maximum ontime of segment 1 of tone 3

    Specifies maximum ontime of segment 1 of tone 3 (msec) for CPA. Setting the value to zero disables checking the ontime against a maximum value, so that any time greater than the minimum ontime will be matched.

    Valid values

    A valid ontimemin must be a greater than or equal to 0 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone3.segment1.ontimemin

    Minimum ontime of segment 1 of tone 3

    Specifies minimum ontime of segment 1 of tone 3 (msec) for CPA.

    Valid values

    A valid ontimemin must be a greater than or equal to 20 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone3.segment2.f1max

    Maximum frequency 1 of segment 2 of tone 3

    Specifies maximum frequency 1 of segment 2 of tone 3 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone3.segment2.f1min

    Minimum frequency 1 of segment 2 of tone 3

    Specifies minimum frequency 1 of segment 2 of tone 3 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone3.segment2.f2max

    Maximum frequency 2 of segment 2 of tone 3

    Specifies maximum frequency 2 of segment 2 of tone 3 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone3.segment2.f2min

    Minimum frequency 2 of segment 2 of tone 3

    Specifies minimum frequency 2 of segment 2 of tone 3 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone3.segment2.offtimemax

    Maximum offtime of segment 2 of tone 3

    Specifies maximum offtime of segment 2 of tone 3 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone3.segment2.offtimemin

    Minimum offtime of segment 2 of tone 3

    Specifies minimum offtime of segment 2 of tone 3 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone3.segment2.ontimemax

    Maximum ontime of segment 2 of tone 3

    Specifies maximum ontime of segment 2 of tone 3 (msec) for CPA. Setting the value to zero disables checking the ontime against a maximum value, so that any time greater than the minimum ontime will be matched.

    Valid values

    A valid ontimemin must be a greater than or equal to 0 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone3.segment2.ontimemin

    Minimum ontime of segment 2 of tone 3

    Specifies minimum ontime of segment 2 of tone 3 (msec) for CPA.

    Valid values

    A valid ontimemin must be a greater than or equal to 20 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone3.segment3.f1max

    Maximum frequency 1 of segment 3 of tone 3

    Specifies maximum frequency 1 of segment 3 of tone 3 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone3.segment3.f1min

    Minimum frequency 1 of segment 3 of tone 3

    Specifies minimum frequency 1 of segment 3 of tone 3 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone3.segment3.f2max

    Maximum frequency 2 of segment 3 of tone 3

    Specifies maximum frequency 2 of segment 3 of tone 3 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone3.segment3.f2min

    Minimum frequency 2 of segment 3 of tone 3

    Specifies minimum frequency 2 of segment 3 of tone 3 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone3.segment3.offtimemax

    Maximum offtime of segment 3 of tone 3

    Specifies maximum offtime of segment 3 of tone 3 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone3.segment3.offtimemin

    Minimum offtime of segment 3 of tone 3

    Specifies minimum offtime of segment 3 of tone 3 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone3.segment3.ontimemax

    Maximum ontime of segment 3 of tone 3

    Specifies maximum ontime of segment 3 of tone 3 (msec) for CPA. Setting the value to zero disables checking the ontime against a maximum value, so that any time greater than the minimum ontime will be matched.

    Valid values

    A valid ontimemin must be a greater than or equal to 0 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone3.segment3.ontimemin

    Minimum ontime of segment 3 of tone 3

    Specifies minimum ontime of segment 3 of tone 3 (msec) for CPA.

    Valid values

    A valid ontimemin must be a greater than or equal to 20 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone4.segment1.f1max

    Maximum frequency 1 of segment 1 of tone 4

    Specifies maximum frequency 1 of segment 1 of tone 4 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone4.segment1.f1min

    Minimum frequency 1 of segment 1 of tone 4

    Specifies minimum frequency 1 of segment 1 of tone 4 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone4.segment1.f2max

    Maximum frequency 2 of segment 1 of tone 4

    Specifies maximum frequency 2 of segment 1 of tone 4 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone4.segment1.f2min

    Minimum frequency 2 of segment 1 of tone 4

    Specifies minimum frequency 2 of segment 1 of tone 4 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone4.segment1.offtimemax

    Maximum offtime of segment 1 of tone 4

    Specifies maximum offtime of segment 1 of tone 4 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone4.segment1.offtimemin

    Minimum offtime of segment 1 of tone 4

    Specifies minimum offtime of segment 1 of tone 4 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone4.segment1.ontimemax

    Maximum ontime of segment 1 of tone 4

    Specifies maximum ontime of segment 1 of tone 4 (msec) for CPA. Setting the value to zero disables checking the ontime against a maximum value, so that any time greater than the minimum ontime will be matched.

    Valid values

    A valid ontimemin must be a greater than or equal to 0 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone4.segment1.ontimemin

    Minimum ontime of segment 1 of tone 4

    Specifies minimum ontime of segment 1 of tone 4 (msec) for CPA.

    Valid values

    A valid ontimemin must be a greater than or equal to 20 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone4.segment2.f1max

    Maximum frequency 1 of segment 2 of tone 4

    Specifies maximum frequency 1 of segment 2 of tone 4 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone4.segment2.f1min

    Minimum frequency 1 of segment 2 of tone 4

    Specifies minimum frequency 1 of segment 2 of tone 4 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone4.segment2.f2max

    Maximum frequency 2 of segment 2 of tone 4

    Specifies maximum frequency 2 of segment 2 of tone 4 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone4.segment2.f2min

    Minimum frequency 2 of segment 2 of tone 4

    Specifies minimum frequency 2 of segment 2 of tone 4 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone4.segment2.offtimemax

    Maximum offtime of segment 2 of tone 4

    Specifies maximum offtime of segment 2 of tone 4 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone4.segment2.offtimemin

    Minimum offtime of segment 2 of tone 4

    Specifies minimum offtime of segment 2 of tone 4 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone4.segment2.ontimemax

    Maximum ontime of segment 2 of tone 4

    Specifies maximum ontime of segment 2 of tone 4 (msec) for CPA. Setting the value to zero disables checking the ontime against a maximum value, so that any time greater than the minimum ontime will be matched.

    Valid values

    A valid ontimemin must be a greater than or equal to 0 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone4.segment2.ontimemin

    Minimum ontime of segment 2 of tone 4

    Specifies minimum ontime of segment 2 of tone 4 (msec) for CPA.

    Valid values

    A valid ontimemin must be a greater than or equal to 20 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone4.segment3.f1max

    Maximum frequency 1 of segment 3 of tone 4

    Specifies maximum frequency 1 of segment 3 of tone 4 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone4.segment3.f1min

    Minimum frequency 1 of segment 3 of tone 4

    Specifies minimum frequency 1 of segment 3 of tone 4 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone4.segment3.f2max

    Maximum frequency 2 of segment 3 of tone 4

    Specifies maximum frequency 2 of segment 3 of tone 4 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone4.segment3.f2min

    Minimum frequency 2 of segment 3 of tone 4

    Specifies minimum frequency 2 of segment 3 of tone 4 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone4.segment3.offtimemax

    Maximum offtime of segment 3 of tone 4

    Specifies maximum offtime of segment 3 of tone 4 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone4.segment3.offtimemin

    Minimum offtime of segment 3 of tone 4

    Specifies minimum offtime of segment 3 of tone 4 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone4.segment3.ontimemax

    Maximum ontime of segment 3 of tone 4

    Specifies maximum ontime of segment 3 of tone 4 (msec) for CPA. Setting the value to zero disables checking the ontime against a maximum value, so that any time greater than the minimum ontime will be matched.

    Valid values

    A valid ontimemin must be a greater than or equal to 0 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone4.segment3.ontimemin

    Minimum ontime of segment 3 of tone 4

    Specifies minimum ontime of segment 3 of tone 4 (msec) for CPA.

    Valid values

    A valid ontimemin must be a greater than or equal to 20 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone5.segment1.f1max

    Maximum frequency 1 of segment 1 of tone 5

    Specifies maximum frequency 1 of segment 1 of tone 5 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone5.segment1.f1min

    Minimum frequency 1 of segment 1 of tone 5

    Specifies minimum frequency 1 of segment 1 of tone 5 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone5.segment1.f2max

    Maximum frequency 2 of segment 1 of tone 5

    Specifies maximum frequency 2 of segment 1 of tone 5 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone5.segment1.f2min

    Minimum frequency 2 of segment 1 of tone 5

    Specifies minimum frequency 2 of segment 1 of tone 5 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone5.segment1.offtimemax

    Maximum offtime of segment 1 of tone 5

    Specifies maximum offtime of segment 1 of tone 5 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone5.segment1.offtimemin

    Minimum offtime of segment 1 of tone 5

    Specifies minimum offtime of segment 1 of tone 5 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone5.segment1.ontimemax

    Maximum ontime of segment 1 of tone 5

    Specifies maximum ontime of segment 1 of tone 5 (msec) for CPA. Setting the value to zero disables checking the ontime against a maximum value, so that any time greater than the minimum ontime will be matched.

    Valid values

    A valid ontimemin must be a greater than or equal to 0 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone5.segment1.ontimemin

    Minimum ontime of segment 1 of tone 5

    Specifies minimum ontime of segment 1 of tone 5 (msec) for CPA.

    Valid values

    A valid ontimemin must be a greater than or equal to 20 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone5.segment2.f1max

    Maximum frequency 1 of segment 2 of tone 5

    Specifies maximum frequency 1 of segment 2 of tone 5 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone5.segment2.f1min

    Minimum frequency 1 of segment 2 of tone 5

    Specifies minimum frequency 1 of segment 2 of tone 5 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone5.segment2.f2max

    Maximum frequency 2 of segment 2 of tone 5

    Specifies maximum frequency 2 of segment 2 of tone 5 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone5.segment2.f2min

    Minimum frequency 2 of segment 2 of tone 5

    Specifies minimum frequency 2 of segment 2 of tone 5 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone5.segment2.offtimemax

    Maximum offtime of segment 2 of tone 5

    Specifies maximum offtime of segment 2 of tone 5 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone5.segment2.offtimemin

    Minimum offtime of segment 2 of tone 5

    Specifies minimum offtime of segment 2 of tone 5 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone5.segment2.ontimemax

    Maximum ontime of segment 2 of tone 5

    Specifies maximum ontime of segment 2 of tone 5 (msec) for CPA. Setting the value to zero disables checking the ontime against a maximum value, so that any time greater than the minimum ontime will be matched.

    Valid values

    A valid ontimemin must be a greater than or equal to 0 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone5.segment2.ontimemin

    Minimum ontime of segment 2 of tone 5

    Specifies minimum ontime of segment 2 of tone 5 (msec) for CPA.

    Valid values

    A valid ontimemin must be a greater than or equal to 20 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone5.segment3.f1max

    Maximum frequency 1 of segment 3 of tone 5

    Specifies maximum frequency 1 of segment 3 of tone 5 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone5.segment3.f1min

    Minimum frequency 1 of segment 3 of tone 5

    Specifies minimum frequency 1 of segment 3 of tone 5 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone5.segment3.f2max

    Maximum frequency 2 of segment 3 of tone 5

    Specifies maximum frequency 2 of segment 3 of tone 5 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone5.segment3.f2min

    Minimum frequency 2 of segment 3 of tone 5

    Specifies minimum frequency 2 of segment 3 of tone 5 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone5.segment3.offtimemax

    Maximum offtime of segment 3 of tone 5

    Specifies maximum offtime of segment 3 of tone 5 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone5.segment3.offtimemin

    Minimum offtime of segment 3 of tone 5

    Specifies minimum offtime of segment 3 of tone 5 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone5.segment3.ontimemax

    Maximum ontime of segment 3 of tone 5

    Specifies maximum ontime of segment 3 of tone 5 (msec) for CPA. Setting the value to zero disables checking the ontime against a maximum value, so that any time greater than the minimum ontime will be matched.

    Valid values

    A valid ontimemin must be a greater than or equal to 0 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone5.segment3.ontimemin

    Minimum ontime of segment 3 of tone 5

    Specifies minimum ontime of segment 3 of tone 5 (msec) for CPA.

    Valid values

    A valid ontimemin must be a greater than or equal to 20 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone6.segment1.f1max

    Maximum frequency 1 of segment 1 of tone 6

    Specifies maximum frequency 1 of segment 1 of tone 6 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone6.segment1.f1min

    Minimum frequency 1 of segment 1 of tone 6

    Specifies minimum frequency 1 of segment 1 of tone 6 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone6.segment1.f2max

    Maximum frequency 2 of segment 1 of tone 6

    Specifies maximum frequency 2 of segment 1 of tone 6 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone6.segment1.f2min

    Minimum frequency 2 of segment 1 of tone 6

    Specifies minimum frequency 2 of segment 1 of tone 6 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone6.segment1.offtimemax

    Maximum offtime of segment 1 of tone 6

    Specifies maximum offtime of segment 1 of tone 6 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone6.segment1.offtimemin

    Minimum offtime of segment 1 of tone 6

    Specifies minimum offtime of segment 1 of tone 6 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone6.segment1.ontimemax

    Maximum ontime of segment 1 of tone 6

    Specifies maximum ontime of segment 1 of tone 6 (msec) for CPA. Setting the value to zero disables checking the ontime against a maximum value, so that any time greater than the minimum ontime will be matched.

    Valid values

    A valid ontimemin must be a greater than or equal to 0 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone6.segment1.ontimemin

    Minimum ontime of segment 1 of tone 6

    Specifies minimum ontime of segment 1 of tone 6 (msec) for CPA.

    Valid values

    A valid ontimemin must be a greater than or equal to 20 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone6.segment2.f1max

    Maximum frequency 1 of segment 2 of tone 6

    Specifies maximum frequency 1 of segment 2 of tone 6 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone6.segment2.f1min

    Minimum frequency 1 of segment 2 of tone 6

    Specifies minimum frequency 1 of segment 2 of tone 6 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone6.segment2.f2max

    Maximum frequency 2 of segment 2 of tone 6

    Specifies maximum frequency 2 of segment 2 of tone 6 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone6.segment2.f2min

    Minimum frequency 2 of segment 2 of tone 6

    Specifies minimum frequency 2 of segment 2 of tone 6 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone6.segment2.offtimemax

    Maximum offtime of segment 2 of tone 6

    Specifies maximum offtime of segment 2 of tone 6 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone6.segment2.offtimemin

    Minimum offtime of segment 2 of tone 6

    Specifies minimum offtime of segment 2 of tone 6 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone6.segment2.ontimemax

    Maximum ontime of segment 2 of tone 6

    Specifies maximum ontime of segment 2 of tone 6 (msec) for CPA. Setting the value to zero disables checking the ontime against a maximum value, so that any time greater than the minimum ontime will be matched.

    Valid values

    A valid ontimemin must be a greater than or equal to 0 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone6.segment2.ontimemin

    Minimum ontime of segment 2 of tone 6

    Specifies minimum ontime of segment 2 of tone 6 (msec) for CPA.

    Valid values

    A valid ontimemin must be a greater than or equal to 20 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone6.segment3.f1max

    Maximum frequency 1 of segment 3 of tone 6

    Specifies maximum frequency 1 of segment 3 of tone 6 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone6.segment3.f1min

    Minimum frequency 1 of segment 3 of tone 6

    Specifies minimum frequency 1 of segment 3 of tone 6 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone6.segment3.f2max

    Maximum frequency 2 of segment 3 of tone 6

    Specifies maximum frequency 2 of segment 3 of tone 6 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone6.segment3.f2min

    Minimum frequency 2 of segment 3 of tone 6

    Specifies minimum frequency 2 of segment 3 of tone 6 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone6.segment3.offtimemax

    Maximum offtime of segment 3 of tone 6

    Specifies maximum offtime of segment 3 of tone 6 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone6.segment3.offtimemin

    Minimum offtime of segment 3 of tone 6

    Specifies minimum offtime of segment 3 of tone 6 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone6.segment3.ontimemax

    Maximum ontime of segment 3 of tone 6

    Specifies maximum ontime of segment 3 of tone 6 (msec) for CPA. Setting the value to zero disables checking the ontime against a maximum value, so that any time greater than the minimum ontime will be matched.

    Valid values

    A valid ontimemin must be a greater than or equal to 0 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone6.segment3.ontimemin

    Minimum ontime of segment 3 of tone 6

    Specifies minimum ontime of segment 3 of tone 6 (msec) for CPA.

    Valid values

    A valid ontimemin must be a greater than or equal to 20 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone7.segment1.f1max

    Maximum frequency 1 of segment 1 of tone 7

    Specifies maximum frequency 1 of segment 1 of tone 7 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone7.segment1.f1min

    Minimum frequency 1 of segment 1 of tone 7

    Specifies minimum frequency 1 of segment 1 of tone 7 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone7.segment1.f2max

    Maximum frequency 2 of segment 1 of tone 7

    Specifies maximum frequency 2 of segment 1 of tone 7 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone7.segment1.f2min

    Minimum frequency 2 of segment 1 of tone 7

    Specifies minimum frequency 2 of segment 1 of tone 7 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone7.segment1.offtimemax

    Maximum offtime of segment 1 of tone 7

    Specifies maximum offtime of segment 1 of tone 7 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone7.segment1.offtimemin

    Minimum offtime of segment 1 of tone 7

    Specifies minimum offtime of segment 1 of tone 7 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone7.segment1.ontimemax

    Maximum ontime of segment 1 of tone 7

    Specifies maximum ontime of segment 1 of tone 7 (msec) for CPA. Setting the value to zero disables checking the ontime against a maximum value, so that any time greater than the minimum ontime will be matched.

    Valid values

    A valid ontimemin must be a greater than or equal to 0 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone7.segment1.ontimemin

    Minimum ontime of segment 1 of tone 7

    Specifies minimum ontime of segment 1 of tone 7 (msec) for CPA.

    Valid values

    A valid ontimemin must be a greater than or equal to 20 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone7.segment2.f1max

    Maximum frequency 1 of segment 2 of tone 7

    Specifies maximum frequency 1 of segment 2 of tone 7 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone7.segment2.f1min

    Minimum frequency 1 of segment 2 of tone 7

    Specifies minimum frequency 1 of segment 2 of tone 7 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone7.segment2.f2max

    Maximum frequency 2 of segment 2 of tone 7

    Specifies maximum frequency 2 of segment 2 of tone 7 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone7.segment2.f2min

    Minimum frequency 2 of segment 2 of tone 7

    Specifies minimum frequency 2 of segment 2 of tone 7 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone7.segment2.offtimemax

    Maximum offtime of segment 2 of tone 7

    Specifies maximum offtime of segment 2 of tone 7 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone7.segment2.offtimemin

    Minimum offtime of segment 2 of tone 7

    Specifies minimum offtime of segment 2 of tone 7 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone7.segment2.ontimemax

    Maximum ontime of segment 2 of tone 7

    Specifies maximum ontime of segment 2 of tone 7 (msec) for CPA. Setting the value to zero disables checking the ontime against a maximum value, so that any time greater than the minimum ontime will be matched.

    Valid values

    A valid ontimemin must be a greater than or equal to 0 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone7.segment2.ontimemin

    Minimum ontime of segment 2 of tone 7

    Specifies minimum ontime of segment 2 of tone 7 (msec) for CPA.

    Valid values

    A valid ontimemin must be a greater than or equal to 20 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone7.segment3.f1max

    Maximum frequency 1 of segment 3 of tone 7

    Specifies maximum frequency 1 of segment 3 of tone 7 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone7.segment3.f1min

    Minimum frequency 1 of segment 3 of tone 7

    Specifies minimum frequency 1 of segment 3 of tone 7 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone7.segment3.f2max

    Maximum frequency 2 of segment 3 of tone 7

    Specifies maximum frequency 2 of segment 3 of tone 7 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone7.segment3.f2min

    Minimum frequency 2 of segment 3 of tone 7

    Specifies minimum frequency 2 of segment 3 of tone 7 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone7.segment3.offtimemax

    Maximum offtime of segment 3 of tone 7

    Specifies maximum offtime of segment 3 of tone 7 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone7.segment3.offtimemin

    Minimum offtime of segment 3 of tone 7

    Specifies minimum offtime of segment 3 of tone 7 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone7.segment3.ontimemax

    Maximum ontime of segment 3 of tone 7

    Specifies maximum ontime of segment 3 of tone 7 (msec) for CPA. Setting the value to zero disables checking the ontime against a maximum value, so that any time greater than the minimum ontime will be matched.

    Valid values

    A valid ontimemin must be a greater than or equal to 0 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone7.segment3.ontimemin

    Minimum ontime of segment 3 of tone 7

    Specifies minimum ontime of segment 3 of tone 7 (msec) for CPA.

    Valid values

    A valid ontimemin must be a greater than or equal to 20 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone8.segment1.f1max

    Maximum frequency 1 of segment 1 of tone 8

    Specifies maximum frequency 1 of segment 1 of tone 8 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone8.segment1.f1min

    Minimum frequency 1 of segment 1 of tone 8

    Specifies minimum frequency 1 of segment 1 of tone 8 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone8.segment1.f2max

    Maximum frequency 2 of segment 1 of tone 8

    Specifies maximum frequency 2 of segment 1 of tone 8 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone8.segment1.f2min

    Minimum frequency 2 of segment 1 of tone 8

    Specifies minimum frequency 2 of segment 1 of tone 8 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone8.segment1.offtimemax

    Maximum offtime of segment 1 of tone 8

    Specifies maximum offtime of segment 1 of tone 8 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone8.segment1.offtimemin

    Minimum offtime of segment 1 of tone 8

    Specifies minimum offtime of segment 1 of tone 8 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone8.segment1.ontimemax

    Maximum ontime of segment 1 of tone 8

    Specifies maximum ontime of segment 1 of tone 8 (msec) for CPA. Setting the value to zero disables checking the ontime against a maximum value, so that any time greater than the minimum ontime will be matched.

    Valid values

    A valid ontimemin must be a greater than or equal to 0 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone8.segment1.ontimemin

    Minimum ontime of segment 1 of tone 8

    Specifies minimum ontime of segment 1 of tone 8 (msec) for CPA.

    Valid values

    A valid ontimemin must be a greater than or equal to 20 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone8.segment2.f1max

    Maximum frequency 1 of segment 2 of tone 8

    Specifies maximum frequency 1 of segment 2 of tone 8 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone8.segment2.f1min

    Minimum frequency 1 of segment 2 of tone 8

    Specifies minimum frequency 1 of segment 2 of tone 8 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone8.segment2.f2max

    Maximum frequency 2 of segment 2 of tone 8

    Specifies maximum frequency 2 of segment 2 of tone 8 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone8.segment2.f2min

    Minimum frequency 2 of segment 2 of tone 8

    Specifies minimum frequency 2 of segment 2 of tone 8 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone8.segment2.offtimemax

    Maximum offtime of segment 2 of tone 8

    Specifies maximum offtime of segment 2 of tone 8 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone8.segment2.offtimemin

    Minimum offtime of segment 2 of tone 8

    Specifies minimum offtime of segment 2 of tone 8 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone8.segment2.ontimemax

    Maximum ontime of segment 2 of tone 8

    Specifies maximum ontime of segment 2 of tone 8 (msec) for CPA. Setting the value to zero disables checking the ontime against a maximum value, so that any time greater than the minimum ontime will be matched.

    Valid values

    A valid ontimemin must be a greater than or equal to 0 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone8.segment2.ontimemin

    Minimum ontime of segment 2 of tone 8

    Specifies minimum ontime of segment 2 of tone 8 (msec) for CPA.

    Valid values

    A valid ontimemin must be a greater than or equal to 20 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone8.segment3.f1max

    Maximum frequency 1 of segment 3 of tone 8

    Specifies maximum frequency 1 of segment 3 of tone 8 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone8.segment3.f1min

    Minimum frequency 1 of segment 3 of tone 8

    Specifies minimum frequency 1 of segment 3 of tone 8 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone8.segment3.f2max

    Maximum frequency 2 of segment 3 of tone 8

    Specifies maximum frequency 2 of segment 3 of tone 8 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone8.segment3.f2min

    Minimum frequency 2 of segment 3 of tone 8

    Specifies minimum frequency 2 of segment 3 of tone 8 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone8.segment3.offtimemax

    Maximum offtime of segment 3 of tone 8

    Specifies maximum offtime of segment 3 of tone 8 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone8.segment3.offtimemin

    Minimum offtime of segment 3 of tone 8

    Specifies minimum offtime of segment 3 of tone 8 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone8.segment3.ontimemax

    Maximum ontime of segment 3 of tone 8

    Specifies maximum ontime of segment 3 of tone 8 (msec) for CPA. Setting the value to zero disables checking the ontime against a maximum value, so that any time greater than the minimum ontime will be matched.

    Valid values

    A valid ontimemin must be a greater than or equal to 0 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone8.segment3.ontimemin

    Minimum ontime of segment 3 of tone 8

    Specifies minimum ontime of segment 3 of tone 8 (msec) for CPA.

    Valid values

    A valid ontimemin must be a greater than or equal to 20 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone9.segment1.f1max

    Maximum frequency 1 of segment 1 of tone 9

    Specifies maximum frequency 1 of segment 1 of tone 9 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone9.segment1.f1min

    Minimum frequency 1 of segment 1 of tone 9

    Specifies minimum frequency 1 of segment 1 of tone 9 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone9.segment1.f2max

    Maximum frequency 2 of segment 1 of tone 9

    Specifies maximum frequency 2 of segment 1 of tone 9 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone9.segment1.f2min

    Minimum frequency 2 of segment 1 of tone 9

    Specifies minimum frequency 2 of segment 1 of tone 9 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone9.segment1.offtimemax

    Maximum offtime of segment 1 of tone 9

    Specifies maximum offtime of segment 1 of tone 9 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone9.segment1.offtimemin

    Minimum offtime of segment 1 of tone 9

    Specifies minimum offtime of segment 1 of tone 9 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone9.segment1.ontimemax

    Maximum ontime of segment 1 of tone 9

    Specifies maximum ontime of segment 1 of tone 9 (msec) for CPA. Setting the value to zero disables checking the ontime against a maximum value, so that any time greater than the minimum ontime will be matched.

    Valid values

    A valid ontimemin must be a greater than or equal to 0 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone9.segment1.ontimemin

    Minimum ontime of segment 1 of tone 9

    Specifies minimum ontime of segment 1 of tone 9 (msec) for CPA.

    Valid values

    A valid ontimemin must be a greater than or equal to 20 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone9.segment2.f1max

    Maximum frequency 1 of segment 2 of tone 9

    Specifies maximum frequency 1 of segment 2 of tone 9 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone9.segment2.f1min

    Minimum frequency 1 of segment 2 of tone 9

    Specifies minimum frequency 1 of segment 2 of tone 9 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone9.segment2.f2max

    Maximum frequency 2 of segment 2 of tone 9

    Specifies maximum frequency 2 of segment 2 of tone 9 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone9.segment2.f2min

    Minimum frequency 2 of segment 2 of tone 9

    Specifies minimum frequency 2 of segment 2 of tone 9 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone9.segment2.offtimemax

    Maximum offtime of segment 2 of tone 9

    Specifies maximum offtime of segment 2 of tone 9 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone9.segment2.offtimemin

    Minimum offtime of segment 2 of tone 9

    Specifies minimum offtime of segment 2 of tone 9 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone9.segment2.ontimemax

    Maximum ontime of segment 2 of tone 9

    Specifies maximum ontime of segment 2 of tone 9 (msec) for CPA. Setting the value to zero disables checking the ontime against a maximum value, so that any time greater than the minimum ontime will be matched.

    Valid values

    A valid ontimemin must be a greater than or equal to 0 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone9.segment2.ontimemin

    Minimum ontime of segment 2 of tone 9

    Specifies minimum ontime of segment 2 of tone 9 (msec) for CPA.

    Valid values

    A valid ontimemin must be a greater than or equal to 20 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone9.segment3.f1max

    Maximum frequency 1 of segment 3 of tone 9

    Specifies maximum frequency 1 of segment 3 of tone 9 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone9.segment3.f1min

    Minimum frequency 1 of segment 3 of tone 9

    Specifies minimum frequency 1 of segment 3 of tone 9 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone9.segment3.f2max

    Maximum frequency 2 of segment 3 of tone 9

    Specifies maximum frequency 2 of segment 3 of tone 9 (Hz) for CPA.

    Valid values

    A valid maximum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone9.segment3.f2min

    Minimum frequency 2 of segment 3 of tone 9

    Specifies minimum frequency 2 of segment 3 of tone 9 (Hz) for CPA.

    Valid values

    A valid minimum frequency must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone9.segment3.offtimemax

    Maximum offtime of segment 3 of tone 9

    Specifies maximum offtime of segment 3 of tone 9 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone9.segment3.offtimemin

    Minimum offtime of segment 3 of tone 9

    Specifies minimum offtime of segment 3 of tone 9 (msec) for CPA.

    Valid values

    A valid offtime must be a non-negative numeric

    Default value

    0

    Takes effect At start/restart

    cpa.tone9.segment3.ontimemax

    Maximum ontime of segment 3 of tone 9

    Specifies maximum ontime of segment 3 of tone 9 (msec) for CPA. Setting the value to zero disables checking the ontime against a maximum value, so that any time greater than the minimum ontime will be matched.

    Valid values

    A valid ontimemin must be a greater than or equal to 0 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.tone9.segment3.ontimemin

    Minimum ontime of segment 3 of tone 9

    Specifies minimum ontime of segment 3 of tone 9 (msec) for CPA.

    Valid values

    A valid ontimemin must be a greater than or equal to 20 numeric

    Default value

    20

    Takes effect At start/restart

    cpa.voice_level_db

    Voice level (dB)

    Specifies the active voice signal level (in dB relative to the maximum) for CPA. By default, this value is set to 70% of the default value of Voice range (dB); that is 17.5 dB. The valid range is 1 dB to Voice range (dB) inclusive. If the value is greater than Voice range (dB), it will be set to Voice range (dB).

    Valid values

    A valid voice level must be a number greater than or equal to one

    Default value

    17.5

    Takes effect At start/restart

    cpa.voice_range_db

    Voice range (dB)

    Specifies the minimum signal to noise ratio (or dynamic range) for the CPA signal (in dB). If the difference between the minimum and maximum signal level is less than this threshold, the entire signal is considered to be noise.

    Valid values

    A valid voice range must be an integer greater than zero

    Default value

    25

    Takes effect At start/restart

    ctrleventpoollowthreshold

    Control Event Pool Low Threshold

    Once the mpc.ctrleventpoolthreshold value is reached for an individual event pool, the number of used events in that pool must drop below the low threshold value before calls can be accepted. Only enabled if mpc.ctrleventpoolthreshold is non-zero. The value is in percentage (%).

    Valid values

    A valid value for the ctrleventpoollowthreshold is greater than or equal to 0 and less than or equal to 100.

    Default value

    50

    Takes effect At start/restart

    ctrleventpoolthreshold

    Control Event Pool Threshold

    Specified a threshold for the percentage (%) of events in an individual media event pool can be reached before the MCP will start rejecting calls. Once reached, the number of used events must drop below the percentage specified in mpc.ctrleventpoollowthreshold before calls will be accepted again. When set to 0, this functionality is disabled.

    Valid values

    A valid value for the ctrleventpoolthreshold is greater than or equal to 0 and less than or equal to 100.

    Default value

    75

    Takes effect At start/restart

    default_audio_format

    Default Audio Format

    Default audio format used by the MCP

    Valid values

    • ULAW
    • ALAW

    Default value

    ULAW

    Takes effect At start/restart

    dsp.g711sildetectalgorithm

    G711 Silence Detection Algorithm

    Specifies whether to use the new G711 silence detection algorithm, which allows configurable silence detection behavior.

    Valid values

    • 0
    • 1

    Default value

    1

    Takes effect At start/restart

    dsp.g726littleendian

    G726 Little Endian

    This parameter specifies whether input/output of the G.726 data is in big-endian or in little-endian order. In addition to determining the order of the generated G.726 data, the incoming G.726 data order is assumed to be in the order specified by this parameter.

    Valid values

    • 0
    • 1

    Default value

    0

    Takes effect Immediately/session

    dsp.g729a

    G.729 Annex A

    Specifies whether to use G.729 Annex A for G.729 transcoding.

    Valid values

    • 0
    • 1

    Default value

    0

    Takes effect Immediately

    dtmf.detectedge

    DTMF Detect Edge

    Specifies whether a DTMF will be recognized on the "rising" edge (1st RFC2833 packet), or on the "falling" edge (when any of the following event happens: 1st RFC2833 packet with "E" bit set, upon receipt of a RTP packet that is not for the same DTMF event, or after the maximum silence gap timeout.

    Valid values

    • 0
    • 1

    Default value

    0

    Takes effect At start/restart

    dtmf.duration

    DTMF Duration

    Specifies the duration (in milliseconds) of outgoing RFC2833 DTMF packets. Default value is 200.

    Valid values

    Possible values are integers from 10 to 1000 inclusive

    Default value

    200

    Takes effect At start/restart

    dtmf.gap

    DTMF Gap

    Specifies the gap between an outgoing RFC2833 DTMF packet and the following outgoing packet in milliseconds.

    Valid values

    Possible values are integers from 10 to 1000 inclusive.

    Default value

    100

    Takes effect At start/restart

    dtmf.inband_amplitude

    Inband DTMF Amplitude

    Specifies the amplitude for inband dtmf generator. The higher the the value, the greater the output amplitude in terms of dB. The default value of 15000 gives approximately -20dB while 3000 gives approximately -35dB for example.

    Valid values

    Possible values are integers from 0 to 32,767 inclusive.

    Default value

    15000

    Takes effect At start/restart

    dtmf.maxsilence

    Maximum DTMF Silence

    The maximum silence permitted between same inband DTMF tones in ms to be considered no longer part of the same DTMF.

    Valid values

    mpc.dtmf.maxsilence must be an integer that is at least equal to 0 and less than or equal to 120.

    Default value

    20

    Takes effect At start/restart

    dtmf.minduration

    Minimum DTMF Duration

    Specifies the minimum duration of DTMF events in ms (either inband or RFC2833) required before a DTMF is detected by the dialog. Must be greater than or equal to 0ms.

    Valid values

    mpc.dtmf.minduration must be an integer that is greater than or equal to 0 and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    0

    Takes effect At start/restart

    dtmf.multidtmfonetimestamp

    Multiple DTMFs Using One Timestamp

    Specifies whether the RFC2833 packets of multiple DTMFs will have the same timestamp. If it is true, the End bit is used to differentiate the DTMFs.

    Valid values

    • 0
    • 1

    Default value

    0

    Takes effect At start/restart

    dtmf.pauseduration

    DTMF Pause Duration

    Specifies the duration (in milliseconds) for the duration of a pause ('p') DTMF.

    Valid values

    Possible values are integers from 10 to 1000 inclusive

    Default value

    200

    Takes effect At start/restart

    dtmf.singlepacket

    DTMF Single Packet

    When set to Disable, outgoing DTMF are represented by multiple (depends on mpc.dtmf.duration) RFC2833 packets followed by 3 RFC2833 packets with the End bit set. When set to Enable, outgoing DTMF are represented by a single RFC2833 packet with the End bit set.

    Valid values

    • 0
    • 1

    Default value

    0

    Takes effect At start/restart

    fcr.defaultdtmfhandling

    FCR Default DTMF Handling

    Specifies the recording behavior for DTMFs in a Full Call Recording.

    Valid values

    • as-is
    • no-digits
    • all-digits
    as-is: (default) Record everything as-is from the RTP stream. Inband DTMFs will be recorded, but RFC2833 digits will not
    no-digits: Strip out all DTMF digits. This includes inband or RFC2833. NOTE: When telephone-event is negotiated on the call, if inband audio DTMFs are received, they will not be removed from the recording.
    all-digits: Record all DTMF digits, including inband, and generate audio for RFC2833 digits

    Default value

    as-is

    Takes effect Immediately/session

    fcr.gain

    FCR Gain

    Gain (in dB from -30 to 30) applied to audio used in Full Call Recording (both input from the caller and output to the caller) from call participants.

    Valid values

    The number must be an integer from -30 to 30 inclusive

    Default value

    0

    Takes effect At start/restart

    font_paths_linux

    Font Directory Paths (Linux)

    List of paths of font directories on a Linux MCP system, separated by the delimiter '|'. This information is used by the Video Text Overlay feature. All the font files are scanned at start-up, and their font name to file name mapping information is cached for fast look-up later. An empty value will disable the feature. The special value "default" can be used for the builtin default value.

    Default value

    /usr/share/fonts/default/ghostscript

    Takes effect At start/restart

    font_paths_win

    Font Directory Paths (Windows)

    List of paths of font directories on a Windows MCP system, separated by the delimiter '|'. This information is used by the Video Text Overlay feature. All the font files are scanned at start-up, and their font name to file name mapping information is cached for fast look-up later. An empty value will disable the feature. The special value "default" can be used for the builtin default value.

    Default value

    C:/Windows/Fonts

    Takes effect At start/restart

    g722.maxptime

    G.722 maxptime

    If the MCP is offering the SDP, or answering the SDP where the offer does not have the maxptime, the maxptime attribute will be set according to this configuration. If this configuration does not exist, or is disabled, the maxptime attribute will not be sent unless the SDP offer had the maxptime attribute. In the case where other codecs in the SDP also specify maxptime, the configuration of the codec listed before this codec will take precedence.

    Valid values

    • 0
    • 10
    • 20
    • 30
    • 40
    • 60
    • 80
    • 100

    Default value

    0

    Takes effect Immediately

    g722.ptime

    G.722 ptime

    If the MCP is offering the SDP or answering the SDP where the offer does not have the ptime, the ptime attribute will be set according to this configuration. This configuration is also used as the transmission rate of this codec when the remote SDP does not specify the ptime attribute. Note that transmission rate will default to 20ms if this configuration is disabled. If disabled, ptime attribute will not be sent unless the SDP offer had the ptime attribute. In the case where the other codecs in the SDP also specify the configured ptime, the configuration of the codec listed before this codec will take precedence.

    Valid values

    • 0
    • 10
    • 20
    • 30
    • 40
    • 60
    • 80
    • 100

    Default value

    0

    Takes effect Immediately

    g726_32.maxptime

    G.726-32 maxptime

    If the MCP is offering the SDP, or answering the SDP where the offer does not have the maxptime, the maxptime attribute will be set according to this configuration. If this configuration does not exist, or is disabled, the maxptime attribute will not be sent unless the SDP offer had the maxptime attribute. In the case where other codecs in the SDP also specify maxptime, the configuration of the codec listed before this codec will take precedence.

    Valid values

    • 0
    • 10
    • 20
    • 30
    • 40
    • 60

    Default value

    0

    Takes effect Immediately

    g726_32.ptime

    G.726-32 ptime

    If the MCP is offering the SDP or answering the SDP where the offer does not have the ptime, the ptime attribute will be set according to this configuration. This configuration is also used as the transmission rate of this codec when the remote SDP does not specify the ptime attribute. Note that transmission rate will default to 20ms if this configuration is disabled. If disabled, ptime attribute will not be sent unless the SDP offer had the ptime attribute. In the case where the other codecs in the SDP also specify the configured ptime, the configuration of the codec listed before this codec will take precedence.

    Valid values

    • 0
    • 10
    • 20
    • 30
    • 40
    • 60

    Default value

    0

    Takes effect Immediately

    g729.fmtp

    G729 FMTP

    Specifies the default G729 fmtp option string used by the platform when initiating SDP offer or answering SDP offer. When initiating SDP offer, if No fmtp is selected, fmtp attribute line for G729 will not be present in SDP offered by the platform. If annexb enabled is selected, fmtp attribute line for G729 will be present as "annexb=yes". If annexb disabled is selected, fmtp attribute line for G729 will be shown as "annexb=no". When answering to an SDP offer with a valid G729 fmtp line, this parameter has no effect and the platform will reply to the offer with the same fmtp line. When answering to an SDP offer without an fmtp line or with an invalid G729 fmtp line, the platform will reply to the offer using this configuration value with the same rule as initiating SDP offer.

    Valid values

    • annexb=yes
    • annexb=no

    Default value

    (blank)

    Takes effect At start/restart

    g729.maxptime

    G.729 maxptime

    If the MCP is offering the SDP, or answering the SDP where the offer does not have the maxptime, the maxptime attribute will be set according to this configuration. If this configuration does not exist, or is disabled, the maxptime attribute will not be sent unless the SDP offer had the maxptime attribute. In the case where other codecs in the SDP also specify maxptime, the configuration of the codec listed before this codec will take precedence.

    Valid values

    • 0
    • 10
    • 20
    • 30
    • 40
    • 60
    • 80
    • 100

    Default value

    0

    Takes effect Immediately

    g729.ptime

    G.729 ptime

    If the MCP is offering the SDP or answering the SDP where the offer does not have the ptime, the ptime attribute will be set according to this configuration. This configuration is also used as the transmission rate of this codec when the remote SDP does not specify the ptime attribute. Note that transmission rate will default to 20ms if this configuration is disabled. If disabled, ptime attribute will not be sent unless the SDP offer had the ptime attribute. In the case where the other codecs in the SDP also specify the configured ptime, the configuration of the codec listed before this codec will take precedence.

    Valid values

    • 0
    • 10
    • 20
    • 30
    • 40
    • 60
    • 80
    • 100

    Default value

    0

    Takes effect Immediately

    gsm.maxptime

    GSM 06.10 maxptime

    If the MCP is offering the SDP, or answering the SDP where the offer does not have the maxptime, the maxptime attribute will be set according to this configuration. If this configuration does not exist, or is disabled, the maxptime attribute will not be sent unless the SDP offer had the maxptime attribute. In the case where other codecs in the SDP also specify maxptime, the configuration of the codec listed before this codec will take precedence.

    Valid values

    • 0
    • 20
    • 40
    • 60
    • 80
    • 100

    Default value

    0

    Takes effect immediately

    gsm.ptime

    GSM 06.10 ptime

    If the MCP is offering the SDP or answering the SDP where the offer does not have the ptime, the ptime attribute will be set according to this configuration. This configuration is also used as the transmission rate of this codec when the remote SDP does not specify the ptime attribute. Note that transmission rate will default to 20ms if this configuration is disabled. If disabled, ptime attribute will not be sent unless the SDP offer had the ptime attribute. In the case where the other codecs in the SDP also specify the configured ptime, the configuration of the codec listed before this codec will take precedence.

    Valid values

    • 0
    • 20
    • 40
    • 60
    • 80
    • 100

    Default value

    0

    Takes effect immediately

    h263.fmtp

    H263 FMTP

    Specifies the SDP fmtp line offered and accepted by MCP for H263 and H263-1998. The value is in the format: [;...][|[;...]...] Note that the list of tokens are grouped by separating them by a vertical bar - each group of tokens represent a separate SDP fmtp line. When more than 1 fmtp's are specified, H263-1998 negotiation will use all of the fmtp's as the local fmtp (for example offer generation will generate 3 payloads for 3 fmtp's). For H263, only the first fmtp will be used as the local fmtp. Following tokens are accepted: profile= level= SQCIF= QCIF= CIF= CIF4= CIF16= CUSTOM=,, F=1 I=1 J=1 T=1 K=1 N=1 P=1 profile - Profile from 0 to 8 can be specified. level - Level from 10 to 70 are supported. SQCIF - Specifies 128 x 96 video resolution with fps @ 30000 / (1001 * mpi) QCIF - Specifies 176 x 144 video resolution with fps @ 30000 / (1001 * mpi) CIF - Specifies 352 x 288 video resolution with fps @ 30000 / (1001 * mpi) CIF4 - Specifies 704 x 480 video resolution with fps @ 30000 / (1001 * mpi) CIF16 - Specifies 1408 x 1152 video resolution with fps @ 30000 / (1001 * mpi) CUSTOM - Specifies custom video resolution with fps @ 30000 / (1001 * mpi) F=1 - Specifies that annex F (from ITU-T Recommendation H.263, January 2005) is supported. I=1 - Specifies that annex I (from ITU-T Recommendation H.263, January 2005) is supported. J=1 - Specifies that annex J (from ITU-T Recommendation H.263, January 2005) is supported. T=1 - Specifies that annex T (from ITU-T Recommendation H.263, January 2005) is supported. K=1 - Specifies that annex K (from ITU-T Recommendation H.263, January 2005) is supported. Not supported when H263 transcoding is enabled. N=1 - Specifies that annex N (from ITU-T Recommendation H.263, January 2005) is supported. Not supported when H263 transcoding is enabled. P=1 - Specifies that annex P (from ITU-T Recommendation H.263, January 2005) is supported. Please see RFC4629 for more details. If H263 transcoding is enabled for the session, the fmtp containing the following tokens will not be offered and also not accepted by MCP: - profile value other than 0 - K=1 - N=1 If H263 transcoding is enabled and h263.fmtp is not specified, the following fmtp value will be set by default: profile=0;level=70|profile=0;level=70;F=1;I=1;J=1;T=1;P=1 If H263 transcoding is disabled and h263.fmtp is not specified, no fmtp will be generated in the offer and all fmtp's will be accepted by MCP. If H263 transcoding is disabled and h263.fmtp is not specified, fmtp negotiation will be done without the transcoding restrictions imposed on the allowed tokens.

    Default value

    (blank)

    Takes effect At start/restart

    h263_1998payload

    H263-1998 Payload

    Default payload type number to use for the H263-1998 codec

    Valid values

    A valid H263-1998 payload can only be an integer from 96 to 127 inclusive

    Default value

    99

    Takes effect At start/restart

    h264.fmtp

    H264 FMTP

    Specifies the H264 SDP profile, level and packetization mode offered and accepted by the MCP. Set to one or more fmtp text values separated by the '|' character. One fmtp text is in the form of "profile=X; level=Y; packetization-mode=Z;".
    X is an element of the set {*, b, cb, m, e, h, h10, h10i, h42, h42i, h44, h44i, c44i} specifying the H264 profile offered and accepted by the MCP. In the set, * is used as the wildcard to allow the MCP to offer and accept any valid profile. The rest of the set are profiles defined by H264 whose full name are (in respective order as the aforementioned set): {baseline, constrained baseline, main, extended, high, high 10, high 10 intra, high 4:2:2, high 4:2:2 intra, high 4:4:4, high 4:4:4 intra, cavlc 4:4:4 intra}. Invalid profile value will be replaced with * (wildcard).
    Y is an element of the set {*, 1, 1b, 1.1, 1.2, 1.3, 2, 2.1, 2.2, 3, 3.1, 3.2, 4, 4.1, 4.2, 5, 5.1} specifying the H264 level of the corresponding profiles offered and accepted by the MCP. In the set, * is used as the wildcard to allow MCP to offer and accept any valid level for its corresponding profile. The rest of the set are levels defined by H264. Invalid level value will be replaced with * (wildcard).
    Z is an element of the set {*, 0, 1} specifying the H264 packetization mode offered and accepted by the MCP. Similar to the others, * is used as the wildcard to allow the MCP to offer and accept any valid packetization mode. 0 refers to single NALU packetization mode while 1 demands non-interleaved packetization capability. The MCP does not support interleaved packetization mode, as well as, any value other than stated. Invalid packetization-mode value will be replaced with 0 (single NALU).
    During SDP negotiation, each fmtp text value without wildcard will be translated to one H264 media fmtp line while those with wildcard will be translated to one or more H264 media fmtp line equivalent to the wildcard.
    For example, profile=b; level=1.1; packetization-mode=* which is the first part of the default will be translated to two H264 media fmtp lines of profile-level-id=42000B; packetization-mode=0; and profile-level-id=42000B; packetization-mode=1;. Note that profile "b" is equivalent to 66 in decimal or 42 in hexadecimal and level "1.1" is equivalent to level 11 in decimal or level 0B in hexadecimal.
    According to RFC3984, the use of profile-level-id and packetization-mode during capability exchange must be negotiated symmetrically except the level part can be downgraded. For example, the MCP is configured with h264.fmtp="profile=b; level=1; packetization-mode=1;" and it receives an offer with H264 media fmtp line of profile-level-id=420033; packetization-mode=1; which is equivalent to h264.fmtp="profile=b; level=5.1; packetization-mode=1". In this case, the profile and packetization-mode of the platform and the offer are symmetric but the level parts are not. This offer will be accepted by the MCP with level downgrade in its response, e.g. "profile-level-id=42000A; packetization-mode=1". The offerer when receiving the response will know that the answerer has accepted the offer but the level must be downgraded and the offerer will have to produce the H264 content accordingly when proceeding with this response.
    Another example, the MCP is configured with h264.fmtp="profile=b; level=5.1; packetization-mode=1" and it receives an offer with H264 media fmtp line of profile-level-id-42000A; packetization-mode=1; which is equivalent to h264.fmtp="profile=b; level=1; packetization-mode=1". In this case, the profile and packetization-mode of the platform and the offer are symmetric but the level parts are not. This offer will still be accepted by the MCP without level downgrade in its response, e.g. "profile-level-id=42000A; packetization-mode=1;". The MCP accepts the offer because it is configured with a higher level which is capable of processing any lower level. The offerer will receive the response that the MCP has accepted the offer. H264 transcoder does not support extended and advanced 4:4:4 profiles. Consequently, if H264 transcoding is enabled for the session, the fmtp containing one of the following profiles (whether enumerated by * or explicitly configured) will not be offered and also not accepted during the SDP negotiation: {e, h44, h44i, c44i}

    Default value

    profile=b; level=3.1; packetization-mode=*;|profile=cb; level=3.1; packetization-mode=*;|profile=m; level=3.1; packetization-mode=*;

    Takes effect At start/restart

    h264.in_band_param_sets_only

    H264 Inband Parameter Sets Enforcement

    This parameter specifies the utilization of sprop-parameter-sets attributes of the initial SDP offered to MCP. It does not; however, apply to any SDP offered by MCP as MCP does not send any sprop-parameter-sets in its SDP offering to another party.
    When set to Disable (default), if any profile-level-id plus packetization-mode in the initial offered SDP is accepted by MCP without level downgrade, MCP will utilize the H264 parameter sets value provided by sprop-parameter-sets attributes if present and valid. Refer to H264 FMTP for more detail on how profile-level-id and packetization-mode are negotiated.
    When set to Enable, MPC will not utilize any H264 parameter sets value provided by sprop-parameter-sets attributes in the offered SDP. Attribute in-band-parameter-sets=1 will be included in the response SDP for any H264 media line to explicitly declare that only parameter sets received via RTP will be utilized and that implicitly forces the offerer to include all parameter sets within RTP packets.

    Valid values

    • 0
    • 1

    Default value

    0

    Takes effect At start/restart

    h264payload

    H264 Payload

    Default payload type number to use for the H264 codec

    Valid values

    A valid H264 payload can only be an integer from 96 to 127 inclusive

    Default value

    113

    Takes effect At start/restart

    includeavpfinsdp

    Including AVPF or SAVPF in SDP

    Sets if the MCP will include SAVPF / AVPF instead of SAVP / AVP in SDP. If set to "none" (default), SAVP / AVP will be used. If set to "audio", only audio will have SAVPF / AVPF. If set to "video", only video will have SAVPF / AVPF. If set to "audioandvideo", both audio and video will have SAVPF / AVPF.

    Valid values

    • none
    • audio
    • video
    • audioandvideo

    Default value

    none

    Takes effect Immediately/session

    maxmediathreads

    Max Media Threads

    Specifies the maximum number of media threads that can be created within MPC. Default value is 16. It is highly recommended to use the default setting.

    Valid values

    mpc.maxmediathreads must be an integer greater than 0 and less than or equal to 100

    Default value

    16

    Takes effect At start/restart

    maxrecordfilesize

    Maximum Record File Size

    All recordings (regular and FCR) will stop when this limit (bytes) is exceeded. Note that the recorded file will usually exceed this limit by a few hundred bytes depending on the codec and the container chosen. Value of 0 disables this limit.

    Valid values

    mpc.maxrecordfilesize is greater than or equal to 0 and less than or equal to 4000000000.

    Default value

    0

    Takes effect Immediately/session

    mediamgr.audiobuffersize

    MediaMgr Audio Buffer Size

    Specifies the audio buffer size for the non-TTS source (in bytes). Default value is 102400.

    Valid values

    Possible values are integer values greater than or equal to 1024 and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    102400

    Takes effect At start/restart

    mediamgr.h263overrideTR

    H263 Override TR

    This parameter is for video recording with H263 and H263-1998 video codec. Whenever video/audio out-of-sync happens in recorded files, enabling this parameter may solve the issue. By default the MCP uses an inherent property available in each H263 video sample called Temporal Reference to determine timing between each video sample in a recording session. Video/audio out-of-sync in recorded files, however, may occur if the Temporal References in the video frames are incorrect. Setting this parameter to Enable will allow the MCP to correct Temporal Reference and try to synchronize video and audio during recording sessions. Setting this parameter to Disable will keep the Temporal Reference intact.

    Valid values

    • 0
    • 1

    Default value

    1

    Takes effect At start/restart

    mediamgr.isofilerecordheadersize

    ISO File Record Header Size

    The header of ISO file container grows as the content of the file grows. The MCP will reserve the header size to harddrive before recording media of an ongoing session. The MCP will actually record header at the end of the session and harddrive operations may be required if the reserved header size is not enough to accommodate the actual header size.

    Valid values

    mpc.mediamgr.isofilerecordheadersize must be an integer that is greater than 0 and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    55000

    Takes effect At start/restart

    mediamgr.rec_iframe_delay_threshold

    Recording iFrame Delay Threshold

    This parameter is for video recording with audio and video. When starting a recorder, a few initial video frames may be dropped as the first self-referencing intra frame is not received for some reasons. As a result, audio duration received prior to receiving the next self-referencing video frame may be too long and it makes audio and video get out-of-sync. This parameter limits how long in milliseconds the audio is allowed in this situation without having to do video filling. The value of -1 will disable this feature.

    Valid values

    mpc.mediamgr.rec_iframe_delay_threshold must be an integer at least equal to -1 and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    160

    Takes effect At start/restart

    mediamgr.recordrtphinttrack

    MediaMgr Record RTP Hint Track

    For ISO file container, recording a hint track for a media track into a recording file allows the file to be streamed when placed on a streaming server.

    Valid values

    • 0
    • 1

    Default value

    0

    Takes effect At start/restart

    mediamgr.rtsplowerbufferthreshold

    MediaMgr RTSP Lower Buffer Threshold

    If mpc.media.rtsppause is set to 1, and RTP streaming has been paused. PLAY will be sent to resume RTP streaming if the packet buffer size has reduced to the lower threshold. Default value is 100 packets. The lower threshold must be smaller than the upper threshold. This value can be overridden using the RTSP URL parameter "vg-rtsp-lowerbufferthreshold".

    Valid values

    mpc.mediamgr.rtsplowerbufferthreshold must be an integer that is greater than 0 and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    100

    Takes effect At start/restart

    mediamgr.rtsppause

    MediaMgr RTSP Pause

    Select the option based on RTSP server support for PAUSE. This value can be overridden using the RTSP URL parameter "vg-rtspserver-pause".

    Valid values

    • 0
    • 1

    Default value

    1

    Takes effect At start/restart

    mediamgr.rtspplayrange

    MediaMgr RTSP Play Range

    Select the option based on RTSP server support for the Range parameter in a PLAY request. This value can be overridden using the RTSP URL parameter "vg-rtspserver-playrange".

    Valid values

    • 0
    • 1

    Default value

    1

    Takes effect At start/restart

    mediamgr.rtspupperbufferthreshold

    MediaMgr RTSP Upper Buffer Threshold

    If mpc.media.rtsppause is set to 1, PAUSE will be sent to stop RTP streaming when the packet buffer size has reached the upper threshold. Default value is 200 packets. This value can be overridden using the RTSP URL parameter "vg-rtsp-upperbufferthreshold".

    Valid values

    mpc.mediamgr.rtspupperbufferthreshold must be an integer that is greater than 0 and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    200

    Takes effect At start/restart

    mediamgr.sharedhttpservers

    Live HTTP Streaming Server Addresses

    Specifies the live HTTP server addresses (without port) delimited by space - address can be a hostname, IPv4, or IPv6 address.
    e.g. genesyslab.com [fe80:0:0:0:200:f8ff:fe21:67cf] 192.168.0.101 dummyhost 192.168.0.102 3ffe:1900:4545:3:200:f8ff:fe21:67cf
    If HTTP URL play request has streaming turned on and the URL address is one of the addresses specified by this configuration, the HTTP URL will be played in live HTTP streaming mode.
    In live HTTP streaming mode, multiple sessions specifying the same URL will play from the same HTTP stream, and newly starting sessions will start playing from the currently arriving media.

    Default value

    (blank)

    Takes effect At start/restart

    mediamgr.strictsamplingrate

    Strict Sampling Rate

    The sampling rate that is officially supported for audio is 8000 Hz and video is 90000 Hz. Some media files may indicate a different sampling rate than what supported and trying to play those files may result in bad media quality. If this parameter is set to Enable, media files indicating any sampling rate other than officially supported will not be played. If this parameter is set to Disable, media files indicating any sampling rate other than supported will still be attempted to play by MCP but without guarantee quality.

    Valid values

    • 0
    • 1

    Default value

    0

    Takes effect At start/restart

    mediamgr.videobuffersize

    MediaMgr Video Buffer Size

    Specifies the video buffer size for non-TTS source (in bytes). This value should be sufficient for buffering up to 1 second of all supported modes of H263 and H264 video stream. Refer to the appropriate specification, e.g. ITU-T H.263 for H.263 and ITU-T H.264 for H.264, and GVP User Guide to determine the size to set to avoid overrunning the video buffer.

    Valid values

    Possible values are integer values greater than or equal to 8000 and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    256000

    Takes effect At start/restart

    mediamgr.videofillingframeduration

    Video Filling Frame Duration

    This parameter is for video recording with audio and video. It is used when video filling happens, e.g. the total duration of video frames dropped exceeds mpc.mediamgr.rec_iframe_delay_threshold. When doing video filling, the duration of between the first and second recorded video frame will be stretched so that synchronization between audio and video is maintained. This parameter limits how long the duration in milliseconds between two video frames can be stretched and guides the recorder to regenerate more than one video frame until it completes video filling duration. Note that the value of this parameter should not exceed that of mpc.mediamgr.maxdurationpervidframe. Half the value of mpc.mediamgr.maxdurationpervidframe is recommended and is set as the default.

    Valid values

    mpc.mediamgr.videofillingframeduration must be an integer that is greater than 32 and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    1000

    Takes effect At start/restart

    mediamgr.videofillingthreshold

    Video Filling Threshold

    This parameter is for video recording. It is used to decide when to trigger video filling; i.e., when the interval between the current and the last frame exceeds this threshold, video filling will be done on the next I-frame for this gap, with a new frame being created for each "videofillingframeduration". This parameter is in milliseconds, and this feature can be disabled by setting this to 0 or a large value.

    Valid values

    mpc.mediamgr.videofillingthreshold must be a postive integer that is 0 or greater and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    2000

    Takes effect At start/restart

    mixer.audiodelay_flush_all_threshold

    Audio Delay Flush All Threshold

    Specifies the maximum difference between the current and expected packet time stamps when mixer flushes all buffered packets. The units are in milliseconds. Default value is 500. Setting to zero disables flushing.

    Valid values

    mpc.mixer.audiodelay_flush_all_threshold must be an integer that is at least equal to 0 and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    500

    Takes effect At start/restart

    mixer.audiodelay_flush_silence_threshold

    Audio Delay Flush Silence Threshold

    Specifies the maximum difference between the current and expected silent packet time stamps when mixer flushes silent buffered packets. The units are in milliseconds. Default value is 100. Setting to zero disables flushing.

    Valid values

    mpc.mixer.audiodelay_flush_silence_threshold must be an integer that is at least equal to 0 and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    100

    Takes effect At start/restart

    mp3.bitrate

    MP3 Encoding Bitrate

    This specifies the MP3 encoding bitrate in Kbits/Second, which will determine the quality and size of a recorded MP3 file. Beware that bitrates above 160 kbps are not supported when sampling rate is less than 32 KHz, i.e., 16 KHz, as per MPEG 2 Layer 3 standard.

    Valid values

    • 32
    • 48
    • 64
    • 96
    • 128
    • 160
    • 192
    • 256
    • 320

    Default value

    128

    Takes effect At start/restart

    mp3.samplingrate

    MP3 Sampling Rate

    This specifies the MP3 sampling rate used in encoding, in KHz. MPEG 1 Layer 3 standard is used for encoding when the sampling rate is 32 KHz or higher, while MPEG 2 Layer 3 standard is used when it is lower. Beware that 16 KHz is not supported when MP3 integer transcoder option is enabled.

    Valid values

    • 16
    • 32
    • 48

    Default value

    32

    Takes effect At start/restart

    mp3.use_integer_transcoder

    MP3 Transcoder Type

    This can be used to specify the type of MP3 transcoder. When set to false, a floating point implementation is used; else if set to true, an integer implementation is used.

    Default value

    false

    Takes effect At start/restart

    pcma.maxptime

    G.711 A-law maxptime

    If the MCP is offering the SDP, or answering the SDP where the offer does not have the maxptime, the maxptime attribute will be set according to this configuration. If this configuration does not exist, or is disabled, the maxptime attribute will not be sent unless the SDP offer had the maxptime attribute. In the case where other codecs in the SDP also specify maxptime, the configuration of the codec listed before this codec will take precedence.

    Valid values

    • 0
    • 10
    • 20
    • 30
    • 40
    • 60
    • 80
    • 100

    Default value

    0

    Takes effect Immediately

    pcma.ptime

    G.711 A-law ptime

    If the MCP is offering the SDP or answering the SDP where the offer does not have the ptime, the ptime attribute will be set according to this configuration. This configuration is also used as the transmission rate of this codec when the remote SDP does not specify the ptime attribute. Note that transmission rate will default to 20ms if this configuration is disabled. If disabled, ptime attribute will not be sent unless the SDP offer had the ptime attribute. In the case where the other codecs in the SDP also specify the configured ptime, the configuration of the codec listed before this codec will take precedence.

    Valid values

    • 0
    • 10
    • 20
    • 30
    • 40
    • 60
    • 80
    • 100

    Default value

    0

    Takes effect Immediately

    pcmu.maxptime

    G.711 u-law maxptime

    If the MCP is offering the SDP, or answering the SDP where the offer does not have the maxptime, the maxptime attribute will be set according to this configuration. If this configuration does not exist, or is disabled, the maxptime attribute will not be sent unless the SDP offer had the maxptime attribute. In the case where other codecs in the SDP also specify maxptime, the configuration of the codec listed before this codec will take precedence.

    Valid values

    • 0
    • 10
    • 20
    • 30
    • 40
    • 60
    • 80
    • 100

    Default value

    0

    Takes effect Immediately

    pcmu.ptime

    G.711 u-law ptime

    If the MCP is offering the SDP or answering the SDP where the offer does not have the ptime, the ptime attribute will be set according to this configuration. This configuration is also used as the transmission rate of this codec when the remote SDP does not specify the ptime attribute. Note that transmission rate will default to 20ms if this configuration is disabled. If disabled, ptime attribute will not be sent unless the SDP offer had the ptime attribute. In the case where the other codecs in the SDP also specify the configured ptime, the configuration of the codec listed before this codec will take precedence.

    Valid values

    • 0
    • 10
    • 20
    • 30
    • 40
    • 60
    • 80
    • 100

    Default value

    0

    Takes effect Immediately

    persistdympayfmtpair

    Persistent pair of dynamic payload and format

    With regards to RFC3264, a history of mappings from payload to format per m-line should be maintained for a session. This is to ensure a dynamic payload assigned to a particular format per m-line will not be reused for a different format when given a reINVITE and asked for an offer. When enabled, the aforementioned behavior will be performed. Note that a given reINVITE with an offer will be responded with regards to, if any, the given dynamic payloads, not the maintained payloads, due to backward-compatibility. When disabled, the legacy GVP method, where history is not remembered, will be used.

    Valid values

    • 0
    • 1

    Default value

    1

    Takes effect Immediately

    playcache.checkversiontime

    Play Cache Check Version Time

    This parameter sets the time period for checking that the source media of a cache entry has changed. This parameter does not apply to http://, https://, and file:// URL types, see note below.
    When a entry in the cache is played, the source media will be checked for change if it has not been checked within this time period. If source media has been found to change the cache file(s) will be recreated using the changed media. Setting the value to zero will cause a check to be performed for every play. The value is set in seconds. The default value is 300.
    For http://, https://, and file:// URL types, the checking of the source media for changes is handled by the fetching module so this parameter does not apply. For these URL types, if the media content provided by the fetching module changes it will be used on the next play. An exception to this is that for file:// URL types, this parameter does not apply if the prompt is played using the MSML tag with precheck disabled.

    Valid values

    The parameter must be set to integer of value 0 or greater.

    Default value

    300

    Takes effect Immediately/session

    playcache.directory

    Play Cache Directory

    This parameter sets the root directory of the play cache.

    Valid values

    The parameter must be set to a directory path.

    Default value

    $installationRoot$/cache/play

    Takes effect At start/restart

    playcache.enable

    Play Cache Enable

    This parameter enables the use of the play cache for media playing. When enabled, media played from http://, file://, rtsp://, and qtmf:// URL types will utilize the play cache. When transcoding is required to play the audio or video media from a source URL to an endpoint with particular audio and or video codecs settings, the play cache will save the transcoded media to audio and or video track file(s), and the media will be played from these track files the next time the URL is played to an endpoint with the same (or compatible) codecs settings. The play cache is enabled by default.

    Valid values

    • 0
    • 1

    Default value

    1

    Takes effect Immediately/session

    playcache.expiretime

    Play Cache Expire Time

    This parameter sets expire time for media URL entries in the play cache. If the amount of time since an entry for a media URL has been played exceeds this time, the entry will be deleted from the play cache. The format is hours:minutes or hours. Setting the value to zero disables deleting based on expire time. The default value is 24:00.

    Valid values

    The parameter must be set to format hours:minutes or hours, where hours and minutes are numeric values

    Default value

    24:00

    Takes effect At start/restart

    playcache.maxsize

    Play Cache Maximum Size

    This parameter sets the maximum disk space for the play cache. If the amount of disk space used by the play cache exceeds this value, cache entries will be deleted, starting with the least recently played. The value is set in MBytes. Setting the value to zero disables deleting based on disk spaced used. The default value is 500.

    Valid values

    The parameter must be set to integer greater than or equal to zero.

    Default value

    500

    Takes effect At start/restart

    playremoteeodtimeout

    Remote EOD callback timeout

    Specifies the duration in milliseconds to wait for remote buffer end of data callback. Playback by platform may involve data buffering locally and remotely, e.g. MCP as the local entity and PSTN-C as the remote one. After the local entity sends its very last packet to the remote, an EOD request will be issued to the remote entity where it will have to respond when its very last packet has been played. If there is no reply from the remote within this period, the local entity will issue a timeout on waiting and proceed.

    Valid values

    mpc.playremoteeodtimeout must be an integer greater than 0

    Default value

    10000

    Takes effect At start/restart

    playremoteflushtimeout

    Remote buffer flush callback timeout

    Specifies the duration in milliseconds to wait for remote buffer flush callback. Playback by platform may involve data buffering locally and remotely, e.g. MCP as the local entity and PSTN-C as the remote one. After the local entity flushes its buffer, a flush request will be issued to the remote entity where it will have to respond. If there is no reply from the remote within this period, the local entity will issue a timeout on waiting and proceed.

    Valid values

    mpc.playremoteflushtimeout must be an integer greater than 0

    Default value

    10000

    Takes effect At start/restart

    playsilencefill

    Play Silence Fill

    Specifies the amount of silence fill in milliseconds to add at the end of prompt play. Default is 160. Setting to zero disables play silence fill.

    Valid values

    mpc.playsilencefill must be an integer that is greater than or equal to 0 and less than or equal to 1000.

    Default value

    160

    Takes effect At start/restart

    preferredipinterface

    Preferred IP Interface

    Specifies the preferred IP interface to use (IPv4 or IPv6) when performing SDP negotiation. In particular, this will be used to set the root connection attribute in SDP answers, and set the connection attribute in SDP offers.

    Valid values

    • V4
    • V6

    Default value

    V4

    Takes effect Immediately

    record.defaultdtmfhandling

    Record Default DTMF Handling

    Specifies the recording behavior for DTMFs in a Simple Recording.

    Valid values

    • as-is
    • no-digits
    • all-digits
    as-is: (default) Record everything as-is from the RTP stream. Inband DTMFs will be recorded, but RFC2833 digits will not
    no-digits: Strip out all DTMF digits. This includes inband or RFC2833. NOTE: When telephone-event is negotiated on the call, if inband audio DTMFs are received, they will not be removed from the recording.
    all-digits: Record all DTMF digits, including inband, and generate audio for RFC2833 digits

    Default value

    as-is

    Takes effect Immediately/session

    refframereqonconnjoin

    Request Intra-frames on Join/Bridge

    Enables requesting of intra-frames when there is a join or a bridge between connections / calls.

    Valid values

    • false
    • true

    Default value

    true

    Takes effect Immediately/session

    rru.beginsilence

    RRU Begin Silence

    Specifies the amount of begin silence in milliseconds to insert for RRU. Default is 1000.

    Valid values

    The value must be an integer from 0 to 10000 inclusive

    Default value

    1000

    Takes effect At start/restart

    rru.endsilence

    RRU End Silence

    Specifies the amount of end silence in milliseconds to insert for RRU. Default is 3000.

    Valid values

    The value must be an integer from 0 to 10000 inclusive

    Default value

    3000

    Takes effect At start/restart

    rtcp.tos

    IP Type of Service for audio RTCP

    Specifies the IP Differentiaed Services Field (also known as ToS) to set in all outgoing audio RTCP packets. Note that this configuration does not work for Windows 2008. For Windows 2008, the setting needs to be configured at the OS level through the policy settings. Please refer to the GVP User's Guide.

    Valid values

    Possible values are integers from 0 to 255 inclusive.

    Default value

    0

    Takes effect Immediately/session

    rtcp.tos.video

    IP Type of Service for video RTCP

    Specifies the IP Differentiaed Services Field (also known as ToS) to set in all outgoing video RTCP packets. Note that this configuration does not work for Windows 2008. For Windows 2008, the setting needs to be configured at the OS level through the policy settings. Please refer to the GVP User's Guide.

    Valid values

    Possible values are integers from 0 to 255 inclusive.

    Default value

    0

    Takes effect Immediately/session

    rtcpfeedback.audio

    RTCP Feedback Behavior (Audio)

    Sets the behavior for RTCP feedback. If set to "allow" (default) the MCP will be enabled to send Generic NACK messages as per RFC 4585 Section 6.2.1 when the far end sends SAVPF or AVPF in SDP. If set to "force", the MCP will enable these messages independent of SDP. If set to "disable", the MCP will disable these messages independent of SDP. This configuration parameter covers audio.

    Valid values

    • force
    • allow
    • disable

    Default value

    allow

    Takes effect Immediately/session

    rtcpfeedback.video

    RTCP Feedback Behavior (Video)

    Sets the behavior for RTCP feedback. If set to "allow" (default) the MCP will be enabled to send Generic NACK messages as per RFC 4585 Section 6.2.1 and RTCP PLI as per RFC 4584 section 6.3.1, when the far end sends SAVPF or AVPF in SDP. If set to "force", the MCP will enable these messages independent of SDP. If set to "disable", the MCP will disable these messages independent of SDP. This configuration parameter covers video.

    Valid values

    • force
    • allow
    • disable

    Default value

    allow

    Takes effect Immediately/session

    rtp.activetimeout

    RTP Active Timeout

    MPC will not send the first outgoing RTP packet until it received an incoming RTP packet or the RTP active timeout is reached. This value is time in milliseconds. Default to 0, in which RTP packets will be transmitted immediately.

    Valid values

    mpc.rtp.activetimeout should be an integer greater than 0 and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    0

    Takes effect At start/restart

    rtp.audiobuffersize

    RTP Audio Buffer Size

    Specifies the size of the buffer used for sending audio RTP data in bytes. If 0 is specified, buffer size will be initially set to 120000, and will be increased automatically if more space is needed.

    Valid values

    mpc.rtp.audiobuffersize must be an integer that is greater than 0 and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    50000

    Takes effect At start/restart

    rtp.dejitter.delay

    RTP De-Jitter Delay

    Specifies the total duration (in milliseconds) of RTP packets to buffer for the inter-arrival dejittering purpose. This will translate to an initial delay before the packets are dispatched internally for further processing. 0 disables the inter-arrival jitter removal functionality.

    Valid values

    rtp.dejitter.delay must be an integer that is greater than or equal to 0 and less than or equal to 10000.

    Default value

    0

    Takes effect At start/restart

    rtp.dejitter.timeout

    RTP De-Jitter Timeout

    Controls how long the buffered RTP packet will wait for the missing RTP (in milliseconds). If timeout occurs, the dispatch process is initiated regardless of the missing packet.

    Valid values

    rtp.dejitter.timeout must be an integer that is greater than or equal to 1 and less than or equal to 1000.

    Default value

    200

    Takes effect At start/restart

    rtp.dtmf.receive

    Alternative DTMFs Receive

    Specifies the allowable ways to receive DTMF in an RTP session if telephone-event (RFC2833) is not negotiated in SDP. Allowable values are to support DTMFs relayed over SIP INFO messages and/or over INBAND audio DTMFs. The default selection is to enable both, however inband DTMF will not be supported if telephone-event is negotiated. SIP INFO will be supported if selected here whether or not telephone-event is negotiated. If support neither is selected on it's own will result in neither being supported.

    Valid values

    • SIPINFO
    • INBAND
    • none

    Default value

    SIPINFO INBAND

    Takes effect Immediately/session

    rtp.dtmf.send

    Alternative DTMFs Send

    Specifies the allowable ways to send DTMF in an RTP session if telephone-event (RFC2833) is not negotiated.

    Valid values

    • SIPINFO
    • INBAND

    Default value

    INBAND

    Takes effect Immediately/session

    rtp.enablertcp

    Enable RTCP

    Specifies whether to transmit RTCP packets.

    Valid values

    • 0
    • 1

    Default value

    1

    Takes effect At start/restart

    rtp.fixedsocketthreads

    Fixed number of RTP socket threads

    Specifies the fixed number of RTP socket threads. Fixed number of RTP socket threads specified by this parameter will be allocated at the start-up time, and no new RTP threads will be created during run-time. If set to 0: 1 RTP thread will be created at start-up time, and new RTP threads will be created in proportion to the number of open sockets during run-time. Setting this parameter to 0 is not recommended. Instead this parameter should be set in proportion to the number of CPU cores in the system.

    Valid values

    Possible values are integers from 0 to 100 inclusive.

    Default value

    8

    Takes effect At start/restart

    rtp.h264allowrfc3984stapa

    Allow RFC3984 STAPA for H264

    Specifies whether RFC3984 single-time aggregation packet type A (STAPA) can be used when non-interleaved packetization mode is negotiated. When non-interleaved mode is negotiated as the packet transport mode, single NAL unit, STAPA and fragmentation type A packets will be sent by default. Alternatively, this configuration, when set to Disable, can allow only single NAL unit and fragmentation type A packets to be used.

    Valid values

    • 0
    • 1

    Default value

    1

    Takes effect At start/restart

    rtp.inputmode

    RTP Input Mode

    Specifies the input mode of incoming RTP streams.

    Valid values

    • continuous
    • vad

    Default value

    vad

    Takes effect At start/restart

    rtp.localaddr

    Local RTP Address (IPv4)

    mpc.rtp.localaddr provides configurability of the connection part (IPv4) of SDP messages sent by the MCP.
    If this parameter is not specified, then the IP Address of the local system will be used.

    Default value

    $LocalIP$

    Takes effect At start/restart

    rtp.localaddrv6

    Local RTP Address (IPv6)

    mpc.rtp.localaddr provides configurability of the connection part (IPv6) of SDP messages sent by the MCP.
    If this parameter is not specified, then the IP Address of the local system will be used.

    Default value

    (blank)

    Takes effect At start/restart

    rtp.maxrtppacketsize

    Maximum RTP Packet Size

    Specifies the maximum size of RTP packets that are sent from the platform in bytes. This also controls the maximum size of the SRTP packets being sent. If 0 is specified, there is no limit - unless internal buffer specified by rtp.audiobuffersize or rtp.videobuffersize runs out of space. Note that for SRTP, huge packet sizes (above 80KB which is greater than the typical 1500 MTU limit) may cause SRTP encryption errors before being sent out. If the problem is encountered for very large video packets, it can be worked around by negotiating lower level/bitrate or by leveraging codec specific transport mechanisms (e.g. packetization-mode=1 SDP fmtp for H264).

    Valid values

    mpc.rtp.maxrtppacketsize must be an integer that is greater than or equal to 0 and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    0

    Takes effect At start/restart

    rtp.multichantimeout

    RTP Multichannel Recording Timeout

    Specifies the RTP timeout value in milliseconds for multichannel recordings. A RTP stream will be considered inactive if there has been no activity for the timeout period. A value of 0 disables this timeout. Default value is 60000.

    Valid values

    mpc.rtp.multichantimeout must be an integer that is greater than or equal to 0 and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    60000

    Takes effect At start/restart

    rtp.overwritessrcandtimestamp

    Overwrite SSRC and Timestamp

    Set to Enable to have the SSRC and timestamp of outgoing RTP packets overwritten during a media bridge. Setting to Disable would result in legacy VG Platform behavior. Setting to Enable is required for SRTP operations, and with certain devices that have problems with receiving inconsistent SSRC and timestamp information.

    Valid values

    • 0
    • 1

    Default value

    1

    Takes effect At start/restart

    rtp.packetseq

    RTP Packet Sequence Number

    Specifies the sequence number for the first outgoing RTP packet. IF set to 0, the first sequence number will be randomly generated for each RTP stream. Default value is 0.

    Valid values

    mpc.rtp.packetseq must be an integer that is greater than or equal to 0 and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    0

    Takes effect At start/restart

    rtp.portrange

    RTP Port Range

    Specifies the RTP ports to be used by MPC.

    Valid values

    Possible values are the empty string or low-high, where low and high are integers from 1030 to 65535 inclusive

    Default value

    20000-45000

    Takes effect At start/restart

    rtp.prefilltime

    RTP prefill time limit

    Specifies the time (milliseconds) limit in which the pre-fill amount needs to be sent out by. If the value is M milliseconds and the pre-fill amount is N milliseconds, then the RTP packets will be sent out at (N/M) times the real-time rate for M milliseconds. When in faster than realtime and N/M results in less than double the real-time rate, N/M will be set to double the real-time rate. Possible values are 100 to 1000, inclusive. Default value is 200.

    Valid values

    Possible values are integers from 100 to 1000 inclusive.

    Default value

    200

    Takes effect At start/restart

    rtp.request_iframe

    Request Intra-frames

    Allows/disallows requesting of video intra-frames. Intra-frames require more bandwith, but improve video quality.

    Valid values

    • 0
    • 1

    Default value

    1

    Takes effect Immediately/session

    rtp.restrictsource

    Enable RTP Restrict Source

    Specifies whether to allow dropping packets from other sources (filtering).

    Valid values

    • 0
    • 1

    Default value

    0

    Takes effect At start/restart

    rtp.rfc2429maxpacketsize

    RFC2429 Maximum Packet Size

    Specifies the maximum RTP packet size for RFC2429 packets in bytes.

    Valid values

    mpc.rtp.rfc2429maxpacketsize must be an integer that is greater than or equal to 0 and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    1400

    Takes effect At start/restart

    rtp.sendmode

    RTP Send Mode

    Specifies the output mode of outgoing RTP streams.

    Valid values

    • continuous
    • vad

    Default value

    vad

    Takes effect At start/restart

    rtp.senduponrecv

    Send RTP packets only after valid RTP packets are received

    Specifies whether defer sending of RTP packets until valid RTP packets are received.

    Valid values

    • 0
    • 1

    Default value

    0

    Takes effect At start/restart

    rtp.source_buffer_video_data_size

    RTP Source Buffer Video Data Size

    Specifies the maximum amount of video media data (in bytes) that the RTP source buffer can contain. If set to zero, the value will be determined automatically based on the video bitrate.

    If video conferencing with video_output_type set to mixed is to be utilized, the platform will buffer the last video IFrame and subsequent packets received for each conference participant. This parameter determines the amount of video data that can be buffered.

    The default value zero is correct for most applications.

    Valid values

    rtp.source_buffer_video_data_size must be an integer that is greater than or equal to 0 and less than or equal to 50000000.

    Default value

    0

    Takes effect Immediately/session

    rtp.source_buffer_video_size

    RTP Source Buffer Video Size

    Specifies the maximum number of packets that the RTP source video buffer can contain. The default value 500 is correct for most applications.

    If video conferencing with video_output_type set to mixed is to be utilized, the platform will buffer the last video IFrame and subsequent packets received for each conference participant. This parameter sets the number of packets that can be buffered. It should be set to the maximum expected input IFrame interval (in packet count) plus 20. For example, if a device will be connected that sends an IFrame every 600 packets, the value should be set to 620.

    Valid values

    rtp.source_buffer_video_size must be an integer that is greater than or equal to 200 and less than or equal to 2000.

    Default value

    500

    Takes effect Immediately/session

    rtp.statisticsinterval

    RTP Statistics Logging Interval

    Specifies the interval (in ms) at which statistics logging in the RTP layer will be logged. Setting this value to 0 will disable the statistics logging. If enabled, will log when an RTP connection is destroyed, regardless of interval.

    Valid values

    Possible values are integers from 0 to 3600000 inclusive.

    Default value

    600000

    Takes effect At start/restart

    rtp.timeout

    RTP Timeout

    Specifies the RTP timeout value in milliseconds. A RTP stream will be considered inactive if there has been no activity for the timeout period. A value of 0 disables this timeout. Default value is 60000.

    Valid values

    mpc.rtp.timeout must be an integer that is greater than or equal to 0 and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    60000

    Takes effect At start/restart

    rtp.tos

    IP Type of Service for audio RTP

    Specifies the IP Differentiaed Services Field (also known as ToS) to set in all outgoing audio RTP packets. Note that this configuration does not work for Windows 2008. For Windows 2008, the setting needs to be configured at the OS level through the policy settings. Please refer to the GVP User's Guide.

    Valid values

    Possible values are integers from 0 to 255 inclusive.

    Default value

    0

    Takes effect Immediately/session

    rtp.tos.video

    IP Type of Service for video RTP

    Specifies the IP Differentiaed Services Field (also known as ToS) to set in all outgoing video RTP packets. Note that this configuration does not work for Windows 2008. For Windows 2008, the setting needs to be configured at the OS level through the policy settings. Please refer to the GVP User's Guide.

    Valid values

    Possible values are integers from 0 to 255 inclusive.

    Default value

    0

    Takes effect Immediately/session

    rtp.video.udprecvbuffersize

    Size of the receive buffer for video RTP UDP sockets

    Specifies the size of the receive buffer for video RTP UDP sockets in bytes. Default value is 60480. If set to zero the buffer size will be set to the default for the operating system.

    Valid values

    mpc.rtp.udpbuffersize must be an integer that is greater than or equal to 0 and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    60480

    Takes effect At start/restart

    rtp.video.udpsendbuffersize

    Size of the send buffer for video RTP UDP sockets

    Specifies the size of the send buffer for video RTP UDP sockets in bytes. Default value is 60480. If set to zero the buffer size will be set to the default for the operating system.

    Valid values

    rtp.video.udpsendbuffersize must be an integer that is greater than or equal to 0 and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    60480

    Takes effect At start/restart

    rtp.videobuffersize

    RTP Video Buffer Size

    Specifies the size of the buffer used for sending RTP video data in bytes. This value should be sufficient for buffering up to 1 second of all supported modes of H263 and H264 video stream. Refer to the appropriate specification, e.g. ITU-T H.263 for H.263 and ITU-T H.264 for H.264, and GVP User Guide to determine the size to set to avoid overrunning the video buffer. If 0 is specified, buffer size will be initially set to 120000, and will be increased automatically if more space is needed.

    Valid values

    mpc.rtp.videobuffersize must be an integer that is greater than 0 and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    0

    Takes effect At start/restart

    rtp.vp8maxpacketsize

    VP8 Maximum Packet Size

    Specifies the maximum RTP packet size for VP8 packets in bytes. Any VP8 packet that exceeds the limit will be broken down into smaller packets. This parameter is used to prevent the OS from sending fragmented UDP packets, which may not be supported by some devices.
    Default value is 1400. Set to 0 to disable the limit.

    Valid values

    mpc.rtp.vp8maxpacketsize must be an integer that is greater than or equal to 0 and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    1400

    Takes effect At start/restart

    rtsp.connection.portrange

    RTSP Port Range

    Specifies the available ports to receive RTSP messages from RTSP servers.

    Default value

    14000-15999

    rtsp.localaddr

    Local RTSP Address

    Specifies the IPv4 interface to receive RTSP messages from RTSP servers. If this parameter is not specified, then the IP Address of the local system will be used. Note that most RTSP servers require this parameter and [mpc]rtsp.rtp.localaddr to be configured identically.

    Default value

    (blank)

    Takes effect At start/restart

    rtsp.localaddrv6

    Local RTSP IPv6 Address

    Specifies the IPv6 interface to receive RTSP messages from RTSP servers. If this parameter is not specified, then the IP Address of the local system will be used. Note that most RTSP servers require this parameter and [mpc]rtsp.rtp.localaddrv6 to be configured identically.

    Default value

    (blank)

    Takes effect At start/restart

    rtsp.rtp.localaddr

    Local RTSP RTP Address

    Specifies the interface to receive RTP media from RTSP servers. If this parameter is not specified, then the value in [mpc]rtp.localaddr will be used. Note that most RTSP servers require this parameter and [mpc]rtsp.localaddr to be configured identically.

    Default value

    (blank)

    Takes effect At start/restart

    rtsp.rtp.localaddrv6

    Local RTSP RTP IPv6 Address

    Specifies the IPv6 interface to receive RTP media from RTSP servers. If this parameter is not specified, then the value in [mpc]rtp.localaddrv6 will be used. Note that most RTSP servers require this parameter and [mpc]rtsp.localaddrv6 to be configured identically.

    Default value

    (blank)

    Takes effect At start/restart

    rtsp.rtp.portrange

    RTSP RTP Port Range

    Specifies the available ports to receive RTP media from RTSP servers. If this parameter is not specified, then the value in [mpc]rtp.portange will be used.

    Valid values

    Possible values are the empty string or low-high, where low and high are integers from 1030 to 65535 inclusive

    Default value

    (blank)

    Takes effect At start/restart

    sdp.audiobandwidth

    Audio Bandwidth Attribute Value

    Specifies the value of the bandwidth attribute as specified in RFC4566. If not empty, this value will be added to the bandwidth attribute for the audio media description in offerring SDP

    Default value

    (blank)

    Takes effect At start/restart

    sdp.connection

    Connection for SDP

    Specifies the connection value of outgoing SDP content for a call. It is indepedent of [mpc] rtp.localaddr, which sets the IP address on the platform to be used. This parameter should only be used if the you wish to send an IP address in SDP that is different from the IP address that will be used in [mpc] rtp.localaddr. Setting it to an empty string disables used of this parameter. Possible use cases include when the MCP has a private IP address and a public IP address, and the SDP needs to contain the public IP address.

    Examples of possible values include:
    - IN IP4 127.0.0.1
    - IN IP6 ::1

    Default value

    (blank)

    Takes effect At start/restart

    sdp.map.origin.0

    SDP origin name map 0

    Specifies the origin to match in the SDP. If origin specified by this parameter matches the SDP, the DTMF type specified by mpc.sdp.map.origin.0.dtmftype and the confgain specified by mpc.sdp.map.origin.0.confgain is used. Possible value is "/". Where is either a fully qualtified domain name or a dotted IP address. This value is matched against the address part of the "o=" line. Note, the value should be set to either the fully qualified domain name or a dotted IP address, depending on which form the end point sends in the SDP. If the end point may send either form then two mpc.sdp.map.origin.0 entries can be used, one set to the fully qualified domain name form and one set to the dotted IP address form. Where is the prefix or the entire content of the SDP "s=" (after the "s=" part) line to match. For example if the value is set to "192.168.0.1/phone-call", it will match on 192.168.0.1 in the address part of the "o=" line and require that the "s=" line start with "s=phone-call". If the is an empty string, it will match any "s=" line content. If both and matches "o=" and "s=" respectively, then it is considered a match.

    Valid values

    A valid string must be of the format <FQDN or IP>/[session name content]

    Default value

    (blank)

    Takes effect At start/restart

    sdp.map.origin.0.confgain

    Conference gain for mpc.sdp.map.origin.0

    Specifies the input gain factor to apply for the SDP matching connection when joining the conference. The connection's SDP must match the mpc.sdp.map.origin.0 configuration. The value is specified in percentage. 100 will denote no change. 30 will denote a new input volume of 30% of the original volume into the conference. 200 will denote a new input volume twice as high as the original volume.

    Valid values

    mpc.sdp.map.origin.0.confgain must be an integer that is greater than or equal to 0 and less than or equal to 1000.

    Default value

    100

    Takes effect At start/restart

    sdp.map.origin.0.dtmftype

    DTMF Send type for mpc.sdp.map.origin.0

    Specifies the DTMF type to use when mpc.sdp.map.origin.0 matches. This is regardless of whether telephone-event is negotiated or not, and also overrides the mpc.rtp.dtmf.send configuration.

    Valid values

    • SIPINFO
    • INBAND

    Default value

    INBAND

    Takes effect At start/restart

    sdp.map.origin.1

    SDP origin name map 1

    Specifies the origin to match in the SDP. If origin specified by this parameter matches the SDP, the DTMF type specified by mpc.sdp.map.origin.1.dtmftype and the confgain specified by mpc.sdp.map.origin.1.confgain is used. Possible value is "/". Where is either a fully qualtified domain name or a dotted IP address. This value is matched against the address part of the "o=" line. Note, the value should be set to either the fully qualified domain name or a dotted IP address, depending on which form the end point sends in the SDP. If the end point may send either form then two mpc.sdp.map.origin.1 entries can be used, one set to the fully qualified domain name form and one set to the dotted IP address form. Where is the prefix or the entire content of the SDP "s=" (after the "s=" part) line to match. For example if the value is set to "192.168.0.1/phone-call", it will match on 192.168.0.1 in the address part of the "o=" line and require that the "s=" line start with "s=phone-call". If the is an empty string, it will match any "s=" line content. If both and matches "o=" and "s=" respectively, then it is considered a match.

    Valid values

    A valid string must be of the format <FQDN or IP>/[session name content]

    Default value

    (blank)

    Takes effect At start/restart

    sdp.map.origin.1.confgain

    Conference gain for mpc.sdp.map.origin.1

    Specifies the input gain factor to apply for the SDP matching connection when joining the conference. The connection's SDP must match the mpc.sdp.map.origin.1 configuration. The value is specified in percentage. 100 will denote no change. 30 will denote a new input volume of 30% of the original volume into the conference. 200 will denote a new input volume twice as high as the original volume.

    Valid values

    mpc.sdp.map.origin.1.confgain must be an integer that is greater than or equal to 0 and less than or equal to 1000.

    Default value

    100

    Takes effect At start/restart

    sdp.map.origin.1.dtmftype

    DTMF Send type for mpc.sdp.map.origin.1

    Specifies the DTMF type to use when mpc.sdp.map.origin.1 matches. This is regardless of whether telephone-event is negotiated or not, and also overrides the mpc.rtp.dtmf.send configuration.

    Valid values

    • SIPINFO
    • INBAND

    Default value

    INBAND

    Takes effect At start/restart

    sdp.map.origin.2

    SDP origin name map 2

    Specifies the origin to match in the SDP. If origin specified by this parameter matches the SDP, the DTMF type specified by mpc.sdp.map.origin.2.dtmftype and the confgain specified by mpc.sdp.map.origin.2.confgain is used. Possible value is "/". Where is either a fully qualtified domain name or a dotted IP address. This value is matched against the address part of the "o=" line. Note, the value should be set to either the fully qualified domain name or a dotted IP address, depending on which form the end point sends in the SDP. If the end point may send either form then two mpc.sdp.map.origin.2 entries can be used, one set to the fully qualified domain name form and one set to the dotted IP address form. Where is the prefix or the entire content of the SDP "s=" (after the "s=" part) line to match. For example if the value is set to "192.168.0.1/phone-call", it will match on 192.168.0.1 in the address part of the "o=" line and require that the "s=" line start with "s=phone-call". If the is an empty string, it will match any "s=" line content. If both and matches "o=" and "s=" respectively, then it is considered a match.

    Valid values

    A valid string must be of the format <FQDN or IP>/[session name content]

    Default value

    (blank)

    Takes effect At start/restart

    sdp.map.origin.2.confgain

    Conference gain for mpc.sdp.map.origin.2

    Specifies the input gain factor to apply for the SDP matching connection when joining the conference. The connection's SDP must match the mpc.sdp.map.origin.2 configuration. The value is specified in percentage. 100 will denote no change. 30 will denote a new input volume of 30% of the original volume into the conference. 200 will denote a new input volume twice as high as the original volume.

    Valid values

    mpc.sdp.map.origin.2.confgain must be an integer that is greater than or equal to 0 and less than or equal to 1000.

    Default value

    100

    Takes effect At start/restart

    sdp.map.origin.2.dtmftype

    DTMF Send type for mpc.sdp.map.origin.2

    Specifies the DTMF type to use when mpc.sdp.map.origin.2 matches. This is regardless of whether telephone-event is negotiated or not, and also overrides the mpc.rtp.dtmf.send configuration.

    Valid values

    • SIPINFO
    • INBAND

    Default value

    INBAND

    Takes effect At start/restart

    sdp.map.origin.3

    SDP origin name map 3

    Specifies the origin to match in the SDP. If origin specified by this parameter matches the SDP, the DTMF type specified by mpc.sdp.map.origin.3.dtmftype and the confgain specified by mpc.sdp.map.origin.3.confgain is used. Possible value is "/". Where is either a fully qualtified domain name or a dotted IP address. This value is matched against the address part of the "o=" line. Note, the value should be set to either the fully qualified domain name or a dotted IP address, depending on which form the end point sends in the SDP. If the end point may send either form then two mpc.sdp.map.origin.3 entries can be used, one set to the fully qualified domain name form and one set to the dotted IP address form. Where is the prefix or the entire content of the SDP "s=" (after the "s=" part) line to match. For example if the value is set to "192.168.0.1/phone-call", it will match on 192.168.0.1 in the address part of the "o=" line and require that the "s=" line start with "s=phone-call". If the is an empty string, it will match any "s=" line content. If both and matches "o=" and "s=" respectively, then it is considered a match.

    Valid values

    A valid string must be of the format <FQDN or IP>/[session name content]

    Default value

    (blank)

    Takes effect At start/restart

    sdp.map.origin.3.confgain

    Conference gain for mpc.sdp.map.origin.3

    Specifies the input gain factor to apply for the SDP matching connection when joining the conference. The connection's SDP must match the mpc.sdp.map.origin.3 configuration. The value is specified in percentage. 100 will denote no change. 30 will denote a new input volume of 30% of the original volume into the conference. 200 will denote a new input volume twice as high as the original volume.

    Valid values

    mpc.sdp.map.origin.3.confgain must be an integer that is greater than or equal to 0 and less than or equal to 1000.

    Default value

    100

    Takes effect At start/restart

    sdp.map.origin.3.dtmftype

    DTMF Send type for mpc.sdp.map.origin.3

    Specifies the DTMF type to use when mpc.sdp.map.origin.3 matches. This is regardless of whether telephone-event is negotiated or not, and also overrides the mpc.rtp.dtmf.send configuration.

    Valid values

    • SIPINFO
    • INBAND

    Default value

    INBAND

    Takes effect At start/restart

    sdp.map.origin.4

    SDP origin name map 4

    Specifies the origin to match in the SDP. If origin specified by this parameter matches the SDP, the DTMF type specified by mpc.sdp.map.origin.4.dtmftype and the confgain specified by mpc.sdp.map.origin.4.confgain is used. Possible value is "/". Where is either a fully qualtified domain name or a dotted IP address. This value is matched against the address part of the "o=" line. Note, the value should be set to either the fully qualified domain name or a dotted IP address, depending on which form the end point sends in the SDP. If the end point may send either form then two mpc.sdp.map.origin.4 entries can be used, one set to the fully qualified domain name form and one set to the dotted IP address form. Where is the prefix or the entire content of the SDP "s=" (after the "s=" part) line to match. For example if the value is set to "192.168.0.1/phone-call", it will match on 192.168.0.1 in the address part of the "o=" line and require that the "s=" line start with "s=phone-call". If the is an empty string, it will match any "s=" line content. If both and matches "o=" and "s=" respectively, then it is considered a match.

    Valid values

    A valid string must be of the format <FQDN or IP>/[session name content]

    Default value

    (blank)

    Takes effect At start/restart

    sdp.map.origin.4.confgain

    Conference gain for mpc.sdp.map.origin.4

    Specifies the input gain factor to apply for the SDP matching connection when joining the conference. The connection's SDP must match the mpc.sdp.map.origin.4 configuration. The value is specified in percentage. 100 will denote no change. 30 will denote a new input volume of 30% of the original volume into the conference. 200 will denote a new input volume twice as high as the original volume.

    Valid values

    mpc.sdp.map.origin.4.confgain must be an integer that is greater than or equal to 0 and less than or equal to 1000.

    Default value

    100

    Takes effect At start/restart

    sdp.map.origin.4.dtmftype

    DTMF Send type for mpc.sdp.map.origin.4

    Specifies the DTMF type to use when mpc.sdp.map.origin.4 matches. This is regardless of whether telephone-event is negotiated or not, and also overrides the mpc.rtp.dtmf.send configuration.

    Valid values

    • SIPINFO
    • INBAND

    Default value

    INBAND

    Takes effect At start/restart

    sdp.map.origin.5

    SDP origin name map 5

    Specifies the origin to match in the SDP. If origin specified by this parameter matches the SDP, the DTMF type specified by mpc.sdp.map.origin.5.dtmftype and the confgain specified by mpc.sdp.map.origin.5.confgain is used. Possible value is "/". Where is either a fully qualtified domain name or a dotted IP address. This value is matched against the address part of the "o=" line. Note, the value should be set to either the fully qualified domain name or a dotted IP address, depending on which form the end point sends in the SDP. If the end point may send either form then two mpc.sdp.map.origin.5 entries can be used, one set to the fully qualified domain name form and one set to the dotted IP address form. Where is the prefix or the entire content of the SDP "s=" (after the "s=" part) line to match. For example if the value is set to "192.168.0.1/phone-call", it will match on 192.168.0.1 in the address part of the "o=" line and require that the "s=" line start with "s=phone-call". If the is an empty string, it will match any "s=" line content. If both and matches "o=" and "s=" respectively, then it is considered a match.

    Valid values

    A valid string must be of the format <FQDN or IP>/[session name content]

    Default value

    (blank)

    Takes effect At start/restart

    sdp.map.origin.5.confgain

    Conference gain for mpc.sdp.map.origin.5

    Specifies the input gain factor to apply for the SDP matching connection when joining the conference. The connection's SDP must match the mpc.sdp.map.origin.5 configuration. The value is specified in percentage. 100 will denote no change. 30 will denote a new input volume of 30% of the original volume into the conference. 200 will denote a new input volume twice as high as the original volume.

    Valid values

    mpc.sdp.map.origin.5.confgain must be an integer that is greater than or equal to 0 and less than or equal to 1000.

    Default value

    100

    Takes effect At start/restart

    sdp.map.origin.5.dtmftype

    DTMF Send type for mpc.sdp.map.origin.5

    Specifies the DTMF type to use when mpc.sdp.map.origin.5 matches. This is regardless of whether telephone-event is negotiated or not, and also overrides the mpc.rtp.dtmf.send configuration.

    Valid values

    • SIPINFO
    • INBAND

    Default value

    INBAND

    Takes effect At start/restart

    sdp.map.origin.6

    SDP origin name map 6

    Specifies the origin to match in the SDP. If origin specified by this parameter matches the SDP, the DTMF type specified by mpc.sdp.map.origin.6.dtmftype and the confgain specified by mpc.sdp.map.origin.6.confgain is used. Possible value is "/". Where is either a fully qualtified domain name or a dotted IP address. This value is matched against the address part of the "o=" line. Note, the value should be set to either the fully qualified domain name or a dotted IP address, depending on which form the end point sends in the SDP. If the end point may send either form then two mpc.sdp.map.origin.6 entries can be used, one set to the fully qualified domain name form and one set to the dotted IP address form. Where is the prefix or the entire content of the SDP "s=" (after the "s=" part) line to match. For example if the value is set to "192.168.0.1/phone-call", it will match on 192.168.0.1 in the address part of the "o=" line and require that the "s=" line start with "s=phone-call". If the is an empty string, it will match any "s=" line content. If both and matches "o=" and "s=" respectively, then it is considered a match.

    Valid values

    A valid string must be of the format <FQDN or IP>/[session name content]

    Default value

    (blank)

    Takes effect At start/restart

    sdp.map.origin.6.confgain

    Conference gain for mpc.sdp.map.origin.6

    Specifies the input gain factor to apply for the SDP matching connection when joining the conference. The connection's SDP must match the mpc.sdp.map.origin.6 configuration. The value is specified in percentage. 100 will denote no change. 30 will denote a new input volume of 30% of the original volume into the conference. 200 will denote a new input volume twice as high as the original volume.

    Valid values

    mpc.sdp.map.origin.6.confgain must be an integer that is greater than or equal to 0 and less than or equal to 1000.

    Default value

    100

    Takes effect At start/restart

    sdp.map.origin.6.dtmftype

    DTMF Send type for mpc.sdp.map.origin.6

    Specifies the DTMF type to use when mpc.sdp.map.origin.6 matches. This is regardless of whether telephone-event is negotiated or not, and also overrides the mpc.rtp.dtmf.send configuration.

    Valid values

    • SIPINFO
    • INBAND

    Default value

    INBAND

    Takes effect At start/restart

    sdp.map.origin.7

    SDP origin name map 7

    Specifies the origin to match in the SDP. If origin specified by this parameter matches the SDP, the DTMF type specified by mpc.sdp.map.origin.7.dtmftype and the confgain specified by mpc.sdp.map.origin.7.confgain is used. Possible value is "/". Where is either a fully qualtified domain name or a dotted IP address. This value is matched against the address part of the "o=" line. Note, the value should be set to either the fully qualified domain name or a dotted IP address, depending on which form the end point sends in the SDP. If the end point may send either form then two mpc.sdp.map.origin.7 entries can be used, one set to the fully qualified domain name form and one set to the dotted IP address form. Where is the prefix or the entire content of the SDP "s=" (after the "s=" part) line to match. For example if the value is set to "192.168.0.1/phone-call", it will match on 192.168.0.1 in the address part of the "o=" line and require that the "s=" line start with "s=phone-call". If the is an empty string, it will match any "s=" line content. If both and matches "o=" and "s=" respectively, then it is considered a match.

    Valid values

    A valid string must be of the format <FQDN or IP>/[session name content]

    Default value

    (blank)

    Takes effect At start/restart

    sdp.map.origin.7.confgain

    Conference gain for mpc.sdp.map.origin.7

    Specifies the input gain factor to apply for the SDP matching connection when joining the conference. The connection's SDP must match the mpc.sdp.map.origin.7 configuration. The value is specified in percentage. 100 will denote no change. 30 will denote a new input volume of 30% of the original volume into the conference. 200 will denote a new input volume twice as high as the original volume.

    Valid values

    mpc.sdp.map.origin.7.confgain must be an integer that is greater than or equal to 0 and less than or equal to 1000.

    Default value

    100

    Takes effect At start/restart

    sdp.map.origin.7.dtmftype

    DTMF Send type for mpc.sdp.map.origin.7

    Specifies the DTMF type to use when mpc.sdp.map.origin.7 matches. This is regardless of whether telephone-event is negotiated or not, and also overrides the mpc.rtp.dtmf.send configuration.

    Valid values

    • SIPINFO
    • INBAND

    Default value

    INBAND

    Takes effect At start/restart

    sdp.map.origin.8

    SDP origin name map 8

    Specifies the origin to match in the SDP. If origin specified by this parameter matches the SDP, the DTMF type specified by mpc.sdp.map.origin.8.dtmftype and the confgain specified by mpc.sdp.map.origin.8.confgain is used. Possible value is "/". Where is either a fully qualtified domain name or a dotted IP address. This value is matched against the address part of the "o=" line. Note, the value should be set to either the fully qualified domain name or a dotted IP address, depending on which form the end point sends in the SDP. If the end point may send either form then two mpc.sdp.map.origin.8 entries can be used, one set to the fully qualified domain name form and one set to the dotted IP address form. Where is the prefix or the entire content of the SDP "s=" (after the "s=" part) line to match. For example if the value is set to "192.168.0.1/phone-call", it will match on 192.168.0.1 in the address part of the "o=" line and require that the "s=" line start with "s=phone-call". If the is an empty string, it will match any "s=" line content. If both and matches "o=" and "s=" respectively, then it is considered a match.

    Valid values

    A valid string must be of the format <FQDN or IP>/[session name content]

    Default value

    (blank)

    Takes effect At start/restart

    sdp.map.origin.8.confgain

    Conference gain for mpc.sdp.map.origin.8

    Specifies the input gain factor to apply for the SDP matching connection when joining the conference. The connection's SDP must match the mpc.sdp.map.origin.8 configuration. The value is specified in percentage. 100 will denote no change. 30 will denote a new input volume of 30% of the original volume into the conference. 200 will denote a new input volume twice as high as the original volume.

    Valid values

    mpc.sdp.map.origin.8.confgain must be an integer that is greater than or equal to 0 and less than or equal to 1000.

    Default value

    100

    Takes effect At start/restart

    sdp.map.origin.8.dtmftype

    DTMF Send type for mpc.sdp.map.origin.8

    Specifies the DTMF type to use when mpc.sdp.map.origin.8 matches. This is regardless of whether telephone-event is negotiated or not, and also overrides the mpc.rtp.dtmf.send configuration.

    Valid values

    • SIPINFO
    • INBAND

    Default value

    INBAND

    Takes effect At start/restart

    sdp.map.origin.9

    SDP origin name map 9

    Specifies the origin to match in the SDP. If origin specified by this parameter matches the SDP, the DTMF type specified by mpc.sdp.map.origin.9.dtmftype and the confgain specified by mpc.sdp.map.origin.9.confgain is used. Possible value is "/". Where is either a fully qualtified domain name or a dotted IP address. This value is matched against the address part of the "o=" line. Note, the value should be set to either the fully qualified domain name or a dotted IP address, depending on which form the end point sends in the SDP. If the end point may send either form then two mpc.sdp.map.origin.9 entries can be used, one set to the fully qualified domain name form and one set to the dotted IP address form. Where is the prefix or the entire content of the SDP "s=" (after the "s=" part) line to match. For example if the value is set to "192.168.0.1/phone-call", it will match on 192.168.0.1 in the address part of the "o=" line and require that the "s=" line start with "s=phone-call". If the is an empty string, it will match any "s=" line content. If both and matches "o=" and "s=" respectively, then it is considered a match.

    Valid values

    A valid string must be of the format <FQDN or IP>/[session name content]

    Default value

    (blank)

    Takes effect At start/restart

    sdp.map.origin.9.confgain

    Conference gain for mpc.sdp.map.origin.9

    Specifies the input gain factor to apply for the SDP matching connection when joining the conference. The connection's SDP must match the mpc.sdp.map.origin.9 configuration. The value is specified in percentage. 100 will denote no change. 30 will denote a new input volume of 30% of the original volume into the conference. 200 will denote a new input volume twice as high as the original volume.

    Valid values

    mpc.sdp.map.origin.9.confgain must be an integer that is greater than or equal to 0 and less than or equal to 1000.

    Default value

    100

    Takes effect At start/restart

    sdp.map.origin.9.dtmftype

    DTMF Send type for mpc.sdp.map.origin.9

    Specifies the DTMF type to use when mpc.sdp.map.origin.9 matches. This is regardless of whether telephone-event is negotiated or not, and also overrides the mpc.rtp.dtmf.send configuration.

    Valid values

    • SIPINFO
    • INBAND

    Default value

    INBAND

    Takes effect At start/restart

    sdp.videobandwidth

    Video Bandwidth Attribute Value

    Specifies the value of the bandwidth attribute as specified in RFC4566. If not empty, this value will be added to the bandwidth attribute for the video media description in offerring SDP

    Default value

    (blank)

    Takes effect At start/restart

    srtp.cryptomethods

    SRTP Crypto Methods

    List of crypto suites corresponding to advertised capabilities offered by the MCP using SDP. See RFC4568 for the description of the suites.

    Valid values

    • AES_CM_128_HMAC_SHA1_80
    • AES_CM_128_HMAC_SHA1_32
    • none

    Default value

    AES_CM_128_HMAC_SHA1_80

    Takes effect At start/restart

    srtp.mode

    SRTP Mode

    Specifies the srtp mode for the MCP

    Valid values

    • none
    • accept_only
    • offer
    • offer_strict
    • offer_selectable
    none: No SRTP supported: the MCP will ignore the crypto
    accept_only: SRTP supported for SDP offers sent to the MCP, no outgoing offers will add SRTP to m-lines that did not previously contain it
    offer: SRTP supported for SDP offers received by the MCP and will be including in outgoing SDP offers. If the other side ignores SRTP, the MCP will fall back to non SRTP mode. If a previously negotiated m-line is used in a reoffer, or the far end requests an offer, and that m-line did not have SRTP negotiated, SRTP will NOT be added. If the far end reoffers and adds SRTP to a previously negotiated m-line, SRTP WILL be negotiated.
    offer_strict: Same as offer, however if the other side doesn't use SRTP, negotiation will fail offer_selectable: Same as offer except - if an offer has two media lines that are the same except that one has crypto, only the one with crypto will be accepted. In its own offer, two media lines will be offered for each media type, one with crypto and the other without. If both media lines are accepted, all RTP will be sent and received only through the crypto line.

    Default value

    none

    Takes effect At start/restart

    srtp.sessionparams

    SRTP Session Params

    List of session parameters that the MCP is willing to accept. See RFC4568 for their description. Note that RFC4568 doesn't allow unauthenticated srtcp.

    Valid values

    • UNENCRYPTED_SRTP
    • UNENCRYPTED_SRTCP
    • UNAUTHENTICATED_SRTP
    • none

    Default value

    UNENCRYPTED_SRTP UNENCRYPTED_SRTCP UNAUTHENTICATED_SRTP

    Takes effect At start/restart

    srtp.sessionparamsoffer

    SRTP Session Params Offer

    List of session parameters that the MCP will include in its SDP offers. See RFC4568 for their description. Note that RFC4568 doesn't allow unauthenticated srtcp.

    Valid values

    • UNENCRYPTED_SRTP
    • UNENCRYPTED_SRTCP
    • UNAUTHENTICATED_SRTP
    • none

    Default value

    (blank)

    Takes effect At start/restart

    telephone_event.maxptime

    RFC2833 DTMF maxptime

    If the MCP is offering the SDP, or answering the SDP where the offer does not have the maxptime, the maxptime attribute will be set according to this configuration. If this configuration does not exist, or is disabled, the maxptime attribute will not be sent unless the SDP offer had the maxptime attribute. In the case where other codecs in the SDP also specify maxptime, the configuration of the codec listed before this codec will take precedence.

    Valid values

    • 0
    • 10
    • 20
    • 30
    • 40
    • 60
    • 80
    • 100

    Default value

    0

    Takes effect Immediately

    telephone_event.ptime

    RFC2833 DTMF ptime

    If the MCP is offering the SDP or answering the SDP where the offer does not have the ptime, the ptime attribute will be set according to this configuration. This configuration is also used as the transmission rate of this codec when the remote SDP does not specify the ptime attribute. Note that transmission rate will default to 20ms if this configuration is disabled. If disabled, ptime attribute will not be sent unless the SDP offer had the ptime attribute. In the case where the other codecs in the SDP also specify the configured ptime, the configuration of the codec listed before this codec will take precedence.

    Valid values

    • 0
    • 10
    • 20
    • 30
    • 40
    • 60
    • 80
    • 100

    Default value

    0

    Takes effect Immediately

    telephone_eventpayload

    telephone-event payload

    Default telephone-event payload to use by the MCP if none are specified

    Valid values

    A valid telephone-event payload can only be an integer from 96 to 127 inclusive

    Default value

    101

    Takes effect At start/restart

    tfcipayload

    TFCI Payload

    Default payload type number to use for tfci

    Valid values

    A valid tfci payload can only be an integer from 96 to 127 inclusive

    Default value

    96

    Takes effect At start/restart

    tiasfraction

    TIAS fraction

    When the TIAS bandwidth parameter is specified on incoming SDP, mpc.tiasfraction specifies the percentage of the TIAS bitrate that the MPC will try to achieve on the outbound media stream. If tiasfraction is 100 (default) then the MPC will try to limit the media bitrate to TIAS. In some cases it might go slightly over the TIAS limit (by perhaps one or two percent), so for safety it might be better to specify a tiasfraction value somewhat less than 100. It is possible to specify a tiasfraction greater than 100, but this is not recommended.

    Valid values

    tiasfraction is a percentage (out of 100) that must be an integer of value 0 or greater.

    Default value

    100

    Takes effect At start/restart

    transcoders

    Transcoders

    Specifies the list of transcoders to be used by MPC. Add H263 to allow video transcoding involving H263 codec: - H263 transcoding to/from H264 (note: H264 also has to be enabled). - H263 resolution downscaling. - H263 frame rate throttling. - H263 bit rate throttling. - H263 conference video mixing. - Textoverlay on H263 video Add H264 to allow video transcoding involving H264 codec: - H264 transcoding to/from H263 (note: H263 also has to be enabled). - H264 resolution downscaling. - H264 frame rate throttling. - H264 bit rate throttling. - H264 conference video mixing. - Textoverlay on H264 video Add VP8 to allow video transcoding involving VP8 codec Set to "none" in order to disable all transcoders.

    Valid values

    • G722
    • GSM
    • G726
    • G729
    • AMR
    • AMR-WB
    • MP3
    • H263
    • H264
    • VP8
    • none

    Default value

    G722 GSM G726 G729 AMR AMR-WB MP3 H263 H264 VP8

    Takes effect At start/restart

    transmitmultiplecodec

    Multiple Codec Transmission

    When media negotiation returns more than one supported codecs, this parameter specifies whether to allow transmission of all supported codecs, or restrict transmission to only one codec. If set to Enable, more than one codec can be transmitted. If set to Disable, only the codec at the top of the negotiated codec list will be transmitted. Note that for SIP devices that support multiple codecs, this parameter must be set to Disable for full call recording to work.

    Valid values

    • 0
    • 1

    Default value

    0

    Takes effect Immediately/session

    tts.appendrejcodec

    TTS Append Rejected Codecs

    When set to Enable, the MCP will advertise all supported codecs when generating an SDP offer to the TTS. Even if codecs are rejected or not presented in the caller's SDP, the MCP will still support receiving these codecs. The MCP will not send for those SDPs unless a payload is presented by the caller.

    Valid values

    • 0
    • 1

    Default value

    0

    Takes effect At start/restart

    tts.codec

    TTS Codec

    List of codec corresponding to advertised capabilities offered by the MCP to the TTS server using SDP. The offered codec list will control the codecs that are offered by the MCP to the remote party for media sent from the remote party to Genesys.

    Valid values

    • pcmu
    • pcma
    • g722
    • g726
    • g729
    • gsm
    • amr
    • amr-wb
    • tfci

    Default value

    pcmu pcma

    Takes effect Immediately

    tts.preferredipinterface

    TTS Preferred IP Interface

    Specifies the preferred IP interface to use (IPv4 or IPv6) for TTS when performing SDP negotiation. In particular, this will be used to set the root connection attribute in SDP answers, and set the connection attribute in SDP offers.

    Valid values

    • V4
    • V6

    Default value

    V4

    Takes effect At start/restart

    tts.srtp.cryptomethods

    TTS SRTP Crypto Methods

    List of crypto suites corresponding to advertised capabilities offered by the MCP to the TTS server using SDP. See RFC4568 for the description of the suites.

    Valid values

    • AES_CM_128_HMAC_SHA1_80
    • AES_CM_128_HMAC_SHA1_32
    • none

    Default value

    AES_CM_128_HMAC_SHA1_80

    Takes effect At start/restart

    tts.srtp.mode

    TTS SRTP Mode

    Specifies the srtp mode for the MCP to use for TTS sessions

    Valid values

    • none
    • offer
    • offer_strict
    none: No SRTP supported: the MCP will ignore the crypto
    offer: SRTP supported in outgoing SDP offers. If the other side ignores SRTP, the MCP will fall back to non SRTP mode.
    offer_strict: Same as offer, however if the other side doesn't use SRTP, negotiation will fail

    Default value

    none

    Takes effect At start/restart

    tts.srtp.sessionparamsoffer

    TTS SRTP Offered Session Parameters

    List of session parameters that the MCP will include in its SDP offers to the TTS server. See RFC4568 for their description. Note that RFC4568 doesn't allow unauthenticated srtcp.

    Valid values

    • UNENCRYPTED_SRTP
    • UNENCRYPTED_SRTCP
    • UNAUTHENTICATED_SRTP
    • none

    Default value

    (blank)

    Takes effect At start/restart

    videotranscoder.bitratecheckdelay

    Video transcoding bit rate check delay

    This parameter specifies the bit rate check delay when bit rate check is enabled for video transcoding. Bit rate checking will start after the milliseconds specified by this parameter elapses.

    Valid values

    A valid value should be an integer greater or equal to 0

    Default value

    10000

    Takes effect At start/restart

    videotranscoder.bitratechecktolerance

    Video transcoding bit rate check tolerance

    This parameter specifies the bit rate check tolerance when bit rate check is enabled for video transcoding. Bit rate checking will allow the bit rate to go over the maximum by the percentage specified by this parameter.

    Valid values

    A valid value should be an integer greater or equal to 0

    Default value

    50

    Takes effect At start/restart

    videotranscoder.checkbitrate

    Bit rate check for video transcoding trigger

    When set to true and the transcoder for the incoming video format is enabled, video transcoding will be triggered when bit rate exceeds the maximum bit rate. When false, it will not.

    Valid values

    • 0
    • 1

    Default value

    1

    Takes effect Immediately/session

    videotranscoder.checkframerate

    Frame rate check for video transcoding trigger

    When set to true and the transcoder for the incoming video format is enabled, video transcoding will be triggered when frame rate exceeds the maximum frame rate. When false, it will not.

    Valid values

    • 0
    • 1

    Default value

    1

    Takes effect Immediately/session

    videotranscoder.frameratechecktolerance

    Video transcoding frame rate check tolerance

    This parameter specifies the frame rate check tolerance when frame rate check is enabled for video transcoding. Frame rate checking will allow the frame rate to go over the maximum by the percentage specified by this parameter.

    Valid values

    A valid value should be an integer greater or equal to 0

    Default value

    50

    Takes effect At start/restart

    videotranscoder.h264.keyframeidrinterval

    H264 video transcoding IDR frame generation interval

    This parameter specifies the IDR frame generation frequency of the H264 transcoder. IDR frame is one of types of i-frames in H264. For example, if 2 is specified, every other i-frame generated will be an IDR frame.

    Valid values

    A number between 0 and 2147483647 inclusive.

    Default value

    1

    Takes effect At start/restart

    videotranscoder.h264.keyframeinterval

    H264 video transcoding i-frame generation interval

    This parameter specifies the i-frame generation frequency of the H264 transcoder. For example, if 50 is specified, an i-frame will be generated per every 50 frames.

    Valid values

    A number between 0 and 2147483647 inclusive.

    Default value

    50

    Takes effect At start/restart

    videotranscoder.h264.resolutions

    H264 Transcodable Resolution List

    This parameter specifies the list of H264 encodable resolutions when H264 transcoding is applied. If empty, defaults to "SQCIF QCIF QVGA CIF VGA 4CIF SVGA 720P". ITU-T H264 Recommendation document Table A.6 specifies the list of resolution/frame rate/bit rate limits per level. If the resolution needs to be downscaled because of the level requirement, the resolution closest downward in this list will be selected. Format: [ ...] Where is x or one of the following keywords - SQCIF - Sub-QCIF resolution (128x96) QCIF - QCIF resolution (176x144) QVGA - QVGA resolution (320x240) CIF - CIF resolution (352x288) VGA - VGA resolution (640x480) 4CIF - 4CIF resolution (704x576) SVGA - SVGA resolution (800x600) 720P - 720P HD resolution (1280x720) When x syntax is used, the resolution must be less than or equal to 720P HD resolution. WARNING: MCP will fail to start if invalid resolution is specified.

    Default value

    SQCIF QCIF QVGA CIF VGA 4CIF SVGA 720P

    Takes effect At start/restart

    videotranscoder.maxbitrate

    Video transcoding max bit rate

    This parameter specifies maximum bit rate used for encoding when video transcoding is active. 0 indicates that there is no maximum imposed. If not 0, video transcoded output encoding bit rate is set to the minimum of the maximum allowed bitrate of the receiver and the value specified by this parameter.

    Valid values

    A valid value should be an integer greater or equal to 0

    Default value

    500000

    Takes effect Immediately/session

    videotranscoder.statsresetthreshold

    Video Rate Statistics Reset Threshold

    This parameter specifies the accumulated duration (in milliseconds) threshold at which to trigger resetting of frame rate/bit rate statistics. For example, if set to 60000, the cumulative duration used for calculating frame rate/bit rate is reset approximately every 60 seconds. The statistics is used for checking and triggering video transcoding when frame rate/bit rate exceeds the required maximum. Lower value makes the transcoding trigger more sensitive to sudden bursts that exceeds the required maximum.

    Valid values

    A number between 1000 and 2147483647 inclusive.

    Default value

    60000

    Takes effect At start/restart

    voipmetrics.enable

    VoIP Metrics

    When enabled, MCP will collect several metrics defined in RFC 3611 for each audio session. The metrics can be divided into local and remote. For local metrics, MCP collects some of them by exchanging RTCP messages between itself and the remote party while some are calculated locally from ongoing activities. For remote metrics, the remote party, if supporting RFC 3611, will report MCP about its metrics periodically and MCP will record them whenever it receives an update. At the end of each audio session, MCP users also have an option to publish the local and remote metrics to a destination. Refer to voipmetrics.* configuration under sip section for more information.

    Valid values

    • 0
    • 1

    Default value

    0

    Takes effect At start/restart

    vp8.adaptive

    VP8 Encoder Adaptivity

    This parameter specifies the adaptivity of the VP8 encoder behaviour, and thus the determinism of its output. In adaptive mode (the default) the encoder will adapt to environmental conditions to provide the best overall user experience. Non-adaptive mode will result in the same output everytime, but will not adapt to environmental situations.

    Valid values

    • true
    • false
    The value must be a boolean of either true or false.

    Default value

    true

    Takes effect At start/restart

    vp8.defaultbitrate

    VP8 Default Bitrate

    This parameter specifies the output bitrate in bits/sec for transcoding to the VP8 format. If set to 0 the default bitrate of the VP8 encoder will be used.
    WARNING: MCP will fail to start if an invalid value is specified.

    Valid values

    The bitrate value must be an integer of value 0 or greater.

    Default value

    0

    Takes effect At start/restart

    vp8.defaultframerateden

    VP8 Default Framerate Denominator

    This parameter specifies the output framerate denominator for transcoding to the VP8 format. The framerate numerator and denominator values are combined to determine the framerate (e.g. 30000/1001 gives 29.97 frames/sec).
    WARNING: MCP will fail to start if an invalid value is specified.

    Valid values

    The framerate numerator value must be 1 or greater.

    Default value

    1001

    Takes effect At start/restart

    vp8.defaultframeratenum

    VP8 Default Framerate Numerator

    This parameter specifies the output framerate numerator for transcoding to the VP8 format. The framerate numerator and denominator values are combined to determine the framerate (e.g. 30000/1001 gives 29.97 frames/sec).
    WARNING: MCP will fail to start if an invalid value is specified.

    Valid values

    The framerate numerator value must be 1 or greater.

    Default value

    30000

    Takes effect At start/restart

    vp8.defaultresolution

    VP8 Default Resolution

    This parameter specifies the output resolution for transcoding to the VP8 format.

    The value is specified by a keyword or width and height value as follows:
    SQCIF - Sub-QCIF resolution (128x96)
    QCIF - QCIF resolution (176x144)
    QVGA - QVGA resolution (320x240)
    CIF - CIF resolution (352x288)
    VGA - VGA resolution (640x480)
    4CIF - 4CIF resolution (704x576)
    SVGA - SVGA resolution (800x600)
    720P - 720P HD resolution (1280x720)
    WidthxHeight - specifies a custom width and height

    When WidthxHeight syntax is used, the resolution must be less than or equal to 720P HD resolution.
    WARNING: MCP will fail to start if invalid resolution is specified.

    Default value

    CIF

    Takes effect At start/restart

    vp8.maxkeyframeinterval

    VP8 Keyframe Maximum Interval

    This parameter, expressed as a number of frames, forces the encoder to code a keyframe if the last keyframe was vp8.maxkeyframeinterval frames ago. A value of 0 or 1 implies all frames will be keyframes.

    Valid values

    The value must be nonnegative.

    Default value

    15

    Takes effect Per session / immediate

    vrmrecorder.enable

    Enable the VRMRecorder

    When set to true, the vrmrecorder for the CRQM feature will be enabled. When false, it will not be loaded.

    Default value

    true

    Takes effect At start/restart

    vrmrecorder.preferredipinterface

    CRQM Preferred IP Interface

    Specifies the preferred IP interface to use (IPv4 or IPv6) when performing SDP negotiation (CRQM related). In particular, this will be used to set the root connection attribute in SDP answers, and set the connection attribute in SDP offers.

    Valid values

    • V4
    • V6

    Default value

    V4

    Takes effect Immediately

    vrmrecorder.srtp.cryptomethods

    VRMRecorder SRTP Crypto Methods

    List of crypto suites corresponding to advertised capabilities offered by the MCP to a recording server using SDP. See RFC4568 for the description of the suites.

    Valid values

    • AES_CM_128_HMAC_SHA1_80
    • AES_CM_128_HMAC_SHA1_32
    • none

    Default value

    AES_CM_128_HMAC_SHA1_80

    Takes effect At start/restart

    vrmrecorder.srtp.mode

    VRMRecorder SRTP Mode

    Specifies the srtp mode for the MCP to use for recording sessions

    Valid values

    • none
    • offer
    • offer_strict
    • offer_selectable
    none: No SRTP supported: the MCP will ignore the crypto.
    offer: SRTP supported in outgoing SDP offers. If the other side ignores SRTP, the MCP will fall back to non SRTP mode.
    offer_strict: Same as offer, however if the other side doesn't use SRTP, negotiation will fail.
    offer_selectable: Same as offer except - two media lines will be offered for each media type, one with crypto and the other without. If both media lines are accepted, all RTP will be sent and received only through the crypto line.

    Default value

    none

    Takes effect At start/restart

    vrmrecorder.srtp.sessionparamsoffer

    VRMRecorder SRTP Offered Session Parameters

    List of session parameters that the MCP will include in its SDP offers to a recording server. See RFC4568 for their description. Note that RFC4568 doesn't allow unauthenticated srtcp.

    Valid values

    • UNENCRYPTED_SRTP
    • UNENCRYPTED_SRTCP
    • UNAUTHENTICATED_SRTP
    • none

    Default value

    (blank)

    Takes effect At start/restart

    widebandconferences

    Wideband conferences

    When enabled and the conference's initial audio requirements are unknown, MCP will mix the conference's audio in wideband. This will generally increase conference sound quality at the cost of increased CPU usage.

    Valid values

    • 0
    • 1

    Default value

    0

    Takes effect At start/restart

    [mrcpv2client]

    sip.transport.0

    MRCPv2 SIP UDP Transport

    The SIP UDP Transport used by the MRCPV2 Client. Format: sip.transport.x = transport_name
    type:ip:port

    where transport_name is any string; type is udp/tcp/tls; ip is the IP address of the network interface that accepts incoming SIP messages; port is the port number where SIP stack accepts incoming SIP messages.
    If ip is an IPv6 address, [] must be used. To define a transport to listen to all IPv4 interfaces, use "any" or "any4" for ip. To define a transport to listen to all IPv6 interfaces, use "any6" for ip. Remarks: The default transport will be the smallest non-empty ID. If all transport.x values are empty, UDP, TCP and TLS transports will all be enabled and respectively listen from ports 5060, 5060 and 5061 on any network interface, TLS transport will use the certificate, x509_certificate.pem, and key, x509_private_key.pem, in the config directory and UDP will be the default transport.

    Default value

    transport0 udp:any:7080

    Takes effect At start/restart

    sip.transport.1

    MRCPv2 SIP TCP Transport

    The SIP TCP Transport used by the MRCPV2 Client. Format: sip.transport.x = transport_name
    type:ip:port

    where transport_name is any string; type is udp/tcp/tls; ip is the IP address of the network interface that accepts incoming SIP messages; port is the port number where SIP stack accepts incoming SIP messages.
    If ip is an IPv6 address, [] must be used. To define a transport to listen to all IPv4 interfaces, use "any" or "any4" for ip. To define a transport to listen to all IPv6 interfaces, use "any6" for ip. Remarks: The default transport will be the smallest non-empty ID. If all transport.x values are empty, UDP, TCP and TLS transports will all be enabled and respectively listen from ports 5060, 5060 and 5061 on any network interface, TLS transport will use the certificate, x509_certificate.pem, and key, x509_private_key.pem, in the config directory and UDP will be the default transport.

    Default value

    transport1 tcp:any:7080

    Takes effect At start/restart

    sip.transport.2

    MRCPv2 SIP TLS Transport

    The SIP TLS Transport used by the MRCPV2 Client. Format: sip.transport.x = transport_name
    type:ip:port [parameters]

    where transport_name is any string; type is udp/tcp/tls; ip is the IP address of the network interface that accepts incoming SIP messages; port is the port number where SIP stack accepts incoming SIP messages;
    [parameters] defines any extra SIP transport parameters. Note that this is for LMSIP2.

    If ip is an IPv6 address, [] must be used. To define a transport to listen to all IPv4 interfaces, use "any" or "any4" for ip. To define a transport to listen to all IPv6 interfaces, use "any6" for ip. Example:
    cert=[cert path and filename] Applicable to SIPS only and mandatory if using SIPS. The path and the filename of the TLS certificate to be used key=[key path and filename] Applicable to SIPS only and mandatory if using SIPS. The path and the filename of the TLS key to be used. type=[Type of secure transport] Applicable to SIPS only and is optional. The type of secure transport to be used and value can be TLSv1, SSLv2, SSLv3, SSLv23. Default to SSLv23. password=[password] Applicable to SIPS only and is optional. The password associated with the certificate and key pair. Required only if key file is password protected.

    cafile=[CA cert path and filename] Mandatory for TLS mutual authentication. The path and the filename of the certificate to be used for verifying the peer. The same certificate specified in cert=[cert path and filename] parameter can be used as the value here if using only 1 certificate is preferred. verifypeer=true Mandatory for TLS mutual authentication. This parameter turns on the TLS mutual authentication. verifydepth=[max depth for the certificate chain verification] Applicable only to TLS mutual authentication. This parameter sets the maximum depth for the certificate chain verification. For the default Genesys certificate provided, the recommended value is 1. Remarks: The default transport will be the smallest non-empty ID. If all transport.x values are empty, UDP, TCP and TLS transports will all be enabled and respectively listen from ports 5060, 5060 and 5061 on any network interface, TLS transport will use the certificate, x509_certificate.pem, and key, x509_private_key.pem, in the config directory and UDP will be the default transport.

    Default value

    transport2 tls:any:7081

    Takes effect At start/restart

    sip.transport.localaddress

    MRCPv2 Local Transport IPv4 Address

    If specified, the sent-by field of the Via header and the hostport part of the Contact header in the outgoing SIP message will be set to this value if a IPv4 transport is used. The value must be a hostname or domain name. If left empty the outgoing transport's actual IP and port will be used for the Via header and the Contact header. Note that if the domain name used in the SRV record query is specified, mrcpv2client.sip.transport.localaddress.srv must be set to true to prevent the port part being automatically generated by the SIP stack.

    Default value

    (blank)

    Takes effect At start/restart

    sip.transport.localaddress.srv

    MRCPv2 Local Transport Address contains SRV domain name

    Specifies whether the mrcpv2client.transport.localaddress contains an SRV domain name. If set to true, port part will not be automatically generated by the SIP stack. Otherwise, the outgoing transport's port will used together with the hostname specified by the mrcpv2client.sip.transport.localaddress.

    Valid values

    • true
    • false

    Default value

    false

    Takes effect At start/restart

    [msml]

    beep.filename

    Beep Filename

    This parameter is used to specify the filename for the 'beep' before doing the operation or in place of the "$beep$" in a play element.. Will be limited by the msml.beep.join.timelimit configuration.

    Valid values

    Please specify a valid path to the file

    Default value

    file://$InstallationRoot$/audio/ulaw/default_audio/endofprompt.vox

    Takes effect Immediately

    beep.join.timelimit

    Beep File Time Limit in Join

    The timelimit for the audible "beep" when played during a element. Units are in milliseconds.

    Valid values

    Must be an integer greater than 0 and less than or equal to 10000.

    Default value

    5000

    Takes effect Immediately

    cpd.beeptimeout

    CPD default Beep Timeout

    CPD Beep Timeout in seconds. When not set in the element attributes, this value will be used as the default beep timeout. Set to 0 to disable.

    Valid values

    Must be an integer greater than or equal to 0 and less than 60.

    Default value

    30

    Takes effect Immediately

    cpd.postconnecttimeout

    CPD default Post-connect Timeout

    CPD Post-connect Timeout in seconds. When not set in the element attributes, this value will be used as the default post-connect timeout. Set to 0 to disable.

    Valid values

    Must be an integer greater than or equal to 0 and less than 60.

    Default value

    30

    Takes effect Immediately

    cpd.preconnecttimeout

    CPD default Pre-connect Timeout

    CPD Pre-connect Timeout in seconds. When not set in the element attributes, this value will be used as the default pre-connect timeout. Set to 0 to disable.

    Valid values

    Must be an integer greater than or equal to 0 and less than 60.

    Default value

    30

    Takes effect Immediately

    cpd.record.basepath

    Root Directory for CPD recording

    Path pointing to the root directory for CPD recording.

    Default value

    file://$installationRoot$/record/

    Takes effect Immediately

    cpd.record.fileext

    File Extension for CPD recording

    Specifies the file extension for CPD recording. Will be used to determine the MIME-type of the file, and the extension used.

    Default value

    wav

    Takes effect Immediately

    defaultaudioext

    Default Audio File Extension for Play Prompt and Recording

    Specifies the default file extension of audio files to be used in play prompt or recording.

    Default value

    .wav

    Takes effect Immediately

    dialogend.silentfail

    Silent fail default value for dialogend

    Set the default behavior for dialogend with regards to silently failing if the dialog cannot be found. When true, and a dialog to end cannot be found, the dialogend will not fail. When false, the dialogend request will fail if the dialog cannot be found.

    Valid values

    • false
    • true

    Default value

    false

    Takes effect Immediately

    info.contenttypes

    MSML INFO Allowed Content-Types

    Content types in a SIP INFO messages that are allowed for the MSML AppModule. Only the defined content types are processed, others are ignored. If left empty, the default value is "application/vnd.radisys.msml+xml". Specifying "*" would mean that any value is permitted. This is a space delimited list of values.

    Valid values

    A valid content type can only contain alphanumeric characters, and '/' or '\'

    Default value

    application/vnd.radisys.msml+xml

    Takes effect Immediately

    play.basepath

    Root Directory for Play Media

    Path pointing to the root directory of prompt media.

    Default value

    file://$installationRoot$

    Takes effect Immediately

    play.fetchtimeout

    Fetch timeout for MSML Play

    Sets the fetch timeout (in ms) for an MSML play.

    Valid values

    Must be an integer greater than or equal to 5000 and less than or equal to 25000.

    Default value

    25000

    Takes effect Immediately/session

    play.h263videoformat

    List of H.263 Video Formats

    A comma-separated list of H.263 video formats that are used for selecting H.263 video files to play.

    Default value

    QCIF=2

    Takes effect Immediately

    play.h264videoformat

    List of H.264 Video Formats

    A comma-separated list of H.264 video formats that are used for selecting H.264 video files to play. The video format is in the form of "byte_value=mpi" where byte value is the last byte of the profile-level-id, and mpi is the minimum picture interval. The last byte of the profile-level-id in the negotiated SDP is matched against the desired minimum picture interval specified in this configuration parameter. MCP shall select the prompt file with filename ending as profile-level-id=matched_minimum_picture_interval to play. If the last byte of profile-level-id of the negotiated SDP is not found in this configuration parameter list, no file will be played. For example, if this configuration parameter has value 0a=2, and if negotiated SDP for H.264 codec has specified profile-level-id as 42e00a, then MCP shall look for prompt file name ending with H264_42e00a=2.

    Default value

    0a=2,0b=2,0c=2,0d=2,14=2,15=2,16=2,1e=2

    Takes effect Immediately

    play.musicbasepath

    Root Directory for Playback of Music Tones or Files

    Path pointing to the root directory of music prompt.

    Default value

    file://$installationRoot$

    Takes effect Immediately

    play.preferredvideocontainer

    Preferred Video Container for MSML Play

    When an extension is not present in the MSML play request, precheck is enabled, and the user negotiates a video codec, this configuration will be used to determine which container will be attempted.

    Valid values

    • avi
    • 3gp
    Can only be 3gp or avi.

    Default value

    avi

    Takes effect Immediately/session

    play.usedefaultsearchorder

    Audio Content Search Order

    Specifies the audio file search order for MSML prompt announcement. The default search order is /. followed by _.. If this option is set to true, the default order will be used. If this is set to false, the search order will be reversed.

    Valid values

    • true
    • false

    Default value

    true

    Takes effect Immediately

    record.appenduniqueid

    MSML Recording Append Unique ID

    When set to true, if an MSML Recording is requested, record destinations that do not have an extension specified will have a unique identifier included as part of recorded file name. When set to false, no unique identifier will be included in the final file name. If a directory is specified, a unique indentifier will always be used, independent of this configuration. If the attribute "gvp:appenduniqueid" is specified in the record element, that value will take precedence over the configured value.

    Valid values

    • true
    • false

    Default value

    true

    Takes effect Immediately/session

    record.basepath

    Root Directory for Record Media

    Path pointing to the root directory for recording media.

    Default value

    file://$installationRoot$

    Takes effect Immediately

    record.finalsilence

    MSML Recording Default Final Silence Timeout

    The default final silence duration in seconds that can be detected in a recording to terminate the recording.

    Valid values

    Must be an integer greater than or equal to 0 and less than or equal to 10000.

    Default value

    4

    Takes effect Immediately

    [mtinternal]

    Internal Media Transport - The Internal Media Transport Module is responsible for managing the internal media transmission to and from the ASR/TTS. This data transmission uses RTP. (Note that this is independent of the external RTP connections.) The following parameters control the internal media transport module

    enablertcp

    MTInternal Enable RTCP

    Specifies whether to transmit RTCP packets.

    Valid values

    • 0
    • 1

    Default value

    0

    Takes effect At start/restart

    max_concurrent_savedata

    MTInternal Max Concurrent Savedata

    If specified as an integer n, and mtinternal.transmit_savedata or mtinternal.receive_savedata is enabled, then only a maximum of n concurrent files will be open for writing data. Default value is -1, which would place no limit.

    Valid values

    mtinternal.max_concurrent_savedata must be an integer that is greater or equal to -1 and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    -1

    Takes effect At start/restart

    receive_max_size

    MTInternal Transmit Maximum Size

    Defines the maximum packet sample size that will be notified to the receiver. Note that this number is applied to all codecs with fixed frame size. It will be rounded down to the nearest multiple of the codec frame size. This parameter will be disabled when variable frame size codec is used. Set to -1 to disable the limit.

    Valid values

    mtinternal.receive_max_size must be an integer that is greater or equal to -1 and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    -1

    Takes effect At start/restart

    receive_min_size

    MTInternal Transmit Minimum Size

    Defines the minimum packet sample size that will be notified to the receiver. Note that this number is applied to all codecs with fixed frame size. It will be rounded down to the nearest multiple of the codec frame size. This parameter will be disabled when variable frame size codec is used. Set to -1 to disable the limit.

    Valid values

    mtinternal.receive_min_size must be an integer that is greater or equal to -1 and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    -1

    Takes effect At start/restart

    receive_rate_alarm

    MTInternal Receive Rate Alarm

    If greater than 0, minor alarm is generated if the transmission rate of incoming packets is slower the real time by the specified delay in milliseconds. This alarm will be disabled if variable frame size codec is used for received packets.

    Valid values

    mtinternal.receive_rate_alarm must be an integer that is greater than or equal to 0 and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    500

    Takes effect At start/restart

    receive_savedata

    MTInternal Receive Savedata

    If specified, received data is saved under the directory.

    Valid values

    mtinternal.receive_savedata must be a valid path

    Default value

    (blank)

    Takes effect At start/restart

    restrictsource

    MTInternal Restrict Source

    Specifies whether to allow dropping packets from other sources (filtering).

    Valid values

    • 0
    • 1

    Default value

    0

    Takes effect At start/restart

    rtp.statisticsinterval

    MTInternal RTP Statistics Logging Interval

    Specifies the interval (in ms) at which statistics logging in the RTP layer will be logged. Setting this value to 0 will disable the statistics logging. If enabled, will log when an RTP connection is destroyed, regardless of interval.

    Valid values

    Possible values are integers from 0 to 3600000 inclusive.

    Default value

    600000

    Takes effect At start/restart

    transmit_max_size

    MTInternal Transmit Maximum Size

    Defines the maximum data size in bytes that can be sent. Note that this number is applied to all codecs with fixed frame size. It will be rounded down to the nearest multiple of the codec frame size. This parameter will be disabled when variable frame size codec is used. Set to -1 to disable the limit.

    Valid values

    mtinternal.transmit_max_size must be an integer that is greater or equal to -1 and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    160

    Takes effect At start/restart

    transmit_min_size

    MTInternal Transmit Minimum Size

    Defines the minimum data size in bytes that can be sent. Note that this number is applied to all codecs with fixed frame size. It will be rounded down to the nearest multiple of the codec frame size. This parameter will be disabled when variable frame size codec is used. Set to -1 to disable the limit.

    Valid values

    mtinternal.transmit_min_size must be an integer that is greater or equal to -1 and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    160

    Takes effect At start/restart

    transmit_rate

    MTInternal Transmit Rate

    Specifies the transmission rate limit as a multiple of realtime. A value of 1 means realtime, 2 means 2 times realtime and so on. Set to 0 for no limit.

    Valid values

    The maximum transmission rate must be an integer that is greater than or equal to 0 and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    10

    Takes effect At start/restart

    transmit_rate_alarm

    MTInternal Transmit Rate Alarm

    If greater than 0, minor alarm is generated if the transmission rate of outgoing packets is slower the real time by the specified delay in milliseconds. This alarm will be disabled if variable frame size codec is used for transmitted packets.

    Valid values

    mtinternal.transmit_rate_alarm must be an integer that is greater than or equal to 0 and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    500

    Takes effect At start/restart

    transmit_savedata

    MTInternal Transmit Savedata

    If specified, utterance is saved under the directory.

    Valid values

    mtinternal.transmit_savedata must be a valid path

    Default value

    (blank)

    Takes effect At start/restart

    [mtmpc]

    conference.output_gain

    Conference Output Gain

    Specifies the gain applied to the output of a conference in decibels. Default value is 100.

    Valid values

    mtmpc.conference.output_gain must be an integer at least equal 0 and less than or equal to 1000

    Default value

    100

    Takes effect At start/restart

    [Netann]

    annc.audiodefaultrepeat

    Default Repeat Times for Play Netann Announcement Prompts

    Specifies the default repeat times to be used for Netann announcement playback, not applicable to DTMF prompts.

    Default value

    forever

    Takes effect Immediately

    annc.basepath

    Root Directory for Prompt Media

    Path pointing to the root directory of prompt media.

    Default value

    $installationRoot$

    Takes effect At start/restart

    annc.defaultaudioext

    Default File Extension for Play Netann Announcement Prompts

    Specifies the default file extension of audio files to be used for Netann announcement playback.

    Default value

    .wav

    Takes effect Immediately

    annc.fetchtimeout

    Fetch timeout for Play Announcement

    Sets the fetch timeout (in ms) for a Play Announcement.

    Valid values

    Must be an integer greater than or equal to 5000 and less than or equal to 25000.

    Default value

    25000

    Takes effect Immediately/session

    annc.h263videoformat

    List of H.263 Video Formats

    A comma-separated list of H.263 video formats that are used for selecting H.263 video files to play. Examples of H.263 video formats are SQCIF=1 to 6, QCIF=1 to 6, CIF=1 to 6, CIF4=1 to 6, and CIF16=1 to 6.

    Default value

    QCIF=2

    Takes effect Immediately

    annc.h264videoformat

    List of H.264 Video Formats

    A comma-separated list of H.264 video formats that are used for selecting H.264 video files to play. The video format is in the form of "byte_value=mpi" where byte value is the last byte of the profile-level-id, and mpi is the minimum picture interval. The last byte of the profile-level-id in the negotiated SDP is matched against the desired minimum picture interval specified in this configuration parameter. MCP shall select the prompt file with filename ending as profile-level-id=matched_minimum_picture_interval to play. If the last byte of profile-level-id of the negotiated SDP is not found in this configuration parameter list, no file will be played. For example, if this configuration parameter has value 0a=2, and if negotiated SDP for H.264 codec has specified profile-level-id as 42e00a, then MCP shall look for prompt file name ending with H264_42e00a=2.

    Default value

    0a=2,0b=2,0c=2,0d=2,14=2,15=2,16=2,1e=2

    Takes effect Immediately

    annc.musicbasepath

    Root Directory for Playback of Music Tones or Files

    Path pointing to the root directory of music prompts.

    Default value

    $installationRoot$

    Takes effect Immediately

    conference.recordmode

    Conference Recording Mode

    When recording is enabled in a conference, this option specifies the recording mode.

    Valid values

    • mixed
    • multich
    • pcap
    • multich-pcap

    Default value

    mixed

    Takes effect Immediately

    record.appenduniqueid

    Netann Recording Append Unique ID

    When set to true, if a Netann Recording is requested, record destinations that do not have an extension specified will have a unique identifier included as part of recorded file name. When set to false, no unique identifier will be included in the final file name. PCAP recordings will still have _(recording number).pcap appended at the end of the file. If a directory is specified, a unique indentifier will always be used, independent of this configuration.

    Valid values

    • true
    • false

    Default value

    true

    Takes effect Immediately/session

    record.basepath

    Root Directory for Recorded Media

    Path pointing to the root directory of the recorded file.

    Default value

    $InstallationRoot$/record

    Takes effect At start/restart

    record.maxrecordsilence

    Maximum Allowed Silence Time During Recording

    Defines the maximum amount of silence in seconds allowed during a recording. If the value is set to 0, silence detection is not used.

    Default value

    0

    Takes effect Immediately

    record.maxrecordtime

    Maximum Recording Time in Seconds

    Defines the maximum recording time in seconds. The default value 0 means that the recording time is unlimited

    Default value

    0

    Takes effect Immediately

    sipinfonotifydtmf

    Send dtmf-relay SIP Info Messages

    Specify when recieving a DTMF, whether to always send, never send, or to depend on the Allow header of incoming INVITEs for prompt announcement services.

    Valid values

    • Auto
    • True
    • False

    Default value

    Auto

    Takes effect At start/restart

    [remdial]

    Remote Dial Application Module (Remdial) Settings

    maxcalls

    Remdial Max Calls

    Maximum number of concurrent remdial calls

    Valid values

    The number should be an integer greater than 0 and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    500

    Takes effect At start/restart

    maxclientsockets

    Remdial Max Client Sockets

    Max number of remdial clients allowed

    Valid values

    The number should be an integer greater than 0 and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    64

    Takes effect At start/restart

    port

    Remdial Port

    Remdial port

    Valid values

    The port number must be an integer from 1030 to 65535 inclusive

    Default value

    6999

    Takes effect At start/restart

    telnetmode

    Remdial Telnet Mode

    Remdial telnet mode. If set to RAW, remdial will buffer data until it receives a carriage return. If set to NORMAL, Remdial will expect the that the full request was sent all at once. RAW is the recommendation configuration since it will support most telnet clients. The default Windows telnet client will only work if this configuration is set to RAW. NORMAL will provide a performance boost if the client sends the full request all at once. Most Linux and Solaris clients, along with PuTTy on Windows, will work with this configuration.

    Valid values

    • RAW
    • NORMAL

    Default value

    RAW

    Takes effect At start/restart

    [sessmgr]

    Dynamic loading of MCP Application Modules
    MCP can dynamically load application modules at startup. The following configuration parameters enable both the VoiceXML Interpreter (vxmli) module, remdial module along with other modules. The configuration parameters can be modified to load a different combination of application modules. These parameters should be set properly by the installation rpm. Customizations are only recommended for advanced users who require usage of special MCP applications for their deployments.

    acceptcalltimeout

    Accept Call Timeout

    Accept call timeout in milliseconds. After alerting is issued, if the application module does not accept the inbound call within the timeout, the call will be disconnected. The timeout is set to 30000 milliseconds by default.

    Valid values

    sessmgr.acceptcalltimeout must be an integer greater than 0 and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    30000

    Takes effect At start/restart

    alert_before_fetch

    Alert Before Fetch

    Issues alerting message to phone network before the page is successfully fetched. When it is set to 1, Composer debugging with the NGI will not work. It is because NGI will not be able to attach the SIP headers to the 18x response.

    Valid values

    • 0
    • 1

    Default value

    0

    Takes effect At start/restart

    appmodules_linux

    Application Module Names (Linux)

    This specifies the list of names of app modules to be initialized on startup for the Linux platform. Each possible value is made up of :. specifies the module containing . ":" is the delimiter used below. To enable VoiceXML Applications on Linux, VXML3:VXML-NG must be set, and [sessmgr] modules_linux needs to have VXML3 set. To disable VoiceXML Applications on Linux, VXML3:VXML-NG must not be set, and [sessmgr] modules_linux needs to not have VXML3 set.

    Valid values

    • Remdial:RemoteDial
    • Netann:Netann
    • VXML3:VXML-NG
    • MSML:MSML

    Default value

    Remdial:RemoteDial Netann:Netann VXML3:VXML-NG MSML:MSML

    Takes effect At start/restart

    appmodules_win

    Application Module Names (Windows)

    This specifies the list of names of app modules to be initialized on startup for the Windows platform. Each possible value is made up of :. specifies the module containing . ":" is the delimiter used below. To enable VoiceXML Applications on Windows, VXML3:VXML-NG must be set, and [sessmgr] modules_win needs to have VXML3 set. To disable VoiceXML Applications on Windows, VXML3:VXML-NG must not be set, and [sessmgr] modules_win needs to not have VXML3 set.

    Valid values

    • Remdial:RemoteDial
    • Netann:Netann
    • VXML3:VXML-NG
    • MSML:MSML

    Default value

    Remdial:RemoteDial Netann:Netann VXML3:VXML-NG MSML:MSML

    Takes effect At start/restart

    default_init_url

    Default Initial VoiceXML URL

    Specifies the URL to the initial VoiceXML page if one isn't specified in the incoming SIP request.

    Default value

    file://$InstallationRoot$/samples/ulaw/helloworld.vxml

    Takes effect At start/restart

    default_vxml_interpreter

    Default VoiceXML interpreter

    Specifies which VoiceXML Interpreter is used to handle calls that do not specify the VoiceXML Interpreter.

    Valid values

    • VXML-NG
    • VXML-LGVP

    Default value

    VXML-NG

    Takes effect At start/restart

    disconnect_cause.badfetch

    Disconnect Cause Badfetch

    This parameter is used to specify the ISDN disconnect cause code if the initial page fetch failed for some reason

    Valid values

    The sessmgr.disconnect_cause.badfetch must be a non-negative integer and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    17

    Takes effect At start/restart

    disconnect_cause.decline

    Disconnect Cause Decline

    This parameter is used to specify the ISDN disconnect cause code if the MCP has chosen to decline the call

    Valid values

    The sessmgr.disconnect_cause.decline must be a non-negative integer and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    21

    Takes effect At start/restart

    fcr_video_dir

    Full call recording video direction

    This specifies which video stream will be recorded during an FCR operation. It can be the video from the user or the video played to the user.

    Valid values

    • IN
    • OUT

    Default value

    IN

    Takes effect Immediately

    init_accept_call_mode

    Initial Accept Call Mode

    This specifies the AcceptCallMode when the MCP starts up.

    Valid values

    • INBOUND
    • OUTBOUND
    • DUPLEX
    • DISABLE

    Default value

    DUPLEX

    Takes effect At start/restart

    join_fallback

    Join Fallback

    This determines whether to fallback on MediaRedirect/Bridged transfer if CallJoin fails.

    Valid values

    • 0
    • 1

    Default value

    0

    Takes effect Immediately

    licensepoolsize.gvp_ports

    GVP Ports License Pool Size

    License pool size for voice port usage, value should be max or a numeric number. MCP would attempt to acquire voice ports from the Genesys License Server up to the pool size specified value. For max. value, MCP would try to acquire the max. allowed voice port licenses as the Genesys License Server could provide.

    Default value

    max

    Takes effect At start/restart

    licensepoolsize.gvp_tts_ports

    GVP TTS Ports License Pool Size

    License pool size for TTS port usage, value should be max or a numeric number. MCP would attempt to acquire TTS ports from the Genesys License Server up to the pool size specified value. For max. value, MCP would try to acquire the max. allowed TTS port licenses as the Genesys License Server could provide.

    Default value

    max

    Takes effect At start/restart

    maxincalltime

    Maximum Inbound Call Time

    This specifies the maximum call time for inbound calls in seconds. When the timer expires, the inbound call will be disconnected. Set to 0 to disable the timer.

    Valid values

    Time must be an non-negative integer value and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    0

    Takes effect Immediately

    mediaswitch_on_alert

    Transfer Media Switch On Alert

    Specifies when media switching should occur in a call transfer, when the transfer "connectwhen" attribute is set to "immediate". When this parameter is set to Enable, media switching would occur when call alerting started on the outbound call. Otherwise, media switching would occur as soon as the outbound call is initiated.

    Valid values

    • 0
    • 1

    Default value

    0

    Takes effect Immediately

    modules_linux

    Application Module SOs (Linux)

    This specifies the list of MCP Application Modules to be loaded, in the order defined, for the Linux platform. The modules correspond to dynamic link libraries that are named libAPP.so. To enable VoiceXML Applications on Linux, VXML3 must be set, and [sessmgr] appmodules_linux needs to have VXML3:VXML-NG set. To disable VoiceXML Applications on Linux, VXML3 must not be set, and [sessmgr] appmodules_linux needs to not have VXML3:VXML-NG set.

    Valid values

    • Remdial
    • Netann
    • VXML3
    • MSML

    Default value

    Remdial Netann VXML3 MSML

    Takes effect At start/restart

    modules_win

    Application Module DLLs (Windows)

    This specifies the list of MCP Application Modules to be loaded, in the order defined, for the Windows platform. The modules correspond to dynamic link libraries that are named libAPP.dll. To enable VoiceXML Applications on Windows, VXML3 must be set, and [sessmgr] appmodules_win needs to have VXML3:VXML-NG set. To disable VoiceXML Applications on Windows, VXML3 must not be set, and [sessmgr] appmodules_win needs to not have VXML3:VXML-NG set.

    Valid values

    • Remdial
    • Netann
    • VXML3
    • MSML

    Default value

    Remdial Netann VXML3 MSML

    Takes effect At start/restart

    mrt.sendsdpininvite

    Send SDP in INVITE for Media Redirect

    When enabled, for a Media Redirect call that has 'connectwhen' specified as "answered", the MCP will send the caller's last SDP to the callee both in a reINVITE and in an ACK. When disabled, the reINVITE to the callee will not contain any SDP.

    Valid values

    • false
    • true

    Default value

    true

    Takes effect Immediately/session

    MSML.MSML

    MSML AppModule Instance Name

    Name of MSML Instance

    Valid values

    A valid name can only contain characters and numerics.

    Default value

    msml

    Takes effect At start/restart

    Netann.Netann

    Netann AppModule Instance Name

    Name of Netann Instance

    Valid values

    A valid name can only contain characters and numerics.

    Default value

    Netann

    Takes effect At start/restart

    Remdial.RemoteDial

    RemoteDial AppModule Instance Name

    Name of Remdial Instance

    Valid values

    A valid name can only contain characters and numerics.

    Default value

    RemoteDial

    Takes effect At start/restart

    VXML3.VXML-NG

    NGI AppModule Instance Name

    Name of the NGI app module instance

    Valid values

    A valid name can only contain characters and numerics.

    Default value

    vxmli-ng1

    Takes effect At start/restart

    [sip]

    SIP Line Manager

    attconfnetworktonetimeout

    ATT Conference Network Tone Timeout

    Specify the network tone timeout in ms for an ATT conference, in which there is no direct way to tell if DTMF star (*) is part of network tone or user input. Since a complete network tone, which is composed of two DTMF stars (**) plus a DTMF digit, would arrive within a short period of time since the first DTMF star comes in, it is reasonable to believe that the DTMF star(s) are user inputs if no complete network tone is received within the time specified in this parameter. By default, attconfnetworktonetimeout is set to 1000 (1s).

    Valid values

    sip.attconfnetworktonetimeout should be positive integer.

    Default value

    1000

    Takes effect At start/restart

    call_rate

    Call Rate

    Specify the number of incoming calls, when not 0, that SIP line manager can accept within call_rate_period. It works along with parameter call_rate_period. For example, if call_rate is set to 10 and call_rate_period is set to 500 (ms), then SIP line manager can accept at most 10 incoming calls every 500 milliseconds. If there are more than 10 incoming calls within 500 milliseconds, the excess calls will be rejected with response 486 Busy Here. By default, call_rate is set to 0, which means no overload control at all.

    Valid values

    sip.call_rate should be an integer from 0 to 1000 inclusive.

    Default value

    0

    Takes effect At start/restart

    call_rate_period

    Call Rate Period

    Specify the call rate period in milliseconds for overload control. It works along with parameter call_rate. For example, if call_rate is set to 10 and call_rate_period is set to 500 (ms), then SIP line manager can accept at most 10 incoming calls every 500 milliseconds. If there are more than 10 incoming calls within 500 milliseconds, the excess calls will be rejected with response 486 Busy Here. By default, call_rate_period is set to 0, which means no overload control at all.

    Valid values

    sip.call_rate_period should be non-negative integer.

    Default value

    0

    Takes effect At start/restart

    copyunknownheaders

    Copy Unknown Headers

    Copy unknown headers from request to all responses. If this parameter set to Enable, all unknown SIP headers found in SIP request will be automatically copied to its responses.

    Valid values

    • 0
    • 1

    Default value

    1

    Takes effect At start/restart

    copyxgenesysheaders

    List of X-Genesys- headers that need to be copied

    Defines a list of X-Genesys custom headers to be copied from SIP requests to all responses and follow-up requests. These custom headers are copied when the copyunknownheaders configuration option is enabled. If there are no headers defined (the list is empty), all X-Genesys custom headers are treated the same as other unknown headers. The X-Genesys- prefix in each header must be omitted when the list is defined. By default, the list is empty. If you do not want the custom headers to be copied in SIP responses or follow-up requests, Genesys recommends that you set the copyxgenesysheaders configuration option value as follows: GVP-Session-ID GVP-Session-Data GVP-Trunk-Prefix GVP-PSTNC-DBID GVP-CTI-Params GVP-CDR bypass-resource-list CallUUID RM-Application-dbid RM-Log-filters gsw-predictive-call outbound-ivr-call geo-location gvp-tenant-ports mediaserver-status GVP-Site-ID

    Valid values

    A valid header can only contain alphanumeric characters and '.', '-' and ':' characters

    Default value

    (blank)

    Takes effect At start/restart

    defaultblindxfer

    Default Blind Transfer

    SIP Transfer Methods for blind transfer

    Valid values

    • HKF
    • REFER
    • BRIDGE
    • REFERJOIN
    • MEDIAREDIRECT
    • ATTCOURTESY
    • ATTCONSULT
    • ATTCONFERENCE
    • ATTOOBCOURTESY
    • ATTOOBCONSULT
    • ATTOOBCONFERENCE
    • NEC61ISDN

    Default value

    REFER

    Takes effect At start/restart

    defaultbridgexfer

    Default Bridge Transfer

    Default bridge type transfer method for sip

    Valid values

    • BRIDGE
    • MEDIAREDIRECT
    • ATTCONFERENCE

    Default value

    BRIDGE

    Takes effect At start/restart

    defaultconsultxfer

    Default Consultation Transfer

    Default consult type transfer method for sip.

    Valid values

    • HKF
    • REFER
    • BRIDGE
    • REFERJOIN
    • MEDIAREDIRECT
    • ATTCONSULT
    • ATTCONFERENCE
    • ATTOOBCONSULT
    • ATTOOBCONFERENCE

    Default value

    REFERJOIN

    Takes effect At start/restart

    defaultfrom

    Default From

    Default From for SIP calls if none given. If a call is placed (either via transfer, call, or remdial) using SIP, and the From value is missing from the request, this parameter will supply the From header value for the SIP request.

    If this parameter is not specified, the value will be set to "sip:Genesys@" + "host" + "the port specified in the sip.transport.0 parmeter".

    Example:
    sip.defaultfrom=sip:Genesys@sip.genesyslab.com:5070

    Valid values

    A valid address can only contain alphanumeric characters, '.', '-', ':', ' ','/' and '\' characters

    Default value

    (blank)

    Takes effect At start/restart

    defaultgw

    Default Gateway

    Default host/port for SIP calls if none given. If a call is placed (either via transfer, call, or remdial) using SIP, and the destination address is a telephone address, then the call will be routed to the configured default gateway.

    For instance, if a call is placed to "tel:4167360905", and this call is routed to the SIP line manager then this address will be translated into "sip:4167360905@default-gw".

    If this parameter is not specified, no default gateway will be used, and calls to telephony addresses will fail.

    Example:
    sip.defaultgw=pstn-gw.genesyslab.com:5060

    Valid values

    A valid address can only contain alphanumeric characters, '.', '-', ':', ' ','/' and '\' characters

    Default value

    (blank)

    Takes effect At start/restart

    defaulthost

    Default Host

    Default host/port for SIP calls if none given. If a call is placed (either via transfer, call, or remdial) using SIP, and the destination address does not contain a hostname or IP address, this parameter will supply a default hostname or IP address.

    For instance, if the address "sip:1234@" is used, the default hostname will be appended. If this parameter is not specified, no default host will be used and calls that do not specify a host will fail.

    Example:
    sip.defaulthost=sip.genesyslab.com:5060

    Valid values

    A valid address can only contain alphanumeric characters, '.', '-', ':', ' ','/' and '\' characters

    Default value

    (blank)

    Takes effect At start/restart

    deferoutalerting

    Defer Out Alerting

    Defer CallOutAlerting response to MCP. This is for early media for an outbound call. If this value is set to Enable, the platform will defer CallOutAlerting to MCP until the media session is initialized and registered. Hence, the MCP can start performing media operations on the channel after CallOutAlerting notification.

    Valid values

    • 0
    • 1

    Default value

    0

    Takes effect At start/restart

    dnis_correlationid_length

    DNIS CorrelationID Length

    If this parameter is enabled, correlation ID is extracted from the user-id portion of the DNIS, and the correlation ID portion is stripped from DNIS. Value is a non-negative integer that specifies the length of the correlation ID within the user-id.

    Note the special case where correlation ID is all of user-id; '@' will be stripped away from the DNIS as well since @<hostname> does not make sense.

    Valid values

    sip.dnis_correlationid_length should be non-negative integer that is less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    0

    Takes effect At start/restart

    dnis_correlationid_offset

    DNIS CorrelationID Offset

    If this parameter is enabled, correlation ID is extracted from the user-id portion of the DNIS, and the correlation ID portion is stripped from DNIS. Value is an integer that specifies the offset of the correlation ID within the user-id. If it is negative, it specifies the offset from the right.

    Note the special case where correlation ID is all of user-id; '@' will be stripped away from the DNIS as well since @<hostname> does not make sense.

    Valid values

    sip.dnis_correlationid_offset should be a valid integer (with minimum and maximum values as defined by the Genesys Administrator Help)

    Default value

    0

    Takes effect At start/restart

    enablemaddr

    Enable SIP Via maddr Support

    Enables SIP VIA maddr parameter support as per RFC 3261. Disabling prevents the SIP Stack from respecting the maddr parameter (needed when multicast support requires that the maddr parameter is not used).

    Valid values

    • true
    • false

    Default value

    true

    Takes effect At start/restart

    enablesendrecvevents

    Enable Send / Receive Events

    Enabled the receiving and sending of SIP INFO messages for application module usage. SIP INFO for other purposes (ie, DTMF) will not be affected.

    Valid values

    • false
    • true

    Default value

    true

    Takes effect Immediately/session

    enabletfci

    Enable TFCI outbound calls

    Allows TFCI (Telephony Free Client Interface) outbound calls. If this configuration is set to Enable, the To header of the outbound SIP INVITE request will be customized for TFCI devices.

    Valid values

    • 0
    • 1

    Default value

    0

    Takes effect At start/restart

    hfdisctimer

    HF Disconnect Timer

    The timeout value (in milliseconds) to terminate SIP hookflash transfer. For "Hookflash/wait for disconnect" mode, if a BYE is not received from remote end before this timeout, then the transfer is treated as failed (otherwise, the transfer is successful). For "Hookflash/initiate disconnect" mode, if a BYE is not received from remote end, then a BYE will be sent from local end after this timeout and the transfer is treated as successful whether BYE is received from remote end or generated from local end

    Valid values

    sip.hfdisctimer should be positive integer and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    5000

    Takes effect At start/restart

    hfprefix

    HF Prefix

    SIP hookflash transfer dialing prefix. Example: sip.hfprefix=none means dial string is exactly as specified in sip.hfprefix=! would dial a hookflash, and then the pattern in sip.hfprefix=*8,, would dial a '*8' followed by two pause durations

    Valid values

    sip.hfprefix should only contain 0-9, !, *, or none

    Default value

    !

    Takes effect At start/restart

    hfstopdial

    HF Stop dial

    digits to dial to stop a hookflash transfer. Character(s) to dial to abort a multi-phase hookflash. It will switch the connection back to original caller.

    Valid values

    sip.hfstopdial should only contain 0-9, !

    Default value

    !

    Takes effect At start/restart

    hftype

    Hookflash Transfer Type

    Hook flash transfer type for sip.

    Valid values

    • 0
    • 1

    Default value

    0

    Takes effect At start/restart

    in.bye.headers

    Custom Inbound BYE Headers

    Defines list of headers to expose to the application. This specifies a list of header names from the incoming BYE requests, whose values will be exposed to the application.

    For example, sip.in.bye.headers = Reason. The exposed values' names will be in sip.invite.<headername>=<value> format. If this value is '*', then all headers will be exposed. If this value is 'none', then no headers will be exposed.

    Valid values

    A valid entry can only contain alphanumeric characters, '.', '-', and ':''characters, or the wildcard, '*'

    Default value

    Reason

    Takes effect At start/restart

    in.info.headers

    Custom Inbound INFO Headers

    Defines list of headers to expose to the application. This specifies a list of header names from the incoming INFO requests, whose values will be exposed to the application.

    For example, sip.in.info.headers = From To Via. The exposed values' names will be in sip.info.<headername>=<value> format. If this value is '*', then all headers will be exposed. If this value is 'none', then no headers will be exposed. 'none' will be ignored alongside other values.

    Valid values

    A valid entry can only contain alphanumeric characters, '.', '-', and ':''characters, or the wildcard, '*'

    Default value

    *

    Takes effect At start/restart

    in.invite.headers

    Custom Inbound INVITE Headers

    Defines list of headers to expose to the application. This specifies a list of header names from the incoming INVITE requests, whose values will be exposed to the application.

    For example, sip.in.invite.headers = From To Via. The exposed values' names will be in sip.invite.<headername>=<value> format. If this value is '*', then all headers will be exposed. If this value is 'none', then no headers will be exposed. 'none' will be ignored alongside other values.

    Valid values

    A valid entry can only contain alphanumeric characters, '.', '-', and ':''characters, or the wildcard, '*'

    Default value

    *

    Takes effect At start/restart

    in.invite.params

    Custom Inbound INVITE Param

    Defines list of parameters to expose to the application. This specifies a list of header names from the incoming INVITE requests, whose parameter values will be exposed to the application.

    For example, sip.in.invite.params = From To Via. The exposed values' names will be in sip.invite.<headername>.<paramname>=<value> format. If this value is 'none', then no parameters will be exposed. 'none' will be ignored alongside other values.

    Valid values

    A valid entry can only contain alphanumeric characters, '.', '-', and ':''characters

    Default value

    RequestURI

    Takes effect At start/restart

    info.contenttype

    INFO Request Content-Type

    Specifies content type of outgoing SIP INFO messages that correspond to VoiceXML application events. A VoiceXML application can trigger the sending of a SIP INFO message by using tag with dest="callmgr". The MCP will then send a SIP INFO message to the remote end with content being the content of the tag. The default content type is "application/text".

    Valid values

    Any character is allowed

    Default value

    application/text

    Takes effect At start/restart

    localuser

    Contact Header User Name

    Configures the user name portion of the Contact header generated from the MCP

    Default value

    Genesys

    Takes effect At start/restart

    maxtcpaccepts

    Maximum TCP Accept

    Defines the maximum number of TCP connections that can be accepted at a time. The method for rejecting new concurrent TCP connection attempts above this amount is operating system dependant. If configured to higher than the operating system limit, the system limit will be used. Will automatically be set to [sip]maxtcpconnections if it is less than this value.

    Valid values

    The maximum number of connections must be an integer from 1 to 1000 inclusive

    Default value

    100

    Takes effect At start/restart

    maxtcpconnections

    Maximum TCP Connections

    Defines the maximum number of TCP connections concurrently established. If the maximum number of TCP connections has been reached, new SIP requests to establish TCP connections will be rejected

    Valid values

    The maximum number of connections must be an integer from 1 to 10000 inclusive

    Default value

    100

    Takes effect At start/restart

    maxtlsaccepts

    Maximum TLS Accept

    Defines the maximum number of TLS connections that can be accepted at a time. The method for rejecting new concurrent TLS connection attempts above this amount is operating system dependant. If configured to higher than the operating system limit, the system limit will be used. Will automatically be set to [sip]maxtlsconnections if it is less than this value.

    Valid values

    The maximum number of connections must be an integer from 1 to 1000 inclusive

    Default value

    100

    Takes effect At start/restart

    maxtlsconnections

    Maximum TLS Connections

    Defines the maximum number of TLS connections concurrently established. If the maximum number of TLS connections has been reached, new SIP requests to establish TLS connections will be rejected.

    Valid values

    The maximum number of TLS connections must be an integer from 1 to 10000 inclusive

    Default value

    100

    Takes effect At start/restart

    min_se

    Minimum Session Expire Time

    Defines the Min-SE parameter in seconds. This is the minimum duration of session expiry this SIP stack will accept from a user agent client.

    Valid values

    The parameter size must be an integer from 90 to 3600 inclusive

    Default value

    90

    Takes effect At start/restart

    mpc.copyheaders

    MPC Copy Headers

    Copy the specified headers from inbound call INVITE messages and pass them to the MPC. These headers are currently used by the third-party call recording feature only, and are copied to the out-going INVITE messages to a recorder. If "none" is the only value present, no headers will be copied. Empty string results in the default value being used. Note that the special value "*" is not supported for this parameter.

    Valid values

    A valid header can only contain alphanumeric characters, '.', '-', ':', '/' and '\' characters, and space is used to separate the headers

    Default value

    X-Genesys-geo-location

    Takes effect At start/restart

    mtusize

    MTU Size

    Defines the Maximum Transmission Unit (MTU) of the network interfaces. If a SIP request size is within 200 bytes of this value, the request will be sent on a congestion controlled transport protocol, such as TCP.

    Valid values

    The MTU size must be an integer from 1 to 65535 inclusive

    Default value

    1500

    Takes effect At start/restart

    out.info.headers

    Custom Outbound INFO Headers

    Defines list of headers to expose to the application. This specifies a list of header names from the outgoing INFO requests, whose values can be customized by the application.

    For example, sip.out.info.headers = From To Via. The customized values' names will be in sip.info.<headername>=<value> format. If this value is '*', then all headers will be exposed. If this value is 'none', then no headers will be exposed. 'none' will be ignored alongside other values.

    Valid values

    A valid entry can only contain alphanumeric characters, '.', '-', and ':''characters, or the wildcard, '*'

    Default value

    *

    Takes effect At start/restart

    out.invite.headers

    Custom Outbound INVITE Headers

    Defines list of headers to expose to the application. This specifies a list of header names from the outgoing INVITE requests, whose values can be customized by the application.

    For example, sip.out.invite.headers = From To Via. The customized values' names will be in sip.invite.<headername>=<value> format. If this value is '*', then all headers will be exposed. If this value is 'none', then no headers will be exposed. 'none' will be ignored alongside other values.

    Valid values

    A valid entry can only contain alphanumeric characters, '.', '-', and ':''characters, or the wildcard, '*'

    Default value

    *

    Takes effect At start/restart

    out.invite.params

    Custom Outbound INVITE Params

    Defines list of parameters to expose to the application. This specifies a list of header names from the outgoing INVITE requests, whose parameter values can be customized by the application. sip.out.invite.params = RequestURI.

    The customized values' names will be in sip.invite.<headername>.<paramname>=<value> format. If this value is 'none', then no headers will be exposed. 'none' will be ignored alongside other values.

    Valid values

    A valid entry can only contain alphanumeric characters, '.', '-', and ':''characters

    Default value

    RequestURI

    Takes effect At start/restart

    out.refer.headers

    Custom Outbound REFER Headers

    Defines list of headers to expose to the application. This specifies a list of header names from the outgoing REFER requests, whose values can be customized by the application. For example, sip.out.refer.headers = From To Via.

    The customized values' names will be in sip.refer.<headername>=<value> format.

    Valid values

    A valid entry can only contain alphanumeric characters, '.', '-', and ':''characters, or the wildcard, '*'

    Default value

    *

    Takes effect At start/restart

    out.refer.params

    Custom Outbound REFER Params

    Defines list of parameters to expose to the application. This specifies a list of header names from the outgoing REFER requests, whose parameter values can be customized by the application. sip.out.refer.params = RequestURI.

    The customized values' names will be in sip.refer.<headername>.<paramname>=<value> format.

    Valid values

    A valid entry can only contain alphanumeric characters, '.', '-', and ':''characters

    Default value

    RequestURI

    Takes effect At start/restart

    outcalluseoriggw

    Use Original Gateway in Outbound Call

    If a SIP call is placed via call or transfer, and the destination address does not contain a hostname or IP address, this parameter will determine which gateway to use. If sip.outcalluseroriggw is set to Enable, the call will be placed using the gateway of the inbound call (e.g. tel://3000 or sip:3000@; "@" is mandatory for the sip: schema in order to make the distinction between user part and host). If sip.outcalluseroriggw is set to Disable, either sip.defaultgw or sip.defaulthost will be used..

    Valid values

    • 0
    • 1

    Default value

    1

    Takes effect At start/restart

    p-alcatel-csbu

    P-Alcatel-CSBU Header Value

    This parameter specifies the value to be set in the P-Alcatel-CSBU header of the 200OK response to the initial incoming INVITE, when the request contains this header. If the parameter value is empty string, no header will be set.

    Default value

    fb=notransfer;dtmf_auto=on

    Takes effect Immediately/session

    passertedidentity

    P-Asserted-Identity Header

    This parameter specifies whether the P-Asserted-Identity header will be used as the ANI if it is found in the incoming SIP INVITE and its value will be exposed to the VXML interpreter through the session.connection.remote.uri session variable. Otherwise, the From header will be used.

    Valid values

    • 0
    • 1

    Default value

    1

    Takes effect Immediately/session

    pcalledpartyid

    P-Called-Party-ID Header

    This parameter specifies whether the P-Called-Party-ID header will be used as the DNIS, if it is found in the incoming SIP INVITE and its value will be exposed to the VXML interpreter through the session.connection.local.uri session variable. Otherwise, the To header will be used.

    Valid values

    • 0
    • 1

    Default value

    1

    Takes effect Immediately/session

    prack.support

    Enable Reliable Provisional Responses

    This parameter will allow the SIP Stack to send reliable the 101-199 provisional responses. The parameter value of 1 or 2 will enable the PRACK support. If the parameter value is set to 2 the MCP will include the "100rel" extension in the Require header of the outbound INVITE request, forcing a remote user that supports PRACK method to sent the provisional responses reliable. If the parameter value is set to 1, the "100rel" extension will be included in the Supported header of the outbound INVITE request giving the remote user the option to send or not the provisional responses reliable. The default parameter value is 0.

    Valid values

    • 0
    • 1
    • 2

    Default value

    0

    Takes effect At start/restart

    preferred_ipversion

    Preferred IP version to be used in SIP

    Preferred IP version to be used in SIP. When multiple IP addresses with different IP versions are resolved from a destination address, the first address from the list with the preferred IP version will be used. However, if there is no sip.transport defined for the preferred version, other version will be used. Valid values are "ipv4" and "ipv6".

    Valid values

    • ipv4
    • ipv6

    Default value

    ipv4

    Takes effect At start/restart

    referredby

    Referred By

    Specifies the header value of Referred-By in REFER message. "none" means no Referred-By header will be included in the REFER request. Empty (default) implies the local MCP SIP URI (ie, To header for inbound call or From header for outbound call) for the dialog will be used.

    Default value

    (blank)

    Takes effect At start/restart

    referxferhold

    Refer Transfer Hold

    Put originator on hold before refer or referjoin transfer. This specifies whether to put the original caller on hold (Invite hold) before sending the REFER for the transfer.

    Valid values

    • 0
    • 1

    Default value

    0

    Takes effect At start/restart

    referxfertryoutbound

    Refer Transfer retry REFER on the outbound leg

    Retry REFER on the outbound leg if the REFER with Replaces request fails on the inbound leg. Valid only for REFER with Replace transfer.

    Valid values

    • 0
    • 1

    Default value

    0

    Takes effect At start/restart

    referxferwaitbye

    Refer Transfer Wait Bye

    Wait for remote to disconnect after NOTIFY. This specifies a timeout value to wait for BYE message from the remote end before sending BYE to disconnect the call. If it is zero, it will send BYE right after a NOTIFY/200 is received. If it is non-zero, it will wait for the configured timeout (in milliseconds) before sending the BYE. Values are specified in millisecond.

    Valid values

    sip.referxferwaitbye should be a non-negative integer and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    0

    Takes effect At start/restart

    referxferwaitnotify

    Refer Transfer Wait Notify

    This parameter is applicable to REFER transfer. If this is set to Enable, LMSIP2 will wait for NOTIFY with a sipflag message with a final response after receiving a 2xx REFER response. If this is set to Disable, LMSIP will not wait for NOTIFY. After that, LMSIP2 will either be sending a BYE request or expecting a BYE request from the caller depending on the value of sip.referxferwaitbye.

    Valid values

    • 0
    • 1

    Default value

    1

    Takes effect At start/restart

    registerexpiryadjustment

    Register Expiry Adjustment

    Specifies the amount of time (in seconds) that the MCP should re-register with the configured registrars before their respective expiration times are reached

    Valid values

    sip.registerexpiryadjustment should be non-negative integer and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    10

    Takes effect At start/restart

    registration

    Registration

    Specifies setting for registration. The system can be configured to register with one or more SIP registration servers on the network.

    The format of the value for sip.registration entries is: <registration-server> <register-as> <requested-expiry> <username> <passowrd> <routeset> All parameters except routeset are compulsory.

    <registration-server> - Host/port with which to register. As the domain of the location service (e.g. genesyslab.com), the "userinfo" and "@" components MUST NOT be present. sip: and sips: can be prefixed to indicate which protocol to use. sip: will be used by default.

    <register-as> - SIP identity to register as. sip: or sips: can be prefixed to indicate which protocol to use. sip: will be used by default.

    <requested-expiry> - Duration of registration; system will re-register after registration expires

    <username> - The user name when authentication is required by the server. This may or may not be the same as register-as.A dash - should be used if no user name is needed.Anonymous will be used if the server request authentication under this setting.

    <password> - The password associated with the authentication user name. To specify an empty string please use the dash - character.

    <routeset> - Route set to define the list of server(s) that the REGISTER messages should go through. Each entry separated by a comma and no space in between. If left empty, the REGISTER messages will be sent directly to the registration-server. The system will attempt to register with all defined registration entries and will periodically re-register as required by the requested-expiry parameter. The system will unregister when shutting down.

    e.g. sip.registration = proxy1.genesyslab.com:5064 mcp@10.0.0.101 60 - -|sip:proxy2.genesyslab.com:5064 sip:mcp@10.0.0.102 60 user password

    Default value

    (blank)

    Takes effect At start/restart

    route.default.tcp

    Default route for TCP

    Default route for TCP. The number denotes the transport defined in sip.transport.x where x is the value of this parameter and will be used when no TCP routes are found.

    Valid values

    Must be a numeric, but can be empty

    Default value

    (blank)

    Takes effect At start/restart

    route.default.tls

    Default route for TLS

    Default route for TLS. The number denotes the transport defined in sip.transport.x where x is the value of this parameter and will be used when no TLS routes are found.

    Valid values

    Must be a numeric, but can be empty

    Default value

    (blank)

    Takes effect At start/restart

    route.default.udp

    Default route for UDP

    Default route for UDP. The number denotes the transport defined in sip.transport.x where x is the value of this parameter and will be used when no UDP routes are found. If this parameter is not set, the first UDP transport found in sip.transport.x becomes the default.

    Valid values

    Must be a numeric, but can be empty

    Default value

    (blank)

    Takes effect At start/restart

    route.dest.0

    Route Destination Instance 0

    This is an entry in routing table.
    Format: sip.route.dest.x=[Destination] [Netmask] [Transport] [Metric]
    To select an entry in routing table, we mask the outgoing IP Address with [Netmask]; if the result matches with the [Destination], we will accept that route. The [Transport] part determines the transport to use and maps to the index 'x' in one of the transports defined as sip.transport.x. In most of the cases, first accepted route will be used. Unless the protocol is specified or required (for example, when the message size is larger than mtusize, tcp is required to be used), the accepted route in routing table is also required to have matched protocol. If there.s no such route, default transport of that protocol will be used.
    If all cases failed, sip.transport.0.s protocol will be obtained. The default transport of the obtained protocol will be used.
    Note that [Metric] entry is needed but not used at this point.
    For example: sip.route.dest.0=138.120.72.0 255.255.255.0 1 0
    When we make a call to the machine 138.120.72.20, outgoing IP is masked with [netmask] using .bitwise AND. operator. In this case: 138.120.72.20 & 255.255.255.0 gives 138.120.72.0. This matches the defined [Destination] in the route. Therefore, transport in sip.transport.1 will be used.

    Default value

    (blank)

    Takes effect At start/restart

    route.dest.1

    Route Destination Instance 1

    This is an entry in routing table.
    Format: sip.route.dest.x=[Destination] [Netmask] [Transport] [Metric]
    To select an entry in routing table, we mask the outgoing IP Address with [Netmask]; if the result matches with the [Destination], we will accept that route. The [Transport] part determines the transport to use and maps to the index 'x' in one of the transports defined as sip.transport.x. In most of the cases, first accepted route will be used. Unless the protocol is specified or required (for example, when the message size is larger than mtusize, tcp is required to be used), the accepted route in routing table is also required to have matched protocol. If there.s no such route, default transport of that protocol will be used.
    If all cases failed, sip.transport.0.s protocol will be obtained. The default transport of the obtained protocol will be used.
    Note that [Metric] entry is needed but not used at this point.
    For example: sip.route.dest.0=138.120.72.0 255.255.255.0 1 0
    When we make a call to the machine 138.120.72.20, outgoing IP is masked with [netmask] using .bitwise AND. operator. In this case: 138.120.72.20 & 255.255.255.0 gives 138.120.72.0. This matches the defined [Destination] in the route. Therefore, transport in sip.transport.1 will be used.

    Default value

    (blank)

    Takes effect At start/restart

    route.dest.2

    Route Destination Instance 2

    This is an entry in routing table.
    Format: sip.route.dest.x=[Destination] [Netmask] [Transport] [Metric]
    To select an entry in routing table, we mask the outgoing IP Address with [Netmask]; if the result matches with the [Destination], we will accept that route. The [Transport] part determines the transport to use and maps to the index 'x' in one of the transports defined as sip.transport.x. In most of the cases, first accepted route will be used. Unless the protocol is specified or required (for example, when the message size is larger than mtusize, tcp is required to be used), the accepted route in routing table is also required to have matched protocol. If there.s no such route, default transport of that protocol will be used.
    If all cases failed, sip.transport.0.s protocol will be obtained. The default transport of the obtained protocol will be used.
    Note that [Metric] entry is needed but not used at this point.
    For example: sip.route.dest.0=138.120.72.0 255.255.255.0 1 0
    When we make a call to the machine 138.120.72.20, outgoing IP is masked with [netmask] using .bitwise AND. operator. In this case: 138.120.72.20 & 255.255.255.0 gives 138.120.72.0. This matches the defined [Destination] in the route. Therefore, transport in sip.transport.1 will be used.

    Default value

    (blank)

    Takes effect At start/restart

    route.dest.3

    Route Destination Instance 3

    This is an entry in routing table.
    Format: sip.route.dest.x=[Destination] [Netmask] [Transport] [Metric]
    To select an entry in routing table, we mask the outgoing IP Address with [Netmask]; if the result matches with the [Destination], we will accept that route. The [Transport] part determines the transport to use and maps to the index 'x' in one of the transports defined as sip.transport.x. In most of the cases, first accepted route will be used. Unless the protocol is specified or required (for example, when the message size is larger than mtusize, tcp is required to be used), the accepted route in routing table is also required to have matched protocol. If there.s no such route, default transport of that protocol will be used.
    If all cases failed, sip.transport.0.s protocol will be obtained. The default transport of the obtained protocol will be used.
    Note that [Metric] entry is needed but not used at this point.
    For example: sip.route.dest.0=138.120.72.0 255.255.255.0 1 0
    When we make a call to the machine 138.120.72.20, outgoing IP is masked with [netmask] using .bitwise AND. operator. In this case: 138.120.72.20 & 255.255.255.0 gives 138.120.72.0. This matches the defined [Destination] in the route. Therefore, transport in sip.transport.1 will be used.

    Default value

    (blank)

    Takes effect At start/restart

    route.dest.4

    Route Destination Instance 4

    This is an entry in routing table.
    Format: sip.route.dest.x=[Destination] [Netmask] [Transport] [Metric]
    To select an entry in routing table, we mask the outgoing IP Address with [Netmask]; if the result matches with the [Destination], we will accept that route. The [Transport] part determines the transport to use and maps to the index 'x' in one of the transports defined as sip.transport.x. In most of the cases, first accepted route will be used. Unless the protocol is specified or required (for example, when the message size is larger than mtusize, tcp is required to be used), the accepted route in routing table is also required to have matched protocol. If there.s no such route, default transport of that protocol will be used.
    If all cases failed, sip.transport.0.s protocol will be obtained. The default transport of the obtained protocol will be used.
    Note that [Metric] entry is needed but not used at this point.
    For example: sip.route.dest.0=138.120.72.0 255.255.255.0 1 0
    When we make a call to the machine 138.120.72.20, outgoing IP is masked with [netmask] using .bitwise AND. operator. In this case: 138.120.72.20 & 255.255.255.0 gives 138.120.72.0. This matches the defined [Destination] in the route. Therefore, transport in sip.transport.1 will be used.

    Default value

    (blank)

    Takes effect At start/restart

    route.dest.5

    Route Destination Instance 5

    This is an entry in routing table.
    Format: sip.route.dest.x=[Destination] [Netmask] [Transport] [Metric]
    To select an entry in routing table, we mask the outgoing IP Address with [Netmask]; if the result matches with the [Destination], we will accept that route. The [Transport] part determines the transport to use and maps to the index 'x' in one of the transports defined as sip.transport.x. In most of the cases, first accepted route will be used. Unless the protocol is specified or required (for example, when the message size is larger than mtusize, tcp is required to be used), the accepted route in routing table is also required to have matched protocol. If there.s no such route, default transport of that protocol will be used.
    If all cases failed, sip.transport.0.s protocol will be obtained. The default transport of the obtained protocol will be used.
    Note that [Metric] entry is needed but not used at this point.
    For example: sip.route.dest.0=138.120.72.0 255.255.255.0 1 0
    When we make a call to the machine 138.120.72.20, outgoing IP is masked with [netmask] using .bitwise AND. operator. In this case: 138.120.72.20 & 255.255.255.0 gives 138.120.72.0. This matches the defined [Destination] in the route. Therefore, transport in sip.transport.1 will be used.

    Default value

    (blank)

    Takes effect At start/restart

    routeset

    Route Set

    Defines a route set for non-secure SIP outbound calls. If defined, this route set will be inserted as the ROUTE header for all outgoing calls. This will force the MCP to send the SIP messages via this defined route set.

    Each element in the routeset should be separated by a comma. This parameter can be used to define outbound proxies. Note that this routeset does not apply to SIP REGISTER messages.

    sip.routeset = <sip:ip/host;priority>, ... e.g. sip.routeset=<sip:p1.example.com;lr>,<sip:p2.domain.com;lr>

    In this example, the MCP will route the request to p1.example.com, which will in turn route the message to p2.domain.com, and finally be redirected to its intended destination.

    This option is not applicable for transfer outbound calls initiated using VoiceXML. A transfer outbound call will use the same route set from the call initiated the transfer.

    Valid values

    A valid routeset must have the format as specify in its description

    Default value

    (blank)

    Takes effect At start/restart

    sdpansinprov

    Enable SDP answer in provisional response

    If this configuration option is enabled and the incoming INVITE contains an SDP offer, MCP will generate the SDP answer in the 101-199 provisional responses. NOTE: This configuration option applies if the [sip]prack.support is set to 1 or 2 (PRACK support is enabled) or the [sip]sendalert configuration option is set to 2 (183 Session Progress response). The default value is 1.

    Valid values

    • 0
    • 1

    Default value

    1

    Takes effect Immediately/session

    sdpwarningheaders

    SDP Warning Headers

    This parameter will enable the SIP warning headers created as a result of SDP negotiation.

    Valid values

    • 0
    • 1

    Default value

    0

    Takes effect Immediately/session

    securerouteset

    Secure Route Set

    Defines a route set for secure SIP outbound calls. Secure SIP calls should specify the "sips:" scheme or "tls" transport. If the secure route set is defined, this route set will be inserted as the ROUTE header for all outgoing calls. This will force the MCP to send the SIP messages via this defined route set.

    Each element in the routeset should be separated by a comma. This parameter can be used to define outbound proxies. Note that this routeset does not apply to SIP REGISTER messages.

    sip.securerouteset = <sips:ip/host;priority>, ... e.g. sip.securerouteset=<sips:p1.example.com;lr>,<sips:p2.domain.com;lr>

    In this example, the MCP will route the request to p1.example.com, which will in turn route the message to p2.domain.com, and finally be redirected to its intended destination.

    This option is not applicable for transfer outbound calls initiated using VoiceXML. A transfer outbound call will use the same route set from the call initiated the transfer.

    Valid values

    A valid secure routeset must have the format as specify in its description

    Default value

    (blank)

    Takes effect At start/restart

    sendalert

    Send Alert

    Specifies the SIP response for alerting. NOTE: Use the [sip]sdpansinprov configuration option to include an SDP answer in the 183 Session Progress response if incoming INVITE contains an SDP offer. The default value is 1.

    Valid values

    • 0
    • 1
    • 2

    Default value

    1

    Takes effect Immediately/session

    sessionexpires

    Session Expires

    Defines the default session expiry value in seconds. The session timer defines the duration of which a SIP session will expire if no re-INVITEs are sent/received within this period.

    Valid values

    The parameter size must be an integer from 90 to 3600 inclusive

    Default value

    1800

    Takes effect At start/restart

    sipinfoallowedcontenttypes

    INFO Allowed Content-Types

    Content types in a SIP INFO messages that are allowed to be passed up to the application level. Only the defined content types would be passed up, others would be ignored. If left empty, the default value is "allowall", which means the content of all received SIP INFO messages would be passed upstream. This is a space delimited list of values.

    Valid values

    A valid content type can only contain alphanumeric characters, and '/' or '\'

    Default value

    (blank)

    Takes effect At start/restart

    tcp.portrange

    Local TCP port range

    The local TCP port range to be used for SIP transport. If this parameter is not specified, MCP will let the OS choose the local port.

    Valid values

    Possible values are the empty string or low-high, where low and high are integers from 1030 to 65535 inclusive

    Default value

    (blank)

    Takes effect At start/restart

    threadpoolsize

    Threadpool Size

    The size of the thread pool for handling DNS queries.

    Valid values

    A valid value is an integer from 1 to 100 inclusive.

    Default value

    4

    Takes effect At start/restart

    threads

    Number of Worker Threads

    Specifies the number of worker threads that handles the SIP requests arriving from the SIP transport layer. If the value is 0, all requests are handled within the arriving transport layer thread. Otherwise, all arriving requests are handled by hashing onto the N number of worker threads.

    Default value

    0

    Takes effect After restart

    timer.ci_proceeding

    Client Invite Proceeding Timer

    Defines the client INVITE proceeding timer in milliseconds, default value is 120000. The timer starts after a 1xx response is received for a client INVITE. If a final response is not received before the timer expires, the SIP session and dialog will be destroyed without further notice to the UAS. Note that the CI proceeding timer should be configured to be greater than the connect timeout of the outbound call (depending on how the outbound call is initiated, the connect timeout can be specified in the transfer tag, or in the remdial command). Otherwise, the Client Invite Proceeding Timer will be triggered before the connect timeout occurs, which overrides the connect timeout as a result.

    Valid values

    sip.timer.ci_proceeding must be an integer that is greater than 0 and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    120000

    Takes effect At start/restart

    timer.provretransmit

    Server Provisional Response Retransmit Timer

    Defines the server provisional response (101-199) retransmit timer in milliseconds. The timer starts after a 101-199 provisional response is sent for the server INVITE. If a final response is not ready before the timer expires, the UA transaction will retransmit the provisional response to extend the transaction on the proxies (refresh TIMER C). Note that the [sip]timer.provretransmit value should be configured to 150000 ms if reliable provisional responses is enabled (please see the description of the [sip]prack.support parameter ). If the value of the parameter is set outside the defined range, the actual value will use the boundary value. The default value is 60000.

    Valid values

    [sip]timer.provretransmit must be an integer that is greater than 60000 and less than 150000.

    Default value

    60000

    Takes effect At start/restart

    timer_si

    Server Invite Retransmission Aborting Timer

    Defines the server INVITE retransmission aborting timer in milliseconds, default value is 32000. The timer starts after a 2xx response is sent for a server INVITE. If an ACK is not received before the timer expires, a BYE message will be sent.

    Valid values

    The parameter must be an integer that is greater than 0 and less than or equal to the maximum integer as defined by the Genesys Administrator Help.

    Default value

    32000

    Takes effect At start/restart

    tls.portrange

    Local TLS port range

    The local TLS port range to be used for SIP transport. If this parameter is not specified, MCP will let the OS choose the local port.

    Valid values

    Possible values are the empty string or low-high, where low and high are integers from 1030 to 65535 inclusive

    Default value

    (blank)

    Takes effect At start/restart

    transfermethods

    Transfer Methods

    Transfer Methods for sip. The final option will be ignored if selected with other options.

    Valid values

    • HKF
    • REFER
    • REFERJOIN
    • MEDIAREDIRECT
    • ATTCOURTESY
    • ATTCONSULT
    • ATTCONFERENCE
    • ATTOOBCOURTESY
    • ATTOOBCONSULT
    • ATTOOBCONFERENCE
    • NEC61ISDN
    • none

    Default value

    HKF REFER REFERJOIN MEDIAREDIRECT ATTCOURTESY ATTCONSULT ATTCONFERENCE ATTOOBCOURTESY ATTOOBCONSULT ATTOOBCONFERENCE NEC61ISDN

    Takes effect At start/restart

    transport.0

    Transport Instance 0

    defines transport layer for SIP stack and the network interfaces that are used to process SIP requests Format: sip.transport.x = transport_name
    type:ip:port [parameters]

    where transport_name is any string; type is udp/tcp/tls; ip is the IP address of the network interface that accepts incoming SIP messages; port is the port number where SIP stack accepts incoming SIP messages;
    [parameters] defines any extra SIP transport parameters. Note that this is for LMSIP2.

    If ip is an IPv6 address, [] must be used. To define a transport to listen to all IPv4 interfaces, use "any" or "any4" for ip. To define a transport to listen to all IPv6 interfaces, use "any6" for ip. Example:
    cert=[cert path and filename] Applicable to SIPS only and mandatory if using SIPS. The path and the filename of the TLS certificate to be used key=[key path and filename] Applicable to SIPS only and mandatory if using SIPS. The path and the filename of the TLS key to be used. type=[Type of secure transport] Applicable to SIPS only and is optional. The type of secure transport to be used and value can be TLSv1, SSLv2, SSLv3, SSLv23. Default to SSLv23. password=[password] Applicable to SIPS only and is optional. The password associated with the certificate and key pair. Required only if key file is password protected.

    cafile=[CA cert path and filename] Mandatory for TLS mutual authentication. The path and the filename of the certificate to be used for verifying the peer. The same certificate specified in cert=[cert path and filename] parameter can be used as the value here if using only 1 certificate is preferred. verifypeer=true Mandatory for TLS mutual authentication. This parameter turns on the TLS mutual authentication. verifydepth=[max depth for the certificate chain verification] Applicable only to TLS mutual authentication. This parameter sets the maximum depth for the certificate chain verification. For the default Genesys certificate provided, the recommended value is 1. Remarks: The default transport will be the smallest non-empty ID. If all transport.x values are empty, UDP, TCP and TLS transports will all be enabled and respectively listen from ports 5060, 5060 and 5061 on any network interface, TLS transport will use the certificate, x509_certificate.pem, and key, x509_private_key.pem, in the config directory and UDP will be the default transport.

    Default value

    transport0 udp:any:5070

    Takes effect At start/restart

    transport.0.tos

    IP Type of Service for transport instance 0

    Specifies the IP Differentiaed Services Field (also known as ToS) to set in all outgoing SIP packets over transport instance 0. Note that this configuration does not work for Windows 2008. For Windows 2008, the setting needs to be configured at the OS level through the policy settings. Please refer to the GVP User's Guide.

    Valid values

    Possible values are integers from 0 to 255 inclusive.

    Default value

    0

    Takes effect At start/restart

    transport.1

    Transport Instance 1

    defines transport layer for SIP stack and the network interfaces that are used to process SIP requests Format: sip.transport.x = transport_name
    type:ip:port [parameters]

    where transport_name is any string; type is udp/tcp/tls; ip is the IP address of the network interface that accepts incoming SIP messages; [parameters] defines any extra SIP transport parameters. Note that this is for LMSIP2.

    If ip is an IPv6 address, [] must be used. To define a transport to listen to all IPv4 interfaces, use "any" or "any4" for ip. To define a transport to listen to all IPv6 interfaces, use "any6" for ip. port is the port number where SIP stack accepts incoming SIP messages;
    Example:
    cert=[cert path and filename] Applicable to SIPS only and mandatory if using SIPS. The path and the filename of the TLS certificate to be used key=[key path and filename] Applicable to SIPS only and mandatory if using SIPS. The path and the filename of the TLS key to be used. type=[Type of secure transport] Applicable to SIPS only and is optional. The type of secure transport to be used and value can be TLSv1, SSLv2, SSLv3, SSLv23. Default to SSLv23. password=[password] Applicable to SIPS only and is optional. The password associated with the certificate and key pair. Required only if key file is password protected.

    cafile=[CA cert path and filename] Mandatory for TLS mutual authentication. The path and the filename of the certificate to be used for verifying the peer. The same certificate specified in cert=[cert path and filename] parameter can be used as the value here if using only 1 certificate is preferred. verifypeer=true Mandatory for TLS mutual authentication. This parameter turns on the TLS mutual authentication. verifydepth=[max depth for the certificate chain verification] Applicable only to TLS mutual authentication. This parameter sets the maximum depth for the certificate chain verification. For the default Genesys certificate provided, the recommended value is 1. Remarks: The default transport will be the smallest non-empty ID. If all transport.x values are empty, UDP, TCP and TLS transports will all be enabled and respectively listen from ports 5060, 5060 and 5061 on any network interface, TLS transport will use the certificate, x509_certificate.pem, and key, x509_private_key.pem, in the config directory and UDP will be the default transport.

    Default value

    transport1 tcp:any:5070

    Takes effect At start/restart

    transport.1.tos

    IP Type of Service for transport instance 1

    Specifies the IP Differentiaed Services Field (also known as ToS) to set in all outgoing SIP packets over transport instance 1. Note that this configuration does not work for Windows 2008. For Windows 2008, the setting needs to be configured at the OS level through the policy settings. Please refer to the GVP User's Guide.

    Valid values

    Possible values are integers from 0 to 255 inclusive.

    Default value

    0

    Takes effect At start/restart

    transport.2

    Transport Instance 2

    defines transport layer for SIP stack and the network interfaces that are used to process SIP requests Format: sip.transport.x = transport_name
    type:ip:port [parameters]

    where transport_name is any string; type is udp/tcp/tls; ip is the IP address of the network interface that accepts incoming SIP messages; [parameters] defines any extra SIP transport parameters. Note that this is for LMSIP2.

    If ip is an IPv6 address, [] must be used. To define a transport to listen to all IPv4 interfaces, use "any" or "any4" for ip. To define a transport to listen to all IPv6 interfaces, use "any6" for ip. port is the port number where SIP stack accepts incoming SIP messages;
    Example:
    cert=[cert path and filename] Applicable to SIPS only and mandatory if using SIPS. The path and the filename of the TLS certificate to be used key=[key path and filename] Applicable to SIPS only and mandatory if using SIPS. The path and the filename of the TLS key to be used. type=[Type of secure transport] Applicable to SIPS only and is optional. The type of secure transport to be used and value can be TLSv1, SSLv2, SSLv3, SSLv23. Default to SSLv23. password=[password] Applicable to SIPS only and is optional. The password associated with the certificate and key pair. Required only if key file is password protected.

    cafile=[CA cert path and filename] Mandatory for TLS mutual authentication. The path and the filename of the certificate to be used for verifying the peer. The same certificate specified in cert=[cert path and filename] parameter can be used as the value here if using only 1 certificate is preferred. verifypeer=true Mandatory for TLS mutual authentication. This parameter turns on the TLS mutual authentication. verifydepth=[max depth for the certificate chain verification] Applicable only to TLS mutual authentication. This parameter sets the maximum depth for the certificate chain verification. For the default Genesys certificate provided, the recommended value is 1. Remarks: The default transport will be the smallest non-empty ID. If all transport.x values are empty, UDP, TCP and TLS transports will all be enabled and respectively listen from ports 5060, 5060 and 5061 on any network interface, TLS transport will use the certificate, x509_certificate.pem, and key, x509_private_key.pem, in the config directory and UDP will be the default transport.

    Default value

    transport2 tls:any:5071 cert=$InstallationRoot$/config/x509_certificate.pem key=$InstallationRoot$/config/x509_private_key.pem

    Takes effect At start/restart

    transport.2.tos

    IP Type of Service for transport instance 2

    Specifies the IP Differentiaed Services Field (also known as ToS) to set in all outgoing SIP packets over transport instance 2. Note that this configuration does not work for Windows 2008. For Windows 2008, the setting needs to be configured at the OS level through the policy settings. Please refer to the GVP User's Guide.

    Valid values

    Possible values are integers from 0 to 255 inclusive.

    Default value

    0

    Takes effect At start/restart

    transport.3

    Transport Instance 3

    defines transport layer for SIP stack and the network interfaces that are used to process SIP requests Format: sip.transport.x = transport_name
    type:ip:port [parameters]

    where transport_name is any string; type is udp/tcp/tls; ip is the IP address of the network interface that accepts incoming SIP messages; port is the port number where SIP stack accepts incoming SIP messages;
    [parameters] defines any extra SIP transport parameters. Note that this is for LMSIP2.

    If ip is an IPv6 address, [] must be used. To define a transport to listen to all IPv4 interfaces, use "any" or "any4" for ip. To define a transport to listen to all IPv6 interfaces, use "any6" for ip. Example:
    cert=[cert path and filename] Applicable to SIPS only and mandatory if using SIPS. The path and the filename of the TLS certificate to be used key=[key path and filename] Applicable to SIPS only and mandatory if using SIPS. The path and the filename of the TLS key to be used. type=[Type of secure transport] Applicable to SIPS only and is optional. The type of secure transport to be used and value can be TLSv1, SSLv2, SSLv3, SSLv23. Default to SSLv23. password=[password] Applicable to SIPS only and is optional. The password associated with the certificate and key pair. Required only if key file is password protected.

    cafile=[CA cert path and filename] Mandatory for TLS mutual authentication. The path and the filename of the certificate to be used for verifying the peer. The same certificate specified in cert=[cert path and filename] parameter can be used as the value here if using only 1 certificate is preferred. verifypeer=true Mandatory for TLS mutual authentication. This parameter turns on the TLS mutual authentication. verifydepth=[max depth for the certificate chain verification] Applicable only to TLS mutual authentication. This parameter sets the maximum depth for the certificate chain verification. For the default Genesys certificate provided, the recommended value is 1. Remarks: The default transport will be the smallest non-empty ID. If all transport.x values are empty, UDP, TCP and TLS transports will all be enabled and respectively listen from ports 5060, 5060 and 5061 on any network interface, TLS transport will use the certificate, x509_certificate.pem, and key, x509_private_key.pem, in the config directory and UDP will be the default transport.

    Default value

    (blank)

    Takes effect At start/restart

    transport.3.tos

    IP Type of Service for transport instance 3

    Specifies the IP Differentiaed Services Field (also known as ToS) to set in all outgoing SIP packets over transport instance 3. Note that this configuration does not work for Windows 2008. For Windows 2008, the setting needs to be configured at the OS level through the policy settings. Please refer to the GVP User's Guide.

    Valid values

    Possible values are integers from 0 to 255 inclusive.

    Default value

    0

    Takes effect At start/restart

    transport.4

    Transport Instance 4

    defines transport layer for SIP stack and the network interfaces that are used to process SIP requests Format: sip.transport.x = transport_name
    type:ip:port [parameters]

    where transport_name is any string; type is udp/tcp/tls; ip is the IP address of the network interface that accepts incoming SIP messages; port is the port number where SIP stack accepts incoming SIP messages;
    [parameters] defines any extra SIP transport parameters. Note that this is for LMSIP2.

    If ip is an IPv6 address, [] must be used. To define a transport to listen to all IPv4 interfaces, use "any" or "any4" for ip. To define a transport to listen to all IPv6 interfaces, use "any6" for ip. Example:
    cert=[cert path and filename] Applicable to SIPS only and mandatory if using SIPS. The path and the filename of the TLS certificate to be used key=[key path and filename] Applicable to SIPS only and mandatory if using SIPS. The path and the filename of the TLS key to be used. type=[Type of secure transport] Applicable to SIPS only and is optional. The type of secure transport to be used and value can be TLSv1, SSLv2, SSLv3, SSLv23. Default to SSLv23. password=[password] Applicable to SIPS only and is optional. The password associated with the certificate and key pair. Required only if key file is password protected.

    cafile=[CA cert path and filename] Mandatory for TLS mutual authentication. The path and the filename of the certificate to be used for verifying the peer. The same certificate specified in cert=[cert path and filename] parameter can be used as the value here if using only 1 certificate is preferred. verifypeer=true Mandatory for TLS mutual authentication. This parameter turns on the TLS mutual authentication. verifydepth=[max depth for the certificate chain verification] Applicable only to TLS mutual authentication. This parameter sets the maximum depth for the certificate chain verification. For the default Genesys certificate provided, the recommended value is 1. Remarks: The default transport will be the smallest non-empty ID. If all transport.x values are empty, UDP, TCP and TLS transports will all be enabled and respectively listen from ports 5060, 5060 and 5061 on any network interface, TLS transport will use the certificate, x509_certificate.pem, and key, x509_private_key.pem, in the config directory and UDP will be the default transport.

    Default value

    (blank)

    Takes effect At start/restart

    transport.4.tos

    IP Type of Service for transport instance 4

    Specifies the IP Differentiaed Services Field (also known as ToS) to set in all outgoing SIP packets over transport instance 4. Note that this configuration does not work for Windows 2008. For Windows 2008, the setting needs to be configured at the OS level through the policy settings. Please refer to the GVP User's Guide.

    Valid values

    Possible values are integers from 0 to 255 inclusive.

    Default value

    0

    Takes effect At start/restart

    transport.5

    Transport Instance 5

    defines transport layer for SIP stack and the network interfaces that are used to process SIP requests Format: sip.transport.x = transport_name
    type:ip:port [parameters]

    where transport_name is any string; type is udp/tcp/tls; ip is the IP address of the network interface that accepts incoming SIP messages; port is the port number where SIP stack accepts incoming SIP messages;
    [parameters] defines any extra SIP transport parameters. Note that this is for LMSIP2.

    If ip is an IPv6 address, [] must be used. To define a transport to listen to all IPv4 interfaces, use "any" or "any4" for ip. To define a transport to listen to all IPv6 interfaces, use "any6" for ip. Example:
    cert=[cert path and filename] Applicable to SIPS only and mandatory if using SIPS. The path and the filename of the TLS certificate to be used key=[key path and filename] Applicable to SIPS only and mandatory if using SIPS. The path and the filename of the TLS key to be used. type=[Type of secure transport] Applicable to SIPS only and is optional. The type of secure transport to be used and value can be TLSv1, SSLv2, SSLv3, SSLv23. Default to SSLv23. password=[password] Applicable to SIPS only and is optional. The password associated with the certificate and key pair. Required only if key file is password protected.

    cafile=[CA cert path and filename] Mandatory for TLS mutual authentication. The path and the filename of the certificate to be used for verifying the peer. The same certificate specified in cert=[cert path and filename] parameter can be used as the value here if using only 1 certificate is preferred. verifypeer=true Mandatory for TLS mutual authentication. This parameter turns on the TLS mutual authentication. verifydepth=[max depth for the certificate chain verification] Applicable only to TLS mutual authentication. This parameter sets the maximum depth for the certificate chain verification. For the default Genesys certificate provided, the recommended value is 1. Remarks: The default transport will be the smallest non-empty ID. If all transport.x values are empty, UDP, TCP and TLS transports will all be enabled and respectively listen from ports 5060, 5060 and 5061 on any network interface, TLS transport will use the certificate, x509_certificate.pem, and key, x509_private_key.pem, in the config directory and UDP will be the default transport.

    Default value

    (blank)

    Takes effect At start/restart

    transport.5.tos

    IP Type of Service for transport instance 5

    Specifies the IP Differentiaed Services Field (also known as ToS) to set in all outgoing SIP packets over transport instance 5. Note that this configuration does not work for Windows 2008. For Windows 2008, the setting needs to be configured at the OS level through the policy settings. Please refer to the GVP User's Guide.

    Valid values

    Possible values are integers from 0 to 255 inclusive.

    Default value

    0

    Takes effect At start/restart

    transport.dnsharouting

    DNS HA Routing

    Specifies whether the DNS HA routing based on RFC3263 should be turned on. If turned off, alternate records returned from the DNS query will not be tried. Otherwise, alternate records returned from the DNS query will be tried based on RFC3263.

    Valid values

    • true
    • false

    Default value

    false

    Takes effect At start/restart

    transport.localaddress

    Local Transport IPv4 Address

    If specified, the sent-by field of the Via header and the hostport part of the Contact header in the outgoing SIP message will be set to this value if a IPv4 transport is used. The value must be a hostname or domain name. If left empty the outgoing transport's actual IP and port will be used for the Via header and the Contact header. Note that if the domain name used in the SRV record query is specified, sip.transport.localaddress.srv must be set to true to prevent the port part being automatically generated by the SIP stack.

    Default value

    (blank)

    Takes effect At start/restart

    transport.localaddress.srv

    Local Transport Address contains SRV domain name

    Specifies whether the sip.transport.localaddress contains an SRV domain name. If set to true, port part will not be automatically generated by the SIP stack. Otherwise, the outgoing transport's port will used together with the hostname specified by the sip.transport.localaddress.

    Valid values

    • true
    • false

    Default value

    false

    Takes effect At start/restart

    transport.localaddress_ipv6

    Local Transport IPv6 Address

    If specified, the sent-by field of the Via header and the hostport part of the Contact header in the outgoing SIP message will be set to this value if a IPv6 transport is used. The value must be a hostname or domain name. If left empty the outgoing transport's actual IP and port will be used for the Via header and the Contact header. Note that if the domain name used in the SRV record query is specified, sip.transport.localaddress.srv must be set to true to prevent the port part being automatically generated by the SIP stack.

    Default value

    (blank)

    Takes effect At start/restart

    transport.staticroutelist

    SIP Static Route List

    Specifies a list of static routes. Each route group is separated by |. Each static route group is a list of IP addresses separated by comma. Within the route group, each IP address could substitute each other as an alternate route destination if sending a SIP request to one of the IP address fails. For example, 10.0.0.1,10.0.0.2|10.0.10.1,10.0.10.2 specified two static route groups, and each group specified two routes that are alternative to each other. Default value is an empty list.

    Default value

    (blank)

    Takes effect At start/restart

    voipmetrics.localhost

    VoIP Metrics Local Host

    sip.voipmetrics.localhost, sip.voipmetrics.remoteserver, and optionally sip.voipmetrics.routeset are used together to provide the configurability of VoIP metrics report via SIP PUBLISH method. The localhost represents the MCP performing VoIP metrics collection. The remoteserver represents the server collecting VoIP metrics report. The routeset can be optionally used to specify the route other than remote server address if alternate routes are required. If sip.voipmetrics.remoteserver is not specified (blank in the configuration), VoIP metrics reporting will be disabled as no SIP PUBLISH method will be sent. sip.voipmetrics.localhost parameter can also be used to provide the fully qualified domain name in SIP requests. The format of the localhost is the host/port of the MCP and can be prefixed with sip: or sips: to indicate which protocol to use. sip: will be used by default. For example, sip.voipmetrics.localhost = sip:voipmetrics1.genesyslab.com:5060.

    Default value

    sip:$LocalIP$:5070

    Takes effect At start/restart

    voipmetrics.registration

    VoIP Metrics Registration

    This configuration performs exactly the same as registration configuration under sip section except it is exclusively used for VoIP metrics report. The system can be configured to register with one or more SIP registration servers on the network. If specified correctly, MCP will register itself to all registrars. If not specified, registration for VoIP metrics will not happen. For detailed information and how to configure, refer to registration configuration under sip section.

    Default value

    (blank)

    Takes effect At start/restart

    voipmetrics.remoteserver

    VoIP Metrics Remote Server

    sip.voipmetrics.localhost, sip.voipmetrics.remoteserver, and optionally sip.voipmetrics.routeset are used together to provide the configurability of VoIP metrics report via SIP PUBLISH method. The localhost represents the MCP performing VoIP metrics collection. The remoteserver represents the server collecting VoIP metrics report. The routeset can be optionally used to specify the route other than remote server address if alternate routes are required. If sip.voipmetrics.remoteserver is not specified (blank in the configuration), VoIP metrics reporting will be disabled as no SIP PUBLISH method will be sent. sip.voipmetrics.remoteserver parameter can also be used to provide the fully qualified domain name in SIP requests. The format of the remoteserver is the host/port of the server collecting VoIP metrics through SIP PUBLISH method and can be prefixed with sip: or sips: to indicate which protocol to use. sip: will be used by default. For example, sip.voipmetrics.remoteserver = sip:voipmetrics2.genesyslab.com:5060.

    Default value

    (blank)

    Takes effect At start/restart

    voipmetrics.routeset

    VoIP Metrics Route Set

    Defines a route set for SIP PUBLISH for VoIP metrics report. If defined, this route set will be inserted as the ROUTE header for all SIP PUBLISH. This will force the MCP to send the SIP messages via this defined route set. Each element in the routeset should be separated by a comma and no space in between. This parameter can be used to define outbound proxies. The format is sip.voipmetrics.routeset = sip:ip1/host1;priority1,sip:ip2/host2;priority2, and so on. For example, sip.voipmetrics.routeset = sip:p1.example.com;lr,sip:p2.domain.com;lr. In this example, the MCP will route the SIP PUBLISH to p1.example.com, which will in turn route the message to p2.domain.com, and finally be redirected to its intended destination as specified in sip.voipmetrics.remoteserver.

    Default value

    (blank)

    Takes effect At start/restart

    vxmlinvite

    VoiceXML URL INVITE

    Specifies acceptance of VoiceXML URLs in INVITE message. It is possible for the originator of a SIP call to specify the initial VoiceXML URL that will be delivered on a session by encoding the Request-URI in the special form "sip:dialog.vxml.@host.com". The portion of the request URI must be encoded (e.g. : -> %3A). If such URLs are received, the normal DNIS mapping procedure will be bypassed, and the specified URL will be fetched.

    Valid values

    • 0
    • 1

    Default value

    1

    Takes effect At start/restart

    warningheaders

    Warning Headers

    sip.warningheaders will set when the MCP sends warning headers.

    Valid values

    • 0
    • 1
    • 2

    Default value

    0

    Takes effect Immediately/session

    xfer.copyheaders

    Transfer Copy Headers

    Copy specified headers from inbound call INVITE to outbound call INVITE for bridged calls and RLT calls. This parameter reads a space delimited list of header names. MCP will copy this list of header fields from an inbound call INVITE to outbound call INVITE of the same voicexml session (ie. bridged calls and RLT calls). Note that re-INVITE from the inbound call causes headers re-scan and applies latest changes on any outbound calls made within the call session. If "*" is present, all unknown headers will be copied. If "none" is the only value present, no headers will be copied. Empty string results in the default (*) being used. sip.copyheaders = VG-SS7-Xfer-Param

    Valid values

    A valid header can only contain alphanumeric characters, '.', '-', ':', ' ','/' and '\' characters

    Default value

    *

    Takes effect Immediately

    [stack]

    connection.portrange

    RTSP Port Range for MRCPv1 Client

    The port range of RTSP stack used by MRCPv1 client.

    Default value

    10000-11999

    connection.timeout

    MRCP Connection Timeout

    The connection timeout for SRM MRCPv1 and MRCPv2 Stack to establish a TCP connection to the server. The value must be integer values in milliseconds.

    Default value

    10000

    trace.debug

    Enable MRCP Stack Debug Trace

    Whether to enable the stack debug message

    Valid values

    • true
    • false

    Default value

    true

    [tts]

    defaultengine

    TTS Engine Default

    The engine specified here will be used to load a default engine. An application using a different name should override this using the ttsengine property or the Request URI configuration.

    Valid values

    The engine name must be a string.

    Default value

    default

    Takes effect Immediately/session

    reserve

    TTS Resource Reservation

    When set to true, the MCP will attempt to reserve a TTS resource prior to accepting the call. This resource will be available until an explicit release of the resource, or until the end of the call. The call will be rejected if the resource is not successfully reserved.

    Valid values

    • false
    • true

    Default value

    false

    Takes effect Immediately/session

    [vrm]

    client.dtmf.abnf_encoding_check

    ABNF grammar encoding check method

    Method for checking ABNF grammar encoding: Selecting content, the entire grammar content will be checked to confirm it is UTF-8 encoded. Selecting attribute, only the encoding field in the self-identifying header will be checked to confirm the grammar is UTF-8 encoded. If the encoding field is absent, the content check method will be used. Selecting none, the encoding will not be checked.

    Valid values

    • content
    • attribute
    • none

    Default value

    content

    client.dtmf.fetchtimeout

    Native DTMF Grammar Fetch Timeout

    Timeout in milliseconds that a native DTMF recognizer needs to complete for an external grammar fetching.

    Default value

    10000

    client.dtmf.maxage

    Native DTMF Grammar Maxage

    Maxage in milliseconds that a native DTMF recognizer will use for an external grammar fetching. A value of -1 indicates to use the server's maxage value.

    Default value

    -1

    client.dtmf.maxloopcount

    Native DTMF Grammar Maximum Loops

    Maximum number of loops that is allowed in evaluating a DTMF grammar.

    Default value

    1000

    client.dtmf.maxstale

    Native DTMF Grammar Maxstale

    Maxstale in milliseconds that a native DTMF recognizer will use for an external grammar fetching. A value of -1 indicates to use the server's maxstale value.

    Default value

    -1

    client.modules

    SRM Client Modules

    This parameter lists the SRM MRCP client protocol modules installed in the platform.

    Valid values

    • MRCPV1
    • MRCPV2
    • MRCP_DTMFRECOGNIZER

    Default value

    MRCPV1 MRCPV2 MRCP_DTMFRECOGNIZER

    client.mrcpv1.sendtrapformrcprecogcompletioncause

    Send Trap For MRCPv1 RECOGNITION-COMPLETE Event

    Send traps when receiving one of the completion-causes in the MRCP RECOGINTION-COMPLETE event. Refer to the MRCPv1 specification for the completion cause codes and their corresponding descriptions.

    Valid values

    A comma separated list of values and/or ranges.

    Default value

    004-006,009,010

    Takes effect Immediately

    client.mrcpv1.sendtrapformrcprequestfailure

    Send Trap For MRCPv1 Request Failure

    Send traps when one of these requests fails to send.

    Valid values

    • RTSP-DESCRIBE
    • RTSP-SETUP
    • RTSP-TEARDOWN
    • MRCP-SET-PARAMS
    • MRCP-DEFINE-GRAMMAR
    • MRCP-RECOGNIZE
    • MRCP-RECOGNITION-START-TIMER
    • MRCP-SPEAK
    • MRCP-STOP

    Default value

    (blank)

    Takes effect Immediately

    client.mrcpv1.sendtrapformrcpresponsecode

    Send Trap For MRCPv1 Response Codes

    Send traps when receiving one of the response codes in the MRCP request's reply. Refer to the MRCPv1 specification for the response codes and their corresponding descriptions.

    Valid values

    A comma separated list of values and/or ranges.

    Default value

    405,407

    Takes effect Immediately

    client.mrcpv1.sendtrapformrcpresponsefailure

    Send Trap For MRCPv1 Response Failure

    Send traps when receiving error response codes for these responses. The error response codes are configured in "Send Trap For MRCPv1 Response Codes".

    Valid values

    • RTSP-DESCRIBE
    • RTSP-SETUP
    • RTSP-TEARDOWN
    • MRCP-SET-PARAMS
    • MRCP-DEFINE-GRAMMAR
    • MRCP-RECOGNIZE
    • MRCP-RECOGNITION-START-TIMER
    • MRCP-SPEAK
    • MRCP-STOP

    Default value

    MRCP-DEFINE-GRAMMAR MRCP-RECOGNIZE MRCP-SPEAK

    Takes effect Immediately

    client.mrcpv1.sendtrapformrcpspeakcompletioncause

    Send Trap For MRCPv1 SPEAK-COMPLETE Event

    Send traps when receiving one of the completion-causes in the MRCP SPEAK-COMPLETE event. Refer to the MRCPv1 specification for the completion cause codes and their corresponding descriptions.

    Valid values

    A comma separated list of values and/or ranges.

    Default value

    002,005

    Takes effect Immediately

    client.mrcpv1.sendtrapforrtspresponsecode

    Send Trap For RTSP Response Codes

    Send traps when receiving one of the response codes in the RTSP request's reply. Refer to the RTSP specification for the response codes and their corresponding descriptions.

    Valid values

    A comma separated list of values and/or ranges.

    Default value

    405,454,500

    Takes effect Immediately

    client.mrcpv2.earlynomatch

    MRCPv2 Early No Match

    The TRUE value of this parameter tells the MRCPv2 server MUST not wait for the end of speech before processing the collected speech to match active grammars.

    Valid values

    • true
    • false

    Default value

    true

    client.mrcpv2.localaddr

    MRCPv2 local address

    Specifies the network interface (IP address) to be used by MRCPv2 stack. If this parameter is not specified, the OS will choose an interface.

    Default value

    (blank)

    Takes effect At start/restart

    client.mrcpv2.maxopensocket

    MRCPv2 Max Open Sockets

    The parameter specifies the maximum allowed sockets opened for MRCPv2 sessions.

    Default value

    256

    client.mrcpv2.portrange

    MRCPv2 Port Range

    The port range of MRCPv2 stack.

    Default value

    12000-13999

    client.mrcpv2.prefix

    MRCPv2 Prefix

    The value is used by the SIP stack to choose the SIP port for SRM MRCPv2 client.

    Default value

    mrcpv2client

    client.mrcpv2.sendtrapformrcprecogcompletioncause

    Send Trap For MRCPv2 RECOGNITION-COMPLETE Event

    Send traps when receiving one of the completion-causes in the MRCP RECOGINTION-COMPLETE event. Refer to the MRCPv2 specification for the completion cause codes and their corresponding descriptions.

    Valid values

    A comma separated list of values and/or ranges.

    Default value

    004-006,009,010,012,016

    Takes effect Immediately

    client.mrcpv2.sendtrapformrcprequestfailure

    Send Trap For MRCPv2 Request Failure

    Send traps when one of these requests fails to send.

    Valid values

    • SIP-OPTIONS
    • SIP-INVITE
    • SIP-BYE
    • MRCP-SET-PARAMS
    • MRCP-DEFINE-GRAMMAR
    • MRCP-RECOGNIZE
    • MRCP-START-INPUT-TIMER
    • MRCP-SPEAK
    • MRCP-STOP

    Default value

    (blank)

    Takes effect Immediately

    client.mrcpv2.sendtrapformrcpresponsecode

    Send Trap For MRCPv2 Response Codes

    Send traps when receiving one of the response codes in the MRCP request's reply. Refer to the MRCPv2 specification for the response codes and their corresponding descriptions.

    Valid values

    A comma separated list of values and/or ranges.

    Default value

    405,407

    Takes effect Immediately

    client.mrcpv2.sendtrapformrcpresponsefailure

    Send Trap For MRCPv2 Response Failure

    Send traps when receiving error response codes for these responses. The error response codes are configured in "Send Trap For MRCPv2 Response Codes".

    Valid values

    • SIP-OPTIONS
    • SIP-INVITE
    • SIP-BYE
    • MRCP-SET-PARAMS
    • MRCP-DEFINE-GRAMMAR
    • MRCP-RECOGNIZE
    • MRCP-START-INPUT-TIMER
    • MRCP-SPEAK
    • MRCP-STOP

    Default value

    MRCP-DEFINE-GRAMMAR MRCP-RECOGNIZE MRCP-SPEAK

    Takes effect Immediately

    client.mrcpv2.sendtrapformrcpspeakcompletioncause

    Send Trap For MRCPv2 SPEAK-COMPLETE Event

    Send traps when receiving one of the completion-causes in the MRCP SPEAK-COMPLETE event. Refer to the MRCPv2 specification for the completion cause codes and their corresponding descriptions.

    Valid values

    A comma separated list of values and/or ranges.

    Default value

    002,005

    Takes effect Immediately

    client.mrcpv2.sendtrapforsipresponsecode

    Send Trap For SIP Response Codes

    Send traps when receiving one of the response codes in the SIP response. Refer to the SIP specification for the response codes and their corresponding descriptions.

    Valid values

    A comma separated list of values and/or ranges.

    Default value

    400-513

    Takes effect Immediately

    client.universals.uri

    Universals Grammar URI

    This gives the URI convention that the NextGen VXMLI uses to specifiy the universals gramamrs. The default value should be set to: client.universals.uri = builtin:grammar/universals

    Default value

    builtin:grammar/universals

    rtp.localaddr

    Local RTP Address (IPv4)

    Specifies the IPv4 interface to be used by RTP streams to and from speech resources. If this parameter is not specified, then the value will be auto-configured.

    Default value

    $LocalIP$

    Takes effect At start/restart

    rtp.localaddrv6

    Local RTP Address (IPv6)

    Specifies the IPv6 interface to be used by RTP streams to and from speech resources. If this parameter is not specified, then the value will be auto-configured.

    Default value

    (blank)

    Takes effect At start/restart

    rtp.portrange

    RTP Port Range

    Specifies the ports to be used by RTP streams to and from speech resources. If this parameter is not specified, then the value will be auto-configured.

    Valid values

    Possible values are the empty string or low-high, where low and high are integers from 1030 to 65535 inclusive

    Default value

    45536-65535

    Takes effect At start/restart

    rtsp.localaddr

    Local RTSP Address

    Specifies the interface to be used by RTSP streams to and from speech resources. If this parameter is not specified, then the value will be auto-configured.

    Default value

    $LocalIP$

    Takes effect At start/restart

    [vrmrecorder]

    sip.localport

    VRMRecorder Local Non-secure SIP Port

    The Local Non-secure SIP Port used by the VRMRecorder Client when SIP UDP and SIP TCP are used.

    Valid values

    The port number must be from 1030 to 65535 inclusive

    Default value

    7090

    Takes effect At start/restart

    sip.localsecureport

    VRMRecorder Local Secure SIP Port

    The Local Secure SIP Port used by the VRMRecorder Client when SIP TLS is used.

    Valid values

    The port number must be from 1030 to 65535 inclusive

    Default value

    7091

    Takes effect At start/restart

    sip.preferred_ipversion

    VRMRecorder Preferred IP version to be used in SIP

    Preferred IP version to be used in SIP by the VRMRecorder. When multiple IP addresses with different IP versions are resolved from a destination address, the first address from the list with the preferred IP version will be used. However, if there is no sip.transport defined for the preferred version, the other version will be used. Valid values are "ipv4" and "ipv6".

    Valid values

    • ipv4
    • ipv6

    Default value

    ipv4

    Takes effect At start/restart

    sip.routeset

    VRMRecorder Route Set

    Defines a route set for non-secure SIP connections to third party recorders by the VRMRecorder client. If defined, this route set will be inserted as the ROUTE header for all VRMRecorder SIP sessions. This will force the MCP to send the SIP messages via this defined route set. Please see "[sip] routeset" for format and other descriptions. The typical value for this would be the Resource Manager (RM) address, as all recorder requests go through the RM.

    Valid values

    A valid routeset must have the format as specified in [sip] routeset description

    Default value

    (blank)

    Takes effect At start/restart

    sip.securerouteset

    VRMRecorder Secure Route Set

    Defines a route set for secure SIP connections to third party recorders. The URI for secure connections should specify the "sips:" scheme or "tls" transport. If the secure route set is defined, this route set will be inserted as the ROUTE header for all VRMRecorder secure SIP sessions. This will force the MCP to send the secure SIP messages via this defined route set. Please see "[sip] securerouteset" for format and other descriptions. The typical value for this would be the Resource Manager (RM)'s secure address, as all recorder requests go through the RM.

    Valid values

    A valid secure routeset must have the format as specified in its description

    Default value

    (blank)

    Takes effect At start/restart

    sip.transport.0

    VRMRecorder SIP UDP Transport

    The SIP UDP Transport used by the VRMRecorder Client. To define a transport to listen to all IPv4 interfaces, use "any" or "any4" for ip. To define a transport to listen to all IPv6 interfaces, use "any6" for ip.

    Default value

    transport0 udp:any:7090

    Takes effect At start/restart

    sip.transport.1

    VRMRecorder SIP TCP Transport

    The SIP TCP Transport used by the VRMRecorder Client. To define a transport to listen to all IPv4 interfaces, use "any" or "any4" for ip. To define a transport to listen to all IPv6 interfaces, use "any6" for ip.

    Default value

    transport1 tcp:any:7090

    Takes effect At start/restart

    sip.transport.2

    VRMRecorder SIP TLS Transport

    The SIP TLS Transport used by the VRMRecorder Client. To define a transport to listen to all IPv4 interfaces, use "any" or "any4" for ip. To define a transport to listen to all IPv6 interfaces, use "any6" for ip.

    Default value

    transport2 tls:any:7091

    Takes effect At start/restart

    sip.transport.dnsharouting

    VRMRecorder DNS HA Routing

    Specifies whether the DNS HA routing based on RFC3263 should be turned on. If turned off, alternate records returned from the DNS query will not be tried. Otherwise, alternate records returned from the DNS query will be tried based on RFC3263.

    Valid values

    • true
    • false

    Default value

    false

    Takes effect At start/restart

    sip.transport.localaddress

    VRMRecorder Local Transport IPv4 Address

    If specified, the sent-by field of the Via header and the hostport part of the Contact header in the outgoing SIP message will be set to this value if a IPv4 transport is used. The value must be a hostname or domain name. If left empty the outgoing transport's actual IP and port will be used for the Via header and the Contact header. Note that if the domain name used in the SRV record query is specified, vrmrecorder.sip.transport.localaddress.srv must be set to true to prevent the port part being automatically generated by the SIP stack.

    Default value

    (blank)

    Takes effect At start/restart

    sip.transport.localaddress.srv

    VRMRecorder Local Transport Address contains SRV domain name

    Specifies whether the mrcpv2client.transport.localaddress contains an SRV domain name. If set to true, port part will not be automatically generated by the SIP stack. Otherwise, the outgoing transport's port will used together with the hostname specified by the vrmrecorder.sip.transport.localaddress.

    Valid values

    • true
    • false

    Default value

    false

    Takes effect At start/restart

    sip.transport.localaddress_ipv6

    VRMRecorder Local Transport IPv6 Address

    If specified, the sent-by field of the Via header and the hostport part of the Contact header in the outgoing SIP message will be set to this value if a IPv6 transport is used. The value must be a hostname or domain name. If left empty the outgoing transport's actual IP and port will be used for the Via header and the Contact header. Note that if the domain name used in the SRV record query is specified, vrmrecorder.sip.transport.localaddress.srv must be set to true to prevent the port part being automatically generated by the SIP stack.

    Default value

    (blank)

    Takes effect At start/restart

    sip.transport.staticroutelist

    VRMRecorder SIP Static Route List

    Specifies a list of static routes. Each route group is separated by |. Each static route group is a list of IP addresses separated by comma. Within the route group, each IP address could substitute each other as an alternate route destination if sending a SIP request to one of the IP address fails. For example, 10.0.0.1,10.0.0.2|10.0.10.1,10.0.10.2 specified two static route groups, and each group specified two routes that are alternative to each other. Default value is an empty list.

    Default value

    (blank)

    Takes effect At start/restart

    [vxmli]

    ac.allow_if_missing

    Access Control - Allow if Missing

    Used for data. Determines the behaviour when fetched XML data does not contain any access-control processing instructions. This parameter only has an effect if ac.enabled is set to true. A value of true means to allow access to XML data if access-control directive is missing. A value of false means to disallow access to XML data if access-control directive is missing.

    Default value

    true

    Takes effect At start/restart

    ac.allow_if_nomatch

    Access Control - Allow if Nomatch

    Used by the data tag. This determines the behaviour of access-control when the host machine does not appear in any access-control directive. This parameter only has an effect if ac.enabled is set to true.

    Default value

    false

    Takes effect At start/restart

    ac.enabled

    Enable Access Control

    Controls support for access-control when using the data tag

    Default value

    true

    Takes effect At start/restart

    ac.use_platform_host_for_file_url

    Access Control - Use Platform Host for File URL

    Used for the data element. It determines the behaviour when the VoiceXML page accessing the XML data is a file URI. When set to true it will force access-control to use the hostname of the platform when verifying access-control instructions. When set to false, access will be allowed if VoiceXML page is a file URI.

    Default value

    true

    Takes effect At start/restart

    asr.release_on_transfer

    Release ASR Engines on Transfer

    If the value is true, all open ASR engines will be released upon a successful transfer (where no speech grammars are loaded). If the value is false, no open ASR engines will be released upon a successful transfer.

    Default value

    true

    Takes effect Immediately

    beep.uri

    Beep URI

    The URI (can be either file:// or http://) of the beep file to be played when beep="true" in the record tag.

    Default value

    file://$InstallationRoot$/audio/ulaw/default_audio/endofprompt.vox

    Takes effect At start/restart

    break.strength.medium

    Medium Break Time

    Specifies the time in milliseconds that the Interpreter should use when encountering a break with the specified strength. This value will be ignored if the break is rendered by a TTS service.

    Valid values

    A number between 1 and 1000000 inclusive.

    Default value

    500

    Takes effect At start/restart

    break.strength.strong

    Strong Break Time

    Specifies the time in milliseconds that the Interpreter should use when encountering a break with the specified strength. This value will be ignored if the break is rendered by a TTS service.

    Valid values

    A number between 1 and 1000000 inclusive.

    Default value

    1000

    Takes effect At start/restart

    break.strength.weak

    Weak Break Time

    Specifies the time in milliseconds that the Interpreter should use when encountering a break with the specified strength. This value will be ignored if the break is rendered by a TTS service.

    Valid values

    A number between 1 and 1000000 inclusive.

    Default value

    200

    Takes effect At start/restart

    break.strength.x-strong

    X-strong Break Time

    Specifies the time in milliseconds that the Interpreter should use when encountering a break with the specified strength. This value will be ignored if the break is rendered by a TTS service.

    Valid values

    A number between 1 and 1000000 inclusive.

    Default value

    2000

    Takes effect At start/restart

    break.strength.x-weak

    X-weak Break Time

    Specifies the time in milliseconds that the Interpreter should use when encountering a break with the specified strength. This value will be ignored if the break is rendered by a TTS service.

    Valid values

    A number between 1 and 1000000 inclusive.

    Default value

    50

    Takes effect At start/restart

    builtin_path

    Builtin Path

    This parameter indicates the main path to search for builtin audio files

    Default value

    $InstallationRoot$/audio/ulaw/

    Takes effect At start/restart

    cache.document.max_count

    Maximum Cached Documents

    The maximum number of documents that may be cached concurrently.

    Valid values

    A number between 0 and 5000 inclusive.

    Default value

    50

    Takes effect At start/restart

    cache.document.max_entry_size

    Maximum Cached Entry Size

    The maximum size of each cached document in bytes.

    Valid values

    A number between 0 and 5000000 inclusive.

    Default value

    100000

    Takes effect At start/restart

    cache.document.max_size

    Maximum Cache Size

    The maximum size, in bytes, of all concurrently cached documents.

    Valid values

    A number between 0 and 50000000 inclusive.

    Default value

    1000000

    Takes effect At start/restart

    conformance.disable_application_lastresult_extensions

    Disable Application Lastresult$ Extensions

    When set to true, none of the additional extension properties of the application.lastresult$ object are set when a result is exposed.

    Default value

    false

    Takes effect At start/restart

    conformance.disallow_exec_content_within_prompts

    Disallow Executable Content within Prompts

    When set to true, executable content is not permitted inside foreach, when the foreach is inside a prompt.

    Default value

    false

    Takes effect At start/restart

    conformance.rfc5552_bye_reason

    Conform to RFC5552 for the reason in the BYE message

    Indicates whether the interpreter will conform to RFC5552, in terms of including reason= in the body of the SIP BYE message. When it is set to false, the message will not have the __reason entry.

    Default value

    true

    Takes effect At start/restart

    conformance.strict_complete_timeout

    Strict Complete Timeout

    When set to true, the interpreter will calculate the maximum of the completetimeout and incompletetimeout values as the value for the incompletetimeout.

    Default value

    true

    conformance.strict_grammar_mode

    Strict Grammar Mode

    Indicates whether the interpreter will follow the VoiceXML specification strictly when handling the grammar element. Specifically, when set to false it will NOT ignore the mode attribute for an external grammar.

    Default value

    false

    Takes effect At start/restart

    conformance.strict_tts_mode

    Strict TTS Mode

    Indicates whether the Interpreter will be strict in conformance of the tts mode. The TTS language will be checked against the list specified in conformance.supported_tts_languages.

    Default value

    false

    Takes effect At start/restart

    conformance.supported_builtin_dtmf

    Supported Builtin DTMF Grammars

    Indicates the platform supported dtmf built-in grammars when strict grammar mode is enabled. This is a space delimited list.

    Default value

    boolean digits currency date number phone time

    Takes effect At start/restart

    conformance.supported_builtin_voice

    Supported Builtin Voice Grammars

    Indicates the platform supported voice built-in grammars when strict grammar mode is enabled. This is a space delimited list.

    Default value

    boolean digits currency date number phone time universals/Cancel universals/Exit universals/Help

    Takes effect At start/restart

    conformance.supported_grammar_languages

    Supported Grammar Languages

    Indicates the grammar languages supported. Note that this is only meaningful when conformance.strict_grammar_mode is enabled.

    Default value

    en-US

    Takes effect At start/restart

    conformance.supported_tts_languages

    Supported TTS Languages

    Indicates the tts languages supported. This is a '|' delimited list.

    Default value

    en-US

    Takes effect At start/restart

    data.use_xerces_dom_parser

    Use Xerces XML DOM parser for Data Tag Implementation

    Choose the XML DOM parser for data tag. Setting this to true is to choose Xerces XML parser; else XML for script is used.

    Default value

    false

    Takes effect At start/restart

    data.xmlscript_path

    Path of the XML Script

    The path of the java script files which are required if XML for script is used for the XML DOM parser. The names of the XML DOM parsing script files are xmlsax.js and xmlw3dom.js, and they should exist in this path

    Default value

    $InstallationRoot$/script/

    Takes effect At start/restart

    debug.enabled

    Enable Real Time Debugging

    Enable real time debugging for the platform.

    Default value

    false

    Takes effect At start/restart

    debug.server.ip

    Debugger Server IP

    The IP address that the debugging client should use to connect to the platform. The platform reports this value to the debugging client via SIP 18x response. A value of "default" means that the platform will determine the IP address programmatically.

    Default value

    default

    Takes effect At start/restart

    debug.server.port

    Debugger Server TCP Port

    The TCP port that the platform will accept socket connections from the debugging client. Setting to 0 will disable this port.

    Valid values

    An integer between 1025 and 65535 inclusive. or 0 to disable this port

    Default value

    27666

    Takes effect At start/restart

    debug.server.port.public

    Debugger Server Public Port

    The TCP port that the debugging client should use to connect to the platform. The platform reports this value to the debugging client via SIP 18x response. This value is publicly exposed and may be different from debug.server.port if a firewall separates the platform and the debugging client.

    Valid values

    An integer between 1025 and 65535 inclusive.

    Default value

    27666

    Takes effect At start/restart

    debug.server.tlscert

    Debugger Server TLS Certificate

    The path and file name of the TLS Certificate. This is required to establish a TLS connection between the debugging client and the platform.

    Default value

    $InstallationRoot$/config/x509_certificate.pem

    Takes effect At start/restart

    debug.server.tlskey

    Debugger Server TLS Key

    The path and file name of the TLS Key. This is required to establish a TLS connection between the debugging client and the platform.

    Default value

    $InstallationRoot$/config/x509_private_key.pem

    Takes effect At start/restart

    debug.server.tlspassword

    Password of Debugger Server TLS Key

    The password required to use the TLS Key, if the TLS Key is password protected.

    Default value

    (blank)

    Takes effect At start/restart

    debug.server.tlsport

    Debugger Server TLS Port

    The TLS port that the platform will accept socket connections from the debugging clients. Setting to 0 will disable this port.

    Valid values

    An integer between 1025 and 65535 inclusive, or 0 to disable the port.

    Default value

    27668

    Takes effect At start/restart

    debug.server.tlsport.public

    Debugger Server TLS Public Port

    The TLS port that the debugging clients should use to connect to the platform. The platform reports this value to the debugging client via SIP 18x response. This value is publicly exposed and may be different from debug.server.tlsport if a firewall separates the platform and the debugging clients.

    Valid values

    An integer between 1025 and 65535 inclusive.

    Default value

    27668

    Takes effect At start/restart

    default.alternate_uri

    Default alternate URI

    The value to use for an alternate URI when the main one can not be fetched.

    Default value

    (blank)

    Takes effect At start/restart

    default.connecttimeout

    Default Transfer Connect Timeout

    The default value to use for a transfer's connecttimeout attribute if not provided. Applies to bridge or consultation transfers. Specified in milliseconds.

    Valid values

    A number between 0 and 1000000 inclusive.

    Default value

    30000

    Takes effect At start/restart

    default.xmllang

    Default XML Language

    The default value to use for xml:lang when it is not provided in the document.

    Default value

    en-US

    Takes effect At start/restart

    defaults_vxml_url

    Defaults Page URL

    This parameter specifies the defaults.vxml path if a default root page is not specified in the DNIS-URL mapping.

    Default value

    file://$InstallationRoot$/config/defaults-ng.vxml

    Takes effect At start/restart

    directories.save_tempfiles

    The directory in which to save tempfiles.

    Default value

    $InstallationRoot$/tmp/

    Takes effect At start/restart

    expose.nlsml.dom

    Expose NLSML as DOM

    Instructs the interpreter whether to expose the NLSML result from the recognizer as a DOM object in application.lastresult$.xmlresult. A value of true means to expose NLSML result from recognizer. A value of false means not to expose NLSML result from recognizer. When this feature is enabled, it may consume large amount of CPU and memory resource if the application has application.lastresult$ as namelist value in various VoiceXML tags, such as in a subdialog.

    Default value

    false

    Takes effect At start/restart

    getinfo_pairs

    GetInfo Pairs

    It is used to set up the valid input parameter and its value for function _VGGetInfo(parameter) / _GetInfo(parameter). The list is comma-delimited, and each item in the list must be in the format =, for example hostaddr=www.genesyslab.com,company=genesys.

    Default value

    (blank)

    Takes effect Immediately

    grammar.builtin:dtmf/currency

    Built-in Currency Grammar Path

    Builtin currency grammar path relative to grammar.builtin_basepath_win or grammar.builtin_basepath_linux or grammar.builtin_baseurl.

    Default value

    dtmf/currency.grxml

    Takes effect At start/restart

    grammar.builtin:dtmf/date

    Built-in Date Grammar Path

    Builtin date grammar path relative to grammar.builtin_basepath_win or grammar.builtin_basepath_linux or grammar.builtin_baseurl.

    Default value

    dtmf/date.grxml

    Takes effect At start/restart

    grammar.builtin:dtmf/number

    Built-in Number Grammar Path

    Builtin number grammar path relative to grammar.builtin_basepath_win or grammar.builtin_basepath_linux or grammar.builtin_baseurl.

    Default value

    dtmf/number.grxml

    Takes effect At start/restart

    grammar.builtin:dtmf/phone

    Built-in Phone Grammar Path

    Builtin phone grammar path relative to grammar.builtin_basepath_win or grammar.builtin_basepath_linux or grammar.builtin_baseurl.

    Default value

    dtmf/phone.grxml

    Takes effect At start/restart

    grammar.builtin:dtmf/time

    Built-in Time Grammar Path

    Builtin time grammar path relative to grammar.builtin_basepath_win or grammar.builtin_basepath_linux or grammar.builtin_baseurl.

    Default value

    dtmf/time.grxml

    Takes effect At start/restart

    grammar.builtin_basepath_linux

    Built-in Grammar Base Path (Linux)

    Builtin grammar base path. This parameter is effective when parameter inlinegrammar_by_url is set to false.

    Default value

    /var/www/gvp/mcp/$AppName$/grammar/

    Takes effect At start/restart

    grammar.builtin_basepath_win

    Built-in Grammar Base Path (Windows)

    Builtin grammar base path. This parameter is effective when parameter inlinegrammar_by_url is set to false.

    Default value

    c:/program files/common files/gcti/www/gvp/mcp/$AppName$/grammar/

    Takes effect At start/restart

    grammar.builtin_baseurl

    Built-in Grammar Base URL

    The base URL to be used when exposing builtin dtmf grammars as a URL to be fetched by an offboard speech engine. This parameter is effective only when parameter inlinegrammar_by_url is set to true.

    Default value

    http://$LocalIP$/mcp/$AppName$/grammar/

    Takes effect At start/restart

    grammar.mimetypes

    Grammar MIME Types

    When vxmli.inlinegrammar_by_url is enabled, the interpreter exposes inline grammars as external grammars for an offboard speech engines as a URL reference, by a locally configured web server. This parameter defines the mappings between the media type of the grammars to the file extension of the exposed URL. The web server should be configured with the same mapping so that the media type of the grammar is exposed correctly to the speech engines. When vxmli.inlinegrammar_by_url is disabled, the interpreter exposes the inline grammar directly in the MRCP request. The mimetypes defined in this parameter are used to verify the type attribute specified in the grammar element.

    Default value

    application/srgs+xml|.grxml|application/srgs|.srgs|Media-Type|.grammar|application/x-abnf|.abnf

    Takes effect At start/restart

    grammars.cache_size

    Grammars Cache Size

    The amount of memory to allocate for caching grammars. This is slightly more than 100 bytes per grammar.

    Valid values

    A number between 1 and 1000000 inclusive.

    Default value

    50000

    Takes effect At start/restart

    http.accept

    HTTP Acceptable MIME Types

    Specifies the acceptable mime types for fetched resources. If left to empty, it takes on a value of "*/*"

    Default value

    (blank)

    Takes effect At start/restart

    http.user_agent

    HTTP User Agent

    Specifies the HTTP user agent to use when fetching resources. If $VERSION$ is contained in the value, it will be replaced with the actual GVP product version info.

    Default value

    GVPi/$VERSION$

    Takes effect At start/restart

    http.version

    HTTP Version

    Specifies the http version to use when fetching resources. Specify 1.0 or 1.1. Default value is 1.1.

    Valid values

    • 1.0
    • 1.1

    Default value

    1.1

    Takes effect At start/restart

    initial_request_enctype

    Initial Request Encoding Type

    The HTTP encoding type to use for the initial request when the request method is POST

    Default value

    application/x-www-form-urlencoded

    Takes effect At start/restart

    initial_request_fetchtimeout

    Initial Request Fetch Timeout

    The fetch timeout (in ms) of the initial VXML document. If document fetch is not completed within this time, the fetch is considered to have failed and the call will be rejected. If value is set to 0, the parameter will be ignored and 60000 will be used instead.

    Valid values

    A number between 0 and 1000000 inclusive.

    Default value

    30000

    Takes effect At start/restart

    initial_request_maxage

    Initial Request Maxage

    Specifies the maximum age (in ms) of content that the VXML document is willing to use. -1 if undefined. The document is not willing to use stale content, unless initial_request_maxstale is defined. Note that since the initial page fetch always include the session id, it is nearly impossible to have this option be meaningful for the initial page. It is, however, meaningful for the initial root page.

    Valid values

    An integer greater or equal to -1

    Default value

    -1

    Takes effect At start/restart

    initial_request_maxstale

    Initial Request Maxstale

    Specifies the maximum amount of time (in ms) past content expiration that the VXML document is willing to accept. -1 if undefined.

    Valid values

    An integer between -1 and 1000000 inclusive.

    Default value

    -1

    Takes effect At start/restart

    initial_request_method

    Initial Request Method

    The HTTP method to use for the initial request

    Valid values

    • POST
    • GET

    Default value

    GET

    Takes effect At start/restart

    inlinegrammar_by_url

    Expose inline grammars with URL

    If this is enabled, NGI hosts inline grammars using the local web server and passes the grammar URL to the MRCP server. This allows NGI to share the same grammar URL among multiple recognitions to optimize loading of grammar. If this is disabled, NGI passes the inline grammar directly to the MRCP server in the MRCP request.

    Default value

    false

    Takes effect At start/restart

    jsruntime_size

    JavaScript Engine RunTime Size

    Specifies the size of each JavaScript Engine Runtime in MB.

    Default value

    1

    Takes effect At start/restart

    jsstack_size

    JavaScript Engine Stack Size

    Specifies the stack size of each JavaScript Engine context in byte.

    Default value

    16384

    Takes effect At start/restart

    legacy.simple_dtmf_grammars

    Support Legacy DTMF Grammars

    When set to true this parameter tells the interpreter to support certain inline legacy DTMF grammars that do not follow proper ABNF syntax.

    Default value

    false

    local.webserver.basepath_linux

    Local Webserver Base Path (Linux)

    This is the path on the local file system where the interpreter writes the inline grammar files, so that the onboard web server can expose the grammar as a URL to an offboard speech engine.

    Default value

    /var/www/gvp/mcp/$AppName$/grammar/inlinetmp/

    Takes effect At start/restart

    local.webserver.basepath_win

    Local Webserver Base Path (Windows)

    This is the path on the local file system where the interpreter writes the inline grammar files, so that the onboard web server can expose the grammar as a URL to an offboard speech engine.

    Default value

    c:/program files/common files/gcti/www/gvp/mcp/$AppName$/grammar/inlinetmp/

    Takes effect At start/restart

    local.webserver.baseurl

    Local Webserver Base URL

    This is the base URL to be used when exposing inline grammars as a URL to be fetched by an offboard speech engine.

    Default value

    http://$LocalIP$/mcp/$AppName$/grammar/inlinetmp/

    Takes effect At start/restart

    logdir

    Log Directory

    The directory for logs created from the log element with destination file.

    Default value

    $InstallationRoot$/logs/

    Takes effect At start/restart

    maintainer.email_subject

    Maintainer Email Subject

    The text to use as the subject for Maintainer Email messages.

    Default value

    Message from GVP to Application Maintainer

    Takes effect At start/restart

    maintainer.enabled

    Enable/Disable Maintainer Email

    If true, the maintainer email feature is enabled. Otherwise, it is disabled.

    Default value

    false

    Takes effect Immediately

    maintainer.log_message.on_error

    Maintainer Log Message on Error

    Controls whether the Interpreter will create a log message for the maintainer package automatically, when an error is thrown. A value of true means message is logged on errors. A value of false means no message is logged on errors.

    Default value

    true

    Takes effect At start/restart

    max_application_logfile_size

    Maximum Application Logfile Size

    The maximum size in bytes of an application log file which can be logged by using the log element with dest value set to file.

    Valid values

    A number between 0 and 2147483647 inclusive.

    Default value

    524288000

    Takes effect At start/restart

    max_loop_count

    Maximum Loop Count

    Maximum number of runtime loops is allowed between waiting states in an application execution. The runtime loop count will be increased when any form item, event handler and an iteration of the foreach element is executed. And the counter will be reset at a waiting state (e.g. waiting for user input, recording and transferring call).

    Valid values

    A number between 0 and 1000000 inclusive.

    Default value

    1000

    Takes effect At start/restart

    max_num_documents

    Maximum Cacheable Documents

    This parameter specifies the maximum number of cacheable documents

    Valid values

    A number between 1 and 1000000 inclusive.

    Default value

    5000

    Takes effect At start/restart

    max_num_sessions

    Maximum Concurrent Sessions

    The maximum number of permitted concurrent sessions

    Valid values

    A number between 1 and 1000000 inclusive.

    Default value

    10000

    Takes effect At start/restart

    max_runtime_error

    Maximum Runtime Error

    Maximum number of runtime application errors is allowed. The runtime error count will be increased when any application run time error is encountered.

    Valid values

    A number between 0 and 100000 inclusive.

    Default value

    1000

    Takes effect At start/restart

    max_script_time

    Maximum Script Time

    Maximum duration in millisecond is allowed for each script or ECMAScript expression execution.

    Valid values

    A number between 0 and 10000000 inclusive.

    Default value

    2000

    Takes effect At start/restart

    max_size.script_file

    Maximum Size of Script File

    Maximum Size allowed in bytes of the script file. If the limit is exceeded, it will result in a badfetch.

    Valid values

    A number between 1000 and 1000000000 inclusive. Or 0 to disable the limit.

    Default value

    0

    Takes effect At start/restart

    max_size.vxml_page

    Maximum Size of VXML Document

    Maximum Size allowed in bytes of the VXML Document. If the limit is exceeded, it will result in a badfetch.

    Valid values

    A number between 1000 and 1000000000 inclusive. Or 0 to disable the limit.

    Default value

    0

    Takes effect At start/restart

    max_size.xml_data

    Maximum Size of XML/JSON data

    Maximum Size allowed in bytes of the XML/JSON data. If the limit is exceeded, it will result in a badfetch.

    Valid values

    A number between 1000 and 1000000000 inclusive. Or 0 to disable the limit.

    Default value

    0

    Takes effect At start/restart

    max_subdialog_depth

    Maximum Subdialog depth

    Maximum depth of subdialogs allowed in a VXML session. The subdialog depth increments when a subdialog is entered, and the depth decrements when a subdialog is returned.

    Valid values

    A number between 1 and 1000 inclusive.

    Default value

    50

    Takes effect At start/restart

    messaging.enabled

    Enable external messaging within VoiceXML

    When set to true the send and receive tags function as normal. Otherwise, these tags are not permitted in VoiceXML pages.

    Default value

    true

    num_session_processing_threads

    Session Processing Threads

    The total number of VXML page execution threads to create.

    Valid values

    A number between 0 and 1000 inclusive.

    Default value

    8

    Takes effect At start/restart

    oem_namespace

    OEM Namespace

    This defines the XML-namespace the applications must use for the non-standard, extension features. Each extension XML attribute/element must be defined in this namespace.

    Default value

    http://www.genesyslab.com/2006/vxml21-extension http://www.voicegenie.com/2006/vxml21-extension

    Takes effect At start/restart

    recording.basepath

    Recording Base Path

    This parameter indicates the base path where the dest/destexpr/filename/filenameexpr attributes of record are based upon.

    Default value

    $InstallationRoot$/record

    Takes effect At start/restart

    recordutterance.path

    Recorded Utterance Path

    This parameter indicates the parent directory where all the recorded utterance files are saved, when the user has specified the sub-directory name using com.voicegenie.utterancedest or vg:utterancedest.

    Default value

    $InstallationRoot$/utterance

    Takes effect At start/restart

    savetmpfiles.max_bytes

    Maximum bytes of total saved temp files per session

    Maximum bytes allowed for the total saved temp files per session. If the limit is exceeded, savetmpfiles will be disabled for the applicable session.

    Valid values

    A number between 0 and 2000000000 inclusive.

    Default value

    100000000

    Takes effect At start/restart

    script_max_loop

    Maximum Loops in Script

    Maximum number of loops is allowed in each script or ECMAScript expression execution. The loop counter will be increased by 1 when a script branches backward during execution and when a function returns.

    Valid values

    A number between 0 and 10000000 inclusive.

    Default value

    1000000

    Takes effect At start/restart

    tmpdir

    Temp Directory

    Temp directory that exists on the platform

    Default value

    $InstallationRoot$/tmp/

    Takes effect At start/restart

    transfer.allowed

    Transfer Allowed

    Indicates whether transfers should be permitted

    Default value

    true

    Takes effect At start/restart

    tts.defaultengine

    TTS Engine Default

    The engine specified here will be used as the default TTS engine. An application using a different name should override this using the Request URI configuration or the ttsengine property.

    Valid values

    The engine name must be a string.

    Default value

    default

    Takes effect Immediately

    universals.cancel

    Universal Cancel Grammar

    This parameter specifies the universal cancel grammar used by the platform

    Valid values

    A location or URL of the universal cancel grammar.

    Default value

    builtin:grammar/universals/Cancel

    Takes effect At start/restart

    universals.exit

    Universal Exit Grammar

    This parameter specifies the universal exit grammar used by the platform

    Valid values

    A location or URL of the universal exit grammar.

    Default value

    builtin:grammar/universals/Exit

    Takes effect At start/restart

    universals.help

    Universal Help Grammar

    This parameter specifies the universal help grammar used by the platform

    Valid values

    A location or URL of the universal help grammar.

    Default value

    builtin:grammar/universals/Help

    Takes effect At start/restart

    universals_path_linux

    Universal Grammar File Path (Linux)

    The path on the local file system where the universal grammar files are stored.

    Default value

    /var/www/gvp/mcp/$AppName$/grammar/common/hotkey/

    Takes effect At start/restart

    universals_path_win

    Universal Grammar File Path (Windows)

    The path on the local file system where the universal grammar files are stored.

    Default value

    c:/program files/common files/gcti/www/gvp/mcp/$AppName$/grammar/common/hotkey/

    Takes effect At start/restart

    use_isdn_mapping

    Use ISDN Mapping

    This parameter controls whether the disconnected return status of the outbound leg should be derived from ISDN code or internal disconnect reason.

    Valid values

    • 0
    • 1

    Default value

    0

    Takes effect At start/restart

    userdata.convert_name_to_lowercase

    Convert userdata name to lowercase

    Whether or not to convert the userdata name to lower case.

    Default value

    false

    Takes effect At start/restart

    userdata.prefix

    Userdata Prefix

    This is a string that, when used as a prefix in a SIP header, identifies userdata variables.

    Default value

    X-Genesys-

    Takes effect At start/restart