cnsHomeSearch
cns
Basic commands for K-State list owners
last updated Oct. 28, 1999

Send questions and comments about K-State's LISTSERV services to listhelp@listserv.ksu.edu.


Overview

  • Send commands to listserv@listserv.ksu.edu
  • Parts of the command line
  • Example of message with commands sent to LISTSERV

    Add and delete members

  • Add a person to the list, Add many people to the list
  • Delete a list member, Delete multiple people from a list
  • Change a member's ID and/or address

    Membership list and mail delivery

  • Get the membership list
  • Find a member and their mail-delivery settings
  • Find which members are using a specific mail-delivery option
  • Set mail-delivery options for a member

    List security: command-confirm or password-protected

  • Change your list from command-confirm to password-protected
  • Register a personal password with LISTSERV
  • Forgot your personal password?
  • Change your LISTSERV personal password
  • Add/delete members on password-protected list

    Other tasks

  • Make ownership changes on the list
  • Get a summary of the K-State lists you belong to
  • Create a customized welcome message
  • Get a month's log of correspondence


    Send commands to listserv@listserv.ksu.edu

    1. Start your e-mail program.
    2. Address a mail message to listserv@listserv.ksu.edu. Don't put anything else in the mail header.
    3. In the message text, type the commands you want to use (see below). You may put as many commands as you want in the message, as long as each command is on a separate line.
    4. Erase any signature lines and/or turn off auto-inclusion of your signature file. (LISTSERV treats signature lines as commands and will send error messages saying "unknown command".)

    Parts of the command line

    Example of message with commands sent to LISTSERV

         To      : listserv@listserv.ksu.edu
         Cc      :
         Attchmnt:
         Subject :
         ----- Message Text -------------------------------------
         ADD     news-l   president@whitehouse.gov    Bill Clinton
         DELETE  news-l   editor@ksu.edu
         ADD     news-l   editor@lan.ksu.edu   William White
         REVIEW  news-l
         GET     news-l   LOG9709
    


    Add a person to the list

               ADD listname userid@address Firstname Lastname
         QUIET ADD listname userid@address Firstname Lastname
    

    Add many people to the list

         QUIET ADD listname DD=X IMPORT
         //X DD *
         userid1@address  Firstname  Lastname
         userid2@address  Firstname  Lastname
         userid3@address  Firstname  Lastname
         /*
    

    Delete a list member

               DELETE listname userid@address
         QUIET DELETE listname userid@address
    

    Delete multiple people from a list

         ok begin
               DELETE listname userid1@address
               DELETE listname userid2@address
               DELETE listname userid3@address
         QUIET DELETE listname userid4@address
         QUIET DELETE listname userid5@address
         QUIET DELETE listname userid6@address
         ok end
    

    Change a member's ID and/or address

         QUIET DELETE listname userid@address
         QUIET ADD listname newuserid@newaddress
    

    Get the membership list

    Send a message to listserv@listserv.ksu.edu with the following format, where listname is your list's ID:
         REVIEW listname
    

    Find a member and their mail-delivery settings

         QUERY listname FOR userid@address
         QUERY listname FOR *@address
    

    Find which members are using a specific mail-delivery option

         QUERY listname WITH CONCEAL FOR *@*
         QUERY listname WITH NOMAIL FOR *@*
         QUERY listname WITH REPRO FOR *@*
         QUERY listname WITH TOPICS: topics FOR *@*
    

    Set mail-delivery options for a member

         QUIET SET listname options FOR userid@address
         QUIET SET listname NOMAIL FOR userid@address
         QUIET SET listname REPRO FOR userid@address
         QUIET SET listname DIGEST FOR userid@address
    

    Get a month's log of correspondence

         GET listname LOGyymm
    


    Change your list from command-confirm to password-protected

    Command-confirm (Validate=Yes,Confirm) causes LISTSERV to prompt the owner for an "OK" message after an owner sends membership changes. This is considered more secure than a password-protected list since it prevents anyone else from forging/spoofing e-mail from the owner's address. It's also an easy way for new owners to manage their lists, but causes twice as much e-mail interaction. (Note: The GET and PUT commands used to revise a list's setup require a personal password, even for command-confirm lists.)

    Password-protected (Validate=Yes) means the owner defines a "personal password" once to LISTSERV, and then uses the password thereafter when sending list changes -- adding or deleting members, or revising the list's setups. Whenever LISTSERV receives a command accompanied by the owner's personal password, it won't ask for an "OK" message because the password verifies the owner's identity. Each owner has only one "personal password" for LISTSERV, regardless of how many lists he/she owns; this one password works for all the owner's password-protected lists. (When a personal password is registered or changed, the owner will still have to confirm or "OK" it to LISTSERV.)

    Almost all lists at K-State were initially set as command-confirm. To change your list to password-protected:

    1. Send e-mail to the LISTSERV counselor at listhelp@listserv.ksu.edu and request your list be changed. Be sure to specify:
      • that you want your list(s) changed from command-confirm to password-protected
      • the exact ID of each list you want changed

    2. Register a personal password with LISTSERV by sending e-mail to listserv@listserv.ksu.edu with this command in the text:
           PW  ADD  mypassword
      
        where "mypassword" is a 6- to 8-character alphanumeric password you choose. This password identifies you to LISTSERV. Don't use your Unix log-on password!

    3. After the LISTSERV counselor notifies you that your list has been changed to password-protected, you can add and delete members by sending e-mail to listserv@listserv.ksu.edu with the following format -- where "PW=mypassword" follows each command:
           ADD listname userid1@address Firstname Lastname PW=mypassword
           DEL listname userid2@address PW=mypassword
      
        where "mypassword" is your own personal password. LISTSERV will send a summary report as usual of the membership changes made.

    Register a personal password with LISTSERV

         PW  ADD  mypassword
    

    Forgot your personal password?

         PW  CHANGE  newpassword
    

    Change your LISTSERV personal password

         PW  CHANGE  newpassword
    

    Add/delete members on password-protected list

         ADD listname userid1@address Firstname Lastname PW=mypassword
         DEL listname userid2@address PW=mypassword
    

    Make ownership changes on the list

    1. Send e-mail to listserv@listserv.ksu.edu with this command in the text:
           GET listname (HEADER
      
    2. When the header arrives, you'll notice that all the header lines begin with an asterisk (*). It is essential to keep that same format.
      • Copy or cut-and-paste all the header lines into a work space.
      • Change the OWNER= settings and any others as needed.
      • Remove any comment marks (>) in front of the header lines.

    3. Copy the updated header into a message addressed to listserv@listserv.ksu.edu.
      Add a PUT command at the top. If you don't know which one to use, use the command-confirm PUT (LISTSERV will tell you if you need a password):
      • For a command-confirm list:   PUT listname LIST
      • For a password-protected list:   PUT listname LIST PW=mypassword

    4. Remove any signature lines (or type QUIT above them), then send the message to LISTSERV.

    Get a summary of the K-State lists you belong to

         QUERY  *
    

    Create a customized welcome message

    1. Review the LISTSERV manual section "Customizing LISTSERV's Default Mail Templates".
    2. Send this command to LISTSERV via e-mail: GET DEFAULT MAILTPL
    3. Once you receive the DEFAULT MAILTPL file from LISTSERV, store it on your local machine. Then make a copy of it and name the copy
      listname MAILTPL
      where listname is the name of your list. Keep the original DEFAULT MAILTPL file in case you make a mistake and need to copy it again.
    4. Edit the $SIGNUP section of your new listname MAILTPL file, inserting the text of your new welcome message. (See "Creating and editing a MAILTPL file for a list")
    5. Before you PUT the template file back to LISTSERV, be sure you've defined a "personal password" to LISTSERV by using the command "PW ADD mypassword". If you've done this previously but can't remember your password, send a "PW CHANGE newpassword" command to LISTSERV.
    6. Send your new MAILTPL file to listserv@listserv.ksu.edu with the following command at the top of the file's text:    PUT listname MAILTPL PW=mypassword


    Comments concerning K-State's LISTSERV services may be sent to listhelp@listserv.ksu.edu.


    start of standard bottom bar
    Home        Search        Directories        Calendar        Comments
    Kansas State University
    January 7, 2001