{{htmlmetatags>metatag-robots=()
metatag-title=(LOGIN | ugBASIC User Manual)
metatag-keywords=(ugBASIC,Commodore 64,Commodore PLUS/4,ZX Spectrum)
metatag-description=(Manual page for LOGIN)
metatag-media-og:image=(:ugbasic:logo-ugbasic-fb.png)
metatag-og:title=(LOGIN | ugBASIC User Manual) 
metatag-og:description=(Manual page for LOGIN)
}}

====== ugBASIC User Manual ======

===== LOGIN  =====

===== SYNTAX =====
     = LOGIN( username, password )

==== PURPOSE ====


The ''LOGIN'' function will allow to connect with a DOJO server. On DOJO 
servers there is no different process between registration and access 
to the systems: this is because, in fact, it is unlikely that the user's 
situation has persisted on the retrocomputers. It follows that, at the 
first attempt to access, there will also be contextual registration of the 
user; after the first access, each subsequent access must have the same 
credentials, and there is no way to change them, at least with actual 
version of the DOJO protocol.

The ''LOGIN'' function return a ''sessionId'', to be used on other 
commands / functions. To verify that the operation has taken place, 
the ''SUCCESS''() function must be used. If ''SUCCESS(...)'' returns 
a ''TRUE'' result, then the login process was successful; if it returns a 
''FALSE'' result, then the process must be considered failed for some 
reason (the username may have already been used, or the credentials are 
incorrect, and so on).



==== EXAMPLE ====
    sessionId = LOGIN( "user", "password" )


==== ABBREVIATION ====
   Lgn


==== AVAILABLE ON ====
  * Commodore 64
  * Commodore 64+REU
  * TRS-80 Color Computer 3
  * TRS-80 Color Computer


==== ALIAS FOR ====
[[DOJO LOGIN]] 

==== ANY PROBLEM? ====
If you have encountered a problem using this command, if you think there is a bug or the explanation is unclear, please [[https://github.com/spotlessmind1975/ugbasic/issues/new?title=ISSUE ON LOGIN|open an issue]] for this keyword on GitHub. Thank you!===== POWERED BY =====

[[:ugbasic:user:index|{{ :ugbasic:user:logo-ugbasic.png?nolink&600 |}}]]