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.

AIX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsWindows operating systems

Supported Clients

This option is valid for all clients.

Options File

AIX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsPlace 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.

Windows operating systemsPlace 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.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-TXNBytelimit-- --number-------------------------------------><

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.