gtpo1m8pOperations

ZMAIL LISTQUOTA-Display Storage for a Mailbox

Use this command to display the amount of storage currently being used by, and the maximum amount of storage allowed for, one or more mailboxes in a TPF Internet mail server database. The maximum amount of storage allowed for 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 LQ as a short form of the ZMAIL LISTQUOTA command.

mailbox
is the name of the mailbox or the name of the placeholder in the mailbox hierarchy for which you want to display storage. The amount of storage currently being used for mail items in, and the maximum amount of storage allowed for, the specified mailbox hierarchy is displayed. Only mailboxes (or placeholder names) that have a set quota (or storage limit) are displayed. See the ZMAIL SETQUOTA command for more information about setting a quota for mailboxes.

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 specified mailbox hierarchy.

max
Shows the maximum number of 4-KB pool records allowed for the specified mailbox hierarchy.

In the following example, 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 these storage limits and the amount of storage currently being used by these mailboxes. This example also shows the error message that is displayed if you enter the ZMAIL LISTQUOTA command for a mailbox in the hierarchy for which there is no specific quota set.

+--------------------------------------------------------------------------------+
|User:   zmail listquota tpfuser                                                 |
|                                                                                |
|System: MAIL0001I 13:11:30 START OF RESPONSE FROM ZMAIL listquota               |
|        STORAGE 400/1000                                                        |
|        END OF DISPLAY                                                          |
|                                                                                |
|User:   zmail lq tpfuser.inbox.work                                             |
|                                                                                |
|System: MAIL0001I 13:11:45 START OF RESPONSE FROM ZMAIL lq                      |
|        STORAGE 3500/5000                                                       |
|        END OF DISPLAY                                                          |
|                                                                                |
|User:   zmail lq tpfuser.inbox.work.project1                                    |
|                                                                                |
|System: MAIL0002E 13:12:15 START OF ERROR RESPONSE FROM ZMAIL lq                |
|        command failed: Quota root does not exist                               |
|        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 lq tpfuser.inbox.play                                             |
|                                                                                |
|System: MAIL0001I 13:11:31 START OF RESPONSE FROM ZMAIL lq                      |
|        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