18.2 Optimizing 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. Message handler threads deliver messages to users mailboxes. The default number of message handler threads is 6; valid values range from 1 to 20. The default value of 6 is appropriate for a multipurpose POA. The maximum value of 20 is appropriate for a POA that has been customized to process only message files.

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

To adjust the number of POA message handler threads:

  1. In the GroupWise Admin console, browse to and click the POA.

  2. Click the Agent Settings tab and locate the Message Processing section.

  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. The more message handler threads the POA uses, the more incoming messages it can process simultaneously. However, the more threads the POA uses, the fewer threads are available to other processes running on the same server.

  4. Click Save, then click Close to return to the main Admin console window.

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

POA Console: The Status page helps you assess whether the POA is currently meeting the message file processing needs of the post office. Under the Thread Status heading, click Message Worker Threads to display the workload and status of the message handler threads.

If the POA console is password protected as described in Section 16.1, Configuring the POA Console, you can change the number of message handler threads on the Configuration page. Under Performance Settings, click Message Worker Threads.