Warum nntpget/umsnewsimport?
============================
Ab UMSRFC 1.1 werden diese Programme eigentlich nicht (mehr) benötigt da
umsnntpget nun auch mit Newsservern funktioniert bei denen NEWNEWS
gesperrt ist. Allerdings importiert umsnntpget die Messages schon während
des Downloads, bei sehr großer Messagebase und/oder langsamer CPU können
dadurch die News nicht mit maximaler Geschwindigkeit geladen werden, bei
nntpget + umsnewsimport werden die News erst später (offline) importiert
wodurch der Download schneller ist.


Benötigt
========

bsdsocket Version >=3 kompatiblen TCP/IP-Stack.
asyncio.library - aminet: dev/c/Asyncio.lha

Installation
============

ums.config:
( Exporter
    ( Alias
        NNTP
        SMTP
        POP3
        NNTPD
        POP3D
        SMTPD
    )
    ( Readaccess "#?" )
    ( Writeaccess "#?" )
    ( Netaccess "#?" )
    ( Import "#?" )
    ( Export "#?" )
    ( Name rfc.default )
)
Hinweis: Wer von UmsRfc umsteigt, braucht hier keine Änderungen
vorzunehmen.

Active-File:
Um nntpget benutzen zu können, muß eine "Active"-File angelegt
werden, in dem die gewünschten Newsgroups und die Nr. des ersten
zu holenden Artikels stehen. Beispiel:

---------------------------------------------
de.comm.software.ums 215
de.comp.sys.amiga.comm 758
de.newusers.questions 9123
---------------------------------------------

Wenn die Artikel-Nummer unbekannt ist (sehr warscheinlich), kann
man beim ersten mal folgendes Eintragen:

---------------------------------------------
de.comm.software.ums   9999999
de.comp.sys.amiga.comm 9999999
de.newusers.questions  9999999
---------------------------------------------

Jetzt werden in diesen Gruppen keine News geholt, aber nntpget
setzt die Nummer auf den aktuellen Wert.
Alternativ kann man auch statt "9999999" "1" einsetzen. Dann
holt nntpget *alle* verfügbaren Nachrichten in der Newsgroup,
was sehr lange dauert kann.
Es ist auch möglich, für Newsgroup die maximale Größe der
Nachrichten anzugeben, bis zu der die Nachrichten geholt
werden sollen. Das sieht dann z.B. so aus:

de.comm.software.ums 215 50000

nntpget holt jetzt nur noch Nachrichten komplett, die kleiner als
50000 Byte sind. Bei größeren Nachrichten wird nur noch der
Header geholt und der Body durch eine "Fake"-Nachricht ersetzt.

Aufruf der Programme:
=====================

*nntpget server active [#sockets [message-base [username password
 [umsuser umspwd]]]]

NNTPGET ist für das holen der News zuständig.
Die Parameter
sind dafür für folgenden zustängig:

-server:   Der Newsserver, von dem die News geholt werden sollen.
-active:   Der Dateiname des Active-Files.
-#sockets: Anzahl der Verbindungen, die zum holen der News benutzt
           werden sollen. Der Werte sollte nicht zu hoch sein -
           sinnvoll sind Werte zwischen 1-4.
           Default ist 5
-message-base: Die benutzte Message-Base. Normalerweise "default"
-username  
 password: Falls man einen fremden Newsserver mit Anmeldung
           benutzt, muß man hier den Usernamen und das Passwort
           für den Newsserver angeben.
-umsuser
 umspwd: Hier gehören Name und Passwort des Exporters hin.
         Üblicherweise sind das 'NNTP ""'.

Beispiele
~~~~~~~~~
Aufruf bei Benutzung des Newsserver des eigenen Providers:
nntpget news.serv.er 1

Newsserver mit Anmeldung:
nntpget news.serv.er 1 default <username> <passwort>


*umsnewsimport active [umsuser umspw message-base]

-umsuser
 umspwd: Hier gehören Name und Passwort des Exporters hin.
         Üblicherweise sind das 'NNTP ""'.
-message-base: Die benutzte Message-Base. Normalerweise "default"


UMSNewsimport sortiert die Empfangenen News in die Message-Base ein.
Als erster Parameter wird hier der Name des Active-File angegeben.