README.TXT              POPrequest version 1.1                      21-apr-1997

NOTE: This program is in beta state. It is only tested on OpenVMS Alpha 6.2
      and VMS VAX 5.3 with UCX 3.3 or SOCKETSHR V0.9-D.

POPREQUEST version 1.1
-----------------------
   POPrequest is a program which can easily access any POP3 server.
   It is *not* a full-featured email client.

   It's main purpose is for use with the non-standard commands of
   your POP3 server, which can't be specified from most email clients.

   It has buildin support for the non-standard commands of IUPOP3 V1.9,
   which can be specified in abbreviated form.


Prerequisites
-------------
   POPrequest uses the BSD sockets interface supported by most TCP/IP
   packages. If your TCP/IP package does not support it directly,
   you need the SOCKETSHR and NETLIB packages. See
   the CMU OpenVMS TCP/IP FAQ for details about this products.
   The FAQ is available at
   http://sacsa3.mp.usbr.gov/CMU.html
   or
   ftp://ftp2.kcl.ac.uk/vms/cmu-tcpip/


Installation
------------
   Unzip the appropriate .ZIP file into a temporay directory.
   The image can be build with

   $@make

   If you need one of the optional parameters type

   $@make ?

   to get a list.

   The (hopefully) generated program file must be installed as a foreign
   command or moved to a directory on your path (see DCL$PATH on >= VMS 6.2).
   To install it as foreign command type

   $poprequest := $device:[directory]poprequest.exe

   If you want install the supplied help file type

   $library/replace sys$help:helplib.hlb poprequest.hlp


Usage
-----
   The usage is very simple, just type
   $poprequest /qualifier /qualifier ...

   where qualifier is one of

   /HOST=hostname
   /PORT=portnumber
   /USERNAME=remote_user_name
   /PASSWORD[=password]
   /[NO]APOP
   /OUTPUT=filespec
   /INPUT=filespec
   /XTND[=(list)]
   /COMMANDS[=(list)]
   /HELP

   See poprequest.hlp for more details.

Supplied files in POPREQUEST.ZIP
--------------------------------
   poprequest.c            source code
   poprequest.h            definition file
   poprequest_cld.cld      commandline definition file
   popcl_cli.c             source code
   md5c.c                  source code md5 algorithm
   md5.h                   include file for md5c.c
   make.com                build command file
   poprequest.mms          build file for mms or mmk
   poprequest.hlp          help file
   readme.txt              this file