WFM Server Options
WFM Server is the only WFM component that has both configuration Annex and Options tab settings.
This topic includes the following sections:
Options Tab Settings
From the Options tab you can modify the default WFM Server configuration settings. The tab contains nine sections. The options in each of these sections are described below.
CalendarService Section
AdjustCarryOverByBonus
Type: Optional
Default Value: false
Valid Values: true, false
Dependencies: None
Specifies an optional way to handle a bonus assignment that does not have a specified end date as a balance adjustment, which is incorporated into carried over hours during the next carry over.
When set to true, all assigned bonus time that does not have a specified end date is carried over to the next configured carry-over date. The final number of carried-over hours remains subject to maximum carry-over hours constraint. The bonus expires after the carry-over date. Used hours are updated as they were before.
AutoPublishTimeOffToSchedule
Type: Optional
Default Value: 0
Valid Values: 0, 1, 2
Dependencies: None
Enables, disables, and configures automatic publishing of granted time off to an agent’s existing schedule. The following settings specify WFM’s response when an agent requests time off:
- 0—Feature is off.
- 1—Feature is on; a part-day time-off cannot overlap exceptions.
- 2—Feature is on; a part-day time-off deletes overlapped exceptions.
BatchRequest
Type: Optional
Default Value: true
Valid Values: true, false
Dependencies: None
Specifies how WFM Server processes multiple time-off requests submitted simultaneously by a single agent. When this option is set to true, WFM Server processes these time-off items in one batch. When this option is set to false, WFM Server processes these time-off items one-by-one.
CalendarOverScheduleData
Type: Optional
Default Value: 0
Valid Values: 0, 1, 2, 3
Dependencies: None
Enables the resolution of conflicts between granted or preferred time-off items and schedule data. Previously, when schedule data overlapped calendar data, unscheduled time off items were not considered when WFM Server checked agent time-off limits and balances.
- 0—Disables the resolution functionality (default value).
- 1—Enables resolution between granted calendar time-off items and overlapping schedule data.
- 2—Adds resolution of preferred time-off items to value 1 functionality.
- 3—These requests are counted against an agent’s time-off balance and limits:
- All requests with the status granted/not scheduled.
- Only wait-listed requests with the status preferred/not scheduled.
CarryOverTimeout
Type: Optional
Default Value: 1440
Valid Values: Any positive integer (-1 = off)
Dependencies: None
Specifies the time interval (in minutes) between process runs that handle automatic carry-over for Time Off balances.
DetermineFullDayTimeOffStartEndPaidHours
Type: Optional
Default Value: false
Valid Values: true, false
Dependencies: None
Specifies whether or not WFM Server resolves the Start/End time. If set to true when a user adds a Full-Day Time Off with the Start/End times not specified, WFM Server resolves the Start/End times.
MaxAuditReports
Type: Optional
Default Value: None
Valid Values: Any positive integer
Dependencies: None
Specifies the number of audit reports that can be built at one time. The recommended value is 1. If you request a greater number than is specified, the additional reports go into a queue.
HideMessagesForNotWorkingAgents
Type: Optional
Default Value: false
Valid Value: true, false
Dependencies: None
Specifies whether to prevent WFM Web from displaying error messages when Calendar items are set for agents who have been terminated or have not yet been hired, set this value to true. If you want to view error messages when Calendar items are set for agents who have been terminated or have not yet been hired, set this option to false.
PreventTimeOffNoAvailability
Type: Optional
Default Value: 0
Valid Values: 0, 1, 2
Dependencies: None
Specifies whether an additional check is turned on or off for already-configured days of days off when an agent requests time off.
- 0—The option is off.
- 1—Prevents an agent from requesting time off for weekdays, when the agent has no Contract availability.
- 2—Same as described for the value 1, except weekdays when Contract nonavailability is overwritten by an open granted availability interval. Also applies to dates with granted no-availability preferences and granted day-off preferences and to days when an agent has a rotating day-off according to his or her assigned rotating schedule.
When this option is on:
- If an agent requests a new time-off that overlaps an existing day-off, that agent receives an error and the time-off is not inserted into the calendar.
- The supervisor receives a warning, which is possible to override.
WaitlistTimeout
Type: Optional
Default Value: 60
Valid Values: Any positive integer (-1 = off)
Specifies the interval, in minutes, between process runs that handle wait-listed Calendar items.
Client Section
CfgServerRequestTimeout
Type: Mandatory
Default Value: 15
Valid Value: Any positive integer
Dependencies: None
Specifies the number of seconds to wait for a response from Configuration Server before timing out. This key is used when requesting the list of objects from Configuration Server for synchronization purposes. The value should be increased in configurations with a high number of objects or slow network connections.
SOAPTimeout
Type: Mandatory
Default Value: 60
Valid Value: Any positive integer
Dependencies: None
Specifies the number of seconds to wait for the response from WFM Server before timing out.
ConfigService Section
MaxCacheSize
Type: Optional
Default Value: No default value
Valid Value: Any positive integer
Dependencies: None
Specifies the maximum size, in megabytes (MB), of the Configuration cache.
MSARestrictAccess
Type: Optional
Default Value: false
Valid Value: true, false
Changes Take Effect: Immediately
Dependencies: None
Specifies whether or not users can access Multi-Site Activites (MSA). When this option is set to true, users must have access to all Activities under MSA to view any multi-site activity. When set to false users must have access to at least one Activity under MSA to view multi-site activities (current functionality).
MinCacheSize
Type: Optional
Default Value: No default value
Valid Value: Any positive integer
Dependencies: None
Specifies the minimum size, in megabytes (MB), of the Configuration cache. The cache is preloaded up to the minimum size.
CacheLifespan
Type: Optional
Default Value: No default value (null value means the size is unlimited)
Valid Value: Any positive integer
Dependencies: None
Specifies the amount of time, in hours, that data remains in the Configuration cache without being accessed. After this duration, the data is dropped from the cache.
CachePreloadTimeout
Type: Optional
Default Value: No default value (null value means 120 minutes)
Valid Value: Any positive integer
Dependencies: None
Specifies the time, in minutes, for preloading data in the cache. Data is preloaded up to the amount specified in the MinCacheSize option.
ETL Section
DaysAhead
Type: Optional
Default Value: 14 days
Valid Values: Any integer between 1 and 365
Dependencies: None
Specifies the number of days in the future from current date to track Fact data.
DaysBack
Type: Optional
Default Value: 14 days
Valid Values: Any integer between 0 and 365
Dependencies: None
Specifies the number of days in the past from current date to track Fact data.
DayChunk
Type: Optional
Default Value: 7 days
Valid Values: Any integer between 1 and 31
Dependencies: Should be less than (DaysBack + DaysAhead)
Specifies the number of days that will be processed at a time. The tracked day range is defined by the values set in the DaysBack and DaysAhead parameters and is processed in the specified chunks of data. So, this parameter determines the size of transaction. Larger transactions require more memory and other resources, but can be processed faster.
ETLTimeout
Type: Optional
Default Value: 180 minutes
Valid Values: Any integer between 0 and 2880
Dependencies: None
Specifies the timeout interval (in minutes) between each execution of the ETL process. Negative or zero values disable the ETL process.
ForecastService Section
ForecastTimestep
Type: Optional
Default Value: 15
Valid Values: 15, 30, 60 (Expert Average Engine) OR 15, 60 (Universal Modeling Engine)
Dependencies: None
Specifies the step used in the Expert Average. If the step is 60, then all values (that is, four values, each representing a 15-minute timestep value) in the 60-minute interval will be filled with the same predicted value.
MaxScenarioCacheSize
Type: Optional
Default Value: No default value (null value means the size is unlimited)
Valid Value: Any positive integer
Dependencies: None
Specifies the maximum size of the Forecast Scenario cache expressed in megabytes (MB).
ServiceLevelMethod
Type: Optional
Default Value: 0
Valid Value: 0, 1
Dependencies: None
Specifies whether Service Level should be calculated from the number of interactions distributed (as in Workforce Management 6.5) or from the number of interactions offered, taking into account abandoned interactions. The default value, 0, indicates that Service Level is calculated, based on the number of interactions distributed. To include abandoned interactions, set the value to 1.
This option is not included in the template by default. You must create it yourself. Create this option if you want to include abandoned interactions (value set to 1). If you do not create this option, WFM functions as though you have set the value to 0. See Creating New Configuration Sections and Options for instructions.
Identity Section
ApplicationType
Type: Optional in a Framework 8.x environment.
Default Value: WFMServer
Valid Value: WFMServer
Dependencies: None
Specifies which Workforce Management component this application is for. Configure this option only if you are using an application of the type ThirdPartyServer.
Log Section
verbose
Type: Mandatory
Default Value: all
Valid Values: all, trace, standard, none, yes (= all), no (= none)
Dependencies: None
Filters the output of log messages, based on their assigned priority.
- all—Enables output of all messages to the log file
- Trace—Enables informational and error messages and disables debug messages
- Standard—Enables error messages only and disables informational and debug messages
- None—Disables all messages.
buffering
Type: Mandatory
Default Value: false
Valid Values: true, false
Dependencies: None
Specifies whether system file buffering is turned on (true) or off (false).
segment
Type: Mandatory
Default Value: false
Valid Values: false, <number>, <number>KB, <number>MB, <number>Hr
Dependencies: None
Sets the maximum size (in KB, MB, or hours) of the log file segment, after which a new segment is created. The default size is in KB. The number (<number>) cannot be less than 100 KB or less than one hour. A value of No indicates no segmentation of the log file.
expire
Type: Mandatory
Default Value: false
Valid Values: false, <number>, <number> file, <number> day
Dependencies: None
Sets the expiration mode for old segments. The number to be stored cannot be less than 1 file or 1 day or more than 100 files or 100 days. A value of No indicates that files do not expire.
messagefile
Type: Mandatory
Default Value: wfmserver.lms
Valid Value: wfmserver.lms
Dependencies: None
Specifies the name of the file that stores application-specific log messages. The only valid value is wfmserver.lms.
standard
Type: Mandatory
Default Value: stdout
Valid Values: log output types, such as stdout, stderr, syslog, network, <filename>
Dependencies: None
Specifies that log events of the Standard level are to be sent to the listed outputs. For centralized logging, use a value of network. You can use a local file name as the value, stdout, or network.
trace
Type: Mandatory
Default Value: stdout
Valid Values: log output types, such as stdout, stderr, syslog, network, <filename>
Dependencies: None
Specifies that log events of the Trace level are to be sent to the listed outputs. For centralized logging, use network. You can use a local file name as the value, stdout, or network.
debug
Type: Mandatory
Default Value: stdout
Valid Values: log output types, such as stdout, stderr, syslog, network, <filename>
Dependencies: None
Specifies that log events of the Debug level are to be sent to the listed outputs.
all
Type: Mandatory
Default Value: stdout
Valid Values: log output types, such as stdout, stderr, syslog, network, <filename>
Dependencies: None
Specifies that log events of all levels, Standard, Trace, and Debug, are to be sent to the listed outputs.
PerformanceService Section
MaxActivityDays
Type: Optional
Default Value: 25,000
Valid Value: Any positive integer
Dependencies: None
Controls the maximum cost of performance-related and forecast-related data that can be returned by WFM Server. It prevents very large requests from overloading WFM Server. The value represents Activity Days. For example, a request for 50 activities over a 31-day period would require 1550 Activity Days.
If the request requirement exceeds the MaxActivityDays option limit, then the server returns this message:
Specified date range is too long for selected target. Please select different target or a shorter date range.
The default value is based on a typical customer configuration. You might need to adjust it, depending on your installed hardware, user work pattern, or if the server is too slow or short of memory when handling certain requests.
NoCallsServiceLevel
Type: Optional
Default Value: 0
Valid Values: 0, 100
Dependencies: None
Specifies whether the Performance window shows service level as 0% or 100% when there are no incoming interactions.
RecalculateForecastStaffing
Valid Value: boolean (yes, no, true, false, y, n, 0, 1)
Default Value: false
Specifies whether or not WFM Server recalculates deferred activity forecasted staffing. When this option is set to true, Server recalculates deferred activity forecasted staffing, based on the schedule, if there is one. When set to false, staffing is returned as saved in the WFM database.
ScheduleService Section
MaxAuditReports
Type: Optional
Default Value: None
Valid Values: Any positive integer
Dependencies: None
Specifies how many audit reports can be built at one time. The recommended value for this option is 1. If you request a greater number than is specified, the additional reports go into a queue.
SplitCoverage
Type: Optional
Default Value: true or 1
Valid Values: true or 1, false or 0
Dependencies: SplitMode and SplitMS options
Specifies whether schedule coverage should be reported in fractional units in views and reports which include this metric. The possible values are:
- false—Split coverage is not reported in fractional units, and the SplitMode option is ignored. For example, the agent is covering one activity per timestep.
- true—Split coverage is reported in fractional units, and the SplitMode option is applied. For example, if an agent is scheduled to cover three activities during a 15-minute interval, he will count 0.33 toward the coverage of each activity. The agent’s split coverage might not be always 0.33. It could be 0.2, 0.8, or any other percentage, depending on the forecast staffing requirement, but the sum is always equal to 1 for the 15-minute timestep.
SplitMode
Type: Optional
Default Value: 0
Valid Values: 0, 1, 2
Dependencies: SplitCoverage and SplitMS options
This option becomes affective only when the SplitCoverage option is set to true. The three possible values and their characteristics are as follows:
- 0—The coverage split is calculated when the schedule is built or modified, and is stored along with the schedule. This means that the coverage split does not change if you change the activity forecast staffing requirement after the schedule is built. (You would have to rebuild the schedule to have any effect on the coverage split.) Fractional coverage is not available for legacy schedules.
- 1—The coverage split is calculated when the schedule is built, and is stored along with the schedule. This setting is similar to SplitMode = 0. However, if you have a legacy schedule or a schedule created with SplitCoverage = false, there is no coverage split stored within the schedule. The fractional coverage is recalculated dynamically for that schedule only.
- 2—The coverage split is always calculated dynamically for all new and legacy schedules. If you change the activity forecast staffing requirement after the schedule is built, the coverage split is adjusted dynamically. This mode should not be used in production environments unless it is suggested by Genesys, because it could have severe performance impact on WFM Server operations
SplitMS
Type: Optional
Default Value: false
Valid Values: true, false
Dependencies: SplitMode and SplitCoverage. If SplitCoverage is false, then SplitMS is ignored.
Enables and disables multi-skill splitting of schedule coverage. When this option value is set to true in the WFM Web Application, the coverage split is dynamically adjusted to maximize multi-skill performance gain. It works on top of the obtained coverage.
AutoCleanupTimeout
Type: Optional
Default Value: 0 (disabled)
Valid Values: Any positive integer (minutes) or 0 (zero) (default; disables the option)
Dependencies: None
Enables WFM Server to perform automatic schedule cleanup for terminated agents, and specifies the time interval, in minutes, at which it does this. For example, setting the value to 60 specifies that WFM Server automatically cleans up the schedules of terminated agents every 60 minutes. Setting the value to 0 disables automatic schedule cleanup by WFM Server.
Special Handling for Terminated Agents
- The schedules of terminated agents will be deleted from the Master Schedule only for dates that occur on or after the agents' termination dates.
- Each running WFM Server cleans up terminated agent schedules only for those sites that are assigned to this particular server in the Organization > Sites > Properties section of the Configuration Utility. If the server has no specific sites assigned to it, it will clean up all sites when automatic cleanup is enabled.
MaxCacheSize
Type: Optional
Default Value: No default value
Valid Value: Any positive integer
Dependencies: None
Specifies the maximum size, in megabytes (MB), of the Schedule cache.
MinCacheSize
Type: Optional
Default Value: No default value
Valid Value: Any positive integer
Dependencies: None
Specifies the minimum size, in megabytes (MB), of the Schedule cache. The cache is preloaded up to the minimum size.
MaxScenarioCacheSize
Type: Optional
Default Value: No default value
Valid Value: Any positive integer
Dependencies: None
Specifies the maximum size, in megabytes (MB), of the Schedule Scenario cache.
CachePreloadDayChunks
Type: Optional
Default Value: No default value (null value means 14 days)
Valid Value: Any positive integer
Dependencies: MinCacheSize
Specifies the chunk of days to load when performing a schedule cache preload.
CachePreloadMaxDays
Type: Optional
Default Value: No default value (null value means 365 days)
Valid Value: Any positive integer
Dependencies: MinCacheSize
Specifies the number of days to preload starting from the current date. The preload stops if the MinCacheSize is reached.
CachePreloadTimeout
Type: Optional
Default Value: No default value (null value means 180 minutes)
Valid Value: Any positive integer
Dependencies: None
Specifies the time, in minutes, for preloading data in the cache. Data is preloaded up to the amount specified in MinCacheSize.
CacheLifespan
Type: Optional
Default Value: No default value (null value means the size is unlimited)
Valid Value: Any positive integer
Dependencies: None
Specifies the amount of time, in hours, that data remains in the Schedule cache without being accessed. After this duration, the data is dropped from the cache.
Server Section
MaxThreadPoolSize
Type: Mandatory
Default Value: 80
Valid Value: Any positive integer
Dependencies: None
Specifies the maximum number of threads in the thread pool.
MinThreadPoolSize
Type: Mandatory
Default Value: 8
Valid Value: Any positive integer
Dependencies: None
Specifies the minimum number of threads in the thread pool.
Proxy
Type: Optional
Default Value: No default value
Valid Value: <proxyservername>:<port>
Dependencies: None
Specifies a proxy server.
SessionTimeout
Type: Mandatory
Default Value: 10
Valid Value: Any positive integer
Dependencies: None
Specifies the timeout, in minutes, for any client session with this WFM Server.
ThreadPoolDownsizeTimeout
Type: Mandatory
Default Value: 15m (minutes)
Valid Value: Any positive integer.
Dependencies: None
Specifies how long a thread stays idle before it is removed from the thread pool. Follow the number with s (seconds) or m (minutes). By default, the value is in minutes.
ThreadPoolUpsizeTimeout
Type: Mandatory
Default Value: 10s (seconds)
Valid Value: Any positive integer
Dependencies: None
Specifies how long a request stays in queue before the thread pool size is increased. Follow the number with s (seconds) or m (minutes). By default, the value is in seconds.
VirtualDirectory
Type: Not applicable
Default Value: No default value
Valid Value: Not applicable
Dependencies: None
For future use.
Annex Tab Settings
From the Annex tab you can modify the default WFM Server configuration settings. The tab contains one sections. The options in each of these sections are described below.
security Section
require-authentication
Type: Optional
Default Value: true
Valid Value: true, false
Dependencies: None
Specifies whether authentication is (or is not) required for third-party connections to WFM Server. The default value true is in effect if this option is not defined.