Config files and its commands =============================== JS_TOSS uses some config files to work. All work the same - they are ASCII files, the command lines are scanned with dos/ReadArgs(), comments start with ";", command options are seperated with spaces, options that should contain spaces must be in quotation marks. The general config file of JS_TOSS is "JS_Toss.cfg" in the "MAIL:" directory. Some other files are placed in a so called "areafile" directory with is specified in the general config. Config Files in "areafile" directory ------------------------------------ (ZZ - zone, NT - net, ND - node, PT - point) "Config_ZZ_NT_ND_PT" Link area config file "Config_ZZ_NT_ND_PT.Sysop" Link area config file for sysop "Config_ZZ_NT_ND_PT.BBS" Link area config file for BBS "Default_Config_ZZ" a default link area config file for all links without a link area config in zone ZZ - should include the default packer and unpacker and maybe some echos you like to add to every new point "Zone_ZZ.cfg" Zone config file: Area list and description (generaded/updated in SCAN mode, not used by JS_TOSS but always updated, needed from "JS Areafix"!) Config file (MAIL:JS_Toss.cfg) ------------------------------ Commands: INBOUND drawer/A path to inbound dir OUTBOUND drawer/A path to outbound dir SYSOUT drawer/A path to sysop outbound -> sysop tosser's inbound! SYSIN drawer/A sysop inbound -> sysop tosser's outbound! BBSOUT drawer/A bbs outbound -> bbs's inbound! BBSIN drawer/A bbs inbound -> bbs's outbound! AREACONFIG drawer/A drawer of link area lists LOGFILE name/A name & path of logfile (default "Mail:JS_Toss.log") TEMPDIR path/A for temporary files (e.g. for mail robots) PACKDIR path/A for packing and unpacking mail archives LOGLEVEL number/A/N 1-4, 1-only important infos (default) 2-more 3-muchmore 4-all additionals GLOBALERRORHANDLER name/A name & patch to global error handling program if non is given, no globar error handler is started (if you want to use a DOS or ARexx script, don't forget the EXECUTE or RX command) ERRORHANDLER errornumber/A/N,name/A name & patch to error handling program for specified error number, if non is given for an error number, the global error handler is started (if you want to use a DOS or ARexx script, don't forget the EXECUTE or RX command) GLOBALAUTONEW turns autonew on (global switch - no parameters) BEFORESESSION command/script started before tossing, current dir is MAIL: AFTERSESSION command/script started after tossing current dir is MAIL: SECURE if present turns SECURE mode on (sysop will be informed in read only echo JS_TOSS.SYSOP of all errors or wrong things by mail - also mail robots may use this echo) BADMAIL enables JS_TOSS.BAD echo for bad echo mails NODELIST path/A path to the traplist compiled nodelists (defaults to "Nodelist:") ATTACHTOSYSOUT if enabled file attachs to the sysop will be copied into the sysop's outbound but some file tickers send their files as file attachs so the local ticker won't find the files if all file attachs are copied (attention! name ends "sysout" not "sysop") NODE address/A address of local system, following commands need this ¹ AKA address/A alternativ address of local system in this zone ¹ ² NAME name/A Sysop name of this zone to send sysop mail to correct tosser, DOS pattern matching! ² ³ LINK Address/A,HOLD/S,DAILY/S,MAXSIZE/S Link addresses (Points, etc.), HOLD put mails for this node/point on HOLD, DAILY generates every day an other mail packet (otherways all new mails are put in one packet), MAXSIZE tell JS_TOSS that mail packets size should always be smaller than 0.5 MB. ¹ ² DAILY currently now supported! LAKA Address/A alternativ address of the last link (lines before) - attention! JS_Toss uses ALWAYS the "Link Area Config" of the "LINK" command address TRACK filename/A name & path to tracker - will be started before every netmail is routed! ¹ ² (if you want to use a DOS or ARexx script, don't forget the EXECUTE or RX command) ROBOT name/A,filename/A name of mail robot (e.g. AREAFIX) and path&filename to program to start if mail for it ¹ ² (if you want to use a DOS or ARexx script, don't forget the EXECUTE or RX command) AUTOHUB address/A
has to be a HUB address! If JS_TOSS finds no "link" address for a netmail and the destination has
as his HUB this mail will be routed to him. This HUB has to be known be the "LINK" or LAKA command. If no HUB matches the "ROUTE" command (see below) is used for routing this mail. ¹ (to use this feature, your must have nodelist installed and compiled with traplist) this will slow down tossing a little bit! ROUTE foraddress/A,toaddress/A to route all mails for to must be listed as "link" (could also be a "laka" but the "link" address will be used!) may have the wildcard "*", see below for details ¹ ² The order is: - if we have a direct LINK we route to this - if we have AUTOHUB active for the HUB of destination node we route to this HUB - now the ROUTE list will be looked for - if really nothing is found (this maybe a wrong mail or you forgot something in the routing list) the mail is lost. But the SYSOP will be informed via SYSOP echo! ATTACH address/A allows file attachs to this
, may have wildcard "*" - see below ¹ ² AUTONEW address/A this
is allowed to send new public echos that will be added to echolist of sysop and this
(only activ if global autonew GLOBALAUTONEW is set!) see below for wildcard usage ¹ command may be used more than one times ² command can only be used after "node" command and all data belong only to this special address ³ command can only be used once per "node" command Link area config ---------------- PACK name/A to pack tool including parameters (e.g LhA a) ¹ UNPACK name/A to unpack tool including parameters (e.g. LhA x) ¹ AREA areaname/A name of connected area ² RAREA areaname/A name of connected readonly area ² All other commands are ignored and should/could also be ignored by mail robots, etc. BUT MAY NOT DELETED! This lines could be some additional commands of a mail robot or of JS_TOSS itself. Currently JS_Areafix doesn't support this! ¹ only one times per file required ² as many as areas are connected Zone config ----------- AREA name/A,description echo name and description ¹ LOCK address/A lock this address form echo listed before - see below for wildcards ² READONLY address/A echo listed before is readonly for this address - see below for wildcards ² ¹ as many as areas are there ² as many as you which - but they always belong (only) to the "area" command before ATTENTION! "lock" and "readonly" are only used by JS AREAFIX! If you want to set an user for an echo READ-ONLY after he has activated it you must also change his "link area config" ("rarea" command). If you want to lock him for an echo you have to remove this area from his link area config! --------------------------------------------------------------------- JS Areafix ---------- JS Areafix is the buildin areafix of JS_TOSS. It uses the same config files as JS_TOSS but has some additional commands. Config file (MAIL:JS_Toss.cfg) ------------------------------ (same file as JS_TOSS uses!) Commands: AREACONFIG drawer/A drawer of link area lists (set this once for JS_TOSS and all is fine!) LOGFILE name/A name & path of logfile (set this once for JS_TOSS and all is fine!) NODELIST path/A path to the traplist compiled nodelists (set this once for JS_TOSS and all is fine!) NO DEFAULT! LOGAREAFIX turn on log function PACKER name/A,packername/A,unpackername/A,text adds a packer and unpacker to the list the user could select one, you may add an optional description for this packer (e.g. packer LHA "c:lha a" "c:lha x" "THE Amiga packer") FORWARD address/A,receivername/A,sendername/A,areafile/A forward request feature:
is the address of the node you allow forward request, is the name of its areafix, is the name the reply of the forward request will be send to - use name "NIL" if possible so this replys will be ignored, is the path & name of an list of areas you could request at
, this file looks the same as Zone Config Files, so LOCK or READONLY and echo descriptions are allowed. To avoid conflicts put every echo only once in ALL forward files or JS_Areafix will take the first matching echo it founds - and this needn't to be in the first areafile! MASTER password/A sets password for MASTER command, if not set in config file MASTERMODE can't be enabled! (from local MASTERMODE can ALWAYS be activated!) MACRO name/A,file/A file is a collection of areafix commands (%LIST, etc.) that could be started with % from any user - no mail is send to user from these script commands! If contains "%z" it will be replaced by current zone (e.g. "Mail:macrofile.%z" to "Mail:macrofile.2"), "%p" will be replaced by everything the user added behind the % command (e.g. "%test foobar", so "foobar" will replace "%p") MASTERMACRO name/A,file/A same as "macro" but only in MASTERMODE available! -- PACKER and FORWARD are allowed as often as needed -- --------------------------------------------------------------------- FTSC = Fido Technical Standard Committee Fido and FidoNet are registered marks of Tom Jennings and Fido Software.