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 you initialize a set of worker jobs using the work queue manager, you can specify the category that supplies the worker jobs. A category is an independent pool of workers. For example, suppose that you assign a maximum of eight workers to the SQL category supplied by the system. Then, suppose that you create a category for processes related to building DeepSee dashboards, and assign a maximum of four workers to that category. If all the workers in the SQL pool are engaged at a given time, the workers in the DeepSee category may still be available to process work items immediately.

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 work queue manager 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 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.

Feedback