Open topic with navigation

TIBCO iProcess® Engine 11.10.0

# 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).

## 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.

Value | Number of WIS processes | Resulting allocation for:
User queues | Group queues
"20%" | 5 | 1 | 4
"50%" | 5 | 2 | 3
"50%" | 6 | 3 | 3
"90%" | 5 | 4 | 1
"90%" | 20 | 18 | 2
"10%" | 5 | 1 | 4

| • | 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.)

Value | Number of non-dedicated WIS processes | Resulting allocation for:
User queues | Group queues
"20%" | 4 | 1 | 3
"50%" | 4 | 2 | 2
"50%" | 5 | 2 | 3
"90%" | 4 | 3 | 1
"90%" | 19 | 17 | 2
"10%" | 4 | 1 | 3

Did you find this helpful?

Yes No
Great!
Thanks for taking the time to give us some feedback.
Sorry about that

Why wasn't this helpful? (check all that apply)

Could not find what I was looking for
Instructions confusing or unclear
Instructions did not work

Want to tell us more?

Please select at least one option or provide details about the issue!!

Error occurred while submitting feedback.

Error2 occurred while submitting feedback.

TIBCO iProcess® Engine

Copyright © 1994-2025. Cloud Software Group, Inc. All Rights Reserved.