M100638: Registry settings for batched transfers

Distribution jobs can be batched for distribution throughout your distribution hierarchy, which can provide performance advantages.

A registry setting, BatchedTransfers, specifies whether or not batching is to occur. A second registry setting, MaxBatchSize, specifies how many distribution jobs should be batched. This knowledge base article describes these two registry settings.

Distribution jobs can be batched for distribution throughout your distribution hierarchy, which can provide performance advantages. A registry setting, BatchedTransfers, specifies whether or not batching is to occur. A second registry setting, MaxBatchSize, specifies how many distribution jobs should be batched.

The maximum size of batched job file that can be handled by distribution servers is 1MB. If batched job files exceed this size, the following errors appear in wh_replag.log or ds_replag.log files (the log files for the ManageSoft replication agent, on warehouse and distribution servers respectively):

[<date> <time&g; (N, 0)] {4360} PRE: Sending 1278079 bytes (data = 0x2dd0020)
[<date> <time&g; (N, 0)] {4360} POST: FAILED Error sending 1278079 bytes )

The size of batched job files varies according to the number of jobs batched and the configuration of your distribution hierarchy. If the size of batched job files is greater than 1MB, set MaxBatchSize to a lower value. (In consultation with your ManageSoft support representative, you might also turn off batching (BatchedTransfers=false).)

BatchedTransfers

Specify whether or not distribution jobs are to be batched. If using batched transfers, be aware that the maximum file size of batched jobs that distribution servers can handle is 1 MB. The size of generated batched job files varies according to the number of jobs to be performed and the shape of your distribution hierarchy. If failures occur because the size of generated batched job files exceeds 1MB, set MaxBatchSize to a smaller value.       

Registry

MaxBatchSize

Specify the maximum number of jobs that a distribution server will send to its children when using batched transfers. Set to 0 to remove the limit.

Use this setting to limit the size of batched job files. The size of generated batched job files varies according to the number of jobs to be performed and the shape of your distribution hierarchy, but the maximum file size of batched jobs that distribution servers can handle is 1 MB. If failures occur because the size of generated batched job files exceeds 1MB, set MaxBatchSize to a smaller value.     

Registry