CTRecord.InsertBatch
Inserts a new record into a batch buffer.
Declaration
void CTRecord.InsertBatch();
Description
Inserts a new record into an internally maintained batch buffer. When the batch buffer fills up, the group of records stored in the batch buffer are inserted into the table. If CTRecord.EndBatch() is called and the batch buffer still contains records, a new insert record operation is performed for the remaining records before the batch operation is terminated.
For transaction controlled files, the batch insertion operation is treated as one all or nothing operation. If no explicit transaction is started, each insertion of records with will start and end its own transaction. Even if an explicit transaction is started, each insertion operation is treated independently through safe points.
Note: Currently, all record insertion operations do not perform any conversion of records images, key values, and record position for heterogeneous client/server implementations.
The following steps must be taken to perform a batch insert record operation:
For each record to be inserted perform the following operations:
In case of errors, CTRecord.InsertBatch() throws a CTException.
Return
void
See Also
CTRecord.BatchLocked(), CTRecord.BatchMode(), CTRecord.EndBatch(), CTRecord.IsBatchActive(), CTRecord.NextBatch(), CTRecord.SetBatch(), CTRecord.BatchLoaded, CTRecord.BatchTotal