[asr]

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. The default value is 250.

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

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

[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.

[conference]

Conferencing Configuration Parameters

audio_format

Conference Audio Format

Conference Audio Format.

Valid values

  • pcmu
  • pcma
  • g726-16
  • g726-24
  • g726-32
  • g726-40
  • l16
  • gsm

Default value

pcmu

Takes effect At start/restart

confdir

Default Conference Direction

Default conference direction of the participant.

Valid values

  • 0
  • 1
  • 2

Default value

2

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

0

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

limit

Conference Participant Limit

Max number of participants allowed for the conference initiated by conferencing app.

Valid values

A valid value is an integer from 2 to 32 inclusive.

Default value

32

Takes effect At start/restart

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

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.

Valid values

  • fixed
  • loudest
  • none

Default value

loudest

Takes effect At start/restart

[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 MF sink. 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-15,41,52-55,74,136-141

Takes effect At start/restart

dc.trace_flag

Trace Flag (Data Collection Sink)

Flag specifying whether debug level logging is enabled for the Data Collection Sink. When enabled (flag is set to TRUE), debug level logs will be processed and filtered like other log levels. When the flag is set to FALSE, debug level log messages will never be processed.

Valid values

  • FALSE
  • TRUE
TRUE or FALSE

Default value

FALSE

Takes effect immediately

log_sinks

Log Sinks

List of one more pipe-delimited identifiers for log sinks that should be loaded upon initialization of the GVP Logging Service.

Valid values

DATAC, MFSINK or TRAPSINK

Default value

DATAC|MFSINK|TRAPSINK

Takes effect At start/restart

logconfig.DATAC

Data Collection 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

0-2|*|*

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

0-3,5|*|*

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 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

*

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-15,19-41,43,52-56,72-74,76-81,127,129,130,132-141

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 messages queued up by the reporting client before sending them up to the reporting server. A higher batch size (e.g. 50 records) will lessen bandwidth constraints, at the cost of making sending data at larger intervals.

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) will lessen bandwidth constraints, at the cost of making sending CDR data at larger intervals.

Valid values

An integer between 1-5000 inclusive.

Default value

500

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

$InstallationRoot$\config\cdrQueue.db

Takes effect At start/restart

rc.cdr.msg_broker_uri

Reporting Server Message Broker for CDR

The URI for the Reporting Server's JMS Message Broker (CDR)

Valid values

A URI

Default value

tcp://$ReportingServerHostname$:61616

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

$InstallationRoot$\config\reportingClientQueue.db

Takes effect At start/restart

rc.msg_broker_uri

Reporting Server Message Broker for Upstream Logging

The URI for the Reporting Server's JMS Message Broker

Valid values

A URI

Default value

tcp://$ReportingServerHostname$:61616

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

$InstallationRoot$\config\cdrQueue.db

Takes effect At start/restart

rc.ors.msg_broker_uri

Reporting Server Message Broker for Operational Reporting

The URI for the Reporting Server's JMS Message Broker (OR)

Valid values

A URI

Default value

tcp://$ReportingServerHostname$:61616

Takes effect At start/restart

trace_flag

Trace Flag

Flag specifying whether debug level logging is enabled. When enabled (flag is set to TRUE), debug level logs will be processed and filtered like other log levels. When the flag is set to FALSE, debug level log messages will never be processed.

Valid values

  • FALSE
  • TRUE
TRUE or FALSE

Default value

FALSE

Takes effect immediately

trapsink.initfile

SNMP Trap EMS to MF Mapping

Specifies the full path of the EMS MF mapping file, which maps EMS log IDs to MF counterparts.

Default value

$InstallationRoot$\config\MCP_EMStoMFIDs.txt

Takes effect At start/restart

trapsink.trapfilterfile

SNMP Trap Filter

Specifies the full path of the trap filter file, which maps MF ids to SNMP traps.

Default value

$InstallationRoot$\config\MCP_trapfilter.txt

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 T-Server 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

    false

    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

    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

    time

    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 3267). 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 controls the AMR modes enabled for the payload. For example, setting "mode-set=0,1" enables modes 0 and 1. If mode-set is not set, all modes are enabled. Setting "mode-set=*" is a special value which will match any set of modes offered by the remote end.

    For example, setting this parameter to "octet-align=1; mode-set=*" enables one payload type with octet aligned mode enabled and any mode allowed, and setting it to "octet-align=0; mode-set=*|octet-align=1; mode-set=*" 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 enabled 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; mode-set=*| octet-align=1; mode-set=*

    Takes effect At start/restart

    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

    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

    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

    asr.codec

    ASR Codec

    Specifies the ASR codec to be used.

    Valid values

    • pcmu
    • pcma
    • g726
    • g729
    • gsm
    • amr
    • tfci

    Default value

    pcmu

    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
    • g726
    • g729
    • gsm
    • amr
    • tfci
    • h263
    • h263-1998
    • telephone-event

    Default value

    pcmu pcma g726 gsm h263 h263-1998 telephone-event

    Takes effect immediately

    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

    controlthreadlevel

    Control Thread Level

    Specifies the thread priority level for the MPC Control thread.

    Valid values

    • NORMAL
    • ABOVE_NORMAL
    • HIGHEST
    • TIME_CRITICAL

    Default value

    NORMAL

    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

    Specifies whether to output transcoded data in little endian order.

    Valid values

    • 0
    • 1

    Default value

    0

    Takes effect immediately

    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.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. Must be greater than or equal to 40ms.

    Valid values

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

    Default value

    40

    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.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
    all-digits: Record all DTMF digits, including inband, and generate audio for RFC2833 digits

    Default value

    as-is

    Takes effect immediately

    fcr.gain

    FCR Gain

    Gain on FCR input in dB from call participants (-30 to 30)

    Valid values

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

    Default value

    0

    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

    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

    localrtpaddr

    Local RTP Address

    mpc.localrtpaddr provides configurability of the connection part 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

    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.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). Default value is 256000. It is recommended the size reflect the resolution of video.

    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

    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

    mixer.maxsilencethreshold

    Maximum Mixer Silence Threshold

    Specifies the max silence threshold. Default value is 32.

    Valid values

    mpc.mixer.maxsilencethreshold must be a non-negative integer and less than or equal to 32

    Default value

    32

    Takes effect At start/restart

    mixer.minsilencethreshold

    Minimum Mixer Silence Threshold

    Specifies the min silence threshold. Default value is 6.

    Valid values

    mpc.mixer.minsilencethreshold must be a non-negative integer and less than or equal to 32

    Default value

    6

    Takes effect At start/restart

    mixer.minvideoswitchtime

    Minimum Switch Time

    Specifies the minimum amount of the time (in ms) that mixer video output is allowed to switch between different video input sources. Default value is 5000.

    Valid values

    mpc.mixer.minvideoswitchtime must be a non-negative 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

    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 the maximum integer as defined by the Genesys Administrator Help.

    Default value

    160

    Takes effect At start/restart

    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

    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 RTP Audio Buffer in bytes. Default value is 20000.

    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

    20000

    Takes effect At start/restart

    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

    rtp.enablertcp

    Enable RTCP

    Specifies whether to transmit RTCP packets.

    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.maxrtppacketsize

    Maximum RTP Packet Size

    Specifies the maximum size of RTP packet in bytes. Default value is 20000.

    Valid values

    mpc.rtp.maxrtppacketsize 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

    20000

    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.porthigh

    RTP Port High

    Specifies the highest RTP/RTCP port to be used by MPC. Default value is 65535.

    Valid values

    Possible values are integers from 1030 to 65535 inclusive

    Default value

    65535

    Takes effect At start/restart

    rtp.portlow

    RTP Port Low

    Specifies the lowest RTP/RTCP port to be used by MPC. Default value is 10000.

    Valid values

    Possible values are integers from 1030 to 65535 inclusive

    Default value

    10000

    Takes effect At start/restart

    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. Any RFC2429 packet that exceeds the limit will be broken down into smaller packets. This parameter is used to prevent the OS from breaking down large RTP packets into multiple UDP packets, which may not be supported by some devices. Default value is 1472 - Linux will break down RTP packets greater than 1472 bytes into multiple UDP packets. Set to 0 to disable the limit.

    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

    1472

    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. 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.udpbuffersize

    Size of the receive buffer for RTP UDP sockets

    Specifies the size of the receive buffer for RTP UDP sockets in bytes. Default value is 30240. 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

    30240

    Takes effect At start/restart

    rtp.videobuffersize

    RTP Audio Buffer Size

    Specifies the size of RTP Video Buffer in bytes. Default value is 120000.

    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

    120000

    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
    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

    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_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

    transcoders

    Transcoders

    Specifies the list of transcoders to be used by MPC. PCM, GSM and G726 transcoders are loaded by default. Set to "none" in order to disable all transcoders.

    Valid values

    • PCM
    • GSM
    • G726
    • G729
    • AMR
    • none

    Default value

    PCM GSM G726

    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

    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
    • g726
    • g729
    • gsm
    • amr
    • tfci

    Default value

    pcmu pcma

    Takes effect immediately

    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

    [mrcpv2client]

    [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

    jitter_log

    MTInternal Jitter Log

    Defines the logging period in terms of number of received packets. If less than 1, Jitter logging is turned off. Jitter logging will be disabled if variable frame size codec is used for received packets.

    Valid values

    mtinternal.jitter_log 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

    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_max_port

    MTInternal max port

    The maximum port range for RTP sockets in MTInternal

    Valid values

    The maximum port must be an integer from 1030 to 65535 inclusive

    Default value

    30000

    Takes effect At start/restart

    rtp_min_port

    MTInternal min port

    The minimum port range for RTP sockets in MTInternal

    Valid values

    The minimum port must be an integer from 1030 to 65535 inclusive

    Default value

    20000

    Takes effect At start/restart

    transmit_interval

    MTInternal Transmit Interval

    Defines a constant transmission interval in milliseconds. If set to 0, packets will be sent as soon as data arrives.

    Valid values

    The transmission interval 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

    20

    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

    When mtinternal.transmit_interval is non-zero, this parameter specifies the maximum number of packets to be sent for each transmission interval. Set to 0 to turn off this restriction.

    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

    5

    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

    [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 1025 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. RAW is for Windows. NORMAL is for linux and Solaris.

    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 20000 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

    20000

    Takes effect At start/restart

    alert_before_fetch

    Alert Before Fetch

    Issues alerting message to phone network before the page is successfully fetched.

    Valid values

    • 0
    • 1

    Default value

    0

    Takes effect At start/restart

    Conference.Conference

    Conference AppModule Instance Name

    Name of Conference Instance

    Valid values

    A valid name can only contain characters and numerics.

    Default value

    Conference

    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/helloaudio.vxml

    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

    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

    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

    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

    confserver

    Conferencing Server

    Address of the GVP conferencing server. If a GVP conferencing server is deployed in the network, the address of that server is configured through this parameter. Either the IP address or hostname of the conferencing server may be specified. If the conferencing server uses a non-default SIP port (other than 5060), it must be specified using ":port" following the IP address/hostname. If this parameter is not specified, no conference server will be configured. sip.confserver=sipconf.genesyslab.com:5020

    Valid values

    A valid address can only contain alphanumeric characters, '.', '-', ':', ' ','/' and '\' characters

    Default value

    (blank)

    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

    defaultblindxfer

    Default Blind Transfer

    SIP Transfer Methods for blind transfer

    Valid values

    • HKF
    • REFER
    • BRIDGE
    • REFERJOIN
    • MEDIAREDIRECT

    Default value

    REFER

    Takes effect At start/restart

    defaultbridgexfer

    Default Bridge Transfer

    Default bridge type transfer method for sip

    Valid values

    • BRIDGE
    • MEDIAREDIRECT

    Default value

    BRIDGE

    Takes effect At start/restart

    defaultconsultxfer

    Default Consultation Transfer

    Default consult type transfer method for sip.

    Valid values

    • HKF
    • BRIDGE
    • REFERJOIN
    • MEDIAREDIRECT

    Default value

    REFERJOIN

    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

    enablesendrecvevents

    Enable Send / Receive Events

    Enabled the receiving and sending of SIP INFO messages for VoiceXML application usage. SIP INFO for other purposes (ie, DTMF) will not be affected.

    Valid values

    • false
    • true

    Default value

    true

    Takes effect immediately

    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 <transfer> sip.hfprefix=! would dial a hookflash, and then the pattern in <transfer> 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.&lt;headername&gt;=&lt;value&gt; 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.&lt;headername&gt;=&lt;value&gt; 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.&lt;headername&gt;=&lt;value&gt; 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.&lt;headername&gt;.&lt;paramname&gt;=&lt;value&gt; 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 <log> application events. A VoiceXML application can trigger the sending of a SIP INFO message by using <log> tag with dest="callmgr". The MCP will then send a SIP INFO message to the remote end with content being the content of the <log> tag. The default content type is "application/text".

    Valid values

    Any character is allowed

    Default value

    application/text

    Takes effect At start/restart

    localhostname

    Local Hostname

    sip.localhostname provides configurability of the host address part of Contact, Call-ID and From headers.
    If this parameter is not specified, then the IP Address of the local system will be used.
    If this value is not defined, sip.localport will be ignored.
    This parameter can also be used to provide the fully qualified domain name in SIP requests.

    Example:
    sip.localhostname=sip.genesyslab.com

    Valid values

    A valid local host name can only contain alphanumeric characters, '.', '-', ':', ' ','/' and '\' characters

    Default value

    (blank)

    Takes effect At start/restart

    localport

    Local Port

    Similar to sip.localhostname, the parameter sip.localport provides configurability of the port part of Contact, Call-ID and From Headers.
    If this parameter is not specified, the default SIP port number of 5060 is used.
    Note that if sip.localhostname is not defined, sip.localport will be ignored.

    Valid values

    The port number must be an integer from 1030 to 65535 inclusive

    Default value

    5070

    Takes effect At start/restart

    localsecureport

    Local Secure Port

    Similar to sip.localhostname, the parameter sip.localsecureport provides configurability of the port part of Contact, Call-ID and From Headers when SIPS is used.
    If this parameter is not specified, the default SIPS port number of 5061 is used.
    Note that if sip.localhostname is not defined, sip.localsecureport will be ignored.

    Valid values

    The port number must be an integer from 1025 to 65535 inclusive

    Default value

    5071

    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

    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

    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

    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.&lt;headername&gt;=&lt;value&gt; 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.&lt;headername&gt;=&lt;value&gt; 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.&lt;headername&gt;.&lt;paramname&gt;=&lt;value&gt; 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.&lt;headername&gt;=&lt;value&gt; 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.&lt;headername&gt;.&lt;paramname&gt;=&lt;value&gt; 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

    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

    1

    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: &lt;registration-server&gt; &lt;register-as&gt; &lt;requested-expiry&gt; &lt;username&gt; &lt;passowrd&gt; &lt;routeset&gt; All parameters except routeset are compulsory.

    &lt;registration-server&gt; - 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.

    &lt;register-as&gt; - SIP identity to register as. sip: or sips: can be prefixed to indicate which protocol to use. sip: will be used by default.

    &lt;requested-expiry&gt; - Duration of registration; system will re-register after registration expires

    &lt;username&gt; - 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.

    &lt;password&gt; - The password associated with the authentication user name. To specify an empty string please use the dash - character.

    &lt;routeset&gt; - 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 = &lt;sip:ip/host;priority&gt;, ... e.g. sip.routeset=&lt;sip:p1.example.com;lr&gt;,&lt;sip:p2.domain.com;lr&gt;

    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.

    Valid values

    A valid routeset must have the format as specify in its description

    Default value

    (blank)

    Takes effect At start/restart

    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 = &lt;sips:ip/host;priority&gt;, ... e.g. sip.securerouteset=&lt;sips:p1.example.com;lr&gt;,&lt;sips:p2.domain.com;lr&gt;

    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.

    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.

    Valid values

    • 0
    • 1
    • 2

    Default value

    1

    Takes effect immediately

    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

    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

    transfermethods

    Transfer Methods

    Transfer Methods for sip. The final option will be ignored if selected with other options.

    Valid values

    • HKF
    • REFER
    • REFERJOIN
    • MEDIAREDIRECT
    • none

    Default value

    REFER REFERJOIN MEDIAREDIRECT

    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.

    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.

    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.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; 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.

    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.

    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.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; 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.

    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.

    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.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.

    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.

    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

    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.

    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.

    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

    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.

    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.

    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

    usenullsdp

    Use Null SDP

    When an INVITE/REINVITE without SDP information need to be sent, this parameter specifies whether NULL SDP is used.

    Valid values

    • 0
    • 1

    Default value

    0

    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.<URL>@host.com". The <URL> 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

    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

    [snmp]

    SNMP settings.

    timeout

    SNMP Task Timeout

    The maximum amount of time that SNMP can wait for a new task. This value is specified in milliseconds.

    Valid values

    The parameter must be an integer value greater than zero.

    Default value

    100

    Takes effect At start/restart

    [stack]

    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

    socket.onesend

    Send Message In One Request

    TRUE indicates that a complete TCP message will be sent in one send request.

    Valid values

    • true
    • false

    Default value

    true

    trace.debug

    Enable MRCP Stack Debug Trace

    Whether to enable the stack debug message

    Valid values

    • true
    • false

    Default value

    true

    [vrm]

    client.dll

    SRM Client DLL

    Path to the DLL library that contains SRM Client. If the library cannot be loaded, ASR/TTS will not be available.

    Default value

    $installationRoot$/bin/libmrcpstack.dll

    client.grammar.path

    Hotkey Grammar Files Location

    This specifies the location of the builtin grammars residing on the MCP.

    Default value

    $installationRoot$/grammar/

    client.logmetrics

    Collect Log Metrics

    This enables collection of MRCP message timing data.

    Valid values

    • true
    • false

    Default value

    true

    client.max.noinput.timeout

    No-Input Timeout

    This sets the value, in milliseconds, for the noinput timeout header that we should send to an MRCP engine. We should set this to a large value, because the MCP handles the no input timer. Default value is 90 seconds.

    Default value

    30000

    client.modules

    SRM Client Modules

    This parameter lists the SRM MRCP client protocol modules installed in the platform.

    Valid values

    • MRCPV1
    • MRCPV2
    • MRCPV1 MRCPV2

    Default value

    MRCPV1 MRCPV2

    client.MRCPV1.dll

    MRCPv1 Client DLL

    Path to the DLL library that contains SRM MRCPv1 Client. If the library cannot be loaded, MRCPv1 ASR/TTS will not be available.

    Default value

    $installationRoot$/bin/libmrcpv1stack.dll

    client.MRCPV2.dll

    MRCPv2 Client DLL

    Path to the DLL library that contains SRM MRCPv2 Client. If the library cannot be loaded, MRCPv2 ASR/TTS will not be available.

    Default value

    $installationRoot$/bin/libmrcpv2stack.dll

    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.maxopensocket

    MRCPv2 Max Open Sockets

    The parameter specifies the maximum allowed sockets opened for MRCPv2 sessions.

    Default value

    256

    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.ping.disable

    SRM Disable Ping

    Set value of this parameter to true will disable ping to all MRCPv2 servers.

    Valid values

    • true
    • false

    Default value

    false

    client.ping.frequency

    SRM Ping Frequency

    Ping interval in milliseconds. This will also be used to check the availability of a disconnected server every specified milliseconds.

    Default value

    30000

    client.ping.timeout

    SRM Ping Timeout

    Minimum milliseconds before ping response can be returned and the server is determined alive.

    Default value

    60000

    client.timeout

    SRM Default Response Timeout

    Timeout value to wait for response. The value must be integer values in milliseconds.

    Default value

    10000

    client.tmp.path

    Temporary Directory

    This specifies the location of the temporary directory used by the media platform. This must match the PW_TMP entry in the voicexml.cfg file used by the interpreter.

    Default value

    $installationRoot$/tmp/

    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

    client.vggrammarbase

    MCP Generated Grammar Files Location

    This gives base HTTP URL base path to the place where call manager will place grammar files. The default value should be set to: client.vggrammarbase = /vggrammarbase/tmp/

    Default value

    /vggrammarbase/tmp/

    [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

    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

    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\effects\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\audio_mulaw

    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_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.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

    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 Port

    The port that the platform will accept socket connections from the debugging client.

    Valid values

    An integer between 1025 and 65535 inclusive.

    Default value

    27666

    Takes effect At start/restart

    debug.server.port.public

    Debugger Server Public Port

    The 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

    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.

    Default value

    true

    Takes effect At start/restart

    grammar.builtin:dtmf/currency

    Built-in Currency Grammar Path

    Builtin currency grammar path.

    Default value

    http://$LocalIP$/vggrammarbase/dtmf/currency.grxml

    Takes effect At start/restart

    grammar.builtin:dtmf/date

    Built-in Date Grammar Path

    Builtin date grammar path.

    Default value

    http://$LocalIP$/vggrammarbase/dtmf/date.grxml

    Takes effect At start/restart

    grammar.builtin:dtmf/number

    Built-in Number Grammar Path

    Builtin number grammar path.

    Default value

    http://$LocalIP$/vggrammarbase/dtmf/number.grxml

    Takes effect At start/restart

    grammar.builtin:dtmf/phone

    Built-in Phone Grammar Path

    Builtin phone grammar path.

    Default value

    http://$LocalIP$/vggrammarbase/dtmf/phone.grxml

    Takes effect At start/restart

    grammar.builtin:dtmf/time

    Built-in Time Grammar Path

    Builtin time grammar path.

    Default value

    http://$LocalIP$/vggrammarbase/dtmf/time.grxml

    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. Leave empty to defer to the Fetching Module's configuration.

    Default value

    (blank)

    Takes effect At start/restart

    http.user_agent

    HTTP User Agent

    Specifies the HTTP user agent to use when fetching resources

    Default value

    GVPi

    Takes effect At start/restart

    http.version

    HTTP Version

    Specifies the http version to use when fetching resources. Specify 1.0 or 1.1. Leave empty to defer to the Fetching Module's configuration.

    Default value

    (blank)

    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

    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

    Local Webserver Base Path

    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

    $InstallationRoot$\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$/vggrammarbase/inlinetmp/

    Takes effect At start/restart

    local.webserver.mimetypes

    Local Webserver MIME Types

    The interpreter exposes inline grammars as external grammars for an offboard speech engines as a URL reference, by a locally configured web server. This parameters 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.

    Default value

    application/srgs+xml|.grxml|application/srgs|.srgs|Media-Type|.grammar|application/x-abnf|.abnf

    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 8.0 to Application Maintainer

    Takes effect At start/restart

    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

    2000

    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_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

    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.recovery.directory

    Recording Recovery Directory

    This parameter indicates the directory path in which to store .recovery files for recordings.

    Default value

    (blank)

    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

    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

    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

    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. 0: uses internal disconnect reason
    1: uses ISDN code

    Valid values

    • 0
    • 1

    Default value

    0

    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