BOT_STATUS_QUERY

TotalControl for LSL‎ Commands

Queries the selected bot status (useful to determine the subscription length).
The result is returned using the BOT_EVENT_STATUS_REPLY event.


llMessageLinked(LINK_SET, BOT_STATUS_QUERY, "", "");

Variables

The following table shows input values (you send them with the API call) and returned output values.

Variable	Description
`str`	—
`id`	—

Return Value

The result of this command will be returned to your script using the BOT_EVENT_STATUS_REPLY event:


link_message(integer sender, integer num, string str, key id)

Parameter	Description
`sender`	Link number of the sender prim
`num`	`BOT_EVENT_STATUS_REPLY`
`str`	String representing the bot's status: • First line — bot status code (see all codes here) • Second line — bot expiration date • Third line — bot online status Online statuses `"ONLINE"` — Bot is online `"LOGGED OUT"` — Bot was logged out gracefully `"CONNECTING"` — The bot is logging in `"OFFLINE"` — Bot is expired or has an error Example output `OK 2019-03-10 00:00 LOGGED OUT`
`id`	Bot UUID

Example

integer BOT_SETUP_SETBOT = 280101;
integer BOT_STATUS_QUERY = 280106;

integer READY = FALSE;

string name = "SmartBots Resident";
string accesscode = "f7dheb7fba9";

default
{
	state_entry()
	{
		llMessageLinked(LINK_SET, BOT_SETUP_SETBOT, name, accesscode);
	}

	touch_start(integer total_number)
	{
		if (READY) {
			llMessageLinked(LINK_SET, BOT_STATUS_QUERY, "", "");
		} else {
			llOwnerSay("The bot is not ready. If you received a Setup Failed message then please check your access code is correct, otherwise please try again in a moment.");
		}
	}

	link_message(integer sender, integer cmd, string data, key idk) {
		string id = (string)idk;
		if(cmd == BOT_SETUP_SUCCESS) {
			READY = TRUE;
			llOwnerSay("Setup Success: data=" + data + "\nkey= " + id);
		} else if(cmd == BOT_SETUP_FAILED) {
			READY = FALSE;
			llOwnerSay("Setup Failed: data=" + data + "\nkey= " + id);
		} else if(cmd == BOT_EVENT_STATUS_REPLY) {
			llOwnerSay("Status: data = " + data + "\nkey= " + id);
		}
	}
}