TServer Section (General)
General TServer Section Options
All of the options in this section must be called TServer.
accept-dn-type
Default Value: +acdqueue +announcement +data +extension +position +routedn +routequeue +trunk +voicemail
Valid Values:
+/-acdqueue—Accepts or rejects registration on DN of type ACD Queue (AddressTypeQueue)
+/-announcement—Accepts or rejects registration on DN of type Music Port (AddressTypeAnnouncement)
+/-data—Accepts or rejects registration on DN of type Modem (AddressTypeDataChannel)
+/-extension—Accepts or rejects registration on DN of type Extension (AddressTypeDN)
+/-position—Accepts or rejects registration on DN of type Position (AddressTypePosition)
+/-routedn—Accepts or rejects registration on DN of type Routing Point (AddressTypeRouteDN)
+/-routequeue—Accepts or rejects registration on DN of type Route Queue (AddressTypeRouteQueue)
+/-trunk—Accepts or rejects registration on DN of type trunk or tie line (AddressTypeTrunk)
+/-voicemail—Accepts or rejects registration on DN of type Voice Mail (AddressTypeVoiceChannel)
Changes Take Effect: Immediately
Defines the supported set of device types that are not configured in the Configuration Layer, but that T-Server can register.
Note: All possible values are listed here, however, this set is T-Server specific.
accode-data
Default Value: none
Valid Values:
none—T-Server does not map the switch account codes to the call user data.
udata—T-Server attaches reported account codes as user data, using the key defined by the accode-name option. T-Server then sends requests to set account codes to the switch, when such user data keys are used in client requests AttachUserData or UpdateUserData.
ext—T-Server attaches user data as extensions to all call events and does not intercept user data update requests with the reserved keys.
Changes Take Effect: Immediately
Specifies whether T-Server has to map the switch account codes to call user data (value udata), to extensions (value ext) or will not map switch account codes (value none).
Note: T-Server uses the reserved keys sent in any call-related client-request Extensions attribute, regardless of the value of this option. The only exception is when the configuration option is set to udata and the user data in the request contains the account code.
accode-name
Default Value: AccountCode
Valid Values: Any valid key name
Changes Take Effect: Immediately
Specifies the data key name under which T-Server attaches the account code to the call, as either user data or extensions.
accode-privateservice
Default Value: false
Valid Values: true, false
Changes Take Effect: Immediately
Enables or disables the use of TPrivateService and EventPrivateInfo for handling the Account Code feature.
agent-only-private-calls
Default Value: false
Valid Value: true, false
Changes Take Effect: Immediately
Specifies whether T-Server will classify a call as private when the initial business type of the call is unknown and there is no agent on the call in situations, but if an agent was on the call, the classification would be private.
- If the value of this option is set to true—the call remains as business type, unknown, when no agent is on the call, where the business type classification would be changed from unknown to private, if an agent was on the call.
- If the value of this option is set to false—calls with no agent(s) on the call are classified as private instead of being left as business type, unknown.
agent-group
Default Value: none
Valid Value: Any agent group value
Changes Take Effect: At the next agent login session
Specifies a value for a virtual group to be used for T-Server reporting.
T-Server obtains the value for this option in the following order of precedence:
- In the TServer section of the Annex tab of the Agent Login object
- In the TServer section of the Annex tab of theDN object
- In the main TServer section.
callback-dn
Default Value: CallbackDN
Valid Values: Any valid string representing a simulated DN
Changes Take Effect: Immediately
Sets the value of the third party DN used in reporting call back scenario as a simulated single-step transfer.
consult-supervised-rt
Default Value: false
Valid Values: true, false
Changes Take Effect: Immediately
Specifies whether T-Server allows supervised routing of consultation calls. If this option is set to a value of false, T-Server forces non-supervised routing for consultation calls, regardless of the configuration option or call-by-call settings.
Note: When set at the Application-level, this option defines the default value for all Routing Points. However, this option can also be specified on the Annex tab of Routing Point DNs, in which case it overrides the option set at the Application-level.
correct-connid
Default Value:true
Valid Value: true, false
Changes Take Effect: Immediately
If the value of this option is set to true, T-Server corrects the wrong ConnectionID provided by the application in CTI requests. If the value of this option is set to false, this feature is disabled.
correct-rqid
Default Value: true
Valid Value: true, false
Changes Take Effect: Immediately
If the value of this option is set to true, T-Server corrects the wrong CTI client request. If the value of this option is set to false, this feature is disabled.
default-dn-type
Default Value: none, extension, position
Valid Values:
- acdqueue—T-Server uses the AddressTypeQueue value
- announcement—T-Server uses the AddressTypeAnnouncement value
- data—T-Server uses the AddressTypeDataChannel value
- extension—T-Server uses the AddressTypeDN value
- none—T-Server assigns the DN type using the PBX-provided information
- position—T-Server uses the AddressTypePosition value
- trunk—T-Server uses the AddressTypeTrunk value
- voicemail—T-Server uses the AddressTypeVoiceChannel value
Changes Take Effect: Immediately
Defines the value that T-Server applies for the AttributeAddressType attribute when the client does not provide it or provides the value, AddressTypeUnknown, instead.
Note: All possible values are listed here, however, this set is T-Server specific.
dn-del-mode
Default Value:idle
Valid Values: never, idle, force, Timeout Value Format
- never—T-Server does not unregister the DN with the PBX and the device-related information is never deleted from the T-Server memory.
- idle—T-Server unregisters the DN with the PBX and the device-related information is deleted from the T-Server memory as soon as there are no more calls on this device.
- force—T-Server unregisters the DN with the PBX and the device-related information is deleted from the T-Server memory regardless of whether any calls exist on that DN.
- Timeout Value Format—T-Server applies a defined delay before unregistering the DN after the last call has left that DN. The valid value, idle is equivalent to setting the Timeout Value to 0 (zero).
Changes Take Effect: Immediately
Defines how T-Server handles device and device-related information when the DN is not configured in the Configuration Layer and there are no clients registered on that DN.
enable-controller-release
Default Value: false
Valid Value: true, false
Changes Take Effect: Immediately
Specifies whether the Clear Connection CSTA request is accepted to clear the conference call.
link-1-name
Default Value: link-tcp—required if the Link-Control Section is absent.
Valid Values: Any valid section name.
Changes Take Effect: Immediately
Specifies the section name containing the section name for the connection to the Connector, while the Link-Control Section options only define the link handling—For example: the number of restarts, gaps, and so on. You must specify a value for this option.
max-pred-req-delay
Default Value: 3 seconds
Valid Value: Any integer from 0-10
Changes Take Effect: Immediately
Defines the maximum time (in seconds) that T-Server waits for a free dialing resource to become available before rejecting a TMakePredictiveCall request.
monitor-agents
Default Value: false
Valid Values: true, false
Changes Take Place: Immediately
Specifies whether T-Server should monitor all agents specified in the Agent Logins tab. This value can be overridden by the agent monitor or emulate-login Annex tab options. T-Server monitors the number as a device and substitutes events on that device with the position number that the agent is logged on. Set this option in the TServer section on the Options tab of the T-Server Application object.
Note: Use this option when all AgentIDs are planned for monitoring. For more selective AgentID monitoring, use the Agent-specific Override option, monitor.
retain-call-tout
Default Value: 15 seconds
Valid Value: Any integer from 0-3600
Changes Take Effect: Immediately
Specifies the time interval (in seconds) that T-Server waits before deleting information about calls that are completed, but for which it has received no notification from the switch.
show-supervisor-dns
Default Value:false
Valid Values: true, false
Changes Take Effect: Immediately
Specifies whether T-Server distinguishes supervisor DNs from regular parties in the Extensions attribute when reporting transfer and/or conference calls. Enables the special reporting of Supervisor DNs in transfer and conference call scenarios.
- If the value of this option is set to true, T-Server differentiates between the supervising devices and reports them as the OrigSV-n and ConsultSV-n keys of the Extensions attribute (as opposed to regular party reporting that uses the OrigDN-n and ConsultDN-n keys of the Extensions attribute).
- If the value of this option is set to false, T-Server reports supervising parties as regular parties using the Extensions attribute keys, OrigDN and ConsultDN in transfer and/or conference calls.
Note: Since the supervisor presence no longer makes a two-party call into a conference call, if this option is enabled, the OtherDN attribute is reported the same as if the call was monitored.
supervised-route-timeout
Default Value: 5 seconds
Valid Value: Any integer from 0-600
Changes Take Effect: Immediately
Specifies the interval (in seconds) that T-Server waits for a call to be answered that is routed from an Routing Point using supervised routing. If the call is not answered within the period specified, T-Server recalls the call to the Routing Point and initiates rerouting. A value of 0 (zero) deactivates this feature. See, agent-no-answer-timeout.
This timeout should be set to a value higher than the system latency.
Notes:
- You can use the Extensions attribute, SUPERVISED_ROUTE to override the value of this configuration option on a call-by-call basis. See the Using the Extensions Attribute topic for more information.
- When set in the TServer section, this option defines the default value for all Routing Points. However, you can also set a value for this option on the Annex tab of DNs of type Routing Point in a section called TServer. When set there, this value overrides the default value for the specific Routing Point. You can also use the Extensions attribute, SUPERVISED_ROUTE, to override the value of this configuration option on a call-by-call basis.
- In order for the supervised routing feature to be able to recall the call to the Routing Point, no Bounced Calls should be configured on the Routing Point in the switch configuration.
unknown-xfer-merge-udata
Default Value: false
Valid Values: true, false
Changes Take Place: Immediately
If the value of this option is set to true, T-Server copies the user data from the current monitored call to the call transferred from an unmonitored destination. Because the primary call was hitherto unknown, normal user data inheritance mechanisms cannot be used. Use this option with the merge-user-data option.