Previous Topic: TUNE INDEX SyntaxNext Topic: Usage


TUNE INDEX Parameter

schema-name

Identifies the schema that will qualify the table name.

If omitted, the current session associated with the user session schema is used. Schema-name is required if there is no current session schema.

table-name

Identifies the table that is constrained by an indexed constraint.

ix-or-con-spec

Identifies constraints and indexes on the current table that is being tuned.

If omitted, all indexed constraints and indexes on the current table are processed.

sql-segment.area-name

Identifies an sql-defined area to be selected for processing.

All tables with indexed constraints in the area are processed.

dbname

Identifies the dbname to be used when binding the subschema.

ss-name

Identifies the subschema to be used for processing a non-SQL database.

set-name

Identifies the indexed sets within the subschema that are to be processed.

If omitted, all linked indexed sets defined in the subschema are processed. (Linked indexed sets are indexed sets with index pointers.)

cmt-interval

Specifies the commit interval. After every cmt-interval record read, a commit is issued. If omitted, the default interval is 100. If specified as zero (0), no commits are issued.

not-interval

Specifies the length of the notify interval in minutes. After each interval expires, a message is issued stating how far the job has progressed. If the notify interval is specified as 0 or allowed to default to 0, no notify messages are created.

constraint-name

Identifies an indexed constraint on the current table that is to be tuned.

index-name

Identifies an index on the current table that is to be tuned.

DEFAULT TUNE OPTIONS

The tune options to be used during the processing of an index if tune options have not been specifically specified.

REBALANCE

Specifies whether to rebalance the index. A well-balanced index has the minimum number of index levels and best performance if the index is frequently accessed vertically from top to bottom.

YES

Rebalances the index.

Note: Rebalancing an index can be resource-intensive.

NO

No rebalancing is done.

RESEQUENCE

Specifies whether to resequence the index. A properly sequenced index is important only if the index is frequently accessed sequentially at the bottom level.

YES

Resequences the index for optimum performance.

Note: Resequencing an index can be resource-intensive.

NO

No resequencing is done.

TEMPORARY INDEX UTILIZATION

Specifies a temporary override for the operation. If not specified, the current run-time value for INDEX BLOCK CONTAINS is used and index blocks are used at 100%.

ixutil-pct

Specifies the percentage of the maximum number of entries that each index block should contain after tuning is complete. ixutil-pct is an integer in the range 10 through 100. The number of entries of an index block is computed as index-block-contains * ixutil-pct / 100.

key-count

Specifies the maximum number of entries that each index block should contain after tuning is complete. key-count is an integer in the range 3 through 8180.

Note: If the specified value exceeds the current run-time value of the INDEX BLOCK CONTAINS, the key-count value is ignored and the INDEX BLOCK CONTAINS value will be used.

TEMPORARY PAGE RESERVE

Specifies a temporary override of the page reserve for the area in which the index resides. If not specified or specified as NULL, the page reserve of the area in which the index resides is used.

page-reserve-pct

Specifies the percentage of each page to leave as free space if it contains a portion of an index being tuned. page-reserve-pct is an integer in the range 0 through 30. The page reserve of the area is computed as area-page-size * page-reserve-pct / 100.

reserve-character-count

Specifies the number of characters to reserve on each page to accommodate increases in the length of records or rows stored on the page if it contains a portion of an index being tuned. reserve-character-count is an integer with a value not larger than 30% of the page size.