F.14 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 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.

EXAMPLE

See the example for OpenISAMContext.

SEE ALSO

CloseISAMContext and OpenISAMContext.