gtpo1m8qOperations

ZMAIL LISTQUOTAROOT-Display the Quota Root for a Mailbox

Use this command to display the quota root for a mailbox, as well as the amount of storage currently being used by, and the maximum amount of storage allowed for, the mailboxes associated with that quota root. The maximum amount of storage allowed for one or more mailboxes is referred to as the quota. A quota is applied to a quota root, which is the point in a mailbox naming hierarchy where the quota (storage limit) is set. A quota root is set when you enter the ZMAIL SETQUOTA command. See ZMAIL SETQUOTA-Set the Storage Limit for a Mailbox for more information about quotas and quota roots.

Requirements and Restrictions

Format




Note:
You can use ZMAIL LQR or ZMAIL LQM as a short form of the ZMAIL LISTQUOTAROOT command.

mailbox
is the name of the mailbox for which you want to display the quota root. In addition to the quota root, the amount of storage currently being used by, and the maximum amount of storage allowed for, the mailboxes associated with that quota root is displayed.

You can specify as many as 30 characters for an account name. The total length of a mailbox string (including all submailboxes) can be as many as 256 characters. The name of an account or mailbox can consist of any alphanumeric character, underscore (_), hyphen (-), comma (,), semicolon (;), left parenthesis ( ( ), or right parenthesis ( ) ).

Additional Information

Examples

The storage for a mailbox is shown in the following format:

used/max

where:

used
Shows the number of 4-KB pool records currently being used to hold mail items in the mailboxes associated with the quota root of the specified mailbox.

max
Shows the maximum number of 4-KB pool records allowed for the mailboxes associated with the quota root of the specified mailbox.

In the following examples, assume the following mailboxes exist:

   tpfuser.inbox
   tpfuser.inbox.work.project1
   tpfuser.inbox.work.project2
   tpfuser.inbox.play
   tpfuser.inbox.todo
 

Also, assume that quotas were previously set as follows:

Therefore, in this example, mailboxes tpfuser.inbox and tpfuser.inbox.todo can use a maximum of 1000 4-KB pool records to hold mail items. Mailboxes tpfuser.inbox.work.project1 and tpfuser.inbox.work.project2 can use a maximum of 5000 4-KB pool records, and mailbox tpfuser.inbox.play can use a maximum of 3000 4-KB pool records. The following displays show the quota roots (the point where the storage limit is set) for each of the mailboxes, the amount of storage currently being used by these mailboxes, and the maximum amount of storage allowed for the mailboxes. This example also shows the error message that is displayed if you enter the ZMAIL LISTQUOTAROOT command for a placeholder name instead of an actual mailbox name.

+--------------------------------------------------------------------------------+
|User:   zmail listquotaroot tpfuser                                             |
|                                                                                |
|System: MAIL0001I 13:11:31 START OF RESPONSE FROM ZMAIL listquotaroot           |
|        inbox STORAGE 400/1000                                                  |
|        END OF DISPLAY                                                          |
|                                                                                |
|User:   zmail lqr tpfuser.inbox.work                                            |
|                                                                                |
|System: MAIL0002E 13:11:55 START OF ERROR RESPONSE FROM ZMAIL lqr               |
|        command failed: Mailbox does not exist                                  |
|        END OF DISPLAY                                                          |
|                                                                                |
|User:   zmail lq tpfuser.inbox.work                                             |
|                                                                                |
|System: MAIL0001I 13:11:31 START OF RESPONSE FROM ZMAIL lq                      |
|        STORAGE 3500/5000                                                       |
|        END OF DISPLAY                                                          |
|                                                                                |
|User:   zmail lqr tpfuser.inbox.work.project1                                   |
|                                                                                |
|System: MAIL0001I 13:12:16 START OF RESPONSE FROM ZMAIL lqr                     |
|        inbox.work STORAGE 3500/5000                                            |
|        END OF DISPLAY                                                          |
|                                                                                |
|User:   zmail lqr tpfuser.inbox.work.project2                                   |
|                                                                                |
|System: MAIL0001I 13:12:45 START OF RESPONSE FROM ZMAIL lqr                     |
|        inbox.work STORAGE 3500/5000                                            |
|        END OF DISPLAY                                                          |
|                                                                                |
|User:   zmail lqr tpfuser.inbox.play                                            |
|                                                                                |
|System: MAIL0001I 13:11:31 START OF RESPONSE FROM ZMAIL lqr                     |
|        inbox.play STORAGE 500/3000                                             |
|        END OF DISPLAY                                                          |
|                                                                                |
|User:   zmail lqr tpfuser.inbox.todo                                            |
|                                                                                |
|System: MAIL0001I 13:11:31 START OF RESPONSE FROM ZMAIL lqr                     |
|        inbox STORAGE 200/1000                                                  |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

Related Information