The configuration section defines properties of the MSMQ transport. Read background on MSMQ.
Beginning with NServiceBus V3, use the configuration section to declare an error queue:
<section name="MessageForwardingInCaseOfFaultConfig" type="NServiceBus.Config.MessageForwardingInCaseOfFaultConfig, NServiceBus.Core" />
To define the value:
<MsmqTransportConfig ErrorQueue="error" NumberOfWorkerThreads="1" MaxRetries="5"/>
MsmqTransportConfig is for compatibility with earlier versions.
ErrorQueue defines the name of the queue to which messages are transferred if they cannot be processed successfully. This may be a queue on the local machine or on a remote machine, in which case the value should be based on the template
queueName is the name of the error queue (often "error") and
"remoteMachineName" is the name of the remote machine on which the error queue resides.
If no error queue is defined, NServiceBus fails to start with the exception: "Could not find backup configuration section 'MsmqTransportConfig' in order to locate the error queue."
Read more about messages whose processing fails.
This property dictates the number of threads that receive messages from the input queue. This property has no impact on the number of threads that can use the bus to send or publish messages.
This property is related to the
ErrorQueue property, defining the number of times to retry a message whose processing fails before it is moved to the error queue.
Default value: 5.
The MsmqTransportConfig configuration section became obsolete in V4.0. Use the TransportConfig section instead:
<?xml version="1.0" encoding="utf-8" ?> <configuration> <configSections> <section name="MessageForwardingInCaseOfFaultConfig" type="NServiceBus.Config.MessageForwardingInCaseOfFaultConfig, NServiceBus.Core" /> <section name="TransportConfig" type="NServiceBus.Config.TransportConfig, NServiceBus.Core"/> </configSections> <MessageForwardingInCaseOfFaultConfig ErrorQueue="error"/> <TransportConfig MaximumConcurrencyLevel="5" MaxRetries="2" MaximumMessageThroughputPerSecond="0"/> </configuration>
MaximumConcurrencyLevel - The same as the
NumberOfWorkerThreads property in
MaximumMessageThroughputPerSecond - Sets a limit on how quickly messages can be processed between all threads. Use a value of 0 to have no throughput limit.
MaxRetries - Sets the First Level Retries (FLR) value that defines the number of times to retry a message whose processing fails before it is moved to the error queue, or, if configured, before the Second Level Retries (SLR) engine kicks in. The default value is 5.
Last modified 2014-08-17 08:12:25Z