Server_Num_Threads

This option is deprecated in release 6.7. We have retained its old behavior for backward compatibility, however, setting it triggers a warning. This option will be removed in a future release. Release 6.7 introduces four new options that supersede this option: Multi_Threaded_Mode Server_Threads Client_Threads Server_Connection_Names If any of these are set, they override the value of Server_Num_Threads. For important background information, see Multi-Thread Mode.

The Server_Num_Threads option specifies how many threads should be used in a multi-thread session with RTserver. The default value is 1, which is a single-thread model and is the default mode for RTserver. Although the server does not enforce a maximum value, we advise caution when using large values; larger values do not necessarily result in better performance.

The optimal number of threads depends on the operational parameters of your deployment, such as the number of processors, the subject namespace, message fan-out characteristics, message rate, disk I/O rate, compression, the number of RTserver-to-RTclient connections, and the number of RTserver-to-RTserver connections (cloud configuration).

We recommend that you empirically determine the optimal value of this option for your deployment. We suggest that you begin tuning with the values in Table 19, and adjust them based on the results of your testing. We caution that the optimal value of this option can change significantly when the operational parameters of your deployment vary; when they do change, we strongly recommend that you re-test to determine the best value for this option.

To run in multi-thread mode, your RTserver must be licensed for the SmartSockets MP option for the RTserver and specify a number of threads greater than 1 for the Server_Num_Threads option. If you specify a number greater than 1 and you do not have a SmartSockets MP license for that RTserver, you receive a warning message when the RTserver is started and it is started in single-thread mode. The Server_Num_Threads option is not available on all platforms. If you specify a number greater than 1 on a platform where Server_Num_Threads is not available, you receive an warning message when the RTserver is started; RTserver then starts in single-thread mode.