issue 1253 - prevent multiple logins with same username

Resolves #1253 
Document the meaning of the return value.