ListProc Help - Managing Lists - Information for List Owners

Last Updated: 05/06/2014

Overview

In addition to the commands listed in the ListProc Common Commands help document, list owners have the ability to manage the list they own. For example, a list owner can add and remove users from the list by sending commands to listproc@lists.colorado.edu, including the list password where necessary.

This tutorial is operating system independent.

Throughout this document, anything presented as word means you should substitute word with your particular information. For example, in this command line: subscribe listname first lastname
you would substitute listname with the real name of the list you want to join and substitute first lastname with your first name and last name. Important: Do not actually italicize any commands you send to ListProc.

Step 1

General Syntax

ListProc command general syntax is (all on one line):

command listname password arguments

where
command is the actual command, such as add or delete
listname is the real name of the list
password is the list owner's password, and
arguments is any additional information needed to complete each command.
 

Visual representation related to step 1

Step 2

Adding Subscribers

To add a subscriber, the command is structured as:

add listname password user-address first lastname

The display image shows how a list owner would add a subscriber to the bungee list (assuming that the password for the list is B0oingg).

When issuing the add command, remember these tips:

  • The entire command must be on one line. That is, you must type the whole command without hitting <ENTER>. Either an <ENTER> command and/or a command that spans more than one line are problematic. If your command does exceed a single line, put a space followed by an & sign at the point where the line breaks to tell the list server that the line continues.  For example:
         add bungeeb0oingg Chip.Buffalo@colorado.edu &
         Chip Buffalo
  • The subscriber's address must be entered exactly as it appears in his or her outbound e-mail. For example, if Chip Buffalo's outbound e-mail identifies him as buffaloc@colorado.edu, not Chip.Buffalo@colorado.edu, you must enter the address as buffaloc@colorado.edu or he will not be able to use this list. (Note: case does not matter.)
  • You must include the @colorado.edu portion of the e-mail address.
  • Whenever possible, let people subscribe themselves to lists rather than adding them manually, since self-subscription is easier and generally more effective. Read more about self-subscribing to lists.
Visual representation related to step 2

Step 3

Removing Subscribers

To remove someone from a list, issue the command to listproc@lists.colorado.edu like so (all on one line):

delete listname password user-address

where
listname is the name of the list from which the person should be removed
password is the password for the list, and
user-address is the e-mail address with which the user is subscribed to the list.

Note that, unlike with the add command, the user's first and last name are not included in the delete command.

The image displayed shows an example of removing Chip Buffalo from the bungee list.

 

Visual representation related to step 3

Step 4

Changing List Settings

List owners are also able to change the list configuration settings. There are numerous configuration options, all of which can be changed by sending a command to listproc@lists.colorado.edu in this format (all on one line):

configure listname password option argument

The word option is replaced with the actual option you want to change, and argument is replaced with additional information you must supply to complete the command, if any.

For example, if you wanted to change the list password after a former list owner has left, you would issue the command (all on one line):

Configure listname oldpassword password newpassword

Remember to replace the italicized words in the command with the actual information, such as the real name of your list and real passwords. The displayed image illustrates the command for changing the password for our sample list, bungee.

A partial list of options includes:
archive, no-archive, closed-subscriptions, open-subscriptions, digest, no-digests, message-limit, no-message-limit, moderated-edit, moderated-no-edit, unmoderated, reply-to-list, reply-to-sender, reply-to-omitted, etc.

To see all list configuration options, send ListProc the command help.

To review the current option settings for a list you own or manage, send this comand to listproc@lists.colorado.edu:
configuration listname password

Visual representation related to step 4

Step 5

Changing List Ownership

To add a new list owner or remove yourself as owner of a list, send the appropriate command to listproc@lists.colorado.edu.

The command to add a new owner (all on one line):

configure listname password owners address

replacing the italicized items with the appropriate list name and the e-mail address of the new owner.

Visual representation related to step 5

Step 6

Remove Old Owner

The command to remove an owner:

configure listname password remove-owners address

replacing the italicized items with the appropriate list name and the e-mail address of the owner being removed.
Note: owner addresses are case sensitive. Doing a review of the list first will show you the case of the owner address to be removed. For example, if Ralphie.Buffalo@colorado.edu is the list owner and you try to remove him by entering the address of ralphie.buffalo@colorado.edu, the list server will return an error.

 

Adding AND Removing

Both the add and remove owner commands can be sent, each on one line, in the same e-mail message to ListProc.  Important: Be sure to add the new owner before removing yourself as the owner.

Visual representation related to step 6


Related Tutorial(s)


BACK TO TOP