Subscribe to a mailing list.

Syntax

SUBSCRIBE list-name [[personal-name] address]

Parameters

list-name

Required parameter specifying the name of the mailing list to subscribe to. Wildcards 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.

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 list-name.txt exists in the PMDF_MAILSERV_MAIL_DIR directory, 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 may impose restrictions as to who may or may not subscribe to a given list.

Examples

SUBSCRIBE local-news 
      

This example shows the command to SUBSCRIBE oneself to the list local-news.

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 Section 2.5 for more details about subaddresses.

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 may 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 may not 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.