gtpo1m8uOperations

ZMAIL SETACLMAILBOX-Set the List of Users for a Mailbox

Use this command to set or change the access control list (ACL) for a mailbox in a TPF Internet mail server database. An access control list specifies the users who have permission to access the mailboxes.

Requirements and Restrictions

Format




Note:
You can use ZMAIL SAM as a short form of the ZMAIL SETACLMAILBOX command.

mailbox
is the mailbox for which you want to set or change the ACL entry.

account
is the account name of the user for which the ACL entry applies.

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 ( ) ).

rights
is the access right for the specified user. Specify the access right as one or more of the following letters:

l
specifies lookup access, which allows you to see that the mailbox exists.

r
specifies read access, which allows you to read the mailbox. You can select the mailbox, retrieve data, perform searches, and copy messages from the mailbox.

s
specifies seen access, which allows you to check if the mail has been read (seen) or not read (not seen).

w
specifies write access, which allows you to modify the following properties associated with mail items in the specified mailbox:

answered
Indicates if the mail has been answered.

flagged
Indicates that a mail item is marked urgent or requires special attention.

draft
Indicates that this is a draft mail item; that is, the composition of the message is not complete.

These flags are modified through the Internet Message Access Protocol (IMAP) client.

i
specifies insert access, which allows you to add (insert) new mail items to the mailbox.

p
specifies post access.
Note:
This access right is not meaningful for TPF mail.

c
specifies create access, which allows you to create new submailboxes of the mailbox.

d
specifies delete access, which allows you to delete mail items.

a
specifies administer access, which allows you to change the access control list for the mailbox.

You can also specify the access rights by using the following value:

all
specifies all (lrswipcda) access rights.

Additional Information

Examples

In the following example, account rocky is given look and read access to the tpfuser mailbox. A ZMAIL LISTACLMAILBOX command is entered to verify the updated access rights.

+--------------------------------------------------------------------------------+
|User:   zmail sam tpfuser rocky lr                                              |
|                                                                                |
|System: MAIL0003I 13:11:31 sam COMPLETED SUCCESSFULLY. NO OUTPUT TO DISPLAY     |
|                                                                                |
|User:   zmail listaclmailbox tpfuser                                            |
|                                                                                |
|System: MAIL0001I 13:11:31 START OF RESPONSE FROM ZMAIL listaclmailbox          |
|        tpfuser lrswipcda                                                       |
|        rocky lr                                                                |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

Related Information