Returns the index allocated to the logical entry.
Returns -1 for error in adding the entry. Check the log for more details.
