DMCHECKIN(5ICD)

NAME
dmCheckIn - terminate a DDM cell transaction

SYNOPSIS

#include "dmincl.h"
dmCheckIn (key, mode)
DM_CELL *key;
int mode;
dmCkinAll (mode)
int mode;

PARAMETERS
is a pointer to a valid DM_CELL as obtained from dmCheckOut(). is an integer selecting a specific behavior of dmCheckIn(). Valid modes as pre-defined in "dmincl.h" are:

COMPLETE -
The data at the 'scratch' node is 'flushed' to the database, and the key is destroyed. The transaction commits. The lock on the data is removed if there is one.
QUIT -
The data at the 'scratch' node is deleted, and the key is destroyed. The transaction rewinds. The lock on the data is removed if there is one.
CONTINUE -
The data at the 'scratch' node is 'flushed' to the database, but the key is not destroyed. The transaction continues. The lock on the data is not removed if there is one.

DESCRIPTION
Function dmCheckIn() terminates a DDM transaction initiated with dmCheckOut(), except when mode is CONTINUE. The precise actions depend upon the version parameter of dmCheckOut().

Function dmCkinAll() does dmCheckIn() for all existing keys.

FILES
view/celllist

DIAGNOSTICS
If properly executed, dmCheckIn() will return 0. If dmCheckIn() fails -1 will be returned, after a call to function dmError() is done, and dmerrno will be set to indicate the error.
This might happen in the following cases:

DME_BADKEY
    No valid cell key given.

DME_BADARG
    Invalid argument. The mode is not one of above.

DME_SYS
    System error.

SEE ALSO
dmCheckOut(5ICD).