home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #16 / NN_1992_16.iso / spool / vmsnet / mail / mx / 758 < prev    next >
Encoding:
Internet Message Format  |  1992-07-26  |  46.2 KB

  1. Path: sparky!uunet!usc!noiro.acs.uci.edu!unogate!mvb.saic.com!mx-list
  2. From: Helmut Springer <helmut@bonnie.physik.uni-stuttgart.de>
  3. Newsgroups: vmsnet.mail.mx
  4. Subject: RE: help!!  need information on lists on MX V3.1c
  5. Message-ID: <0095E317.D1807F20.9814@bonnie.physik.uni-stuttgart.de>
  6. Date: Mon, 27 Jul 1992 09:31:36 +0200
  7. Organization: Mx-List<==>Vmsnet.Mail.Mx Gateway
  8. X-Gateway-Source-Info: Mailing List
  9. Lines: 1492
  10.  
  11. Hi Matt,
  12.  
  13. >I need to get a copy of the MX manual via FTP how can I do so???
  14. ftp to ftp.spc.edu and get the file mx031.k_z (and eventually the unpacker
  15. lzdcmp.exe), contaons the whole docu...
  16.  
  17. >How do I set up a list(s)
  18. it's easy, MLF-guide appended  8-)
  19.  
  20. enjoy
  21.   helmut
  22.  
  23.  
  24.  
  25. _____________________________________cut here_____________________________
  26.  
  27.  
  28.           Message Exchange Mailing List/File
  29.           Server Guide
  30.  
  31.  
  32.  
  33.  
  34.           March, 1992
  35.  
  36.  
  37.           This manual describes the management and operation
  38.           of Message Exchange, electronic mail software for VMS
  39.           systems.
  40.  
  41.  
  42.  
  43.  
  44.  
  45.           Revision/Update Information:  This is a revised manual.
  46.                                         Revision bars indicate
  47.                                         changes made since the
  48.                                         last version of the
  49.                                         software.
  50.  
  51.           Operating System and Version: VMS V5.0 or later
  52.  
  53.           Software Version:             Message Exchange V3.1
  54.  
  55.           Engineering Computing Services
  56.           Rensselaer Polytechnic Institute
  57.           Troy, New York
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.           ________________________
  74.           10 March 1992
  75.  
  76.           Permission is granted to copy and redistribute this
  77.           document for no commercial gain.
  78.  
  79.           This document is still under construction. Comments
  80.           and suggestions for improvements may be forwarded to
  81.           MX-List@vms.ecs.rpi.edu.
  82.  
  83.           The information in this document is subject to change
  84.           without notice and should not be construed as a
  85.           commitment by Rensselaer Polytechnic Institute.
  86.           Rensselaer assumes no responsibility for any errors
  87.           that may appear in this document.
  88.  
  89.           DISCLAIMER: The software described in this document
  90.           is provided "as is". No guarantee is made by the
  91.           author or the author's employer as to the suitability,
  92.           reliability, security, usefulness, or performance of
  93.           this software.
  94.  
  95.           The following are trademarks of Digital Equipment
  96.           Corporation:
  97.  
  98.           DEC                   DECnet                ULTRIX
  99.           VAX                   VAXcluster            VMS
  100.  
  101.           Jnet is a trademark of Joiner Associates, Inc.
  102.  
  103.           MultiNet is a trademark of SRI International and TGV,
  104.           Inc.
  105.  
  106.           TCPware is a trademark of Process Software
  107.           Corporation.
  108.  
  109.           __________
  110.           Copyright )1992 Rensselaer Polytechnic Institute
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.           _______________________________________________________
  120.  
  121.           Contents
  122.  
  123.                 _________________________________________________
  124.                 PREFACE                                       vii
  125.  
  126.           _______________________________________________________
  127.           CHAPTER 1  THE MAILING LIST/FILE SERVER             1-1
  128.  
  129.                 _________________________________________________
  130.                 1.1   MAILING LISTS                           1-1
  131.  
  132.                 _________________________________________________
  133.                 1.2   FILE SERVERS                            1-2
  134.  
  135.  
  136.           _______________________________________________________
  137.           CHAPTER 2  USING MLF_CONFIG.COM                     2-1
  138.  
  139.                 _________________________________________________
  140.                 2.1   LIST SERVER MANAGERS                    2-1
  141.  
  142.                 _________________________________________________
  143.                 2.2   MAILING LISTS                           2-2
  144.  
  145.                 _________________________________________________
  146.                 2.3   FILE SERVERS                            2-2
  147.  
  148.                 _________________________________________________
  149.                 2.4   USING THE RESULTS                       2-3
  150.  
  151.  
  152.           _______________________________________________________
  153.           CHAPTER 3  MAILING LISTS                            3-1
  154.  
  155.                 _________________________________________________
  156.                 3.1   ARCHIVES                                3-1
  157.  
  158.  
  159.  
  160.  
  161.                                                               iii
  162.  
  163.  
  164.  
  165.  
  166.           Contents
  167.  
  168.  
  169.  
  170.                 _________________________________________________
  171.                 3.2   PROTECTION CODES                        3-2
  172.  
  173.                 _________________________________________________
  174.                 3.3   AUTOMATIC REQUEST HANDLING              3-4
  175.  
  176.                 3.3.1     Control Commands  ______________    3-7
  177.  
  178.                 _________________________________________________
  179.                 3.4   USER NOTIFICATION MESSAGES              3-7
  180.  
  181.                 _________________________________________________
  182.                 3.5   VMS MAIL FORWARDING                     3-9
  183.  
  184.                 _________________________________________________
  185.                 3.6   USING THE ADD AND REMOVE COMMANDS      3-10
  186.  
  187.                 3.6.1     ADD  ___________________________   3-10
  188.  
  189.                 3.6.2     REMOVE  ________________________   3-11
  190.  
  191.                 _________________________________________________
  192.                 3.7   DELETING A MAILING LIST                3-12
  193.  
  194.           _______________________________________________________
  195.           CHAPTER 4  FILE SERVERS                             4-1
  196.  
  197.                 _________________________________________________
  198.                 4.1   PACKAGES                                4-1
  199.  
  200.                 _________________________________________________
  201.                 4.2   HELP FILE                               4-2
  202.  
  203.                 _________________________________________________
  204.                 4.3   FILE SERVER COMMANDS                    4-3
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.           iv
  212.  
  213.  
  214.  
  215.  
  216.                                                          Contents
  217.  
  218.  
  219.  
  220.           _______________________________________________________
  221.           APPENDIX A  TROUBLESHOOTING MLF PROBLEMS            A-1
  222.  
  223.                 _________________________________________________
  224.                 A.1   CASE SENSITIVITY                        A-1
  225.  
  226.  
  227.           _______________________________________________________
  228.           APPENDIX B  EXAMPLE: MAILING LIST WITH ARCHIVE
  229.                       SERVER                                  B-1
  230.  
  231.  
  232.           _______________________________________________________
  233.           TABLES
  234.  
  235.                 3-1       Mailing list protection
  236.                           classes  _______________________    3-2
  237.  
  238.                 3-2       Mailing list protection codes  _    3-2
  239.  
  240.                 3-3       Typical protection codes  ______    3-3
  241.  
  242.                 3-4       MLF -Request commands  _________    3-4
  243.  
  244.                 3-5       MLF LISTSERV commands  _________    3-5
  245.  
  246.                 3-6       User notification messages  ____    3-7
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                 v
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.           _______________________________________________________
  270.  
  271.           Preface
  272.  
  273.  
  274.           This guide describes the management and operation
  275.           of the Message Exchange Mailing List/File Server (MX
  276.           MLF).
  277.  
  278.           __________________________________________________________________
  279.  
  280.           Intended Audience
  281.  
  282.           This manual is intended for use by the system
  283.           manager or any individual responsible for installing
  284.           and maintaining MX, and for users responsible for
  285.           creating or managing MX-based mailing lists and file
  286.           servers. The reader should be generally familiar
  287.           with VMS system concepts, electronic mail systems and
  288.           networking terminology.
  289.  
  290.           __________________________________________________________________
  291.  
  292.           Document Structure
  293.  
  294.           This guide consists of
  295.  
  296.           Chapter 1   Contains a general description of MLF.
  297.  
  298.           Chapter 2   Describes how to use the MLF_CONFIG
  299.                       procedure.
  300.  
  301.           Chapter 3   Describes how to manage a mailing list.
  302.  
  303.           Chapter 4   Describes how to manage a file server.
  304.  
  305.           __________________________________________________________________
  306.  
  307.           Related Documents
  308.  
  309.           You can find additional information in the following
  310.           documents:
  311.  
  312.           o  Message Exchange Management Guide describes how to
  313.              manage MX and contains the command dictionary for
  314.              the MX Control Program (MCP).
  315.  
  316.                                                               vii
  317.  
  318.  
  319.  
  320.  
  321.           Preface
  322.  
  323.  
  324.  
  325.           o  Message Exchange User's Guide describes MX features
  326.              available to general users.
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.           viii
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.           _______________________________________________________
  376.  
  377.    1      The Mailing List/File Server
  378.  
  379.  
  380.  
  381.  
  382.           Message Exchange (MX) includes a program called the
  383.           Mailing List/File Server (MLF). This program provides
  384.           the services needed to distribute messages to mailing
  385.           lists and manage those lists through mailed commands.
  386.           It also provides services for distributing packages of
  387.           files by electronic mail.
  388.  
  389.           __________________________________________________________________
  390.  
  391.    1.1    Mailing Lists
  392.  
  393.           When talking about electronic mail, the term mailing
  394.           list is generally used to describe an E-mail address
  395.           that forwards messages to one or more subscribers.
  396.           Mailing lists abound on the Internet and BITNET, on a
  397.           wide variety of technical and non-technical topics.
  398.  
  399.           Unfortunately, there are no standards on the
  400.           implementation of mailing lists, so their use will
  401.           vary depending on the systems on which the mailing
  402.           lists are set up. For the most part however, mailing
  403.           lists can be broken down into two basic types:
  404.           Internet and BITNET.
  405.  
  406.           For an Internet-style mailing list, there are
  407.           generally two addresses: one for the mailing list
  408.           itself, and one for "administrivia" (subscription
  409.           requests, etc.). The administrative address is usually
  410.           the mailing list name with "-request" added. For
  411.           example, the mailing list for discussing Message
  412.           Exchange is MX-List@vms.ecs.rpi.edu. Subscription
  413.           requests, removals, or comments about the list are
  414.           sent to MX-List-request@vms.ecs.rpi.edu.
  415.  
  416.                                                               1-1
  417.  
  418.  
  419.  
  420.  
  421.           The Mailing List/File Server
  422.  
  423.  
  424.  
  425.           Most mailing lists on BITNET hosts are implemented
  426.           using Eric Thomas's LISTSERV, a package developed
  427.           specifically for automated handling of mailing
  428.           lists. One LISTSERV on a system, at address
  429.           LISTSERV@hostname, manages all the mailing lists
  430.           offered on that system, and provides automatic
  431.           administrative request handling.
  432.  
  433.           MLF provides support for both the Internet -request
  434.           interface and the BITNET LISTSERV interface for its
  435.           automatic command handling.
  436.  
  437.           __________________________________________________________________
  438.  
  439.    1.2    File Servers
  440.  
  441.           As with mailing lists, there are no standards for file
  442.           servers. There are several file server implementations
  443.           in existence: LISTSERV, VMSSERV, MAILSERV, and several
  444.           others. Some of these file servers accept commands
  445.           via BITNET immediate messages, some only by E-mail
  446.           messages. Some take commands on the subject line of
  447.           a message, and some in the body of a message. The way
  448.           files are distributed can also vary from server to
  449.           server.
  450.  
  451.           The MLF file server command interface accepts commands
  452.           by E-mail only, and returns files only by E-mail.
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.           1-2
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.           _______________________________________________________
  476.  
  477.    2      Using MLF_CONFIG.COM
  478.  
  479.  
  480.  
  481.  
  482.           MLF comes with a command procedure, MLF_CONFIG.COM,
  483.           which is placed at installation time in the MX_DIR:
  484.           directory. This command procedure uses a simple
  485.           question-and-answer script to develop the MCP commands
  486.           needed to create mailing lists and file servers.
  487.  
  488.           __________________________________________________________________
  489.  
  490.    2.1    List Server Managers
  491.  
  492.           MLF_CONFIG begins by reading in your current MX
  493.           configuration and checking to see if you have any
  494.           list server managers (called SYSTEM_USERS in MCP)
  495.           defined. If not, MLF_CONFIG will prompt you first for
  496.           the primary list server manager's address, followed by
  497.           any other users who should be given manager access to
  498.           mailing lists.
  499.  
  500.           List server managers are granted control access to
  501.           all mailing lists on the system, allowing them to use
  502.           the ADD and REMOVE commands. In addition, they are
  503.           granted access through the SYSTEM protection class on
  504.           all mailing lists.
  505.  
  506.           Note: The mailing list processor is case sensitive
  507.           when matching the username portion of addresses. Be
  508.           sure to enter the list manager addresses using the
  509.           correct case. MX, by default, converts all usernames
  510.           to lower case for local users, so you should generally
  511.           use lower case when specifying local list managers'
  512.           addresses.
  513.  
  514.  
  515.  
  516.                                                               2-1
  517.  
  518.  
  519.  
  520.  
  521.           Using MLF_CONFIG.COM
  522.  
  523.  
  524.  
  525.           Primary List Server Manager
  526.  
  527.           The first address on the SYSTEM_USERS list is for
  528.           the primary list server manager. The primary list
  529.           server manager's address is used as the return address
  530.           for non-list-related mail messages sent by MLF. If
  531.           you would rather not have an actual person's E-mail
  532.           address be used for that purpose, you should set up an
  533.           alias.
  534.  
  535.           __________________________________________________________________
  536.  
  537.    2.2    Mailing Lists
  538.  
  539.           Once you have defined your list server managers, or if
  540.           they were already defined before you ran MLF_CONFIG,
  541.           you can then set up one or more mailing lists. MLF_
  542.           CONFIG will prompt you for the name of the mailing
  543.           list and the address of the owner of the list, which
  544.           are required. It will then prompt you for the optional
  545.           information related to the list.
  546.  
  547.           To move on to the File Server section of MLF_CONFIG,
  548.           just press RETURN when prompted for a mailing list
  549.           name.
  550.  
  551.           Note: The mailing list processor is case sensitive when
  552.           matching the username portion of addresses. Be sure to
  553.           enter the owner addresses using the correct case. MX,
  554.           by default, converts all usernames to lower case for
  555.           local users, so you should generally use lower case
  556.           when specifying local owner addresses.
  557.  
  558.           __________________________________________________________________
  559.  
  560.    2.3    File Servers
  561.  
  562.           After the mailing lists phase, MLF_CONFIG will ask
  563.           you about file servers. To create a file server, you
  564.           must specify the name, manager's address, and the
  565.           device and directory that will serve as the root of
  566.           the file server. MLF_CONFIG will prompt you for this
  567.           information, and will create the root directory for
  568.  
  569.           2-2
  570.  
  571.  
  572.  
  573.  
  574.                                              Using MLF_CONFIG.COM
  575.  
  576.  
  577.  
  578.           you, if you wish. It will then prompt for optional
  579.           information regarding the file server.
  580.  
  581.           __________________________________________________________________
  582.  
  583.    2.4    Using the Results
  584.  
  585.           When MLF_CONFIG finishes, it leaves you with an
  586.           MCP command file, called MX_DIR:MLF_CONFIG.MCP by
  587.           default. You should review the contents of that
  588.           file; if satisfied with the results, you should then
  589.           execute the command file in MCP, save the resulting
  590.           configuration information, then reset the Router and
  591.           MLF processes to have the new mailing lists and file
  592.           servers recognized:
  593.  
  594.                $ MCP
  595.                MCP> @MLF_CONFIG.MCP
  596.                MCP> SAVE
  597.                MCP> RESET/CLUSTER ROUTER,MLF
  598.  
  599.           Your newly-created mailing lists and file servers will
  600.           then be ready.
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.                                                               2-3
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.           _______________________________________________________
  629.  
  630.    3      Mailing Lists
  631.  
  632.  
  633.  
  634.  
  635.           The MCP DEFINE LIST command is used to create a
  636.           mailing list. The mailing list processor supports
  637.           the automatic archiving of mailing list messages,
  638.           automatic subscription processing, and limited remote
  639.           control of mailing lists. In addition, mailing lists
  640.           can be protected in a variety of ways to restrict the
  641.           automatic subscription facility as well as postings to
  642.           the list.
  643.  
  644.           Two local addresses are set up for each mailing list:
  645.           one for the list itself and a request address (list-
  646.           name-REQUEST). The mailing list processor accepts
  647.           subscription requests and other control messages on a
  648.           list's request address.
  649.  
  650.           The list of subscribers is maintained by the MLF agent
  651.           in the file MX_MLIST_DIR:list-name.MAILING_LIST. The
  652.           format used for this file is not readable by humans;
  653.           you should use the list server command interface or
  654.           the MCP REVIEW command to examine subscriber list.
  655.  
  656.           __________________________________________________________________
  657.  
  658.    3.1    Archives
  659.  
  660.           A mailing list is archived automatically by the
  661.           mailing list processor when the /ARCHIVE qualifier
  662.           is used on the DEFINE LIST command. You must specify
  663.           at least a device and directory for the archive. The
  664.           file name for the archive defaults to the name of
  665.           the mailing list, and the file type for the archive
  666.           defaults to yyyy-mm, the current year and month. By
  667.           keeping with the default, a new archive file will be
  668.           created every month.
  669.  
  670.                                                               3-1
  671.  
  672.  
  673.  
  674.  
  675.           Mailing Lists
  676.  
  677.  
  678.           __________________________________________________________________
  679.  
  680.    3.2    Protection Codes
  681.  
  682.           The standard VMS protection code syntax is used to
  683.           describe access to mailing lists. Table 3-1 describes
  684.           how each of the protection classes relates to mailing
  685.           lists, and Table 3-2 describes the protection codes.
  686.  
  687.           Table_3-1__Mailing_list_protection_classes_____________
  688.  
  689.           Class_______Description________________________________
  690.  
  691.           SYSTEM      any address matching one of the addresses
  692.                       on the system user list (see DEFINE
  693.                       SYSTEM_USERS)
  694.  
  695.           OWNER       any address matching one of the owner
  696.                       addresses specified on the /OWNER
  697.                       qualifier
  698.  
  699.           GROUP       any address matching one the addresses on
  700.                       the subscriber list for the mailing list
  701.  
  702.           WORLD_______any_other_address__________________________
  703.  
  704.           Table_3-2__Mailing_list_protection_codes_______________
  705.  
  706.           Code________Description________________________________
  707.  
  708.           R (Read)    allows the use of the REVIEW command
  709.  
  710.           W (Write)   allows the user to post messages to the
  711.                       list
  712.  
  713.           E (Enroll)  allows the automatic handling of the
  714.                       SUBSCRIBE command
  715.  
  716.           D (Delete)  allows the automatic handling of the
  717.           ____________SIGNOFF_command____________________________
  718.  
  719.           Note that Enroll access is only meaningful to WORLD-
  720.           class users, and Delete access is only meaningful
  721.  
  722.           3-2
  723.  
  724.  
  725.  
  726.  
  727.                                                     Mailing Lists
  728.  
  729.  
  730.  
  731.           to GROUP-class users. For most, if not all, mailing
  732.           lists, you should grant RWED access to both SYSTEM
  733.           and OWNER classes. SYSTEM and OWNER also implicitly
  734.           have Control access, allowing them to add and remove
  735.           other users from the mailing list. Some typical
  736.           protection codes for GROUP and WORLD users are given
  737.           in Table 3-3.
  738.  
  739.           Table_3-3__Typical_protection_codes____________________
  740.  
  741.           (G:RWED,W:RWE)   Public list. Anyone can subscribe,
  742.                            sign off, and review the list; anyone
  743.                            can post to the list.
  744.  
  745.           (G:RWED,W:E)     Semi-public list. Anyone can
  746.                            subscribe and sign off the list, but
  747.                            only subscribers can review or post
  748.                            to the list.
  749.  
  750.           (G:W,W)          Private list. Only subscribers
  751.                            can post to the list, and all
  752.                            subscription requests are screened
  753.                            by the owners of the mailing list.
  754.  
  755.           (G,W)            One-way list. Only the owners can
  756.                            post to the list, and they also
  757.           _________________screen_all_the_subscription_requests._
  758.  
  759.           Note: Since electronic mail can readily be forged,
  760.           you should not depend on this protection scheme for
  761.           absolute security of your mailing lists. The mailing
  762.           list processor attempts no authentication of addresses
  763.           when it receives messages.
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.                                                               3-3
  773.  
  774.  
  775.  
  776.  
  777.           Mailing Lists
  778.  
  779.  
  780.           __________________________________________________________________
  781.  
  782.    3.3    Automatic Request Handling
  783.  
  784.           MLF will answer requests automatically at both a
  785.           list's -Request address and through the LISTSERV
  786.           interface. The commands it recognizes through the -
  787.           Request interface are listed in Table 3-4. LISTSERV
  788.           commands are listed in Table 3-5.
  789.  
  790.           Table_3-4__MLF_-Request_commands_______________________
  791.  
  792.           Command____________________Description_________________
  793.  
  794.           ADD address[,...]          Control command: allows
  795.                                      list owner to add other
  796.                                      users to the list.
  797.  
  798.           HELP                       Sends file MX_MLIST_
  799.                                      DIR:MLIST_HELP.TXT.
  800.  
  801.           LIST                       Lists all available mailing
  802.                                      lists.
  803.  
  804.           QUERY                      Returns the subscriber's
  805.                                      status on the list.
  806.  
  807.           REMOVE address[,...]       Control command: allows
  808.                                      list owner to remove other
  809.                                      users from the list.
  810.        |
  811.        |  REVIEW                     Returns the list of
  812.        |                             subscribers.
  813.  
  814.           SET [NO]MAIL               Enables/disables receipt of
  815.                                      list messages.
  816.        |
  817.        |  SET [NO]CONCEAL            Controls whether subscriber
  818.        |                             is concealed from view in
  819.        |                             REVIEW listings.
  820.  
  821.  
  822.           3-4
  823.  
  824.  
  825.  
  826.  
  827.                                                     Mailing Lists
  828.  
  829.  
  830.  
  831.        |  Table_3-4_(Cont.)__MLF_-Request_commands_______________
  832.        |
  833.        |  Command____________________Description_________________
  834.        |
  835.        |  SET [NO]REPRO              Controls whether subscriber
  836.        |                             receives a posting s/he
  837.        |                             makes to the mailing list.
  838.  
  839.           SIGNOFF                    Removes the user from the
  840.                                      list of subscribers.
  841.  
  842.           SUBSCRIBE                  Adds the user to the
  843.           ___________________________subscriber_list.____________
  844.  
  845.  
  846.           Table_3-5__MLF_LISTSERV_commands_______________________
  847.  
  848.           Command____________________Description_________________
  849.  
  850.           ADD list-name              Control command: allows
  851.           address[,...]              list owner to add other
  852.                                      users to the list.
  853.  
  854.           HELP                       Sends file MX_MLIST_
  855.                                      DIR:MLIST_HELP.TXT.
  856.  
  857.           LIST                       Lists all available mailing
  858.                                      lists.
  859.  
  860.           QUERY list-name            Returns the subscriber's
  861.                                      status on the list.
  862.  
  863.           REMOVE list-name           Control command: allows
  864.           address[,...]              list owner to remove other
  865.                                      users from the list.
  866.        |
  867.        |  REVIEW list-name           Returns the list of
  868.        |                             subscribers.
  869.  
  870.  
  871.  
  872.                                                               3-5
  873.  
  874.  
  875.  
  876.  
  877.           Mailing Lists
  878.  
  879.  
  880.  
  881.           Table_3-5_(Cont.)__MLF_LISTSERV_commands_______________
  882.  
  883.           Command____________________Description_________________
  884.  
  885.           SET list-name [NO]MAIL     Enables/disables receipt of
  886.                                      list messages.
  887.        |
  888.        |  SET list-name [NO]CONCEAL  Controls whether subscriber
  889.        |                             is concealed from view in
  890.        |                             REVIEW listings.
  891.        |
  892.        |  SET list-name [NO]REPRO    Controls whether the
  893.        |                             subscriber receives a
  894.        |                             posting s/he makes to the
  895.        |                             mailing list.
  896.  
  897.           SIGNOFF list-name          Removes the user from the
  898.                                      list of subscribers.
  899.  
  900.           SUBSCRIBE list-name        Adds the user to the
  901.           ___________________________subscriber_list.____________
  902.  
  903.  
  904.           SUBSCRIBE requests are handled automatically only
  905.           if the WORLD protection class is granted E (Enroll)
  906.           access to the list. Otherwise, they are forwarded to
  907.           the list owners for manual handling.
  908.  
  909.           SIGNOFF requests are handled automatically only if the
  910.           GROUP protection class is granted D (Delete) access
  911.           to the list. Otherwise, they are forwarded to the list
  912.           owners for manual handling.
  913.  
  914.           REVIEW requests are handled automatically only if
  915.           the requesting user is granted R (Read) access to the
  916.           list. Read access may be granted only to GROUP (i.e.,
  917.           the subscribers of the list) or to GROUP and WORLD.
  918.           If access is denied, the request is returned with an
  919.           error message.
  920.  
  921.  
  922.           3-6
  923.  
  924.  
  925.  
  926.  
  927.                                                     Mailing Lists
  928.  
  929.  
  930.           ___________________________
  931.  
  932.    3.3.1  Control Commands
  933.  
  934.           The mailing list processor currently supports two
  935.           control requests: ADD and REMOVE. They may be used by
  936.           the owners of a mailing list to add and remove other
  937.        |  users to and from the list of subscribers.
  938.        |
  939.        |  The owners of a mailing list also receive the
  940.        |  full list of subscribers when they REVIEW their
  941.        |  list, regardless of the CONCEAL setting of each
  942.        |  subscriber. Non-owners receive a list consisting of
  943.        |  subscribers who have not set the CONCEAL flag for
  944.        |  their subscription to the list.
  945.  
  946.           __________________________________________________________________
  947.  
  948.    3.4    User Notification Messages
  949.  
  950.           You can control the text of the message that is sent
  951.           to the user when he or she subscribes or signs off
  952.           from a mailing list, on a per-list and/or global
  953.           basis. Table 3-6 lists the types of messages you can
  954.           set up and when they are sent.
  955.  
  956.           Table_3-6__User_notification_messages__________________
  957.  
  958.                                                            When
  959.           Per-list_qualifier____Global_default_____________sent__
  960.  
  961.           /ADD_MESSAGE          MLIST_ADD_MESSAGE.TXT      when
  962.                                                            a
  963.                                                            user
  964.                                                            is
  965.                                                            added
  966.                                                            to a
  967.                                                            mail-
  968.                                                            ing
  969.                                                            list
  970.  
  971.  
  972.                                                               3-7
  973.  
  974.  
  975.  
  976.  
  977.           Mailing Lists
  978.  
  979.  
  980.  
  981.           Table_3-6_(Cont.)__User_notification_messages__________
  982.  
  983.                                                            When
  984.           Per-list_qualifier____Global_default_____________sent__
  985.  
  986.           /REMOVE_MESSAGE       MLIST_REMOVE_MESSAGE.TXT   when
  987.                                                            a
  988.                                                            user
  989.                                                            is
  990.                                                            re-
  991.                                                            moved
  992.                                                            from
  993.                                                            a
  994.                                                            mail-
  995.                                                            ing
  996.                                                            list
  997.  
  998.           /FORWARD_MESSAGE      MLIST_FORWARD_MESSAGE.TXT  when
  999.                                                            a
  1000.                                                            user
  1001.                                                            at-
  1002.                                                            tempts
  1003.                                                            to
  1004.                                                            sub-
  1005.                                                            scribe
  1006.                                                            to a
  1007.                                                            list
  1008.                                                            with
  1009.                                                            no
  1010.                                                            W:E
  1011.                                                            ac-
  1012.           _________________________________________________cess__
  1013.  
  1014.  
  1015.           The global default message files are located in MX_
  1016.           MLIST_DIR. You can customize these files to suit your
  1017.           site's needs for all mailing lists, or use them as
  1018.           templates for the per-list files.
  1019.  
  1020.  
  1021.  
  1022.           3-8
  1023.  
  1024.  
  1025.  
  1026.  
  1027.                                                     Mailing Lists
  1028.  
  1029.  
  1030.  
  1031.           Customization Variables
  1032.  
  1033.           The text of a notification message can contain
  1034.           references to customization "variables" whose values
  1035.           are supplied by the mailing list processor. Available
  1036.           variables are:
  1037.  
  1038.           {list-address}        the RFC822 address of the
  1039.                                 mailing list
  1040.  
  1041.           {request-address}     the RFC822 address of the list's
  1042.                                 -Request address
  1043.  
  1044.           {list-name}           the name of the mailing list (no
  1045.                                 @hostname)
  1046.        |
  1047.        |  {list-desc}           the contents of the list
  1048.        |                        description, as specified by
  1049.        |                        the /DESCRIPTION qualifier on
  1050.        |                        the DEFINE LIST command
  1051.  
  1052.           {list-owner}          the address of the owner of
  1053.                                 the mailing list (if there are
  1054.                                 multiple owner addresses, only
  1055.                                 the first is used)
  1056.  
  1057.           Note that each variable name must be surrounded
  1058.           by curly braces to be recognized. All other text
  1059.           (including unrecognized variable references) is sent
  1060.           verbatim.
  1061.  
  1062.           __________________________________________________________________
  1063.  
  1064.    3.5    VMS Mail Forwarding
  1065.  
  1066.           You can make it easier for local users and DECnet-
  1067.           connected users to send messages to a mailing list by
  1068.           creating a forwarding address in VMS Mail for the list
  1069.           name:
  1070.  
  1071.                $ MAIL
  1072.                MAIL> SET FORWARD/USER=list-name MX%list-name
  1073.  
  1074.                                                               3-9
  1075.  
  1076.  
  1077.  
  1078.  
  1079.           Mailing Lists
  1080.  
  1081.  
  1082.  
  1083.           This will allow users to use just the list name when
  1084.           addressing the mailing list, without the MX% prefix.
  1085.  
  1086.           If the list name ever changes or the list is deleted,
  1087.           you should remember to remove the forwarding address
  1088.           from VMS Mail for the list name:
  1089.  
  1090.                MAIL> REMOVE list-name
  1091.  
  1092.           This will prevent a possible mail looping problem from
  1093.           occurring.
  1094.  
  1095.           __________________________________________________________________
  1096.  
  1097.    3.6    Using the ADD and REMOVE Commands
  1098.  
  1099.           The list processor provides two commands for use
  1100.           exclusively by list owners and list server managers:
  1101.           ADD and REMOVE.
  1102.  
  1103.           ___________________________
  1104.  
  1105.    3.6.1  ADD
  1106.  
  1107.           The ADD command adds other users to a mailing list.
  1108.           The syntax for this command for the -Request interface
  1109.        |  is:
  1110.        |
  1111.        |                     ADD [/NONOTIFY] [/NOMAIL] [/NOCASE] [/CONCEAL]
  1112.  [/NOREPRO]  address [,...]
  1113.  
  1114.           The syntax for the LISTSERV interface is:
  1115.  
  1116.                              ADD [/NONOTIFY]  list-name  address [,...]
  1117.  
  1118.           You may specify multiple addresses to be added by
  1119.           separating the list with commas, but note that the
  1120.           entire command must fit on one line in the E-mail
  1121.           message.
  1122.  
  1123.           For address, you should enter the RFC822-type address
  1124.           for the user to be added. It should generally appear
  1125.           exactly as it does on the From line of a message,
  1126.           since the mailing list processor is case sensitive in
  1127.           the username part of addresses. You may include the
  1128.           personal name, if desired.
  1129.  
  1130.           3-10
  1131.  
  1132.  
  1133.  
  1134.  
  1135.                                                     Mailing Lists
  1136.  
  1137.  
  1138.  
  1139.           Use the /NONOTIFY qualifier when you do not want the
  1140.           new subscribers to receive the "you have been added"
  1141.           message for the mailing list.
  1142.  
  1143.           The /NOMAIL qualifier is used to add the user to the
  1144.           mailing list as a NOMAIL subscriber. That is, the
  1145.           user is on the list without receiving any mail from
  1146.           the list. NOMAIL subscriptions are used for private
  1147.           mailing lists, where only the subscribers are allowed
  1148.           to post, and for mailing lists that control access
  1149.           to file servers; a subscriber might have multiple
  1150.           addresses and may need access to the list or file
  1151.        |  server from any of those addresses.
  1152.        |
  1153.        |  The /NOCASE qualifier is used to add the user to the
  1154.        |  mailing list while having the list processor disregard
  1155.        |  the case of the username portion of the address.
  1156.        |  Normally, the list processor is case-sensitive
  1157.        |  regarding usernames.
  1158.        |
  1159.        |  The /CONCEAL qualifier is used to set the CONCEAL flag
  1160.        |  in the subscriber's entry in the list. CONCEALed users
  1161.        |  do not appear in REVIEW listings, except for those
  1162.        |  requested by the list owners.
  1163.        |
  1164.        |  The /NOREPRO qualifier is used to prevent the
  1165.        |  subscriber from receiving a copy of postings s/he
  1166.        |  makes to the list.
  1167.        |
  1168.        |  Note that the LISTSERV ADD command supports only the
  1169.        |  /NONOTIFY qualifier.
  1170.  
  1171.           ___________________________
  1172.  
  1173.    3.6.2  REMOVE
  1174.  
  1175.           The REMOVE command removes other users from a mailing
  1176.           list. The syntax for this command for the -Request
  1177.           interface is:
  1178.  
  1179.                              REMOVE [/NONOTIFY]  address [,...]
  1180.  
  1181.           The syntax for the LISTSERV interface is:
  1182.  
  1183.                              REMOVE [/NONOTIFY]  list-name  address [,...]
  1184.  
  1185.                                                              3-11
  1186.  
  1187.  
  1188.  
  1189.  
  1190.           Mailing Lists
  1191.  
  1192.  
  1193.  
  1194.           You may specify multiple addresses to be added by
  1195.           separating the list with commas, but note that the
  1196.           entire command must fit on one line in the E-mail
  1197.           message.
  1198.  
  1199.           For address, you should enter the RFC822-type address
  1200.           for the user to be added. It should appear exactly as
  1201.           it does in the subscriber list (use the REVIEW command
  1202.           to check this). You may include the personal name, if
  1203.           desired, but only the address part is checked when MLF
  1204.           does the removal.
  1205.  
  1206.           Use the /NONOTIFY qualifier when you do not want the
  1207.           new subscribers to receive the "you have been removed"
  1208.           message for the mailing list.
  1209.  
  1210.           __________________________________________________________________
  1211.  
  1212.    3.7    Deleting a Mailing List
  1213.  
  1214.           The MCP REMOVE LIST command removes the definition of
  1215.           a mailing list from the MX configuration database. The
  1216.           file containing the list of subscribers will remain
  1217.           after the definition is removed, however. You should
  1218.           delete that file also:
  1219.  
  1220.                $ DELETE MX_MLIST_DIR:list-name.MAILING_LIST;*
  1221.  
  1222.           You should also remember to delete any add, remove, or
  1223.           forward message files you set up for the mailing list
  1224.           at creation time.
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.           3-12
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.           _______________________________________________________
  1245.  
  1246.    4      File Servers
  1247.  
  1248.  
  1249.  
  1250.  
  1251.           The MCP DEFINE FILE_SERVER command is used to set
  1252.           up a file server. Each file server can automatically
  1253.           service requests for single files or groups of files.
  1254.           Large files can be delayed to non-prime-time hours,
  1255.           on a per-server basis. You can specify a per-server,
  1256.           per-host, and/or per-user byte count limit, to prevent
  1257.           users from overtaxing the mail system with file server
  1258.           requests. In addition, you can link a file server
  1259.           to a mailing list, so that only those users who are
  1260.           subscribed to the list can gain access to the file
  1261.           server.
  1262.  
  1263.           __________________________________________________________________
  1264.  
  1265.    4.1    Packages
  1266.  
  1267.           The file server is designed to handle groups of files,
  1268.           called packages. When you create a package, you create
  1269.           a directory with the name of that package, and all
  1270.           files in that directory must have file names the same
  1271.           as the package name. In addition, you must place a
  1272.           description file above the package directory which
  1273.           is sent when a user requests a listing of available
  1274.           packages.
  1275.  
  1276.           This structure works best when you use a program such
  1277.           as VMS_SHARE to put together your packages. VMS_SHARE
  1278.           is readily available around the Internet and BITNET.
  1279.           It is used to collect together text files, format
  1280.           them so as to improve the chances of their being
  1281.           transferable through most mail systems, and split them
  1282.           up into easily mailable chunks. When all the chunks
  1283.           are put together on the receiving end, they form a DCL
  1284.           command procedure that re-creates the original files.
  1285.  
  1286.                                                               4-1
  1287.  
  1288.  
  1289.  
  1290.  
  1291.           File Servers
  1292.  
  1293.  
  1294.  
  1295.           Example
  1296.  
  1297.           To demonstrate the structure used by the file server,
  1298.           let us suppose you have created a package called
  1299.           STUFF. You used VMS_SHARE to create the package, which
  1300.           split the package into three parts.
  1301.  
  1302.           First, you would create a directory for the package:
  1303.  
  1304.                $ CREATE/DIRECTORY disk:[FILESERV.STUFF]
  1305.  
  1306.           Next, you would copy the VMS_SHARE files into that
  1307.           directory. They must have file names the same as the
  1308.           package name:
  1309.  
  1310.                $ COPY STUFF.* disk:[FILESERV.STUFF]
  1311.  
  1312.           Next, you would create a file containing a brief
  1313.           description of the package and place it above the
  1314.           STUFF directory:
  1315.  
  1316.                $ EDIT disk:[FILESERV]STUFF.DESCRIPTION
  1317.  
  1318.           Finally, you would need to set up the file server in
  1319.           MCP:
  1320.  
  1321.                MCP> DEFINE FILE_SERVER FILESERV/ROOT=disk:[FILESERV.]
  1322.  
  1323.           The file server FILESERV will now automatically handle
  1324.           distribution of the STUFF package.
  1325.  
  1326.           __________________________________________________________________
  1327.  
  1328.    4.2    Help File
  1329.  
  1330.           The file FILESERV_HELP.TXT, provided by the
  1331.           installation procedure in directory MX_ROOT:[MLF],
  1332.           contains a description of the file service commands.
  1333.           You should update this file to include the address
  1334.           you have chosen for your file server and any other
  1335.           information specific to the file server that you
  1336.           wish to include. Place the edited copy in the root
  1337.           directory of your file server to have it sent when a
  1338.           user sends a HELP command to your file server.
  1339.  
  1340.           4-2
  1341.  
  1342.  
  1343.  
  1344.  
  1345.                                                      File Servers
  1346.  
  1347.  
  1348.           __________________________________________________________________
  1349.  
  1350.    4.3    File Server Commands
  1351.  
  1352.           The three commands accepted by the file server are
  1353.           SENDME, LIST (or DIRECTORY), and HELP. Each may be
  1354.           abbreviated to the smallest unique string. One command
  1355.           is allowed per line of text in a request message, but
  1356.           several command lines may be sent in one request.
  1357.  
  1358.           SENDME takes either a package name (to have all parts
  1359.           of a package sent) or a file name (to have just one
  1360.           part sent). Large files are delayed until non-prime-
  1361.           time hours if enabled when file service is set up.
  1362.  
  1363.           LIST takes a pattern which is used to match against
  1364.           package names. The description file for each matching
  1365.           package is added to a message that is returned to the
  1366.           requesting user. If no pattern is specified, "*" is
  1367.           used.
  1368.  
  1369.           HELP causes the file FILESERV_HELP.TXT (located in the
  1370.           root directory of the file server) to be sent to the
  1371.           requesting user.
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.                                                               4-3
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.           _______________________________________________________
  1400.  
  1401.    A      Troubleshooting MLF Problems
  1402.  
  1403.  
  1404.  
  1405.  
  1406.           MLF includes a debug mode that displays information
  1407.           about what it is doing when processing mailing list
  1408.           and file server requests. If you are experiencing
  1409.           problems with either a mailing list or a file server,
  1410.           you can enable this debug mode with the command:
  1411.  
  1412.                $ DEFINE/SYSTEM MX_MLF_DEBUG TRUE
  1413.  
  1414.           If you are in a VAXcluster, this logical must be
  1415.           defined on the same node as the currently active MX
  1416.           MLF process to have any effect.
  1417.  
  1418.           Debug log files created by MLF are called MX_MLF_
  1419.           DIR:MX_MLF_LOG.LOG.
  1420.  
  1421.           __________________________________________________________________
  1422.  
  1423.    A.1    Case Sensitivity
  1424.  
  1425.           The mailing list processor uses case-sensitive
  1426.           matching on the username part of addresses when
  1427.        |  looking up users on the subscriber list (except for
  1428.        |  subscribers with the NOCASE flag set), owner list, and
  1429.           SYSTEM_USERS list. Be careful when adding and removing
  1430.           users from these lists that the case of the username
  1431.           part of the address exactly matches what will be in
  1432.           the From: header of the address.
  1433.  
  1434.           Remember that MX automatically converts usernames
  1435.           to lower case, by default, when creating the From:
  1436.           header, so messages originating on the local system
  1437.           will have lower case usernames.
  1438.  
  1439.  
  1440.                                                               A-1
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.           _______________________________________________________
  1450.  
  1451.    B      Example: Mailing List with Archive Server
  1452.  
  1453.  
  1454.  
  1455.  
  1456.           This example creates a mailing list whose archives are
  1457.           made available through a file server.
  1458.  
  1459.                $ CREATE/DIRECTORY SOME_DISK:[ARCHIVES.MAILLIST]
  1460.                $ MCP
  1461.                MCP> DEFINE LIST "MailList" -
  1462.                _MCP>     /OWNER="me@myhost.mycompany.ORG"-
  1463.                _MCP>     /PROTECTION=(S:RWED,O:RWED,G:RWED,W:RWE)-
  1464.                _MCP>     /ARCHIVE=SOME_DISK:[ARCHIVES.MAILLIST]
  1465.  
  1466.           This would set up a public mailing list, with the list
  1467.           owner being user "me", who would also receive all the
  1468.           bounced mail from the mailing list (by default, since
  1469.           no /ERRORS_TO was specified). The archive will be
  1470.           created in directory SOME_DISK:[ARCHIVES.MAILLIST] a
  1471.           file name of MAILLIST (defaulting from the list name)
  1472.           and a file type of yyyy-mm (the year and month).
  1473.  
  1474.           You could then create a file server called Archives:
  1475.  
  1476.                MCP> DEFINE FILE_SERVER "Archives" -
  1477.                _MCP>     /MANAGER="me@myhost.mycompany.ORG"-
  1478.                _MCP>     /ROOT=SOME_DISK:[ARCHIVES.]-
  1479.                _MCP>     /MAILING_LIST=MailList
  1480.  
  1481.           This file server could then respond to requests
  1482.           for sending some or all of the monthly archives for
  1483.           mailing list MailList. The mailing list link prevents
  1484.           those users who are not subscribed to MailList from
  1485.           obtaining the archives. To complete the setup, you
  1486.           would also need to create the files FILESERV_HELP.TXT
  1487.           and MAILLIST.DESCRIPTION to be placed in directory
  1488.           SOME_DISK:[ARCHIVES], to describe the file server and
  1489.           the MailList archive "package".
  1490.  
  1491.                                                               B-1
  1492.  
  1493.  
  1494. __________________________cut here______________________________________
  1495.  
  1496. --
  1497. Helmut Springer                    University of Stuttgart, FRG
  1498. User HelpDesk Computing Center           CipPool Physics Department
  1499. springer@rus.uni-stuttgart.de            helmut@bonnie.physik.uni-stuttgart.de
  1500. phone: +49 711 685-4828                  1291::helmut (BelWue)
  1501.  
  1502. %SYSTEM-W-MAILONSYS, there is real mail installed on this system
  1503.