Souper is a program that transfers mail and news from a POP3 mail server and NNTP news server respectively to SOUP packets. It can also send messages in SOUP reply packets. It runs on OS/2 Warp with the IBM Internet Connection for OS/2.
Copy the souper.exe file to a directory in your PATH.
Edit your \tcpip\etc\services file. Look for a line beginning with the word "pop3". If the file does not contain such a line, add the line
pop3 110/tcp
to the file.
Souper is designed to work with the IBM Internet Connection for OS/2. In your PPP/SLIP settings notebook, you must fill in the entries for
Your Host Name: Your Domain Name: News Server: Mail Gateway: POP Mail Server: Reply Domain: Reply (Mail) ID: POP Login ID: POP Password:
Ask your Internet service provider for the correct values for these settings.
You can set these environment variables to change the default behaviour of the program.
Use a text editor to create a file named newsrc in your home directory. List the newsgroups you want to transfer, one per line, and end each line with a colon. For example:
comp.answers: news.answers: rec.humor.funny:
The program records the article numbers it has fetched by updating this file.
If you use Yarn, be sure to give Souper a separate newsrc file from the one used by Yarn. The files must be separate and are used for different purposes. The Souper newsrc file records the articles you have downloaded from the news server. The Yarn newsrc file records the articles you have read with the Yarn news reader.
A kill file specifies criteria used to kill news articles, that is, exclude them from the SOUP packet. You can kill articles that have a specific subject, are from a specific poster, or contain a particular string anywhere in the header.
By default, the program looks for a file named kill in your home directory. An entry in the kill file has the format:
<newsgroup> {
<where> <pattern>
...
}
where
Here is an example kill file:
all {
From netkook
}
comp.os.os2.advocacy {
Subject Microsoft
Subject crash OS/2
}
In all newsgroups, articles from netkook are killed. Also in the comp.os.os2.advocacy newsgroup, articles with a Subject containing the string "Microsoft" or "crash OS/2" are killed.
To fetch your mail and news, run the command
souper
You can specify a different POP3 mail server than the one specified in the PPP/SLIP settings notebook by instead running the command
souper <mailhost> <userid> <password>
where
If you want to transfer only news, specify the -m option to disable the mail transfer.
souper -m
If you want to transfer only mail, specify the -n option to disable the news transfer.
souper -n
The program creates the AREAS and *.MSG files of the SOUP packet in the current directory. Here's a typical batch file designed to import news into Yarn:
cd \temp souper import -u
And to export messages from Yarn:
cd \temp unzip -o \home\reply.zip del \home\reply.zip souper -s
The program accepts the following command line options.
This program is derived from popclient by Carl Harris <ceharris@vt.edu> and uqwk by Steve Belczyk <seb3@gte.com>.
The author makes no representations about the accuracy or suitability of this material for any purpose. It is provided "as is", without any express or implied warranties. The author will assume no liability for damages either from the direct use of this product or as a consequence of the use of this product.