NAME

tisam_interface_t - specifies the mode in which T-ISAM is to be used

SYNOPSIS

typedef enum{
TISAM_COMPATIBILITY_MODE,
TISAM_STANDARD_MODE,
TISAM_GET_ENV_MODE
} tisam_interface_t;

DESCRIPTION

The tisam_interface_t data type is used by the tisam_Initialize function to specify how the T-ISAM interface is to be used. 

The value TISAM_COMPATIBILITY_MODE means that the following rules apply to the T-ISAM interface:

The application can use the C-ISAM functions. It can use the following functions for beginning and ending local transactions:

isbegin

iscommit

isrollback

The di_nkeys field will have the high bit set for files that support variable length records on return from isindexinfo. 

Use of isrewcurr will not change the current record position to reflect the new value of the updated record. Instead, the record position remains the same. 

The value TISAM_STANDARD_MODE means that the following rules apply to the T-ISAM interface:

The application can use Encina Toolkit and Encina Monitor functions for beginning and ending transactions. 

The application must not make any C-ISAM specific function calls.  None of the following functions can be called:

isbegin

iscommit

isrollback

iscluster

islogclose

islogopen

The value TISAM_GET_ENV_MODE means the interface is initialized using the mode specified in the ENCINA_TISAM_MODE environment variable.  If ENCINA_TISAM_MODE is not set in the environment, the interface is automatically initialized in theTISAM_COMPATIBILITY_MODE. 

The ENOTCOMP or ENOTSTD error will result if these restrictions are not followed. 

RELATED INFORMATION

Encina SFS Programming Guide

isbegin

iscommit

isrollback

tisam_Initialize

  —  March 1997