gtpo1m8oOperations

ZMAIL LISTMAILBOX-Display a List of Mailboxes

Use this command to display a list of mailboxes for an account in a TPF Internet mail server database.

Requirements and Restrictions

Format




Note:
You can use ZMAIL LM as a short form of the ZMAIL LISTMAILBOX command.

mailbox
is the mailbox that you want to display. You can use the following wildcard characters in the mailbox name to display mailboxes that match a particular name pattern:

Wildcard
Description

mailbox.*
Matches any string.

mailbox.%
Matches any string except the hierarchy separator. For example, if you enter zmail listmailbox user.inbox.foo.% and mailboxes user.inbox.foo.bar and user.inbox.foo.bar.old both exist, user.inbox.foo.bar is then displayed, but user.inbox.foo.bar.old is not.

Sometimes, when the % character is used as the last character of a pattern, nonmailbox names are listed in parentheses. This indicates that the name is not actually a mailbox, but there are submailboxes under that name. For example, if you enter zmail listmailbox user.inbox.foo.% and mailbox user.inbox.foo.bar.old exists, but user.inbox.foo.bar does not exist, (user.inbox.foo.bar) is then displayed.

If you use a wildcard character, you must specify at least the account name.

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

In the following example, all the submailboxes for mailbox curly are displayed.

+--------------------------------------------------------------------------------+
|User:   zmail lm curly                                                          |
|                                                                                |
|System: MAIL0001I 10:01:35 START OF RESPONSE FROM ZMAIL lm                      |
|        curly.inbox                                                             |
|        curly.inbox.foo                                                         |
|        curly.inbox.foo.bar                                                     |
|        curly.inbox.foo.blah                                                    |
|        curly.inbox.foo.bar.old                                                 |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

In the following example, all the submailboxes that begin with the string curly.inbox.foo.b are displayed.

+--------------------------------------------------------------------------------+
|User:   zmail lm curly.inbox.foo.b*                                             |
|                                                                                |
|System: MAIL0001I 10:01:35 START OF RESPONSE FROM ZMAIL lm                      |
|        curly.inbox.foo.bar                                                     |
|        curly.inbox.foo.blah                                                    |
|        curly.inbox.foo.bar.old                                                 |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

In the following example, all the submailboxes that begin with the string curly.inbox.foo.b at the same level are displayed.

+--------------------------------------------------------------------------------+
|User:   zmail lm curly.inbox.foo.b%                                             |
|                                                                                |
|System: MAIL0001I 10:01:35 START OF RESPONSE FROM ZMAIL lm                      |
|        curly.inbox.foo.bar                                                     |
|        curly.inbox.foo.blah                                                    |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

Related Information