home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
DP Tool Club 15
/
CD_ASCQ_15_070894.iso
/
vrac
/
ttoss101.zip
/
TRITOSS.DOC
< prev
next >
Wrap
Text File
|
1994-06-03
|
20KB
|
1,057 lines
TriToss (tm) 1.01
Copyright 1994 By TriSoft
COPYRIGHT NOTICE
TriToss is a copyrighted program being distributed under the shareware
concept. As such, you may use TriToss for a period of 30 days without
registering the software. After the 30 day evaluation period, you
must register your copy of TriToss or you will be in violation of
United States and International copyright laws.
As a shareware program, TriToss my be freely distributed through a
BBS. Shareware distributors may distribute copies of TriToss on disk
for a modest disk duplication charge not to exceed $6 per disk.
It is a violation of the TriToss license agreement to modify the EXE
file in anyway.
TriToss key files may not be transferred without the expression
written permission of TriSoft.
WARRANTY
TriToss is distributed without warranty. In no event will TriSoft be
liable to you for damages, including any loss of profits, lost
savings, or other incidental or consequential damages arising out of
your use of or inability to use the program, even if TriSoft or an
authorized representative has been advised of the possibility of such
damages. TriSoft will not be liable for any such claim by any other
party.
TRADEMARKS
TriToss is a trademark of TriSoft.
TriBBS is a registered trademark of TriSoft.
All other trademarks are the property of their respective owners.
ACKNOWLEDGMENTS
TriToss uses the excellent SPAWNO routines by Ralf Brown to minimize
memory use while shelling to DOS and running other programs.
TABLE OF CONTENTS
INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
SETTING UP TRITOSS . . . . . . . . . . . . . . . . . . . . . . . . 2
THE TRITOSS CONFIGURATION FILE . . . . . . . . . . . . . . . . 2
THE TRITOSS AREAS FILE . . . . . . . . . . . . . . . . . . . . 3
RUNNING TRITOSS . . . . . . . . . . . . . . . . . . . . . . . . . . 5
ADVANCED TRITOSS.CFG COMMANDS . . . . . . . . . . . . . . . . . . . 6
AREAFIX COMMANDS . . . . . . . . . . . . . . . . . . . . . . . . . 8
AREAFIX MESSAGES . . . . . . . . . . . . . . . . . . . . . . . . . 10
OTHER TRITOSS COMMAND LINE COMMANDS . . . . . . . . . . . . . . . . 11
MULTIPLE CONFIGURATION AND AREA FILES . . . . . . . . . . . . . . . 12
SUPPORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
i
INTRODUCTION
TriToss is a FidoNet tosser/scanner written expressly for the TriBBS
Bulletin Board System. As such, it can take incoming FidoNet echomail
archives and toss them directly into the TriBBS message base and
create archives for you FidoNet downlinks. Additionally, TriBBS can
scan the TriBBS message base for outgoing messages and create FidoNet
echomail archives for your FidoNet uplinks and downlinks. TriToss
also supports a large number of AreaFix features to allow your
downlinks to automatically request echoes without the need for you to
intervene.
1
SETTING UP TRITOSS
The first step in setting up TriToss is to create a directory for
TriToss. Use a DOS command similar to the following to create your
TriToss directory:
MD \TRITOSS
Next you must copy the file TRITOSS.EXE to the newly created TriToss
directory with a DOS command like the following:
COPY TRITOSS.EXE \TRITOSS
THE TRITOSS CONFIGURATION FILE
Now you must create a TriToss configuration file. This file must be
named TRITOSS.CFG and resides in your TriToss directory. You can
create a TriToss configuration file with any text editor. The
following in a sample TriToss configuration file:
----------------------------------------------------------------------
;
; TRITOSS.CFG for The Lobster Buoy
;
tribbs c:\tribbs ;Node 1's main directory
address 1:328/104 ;The Lobster Buoy's FidoNet address
netmail c:\fd\netmail ;My netmail directory
outecho c:\fd\outecho ;The directory where TriToss should place
;outgoing echomail archives
inecho c:\fd\inecho ;The directory where TriToss should look for
;incoming echomail archives
----------------------------------------------------------------------
You should note that TriToss will treat anything after a semicolon (;)
as a comment. Comments are strictly optional.
Now let's examine the TriToss configuration commands in the above
configuration file.
TRIBBS <node1's main directory>
The TRIBBS command is a required command and specifies where node
1's main directory is located.
ADDRESS <FidoNet address>
The ADDRESS command is a required command and tells TriToss the
FidoNet address that it should use in PKTs, origin lines, SEEN-BY
lines, and PATH lines.
2
NETMAIL <netmail directory>
The NETMAIL command is a required command and tells TriToss where
it is to place ARCMail and AreaFix messages and where TriToss is
to look for AreaFix messages.
OUTECHO <outgoing archive directory>
The OUTECHO command is a required command and tells TriToss where
it is to place outgoing echomail archives.
INECHO <incoming archive and packet directory>
The INECHO command is a required command and tells TriToss where
it is to look for incoming echomail archives and packets.
There are a number of other optional configuration files command that
advanced users will want to take advantage too. They will be
discussed in detail in another section of this manual.
THE TRITOSS AREAS FILE
Next you must create a TriToss areas file. This file must be named
TTAREAS.BBS and resides in your TriToss directory. You can create a
TriToss configuration file with any text editor. The following is a
sample TriToss areas file:
----------------------------------------------------------------------
;
; TTAREAS.BBS for The Lobster Buoy
;
The Lobster Buoy * Home of TriBBS ! Mark Goodwin
8 TRIBBS 1:328/104 105 6:670/23 55:324/1
10 DBRIDGE 1:328/105 1:3615/50 6:32/54
11 FDECHO 1:328/105 1:3615/50 6/32/55
19 NETADMIN 1:328/104 340/50 60 550/29 55:324/1
52 TTN_STARTREK 1:238/55 328/104 55:255/19 324/1
0 TTN_NETADMIN 1:45/368 328/104 2:55/63 55:324/1
----------------------------------------------------------------------
As with the TriToss configuration file, TriToss will treat anything
after a semicolon (;) as a comment in a TriToss areas file. Comments
are strictly optional.
The first uncommented line in the TriToss areas files must use the
following format:
3
<origin tagline> ! <sysop's name>
Where:
<origin tagline> is the tagline TriToss will append to messages
originating from your system. TriToss will append
the address that is specified in TRITOSS.CFG's
ADDRESS line to the origin tagline using the
following format (zone:net/node).
<sysop's name> is the sysop's name.
The remaining lines in the TriBBS areas file use the following format:
<conference number> <echo name> <node address> <node address> <...>
Where:
<conference number> is the echo's conference number in your message
base. IMPORTANT: You need to specify a conference
number of 0 for passthru echoes. A passthru echo
is an echo that is echoed to your downlinks, but
is not carried on your board.
<echo name> is the echo's FidoNet name.
<node address> is a node address that this echomail area is
echoed to. You must specify at least one echomail
address. IMPORTANT: Be sure to include the
address of the hub that you get the echo from as
well as your downlinks.
To keep the lines in TTAREAS.BBS as short as
possible, you can use a SEEN-BY like shorthand for
specifying node addresses. For example, if the
next node address has the same zone as the
previous node address you only have to specify the
next node's net and node address (net/node). If
the next node address has the same zone and net as
the previous node address you only have to specify
the next node's node address (node).
4
RUNNING TRITOSS
Running TriToss is a pretty simple matter. Simply add something like
the following to your frontend mailer's batch file where it processes
received mail:
cd \tritoss
tritoss
cd \fd
Yes, it's that simple. TriToss both scans and tosses in a single
operation. This is done for two reasons: the way the TriBBS message
base is structured and it keeps TriToss an extremely simple program to
use.
IMPORTANT: TriToss uses PKZIP.EXE and PKUNZIP.EXE to archive and
dearchive echo mail archives. Therefore, both of these programs must
reside in a directory that is in your DOS PATH. If this they are not
in your DOS PATH, TriToss will not be able to function correctly.
5
ADVANCED TRITOSS.CFG COMMANDS
TriToss offers a number of commands in its configuration file for
advanced setups. All of these commands are strictly optional. This
section explains these commands in detail.
AKA <FidoNet address>
The AKA command is used to specify an alias address for incoming
archives and packets. Normally, TriToss will only process
incoming archives and packets that are addressed to the address
specified in the ADDRESS command line. By specifying an AKA,
TriToss will also process incoming archives and packets that are
addressed to the address in AKA command line.
Example:
aka 1:3615/51
ECHO_LIST <echo list path>
The ECHO_LIST command is used to specify what file TriToss will
send the a node that has included a "-L" switch in the subject
line of an AreaFix message.
Example:
echo_list c:\fd\netfile\fidonet.na
PASSWORD <FidoNet address> <password>
The PASSWORD command is used to specify a node that has AreaFix
access. You can have up to 255 PASSWORD commands in your
configuration file. A <password> can be up to 30 characters in
length and is case insensitive.
Example:
password 1:555/32 mypass
password 6/35/400 tribbs
password 1:328/104 lobster
FORWARD_LIST <list file> <FidoNet address> <password>
The FORWARD command is used to specify a list of echo areas, the
address of the hub that they are available from, and your AreaFix
password for that system. These lists are used to automatically
turn on echoes from your hub that you are not already carrying or
6
to turn off echoes from your hub that neither you nor your
downlinks want to carry anymore. You can have up to 10
FORWARD_LIST commands in your configuration file.
Example:
forward_list c:\fd\netfile\fidonet.na 1:101/1 lobster
The list files for these are simple ASCII text files with one
echo name per line like the following:
COMM
FDECHO
TRIBBS
C_ECHO
7
AREAFIX COMMANDS
TriToss offers a number of AreaFix commands that can be used simply by
running TriToss using the following format at the DOS prompt:
TRITOSS AREAFIX <command>
This section will explain these AreaFix commands in detail.
TRITOSS AREAFIX EC
The EC command instructs TriToss to scan and process any AreaFix
messages in the netmail directory.
TRITOSS AREAFIX FIND <FidoNet address>
The FIND command lists all of the active areas for a specified
node address.
Example:
tritoss areafix find 1:328/104
TRITOSS AREAFIX ADD <FidoNet address> <Echo> <Echo> <...>
The ADD command adds a specified node to one or more echo areas.
You should note that by specifying "ALL" for an echo area TriToss
will add the node to all available echo areas.
Example:
tritoss areafix add 1:328/104 tribbs c_echo
tritoss areafix add 6:32/400 all
TRITOSS AREAFIX DELETE <FidoNet address> <Echo> <Echo> <...>
The DELETE command deletes a specified node from one or more echo
areas. You should note that by specifying "ALL" for the echo
area TriToss will delete the node from all available echo areas.
Example:
tritoss areafix delete 328/104 comm fdecho
tritoss areafix delete 6:32/400 all
TRITOSS AREAFIX NOTIFY
The NOTIFY command will send a message to each of your AreaFix
8
nodes that lists all of the areas that are available to the node
and what areas each node is active in.
9
AREAFIX MESSAGES
How do downlinks use TriToss's AreaFix capabilities? Pretty easy,
actually. They simply address a message to AreaFix at your system's
address. On the subject line, they MUST put their AreaFix password.
Besides specifying an AreaFix password, the following two switches can
be specified in the subject line:
-L This switch instructs TriToss to attach a list of available
echos to a message. This list is configured in the TriToss
configuration file with the ECHO_LIST command.
-Q This switch instructs TriToss to send a list of of active
areas in a message.
In the body of an AreaFix message, a downlink can turn echoes on and
off by simply listing them one echo name per line. An echo will be
deleted if it is preceded by a hypen (-). The list of echoes must be
followed by a tearline (---). Anything after the tearline is ignored
by TriToss. Here's an example body of an AreaFix message:
----------------------------------------------------------------------
COMM
TRIBBS
-FDECHO
DBRIDGE
---
Hi! This is ignored by TriToss. :)
----------------------------------------------------------------------
This message would instruct TriToss to turn on the COMM, TRIBBS, and
DBRIDGE echos and turn off the FDECHO.
10
OTHER TRITOSS COMMAND LINE COMMANDS
TriToss supports two other important command line commands. This
section details how these commands are used.
TRITOSS RESET
The RESET command forces TriToss to reset the last message read
pointers in the TRITOSS.HGH file. IMPORTANT: Before adding or
deleting conferences from your board's configuration, you should
run TriToss to scan for any messages that may need to be exported
from the message base. After you've made the appropriate changes
to the message base, you should immediately run the RESET
command. Failure to perform these steps will result in messages
being lost.
TRITOSS OVERRIDE
To provide maximum dupe checking, TriToss will not re-export any
messages from the message base that have been previously scanned.
This can cause a problem if you want to scan the same conference
for multiple networks. This safety feature can be overridden
with the OVERRIDE command and should only be used if absolutely
necessary.
11
MULTIPLE CONFIGURATION AND AREA FILES
TriToss allows you to use multiple configuration and area files. To
use multiple configuration files use the following TriToss command
line:
TRITOSS <configuration file number>
or
TRITOSS <configuration file number> AREAFIX <command>
or
TRITOSS <configuration file number> RESET
or
TRITOSS <configuration file number> OVERRIDE
The <configuration file number> must be a number from 1 to 9 and you
should name your files as follows:
TRITOSS1.CFG and TTAREAS1.BBS
TRITOSS2.CFG and TTAREAS2.BBS
etc.
12
SUPPORT
I will only provide support for questions that deal directly with
TriToss. As much as I would like to be able to, I just don't have the
time to answer questions about how to setup a frontend mailer, a tic
processer, etc.
If you have a question about TriToss, a suggestion on how TriToss can
be improved, or you suspect a bug, please feel to contact me on The
Lobster Buoy at 207-941-0805, through FidoNet (1:328/104), through
Internet (mgoodwin@trisoft.com), or through any network that carries
the TriBBS Support conference.
13