12 – SUBSCRIBE
Subscribe to a mailing list.
Syntax
SUBSCRIBE list-name [[personal-name] address]
12.1 – Parameters
list-name
Required parameter specifying the name of the mailing list to
subscribe to. Wild cards are not allowed.
personal-name
Optional parameter specifying the personal name for the address
to subscribe to the mailing list. If this parameter is omitted,
no personal name information will be included in the subscribed
address.
address
Optional parameter specifying the fully-qualified address to
subscribe to the mailing list. If no address is specified, the
From: address from the requesting message will be used.
12.2 – Description
The SUBSCRIBE command adds either your address or a specified
address to the specified mailing list. A response message
reporting the success or failure of the subscription request will
be returned. If the file PMDF_MAILSERV_MAIL_DIR:list-name.TXT
exists, it will be sent to you.
Use the UNSUBSCRIBE command to subsequently unsubscribe from a
mailing list; use the DIRECTORY/LIST or LISTS command to obtain
information on available mailing lists.
Note that some mail servers can impose restrictions as to who may
or may not subscribe to a given list.
12.3 – Examples
1.SUBSCRIBE LOCAL-NEWS
This example shows the command to SUBSCRIBE oneself to the list
LOCAL-NEWS.
2.SUBSCRIBE LOCAL-NEWS "John Doe" <jdoe+local-news@example.com>
This example shows the user jdoe@example.com subscribing the
address "John Doe" <jdoe+local-news@example.com> to the list
LOCAL-NEWS. That is, this example shows a subscription request
using a more formal address format, one that includes an RFC
822 personal name as well as the actual address, and where
the address includes a subaddress; see for more details about
subaddresses.
12.4 – Error messages
%MAILSERV-W-
ALREADYSUB, address is already subscribed to the mailing list
You are already subscribed to the mailing list. If you used
the optional address parameter, then the specified address is
already subscribed. Check to make sure that you specified the
correct mailing list name or address or both.
%MAILSERV-W-CANTDELETE, cannot delete old mailing list file
An error occurred while trying to delete the old mailing list
file. Try again later; the postmaster in charge of the mail
server has been notified.
%MAILSERV-W-CANTUPDATE, cannot update mailing list file
An error occurred while trying to update the mailing list. Try
again later; the postmaster in charge of the mail server has
been notified.
%MAILSERV-W-ILLADDRESS, illegal address
You specified an illegal or invalid address for the optional
address parameter. Resend the command either omitting the
address entirely or specifying a valid address.
%MAILSERV-W-INSFPRM, missing command parameters
You failed to supply the name of the mailing list to subscribe
to. Resend the command with a list name specification.
%MAILSERV-W-LNF, list not found
The mailing list you specified does not exist. Resend the
command specifying the name of a valid mailing list. You can
use the DIRECTORY/LIST command to obtain a listing of the valid
mailing list names.
%MAILSERV-W-LSTCREERR, unable to create new mailing list
The mailing list specified by the list-name parameter does not
exist and could not be created. Check to make sure that you
specified the correct list name.
%MAILSERV-W-LSTLOCKED, mailing list currently locked by another user
The mailing list is currently locked; you cannot subscribe to
it at this time. Try resending the command again later.
%MAILSERV-F-NOMAILLIST, mailing lists are not enabled
The mail server is not configured to operate as a list server.
%MAILSERV-W-PRV, insufficient privilege or file protection violation
You are not allowed to subscribe to this mailing list.
13 – UNSUBSCRIBE
Unsubscribe from a mailing list.
Syntax
UNSUBSCRIBE list-name [address]
13.1 – Parameters
list-name
Required parameter specifying the name of the mailing list to
unsubscribe from Wild cards are not allowed.
address
Optional parameter specifying the address to remove from the
mailing list. If no address is specified, the From: address from
the requesting message will be used.
13.2 – Description
The UNSUBSCRIBE command removes either your address or the
address you specify from the specified mailing list. A response
message reporting the success or failure of the unsubscribe
request will be returned.
Typically, the use of the optional address parameter is
restricted.
13.3 – Error messages
%MAILSERV-W-CANTDELETE, cannot delete old mailing list file
An error occurred while trying to delete the old mailing list
file. Try again later; the postmaster in charge of the mail
server has been notified.
%MAILSERV-W-CANTUPDATE, cannot update mailing list file
An error occurred while trying to update the mailing list. Try
again later; the postmaster in charge of the mail server has
been notified.
%MAILSERV-W-ILLADDRESS, illegal address
You specified an illegal or invalid address for the optional
address parameter. Resend the command either omitting the
address entirely or specifying a valid address.
%MAILSERV-W-INSFPRM, missing command parameters
You failed to supply the name of the mailing list to
unsubscribe from. Resend the command with a list name
specification.
MAILSERV-W-LNF, mailing list not found
The mailing list you specified does not exist. Resend the
command specifying the name of a valid mailing list. You can
use the DIRECTORY/LIST command to obtain a listing of the valid
mailing list names.
%MAILSERV-W-LSTCREERR, unable to create new mailing list
The mailing list specified by the list-name parameter does not
exist and could not be created. Check to make sure that you
specified the correct list name.
%MAILSERV-W-LSTLOCKED, mailing list currently locked by another user
The mailing list is currently locked; you cannot unsubscribe
from it at this time. Try again later.
%MAILSERV-F-NOMAILLIST, mailing lists are not enabled
The mail server is not configured to operate as a list server.
%MAILSERV-W-NOSUCHADR, no such address subscribed to the mailing list
You are not subscribed to the specified mailing list. If you
used the optional address parameter, then the specified address
is not subscribed. Check to make sure that you specified the
correct mailing list name or address or both.
%MAILSERV-W-PRV, insufficient privilege or file protection violation
You are not allowed to unsubscribe from this mailing list or
unsubscribe addresses other than your own from the list.