Replication Distribution Agent Utility
The Replication Distribution Agent utility configures and begins the Distribution Agent, which moves the snapshot (for snapshot replication and transactional replication) held in the distribution database tables (for transactional replication) to the destination tables at the Subscribers.
[-SkipErrors native_error_id [:...n]]
Note Parameters can be specified in any order. When optional parameters are not specified, values from predefined registry settings on the local computer are used.
Prints all available parameters.
Is the name of the Publisher. Specify server_name for the default instance of Microsoft® SQL Server™ 2000 on that server. Specify server_name\instance_name for a named instance of SQL Server 2000 on that server.
Is the name of the Publisher database.
Is the name of the Subscriber. Specify server_name for the default instance of SQL Server 2000 on that server. Specify server_name\instance_name for a named instance of SQL Server 2000 on that server.
Is the path to the folder that contains the initial snapshot for a subscription.
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.
Is the number of buffers available for asynchronous transactions. The default is 2. Increasing the number of buffers can increase performance because doing so reduces memory paging; however, a larger number of buffers also increases the amount of memory reserved for paging. Evaluate performance by seeing how a change in buffer values affects the speed of the connections between Subscriber and Distributor.
Is the number of transactions to be issued to the Subscriber before a COMMIT statement is issued. The default is 100.
Is the number of replication commands to be issued to the Subscriber before a COMMIT statement is issued. The default is 1000.
Specifies whether the agent attempts to poll replicated transactions continually. If specified, the agent polls replicated transactions from the source at polling intervals, even if there are no transactions pending.
Is the path of the agent definition file. An agent definition file contains command prompt arguments for the agent. The content of the file is parsed as an executable file. Use double quotation marks (") to specify argument values containing arbitrary characters.
Is the Distributor name. For Distributor (push) distribution, the name defaults to the name of the local Distributor.
Is the network connection string for the Net-Library defined in the DistributorNetwork option. If the DistributorNetwork option is the TCP/IP Sockets Net-Library, then the connection string is in the form of
For more information about the format, see Network Protocols. This option is useful for configuring connections over the Internet.
Is the Distributor login name.
Is the Net-Library to use when connecting to the Distributor. This option is useful when configuring the Distribution Agent to connect to a Distributor over the Internet.
Is the Distributor password.
Specifies the security mode of the Distributor. A value of 0 indicates SQL Server Authentication Mode (default), and a value of 1 indicates Windows Authentication Mode.
Is the path and file name of the error file generated by the Distribution Agent. This file is generated at any point where failure occurred while applying replication transactions at the Subscriber. This file contains the failed replication transactions and associated error messages. When not specified, the error file is generated in the current directory of the Distribution Agent. The error file name is the name of the Distribution Agent with an .err extension. If the specified file name exists, error messages are appended to the file.
Specifies the file transfer type. A value of 0 indicates UNC (universal naming convention), and a value of 1 indicates FTP (file transfer protocol).
Is the network address of the FTP service for the Distributor. When not specified, DistributorAddress is used. If DistributorAddress is not specified, Distributor is used.
Is the user password used to connect to the FTP service.
Is the port number of the FTP service for the Distributor. When not specified, the default port number for FTP service (21) is used.
Is the user name used to connect to the FTP service. When not specified, anonymous is used.
Specifies the amount of history logged during a distribution operation. You can minimize the effect of history logging on performance by selecting 1.
|HistoryVerboseLevel value|| |
|1||Default. Always update a previous history message of the same status (startup, progress, success, and so on). 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.|
Is the host name used when connecting to the Publisher.
Is the number of seconds before the history thread checks if any of the existing connections is waiting for a response from the server. This value can be increased to avoid having the checkup agent mark the Distribution Agent as suspect when executing a long-running batch. The default is 300 seconds.
Is the number of seconds before the login times out. The default is 15 seconds.
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 0 and has no hard-coded upper limit. The default is 1. When applying a snapshot that was generated at the Publisher using the concurrent snapshot option, one thread is used, regardless of the number you specify for MaxBcpThreads.
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.
Is the time interval used for history logging. A history event is logged when one of these parameters is reached:
- The TransactionsPerHistory value is reached after the last history event is logged.
- The MessageInterval value is reached after the last history event is logged.
If there is no replicated transaction available at the source, the agent reports a no-transaction message to the Distributor. This option specifies how long the agent waits before reporting another no-transaction message. Agents always report a no-transaction message when they detect that there are no transactions available at the source after previously processing replicated transactions. The default is 60 seconds.
Is the path of the agent output file. If the file name is not provided, the output is sent to the console. If the specified file name exists, the output is appended to the file.
Specifies whether the output should be verbose. If the verbose level is 0, only error messages are printed. If the verbose level is 1, all the progress report messages are printed. If the verbose level is 2 (default), all error messages and progress report messages are printed, which is useful for debugging.
Is the packet size, in bytes. The default is 4096 (bytes).
Is how often, in seconds, the distribution database is queried for replicated transactions. The default is 1 second.
Specifies an agent profile to use for agent parameters. If ProfileName is NULL, the agent profile is disabled. If ProfileName is not specified, the default profile for the agent type is used.
Is the name of the publication. This parameter is only valid if the publication is set to always have a snapshot available for new or reinitialized subscriptions.
Is the number of seconds before the query times out. The default is 300 seconds.
Specifies the quoted identifier character to use. The first character of the value indicates the value the Distribution Agent uses. If QuotedIdentifier is used with no value, the Distribution Agent uses a space. If QuotedIdentifier is not used, the Distribution Agent uses whatever quoted identifier the Subscriber supports.
-SkipErrors native_error_id [:...n]
Is a colon-separated list that specifies the error numbers to be skipped by this agent. For more information, see the section Skipping Errors in Transactional Replication in Handling Agent Errors.
Is the path to the Jet database (.mdb file) if SubscriberType is 2 (allows a connection to a Jet database without an ODBC Data Source Name (DSN)).
Is the name of the Subscriber database.
Is the Subscriber login name. If SubscriberSecurityMode is 0 (for SQL Server Authentication), this parameter must be specified.
Is the Subscriber password. If SubscriberSecurityMode is 0 (for SQL Server Authentication), this parameter must be specified.
Specifies the security mode of the Subscriber. A value of 0 indicates SQL Server Authentication (default), and a value of 1 indicates Windows Authentication Mode.
Specifies the type of Subscriber connection used by the Distribution Agent.
|0||Microsoft SQL Server|
|1||ODBC data source|
|2||Jet database (direct connection)|
|3||OLE DB data source|
Is the name of the subscription table generated or used at the given Subscriber. When not specified, the MSreplication_subscription table is used. Use this option for database management systems (DBMS) that do not support long file names.
Specifies the subscription type for distribution. A value of 0 indicates a push subscription, a value of 1 indicates a pull subscription, and a value of 2 indicates an anonymous subscription.
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, a history message is logged. The default is 100. A value of 0 indicates infinite TransactionsPerHistory. See the preceding –MessageInterval parameter.
Must be specified as a parameter for a publication that allows data transformation.
Improves the performance of the initial snapshot by causing the Distribution Agent to use the BULK INSERT command when applying snapshot files to the Subscriber.