Configuring thread pool properties: Core Pool Size, Keep Alive Time, and Queue Size

Thread pool properties for Infor Process Automation are Configuration Parameter records stored in the gen environment data area and can be configured per data area.

Note: In earlier versions of Infor Process Automation, the Core Pool Size, Keep Alive Time, and Queue Size properties were Grid properties that were added, changed, and deleted using the Grid UI.

The system provides default values for the thread pool properties. To change these defaults, you must add Configuration Parameter records to define new values. Configuration Parameters can be changed or deleted as needed. When these configuration parameters are added, changed, or deleted, the Infor Process Automation node or nodes processing the specified data areas must be restarted in order for changes to take effect.

Most customers are still advised to have one dedicated Infor Process Automation node per data area, but if you wish to have one node service multiple data areas, you can. If there is more than one node servicing a given data area, the Configuration Parameter records will apply to all those Grid nodes. For example, if there are two IPA nodes servicing data area "prod", both nodes will share the settings chosen for Core Pool Size, Keep Alive Time, and Queue Size for the "prod" data area.

The Core Pool Size controls how many workunits will be processed in parallel. Increasing this number can increase performance because workunits will be completed faster. The default value is 2. This number can be increased depending on the design of your processes, other programs running on your servers, and your server hardware resources. A number to start testing with is the number of cores available to this data area.

  1. Access the web UI. Select the gen data area and search for ConfigurationParameter.

    Alternatively, select Start > Data > la > Business Classes > ConfigurationParameter.

  2. If ipa configuration parameters already exist, you can edit them. If not, the system is using default values. You must create parameter records to override the default values.
  3. On Configuration Parameters List, select Actions > Create.
  4. Create one record for each parameter you want to configure: Core Pool Size, Keep Alive Time, and Queue Size.
    On the Configuration Parameter screen, specify the Component, Name, and Value. You can leave Type, Length, and Precision fields blank
    Component Name Value
    ipa

    dispatcher.CorePoolSize.env-da-name.app-da-name

    Example:

    dispatcher.CorePoolSize.gen.prod

    Default value: 2

    The maximum number of work unit processing threads for data area app-da-name. Change this value as needed to ensure efficient running of the system in conjunction with resources needed by other systems.

    If a thread is idle for the time specified by dispatcher.KeepAliveTime, the thread will be purged.
    ipa

    dispatcher.KeepAliveTime.env-da-name.app-da-name

    Example:

    dispatcher.KeepAliveTime.gen.prod

    Default value: 300

    Time in seconds to keep the thread alive in the pool when a thread is idle.
    ipa

    dispatcher.QueueSize.env-da-name.app-da-name

    Example:

    dispatcher.QueueSize.gen.prod

    Default value: -1 (-1 indicates no limit)

    The size of the queue for workunits or Inbasket actions waiting for a thread.

    env-da-name is the environment data area name. It should be specified in lowercase. In a single tenant scenario, this will always be gen".

    app-da-name is the application data area name. It should be specified in lowercase.

  5. Restart the Infor Process Automation node or nodes processing the data areas in Grid Management.