Takes three parameters, Login, Password, bRememberMe
Mostly to facilitate logging in (creating a new session) after a new user has signed up, or used the login help. Can also be used in distributed systems as well.
Login Username, Password, bRememberMe
Login Username, Password
If unsuccessful, a runtime error will be thrown, so using a Try block around this will be necessary.
If successful, all aspects of the login, including creating the session, setting the outbound cookies, will be done for you. Internal runtime values such as $SessionUser, will be updated and ready to use.
In order to obtain a user friendly message on an unsuccessful login, or in the case of a two factor authentication prompt, use the Login$ function instead