Commenting Disabled on Discussion Pages

Commenting is temporarily disabled on the Discussion pages. If you have comments or questions about documentation information on a product page on this site, please contact Genesys Technical Publications at Techpubs.webadmin@genesys.com.

TServer IVR Configuration Options

From Genesys Documentation

Jump to: navigation, search

The following options can be used to configure TServer_IVR applications in Genesys Administrator.


agent-reservation

reject-subsequent-request (reject-subsequent-request)
Description Valid values Default value Takes effect
Specifies whether T-Server rejects subsequent requests from the same client application, for an agent reservation for the same Agent object that is currently reserved.
  • true — T-Server rejects subsequent requests.
  • false — A subsequent request prolongs the current reservation made by the same client application for the same agent.

<p>Note: Genesys does not recommend setting this option to false in a multi-site environment in which remote locations use the Agent-Reservation feature.</p>

true immediately
request-collection-time (request-collection-time)
Description Valid values Default value Takes effect
Specifies the interval that agent reservation requests are collected before a reservation is granted. During this interval, agent reservation requests are delayed, in order to balance successful reservations between client applications (for example, Universal Routing Servers). 100 msec immediately
reservation-time (reservation-time)
Description Valid values Default value Takes effect
Specifies the default interval that an AgentDN is reserved to receive a routed call from a remote T-Server. During this interval, the agent cannot be reserved again 10000 msec immediately

backup-sync

addp-remote-timeout (addp-remote-timeout)
Description Valid values Default value Takes effect
Specifies the time interval in seconds that the redundant T-Server waits for a response from this T-Server after sending a polling signal. The default value of 0 (zero) disables the functionality of this option. To establish an appropriate timeout, specify a value other than the default. This option applies only if the protocol option is set to addp. 0-3600 0 immediately
addp-timeout (addp-timeout)
Description Valid values Default value Takes effect
Specifies the time interval in seconds that this T-Server waits for a response from another T-Server after sending a polling signal. The default value of 0 (zero) disables the functionality of this option. To establish an appropriate timeout, specify a value other than the default. This option applies only if the protocol option is set to addp 0-3600 0 immediately
addp-trace (addp-trace)
Description Valid values Default value Takes effect
Specifies whether the option is active, and to which side(s) the trace is performed. This option applies only if the protocol option is set to addp. off,local,remote,both off immediately
network-provided-address (network-provided-address)
Description Valid values Default value Takes effect
Specifies how T-Server reports to its clients the host information about its backup T-Server.
  • false — T-Server reports the backup host information as configured in the Configuration Layer.
  • true — T-Server reports the backup host information as supplied by the network.
false immediately
protocol (protocol)
Description Valid values Default value Takes effect
Specifies the name of the method used to detect connection failures. If you specify the addp value, you must also specify a value for the addp-timeout, addp-remote-timeout, and addp-trace options.

default The feature is not active. addp Activates the Advanced Disconnect Detection Protocol.

default,addp default When the next connection is established
sync-reconnect-tout (sync-reconnect-tout)
Description Valid values Default value Takes effect
Specifies the time interval after which the backup T-Server attempts to reconnect to the primary server (for a synchronized link). 20 sec immediately

call-cleanup

cleanup-idle-tout (cleanup-idle-tout)
Description Valid values Default value Takes effect
Specifies the time interval that T-Server waits for a call to be updated from its last update. After this time elapses, if no new events about the call are received, T-Server clears this call as a stuck call, either by querying the switch (if a CTI link provides such capabilities) or by deleting the call information from memory unconditionally. The default value of 0 disables the stuck calls cleanup. 0 immediately
notify-idle-tout (notify-idle-tout)
Description Valid values Default value Takes effect
Specifies the time interval that T-Server waits for a call to be updated from its last update. After this time elapses, if no new events about the call are received, T-Server reports this call as a stuck call. The default value of 0 disables the stuck calls notification. 0 immediately
periodic-check-tout (periodic-check-tout)
Description Valid values Default value Takes effect

Specifies the time interval for periodic checks for stuck calls. These checks affect both notification and cleanup functionality, and are made by checking the T-Server's own call information with call information available in the switch. For performance reasons, T-Server does not verify whether the notify-idle-tout or cleanup-idle-tout option has expired before performing this checking.

Note: Setting this option to a value of less than a few seconds can affect T-Server performance.
Example 1
notify-idle-tout = 0
cleanup-idle-tout = 0
periodic-check-tout = 10
With these settings, T-Server will not perform any checks for stuck calls.
Example 2
notify-idle-tout = 5 min
cleanup-idle-tout = 0
periodic-check-tout = 10 min
With these settings, T-Server performs checks every 10 minutes and sends notifications about
all calls that have been idle for at least 5 minutes.
Example 3
notify-idle-tout = 5 min
cleanup-idle-tout = 20 min
periodic-check-tout = 10 min
With these settings, T-Server performs checks every 10 minutes, sends notifications about
all calls that have been idle for at least 5 minutes, and attempts to clean up all calls that 
have been idle for more than 20 minutes.


10 min immediately

CallIdSap

input-network-call-id-key (input-network-call-id-key)
Description Valid values Default value Takes effect
Specifies the property map element where the call ID for inbound messages is

stored.

XML.Message.GctiMsg.CallId.Val XML.Message.GctiMsg.CallId.Val After TServer_IVR is restarted

extrouter

cast-type (cast-type)
Description Valid values Default value Takes effect

Specifies --using a space-, comma- or semicolon-separated list --the routing types that can be performed for this T-Server. The valid values provide for a range of mechanisms that the ISCC feature can support with various T-Servers, in order to pass call data along with calls between locations. Because switches of different types provide calls with different sets of information parameters, some values might not work with your T-Server. See "T-Server Support of Transaction Types" for information about supported transaction types by a specific T-Server. The "Multi-Site Support" chapter also provides detailed descriptions of all transaction types.

Notes: For compatibility with the previous T-Server releases, you can use the direct value for this option. This is an alias for direct-callid. An alias, route-notoken, has been added to the route value. </p>

route, route-uui, reroute, direct-callid, direct-uui, direct-network-callid, direct-notoken, direct-digits, direct-ani, dnis-pool, pullback route direct-callid reroute direct-uui direct-ani direct-notoken dnis-pool direct-digits pullback route-uui direct-network-callid For the next request for the remote service
cof-ci-defer-create (cof-ci-defer-create)
Description Valid values Default value Takes effect
Specifies the time interval that T-Server waits for call data from the switch before generating a negative response for a call data request from a remote T-Server. If T-Server detects the matching call before this timeout expires, it sends the requested data. 0 immediately
cof-ci-defer-delete (cof-ci-defer-delete)
Description Valid values Default value Takes effect
Specifies the time interval that T-Server waits before deleting call data that might be overflowed. If set to 0, deletion deferring is disabled. 0 immediately
cof-ci-req-tout (cof-ci-req-tout)
Description Valid values Default value Takes effect
Specifies the time interval during which T-Server will wait for call data requested with respect to a call originated at another site. After T-Server sends the call data request to remote T-Servers, all events related to this call will be suspended until either the requested call data is received or the specified timeout expires. 500 msec For the next COF operation
cof-ci-wait-all (cof-ci-wait-all)
Description Valid values Default value Takes effect

Specifies whether T-Server, after sending a request for matching call data, waits for responses from other T-Servers before updating the call data (such as CallHistory, ConnID, and UserData) for a potentially overflowed call. The waiting period is specified by the cof-ci-req-tout and cof-rci-tout options.


  • true — T-Server waits for responses from all T-Servers that might have the requested call data before updating the call data with the latest information.
  • false — T-Server updates the call data with the information received from the first positive response.
false immediately
cof-feature (cof-feature)
Description Valid values Default value Takes effect
Enables or disables the Inter Server Call Control/Call Overflow (ISCC/COF) feature. true,false false immediately
cof-rci-tout (cof-rci-tout)
Description Valid values Default value Takes effect
Specifies the time interval that T-Server waits for call data from other T-Server's transactions. Counting starts when cof-ci-req-tout expires. 10 sec For the next COF operation
default-dn (default-dn)
Description Valid values Default value Takes effect
Specifies the DN to which a call is routed when a Destination DN (AttributeOtherDN) is not specified 
in the client's request for routing. 
If neither this option nor the client's request contains the destination DN,
the client receives EventError.
Note: This option is used only for requests with route types route, route-uui, direct-callid,
direct-network-callid, direct-uui, direct-notoken, direct-digits, and direct-ani.
Any DN (blank) For the next request for the remote service
direct-digits-key (direct-digits-key)
Description Valid values Default value Takes effect
Specifies the name of a key from the UserData attribute that contains a string of digits 
that are used as matching criteria for remote service requests with the direct-digits routing type.
Note: For compatibility with the previous T-Server releases, this configuration option
has an alias value of cdt-udata-key.
Any valid key name of a key-value pair from the UserData attribute CDT_Track_Num For the next request for the remote service
dn-for-unexpected-calls (dn-for-unexpected-calls)
Description Valid values Default value Takes effect
Specifies a default DN for unexpected calls arriving on an External Routing Point. Any DN (blank) immediately
event-propagation (event-propagation)
Description Valid values Default value Takes effect

Specifies whether the Event Propagation feature is enabled.


  • list — Changes in user data and party events are propagated to remote locations through call distribution topology.
  • off — The feature is disabled. Changes in user data and party events are not propagated to remote locations.
list immediately
match-call-once (match-call-once)
Description Valid values Default value Takes effect

Specifies how ISCC processes an inbound call that has already been processed.


  • true — ISCC does not process (match) an inbound call that has already been processed (matched).
  • false — ISCC processes (matches) a call as many times as it arrives at an ISCC resource or multi-site-transfer target.
true immediately
network-request-timeout (network-request-timeout)
Description Valid values Default value Takes effect
For a premise T-Server, this option specifies the time interval that the premise

T-Server waits for a response, after relaying a TNetwork(...) request to the Network T-Server. For a Network T-Server, this option specifies the time interval that the Network T-Server waits for a response from an SCP (Service Control Point), after initiating the processing of the request by the SCP. When the allowed time expires, the T-Server cancels further processing of the request and generates EventError.


20 sec For the next request for remote service
reconnect-tout (reconnect-tout)
Description Valid values Default value Takes effect
Specifies the time interval after which a remote T-Server attempts to connect to this T-Server after an unsuccessful attempt or a lost connection. The number of attempts is unlimited. At startup, T-Server immediately attempts the first connection, without this timeout. 5 sec At the next reconnection attempt
register-attempts (register-attempts)
Description Valid values Default value Takes effect
Specifies the number of attempts that T-Server makes to register a dedicated External Routing Point. 5 For the next registration
register-tout (register-tout)
Description Valid values Default value Takes effect
Specifies the time interval after which T-Server attempts to register a dedicated External Routing Point. Counting starts when the attempt to register a Routing Point fails. 2 sec For the next registration
report-connid-changes (report-connid-changes)
Description Valid values Default value Takes effect
Specifies whether the destination T-Server generates EventPartyChanged for the incoming call when the resulting ConnID attribute is different from the ConnID attribute of an instance of the same call at the origination location. true,false false immediately
request-tout (request-tout)
Description Valid values Default value Takes effect

Specifies the time interval that a T-Server at the origination location waits for a notification of routing service availability from the destination location. Counting starts when the T-Server sends a request for remote service to the destination site.


20 sec For the next request for remote service
resource-allocation-mode (resource-allocation-mode)
Description Valid values Default value Takes effect

Specifies the manner in which T-Server allocates resources (that is, DNs of the External Routing Point type and Access Resources with Resource Type dnis) for multi-site transaction requests.


  • home — T-Server takes an alphabetized (or numerically sequential) list of configured DNs and reserves the first available DN from the top of the list for each new request. For example, if the first DN is not available, the second DN is allocated for a new request. If the first DN is freed by the time the next request comes, the first DN is allocated for this next request.
  • circular — T-Server takes the same list of configured DNs, but reserves a subsequent DN for each subsequent request. For example, when the first request comes, T-Server allocates the first DN; when the second request comes, T-Server allocates the second DN; and so on. T-Server does not reuse the first DN until reaching the end of the DN list.
circular immediately
resource-load-maximum (resource-load-maximum)
Description Valid values Default value Takes effect
Specifies the maximum number of ISCC routing transactions that can be concurrently processed at a single DN of the External Routing Point route type. After a number of outstanding transactions at a particular DN of the External Routing Point type reaches the specified number, T-Server considers the DN not available. Any subsequent request for this DN is queued until the number of outstanding transactions decreases. A value of 0 (zero) means that no limitation is set to the number of concurrent transactions at a single External Routing Point. In addition, the 0 value enables T-Server to perform load balancing of all incoming requests among all available External Routing Points, in order to minimize the load on each DN. 0 immediately
route-dn (route-dn)
Description Valid values Default value Takes effect
Specifies the DN that serves as a Routing Point for the route transaction type in the multiple-to-one access mode. Any DN (blank) immediately
tcs-queue (tcs-queue)
Description Valid values Default value Takes effect
Specifies the TCS DN number to which a call, processed by the TCS feature, is dialed after the originating external router obtains an access number. Any valid DN number (blank) For the next request for the remote service
tcs-use (tcs-use)
Description Valid values Default value Takes effect

Specifies whether the Transfer Connect Service (TCS) feature is used.


  • never — The TCS feature is not used.
  • always — The TCS feature is used for every call.
  • app-defined — In order to use the TCS feature for a multi-site call transfer request, a client application must add a key-value pair with a TC-type key and a nonempty string value to the UserData attribute of the request.
Note: For compatibility with the previous T-Server releases, you can use the value
up-app-depended for this option. This is an alias for app-defined.
never immediately
timeout (timeout)
Description Valid values Default value Takes effect
Specifies the time interval that the destination T-Server waits for a call routed from the origination location. Counting starts when this T-Server notifies the requesting T-Server about routing service availability. The timeout must be long enough to account for possible network delays in call arrival. 60 sec For the next request for remote service
use-data-from (use-data-from)
Description Valid values Default value Takes effect

Specifies the call from which the values for the UserData and ConnID attributes should be taken for a consultation call that is routed or transferred to a remote location.


  • active — The UserData and ConnID attributes are taken from the consultation call.
  • original — The UserData and ConnID attributes are taken from the original call.
  • consult-user-data — If the value of consult-user-data is specified, the following occurs:

- Before the transfer or conference is completed, the UserData and ConnID attributes are taken from the consultation call. - After the transfer or conference is completed, EventPartyChanged is generated, and the UserData and ConnID are taken from the original call.

Note: For compatibility with the previous T-Server releases, you can use the values 
consult, main, and current for this option. 
These are aliases for active, original, and consult-user-data, respectively.
active immediately
use-default-access-numbers (use-default-access-numbers)
Description Valid values Default value Takes effect


true,false false immediately
use-implicit-access-numbers (use-implicit-access-numbers)
Description Valid values Default value Takes effect

Determines whether an External Routing Point in which at least one access number is specified is eligible for use as a resource for calls coming from switches for which an access number is not specified in the External Routing Point.


  • false — the External Routing Point is not eligible for use as a resource for calls coming from such switches.
  • true — An implicit access number for the External Routing Point, composed of the switch access code and the DN number of the External Routing Point, will be used.
Note: If an External Routing Point does not have an access number specified,
this option will not affect its use.
false immediately

gli

gli-keep-alive-interval (gli-keep-alive-interval)
Description Valid values Default value Takes effect

Specifies (in seconds) the time before a KeepAliveRequest is sent. A value of -1 turns off the sending of these requests.


-1 immediately
gli-keep-alive-tries (gli-keep-alive-tries)
Description Valid values Default value Takes effect

Specifies the number of gli-keep-alive-interval that can pass without receiving either a message or a KeepAliveResponse before the link is closed.


1 immediately
gli-mode (gli-mode)
Description Valid values Default value Takes effect

Specifies whether the GDI Link Interface (GLI) layer acts as a client or a server. If set to server, the IVR Server uses the options in the gli_server section. Because the IVR Server always acts in the server role, this option must be set to server, and the gli_server section must also be provided.


  • server server
  • client client
server After TServer_IVR is restarted
gli-reconnect-delay (gli-reconnect-delay)
Description Valid values Default value Takes effect

Specifies the delay (in seconds) before a reconnection is attempted. This option affects both server and client connections.


5 immediately

gli_server

gli-n-servers (gli-n-servers)
Description Valid values Default value Takes effect

Used in Circuit mode only. Specifies the number of server group sections to read. These server group sections are named gli_server_group_1, gli_server_group_2, and so on. Each server group section contains a gli-server-address and a gli-client-list.


1 immediately
gli-server-mode (gli-server-mode)
Description Valid values Default value Takes effect

Specifies use of gli-n-servers option in Circuit mode. Warning! This option must not be changed dynamically. T-Server must be restarted for option changes to take effect properly.


circuit after TServer IVR restart

gli_server_group_1

gli-circuit-failover (gli-circuit-failover)
Description Valid values Default value Takes effect

If the T-Server clients (SCP) share call context, then you can set the option to on. Otherwise, it must be set to off.


on off off immediately
gli-client-list (gli-client-list)
Description Valid values Default value Takes effect

Specifies the list of clients that are allowed to connect to the server in a comma-separated format where each client is composed of the host name and port number. If no value is present, then any client may connect. Otherwise, an exact match (through DNS or BIND) is required. You can use the port number * (asterisk) to match any port. Note: This option is only used when connections are created. If this option is changed, open connections are not closed, even if they have been removed from the client list.


(blank) immediately
gli-server-address (gli-server-address)
Description Valid values Default value Takes effect

Specifies the address to use when creating the server's listen socket. You can specify more than one address using a comma-separated list of addresses, where each address is composed of the host name or IP address and the TCP/IP port number in the format Hostname or="" IP_Address="":TCP/IP Port#. Note: Changing the address will not affect any existing client connections. It will only change the address for the server listen port.


on off on After TServer_IVR is restarted
gli-tls-cert (gli-tls-cert)
Description Valid values Default value Takes effect

For Windows, this option contains the thumbprint obtained from a user certificate generated for the host. On UNIX, this option specifies the path and filename to a .pem encoded file containing the host certificate. Note: This option is only used when connections are created. If this option is changed, open connections are not closed.


(blank) After T-Server is restarted
gli-tls-cert-key (gli-tls-cert-key)
Description Valid values Default value Takes effect

On UNIX, this option specifies the path and filename to a .pem encoded file containing the host private key. Notes: This option is only applicable to UNIX operating systems. This option is only used when connections are created. If this option is changed, open connections are not closed.


(blank) After T-Server is restarted
gli-tls-trusted-ca (gli-tls-trusted-ca)
Description Valid values Default value Takes effect

On UNIX, this option specifies the path and filename to a .pem encoded file containing the CA certificate. Notes: This option is only applicable to UNIX operating systems. This option is only used when connections are created. If this option is changed, open connections are not closed.


(blank) After T-Server is restarted

IServer

app-name (app-name)
Description Valid values Default value Takes effect

Specifies the name of the I-Server application object in Configuration Manager. This option is required for IVR-In-Front and IVR-Behind-Switch configurations, but is not used for IVR Network T-Server configurations.


Any valid I-Server application object name (blank) After TServer_IVR is restarted
dtd-file (dtd-file)
Description Valid values Default value Takes effect

Specifies the name of the .dtd file to be included in XML messages that IVR Server sends.


Any relative or absolute path to a .dtd file IServer.dtd After TServer_IVR is restarted
flow-control (flow-control)
Description Valid values Default value Takes effect

Enables flow control for a related IVR Server. If set to on, no new calls can be started at that IVR Server; however, existing calls proceed normally.


  • off off
  • on on
off immediately
report-dn-status (report-dn-status)
Description Valid values Default value Takes effect

Specifies whether EventDNOutOfService / EventDNBackInService messages are generated.


true,false false immediately

IServerGLMSap

checkout-interval (checkout-interval)
Description Valid values Default value Takes effect

Specifies the interval (in seconds) at which the IVR Server attempts to request license updates from the FlexLM license server for the maximum call usage during that interval. IVR Server keeps track of the maximum number of concurrent calls during each interval, and at the end of the interval, it sends a message to FlexLM to update the licenses used by the IVR Server to the maximum concurrent value for that interval. The minimum possible value is 600 seconds, and the maximum possible value is 3600 seconds. If you set a value that is outside this range, it is ignored, and the default is used instead.


600 thru 3600 600 Immediately
operation-mode (operation-mode)
Description Valid values Default value Takes effect

Specifies the IVR Server deployment mode. IVR Server cannot be started until you set this option. Set the value to NTS for an IVR Network T-Server configuration. This enables the IVR Server to use the GenSpec XML protocols. Set the value to IVR for an IVR-In-Front or IVR-Behind-Switch configuration.


IVR,NTS IVR After TServer_IVR is restarted

license

license-file (license-file)
Description Valid values Default value Takes effect

As supported in the "Licensing Guide", Generally a local license file or a port@host syntax of a remote license server.


valid license access (blank) After TServer_IVR is restarted
num-of-licenses (num-of-licenses)
Description Valid values Default value Takes effect

Specifies how many DN licenses T-Server checks out. T-Server treats a value of 0 (zero) the same as it treats max-that is, it checks out all available licenses. The sum of all num-of-licenses values for all concurrently deployed T-Servers must not exceed the number of seat-related DN licenses (tserver_sdn) in the corresponding license file. The primary and backup T-Servers share the same licenses, and therefore they need to be counted only once. T-Server checks out the number of licenses indicated by the value for this option, regardless of the number actually in use.


0 0 immediately
num-sdn-licenses (num-sdn-licenses)
Description Valid values Default value Takes effect

Specifies how many seat-related licenses T-Server checks out. A value of 0 (zero) means that T-Server does not grant control of seat-related DNs to any client, and it does not look for seat-related DN licenses at all. The sum of all num-sdn-licenses values for all concurrently deployed T-Servers must not exceed the number of seat-related DN licenses(tserver_sdn) in the corresponding license file. The primary and backup T-Servers share the same licenses, and therefore they need to be counted only once. T-Server checks out the number of licenses indicated by the value for this option, regardless of the number actually in use. Note: For Network T-Servers, Genesys recommends setting this option to 0. Note: Be sure to configure in the Configuration Database all the DNs that agents use (Extensions and ACD Positions) and that T-Server should control.


(0 equal to the value of num-of-licenses), or any integer from 0 - 9999 0 immediately

Log

all (Output for level all)
Description Valid values Default value Takes effect
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.

  • 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.
stderr immediately
buffering (buffering)
Description Valid values Default value Takes effect

Turns on/off operating system file buffering. The option is applicable only to the stderr and stdout output. Setting this option to true increases the output performance. Note: When buffering is enabled, there might be a delay before log messages appear at the console.

true,false true immediately
expire (Log Expiration)
Description Valid values Default value Takes effect
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.

  • 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.
false immediately
keep-startup-file (Keep startup log file)
Description Valid values Default value Takes effect
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).

  • 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.
false After restart
segment (Log Segmentation)
Description Valid values Default value Takes effect
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.

  • 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.
false immediately
verbose (verbose)
Description Valid values Default value Takes effect
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.
  • 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.
all immediately

pgf

ptc-file (name of .smx file)
Description Valid values Default value Takes effect

Specifies the file name for the .smx file for this T-Server. Warning! For this T-Server to operate properly, you must set the value of this option to the relative or absolute path name for the .smx file.


I-Server.smx after TServer IVR is restarted

Timers

Call Timeout (Call Timeout)
Description Valid values Default value Takes effect

Specifies the amount of time that a call can remain active before it is ended.


8 h After TServer_IVR is restarted
CME Update Timeout (CME Update Timeout)
Description Valid values Default value Takes effect

Specifies the length of the delay between when changes are made and when those changes are applied.


2 s After TServer_IVR is restarted
Registration Timeout (Registration Timeout)
Description Valid values Default value Takes effect

Used only when IVR Server is configured to perform agent login on a connected T-Server. If the DN on which the agent login is to be performed is successfully registered with the T-Server, IVR Server waits the specified amount of time before it checks again to determine whether the DN is now registered. After the DN is registered, the agent login is requested.


5 s Immediately
Retry Timeout (Retry Timeout)
Description Valid values Default value Takes effect

If an error occurs in response to attempts to register a DN or log in an agent, IVR Server reattempts the specified operation after the amount of time.


30 s Immediately
Router Timeout (Router Timeout)
Description Valid values Default value Takes effect

Specifies the amount of time that IVR Server waits for routing or call treatment instructions before it performs default routing for the call.


4 s Immediately
Stat Timeout (Stat Timeout)
Description Valid values Default value Takes effect

Specifies the amount of time that IVR Server waits for a reply from Stat Server for a noncached peek operation. After the timer expires, the last known good value is used.


3 s Immediately
Stop Waiting Timeout (Stop Waiting Timeout)
Description Valid values Default value Takes effect

Specifies the amount of time that IVR Server waits for the final stage of the two-stage release mechanism before it ends the call.


30 s Immediately
Unregister Timeout (Unregister Timeout)
Description Valid values Default value Takes effect

Specifies the maximum amount of time that IVR Server waits for EventUnregistered from a connected T-Server when it attempts to unregister a DN. If this timer expires, IVR Server stops waiting for the reply and makes no further attempt to unregister the DN.


3 s Immediately
wait-for-ringing (wait-for-ringing)
Description Valid values Default value Takes effect

Specifies the maximum time interval between receipt of a NewCall message from an IVR Driver and receipt of a corresponding EventRinging message for this call from the T-Server.


60 s immediately

TServer

background-processing (background-processing)
Description Valid values Default value Takes effect

When set to true, T-Server processes all client requests in the background, giving higher priority to the rest of the messages. This ensures that it processes these messages without any significant delay. With Background Processing functionality enabled, T-Server processes all switch messages immediately and waits until there are no switch messages before processing the message queue associated with T-Server client requests. T-Server reads all connection sockets immediately and places client requests in the input buffer, which prevents T-Server clients from disconnecting because of configured timeouts. When T-Server processes client requests from the message queue, requests are processed in the order in which T-Server received them. When set to false, T-Server processes multiple requests from one T-Server client before proceeding to the requests from another T-Server client, and so on. Note: Use of this option can negatively impact T-Server processing speed.


true,false false immediately
background-timeout (background-timeout)
Description Valid values Default value Takes effect
Specifies the time interval that T-Server waits before processing client requests in background mode. You must set the background-processing option to true in order for this option to take effect 60 msec immediately
check-tenant-profile (check-tenant-profile)
Description Valid values Default value Takes effect

When set to true, T-Server checks whether a client provides the correct name and password of a tenant. If it does, T-Server allows that client to register DNs that are included in the switch configuration in the Configuration Database, but it does not allow the client to register DNs that are not included in the switch configuration. Note: To make T-Server compatible with 3.x and 5.x clients, set the check-tenant- profile option to false.


true,false false For the next connected client
compatibility-port (compatibility-port)
Description Valid values Default value Takes effect
Specifies the TCP/IP port that 3.x clients use to establish connections with T-Server. Connections to this port are accepted only if T-Server has a connection with the switch. If set to 0 (zero), this port is not used. 0 After T-Server has reconnected to the link
consult-user-data (consult-user-data)
Description Valid values Default value Takes effect

Specifies the method for handling user data in a consultation call. Note: A T-Server client can also specify the consult-user-data mode in the Extensions attribute ConsultUserData key for a conference or transfer request. If it is specified, the method of handling user data is based on the value of the ConsultUserData key-value pair of the request and takes precedence over the T-Server consult-user-data option. If it is not specified in the client request, the value specified in the consult-user-data option applies.


  • separate — Stores user data for original and consultation calls in separate structures. The data attached to the original call is available for review or changes only to the parties of that call. The data attached to the consultation call is available only to the parties of the consultation call.
  • inherited — Copies user data from an original call to a consultation call when the consultation call is created; thereafter, stores user data separately for the original and the consultation call. Changes to the original call's user data are not available to the parties of the consultation call, and vice versa.
  • joint — Stores user data for an original call and a consultation call in one structure. The user data structure is associated with the original call, but the parties of both the original and consultation calls can see and make changes to the common user data.
separate For the next consultation call created
customer-id (customer-id)
Description Valid values Default value Takes effect

Identifies the T-Server customer. You must set this option to the name of the tenant that is using this T-Server. You must specify a value for this option if you are working in a multi-tenant environment. Note: Do not configure the customer-id option for single-tenant environments


(blank) immediately
log-trace-flags (log-trace-flags)
Description Valid values Default value Takes effect

Specifies --using a space-, comma- or semicolon-separated list --the types of information that are written to the log files.


  • +/-iscc — Turns on/off the writing of information about Inter Server Call Control (ISCC) transactions.
  • +/-cfg$dn — Turns on/off the writing of information about DN configuration.
  • +/-cfgserv — Turns on/off the writing of messages from Configuration Server.
  • +/-passwd — Turns on/off the writing of information about passwords.
  • +/-udata — Turns on/off the writing of attached data.
  • +/-devlink — Turns on/off the writing of information about the link used to send CTI messages to the switch (for multilink environments).
  • +/-sw — Reserved by Genesys Engineering.
  • +/-req — Reserved by Genesys Engineering.
  • +/-callops — Reserved by Genesys Engineering.
  • +/-conn — Reserved by Genesys Engineering.
  • +/-client — Turns on/off the writing of additional information about the client's connection.
+iscc +cfg$dn -cfgserv +passwd +udata -devlink -sw -req -callops -conn -client immediately
management-port (management-port)
Description Valid values Default value Takes effect
Specifies the TCP/IP port that management agents use to communicate with T-Server. If set to 0 (zero), this port is not used. 0 After T-Server is restarted
merged-user-data (merged-user-data)
Description Valid values Default value Takes effect

Specifies the data that is attached to the resulting call after a call transfer, conference, or merge completion.


  • main-only — T-Server attaches user data from the remaining call only.
  • merged-only — T-Server attaches user data from the merging call.
  • merged-over-main — T-Server attaches user data from the remaining and the merging call. In the event of equal keys, T-Server uses data from the merging call.
  • merged-over-merged — T-Server attaches data from the remaining and the merging call. In the event of equal keys, T-Server uses data from the remaining call.
main-only immediately
server-id (server-id)
Description Valid values Default value Takes effect

Specifies the Server ID that T-Server uses to generate Connection IDs and other unique identifiers. In a multi-site environment, you must assign each T-Server a unique Server ID, in order to avoid confusion in reporting applications and T-Server behavior.

Configuration of this option is necessary for Framework environments in which there are two or more instances of the Configuration Database.

Note: If you do not specify a value for this option, T-Server populates it with the ApplicationDBID as reported by Configuration Server. Each data object in the Configuration Database is assigned a separate DBID that maintains a unique Server ID for each T-Server configured in the database.

Warning! Genesys does not recommend using multiple instances of the Configuration Database.


(blank) immediately
user-data-limit (user-data-limit)
Description Valid values Default value Takes effect

Specifies the maximum size (in bytes) of user data in a packed format.

Note: When T-Server works in mixed 7.x/6.x environment, the value of this option must not exceed the default value of 16000 bytes; otherwise, 6.x T-Server clients might fail.


Check your TServer for maximum supported size 16000 immediately

TServerClientSap

call-timer-timeout (call-timer-timeout)
Description Valid values Default value Takes effect

Specifies the amount of time (in seconds) that the TServerClientSap waits for the call to be released. After the timer expires, the TServerClientSap assumes that the call is over, and all call-related information is deleted.


28800 Immediately
defer-tlib-events (defer-tlib-events)
Description Valid values Default value Takes effect

Specifies whether call-related events are processed before a new call notification for the call is received. If false, all call-related events are processed immediately. If true, all call-related events are buffered in the TServerClientSap until a new call notification is received for the call, at which time the events are processed. Note: In order for I-Server to function properly, the defer-tlib-events option must be set to true.


true true At I-Server startup
waiting-for-newcall-timeout (waiting-for-newcall-timeout)
Description Valid values Default value Takes effect

Specifies the amount of time (in seconds) that the TServerClientSap waits for a new call notification for a call. After the timer expires, the TServerClientSap assumes that the new call notification will never arrive, and all events for the call are discarded.


30 Immediately

XmlSap

target-encoding (target-encoding)
Description Valid values Default value Takes effect

Valid Values: Any target encoding that is supported by the Genesys Framework components. For a complete list of supported transcoders, go to http://www.ibm.com/software/globalization/icu/demo/converters.

Note: Any keys or user data sent or received (including after the transcoding thereof) must be no more than two bytes per character.


ISO-8859-1 At startup
validation-scheme (validation-scheme)
Description Valid values Default value Takes effect

Specifies whether validation is performed on incoming XML messages.


  • never — no validation of the XML messages is performed.
  • auto — XML messages are validated if a .dtd file exists; otherwise, no validation is performed.
  • always — all XML messages are validated, and it is considered an error if no .dtd file exists.
never Immediately
Personal tools
Namespaces
Variants
Actions
Navigation
Genesys
Create a PDF
Social Side Bar
Share
Toolbox