Product Documentation

FairCom ISAM for C

Previous Topic

Next Topic

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 FairCom DB Error Codes for a complete listing of valid FairCom DB error values.

See also

TransactionHistory, FreeHistory

TOCIndex