Unsubscribe from a mailing list.

Syntax

UNSUBSCRIBE list-name [address]

Parameters

list-name

Required parameter specifying the name of the mailing list to unsubscribe from Wildcards are not allowed.

address

Optional parameter specifying the address to remove from the mailing list. If no address is specified, the From: address from the requesting message will be used.

Description

The UNSUBSCRIBE command removes either your address or the address you specify from the specified mailing list. A response message reporting the success or failure of the unsubscribe request will be returned.

Typically, the use of the optional address parameter is restricted.

Error Messages

%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 unsubscribe from. Resend the command with a list name specification.

MAILSERV-W-LNF, mailing list not found 
      

The mailing list you specified does not exist. Resend the command specifying the name of a valid mailing list. You may 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 may not unsubscribe from it at this time. Try again later.

%MAILSERV-F-NOMAILLIST, mailing lists are not enabled 
      

The mail server is not configured to operate as a list server.

%MAILSERV-W-NOSUCHADR, no such address subscribed to the mailing list 
      

You are not subscribed to the specified mailing list. If you used the optional address parameter, then the specified address is not subscribed. Check to make sure that you specified the correct mailing list name or address or both.

%MAILSERV-W-PRV, insufficient privilege or file protection violation 
      

You are not allowed to unsubscribe from this mailing list or unsubscribe addresses other than your own from the list.