OpenSRS Service Account Provisioning Protocol

Transcription

1 OpenSRS Service Account Provisioning Protocol September 29, 2011

2 COPYRIGHT Copyright 2011 Tucows, Inc. All rights reserved.

3 Contents CHAPTER 1 Overview of the APP APP architecture APP client layer APP server layer Getting started CHAPTER 2 Using the APP Overview Establishing a secure connection Specifying the version number Logging in Submitting commands Command syntax Rules for creating and deleting domains, workgroups, and mailboxes Mailbox types Legal field values Special characters Ending the session Quit Timeouts for idle connections CHAPTER 3 APP Commands Initializing and terminating commands Domain commands Workgroup commands Mailbox commands General Options (Settings) Suspension and resinstatement Mailing lists Forward only mailboxes CHAPTER 4 Timezone values CHAPTER 5 Reference APP data types Definitions

4 Data types Input attributes Related information Mailbox Folder Names Using Webmail to encode folder names User name and password rules Mailbox user name Password Mailbox account holder Forward address constraints Parsing rules Some definitions Whitespace Label Double-quoted string Client syntax parsing Command Command Name Attribute-Value Pairs Attribute Name & double-quoted value Value Parsing the value further Server syntax parsing Response Status line Other response data Value Parsing the response further Protocol syntax Related information Java prerequisite Example error Identifying the problem Solution Example of APP usage CHAPTER 6 Glossary Revisions Index Contents

5 Chapter 1 Overview of the APP This chapter contains the following topics: APP architecture on page 5 Getting started on page 5 APP architecture APP client layer APP server layer The Account Provisioning Protocol (APP) provides a command-based, TCP/IP protocol that gives external clients a simplified command set to manage mailbox accounts. An APP client may be as simple as a small Perl script that assigns new passwords to a group of mailboxes or as complex as a Web-based front-end that lets users change their individual mailbox preferences. All APP clients contain code that calls one or more of the APP commands. The APP requires a secure connection between the server and a client. Your APP client should initiate a connection through a secure tunnel client that provides SSL encryption using port The APP client invokes commands in the APP server. The APP server, in turn, carries out the commands, which modify mailboxes or other OpenSRS services. Getting started TO GET STARTED WITH THE APP 1) Install a secure tunnel client to create a secure socket layer for your sessions. 2) Understand how to initialize and test your sessions. See Using the APP on page 6. Once you learn the basics, use the APP command list for reference. See Chapter 3, APP Commands. 5

6 Chapter 2 Using the APP Overview Here are general steps for using the APP. The topics which follow this provide more detail. TO WORK WITH THE APP 1) Use port 4449 to establish a secure connection to: test (for development and testing) at admin.test.hosted .com or production server at admin.hosted .com See Establishing a secure connection on page 6. 2) Specify the APP version number. See Specifying the version number on page 6. 3) Log in. See Logging in on page 7. 4) Submit commands. See Submitting commands on page 7. 5) End the session. See Ending the session on page 9. In general, you don t perform these steps manually (by typing them in a TELNET session, for example). Instead, you write a script that performs these steps in the order listed. Establishing a secure connection Submit the appropriate commands for the secure tunnel client you have installed. Specifying the version number The APP always expects the following command first: VER VER= 3.4 <CRLF>. <CRLF> 6

7 Replace 3.4 with the current version of the APP. NOTE You must enter a RETURN character followed by a period and then another RETURN after each command you send to the APP. Logging in LOGIN USER="user-admin" DOMAIN="domain" PASSWORD="password" <CRLF>. <CRLF> Replace user-admin, domain, and password with the appropriate values of your administrator account. Submitting commands This section explains the syntax and rules for submitting commands. Command syntax The template for a command is as follows: command attribute= value <CRLF>. <CRLF> Commands consist of a command, followed by white space, followed by zero or more attribute-value pairs separated by white space, followed by a carriage-return with a line-feed (indicated by <CRLF>), a period, and another carriage-return with a line-feed. The values must be enclosed by double quotes. Valid white space characters are Space, Tab, and Carriage-return/line-feed. Rules for creating and deleting domains, workgroups, and mailboxes Hierarchy A strict hierarchy governs the creating and deleting of domains, workgroups, and mailboxes. Listed in order from highest to lowest, that order is company, domain, workgroup, and mailbox. For example, if you want to delete a domain using the APP, the workgroups and mailboxes within a domain must be deleted before that operation will work. Likewise, a user cannot create mailboxes in a specified domain if that domain doesn t already exist. Case-insensitive The APP changes to lowercase all mailbox names (including alias mailboxes, group aliases, and forward-only mailboxes), domain names, and workgroup names. Chapter 2 Using the APP Logging in 7

8 Mailbox types Mailbox accounts can function as one of four possible types: regular mailbox, alias, forwardonly, or filteronly. In the OpenSRS provisioning system, the mailbox type will change depending on how the mailbox is actually being used. This means that your account billing is more accurate as it is based on what your customers actually do with their mailboxes rather than the way the mailboxes were originally created. For example, if you create an account as a regular mailbox, and then enable it for forwarding and turn off the keep copy flag, you will be charged the rate for a forwardonly account rather than a full mailbox. The type is reflected in the APP command results, so, for example, the GET_DOMAIN_MAILBOXES command shows the account as a forwardonly even though you originally created it as a regular mailbox. NOTE There used to be one additional type - group alias - however, since group aliases have always operated as forwardonly accounts, they are now displayed that way. The existing group alias APP commands continue to work and are equivalent to the associated forward only commands, for example, the CREATE_GROUP_ALIAS_MAILBOX command is equivalent to the CREATE_MAILBOX_FORWARD_ONLY command. Legal field values The following table shows the legal field values for APP data types. Data type Length host 90 Valid domain name (lowercase APP automatically converts uppercase characters). domain 64 Valid domain name (lowercase APP automatically converts uppercase characters). workgroup 30 Starts and ends in a lowercase alphanumeric, otherwise lowercase alphanumeric, hyphen, underscore, or period. mailbox 64 Same as for workgroup. password 54 Any printable ASCII characters. For guidelines on creating passwords, see User name and password rules on page 95. Chapter 2 Using the APP Submitting commands 8

9 Data type Length first name 30 UTF-8 characters. For guidelines on assigning account names, see User name and password rules on page 95. last name 30 UTF-8 characters. For guidelines on assigning account names, see User name and password rules on page 95. Special characters The following ASCII characters has special meaning in the TELNET interface and should not be entered in APP command attributes. ASCII number character APP behavior 3 ^C Stops responding and times out after 2 minutes 5 ^E May or may not ignore irregular behavior 26 ^Z Stops responding and times out after 2 minutes 28 ^\ Stops responding and times out after 2 minutes 29 ^] Comes to TELNET prompt Ending the session Quit The QUIT command terminates your session. QUIT <CRLF>. <CRLF> The server automatically closes its TCP/IP connection. Timeouts for idle connections Your TELNET session will time out if the connection is idle past a certain time period. The default timeout is two minutes. Contact your customer support person if idle timeouts are a problem for you. Chapter 2 Using the APP Ending the session 9

10 Chapter 3 APP Commands The APP commands are listed here, arranged by usage: Initializing and terminating commands on page 11 Domain commands on page 13 Workgroup commands on page 35 Mailbox commands on page 39 Also see Command syntax on page 7. Each command is shown with a full example of its syntax; you should replace the sample values with your own values. Some examples may appear broken across several lines; however, this is for illustration purposes only, and your commands should appear on a single line. Some commands require that the user have a certain level of administration privilege; for example, only Company Administrators can create or delete domains. Permission levels are listed under in the following sections. Permission Company Domain Workgroup Mailbox Can be executed by A company administrator in the same company The above plus domain administrator in same domain All the above plus workgroup administrator in same workgroup All the above plus mailbox owner Also see the glossary definition for administration privileges on page

11 Initializing and terminating commands VER VER VER="<x.x>" Tells the server what version the client is. This must be the first command issued. For example: VER VER= 3.4 None Required VER Version number of client. Command takes 3.4, 3.5, or 3.6. Optional Errors None 6 Unsupported version LOGIN LOGIN USER="<name>" DOMAIN="<domain>" PASSWORD="<pwd>" Authenticates a user to the APP server. For example: LOGIN USER="ralph" DOMAIN="example.com" PASSWORD="5lKnet" Passwords must be printable characters and not include spaces. For guidelines on creating passwords, see User name and password rules on page 95. Required USER Username DOMAIN Domain name PASSWORD Password Optional None Errors 7 Invalid login 15 Invalid password syntax Chapter 3 APP Commands Initializing and terminating commands 11

12 Also see the glossary definition for administration privileges on page 108. QUIT Required Optional Errors QUIT Terminates APP session. None None None None Chapter 3 APP Commands Initializing and terminating commands 12

13 Domain commands CREATE_DOMAIN CREATE_DOMAIN DOMAIN="<domain>" [TIMEZONE="<zone>"] [LANGUAGE="<language>"] [FILTERMX="<domain.tld:port>"] [SPAM_TAG="<tag>"] [SPAM_FOLDER="<folder>"] [SPAM_LEVEL="<level>"] Adds a new domain. Automatically creates the workgroup staff. Company (Customer) level permission Required DOMAIN Domain name; the domain must not already exist. Optional TIMEZONE Time zone for the domain. See Appendix 4, Timezone values. LANGUAGE The default language for all mailboxes in the domain. Defaults to "en" if not set. Valid values are: da, en, es, de, fr, it, nl, no, pt_br, and sv. FILTERMX The Exchange (MX) record to which any filter-only accounts direct messages released from spam quarantine. Valid values are hostname and IP address. Both must formats must specify a port. SPAM_TAG The value of this field is appended to the subject of any message identified as spam. Max. 30 char. SPAM_FOLDER The folder into which spam is delivered for all mailboxes in the domain. If not specified, the domain default is Spam. Max. 30 char. SPAM_LEVEL The agressiveness level of spam filtering. Valid values are NORMAL, HIGH, VERY HIGH, or "" (no value). When set to NORMAL, most spam is caught. When set to HIGH or VERY HIGH, more spam is caught, but the likelihood that non-spam messages (false positives) will be labelled as spam increases accordingly. Returns When the command is issued correctly, APP returns the following message: OK 0 Domain created. Chapter 3 APP Commands Domain commands 13

14 CREATE_DOMAIN Errors 4 Permission denied 8 Invalid domain name syntax 9 Domain name already exists 10 Nonexistent domain (only in version 3.5 and earlier) 104 Domain name is blacklisted 111 Invalid SPAM_LEVEL CREATE_DOMAIN_ALIAS CREATE_DOMAIN_ALIAS DOMAIN="<existing domain>" ALIAS="<new domain alias>" Creates an alias domain. Company (Customer) level permission. Required DOMAIN ALIAS Optional Returns None. When the command is issued correctly, APP returns the following message: OK O Alias created. Errors 4 Permission denied 8 Invalid domain name syntax 9 Domain name already exists 10 Nonexistent domain (only in version 3.5 and earlier) 104 Domain name is blacklisted DELETE_DOMAIN DELETE_DOMAIN DOMAIN="<domain>" [CASCADE="T F"] Removes a domain (including all workgroups and mailboxes if CASCADE is set to T). For example: DELETE_DOMAIN DOMAIN="example.com" CASCADE="T" Company-level permissions Chapter 3 APP Commands Domain commands 14

15 DELETE_DOMAIN Required DOMAIN Domain name Optional CASCADE Boolean T or F, F by default. Cascade= F (or left blank) only deletes the specified domain if it contains no workgroups or mailboxes; otherwise, the command returns error 18 and deletes nothing. Cascade= T enables the command to delete all the workgroups and mailboxes in the domain, if any exist. If the domain has more than 10,000 mailboxes, the command displays error 28 and deletes nothing. LIMIT Overrides the default limit of 10,000, and allows you to specify the maximum number of mailboxes allowed. Returns When the command is issued correctly, APP returns the following message: OK 0 Domain deleted. In version 3.5 and later, when CASCADE is specified, the response includes STATUS. For example: STATUS 1 Deleted user user1@b.com STATUS 2 Deleted user user2@b.com STATUS 3 Deleted user user3@b.com STATUS 4 Deleted workgroup staff OK 0 Domain deleted Errors 10 Nonexistent domain (only in version 3.5 and earlier) 18 Related workgroups exist (You tried to delete a domain that contains workgroups, and CASCADE is not set to T.) 28 Too many mailboxes for cascade delete (current mailbox count > current limit) DELETE_DOMAIN_ALIAS DELETE_DOMAIN_ALIAS ALIAS="<domain alias to be deleted>" Deletes an alias domain. Company (Customer) level permission. Required ALIAS Optional None. Chapter 3 APP Commands Domain commands 15

16 DELETE_DOMAIN_ALIAS Returns When the command is issued correctly, APP returns the following message: OK 0 Alias deleted. Errors 4 Permission denied 8 Invalid domain name syntax 10 Nonexistent domain (only in version 3.5 and earlier) CREATE_DOMAIN_WELCOME_ CREATE_DOMAIN_WELCOME_ DOMAIN="<domain>" WELCOME_TEXT="<welcome_text>" WELCOME_SUBJECT="<welcome_subject>" FROM_NAME="<from_name>" FROM_ADDRESS="<from_address>" CHARSET="utf8" MIME_TYPE="text/plain" or "text/html" Creates a welcome message that is sent to every new user who registers on the domain. For example: CREATE_DOMAIN_WELCOME_ DOMAIN="example.com" WELCOME_TEXT="Hello <name>{4} {5}! Thanks for registering! Your ID {0}@{1} <user@example.com> has been successfully created." WELCOME_SUBJECT="Welcome to example.com" FROM_NAME="System Administrator" FROM_ADDRESS="admin@example.com" CHARSET="utf8" MIME_TYPE="text/html" If you issue the command more than once, subsequent commands overwrite the earlier messages. Company (Customer) level administration or domain administration permission. Chapter 3 APP Commands Domain commands 16

17 CREATE_DOMAIN_WELCOME_ Required DOMAIN Domain name. The domain must already exist. WELCOME_TEXT The welcome message text. There are no limitations on the size of the message; however, we recommend that it is no more than characters. In the welcome text, the following substitution variables may be used: {0} Mailbox name {1} Domain name {4} First name {5} Last name For example, suppose a new user, bill.smith@example.com, registers using his first name Bill, his last name Smith, then the welcome message used in the command example above is reformatted as: Hello Bill Smith! Thanks for registering! Your ID bill.smith@example.com has been successfully created. WELCOME_SUBJECT The subject line of the message; must be less than 4000 characters. FROM_NAME Name of the sender; must be UTF-8 so that international characters are supported. Any other format results in a syntax error. FROM_ADDRESS Must be a valid address. Use the full address, including the domain. CHARSET Must be utf8. MIME_TYPE Can be text/plain or text/html. If WELCOME_TEXT is plain, then MIME TYPE should be text/plain; if WELCOME_TEXT is HTML, then MIME_TYPE should be text/html. Optional Returns None When the command is issued correctly, APP returns the following message: OK 0 Welcome attributes created for the domain. Chapter 3 APP Commands Domain commands 17

18 CREATE_DOMAIN_WELCOME_ Errors 1 error (if one or more of the required parameters are not present or are incorrect) 5 Internal system error (if failures occur when APP invokes the back end DB procedures) 8 Invalid domain name syntax. Domain does not comply with RFC conventions. 10 Nonexistent domain (only in version 3.5 and earlier) GET_COMPANY_DOMAINS GET_COMPANY_DOMAINS [LIMIT="<n>"] Returns a list of domains within the current company. For example: GET_COMPANY_DOMAINS LIMIT= 200 Required Company-level permissions None Optional LIMIT Restricts the size of the list returned (the default is 1,000,000). LIMIT must be a positive integer. The command does not return errors on non-valid LIMIT values. Chapter 3 APP Commands Domain commands 18

19 GET_COMPANY_DOMAINS Returns When the command is issued correctly, APP returns the following message: In version 3.4: DOMAIN CREATE_DATE "example1.com","01/01/2004" "example2.com","01/01/2004" "example3.com","01/01/2004" NOTE In version 3.4, this command always returns 01/01/2004 as the create_date. In versions 3.5 and later: OK 0 Success DOMAIN,TYPE,MAILBOX_COUNT,FORWARD_COUNT,ALIAS_COUNT "example1.com","domain","0","0","0","0" "example2.com","domain","0","0","0","0" "example3.com","domain","0","0","0","0" "example4.com","domain","0","0","0","0" "example5.com","domain","0","0","0","0" Errors 10 Nonexistent domain (only in version 3.5 and earlier) 48 Company has too many domains DELETE_DOMAIN_WELCOME_ DELETE_DOMAIN_WELCOME_ DOMAIN="<domain>" Deletes a previously configured domain welcome message. New users who register on the domain after this command is run, do not receive a welcome message. For example: DELETE_DOMAIN_WELCOME_ DOMAIN="example.com" Company (Customer) level administration or domain administration permission. domain must already exist. Required DOMAIN Domain name; the domain must exist. Optional Returns NONE When the command is issued correctly, APP returns the following message: OK 0 Welcome attributes deleted for the domain. Chapter 3 APP Commands Domain commands 19

20 DELETE_DOMAIN_WELCOME_ Errors 1 error (if the DOMAIN parameter is not specified) 5 Internal system error (if failures occur when APP invokes the back end DB procedures) 8 Invalid domain name syntax. Domain does not comply with RFC conventions. 10 Nonexistent domain (only in version 3.5 and earlier) GET_DOMAIN GET_DOMAIN DOMAIN="<domain>" Display details about a domain. For example: GET_DOMAIN DOMAIN="example.com" Required Domain-level permissions or higher The specified domain must exist. Chapter 3 APP Commands Domain commands 20

21 GET_DOMAIN Returns When the command is issued correctly, APP returns the following message: In version3.4 OK 0 Success DOMAIN= "example.com" BRANDNAME= "<brand> " CATCHALLUSER= " " INBOUND SMTP= "mx.cust.example.hossted .com " IP= "mail.cust.example.hosted .com " NAME= "example.com " OUTBOUNDSMTP= "smtp.cust.example.hosted .com " PARENT= " " QUESTION= " " SPAM_TAG= "SPAM " SPAM_FOLDER= "SPAM " SPAM_LEVEL= "NORMAL" DISABLED= "F " In version3.5 OK 0 Success DOMAIN= "example.com" BRANDNAME= "<brand> " CATCHALLUSER= " " INBOUND SMTP= "mx.cust.example.hossted .com " IP= "mail.cust.example.hosted .com " NAME= "example.com " OUTBOUNDSMTP= "smtp.cust.example.hosted .com " SPAM_TAG= "SPAM " SPAM_FOLDER= "SPAM " SPAM_LEVEL= "NORMAL" DISABLED= "F " ALIASES="bb.com,ba.com,bd.com BRANDNAME The brand associated with this domain. CATCHALLUSER Catch-all mailbox account for this domain. DOMAIN The name of the domain (e.g. "example.com") INBOUNDSMTP Inbound hostname. IP Domain hostname. NAME Domain name. Chapter 3 APP Commands Domain commands 21

22 GET_DOMAIN OUTBOUNDSMTP Outbound hostname. SPAM_TAG A text tag appended to any the subject of any messages identified as spam. Empty if no tag is specified. Max. 30 char. SPAM_FOLDER The folder to which messages identified as spam are delivered. This value is empty if no folder has been specified; however, the system default of Spam will be applied to the domain.max. 30 char. SPAM_LEVEL The agressiveness level of spam filtering. Value may be NORMAL, HIGH, VERY HIGH, or " " (not set). DISABLED Indicates whether the domain is disabled. Valid values are T and F. Errors 10 Nonexistent domain (only in version 3.5 and earlier) GET_DOMAIN_BRAND GET_DOMAIN_BRAND DOMAIN= "<domain>" Display details about a domain. For example: GET_DOMAIN_BRAND DOMAIN= "example.com " Required Returns Errors Domain-level permissions or higher The specified domain must exist. When the command is issued correctly, APP returns the following message: OK 0 success BRANDCODE= "<code>" BRANDCODE The name of the brand that is associated with this domain. 10 Nonexistent domain (only in version 3.5 and earlier) Chapter 3 APP Commands Domain commands 22

23 CHANGE_DOMAIN CHANGE_DOMAIN DOMAIN="<domain_name>" [LANGUAGE="<language>"] [TIMEZONE="<zone>"] [FILTERMX="<domain.tld:port>"] [SPAM_TAG="<tag>"] [SPAM_FOLDER="<folder>"] [SPAM_LEVEL="<level>"] Changes the settings for a domain. Domain-level permissions Required DOMAIN Domain name. DOMAIN must already exist. At least one optional argument. Optional LANGUAGE The default language for all mailboxes in the domain. Defaults to "en" if not set. Valid values are as follows: da, en, es, de, fr, it, nl, no, pt_br, and sv. TIMEZONE Time zone for the domain. See Appendix 4, Timezone values. FILTERMX The Exchange (MX) record to which any filter-only accounts direct messages released from spam quarantine. Valid values are hostname and IP address. Both must formats must specify a port. SPAM_TAG The value of this field will be appended to the subject of any message identified as spam. To remove an existing tag, as opposed to overwriting it, leave the value empty (i.e., SPAM_TAG="").Maximum 30 characters. SPAM_FOLDER Specifies the folder into which spam will be delivered for all future created mailboxes in the domain. Max. 30 char. NOTE All existing mailboxes will retain their current domain level setting. If you need to change the SPAM_FOLDER for these mailboxes, it will have to be done at the mailbox level. See CHANGE_MAILBOX on page 44. SPAM_LEVEL The agressiveness level of spam filtering. Valid values are NORMAL, HIGH, VERY HIGH, or "" (no value). When set to NORMAL, most spam is caught. When set to HIGH or VERY HIGH, more spam is caught, but the likelihood that non-spam messages (false positives) will be labelled as spam increases accordingly. Chapter 3 APP Commands Domain commands 23

24 CHANGE_DOMAIN Returns When the command is issued correctly, APP returns the following message: OK 0 Domain is updated. Errors 4 Permission denied 8 Invalid domain name syntax 10 Nonexistent domain (only in version 3.5 and earlier) 37 Invalid domain type 111 Invalid SPAM_LEVEL SET_DOMAIN_ADMIN SET_DOMAIN_ADMIN DOMAIN="<domain>" MAILBOX="<mailbox>" [STATE="T F"] Grants or removes administration privileges over the domain to which the mailbox already belongs. For example: SET_DOMAIN_ADMIN DOMAIN="example.com" MAILBOX="foo" STATE="T" If adding domain-administrator, this command tries to remove any other administrator privileges the mailbox already has (Workgroup, Company), and fails if the caller has insufficient permission to do so. If removing privileges, this command returns OK 0 if the mailbox did not have Domain administrator in the first place. NOTE SET_DOMAIN_ADMIN replaces the deprecated commands CREATE_DOMAIN_ADMIN and DELETE_DOMAIN_ADMIN. Company-level permissions. Required DOMAIN MAILBOX Optional STATE Boolean T or F. Chapter 3 APP Commands Domain commands 24

25 SET_DOMAIN_ADMIN Returns When the command is issued correctly, APP returns the following message: OK 0 Errors 10 Nonexistent domain (only in version 3.5 and earlier) 17 Nonexistent mailbox 17 Invalid mailbox type (if mailbox is one of type: alias, or forward_only SET_DOMAIN_BRAND SET_DOMAIN_BRAND DOMAIN="<domain>" BRAND_CODE="<code>" Assigns a brand to the domain For example: SET_DOMAIN_BRAND DOMAIN=""example.com" BRAND_CODE="mycoolbrand" Company-level permissions. Required DOMAIN Domain name. must already exist NOTE You must specify at least one of the optional attributes. Optional BRAND The brand associated with this domain. BRAND_CODE Name of the brand as it appears in the MAC or is returned by GET_DOMAIN_BRAND Returns When the command is issued correctly, APP returns the following message: OK 0 Errors 10 Nonexistent domain (only in version 3.5 and earlier) ER 52 Brand Code not found Chapter 3 APP Commands Domain commands 25

26 SET_DOMAIN_CATCH_ALL_MAILBOX SET_DOMAIN_CATCH_ALL_MAILBOX DOMAIN="<domain>" [MAILBOX="<mailbox>"] [STATE="T"] Sets the domain catch-all mailbox, which receives any mail sent to a nonexistent mailbox in the domain. This prevents mail from bouncing. The catch-all mailbox must be a mailbox within the domain. For example: SET_DOMAIN_CATCH_ALL_MAILBOX DOMAIN="example.com" MAILBOX="default" STATE="T" You must set STATE as T to enable the mailbox. Setting only MAILBOX and DOMAIN specifies a pre-existing mailbox as a catch-all mailbox, but does not activate it. Domain-level permissions. Required DOMAIN STATE T turns the feature on and F turns it off. MAILBOX The mailbox to be made a catch-all. NOTE MAILBOX is required only when enabling. Optional None Errors 10 Nonexistent domain (only in version 3.5 and earlier) 17 Nonexistent mailbox 17 Invalid mailbox type (if mailbox is one of type: alias, or forward_only) 20 Invalid catch-all state (you tried to set STATE= T without specifying a value for MAILBOX) Chapter 3 APP Commands Domain commands 26

27 SET_DOMAIN_DISABLED_STATUS SET_DOMAIN_DISABLED_STATUS DOMAIN="<domain>" Enables or disables the specified domain. For example: SET_DOMAIN_DISABLED_STATUS DOMAIN="example.com" DISABLED="T" NOTE This command can only executed by Company Admins and higher. A domain disabled by a Super Admin cannot not be enabled by a Company Admin Company-level permissions. Required DOMAIN DISABLED T disables the domain and F enables it. Optional Returns None When the command is issued correctly, APP returns the following message: OK 0 success Errors GET_NUM_DOMAIN_MAILBOXES Required Optional GET_NUM_DOMAIN_MAILBOXES DOMAIN="<domain>" Gets the number of mailboxes in a domain and displays by mailbox type. For example: GET_NUM_DOMAIN_MAILBOXES DOMAIN="example.com" Domain-level permissions. DOMAIN None Chapter 3 APP Commands Domain commands 27

28 GET_NUM_DOMAIN_MAILBOXES Returns When the command is issued correctly, APP returns the following message: In version 3.4: OK 0 NORMAL="2" GROUP_ALIAS="0X ALIAS= 0 FORWARD_ONLY="0" POPLINK="0" DOMAIN_CATCH_ALL="F" In version 3.5 and later: OK 0 MAILBOX="2" ALIAS="0X FORWARD_ONLY="0" FILTER="" DOMAIN_CATCH_ALL="F" Errors 10 Nonexistent domain (only in version 3.5 and earlier) GET_DOMAIN_MAILBOXES GET_DOMAIN_MAILBOXES DOMAIN="<domain>" [LIMIT="<n>"] Returns a list of all mailbox names in the domain, along with their types and workgroup names. For example: GET_DOMAIN_MAILBOXES DOMAIN="example.com" LIMIT="1000" Domain-level permissions Required DOMAIN Optional LIMIT Sets the maximum number of mailboxes the command will return. The default limit is 100,000 (mailboxes), which can be set lower. Use a lower number to speed up the command's processing; the more mailboxes the command needs to return, the longer it will take to return the results. NOTE If you specify LIMIT as over 100K, the command ignores the request and instead uses the default of 100K, but returns no error. Administrators can set LIMIT to be higher than the default. Chapter 3 APP Commands Domain commands 28

29 GET_DOMAIN_MAILBOXES Returns When the command is issued correctly, APP returns the following message: In version 3.4: OK 0 MAILBOX TYPE WORKGROUP "mb1" "NORMAL" "staff", "mb2" "OTHER" "staff", "mb3" "NORMAL" "staff" In version 3.5 and later: OK 0 Success MAILBOX,TYPE,WORKGROUP,ALIAS TARGET, FORWARD_RECIPIENT,FORWARD_RECIPIENT_COUNT "1","mailbox","994","","","" "24nospam","mailbox","staff","","","" "w4","forward","fo","","w1@b.com","1" "second1","alias","unknown","second@example.adm","", "" "a16","mailbox","staff","","","2" NOTE In version 3.5 and later, f FORWARD_RECIPIENT_COUNT >1, then FORWARD_RECIPIENT is not displayed. Errors 10 Nonexistent domain (only in version 3.5 and earlier) 1 error (LIMIT is negative or non-numeric) 46 Domain has too many mailboxes (Number of mailboxes to be returned is over the specified LIMIT) GET_DOMAIN_MAILBOX_LIMITS Required Optional GET_DOMAIN_MAILBOX_LIMITS DOMAIN="<domain>" Returns the limits for each mailbox type. For example: GET_DOMAIN_MAILBOX_LIMITS DOMAIN="example.com" Domain-level permissions. DOMAIN None Chapter 3 APP Commands Domain commands 29

30 GET_DOMAIN_MAILBOX_LIMITS Returns When the command is issued correctly, APP returns the following message: In version 3.4: OK 0 Success MAILBOX="500" FILTER_ONLY="500" ALIAS="600" FORWARD_ONLY="500" MAILING_LIST="500" Since the same limit applies to MAILBOX, FILTER_ONLY, FORWARD_ONLY, and MAILING_LIST, each of these values will be the same, and will be the largest of the values set using SET_DOMAIN_MAILBOX_LIMITS. In version 3.5 and later: OK 0 Success USER="500" ALIAS="600" In version 3.5 and later, the command returns only USER and ALIAS limits and the value of ALIAS is the largest of the values. Errors SET_DOMAIN_MAILBOX_LIMITS Required SET_DOMAIN_MAILBOX_LIMITS DOMAIN="<domain>" Sets the number of each mailbox type that can be created. For example: SET_DOMAIN_MAILBOX_LIMITS DOMAIN="example.com" MAILBOX="500" FILTER_ONLY="150" Company Admins and higher DOMAIN Chapter 3 APP Commands Domain commands 30

31 SET_DOMAIN_MAILBOX_LIMITS Optional MAILBOX In version 3.4. FILTER_ONLY In version 3.4. ALIAS The number of aliases that can be created. FORWARD_ONLY In version 3.4. MAILING_LIST In version 3.4. USER In version 3.5 and later. The largest of the values set for MAILBOX, FILTER_ONLY, FORWARD_ONLY, and MAILING_LIST Returns When the command is issued correctly, APP returns the following message: In version 3.4: OK 0 Success MAILBOX="500" FILTER_ONLY="500" ALIAS="600" FORWARD_ONLY="500" MAILING_LIST="500" Since the same limit applies to MAILBOX, FILTER_ONLY, FORWARD_ONLY, and MAILING_LIST, each of these values will be the same, and will be the largest of the values set using SET_DOMAIN_MAILBOX_LIMITS. In version 3.5 and later: OK 0 Success USER="500" ALIAS="600" In version 3.5 and later, the command returns only USER and ALIAS limits and the value of USER is the largest of the values set for MAILBOX, FILTER_ONLY, FORWARD_ONLY, and MAILING_LIST. Errors Chapter 3 APP Commands Domain commands 31

32 SET_DOMAIN_ALLOW_LIST SET_DOMAIN_ALLOW_LIST DOMAIN="<domain>" *domain.tld" Creates a new Allow Sender List for the domain. WARNING Any previously existing Allow Sender List for the domain will be overwritten without notification. Domain level permissions. Required DOMAIN LIST Maximum 300 entries. NOTE Domains entered in the LIST attribute require an asterisk (*) as illustrated above in the syntax example. The LIST is \n separated. Asterisk (*) is the only allowed wildcard. Multiple asterisks are accepted. Optional Returns None When the command is issued correctly, APP returns the following message: OK 0 Errors 2 Required attribute missing 10 Nonexistent domain (only in version 3.5 and earlier) SET_DOMAIN_BLOCK_LIST SET_DOMAIN_BLOCK_LIST DOMAIN="<domain>" LIST="user@domain.tld *domain.tld" Creates a new Block Sender List for the domain. WARNING Any previously existing Block Sender List for the domain will be overwritten without notification. Domain level permissions. Chapter 3 APP Commands Domain commands 32

33 SET_DOMAIN_BLOCK_LIST Required DOMAIN LIST Maximum 300 entries. NOTE Domains entered in the LIST attribute require an asterisk (*) as illustrated above in the syntax example. The LIST is \n separated. Asterisk (*) is the only allowed wildcard. Multiple asterisks are accepted. Optional Returns None When the command is issued correctly, APP returns the following message: OK 0 Errors 2 Required attribute missing 10 Nonexistent domain (only in version 3.5 and earlier) GET_DOMAIN_ALLOW_LIST GET_DOMAIN_ALLOW_LIST DOMAIN="<domain>" Returns the Allow Sender List for the domain. Domain level permissions. Required DOMAIN Optional Returns None When the command is issued correctly, APP returns the following message: OK 0 List="fred@gmail.com yahoo.com" Errors 2 Required attribute missing 10 Nonexistent domain (only in version 3.5 and earlier) Chapter 3 APP Commands Domain commands 33

34 GET_DOMAIN_BLOCK_LIST GET_DOMAIN_BLOCK_LIST DOMAIN="<domain>" Returns the Block Sender List for the domain. Domain level permissions. Required DOMAIN Optional None Errors 2 Required attribute missing 10 Nonexistent domain (only in version 3.5 and earlier) Chapter 3 APP Commands Domain commands 34

35 Workgroup commands CREATE_WORKGROUP CREATE_WORKGROUP WORKGROUP="<group>" DOMAIN="<domain>" Creates a workgroup within the specified domain. For example: CREATE_WORKGROUP WORKGROUP="db-techies" DOMAIN="example.com" Domain level permission Required WORKGROUP DOMAIN Optional Returns None. When the command is issued correctly, APP returns the following message: OK 0 Workgroup created. Errors 10 Nonexistent domain (only in version 3.5 and earlier) 11 Invalid workgroup name syntax 12 Workgroup already exists GET_DOMAIN_WORKGROUPS GET_DOMAIN_WORKGROUPS DOMAIN="<domain>" [LIMIT= <x> ] Returns a list of workgroups in the specified domain. For example: GET_DOMAIN_WORKGROUPS DOMAIN="example.com" LIMIT= 50 Domain-level permissions. Required DOMAIN Must be an existing domain. Optional LIMIT Restricts the number of workgroups returned; the default is 100,000. If you specify a number greater than 100,000, the number is ignored, and the default value of 100,000 is used. LIMIT must be a positive integer.. Chapter 3 APP Commands Workgroup commands 35

36 GET_DOMAIN_WORKGROUPS Returns When the command is issued correctly, APP returns the following message: In version 3.4: OK 0 WORKGROUP CREATE_DATE "staff" "01/01/2004", "test1" "01/01/2004" NOTE The CREATE_DATE value is always listed as 01/01/2004. In version 3.5 and later: OK 0 Success WORKGROUP,MAILBOX_COUNT,FORWARD_COUNT,ALIAS_COUNT "994","11","3","5","0" "blob","0","0","0","0" "bubba","0","0","0","0" Errors 10 Nonexistent domain (only in version 3.5 and earlier) 46 Domain has too many workgroups DELETE_WORKGROUP DELETE_WORKGROUP WORKGROUP="<group>" DOMAIN="<domain>" [CASCADE="T F"] Removes a workgroup from the specified domain. For example: DELETE_WORKGROUP WORKGROUP="db-techies" DOMAIN="example.com" CASCADE="T" Domain-level permissions. Required WORKGROUP Workgroup name. DOMAIN Domain name. Chapter 3 APP Commands Workgroup commands 36

37 DELETE_WORKGROUP Optional CASCADE Boolean T or F, F by default. When set to T, enables the command to delete all mailboxes in the domain, if any exist. If the workgroup has more than a specified number of mailboxes, the command displays error 28 and deletes nothing. LIMIT Overrides the default limit. Specify the maximum number of mailboxes. Returns When the command is issued correctly, APP returns the following message: OK 0 Workgroup deleted. Errors 10 Nonexistent domain (only in version 3.5 and earlier) 13 Nonexistent workgroup 28 Too many mailboxes for cascade delete (current mailbox count > current limit) SET_WORKGROUP_ADMIN SET_WORKGROUP_ADMIN DOMAIN="<domain>" MAILBOX="<mailbox>" [STATE="T F"] Grants or removes administration privileges over the workgroup to which the mailbox already belongs. For example: SET_WORKGROUP_ADMIN DOMAIN="example.com" MAILBOX="db-admin" STATE="T" If adding administrator privileges, this command attempts to remove any other administrator privileges (Company, Domain) the mailbox already has and fails if the caller has insufficient permission to do so. If removing privileges, this command returns OK 0 if the mailbox did not have Workgroup administrator in the first place. Domain-level permissions. Required DOMAIN MAILBOX Optional STATE Boolean T or F. T means grant Workgroup administration privileges (default), while F means remove privileges. Chapter 3 APP Commands Workgroup commands 37

38 SET_WORKGROUP_ADMIN Returns When the command is issued correctly, APP returns the following message: OK 0 Errors 10 Nonexistent domain (only in version 3.5 and earlier) 17 Nonexistent mailbox or 17 Invalid mailbox type (if mailbox is one of type: alias or forward_only) Chapter 3 APP Commands Workgroup commands 38

39 Mailbox commands General GET_MAILBOX_AVAILABILITY GET_MAILBOX_AVAILABILITY DOMAIN="<domain>" MAILBOX_LIST="<mailbox1,mailbox2,...mailboxN>" Takes a list of mailbox names in a domain and returns whether or not they exist. For example: GET_MAILBOX_AVAILABILITY DOMAIN="example.com" MAILBOX_LIST="joe,rsmith,janew" Domain-level permissions. Required DOMAIN Domain name. MAILBOX_LIST Comma=delimited list of mailbox names. Optional Returns None. When the command is issued correctly, APP returns the following message: OK 0 Success AVAILABLE_LIST="T,T,F" AVAILABLE_LIST indicates whether each mailbox listed in the request exists. "T" indicates that the mailbox exists. Errors 10 Nonexistent domain (only in version 3.5 and earlier) Chapter 3 APP Commands Mailbox commands 39

40 GET_ALTERNATE_MAILBOX_NAMES GET_ALTERNATE_MAILBOX_NAMES MAILBOX_LIST="<mailbox1,mailbox2,...mailboxN>" Given a comma-delimited list of mailbox names (in the form mailbox@domain), returns the same list with alternate suggestions for those which are already taken. For example: GET_ALTERNATE_MAILBOX_NAMES MAILBOX_LIST="foo@bar.com,baz@bar.com" Use this command as an alternative to the command GET_MAILBOX_AVAILABILITY. None Required MAILBOX_LIST Candidate mailbox names. Optional Returns Errors None. When the command is issued correctly, APP returns the following message: OK 0 MAILBOX_LIST="foo1@bar.com,baz@bar.com" An invalid mailbox in the list will be replaced with *nodomain* Chapter 3 APP Commands Mailbox commands 40

41 CREATE_MAILBOX CREATE_MAILBOX DOMAIN="<domain>" WORKGROUP="<group>" MAILBOX="<name>" PASSWORD="<pwd>" [FIRST_NAME="<first>"] [LAST_NAME="<last>"] [TITLE="<title>"] [PHONE="<phone_number>"] [FAX="<fax_number>"] [TIMEZONE="<zone>"] [LANGUAGE="<language>"] [FILTERONLY="T F"] [SPAM_TAG="<tag>"] [SPAM_FOLDER="<folder>"] [SPAM_LEVEL="<level>"] NOTE SPAM_TAG and SPAM_FOLDER are not supported when creating a filteronly mailbox. Adds a new mailbox to the specified domain. For example: CREATE_MAILBOX DOMAIN="example.com" WORKGROUP="staff" MAILBOX="ken" PASSWORD="s0up@K" FIRST_NAME="first" LAST_NAME="last" TITLE="title" PHONE=" " TIMEZONE= Europe/Amsterdam LANGUAGE="en" Workgroup level permission Required MAILBOX Must not already exist in DOMAIN. PASSWORD Must consist entirely of printable, non-space characters. For guidelines on creating passwords, see User name and password rules on page 95. WORKGROUP Must exist in DOMAIN. DOMAIN Chapter 3 APP Commands Mailbox commands 41

42 CREATE_MAILBOX Optional FILTERONLY Must be T in order to create a filter-only or spam quarantine mailbox. FIRST_NAME Mailbox user s first name. LAST_NAME Mailbox user s last name. PHONE Mailbox user s phone number. FAX Mailbox user s fax number; can be a maximum of 30 characters. TITLE Mailbox user s job title. TIMEZONE Mailbox user's time zone. See Appendix 4, Timezone values. LANGUAGE Mailbox user s preferred language. Valid values are as follows: da, en, es, de, fr, it, nl, no, pt_br, and sv. SPAM_TAG The value of this field will be appended to the subject of any message identified as spam. Max. 30 char. This is not supported for filteronly accounts. SPAM_FOLDER Specifies the folder into which spam will be delivered for the mailbox with the following parameters: argument max length is 128 characters and should take the form of a dot separated folder path; individual folders cannot exceed 30 characters. This is not supported for filteronly accounts. SPAM_LEVEL The agressiveness level of spam filtering. Valid values are NORMAL, HIGH, VERY HIGH, and ""(none). When set to NORMAL, most spam is caught. When set to HIGH or VERY HIGH, more spam is caught, but the likelihood that non-spam messages (false positives) will be labelled as spam increases accordingly. If this value is not set, the mailbox uses the SPAM_LEVEL setting for the next highest level (for example, domain or company). NOTE For guidelines on defining the MAILBOX, PASSWORD, FIRST_NAME, and LAST_NAME attributes, see User name and password rules on page 95. Chapter 3 APP Commands Mailbox commands 42

43 CREATE_MAILBOX Returns When the command is issued correctly, APP returns the following message: OK 0 Mailbox created. Errors 10 Nonexistent domain (only in version 3.5 and earlier) 13 Nonexistent workgroup 14 Invalid mailbox name syntax 15 Invalid password syntax. Password must contain only alpha, numeric, alphanumeric and ~!@#$%^&'*() _=+/*\][{}:;><,.`? 15 Invalid password syntax. Password must not be empty. 15 Invalid password syntax. Password must not be more than 54 characters long. 16 Mailbox already exists 111 Invalid SPAM_LEVEL 112 Maximum number jof mailboxes of this type for this domain reached SET_MAIL_ADMIN SET_MAIL_ADMIN DOMAIN="<domain>" MAILBOX="<mailbox>" [STATE="T F"] Grants or removes administration privileges to view and change mailboxes. For example: SET_MAIL_ADMIN DOMAIN="example.com" MAILBOX="foo" STATE="T" Domain-level permissions. Required DOMAIN MAILBOX Optional STATE Boolean T or F. The default is T. Returns When the command is issued correctly, APP returns the following message: OK 0 Errors 10 Nonexistent domain (only in version 3.5 and earlier) 17 Nonexistent mailbox 17 Invalid mailbox type (if mailbox is one of type: alias or forward_only) Chapter 3 APP Commands Mailbox commands 43

44 CHANGE_MAILBOX CHANGE MAILBOX DOMAIN="<domain>" MAILBOX="<mailbox>" [WORKGROUP="<group>"] [PASSWORD="<pwd>"] [FIRST_NAME="<first>"] [LAST_NAME="<last>"] [TITLE="<title>"] [PHONE="<number>"] [FAX="<fax_number>"] [NEW_MAILBOX_NAME="<mailbox>"] [TIMEZONE="<zone>"] [LANGUAGE="<language>"] [FILTERONLY="T F"] [SPAM_TAG="<tag>"] [SPAM_FOLDER="<folder>"] [SPAM_LEVEL="<level>"] Changes the mailbox attributes listed below. For example: CHANGE MAILBOX DOMAIN="example.com" MAILBOX="kenny" WORKGROUP="staff" PASSWORD="s0upKa" FIRST_NAME="Ken" LAST_NAME="Dryden" TITLE="Legal Counsel" PHONE=" " NEW_MAILBOX_NAME="newkenny" TIMEZONE="Europe/Amsterdam" LANGUAGE="en" FILTERONLY="T" If you specify a different domain, it creates the mailbox in that domain. If the domain is not specified, the new mailbox is created in the same domain as the old one. For example: CHANGE_MAILBOX DOMAIN="example.com" MAILBOX="rigby" NEW_MAILBOX_NAME="riggs@foo.com" This example renames rigby@example.com to riggs@foo.com. NOTE Only mailboxes, forwards, and filters can be renamed. Mailbox level permissions Chapter 3 APP Commands Mailbox commands 44

45 CHANGE_MAILBOX Required MAILBOX The current name of the mailbox. Can be used with NEW_MAILBOX_NAME when you want to rename the mailbox. DOMAIN Domain name. NOTE At least one optional attribute must be set. Optional PASSWORD Must consist entirely of printable, non-space characters. For guidelines on creating passwords, see User name and password rules on page 95. FIRST_NAME Mailbox user s first name. LAST_NAME Mailbox user s last name. PHONE Mailbox user s phone number. FAX Mailbox user s fax number; can be a maximum of 30 characters. TITLE Mailbox user s job title. WORKGROUP Adds a new workgroup for the specified mailbox; must be a valid workgroup in DOMAIN. NEW_MAILBOX_NAME The new name for the mailbox. Can be used with MAILBOX when you want to rename the mailbox. TIMEZONE Mailbox user's time zone. See Appendix 4, Timezone values. LANGUAGE Mailbox user s language. Valid values are as follows: da, en, es, de, fr, it, nl, no, pt_br, and sv. FILTERONLY Set the FILTERONLY value to F to change a filter-only mailbox to a regular mailbox. NOTE You cannot use this command to change a regular mailbox to a filteronly mailbox. <WILL DELETE THIS NOTE.> Chapter 3 APP Commands Mailbox commands 45

46 CHANGE_MAILBOX SPAM_TAG The value of this field will be appended to the subject of any message identified as spam. To remove an existing tag, as opposed to overwriting it, leave the value empty (i.e., SPAM_TAG=" "). Max. 30 char. SPAM_FOLDER Specifies the folder into which spam will be delivered for the mailbox with the following parameters: argument max length is 128 characters and should take the form of a dot separated folder path; individual folders cannot exceed 30 characters. SPAM_LEVEL The agressiveness level of spam filtering. Valid values are NORMAL, HIGH, VERY HIGH, and "" (none). When set to NORMAL, most spam is caught. When set to HIGH or VERY HIGH, more spam is caught, but the likelihood that non-spam messages (false positives) will be labelled as spam increases accordingly. If this value is not set, the mailbox uses the SPAM_LEVEL setting for the next highest level (for example, domain or company). NOTE For guidelines on defining the MAILBOX, PASSWORD, FIRST_NAME, and LAST_NAME attributes, see User name and password rules on page 95. Returns When the command is issued correctly, APP returns the following message: OK 0 Mailbox changed. Errors 10 Nonexistent domain (only in version 3.5 and earlier) 13 Nonexistent workgroup 14 Invalid mailbox name syntax. Mailbox name does not comply with RFC conventions 15 Invalid password syntax. Password must contain only alpha, numeric, alphanumeric and ~!@#$%^&'*() _=+/*\][{}:;><,.`? 15 Invalid password syntax. Password must not be empty. 15 Invalid password syntax. Password must not be more than 54 characters long. 17 Nonexistent mailbox 17 Invalid mailbox type (if mailbox is one of type: alias or forward_only) 111 Invalid SPAM_LEVEL 200 Problem in moving mailbox to workgroup 207 Invalid Timezone value Chapter 3 APP Commands Mailbox commands 46

47 CREATE_ALIAS_MAILBOX CREATE_ALIAS_MAILBOX ALIAS_MAILBOX="<mailbox>" MAILBOX="<mailbox>" DOMAIN="<domain>" Creates a nickname a mailbox name that points to an existing mailbox. For example: CREATE_ALIAS_MAILBOX ALIAS_MAILBOX="jon" MAILBOX="jonathan" DOMAIN="example.com" To create an intra-domain mailbox alias, specify the full address Workgroup level permissions Required MAILBOX A normal user mailbox that exists in the specified domain DOMAIN A domain that already exists on the system ALIAS_MAILBOX Alias name that points to MAILBOX; must be a new mailbox name that doesn t already exist in the domain. To create an intra-domain mailbox alias, specify the full address instead of the username. Optional Returns None When the command is issued correctly, APP returns the following message: OK 0 Mailbox created. Errors 10 Nonexistent domain (only in version 3.5 and earlier) 14 Invalid mailbox name syntax 16 Mailbox already exists 17 Nonexistent mailbox 112 Maximum number of mailboxes of this type for this domain reached Chapter 3 APP Commands Mailbox commands 47

48 RENAME_MAILBOX RENAME_MAILBOX DOMAIN="<domain>" OLD_MAILBOX="<mailbox>" NEW_MAILBOX="<mailbox>" Renames a mailbox and moves all of the mailbox's settings, folders, and aliases to the new name, leaving the old name unused. If you specify a different domain, it creates the mailbox in that domain. If the domain is not specified, the new mailbox is created in the same domain as the old one. For example: RENAME_MAILBOX DOMAIN="example.com" OLD_MAILBOX="rigby" NEW_MAILBOX="riggs@foo.com" This example renames rigby@example.com to riggs@foo.com. NOTE Only mailboxes, forwards, and filters can be renamed. Workgroup-level permissions or higher. Required DOMAIN OLD_MAILBOX NEW_MAILBOX Optional Returns None. When the command is issued correctly, APP returns the following message: OK 0 Mailbox renamed. Errors 10 Nonexistent domain (only in version 3.5 and earlier) 17 Nonexistent mailbox 17 Invalid mailbox type (OLD_MAILBOX isn't a regular user mailbox) 14 Invalid mailbox name syntax (NEW_MAILBOX is invalid mailbox) 16 Mailbox already exists (NEW_MAILBOX already exists) 35 Mailbox has calendaring (a mailbox that has calendaring enabled cannot be renamed) Chapter 3 APP Commands Mailbox commands 48