Switch Options
This section describes the configuration options that you configure on the Annex tab of any Switch configuration object that is monitored by a T-Server related to your Interaction Concentrator. Interaction Concentrator processes these options.
gts Section
All the Switch configuration options that affect Interaction Concentrator behavior are contained in a special configuration section, gts. If required, you must create this section on the Annex tab of the Switch object.
call-deletion-timeout Option
delivered-flag Option
emulate-event-queued-extrp
emulate-event-queued-rp
emulate-event-queued-rq
fix-time-stamps
gls-acw-first
gls-associations-rule
gls-enable-acw-busy
gls-flag-on-disconnect
gls-improve-data-for-agent
gls-max-duration
gls-max-inactivity
gls-use-ts-id
gts-dnis-detection
min-tsync-roundtrip
ring-divert
sst-options
support-dn-type-5
suppress-user-data
switch-multi-links-enabled
third-party-queue-in-divert
call-deletion-timeout
Specifies the amount of time, in seconds, that ICON delays call context deletion after receiving a notification that the call has been deleted in T-Server.
- Configured in: Switch Application
- Default value: 30
- Valid values: 3–600
- Changes take effect: Immediately
delivered-flag
Controls when an unmonitored party is reconstructed (regarding an event flow), and when a transition to the alerting state occurs for this party in the call to an external destination (regarding the switch).
- Configured in: Switch Application object, Annex tab, [gts] ection
- Default values:
- 0—(For all switches except Cisco CallManager)
- 1—(For Cisco CallManager)
- Valid values:
- 0—The alerting state is generated when EventDialing arrives.
- 1—The alerting state is generated when EventNetworkReached arrives.
- 2—The alerting state is generated when EventEstablished arrives.
- 3—An unmonitored party is not reconstructed.
- Changes take effect: After restart
emulate-event-queued-extrp
Enables the emulation of EventQueued for an External Routing Point that belongs to this switch.
- Configured in: Switch Application object, Annex tab, [gts] section
- Default value: 1
- Valid values:
- 0—EventQueued is not emulated.
- 1—EventQueued is emulated.
- Changes take effect: Immediately
emulate-event-queued-rp
Enables the emulation of EventQueued for a Routing Point that belongs to this switch.
- Configured in: Switch Application
- Default value: 1
- Valid values:
- 0—EventQueued is not emulated.
- 1—EventQueued is emulated.
- Changes take effect: Immediately
emulate-event-queued-rq
Enables the emulation of EventQueued for a routing queue that belongs to this switch.
- Configured in: Switch Application
- Default value:1
- Valid values:
- 0—EventQueued is not emulated.
- 1—EventQueued is emulated.
- Changes take effect: Immediately
fix-time-stamps
Enables adjustment of timestamps when the CTI event contains an earlier timestamp than the timestamp from a previously received CTI event.
- Configured in: Switch Application
- Default value: 0
- Valid values:
- 0—Adjustment is disabled.
- Any non-zero integer—Adjustment is enabled.
- Changes take effect: After restart
gls-acw-first
Specifies which interaction ICON associates with after-call work (ACW). This option is configured in the ICON Application, or in the Switch Application, or both. If it is set only in the ICON Application, it applies to all switches ICON is configured to monitor. If any Switch is set with a value different from that set in the ICON Application, the Switch value takes precedence.
By default, ICON associates after-call work metrics with the voice interaction that immediately precedes the completion of the after-call work (the last voice interaction).
Setting this option to true enables ICON to associate after-call work with the voice interaction that most recently changed the agent’s state from NotBusy to Busy (the first voice interaction). In this case, subsequent voice interactions that occur during the period of after-call work are considered as related to ACW processing and should not interrupt measurement of ACW-related metrics.
When the agent logs out, changes his or her state to Ready, or goes NotReady for any reason other than to perform after-call work, ICON reports the end of the current ACW state.
- Configured in: ICON Application, [callconcentrator] Section; Switch Application, Annex tab, [gts] Section
ICON Application Settings:
- Default value: false
- Valid values:
- false—ICON associates the last voice interaction with after-call work.
- true—ICON associates the first voice interaction with after-call work.
- Changes take effect: After restart
Switch Application Settings:
- Default value: -1
- Valid values:
- -1—ICON uses the value of the gls-acw-first option specified in the ICON Application object. If no value is set at the application level, ICON associates the last voice interaction with after-call work.
- 0—ICON associates the last voice interaction with after-call work.
- 1—ICON associates the first voice interaction with after-call work.
- Changes take effect: After restart
gls-associations-rule
Controls, for this switch, how ICON associates DNs with a given agent login session. You can configure DN associations in Configuration Layer in two ways:
- By adding DNs to the same Place object. (For example, a DN of Position type and DN of Extension type on the same phone set on an Avaya switch must belong to the same Place. Another example involves DNs of different media types that are included into the same Place.)
- By creating a relationship between two DNs through the Association field in the DN Properties window.
The gls-associations-rule option enables ICON to process signaling on the associated DNs as follows:
- With the setting of -1, ICON creates two separate login sessions for an agent who logs in with two different login IDs at two DNs that belong to the same place. For example, when one DN is used for multimedia interactions and another DN is used for voice interactions, ICON handles agent login sessions at these two DNs separately.
- With the setting of 0, ICON creates a single login session for two DNs that belong to the same place when an agent logs in at one of these DNs. For example, when an agent logs in at a position DN and an extension DN exists on the same phone set, ICON maintains a single login session for these two DNs.
- With the setting of 1, ICON creates a single login session for two DNs that are related through the Association field when an agent logs in at one of these DNs. For example, when an agent logs in to different queues from two associated DNs, ICON maintains a single login session for these two DNs.
- Configured in: Switch Application
- Default values:
- -1—(For SIP switches)
- 0—(For all switches except SIP)
- Valid values:
- -1—ICON associates each DN with a separate login session.
- 0—ICON associates a single login session with multiple DNs at a place.
- 1—ICON associates a single login session with two DNs associated through configuration.
- Changes take effect: After restart
gls-enable-acw-busy
Specifies, for this switch, whether ICON should continue ACW and NotReady agent states when agents place or receive calls during the period of time that after-call work or NotReady agent state were invoked.
The following IDB tables are affected by this option: G_AGENT_STATE_HISTORY, G_AGENT_STATE_RC, GS_AGENT_STAT, GS_AGENT_STAT_VM. For a description of these tables, refer to the IDB schema chapter in the Interaction Concentrator 8.1 User’s Guide.
- Configured in: Switch Application
- Default value: 1
- Valid values:
- 0—ICON continues ACW and NotReady agent states while an agent is handling another call.
- 1—ICON interrupts ACW and NotReady agent states while the agent handles another call.
- Changes take effect: After restart
ICON recognizes completion of after-call work when any of the following occur:
- The agent logs out.
- The agent places himself/herself in Ready mode.
- The agent goes NotReady for any reason other than to perform after-call work. (This includes indirect work mode changes such as when the agent walks away from his or her desk for a period of time.)
gls-flag-on-disconnect
Specifies how ICON handles agent states when disconnecting from, and reconnecting to, T-Server.
- Configured in: Switch Application
- Default value: 0
- Valid values:
- 0—When reconnecting to T-Server, ICON compares the agent state from its memory with the state from EventRegistered. If the in-memory state does not match the currently reported agent state, ICON updates the agent state in both its internal memory and IDB. When disconnecting from T-Server, ICON performs no actions specific to agent states.
- 1—When disconnecting from T-Server, ICON closes any existing agent login sessions, and records this fact in IDB. When reconnecting to T-Server, ICON uses information from EventRegistered to start new agent login sessions, sets the current agent states, and writes this data to IDB.
- 2—When disconnecting from T-Server, ICON does not close any existing agent login sessions. Instead, it changes agents’ states to UNKNOWN, and records these new states in IDB. When reconnecting to T-Server, ICON uses information from EventRegistered to restore the current agents’ states and write them to IDB.
- Changes take effect: Immediately
- Genesys recommends setting this option to 0 when the switch is monitored by T-Server 7.6.
- Genesys recommends that you do not set the value of this option to 1 for deployments supporting HA of agent data. If you choose to set this option to 1, however, a limited amount of HA agent data will be available (event sequence numbers only) provided that you also set the gls-use-ts-id configuration option in the [gts] section to 0 on the Switch Annex tab.
gls-improve-data-for-agent
Specifies when ICON should process agent states data in two-step transfer and conference scenarios.
- Configured in: Switch Application
- Default value: 0
- Valid values:
- 0—EventCallDeleted triggers agent states data processing (legacy behavior).
- 1—Enables ICON to process agent states data based on EventReleased and store a more accurate value of PartyID in the G_AGENT_STATE_HISTORY table when a record describes one of the following:
- An agent state changing from Busy to another state
- An agent state changing from Busy to Busy
- An agent state changing to ACW
- Changes take effect: After ICON is restarted
gls-max-duration
Specifies the maximum amount of time, in hours, that an agent login session can last on a DN that belongs to this switch. Setting the option value to 0 (zero) prevents ICON from checking session durations.
- Configured in: Switch Application
- Default value: 0
- Valid values: Any integer from 0 to 720
- Changes take effect: Immediately
In deployments that use T-Server release 7.6 or later, ICON ignores the gls-max-duration option. With T-Server release 7.6 and later, T-Server generates agent login session IDs and controls the login sessions. In this case, the gls-max-duration option has no effect on ICON reporting.
Earlier releases of T-Server do not provide agent login session IDs. In these cases, ICON generates its own agent login session IDs, and uses the gls-max-duration and gls-max-inactivity options to help manage reporting on agent login session activity.
gls-max-inactivity
Specifies the maximum allowed inactivity period, in hours, during a single login session. ICON closes any agent login session for which no agent-related activity is detected during the specified interval. Setting the option value to 0 (zero) prevents ICON from checking inactivity durations.
- Configured in: Switch Application
- Default value: 0
- Valid values: Any integer from 0 to 72
- Changes take effect: Immediately
In deployments that use T-Server release 7.6 or later, ICON ignores the gls-max-inactivity option. With T-Server release 7.6 and later, T-Server generates agent login session IDs and controls the login sessions. In this case, the gls-max-inactivity option has no effect on ICON reporting.
Earlier releases of T-Server do not provide agent login session IDs. In these cases, ICON generates its own agent login session IDs, and uses the gls-max-duration and gls-max-inactivity options to help manage reporting on agent login session activity.
gls-use-ts-id
Specifies whether ICON uses the login session ID generated by T-Server (GUID) or by itself when connecting to, or disconnecting from, T-Server.
- Configured in: Switch Application
- Default value: 1
- Valid values:
- 0—ICON generates the login session ID itself.
- 1—ICON uses the login session ID (GUID) generated by T-Server.
- Changes take effect: After restart
gts-dnis-detection
Specifies how the value of DNIS is determined for outbound calls.
- Configured in: Switch Application
- Default value: 0
- Valid values: 0, 1
- 0—The DNIS is captured only from the attributeDNIS value in the TEvents related to the outbound call.
- 1—An extended algorithm will be used to find the value of the DNIS.
- Changes take effect: After restart
min-tsync-roundtrip
Specifies the amount of time, in milliseconds, allowed for messages sent from ICON to T-Server to be acknowledged by T-Server, for the purposes of time synchronization. All messages that are acknowledged within the specified round-trip delay are considered valid for the purposes of calculating the time difference between the ICON host and the T-Server host.
See also the tsync-threshold option in the ICON Application object.
- Configured in: Switch Application
- Default value: 50
- Valid values: 0–500 (0 indicates that no calculation will be performed)
- Changes take effect: Immediately
ring-divert
Controls whether ICON identifies the PARENTPARTYID and the PARENTLINKTYPE of the Ringing party in event flows in which EventRinging comes before EventDiverted or the call is routed to an external switch.
- Configured in: Switch Application, DN Application
- Default Value: 0
- Valid Values: 0, 1
- 0—ICON preserves its former behavior; that is, ICON does not identify the PARENTPARTYID or the PARENTLINKTYPE in these event flows.
- 1—ICON correctly sets the value of the PARENTPARTYID and the PARENTLINKTYPE.
- Changes Take Effect: If set for the Switch, changes take effect after ICON is restarted; if set for the DN, changes take effect immediately.
sst-options
Specifies the TEvents that ICON uses to recognize a single-step transfer, in order to ensure the correct processing of scenarios involving a single-step transfer.
- Configured in: Switch Application
- Default value: 0
- Valid values:
- 0—EventReleased, followed by a corresponding EventRinging or EventQueued. Arrivals of EventReleased, EventRinging, or EventQueued trigger the recognition logic.
- 1—EventReleased only. Arrival of EventReleased with an additional cause attribute triggers the recognition logic.
- Changes take effect: After restart
- SIP Server deployments with VoIP IVRs (GVP and third-party)
- T-Server for Siemens HiPath 4000 CSTA III.
support-dn-type-5
Enables the processing of events that pertain to DNs of the Virtual Queue type that belong to this switch.
- Configured in: Switch Application
- Default value: 1
- Valid values:
- 0—ICON does not process any Virtual Queue–related events for DNs that belong to this switch.
- 1—ICON processes Virtual Queue–related events for DNs that belong to this switch.
- Changes take effect: Immediately
suppress-user-data
Specifies whether the switch instructs T-Server to propagate attached data only when the attached data changes. This optimizes ICON processing of attached data by reducing network traffic.
This option can be set at the level of the Switch or the ICON application. ICON automatically detects the Switch-level option setting. If the Switch-level option is set to the (default) value of 1 (unchanged attached data suppressed), T-Server TEvents are optimized for all ICON applications that connect to the T-Servers for that Switch. In this case, the Switch-level option setting overrides any ICON-level settings of 0 (unchanged attached data not suppressed). If the Switch-level option is set to 0, an application-level setting of 1 will override it.
- Configured in: ICON Application, [callconcentrator] Section; Switch Application, Annex tab, [gts] Section
- Default value: 1
- Valid values:
- 0—Unchanged attached user data is not suppressed.
- 1—Unchanged attached user data is suppressed.
- Changes take effect: After restart
switch-multi-links-enabled
Specifies whether this switch is working in load-balancing mode; that is, it is served by multiple Network T-Servers or IVR T-Servers. ICON uses this option to determine whether to enable connection to more than one Network T-Server or IVR T-Server serving this switch.
- Configured in: Switch Application
- Default value: 0
- Valid values:
- 1—A network or IVR switch in load-balancing mode.
- Any other integer—Not a network or IVR switch in load-balancing mode.
- Changes take effect: After restart
This option should be used only in a configuration in which Network T-Servers or IVR T-Servers are working in load-balancing mode; that is, when there is no duplication in notification events received in ICON via connections to these T-Servers. Currently, load balancing mode is supported only for Network T-Servers and IVR T-Servers.
third-party-queue-in-divert
Specifies how Interaction Concentrator should process multi-queue scenarios in which a call is distributed to multiple queues simultaneously, then it is distributed from one of these queues and cleared from the remaining queues. When the third-party-queue-in-divert option is set to 1, Interaction Concentrator takes into account AttributeThirdPartyQueue in EventDiverted when AttributeCallState has a value of 0 in order to process interactions in the same way as for redirect scenarios.
- Configured in: Switch Application
- Default value: 0
- Valid values:
- 0—Interaction Concentrator does not check for the presence of AttributeThirdPartyQueue in EventDiverted.
- 1—Interaction Concentrator checks for the presence of AttributeThirdPartyQueue in EventDiverted.
- Changes take effect: After Interaction Concentrator is restarted
- Genesys Info Mart 7.x customers should use the default value for this option.
- In multi-queue scenarios, distribution to external DNs is not supported.