Skip to main content

Configuring Work Queue Manager Categories

The Work Queue Manager enables you to distribute work to multiple concurrent processes programmatically in order to improve performance. For more information, see Using the Work Queue Manager.

When your code initializes a set of worker jobs using the Work Queue Manager, that code can specify the category that supplies the worker jobs. A category is an independent pool of workers with its own maximum of workers.

The system supplies two categories that you cannot delete: Default and SQL. By default, the maximum number of workers for these categories is Dynamic, which is equivalent to twice the number of cores available to your system.

The Work Queue Manager Categories page enables you to create, modify, and delete categories as described in the following sections. Any changes that you make are reflected in the configuration parameter file, iris.cpf.

Creating a Work Queue Manager Category

From the Work Queue Manager Categories page, you can create new categories.

Category names must be unique and are case sensitive. Additionally, category names can include only letters, numbers, dashes, underscores, and periods, and have a maximum of 64 characters.

To create a new category, do the following:

  1. Navigate to System Administration > Configuration > System Configuration > WQM Categories.

  2. Click Create Category.

  3. In the Category name field, type a name for the category.

  4. In the Max active workers field, select the maximum number of active worker jobs kept in the pool of jobs that service requests in this category. InterSystems IRIS detects idle jobs and automatically starts new jobs to keep the maximum active job number around this limit. By default, InterSystems IRIS dynamically adjusts this limit based on system resources, up to a maximum of 16 workers.

  5. In the Default workers field, select the default number of worker jobs assigned to a work group, when a work group in this category is created and no worker job count is specified. By default, InterSystems IRIS dynamically adjusts this value based on system resources, up to a maximum of 8 workers.

  6. In the Max workers field, select the maximum number of worker jobs kept in the pool of jobs servicing requests in this category. If the number of jobs requested by a work group in this category is greater than this limit, then InterSystems IRIS provides workers only up to this maximum value. By default, InterSystems IRIS dynamically adjusts this value based on system resources, up to a maximum of 16 workers.

Editing or Deleting a Work Queue Manager Category

From the Work Queue Manager Categories page, you can modify the maximum number of workers for an existing category and delete user-specified categories as follows:

  1. Navigate to System Administration > Configuration > System Configuration > WQM Categories.

  2. Click Edit or Delete for the relevant category.

FeedbackOpens in a new tab