|
Purpose |
Retrieves records after a commit failure | |
|
Old name |
#define retrieve rec_retrieve | |
|
Syntax (CCOWN) |
BOOLEAN rec_retrieve(short *datarec) | |
|
Syntax (DP4DBAPI) |
BOOLEAN dp4_rec_retrieve(DCONN * dconn,short *datarec) | |
|
Parameters |
DCONN * dconn |
Handle to an open database connection |
|
|
short* datarec |
Pointer to the L field of a database record |
|
Description |
After an unsuccessful call to the function db_commit(), the contents of the workfile may be recovered by calling the function rec_retrieve(). This function can only be used if the RETRIEVE_ENABLE flag was passed to the db_open() function originally. Each call to the function rec_retrieve() returns a record that was originally posted from the address of the data record specified. The return value is TRUE if such a record is found and FALSE if there are no more matching records in the workfile. In the CCOWN implementation the value returned by the function is stored in the global variable there. | |