Synopsis:

       rec_num=db_recnum(rec_handle)

Arguments:

       rec_handle - the record handle returned by db_get() or db_append()

Description:   This function returns the record number (starting from 1) of the record specified by the given rec_handle.

Returns:    Returns the record number of the speicifed record or a negative error code.