ChangeHistory

Change current history buffer.

Short Name

CHGHST()

Type

ISAM function

Declaration

COUNT ChangeHistory(COUNT hstnum)

Description

ChangeHistory() is called before each use of TransactionHistory() when multiple history buffers are in use at the same time. As a new history area is needed, simply call ChangeHistory() with a unique hstnum.

Changing between active history buffers is accomplished by passing the desired hstnum value. hstnum values do not need to be consecutive and can be positive or negative values up to 32,767.

Return

Value	Symbolic Constant	Explanation
0	NO_ERROR	Successful set change.
185	ISAL_ERR	No memory available for history buffers.

See c-tree Plus Error Codes for a complete listing of valid c-tree Plus error values.