Creating An Announcement List

Before we begin, decide what you would like the name of your mailing list to be. Whatever you decide on for the name, this will be what users of your mailing list will send emails to. For example, if you name your new mailing list 'bob', you will send messages to bob@mlm.yourdomain.tld for subscribers to read.

In order to create a new announcement list, you must have some minor knowledge of working with Telnet as well as downloading and uploading with FTP, and editing files with your favorite text editor.

Launch your telnet program, and log in to your account. After you have logged in, you should see a command prompt that looks similar to the following;


[Username@FQ-Six:~ ]$ 

Type the following at your command prompt, replacing *** with the name you chose for your mailing list and pressing the [Enter] key on your keyboard when you see {Enter}. This will create a new, un-moderated mailing list at listname@mlm.yourdomain.com The entire line must be lower case, this includes your mailing list name. If you type it in upper case, the list will not work.

cd {Enter}
ezmlm-make ~/*** ~/.qmail-*** *** mlm.yourdomain.com {Enter}

Now, close your Telnet session, and launch your FTP program. Change to the directory recently created for your new mailing list. For example, if your login name is jose, and your list's name is bob, change directories to /big/dom/xyourdomain/jose/bob/. Locate the file named 'editor', and download it to your own machine. Open this file in your favorite text editor (Notepad or similar will do fine). You should see three lines in that file, which will look similar to the following (with xdomain, jose and bob replaced with your own domain name, username and list name respectively);

|/usr/local/bin/ezmlm/ezmlm-reject
|/usr/local/bin/ezmlm/ezmlm-send '/big/dom/xdomain/jose/bob'
|/usr/local/bin/ezmlm/ezmlm-warn '/big/dom/xdomain/jose/bob' || exit 0

Above those lines you need to paste this line into the file, replacing user@domain.tld with your own email address that you would like to be the administrative email address. |egrep "^From:.*user@domain.tld" || (echo "This is an outgoing list only"; exit 100)

Note: Make sure you press Enter after the last line, so that the file ends with a blank line.
When you are finished, the contents of the file should look like the following;

|egrep "^From:.*user@domain.tld" || (echo "This is an outgoing list only"; exit 100)
|/usr/local/bin/ezmlm/ezmlm-reject
|/usr/local/bin/ezmlm/ezmlm-send '/big/dom/xdomain/jose/bob'
|/usr/local/bin/ezmlm/ezmlm-warn '/big/dom/xdomain/jose/bob' || exit 0

Upload in ASCII

Save this file, and re-upload it in place of the original 'editor' file. You may want to make a back up of the original first, just in case (name it something like editor.bak).

What this just did is quite simple in concept. Anyone can still subscribe to the mailing list, but only you can send messages to the mailing list. The way the program knows if it is you sending the message is by reading the 'From:' header in your email. If it contains the address you specified in the line added above, the message is allowed through to the entire list. If the 'From:' address is not the one specified, it returns an error to the user saying, "This is an outgoing list only". You may edit that text as you see fit by changing the text in the line added above.

Congratulations, you've just created your new Announcement list! You may be asking, 'Great, now how do I use it?'. The answer is simple and can be found in Step Two, Using your new Discussion List.

Using your new Announcement List
Here you will find the commands necessary to use your mailing list, along with a short description of what each one does. All commands are sent to ezmlm via email, making the list very simple to use and maintain. For sake of simplicity, wherever you see list, replace it with the name of your mailing list.

To subscribe to the mailing list, simply send a blank email to
list-subscribe@mlm.yourdomain.com
Ezmlm will send back an email from a special confirmation email address. Simply click the [Reply] button in your mail reader, and send another blank email to this confirmation address. Ezmlm will then reply with a message that your email address has been added to the subscribers list.

To unsubscribe from the mailing list, simply send a blank email to
list-unsubscribe@mlm.yourdomain.com
Ezmlm will send back an email from a special confirmation email address. Simply click the [Reply] button in your mail reader, and send another blank email to this confirmation address. Ezmlm will then reply with a message that your email address has been removed to the subscribers list.

To retrieve a specific message number from ezmlm, send a blank email to
list-get.###@mlm.yourdomain.com
where ### is replaced with the number of the message you'd like to retrieve. If ezmlm has record of that message number, it will send it to your email box right away. If there is no record of that message number, ezmlm will tell you that it was unable to find that message.

For a generic help message, send a blank email to
list-help@mlm.yourdomain.com
Ezmlm will respond with a list of commands that are available, as well as instructions on how to use them, and where to send them.

To add an email address to your announcement list, log in to your domain account via Telnet, and type the following (replace *** with the name of your announcement mailing list, replace user@domain.tld with the email address you want to add to the list);
ezmlm-sub *** user@domain.tld

To remove a specific email address from your announcement list, log in to your domain account via Telnet and type the following (replace *** with the name of your announcement mailing list, replace user@domain.tld with the email address you want to remove from the list);
ezmlm-unsub *** user@domain.tld

To see a list of all email addresses subscribed to your announcement list, log in to your domain account via Telnet and type the following (replace *** with the name of your announcement mailing list);
ezmlm-list ***

Finally, to send messages to everyone subscribed to the mailing list, you can send an email to
list@mlm.yourdomain.com
containing the body of the message you want to send. Only the list owner can send messages to the list.

Home