F.13 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 Appendix A "c-tree Plus Error Codes" of the c-tree Plus Programmer's Reference Guide for a complete listing of valid c-tree Plus error values.

SEE ALSO

TransactionHistory and FreeHistory.