|
USEFUL COMMANDS
|
| |
|
These are the most commonly used LISTSERV® commands.
Each command listed is followed by its syntax - angled brackets
indicate a required parameter and square brackets an optional
parameter.
|
| |
| SUBSCRIBER COMMANDS |
| |
| SUBSCRIBE |
 |
SUBSCRIBE <listname>
<forename surname> [WITH opt1 opt2 etc] |
| |
|
|
This subscribes you to a list.
You can also use this to change your name if you are already
on the list and you will receive a message saying that your subscription options have been updated. Please note that to do this, you must use the same email address you were originally subscribed with.
You can specify options using the WITH
command. Note: Your email address is automatically
taken
from your email, as is your name if present. |
| |
|
|
| Example 1: |
|
SUBSCRIBE arts-list Joe
Bloggs |
| |
|
|
| |
|
This is the standard subscription,
in this case subscribing to the list - 'arts-list'
with the name 'Joe Bloggs'. |
| |
|
|
| Example 2: |
|
SUBSCRIBE arts-list Joe
Bloggs WITH DIGESTS NOHTML |
| |
|
|
| |
|
This subscribes you to
'arts-list' and specifies that you wish to
receive postings to the list in DIGEST form and want
to avoid HTML. The full list of WITH options can be
seen under the SET
command below. |
|
| |
| UNSUBSCRIBE |
|
UNSUBSCRIBE <listname>
|
| |
|
|
| Remove yourself from a list.
Specifying an asterisk instead of a list name will remove
you from ALL JISCMail lists. Note: Since LISTSERV extracts
your email address automatically, you must send the
command from the same email address as you are subscribed
to the list under. |
| |
|
|
| Example 1: |
|
UNSUBSCRIBE arts-list |
| |
|
|
| |
|
This will remove you from
the list 'arts-list'. |
|
| |
| SET |
|
SET <listname> <opt1>
[opt2 etc] |
| |
|
|
| Alters your subscription
options for one or all lists. |
| |
|
|
| Example 1: |
|
SET * NOMAIL |
| |
|
|
| |
|
This command sets you to
NOMAIL for ALL lists you are subscribed to. |
|
| |
| ACK/NOACK |
Acknowledgements for postings |
| CONCEAL/NOCONCEAL |
Hide yourself from REVIEW |
| HTML/NOHTML |
Prefer/avoid HTML format,
especially in digests |
| MAIL/NOMAIL |
Toggle receipt of mail |
| MIME/NOMIME |
Prefer/avoid MIME format,
especially in digests |
| DIGESTS/NODIGESTS |
Receive postings in digest
form |
| INDEX/NOINDEX |
Receive message indexes |
| REPRO/NOREPRO |
Copy of your own postings |
| FULL/SHORT/SUBJ |
Mail header style |
|
| |
| QUERY |
|
QUERY <listname> |
| |
|
|
| Request details of your
list subscriptions. |
| |
|
|
| Example 1: |
|
QUERY * |
| |
|
|
| |
|
Returns details of ALL
lists you are subscribed to, along with your subscription
options. |
|
| |
| CHANGE |
|
CHANGE <listname>
<newaddress> |
| |
|
|
| Changes your email address
on the specified list. Note: You must send this command
from the email address that you wish to change from. |
| |
|
|
| Example 1: |
|
CHANGE * new@address.ac.uk |
| |
|
|
| |
|
Change your address to
new@address.ac.uk on ALL lists. |
|
|
| OWNER COMMANDS |
| |
| ADD |
|
[QUIET] ADD <listname>
<address> [full name]
[QUIET] ADD <listname> DD=ddname IMPORT |
| |
|
|
| Add users to one of your
lists. The word QUIET, when placed before the command,
stops any confirmations being sent out. |
| |
|
|
| Example 1: |
|
ADD arts-list joe.bloggs@somewhere.ac.uk
Joe Bloggs |
| |
|
|
| |
|
Adds Joe Bloggs to the
'arts-list' list with the email address 'joe.bloggs@somewhere.ac.uk'.
A confirmation message would be sent to him. |
| |
|
|
| Example 2: |
|
QUIET ADD arts-list DD=ddname
IMPORT
//ddname DD *
j.bloggs@somewhere.com Joe Bloggs
j.smith@anywhere.com John Smith
/* |
| |
|
|
| |
|
This is what's known as
a 'Bulk Add'. In this case, 2 subscribers
are added to the 'arts-list' without sending
them a confirmation. |
|
| |
| DEL |
|
[QUIET] DEL <listname>
<address>
[QUIET] DEL <listname> DD=ddname |
| |
|
|
| Delete users from one of
your lists. The word QUIET, when placed before the command,
stops any confirmations being sent out. |
| |
|
|
| Example 1: |
|
DEL arts-list joe.bloggs@somewhere.ac.uk |
| |
|
|
| |
|
Removes 'joe.bloggs@somewhere.ac.uk'
from the 'arts-list' list and sends him a
confirmation. |
| |
|
|
| Example 2: |
|
QUIET DEL arts-list DD=ddname
//ddname DD *
j.bloggs@somewhere.com
j.smith@anywhere.com
/* |
| |
|
|
| |
|
This is what's known as
a 'Bulk Delete'. In this case, 2 subscribers
are removed from the 'arts-list' without sending
them a confirmation. |
|
| |
| GET |
|
GET <listname> (HEADER |
| |
|
|
| Gets the specified list
header to enable a list owner to view or change the
list configuration. Note: This command locks
the list header until either it is replaced using the
PUT command, or
the UNLOCK command
is issued. |
| |
|
|
| Example 1: |
|
GET arts-list (HEADER |
| |
|
|
| |
|
Get the 'arts-list'
list header. |
|
| |
| PUT |
|
PUT <listname> LIST
PW=<password> |
| |
|
|
| Replaces the specified list
header. The password is your LISTSERV password, registered
via the web interface or with the PW
command. Note: When you perform a GET
command the header is sent to you in the correct format
for a subsequent PUT. It is therefore strongly recommended
that you copy the contents of that email into a new
email and amend the relevant parts from there. |
| |
|
|
| Example 1: |
|
PUT arts-list LIST PW=waterfall
* header line 1
* header line 2
* etc
|
| |
|
|
| |
|
Replaces the 'arts-list'
list header where your LISTSERV password is 'waterfall'. |
|
| |
| UNLOCK |
|
UNLOCK <listname> |
| |
|
|
| Unlocks the specified list
header that was locked by a previous GET
command. |
| |
|
|
| Example 1: |
|
UNLOCK arts-list |
| |
|
|
| |
|
Unlocks the 'arts-list'
list header. |
|
| |
| HOLD |
|
HOLD <listname> |
| |
|
|
| Holds (freezes) a list, preventing
new postings from being processed until a FREE
command is sent. This can be useful if you want to stop
postings being delivered to the list while investigating
a problem. |
| |
|
|
| Example 1: |
|
HOLD arts-list |
| |
|
|
| |
|
Holds the list 'arts-list'. |
|
| |
| FREE |
|
FREE <listname> |
| |
|
|
| Frees a list that has been
held by the HOLD command
or by LISTSERV. |
| |
|
|
| Example 1: |
|
FREE arts-list |
| |
|
|
| |
|
Frees the list 'arts-list'. |
|
| |
| FILE/ARCHIVE COMMANDS |
| |
| INDEX |
|
INDEX <listname>
|
| |
|
|
| Returns a list of available
files and archives for the specified list. |
| |
|
|
| Example 1: |
|
INDEX arts-list |
| |
|
|
| |
|
Returns index for 'arts-list'. |
|
| |
| GET |
|
GET [<listname>\]<file
name> |
| |
|
|
| Retrieve a file or achive. |
| |
|
|
| Example 1: |
|
GET arts-list\minutes.txt |
| |
|
|
| |
|
Request a file called 'minutes.txt'
belonging to 'arts-list'. |
| |
|
|
| Example 2: |
|
GET arts-list.log0811 |
| |
|
|
| |
|
Requests the November
2008 archive file for the 'arts-list' list. |
|
| |
| PUT |
|
PUT <file name> <listname>
PW=<password> |
| |
|
|
| Update a file or achive. |
| |
|
|
| Example 1: |
|
PUT minutes.txt arts-list
PW=waterfall
text
text
etc |
| |
|
|
| |
|
Replace the file 'minutes.txt'
belonging to the 'arts-list'. Note: The first
line of the email must contain the PUT command and the
subsequent lines are the actual lines that will appear
in the file you are updating. |
|
| |
| SEARCH |
|
SEARCH <listname>
<word1> [word2 etc] [more options below] |
| |
|
|
| Search a list's message
archives. |
| |
|
|
| Example 1: |
|
SEARCH arts-list constable
turner |
| |
|
|
| |
|
Searches the archives of
'arts-list' for the words 'constable'
& 'turner'. |
| |
|
|
| Additional options can be
appended to the above syntax in many combinations. These
are: |
| |
|
|
| FROM date1 TO date2 |
Between and including
the specified dates, eg:
FROM 01/10/2002 TO 01/11/2002 |
| FROM TODAY |
Search only today's
posts |
| FROM TODAY-7 |
Search in the last
7 days |
| WHERE SUBJECT CONTAINS
xxxxx |
Match where subjects
contains 'xxxxx' |
| WHERE SENDER CONTAINS
xxxxx |
Match where sender
contains 'xxxxx' |
| AND/OR |
Can be used to separate
multiple WHERE conditions |
|
|
| |
| OTHER COMMANDS |
| |
| PW |
|
PW ADD <password>
PW CHANGE newpassword PW=oldpassword |
| |
|
|
| Registers a new, or changes
an existing, LISTSERV password, registered against your
email address. |
| |
|
|
| Example 1: |
|
PW ADD waterfall |
| |
|
|
| |
|
Registers the new password
'waterfall'. |
| |
|
|
| Example 2: |
|
PW CHANGE eclipse PW=waterfall |
| |
|
|
| |
|
Changes your existing 'waterfall'
password to 'eclipse'. |
|
| |
| REVIEW |
|
REVIEW <listname>
|
| |
|
|
| Returns a list of subscribers
on the specified list. |
| |
|
|
| Example 1: |
|
REVIEW arts-list |
| |
|
|
| |
|
Reveals the subscribership
of 'arts-list'. |
|
| |
| LISTS |
|
LISTS |
| |
|
|
| Returns a list of non-confidential
lists on the JISCMail service. |
|
| |
| |
| The full LISTSERV documentation on commands
can be viewed in the LSoft manual
here. |
