Copyright © Cloud Software Group, Inc. All Rights Reserved
Copyright © Cloud Software Group, Inc. All Rights Reserved


Chapter 6 Administering Process Attributes : WIS and WQS Process Configuration : WQS_WIS_USER_COUNT

WQS_WIS_USER_COUNT
WIS and WQS Process Configuration
Summary
This attribute defines the number of WIS processes that should be dedicated to handling user queues and group queues respectively.
Applies To
The attribute can be set for the WQS process.
Permissible Values
The attribute value must be a string, and can be either:
a number, indicating the number of WIS processes that should be dedicated to handling user queues. For example:
"2"
a percentage in the range 1% to 99%, indicating the percentage of WIS processes that should be dedicated to handling user queues. For example:
"20%"
Default Value
This attribute is not defined on a newly installed iProcess Engine. In this case (or if the attribute is defined incorrectly), queues are allocated to WIS processes alphabetically, irrespective of whether they are user or group queues (either by round robin or on-demand allocation - see WQS_ROUND_ROBIN on page 49).
Notes
The remaining WIS processes will be dedicated to handling group queues. Note that:
There must always be at least one WIS available to handle user queues and one WIS to handle group queues if the attribute is defined. The attribute value should be set accordingly.
If a percentage value is used, iProcess will round this figure down, subject to there being at least one WIS available to handle user queues. For example, the following table shows how different WQS_WIS_USER_COUNT values are interpreted, depending on the number of available WIS processes.
If there are not enough WIS processes configured to create the specified allocation, the WQS_WIS_USER_COUNT value is ignored, default queue allocation is used, and one of the following messages is written to the sw_warn file:
      WQS_WIS_USER_COUNT ignored - too big
or
      WQS_WIS_USER_COUNT ignored - percentage too big
For example, if there are 5 WIS processes configured, the following WQS_WIS_USER_COUNT values would all generate an error as described:
"0" "0%" "5" "6" "100%" "150%"
WIS processes can also be dedicated to handling explicitly specified queues - see Assigning a Queue Explicitly to a WIS Process. Dedicated queues are not considered when calculating the allocation of WIS processes to user queue or group queue pools.
The following table shows how the allocations described in the example above would be affected if one of the WIS processes was subsequently dedicated to handling a specific queue. (The values in bold font show the changes.)

Copyright © Cloud Software Group, Inc. All Rights Reserved
Copyright © Cloud Software Group, Inc. All Rights Reserved