Subscribe to a mailing list.

    Syntax

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

1  –  Parameters

 list-name

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

2  –  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 PMDF_MAILSERV_MAIL_DIR:list-name.TXT
    exists, 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 can impose restrictions as to who may
    or may not subscribe to a given list.

3  –  Examples

    1.SUBSCRIBE LOCAL-NEWS

      This example shows the command to SUBSCRIBE oneself to the list
      LOCAL-NEWS.

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

4  –  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 can
      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 cannot 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.