**************************************************************************** * * * FUSTick 2.8 by Robert Wahlström 94-Mar-13 * * * * Copyright © by Robert Wahlström All rights reserved. * * * * Process and hatch .ticfiles * * * * Written in SAS C 6.51 with CygnusED Pro & Chelp on Amiga 4000/040. * * * * Robert Wahlström * * Enehagsg 197 * * S-441 57 ALINGSÅS SWEDEN * * * * Usenet: d0robert@dtek.chalmers.se * * Fidonet: 2:203/316.0 * * Amiganet: 39:160/303.0 * * * * * * Support BBS: UTILITYBASE +46-322-17877 16.8kHST+V32" 2:203/316.0 * * * **************************************************************************** $VER: FusTick 2.8 (94-Mar-13) © by Robert Wahlström 1994 1. INTRODUCTION =============== WHAT IS FusTick? FusTick is a utility that handles file echo .tic files. At the moment FusTick works with MEBBSNet and as a stand alone program. 2. LICENSE ========== This material is © Copyright 1994 by Robert Wahlström -- All rights reserved. It may be distributed freely as long as the following restrictions are met: The distributor may charge a fee to recover distribution costs. The fee for diskette distribution should not be more than the cost to obtain the same diskette from Fred Fish. The distributor agrees to cease distributing the programs and data involved if requested to do so by the authors. You may copy and distribute verbatim copies of the program's executable code and documentation as you receive it, in any medium, provided that you conspicuously and appropriately publish only the original, unmodified program, with all copyright notices and disclaimers of warranty intact and including all the accompanying documentation, example files and anything else that came with the original. The author will not be liable for any damage arising from the failure of this program to perform as described, or any destruction of other programs or data residing on a system attempting to run the program. While I know of no damaging errors, the user of this program uses it at his or her own risk. 3 REQUIREMENTS ============== AmigaDos 2.0 or higher. Mebbsnet 0.158 4 INSTALLATION ============== Put FusTick anywhere. (Ex in directory MebbsNet:c) FUSTick NEEDS a configutation file called TICK.CFG this file can be placed in the directory from where FUSTick is started. If an Env variable is set FUSTick gets the configuration file name from the ENV variable. EX: setenv FusTick MebbsNet:ConfigFiles/tick.cfg Fustick gets Tick.cfg from MebbsNet:ConfigFiles/tick.cfg If FusTick is started with the argument CONFIGFILE= The argument filename will be used INSTEAD of the ENV variable namne. Fustick also handles a datafile to be used from other FUS utilities like the TickStat (Fileecho statistics utility) Example configuration file: 5 CONFIGFILE ============ HERE
[AKA
[Address] ... ] PASSWORD
[EMAILAREA] [CHECK_CRC] [IN ] [OUT ] [BAD ] [COPYTIC ] [LOGFILE ] [LOGLEVEL ] [LIST []] [HOLD ] [MEBBS] - Signals FUSTICK that you are using MEBBS and without this line FUSTICK can't add files to the MebbsNet file areas. [UTC ] [DEFAULTAREA ] ; FileEcho block. ONE block for each file echo AREA FILEECHO [FILEAREA ] [MAKEFREE] [NOHATCH] TO [
... ] Items in square brackets "[]" are optional, depending upon the environment. See breakdown below. Items in "greater than" and "less than" symbols "<>" are not literal, but should be replaced by appropriate data. Lines are >NOT< case sensitive, and may be preceded or followed by whitespace. Blank lines and sections of lines following a semicolon ";" will be treated as comments and ignored. HERE ------------------------- The "HERE" parameter tells FusTick what your system's FidoNet address is. This must be your 3 or 4 dimensional address. ex: HERE 2:203/316 HERE 2:203/316.5 [AKA
[Address] ... ] ------------------------------- If your system is using AKA addresses enter them here like: ex: AKA 39:160/105 PASSWORD ---------------------------------------- All system that you send/recive files from MUST be listed in the password list.If FUSTICK fails to find a node or correct password. The file and the tic file will go to a BAD directory. ex: PASSWORD 2:203/316 UtilityBase PASSWORD 2:203/129 PASSWORD 2:203/316.5 dfhg EMAILAREA ----------------------- The number of your email area. Default 1 CHECK_CRC --------- Having this line in your Tic.cfg file is a good ide since it checks if the file is corrupt in some way and no one likes to get bad files via a file echo. IN ----------------- Your inbound directory. The default is "MebbsNet:in/". ex: IN MAIL:inbound/ OUT ------------------- Your outbound directory. The default is "Mebbsnet:out/". ex: OUT MAIL:outbound/ BAD -------------------- The directory where all bad files (unknown area, failed CRC check, from unknown system, Tick files without the appropriate file) are moved to. The default is "MebbsNet:bad/". ex: BAD MAIL:BAD/ COPYTIC ----------------------- Backup directory for all incoming ticfiles. Default: No backup ex: COPYTIC back:tic/ LOGFILE ---------------- Name and path to logfile. Recommended: Assign a directory to hold the LOGfiles. like: Assign LOG: Mail:log (wish this could be a standard log dir) :-) (We DONT want them in MebbsNet: its full of stuff anyway) ex: LOG:FUSTick.log LOGLEVEL ---------------- Loglevel value 1-9. Higher value - more logging level 3 is default ex LOGLEVEL 5 HOLD ------------------------- This indicates that the .flo files should be HELD until the reciving node calls you. (The .FLO is changed to .HLO file.) Note that this option ONLY works with 4 dimentional addresses (read Trapdoor or other external mailer) ex: HOLD 2:203/129.0 HOLD 2:203/316.5 LIST ------------------------------------------------ This line is used to generate a listing of the files processed by FusTick. There may be any number of these lines, limited by memory of course, and they may each act upon any number of echos. Below is an explanation of each field: This is a simple pattern match, which indicates which echos are to be considered for listing in this listfile. It accepts the MS-DOS type "?" and "*" , and Amiga-DOS wildcard characters. This is the path and name of the file FusTick should make the file list in. This is the format FusTick should use when adding to the list file. It is a very powerful way to specify the look of the list. Those who know C will recognize the syntax of the format specifier, those who don't may have a little trouble understanding it. All text is copied exact except for sequences starting with a percent "%" symbol. They work as follows: %[-][] Where: % is the escape to a sequence - must prefix all of them. [-] is an optional dash meaning "Left justify this field" [] is the optional (fixed) width of the field. Replace this with the appropriate number if you wish to make your listing in columns, otherwise the field will be of variable length. If field is numeric (i.e. CRC, length) a leading 0 may be specified to pad the leading end of the number with 0's. is the type of field. There are 7 types supported: a areaname c crc Form: Hex digits d description l length Form: Decimal digits (in bytes) n filename o origin address Form: (Z:Net/Node) Examples: LIST SKY* ADSFILES.LST Area: %a\nName: %n\nLength: %l\nDesc: %d\nOrigin: %o\nCRC: %c\n LIST NODE* FIDOFILE.LST %-12a | %-14n - %d\n The first would result possibly in this listing being generated: Area: SKYUTILS Name: CH136_E.LHA Length: 44060 Desc: Chelp 1.36 [eval] - Search in autodocs & includes Origin: 1:150/111 CRC: 6623414 While the second would result in something like this: NODEDIFF | NODEDIFF.A45 - FidoNet NodeDiff for day 145 NODEDIFF | NODEDIFF.A59 - FidoNet NodeDiff for day 159 '\n' is replaced by a newline character when printed. A '\n' must be placed at the end of the line. It is fine to have multiple LIST lines pointing to the same file, as long as the tag patterns are mutually exclusive (or duplicate listing will occur). If no output format is specified, the following is default: %-16a | %-13n | %7l | %d\n MEBBS ------- Notifies that MebbsNet is the BBS program you are using Without this comand FUSTICK cant send files to the MEBBSNET file areas. UTC [offset] ------------ The offset value specifies the time in minutes to calculate the UTC from your local time. This value is added to your local time before FusTick inserts any date-/time-strings into the path-lines of a .tic file. Sweden -60 (summertime(GMT)) -60 (wintertime(CET)) UK 0 ex: UTC -60 DEFAULTAREA [namn] ------------------ Tells FUSTICK what default area to use when hatching files. ex: DAEFAULTAREA SKYPROG FileEchoblock ============= FILEECHO ------------------------- Indicates the start of an 'Area Block' all lines below this line has to do with ONE fileecho area. All paths MUST end with an / or : ex: FILEECHO ADSMEBBS DIV:files/mebbs/ MUST be present if you dont want to add the incomming files wiht its descriptions to the MEBBSnet Fileareas.This might be convienient if you want to add the file to another directory. If the FILEAREA command is present with the area actuall Areaname the file will be added to MEBBSnet fileare listings and the physical file will be copied to the appropriate directory. FILEAREA -------------------- The actual name in your BBS for the file area where you want your incomming files. ex: FILEECHO ADSMEBBS FILEAREA Mebbs Utilities TO 2:203/424.0 TO 2:203/319.0 MAKEFREE -------- Enter this if you want the areas incomming files to be Free download. NOHATCH ------- If you don't want to hatch files in this area. ex: FILEECHO NODEDIFF mail:nodelist/ NOHATCH ; Don't hatch in nodediff TO 2:203/316.5 TO ... -------------------------------------------------------------------- ex: TO 2:204/641.0 2:204/455.0 Tells Fus tick who to send recived files to Note that if your BBS is the last in the chain and you are NOT sending it to anyone else just enter a blank TO statement in those areas. ex: FILEECHO NODEDIFF mail:nodelist/ TO FILEECHO NEWSTARTICK work:lc/prg/snet/newstartic/fil/ FILEAREA Utilities TO 2:203/300 FILEECHO SKYUTILS work:bbs/fl/utils/ MAKEFREE FILEAREA Graphics TO 2:203/129 TO 2:203/600 2:203/235.5 6 Running FusTick ================= FUSTick arguments: FUSTick [HATCH] [CONFIGFILE=] [PUBSCREEN=] [LIST] [QUERY=] CONFIGFILE - Tells FUSTICK to use another configuration file the the default one (Tick.cfg) OR the file specifyed with the ENV command. ex: FusTick CONFIGFILE=work:special_tick.cfg HATCH - Puts FUSTICK into HATCH mode and open hatchwindow. PUBSCREEN - Open Hatchwindow on a publicscreen ex: FusTick HATCH PUBSCREEN=DOPUS.1 QUERY - List all active areas for node [nodenumber] ex: FusTick QUERY=2:203/316 LIST - List all availible areas ex: FusTick LIST 7 The HATCHING of FILES ========================= FusTick HATCH Opens a window that is used to hatch files in to an file echo. The "square" at the right are used to select the filearea to hatch the file in. FILE Field: Are used to select the file to hatch. You could also use a regular file requester to select file to hatch with the TINY gadget at the window. enter something like: Work:prog/FUSTick_101.lha AS field: Tells Fustick under what name the file should be sent. ex: FST101.lha DESC field: Where to enter the file description. ex: FusTick 2.7 Nice tick utility for MEBBS. TO FILAREA gadget: Used if you want the file sent to your own BBS fileareas. CYCLE gadget: Selects type of outgoing file HOLD, NORMAL or CRASH HATCH: When everything is set this one is selected to actual HATCH the file 8 TickStat ========== Tickstat is a small utility that monitors the amount of incomming fileecho files. TickStat [-f] Tickstat Tries to get the information from tick.log.dat Tickstat -f Uses the dat file from the one entered. ex: TickStat -flog:Tick.log.dat ex of running tickstat: TickStat 0.04 © 1992 Robert Wahlstrom Area Today Week Month Year Total ========================================================== ADSFIDO 7 7 7 7 7 SKYTEXT 3 3 3 3 3 SKYCOMMS 0 50 50 50 50 NODEDIFF 0 59 59 59 59 SKYPROGS 0 104 104 104 104 SKYUTILS 145 393 393 393 393 FUS_FILES 0 171 171 171 171 ADSWORK2 0 78 78 78 78 Total: 156 868 868 868 868 9. ADDRESSES AND PHONENUMBERS ============================= If You have any questions, suggestions or bug-reports, please contact us. NetMail, snailmail, voice or logging on to our support bbs's. Here are addresses and phonenumbers: Robert Wahlstrom Enehagsg 197 S-441 57 ALINGSÅS SWEDEN phone: +46 (0)322-183 31 Support BBS: UtilityBase +46 (0)322-178 77 v32" + 16.8k HST Fido: 2:203/316.0 Amiganet: 39:160/303.0 Usenet: d0robert@dtek.chalmers.se MEBBSnet Service Center (SWEDEN): Yggdrazil bbs +46 (0)11-164276 Line 1 +46 (0)11-107033 Line 2 +46 (0)11-107037 Line 3 +46 (0)11-107069 Line 4 Fido: 2:204/455.0 10. CREDITS =========== Thanks to the following for hints, suggestions and debugging: Kejll Harnesk - alfatesting, many ideas. Kjell Cederfeldt - alfatesting, many ideas. Mikael Johansson - alfatesting Stefan von Straten - MEBBS support Sweden, Documentation. William Bowling - MEBBS 11 Other programs by Robert Wahlström ===================================== FusEdit - Fullscreeneditor for MEBBS FusAC - Areafix for MEBBS FusList - Very configurable filearea list creator Chelp - A help program for programmers - Lookup functions in autodocs and strcuts/defines in includefiles Ast - Astronomyprogram (beta only)