Distribution Agent Profile

A default profile for the Distribution Agent is installed when a server is configured as a Distributor. The default profile contains the following parameters and values.

Parameter Default value Description
-BcpBatchSize 100000 Is the number of rows to send in a bulk copy operation. When performing a bcp in operation, the batch size is the number of rows to send to the server as one transaction, and also the number of rows that must be sent before the Distribution Agent logs a bcp progress message. When performing a bcp out operation, a fixed batch size of 1000 is used. A value of 0 indicates no message logging.
-CommitBatchSize 100 Is the number of transactions to be issued to the Subscriber before a COMMIT statement is issued.
-CommitBatchThreshold 1000 Is the number of replication commands to be issued to the Subscriber before a COMMIT statement is issued.
-HistoryVerboseLevel 2 Specifies the amount of history logged during a distribution operation. Can be:

1 = Always update a previous history message of the same status (startup, progress, success, and so forth). If no previous record with the same status exists, insert a new record.

2 = Insert new history records unless the record is for such things as idle messages or long-running job messages, in which case update the previous records.

3 = Always insert new records, unless it is for  idle messages.

You can minimize the performance effect of history logging by selecting 1.

-LoginTimeOut 15. Is the number of seconds before the login attempted by the agent times out.
-MaxBcpThreads 1 Specifies the number of bulk copy operations that can be performed in parallel. The maximum number of threads and ODBC connections that exist simultaneously is the lesser of MaxBcpThreads or the number of bulk copy requests that appear in the synchronization transaction in the distribution database. MaxBcpThreads must have a value greater than zero, and has no hard-coded upper limit.
-MaxDeliveredTransactions 0 Is the maximum number of push or pull transactions applied to Subscribers in one synchronization. A value of 0 indicates that the maximum is an infinite number of transactions. Other values can be used by Subscribers to shorten the duration of a synchronization being pulled from a Publisher.
-PollingInterval 10 Is how often, in seconds, the distribution database is queried for replicated transactions.
-QueryTimeOut 300 Is the number of seconds before the queries issued by the agent time out.
-TransactionsPerHistory 100 Specifies the transaction interval for history logging. If the number of committed transactions after the last instance of history logging is greater than this option, then a history message is logged. A value of 0 indicates infinite TransactionsPerHistory.

See Also
Replication Distribution Agent Utility  

  


(c) 1988-98 Microsoft Corporation. All Rights Reserved.