View source for XsConnectToDatabase

{{LSL Function/warning
|1=Software Dependency
|2=This specific command and other "'xs'-prefixed" commands require the Xenon Systems runtime script, and several blocks of code for the aliases (commands with the "xs" prefix).
}}{{LSL_Function
|mode=user
|func=xsConnectToDatabase
|func_desc=Connects to database '''id''' with user ID '''user''' and password '''password'''. Also uses '''params''' for additional parameters if used.
|sort=ConnectToDatabase
|func_id
|func_sleep=5.0
|func_energy=10.0
|func_footnote
|p1_type=integer|p1_name=id|p1_desc=Database ID. Must be registered with central server!.
|p2_type=string|p2_name=user|p2_desc=User ID to login to database. Must use underscores (_) instead of spaces.
|p3_type=key|p3_name=password|p3_desc=Associated ID password. Must be between 4 and 16 chars. Only numbers and letters are accepted.
|p4_type=list|p4_name=params|p4_desc=Parameters to change default settings to suit the current session. (Optional)
|spec
|caveats=
* This script requires the Xenon Systems Runtime File and a few code modifications to include the appropriate aliases.
* The object containing the runtime file will change its name for any notifications. However, it will change back as soon as the notification has been sent. (For example, from "Object" to "XS Runtime (Object)" and back.)
* This command, associated dependencies, and supported products are available only on the Teen Grid at the moment.
** This product is pending a {{DuoGrid Link}}-Compatible badge. This will make it work on the Main Grid as well.
|examples=
<lsl>default
{
    xsConnectToDatabase(integer id, string user, key password, list params)
    {
        llMessageLinked(LINK_SET,0215,id + "~" + user + "~" + password,llDumpList2String(params,"|"));
    }

    state_entry()
    {
        //This will contact database 39 (routed through the main server), with the user id named
        //"Average_User", using password 12345678 (database user passwords must be between 4-16 chars).
        //In addition, the params will attempt to create this session in Sysop mode, allowing the
        //user to do anything but change user ID records.
        //Note database IDs are different from your Second Life ID! The IDs are controlled by the
        //server administrator. Database servers are *inworld*.

        xsConnectToDatabase(39,"Average_User",123456,["mode.sysop"]);
    }
}

//That will start the connection, and finally the runtime script will "say" the results in
//the chosen format.
//If the owner chose to display them public, it will show them in [[DEBUG_CHANNEL]].

//Results:
//XS Runtime (Object): Connection successful, however, 1 warning has occurred.
//XS Runtime (Object): WARNING 29: Your parameter "Mode.Sysop" has been declined by the server.
//You are connected as your permission level allows (Bureaucrat).
</lsl>
|helpers
|also_header
|also_tests
|also_articles
|also_footer
|also_functions
|also_events
|also_articles
|notes
|cat1=3rd Party Dependencies
|cat2=Xenon Systems Runtime-powered
}}