View source for Usage/Status Codes

{{DISPLAYTITLE: Status Codes}}
"Command status code" is additional information you receive with the [[AdminBot for Bots/Events|AdminBot event]].

== How to get the code ==
Events come to your script using link_message:

<syntaxhighlight lang="lsl">
link_message( integer sender_num, integer num, string str, key id )
</syntaxhighlight>

The "Command status code" is located in the '''str''' variable (while '''num''' holds the AdminBot event ID).

== Status Codes ==

The possible status codes are listed below:

{| width="100%" class=big12
! Possible events
! Status code
! width=250 | Description
|-
| colspan=3 |
=== Success code ===
|-  class=row-b
| BOT_EVENT_STATUS_REPLY
| OK
| Command succeed, bot subscription valid.

|-
| colspan=3 |
=== Command fails ===
|- class="row-a"
| BOT_COMMAND_FAILED
| UNKNOWN_COMMAND
| The command you've sent is unknown. Try upgrading to the most newest version.
|- class=row-b
| BOT_COMMAND_FAILED
| SERVICE_UNAVAILABLE
| This SmartBots service is not available for you. Refer to SmartBots [http://www.mysmartbots.com/docs/Personal_Bots Services] page for details.
|- class="row-a"
| BOT_COMMAND_FAILED<br>BOT_SETUP_FAILED<br>BOT_EVENT_STATUS_REPLY
| BOT_NOTSET
| You are trying to issue the command, but AdminBot does not know your Bot yet (use [[AdminBot for Bots/Commands|BOT_SETUP_SETBOT]] command)

|-
| colspan=3 |

=== Bot status fails ===
|- class=row-b
| BOT_COMMAND_FAILED<br>BOT_SETUP_FAILED<br>BOT_EVENT_STATUS_REPLY
| BOT_NOTEXIST
| The bot you are trying to use does not exist. You have to visit http://www.smartbots2life.com and list your personal bot
|- class="row-a"
| BOT_SETUP_FAILED
| BOT_WRONGCODE
| You have specified the wrong [http://www.mysmartbots.com/docs/Bot_access_code Access Code] while setting the bot using BOT_SETUP_SETBOT.
|- class="row-b"
| BOT_COMMAND_FAILED<br>BOT_SETUP_FAILED<br>BOT_EVENT_STATUS_REPLY
| BOT_NOTPAID
| You've listed your bot with SmartBots, but did not paid your subscription yet.
|- class=row-a
| BOT_COMMAND_FAILED<br>BOT_SETUP_FAILED<br>BOT_EVENT_STATUS_REPLY
| BOT_EXPIRED
| Your SmartBots subscription has expired. The expiration date attached.
|- class="row-b"
| BOT_COMMAND_FAILED<br>BOT_SETUP_FAILED<br>BOT_EVENT_STATUS_REPLY
| BOT_NOTSETUP
| Editor will process and start your order shortly. Please wait a bit.

|-
| colspan=3 |

== Example ==
The following example shows how to parse bot setup error.

In this example we receive the BOT_SETUP_FAILED event: this means that AdminBot can't use the bot you've asked. We should try to understand what's wrong with the bot (usually the bot name error, or SmartBots subscription has expired).

<syntaxhighlight lang="lsl">
link_message(integer sender,integer cmd, string data, key id) {
  /////////////////// Bot setup failed event
  if(cmd==BOT_SETUP_FAILED) {
    // We split the string parameter to the lines
    list parts=llParseString2List(data,["\n"],[]);

    // The first line is a status code, and second line is the bot expiration date
    string code=llList2String(parts,0);
    string expires=llList2String(parts,1);
            
    // Inform user
    llOwnerSay("AdminBot bot setup failed:\n"+
      "error code: "+code+"\n"+
      "expired: "+expires);
  }
}
</syntaxhighlight>

{{NavMenu}}

__NOTOC__