Synopsis:

       db_rls(rec_handle)

Arguments:

       rec_handle - The record handle returned from db_get() or db_append()

Description:   This function releases a record handle obtained by a call to db_get() or db_append() and writes any changes that have been made to the internal copy of the record back to the DBF file and releases and record (or append byte) locks.

Note that a record is automatically released if the task that obtained the record is killed (E.g. by an explicit call to task_kill() or task_chain()) or by encountering a restart, stop or endmain statement.

Returns:  Returns 0 on success or a negative error code.