Txnbytelimit
The txnbytelimit option specifies the number of kilobytes the client program buffers before it sends a transaction to the server.
A transaction is the unit of work exchanged between the client and server. A transaction can contain more than one file or directory, called a transaction group.
You can control the amount of data sent between the client and server, before the server commits the data and changes to the server database, using the txnbytelimit option. Controlling the amount of data sent changes the speed of the client to perform the transactions. The amount of data sent applies when files are batched together during backup or when receiving files from the server during a restore procedure.
After the txngroupmax number is reached, the client sends the files to the server, even if the transaction byte limit is not reached.
Supported Clients
This option is valid for all clients.
Options File
Place this option in the client system-options file (dsm.sys) within a server stanza. You can set this option on the General tab, in the Transaction Buffer Size field in the Preferences editor.
Place this option in the client options file (dsm.opt). You can set this option on the General tab, in the Transaction Buffer Size field in the Preferences editor.
Parameters
- number
- Specifies the number of kilobytes the client program sends to
the server before committing the transaction. The range of values
is 300 through 34359738368 (32 GB). The default is 25600 KB. The number
can be specified as an integer or as an integer with one of the following
unit qualifiers:
- K or k (kilobytes)
- M or m (megabytes)
- G or g (gigabytes)
If no unit qualifier is specified, the integer is in kilobytes.
Restriction: The txnbytelimit option does not support decimal numbers, and only one-unit letters are allowed. For example: K, M, or G.
Examples
- Options file:
- txnb 25600
- txnb 2097152
- txnb 2097152k
- txnb 2048m
- txnb 2g
- txnb 32G
- Command line:
- -txnb=25600
- -txnb=16G
This option is valid only on the initial command line. It is not valid in interactive mode.