Category : BBS Programs+Doors
Archive   : WGT109A.ZIP
Filename : CONFIG.DOC

Included below are a few words on each of the configuration records
currently defined for the WWIVGATE.DAT file.

Note that anything after a ; on a line is treated as a comment. This is
convenient for toggling options on and off - simply insert a ; as the
first character of the line to disable the option.

Registration_number = xxx

This record, if present, defines your registration number so that
you will quit getting the tones and Please Register type message.
Simply substitute the registration number I e-mail you for the xxx
above and the tones and messages should never appear again. Note
that each registration number is keyed to a particular FIDOnet zone,
net, and node, so giving it out will probably not help your friends.
Invalid values (like "unregistered") are simply ignored.

Debug = n

This record enables various levels of debugging messages to be
generated by the code. Level 1 may be useful when initially
setting up the product, Level 0 is recommended after everything
is set up and working. Higher levels are only for those that are
very curious, or if you are assisting the author in tracking down
a bug.

Zone = z

Your FIDOnet Zone number. The z in z:nnn/fff. It is critical
that you get this one right, or mail and echomail post will be
mis-marked.

Net = nnn

Your FIDOnet Net number. The n in z:nnn/fff. It is critical
that you get this one right, or mail and echomail post will be
mis-marked.

Node = fff

Your FIDOnet Node number. The f in z:nnn/fff. It is critical
that you get this one right, or mail and echomail post will be
mis-marked.

User_rec_len = nnnn

This record allows you to specify your WWIVnet User record length.
It defaults to 832, which is the standard length of a WWIV 4.21A
system using the 64 sub support. This number has a maximum of
2048 for you truely mod crazy folks . The only dependance
WWIVgate has on the User Record is that the first two fields be
the normal default of handle and name, with their normal field
lengths.

Keep_after_processing

This record, if it exist, prevents WWIVgate from removing files
after it is done processing them. It's main usage is during initial
setup when WWIVgate may be being run by hand. Note that WWIVgate
may be called repeatably by your calling batch file if this record
is left uncommented out, since the files your calling batch file
keys off of, will be left when WWIVgate is done processing. I know,
I've done it...

Local_mail_only

This record, if it exist, prevents WWIVgate from exporting e-mail
from WWIV nodes other than yours. If this record does not exist,
anyone on WWIVnet (or equavalent) can route mail to FIDOnet through
your node.

Crash_mail = n

This record allows you to control the FIDOnet Crash bit setting on
generated FIDOnet e-mail. When set to 0, the Crash bit will never
be set. When set to 1, e-mail destined to another node in your
zone and net will have the Crash bit set. When set to 2, e-mail
will always have the Crash bit set, even if the mail is to another
net or zone.

Direct_mail = n

This record allows you to control the FIDOnet Direct bit setting on
generated FIDOnet e-mail. When set to 0, the Direct bit will never
be set. When set to 1, e-mail destined to another node in your
zone and net will have the Direct bit set. When set to 2, e-mail
will always have the Direct bit set, even if the mail is to another
net or zone.


High_Ascii

This record, if it exist, prevents WWIVgate from removing any
character in the ASCII code range of 128 to 170. Normally, all
"high_ascii" (codes 128-255) are removed from text when processed.
This feature was added to allow non-english character sets to be
successfully processed.

Pass_WWIV

This record, if it exist, prevents WWIVgate from stripping out
WWIV control characters (colors, and centering). This flag
should not be used unless the output is going directly to another
BBS that understands WWIV control codes.

Pass_All

This record, if it exist, prevents WWIVgate from removing any
"high_ascii" control codes. Again, only use this keyword if you
know what your doing. Most FIDOnet networks do not allow "high
ascii" characters in their messages. Added by request.

Always_Center

This record, if it exist, overrides the Pass_WWIV and Pass_All
flags in regards to centering. If this record is used, the WWIV
center codes will always be honored.

Alias_ok

This record, if it exist, prevents WWIVgate from translating
incomming user names from what is assumed to be a real name to
the users alias. In other words, it tells WWIVgate that Aliases
are the norm for the FIDOnet compatible network you are running.

Skip_Sysop_Mail

This record, if it exist, prevents WWIVgate from processing any
inbound mail destined for the Sysop. This is any netmail, not
echomail, addressed to "Sysop", "ALL", or the real name of WWIV
user number 1.

Areafix

This record, if it exist, prevents WWIVgate from processing any
inbound mail destined for the user "Areafix". This is useful
for folks that run programs like GEcho who use the name Areafix
for managing echo feeds.

Add_CR

This record, if it exist, will tell WWIVgate to add a CR after
every 78 characters of inbound text. This is useful if your editor
does not gracefully handle things like quoteing... Many FIDOnet
mail processes just ship a unbroken stream of characters without
any line breaks. Line breaks should occur on word boundries.

Soft_CR

This record, if it exist, will tell WWIVgate to allow soft CRs
commonly present in FIDOnet messages to be passed through to
WWIV. Since soft CRs (hex 8D) are not normally displayable, this
might cause some viewing discomfort.

Soft_to_HardCR

This record, if it exist, will tell WWIVgate to convert soft CRs
to hard CRs.

Kill_tag

This record, if it exist, will tell WWIVgate to kill all tag lines
it finds while exporting messages. This option is dependant upon
the tag line starting with a Ctrl-D.

WWIVnet_name = xxx

This record, if it exist, allow folks running WWIVnet compatible
networks to use WWIVgate. xxx should be replaced with whatever
you define your network name to be in INIT (WWIVlink, ICEnet, etc.).
An alternative is to set the WWIV_Net environmental variable to
point to the INIT defined network.

Force_fake = xxx

This record, if it exist, forces the fake_net node number that
WWIVgate will use. This takes a bit of explaining...

WWIVgate was originally written using the WWIV 4.21a facility of
supporting multiple networks. This WWIV feature was utilized so
that when I person posted, or e-mailed, someone on FIDOnet, the
message comming from WWIV would indicate that (ie. "This message
will go out on FIDOnet"). The main goal of the original WWIVgate
was to allow the Sysop to have their board participate in FIDOnet;
not to gate FIDOnet echos into WWIVnet land.

In part due to its name, and in part due to the functionality of
similar programs like NETSex, some folks expected WWIVgate to
literally gate messages between the FIDOnet world and the WWIVnet
world. WWIV 4.22 appears to allow that, if the sysop sets it up
properly.

Force_fake is an alternative to using the WWIV 4.22 setup. It
will force the fakenet number to be whatever is specified. It
is designed to be used in conjuction with either one of the
command line options.
For instance, if WWIVnet is defined in INIT as network
1, and WWIVgate is called via the command line: "WWIVgate 1",
WWIVgate will port described subboards directly into WWIVnet.

When this option is used, it should be noted that no indication
will be given to the use that their post is destined for FIDOnet.

Non_Local

This option, if it exist, will cause WWIVGate to process all
*.MSG files that have the LOCAL bit set. It will also prevent
WWVIGate from marking messages generated as LOCAL. Use this
option carefully, and only if you understand what this means.
The option was added by request of a registered user who was
using WWIVgate to move messages between BBSes... It is NOT for
general usage but is documented here because it IS available.

Origin:

This record allows you to specify the origin line you would like to
appear on echomail posts.

Subboard

These records map for WWIVgate the relationship between WWIV sub-types
and FIDOnet message folders. A special sub-type keyword of "mail"
should be used for your FIDOnet e-mail folder. Failure to specify
a mail folder will typically cause WWIVgate to die while trying to
process mail. This is another common source of program looping,
since the mail would not be processed, but would remain waiting to
be processed.