Set the toss limit for the specified table.

Syntax

proutil db-name -C settabletosslimit table-name toss-limit
   [ tenant tenant-name| group group-name|
        partition partition-name | composite initial]

Parameters

db-name
Specifies the database where you are setting the toss limit.
table-name
Specifies the table where you are setting the toss limit.
toss-limit
Specifies the new toss limit.
tenant tenant-name
Specifies that the table toss limit is to be set on the table partition that is associated with tenant-name. If tenant-name is not valid, is part of a group, or is not associated with a partition of the table, SETTABLETOSSLIMIT exits with an error. Specifying tenant is only allowed on databases enabled for multi-tenancy.
group group-name
Specifies that the table toss limit is to be set on the table partition that is associated with group-name. If group-name is not valid or is not associated with a partition of the table, SETTABLETOSSLIMIT exits with an error. Specifying group is only allowed on databases enabled for multi-tenancy.
partition partition-name
Specifies that the table toss limit is to be set on the table partition partition-name. If partition-name is not valid or is not associated with the specified table, SETABLETOSSLIMIT exits with an error. Specifying partition is only allowed on databases enabled for table partitioning.
composite initial
Specifies that the table toss limit is to be set on the composite initial partition of the specified table. If table-name is not a partitioned table, SETTABLETOSSLIMIT exits with an error. Specifying composite initial is only allowed on databases enabled for table partitioning.

Notes

  • For a Type II area, SETTABLETOSSLIMIT sets the table toss limit for the specified table. For a Type I area, SETTABLETOSSLIMIT issues a warning that all tables and LOBs in an area must have the same toss limit, and prompts you to confirm setting the toss limit for all tables and LOBs in the area containing the specified table.
  • The toss limit value must be greater than zero (0) and less than the block size minus 128 bytes.
  • For databases with a 1K block size, the default create limit is 150. For all other database block sizes, the default create limit is 300.
  • For databases enabled for table partitioning, if the specified table-name is a partitioned table, but partition or composite initial is not specified, then the toss limit is set for all partitions of the table.
  • For more information on setting toss limits, see Database fragmentation.