; sysafix.txt
;
; This is the WaterGate help file
; This file is included by wtrgate.txt
;
; Contents: WtrConf System -> Areafix forwarding
;

; quick reference:
;
; #topic(reference text)
; #subtopic(reference text)
; #end
; #title(text)
; Space at start of line or #linebreak
; Empty line or #break
; #link(reference)(text)
; #highlight(text) or #hl(text)


;-------------------------------------------------------------------------
; SysAFix Area Request Forward Systems
;
#topic(SysAFix Area Request Forward Systems)
#title(Area Request Forward Systems)
When one of your downlinks requests an area that does not exist
on your system, WaterGate is capable of forwarding the request
for the area the Area Manager of your FTN uplink (AreaFix forward
system) or RFC uplink (Newsfix forward system).

You can define an unlimited number of systems to forward
the request to. For each system you can define a list containing
the areas the system has to offer, or you can choose to forward
the messages unconditionally.

Press Insert to add a new definition, Enter to change it or
Delete to remove it.

#subtopic(SysNFix Area Request Forward Systems)
#title(Newsfix forwarding)
This option was added to support external area managers for UUCP
systems. WaterGate names the area manager for UUCP "Newsfix" to
differentiate them from FTN area managers.

Because there is no such thing as a 'standard' area manager used by
UUCP hosts, WaterGate is unable to forward requests for areas to
such a host. Instead, an entry is written to a file that can be
post-processed by a program after WtrGate has run.

When a request a place, an entry to a file named #hl(UUCPAREA.REQ) in
the spool directory for the UUCP system this request is for. An
external utility can read this file and convert it to the format
required for the area manager of your host.

Example UUCPAREA.REQ file:
 hostuucpname,areaname
 wtrlnd,alt.bbs.watergate
 wtrlnd,alt.fan.doom.doom.more.negative.energy

#end


;===========================================================================
; Areafix Forward System Editor
;
#topic(Areafix Forward System Editor)
#title(Areafix Forward System editor)
This topic describes the fields that can be changed in the definition
of an Areafix Forward System in WtrConf under System Configuration,
FTN Settings, Areafix forwarding.

#subtopic(SysAFix Address)
#title(Address)
Enter the address for the system you want to forward your areafix
requests to; this system #hl(must be defined) as one of the users in
your userbase.

#subtopic(SysAFix ExportAKA)
#title(Export AKA)
Select your system AKA that WaterGate will use in the
To: field when writing a netmail to this areafix.

#subtopic(SysAFix Unconditional)
#title(Unconditional)
Select whether you want to unconditionally forward all area requests
for this group through this node, or only when the area is mentioned
in the area list.

#subtopic(SysAFix Arealist path)
#title(Arealist path)
Enter the complete path to an area listing.

Example:  C:\MSGBASE\FORWARD\AREAS.280

#subtopic(SysAFix Arealist type)
#title(Arealist type)
Select the type of area listing to use, you can either select
the "AREAS.BBS" format, or a simple name listing.

 [Areas.BBS]

   Origin ! Sysop_Name
   ;
   P ARENA      2:280/802
   1 POINTS     60:100/1

 [Name listing]

   ARENA         Local Discussion Group
   POINTS        The systems problem childs

#subtopic(SysAFix Area manager)
#title(Area manager)
The name of the area robot on the other system.
Most systems should be capable of recognizing "AreaFix" as a valid name.

#subtopic(SysAFix Password)
#title(Password)
Select the password to use for this system
when requesting new areas.

#subtopic(SysAFix Group)
#title(Group)
Select the group you want to use this entry for,
a message is only forwarded to this system if
the requesting user has access to this group.

The newly created area is also connected to this
group.

#subtopic(SysAFix AddPlus)
#title(Add "+")
If you toggle this option to Yes, WaterGate will add a "+" to every
area it request from this system, this because some areafix
implementations require the "+" as an additional command.

Most systems should accept area requests both with and without the "+".
#end


;===========================================================================
; Newsfix Forward System Editor
;
#topic(Newsfix Forward System Editor)
#title(Newsfix Forward System editor)
This topic describes the fields that can be changed in the definition
of an Newsfix Forward System in WtrConf under System Configuration,
RFC Settings, Newsfix forwarding.

#subtopic(SysNFix UUCPname)
#title(UUCP name)
Enter the UUCPname of the uplink your want this request to be
sent to. A UUCP User Definition must exist with this UUCPname.

#subtopic(SysNFix Newsgroup listing path)
#title(Newsgroup listing path)
Specify the path to a file containing the area names this
UUCP host has available.

Example of expected contents in newsgroups list file:
 areaname description
 alt.fan.doom
 alt.bbs.watergate Discussing WaterGate message processor

#subtopic(SysNFix Group)
#title(Group)
When a new newsgroup is requested from the UUCP uplink,
an area record is created and the area is automatically
put in the given group.
The user requesting the area must have access to this
group as well.
#end

; end of file sysafix.txt

