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
- You can enter this command only in CRAS state or higher.
- You must set the MAILDOMAIN environment variable to the domain that
contains the mailbox. Use the ZFILE export command to set the
environment variable.
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
- Online help information is available for this command. To display
the help information, enter one of the following:
ZMAIL HELP
ZMAIL ?
- The ZMAIL SETACLMAILBOX command is based on the setaclmailbox command of
the Cyrus project.
- All data entered with the ZMAIL commands is changed to lowercase.
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