<HTML>
<HEAD><TITLE>live</TITLE></HEAD>
<BODY>
<PRE>
	How to connect and use the Interactive ListProcessor
	----------------------------------------------------

ListProcessor may be reached for interactive (direct, without using email)
sessions if both this system and your host are on Internet. Live sessions
look a lot like ftp sessions, in the sense that the user may issue all of
the valid requests he would send over email, plus download files from the
archives. The server has also the capability of connecting to remote live UNIX
ListProcessors for requests that refer to remote lists.

To be able to connect to an ILP, you will need a program called "ilp"; this
should be available from this site's archives; issue an 'index' request and
'get' all files from the designated archive.

You will need to compile the ilp client before you use it; once compiled, you
may use it as follows:

			ilp ${HOSTNAME:-this host's address} [port]

All compliant Interactive ListProcessors listen at port 372 for connections
by default, but they may use any other port, in which case you will have
to specify which one. For example, on host csa.bu.edu a sample server is
running for testing purposes; to connect to it you would issue the following
command:

			ilp csa.bu.edu 8000

Log in with email address 'test' and password 'new-user' to obtain subscriber
privileges (more on this later). Notice that you may also specify an I.P.
address instead of the DNS name of the host. If using domain names, you
probably have to be running a name server on your local network.

Once a connection is established, you will be asked for an email address and a
password; these will be used to establish the privileges (valid set of requests)
upon login. A mismatch or no email address reduces these privileges to a
minimum (casual user).

Casual users may only issue 'help', 'information', 'recipients' and 'statistics'
for nonprivate lists, 'lists', 'index', 'get', 'view', 'search' and 'release'
requests.

Subscriber privileges also include the 'set', 'run', 'unsubscribe', and 'which'
requests.

Owners may, in addition, issue all of their administrative requests.

To gain subscriber privileges you must be subscribed to at least one list, use
your email address as shown by a 'recipients' request, and provide the password
that you have set before. If you are subscribed to more than one lists, any
password from the ones that you use for each list will do (assuming that your
subscription address is the same for all those lists). However, if you belong to
a private list, you should use the password as set for that list in order to be
able to have access to 'recipients' and 'statistics' listings.

To gain owner privileges, please contact this system's manager (you may
get the manager's address via a 'release' request).

To end a live session, just type 'quit' or 'exit'. To review your privileges
at any time, type '?' or 'privileges'. Connections are limited to a certain
amount of time; to get the time left on your connection, type 'timeleft'.

Requests may be continued on multiple lines by use of '&amp;' followed by a new-line
character. The output of every request (if it is not an error message) may be
redirected to a file by using a '&gt;' followed by a file name.

Example:

REQUEST&gt; index &gt; index

or by using '&gt;&gt;' in which case the output is appended to the file. File transfer
also takes place when you 'get' files from an archive. For example, if you

REQUEST&gt; get listproc info

the output will be saved under file 'info'. You choose another file name by
redirecting:

REQUEST&gt; get listproc info &gt; index

The keywords 'binary' and 'ascii' specify the transfer type; the default is
'binary', i.e. files are transferred as they are; in ascii mode, new-line
characters are translated to carriage-return/line-feed pairs.

Input may also be redirected from a file by using '&lt;' followed by a file
name; for example:

REQUEST&gt; &lt; batched.requests

In this case, each line will be interpeted as a separate request and replies
will be produced. Here is an example batch file:

index &gt; index
get listproc info &gt;&gt; index
quit

A particularly useful case of input redirection is the 'put' request:

REQUEST&gt; put ermis ermis1 welcome &lt; prepared-welcome-file

Note that for requests requiring a password, you may replace the password with
a dash (-) since you provided the password at login; this of course works only
if you use the same password for all lists you are subscribed to or own.
Then, the previous request could have been written as:

REQUEST&gt; put ermis - welcome &lt; prepared-welcome-file

Moreover, the output of requests not redirected may be piped to UNIX command
using the '|' character.  For example:

REQUEST&gt; review ermis | more

will pipe the output of the 'review' request to the UNIX "more" command. As
another example, to look for a particular subscriber in a list, one may do:

REQUEST&gt; review venus | grep -i Name

As a last note, requests for remote lists are serviced by contacting the remote
servers, if possible. Live requests are subject to the usual restrictions
(system loads) -- requests that are designated by the manager for batch
processing will be rejected, and you will have to submit your request via email.

<PRE>
</BODY>
</HTML>

