ChangeISAMContext

Change current ISAM context.

Short Name

CHGICON()

Type

ISAM function

Declaration

COUNT ChangeISAMContext(COUNT contextid)

Description

ChangeISAMContext() accepts the context ID returned as the result of a successful call to OpenISAMContext(). If ChangeISAMContext() is successful, the current ISAM position for the data file associated with the context ID is:

Saved in the context ID active just prior to the call to ChangeISAMContext().
Changed to the position stored in the selected context ID.

If the context ID passed to ChangeISAMContext() is the current context for the associated data file, ChangeISAMContext() has no effect.

Return

Value	Symbolic Constant	Explanation
0	NO_ERROR	Successful change.
590	NCON_ERR	Non-existent context ID.

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

Example

See the example for OpenISAMContext().