Adjusting the Number of POA Threads for Message File Processing

If the POA is configured for message file processing, it starts the number of threads specified by the Message Handler Threads option. Each thread can perform any POA function (except client/server processing, of course). Although the threads are started from the same program, each thread operates independently of the others. For example, one thread might be processing a message, while another thread might be polling the input queue directories in the post office, and another thread might be idle. The default number of message handler threads is 8; valid values range from 1 to 30.

The more message threads the POA uses, the faster it can process messages. However, the more threads the POA uses, the fewer resources are available to other processes running on the machine.

To adjust the number of POA message handler threads:

  1. In ConsoleOne, browse to and right-click the POA object > click Properties.

  2. Click GroupWise > Agent Settings to display the Agent Settings page.


    Agent Settings property page

  3. Increase the number in the Message Handler Threads field.

    For example, you could increase the number of threads in increments of three to five threads until acceptable throughput is reached. The optimum number of threads for a POA is affected by many factors, including available system resources.

  4. Click OK to save the new thread setting.

    ConsoleOne then notifies the POA to restart so the new setting can be put into effect.

Corresponding Startup Switches
You could also use the /threads switch in the POA startup file to adjust the number of message handler threads.