November 29, 2017 | Author: Sarah Harrell | Category: N/A
1 FBB Packet-radio BBS * FBB is a bulletin board software for amateur packet-radio. This software is free of charges. It...
FBB Packet-radio BBS * FBB is a bulletin board software for amateur packet-radio. This software is free of charges. It can be copied or installed only for non-commercial use abiding by the laws. * This software has been developed to be compiled on different architectures including MsDos (DosFBB), Windows 16 (WinFBB-16), Windows 32 (WinFBB-32) and Linux on PC hardware (LinFBB). All these versions have almost the same functionalities. Some differences may happen due to the capabilities of the operating and windowing systems. * TFWIN32.DLL is also available to interface WinFBB-32 to KISS TNCs. This DLL uses the WA8DED interface and is based on the TF23 TNC software of NORD> or B:\> If you now are ready to install FBB for the first time on your PC, you type INSTA700. You will now see at your screen something like this: ---- QUOTE: ---**** FIRST TIME INSTALLATION OF FBB 7.00 FROM DISK %disk% **** -
Main BBS-directory System-files Messages Binary-messages User's dir Yapp files Oldmail Statistics Documentation FBB-manuals Fwd-include-files Executable files -
C:\FBB C:\FBB\SYSTEM C:\FBB\MAIL C:\FBB\BINMAIL C:\FBB\USERS C:\FBB\USERS\YAPP C:\FBB\OLDMAIL C:\FBB\STATS C:\FBB\DOCS C:\FBB\DOC C:\FBB\SYSTEM\FWD C:\FBB\BIN 14
- Example files - C:\FBB\EXAMPLES.700 - Utilities - C:\FBB\UTIL (Fwd-include-files MUST stay under %system%.) If this configuration does not suit your needs, you must stop now with CTRL-C and edit the SET-lines in the file A:SUITE1.BAT. If a version of FBB 5.15c already exists, press Ctrl-C and use 515c700.BAT for upgrading. ----- UNQUOTE. ----This screen may vary a bit from version to version, but the work you have to do, will still be the same. First of all, you will see that the PC says that you will install from disk A. Is this correct ? If you are installing from disk-drive B, you must stop the installation now. The same applies if you want to use other directory-names or paths for some of the other directories that are listed on your screen now. If you DO want to change any of these things, you MUST do it now. The changes are described in this paragraph; if you do NOT want any changes, you can go on to the next paragraph. You stop the installation-batch by pressing CTRL-C. Now you will see the standard A:\> prompt again. Now you must use a normal text-editor and edit the file SUITE1.BAT on your diskette. I presume you have such an editor... Make sure that it is able to save the file again in (DOS) format ! So if you use for example Word Perfect, you MUST remember to save the file again in DOS-format ! At the beginning of that file, you will see a line saying SET disk=A: If you want to install from Bdrive, you edit this line like this: SET disk=B: You change only the letter after '=', nothing else ! You can also change all directory-names or directory-paths in this same way. If you do not want to use C:\FBB\SYSTEM, but want it to be C:\FICHIERS, you just change the line saying SET system=C:\FBB\SYSTEM to SET system=C:\FICHIERS and so on. You must ONLY change the name behind the '=' sign, you must NOT change anything before that in that line. You can do this with any (or all) the directory-names and paths. But remember that you will need to do some extra work with other config files later if you do not use the default installation. When you have finished doing the changes you want in the lines starting with SET, you must save the file again to disk. When that is done, you start over again from the beginning, by typing INSTA700 etc. OK. That is about all. Now the BBS-program and all its files will be installed on your hard-disk. You only have to change diskettes each time you are asked to (if you install from more than one diskette). Next, the installation-procedure continues by starting the program FBBSETUP. This program lets 15
you set all the parameters in INIT.SRV and PORT.SYS that you need for your installation. (FBBSETUP supports multiple language files, but for the first time installation you will probably have only the English language files.) Please take great care here, and go through ALL the pages of this installation very carefully before you exit the program. Be sure to put in your correct callsign, your correct H-route etc. FBBSETUP will update INIT.SRV and PORT.SYS for you, you will not need to change it manually later, if you take great care to do a good job now. The path FBB\BIN must be included in your PATH in AUTOEXEC.BAT. Do this by adding to the PATH line in AUTOEXEC.BAT ";C:\FBB\BIN" like: PATH C:\;C:\FBB\BIN Next, the same procedure for LinFBB follows. Skip it, and go directly to the section called "FIRSTTIME SETUP OF DIFFERENT FILES." For LinFBB: There are two versions: a windowing version (using X11 windowing system and MOTIF toolkit). a daemon version. The daemon version has no interface and works alone in background (like works an anti-virus, hi...). So the computer may be used for any application while the BBS is running. TNX to SM6TKY: If you need some help in setting up AF_AX25 and AF_NETROM for use with LinFBB, you may want to read the Appendix 23. You should now be ready to start the installation procedure. To install and run LinFBB you MUST have root access, you may log in as root or you can go to superuser mode with: 'su root' (1) Put the floppy disk into the disk drive. (2) If you have MTOOLS installed. To copy from floppy disk A:, type: mcopy a:/x700.tgz /tmp To copy from floppy disk B:, type: mcopy b:/x700.tgz /tmp If you have NOT MTOOLS installed. To mount floppy drive A: type: mount -t msdos /dev/fd0 /mnt To mount floppy drive B: type: mount -t msdos /dev/fd1 /mnt Then type: then type:
cp /mnt/x700.tgz /tmp, to copy the contents of disk to /tmp, umount /mnt, to unmount the floppy disk.
(3) Now you should create the base directory where you want LinFBB. Example, if you want LinFBB in: /usr/local/fbb Then type: mkdir /usr/local/fbb (4) If you now are ready to install LinFBB for the first time on your PC, 16
Type: Type:
cd /usr/local/fbb, to go to the LinFBB root directory. tar xvzf /tmp/x700.tg , to unpack the LinFBB archive.
OK. That is about all. Now the BBS-program and all its files will be installed on your hard-disk. Next, the installation-procedure continues by starting the installation script named INSTALL.SH This script lets you set most of the parameters in INIT.SRV (BUT NOT ALL !) that you need for your installation. Please take great care here, and go through ALL the questions of this installation very carefully before you exit the script. Be sure to put in your correct callsign, your correct H-route etc. The script INSTALL.SH will update INIT.SRV for you, but you will also need to check the rest of it manually, too, afterwards ! FIRST-TIME SETUP OF DIFFERENT FILES So far so good... Now we must modify some files, to make the system work. I will describe all the changes you MUST do, and some changes that you CAN do, if you like. Read this section very carefully. For most of the files it is VERY important that the number of non-comment lines must NOT be changed. Later in the Sysop manual you will find more details on some of these files, and also details on other files that are not described here in this startup-section. Files you MUST check/change: RUNFBB.BAT (ONLY for WinFBB) XFBB.SH (ONLY for LinFBB) APPEL.BAT (ONLY for DosFBB) PORT.SYS (MUST be changed for LinFBB, no changes needed for WinFBB or DosFBB) INITTNCx.SYS MAINTx.SYS Files you must change if you plan to do any forward: BBS.SYS FORWARD.SYS Files you should check, too, but not so important: BEACONx.SYS EPURMESS.INI SWAPP.SYS Files that are automatically configured by INSTWFBB and FBBSETUP, and should normally not be needed to change manually after (DosFBB and WinFBB). INIT.SRV PORT.SYS Files you may have a look at later (not so important). CRON.SYS REJECT.SYS PROTECT.SYS 17
LANGUE.SYS THEMES.SYS REDIST.SYS MEMO.SYS Start the BBS for the first time Now you should be ready to start the BBS for the first time. Before you do, make sure that the internal clock of the BBS is correct. If not, you must correct it now with the DOS-command DATE and TIME. In most newer PCs today, the clock is automatically set at each power-up. But in some older PCs you may need to use a special clock/calendar card in your PC, and use a special program to set the date/time at each startup. For this you must look in the manual for that clock/calendar card and include the appropriate command in your AUTOEXEC.BAT file. For WinFBB: Go to the FBB program-group an double-click the WinFBB icon. For DosFBB: Go to the FBB directory and type APPEL and press ENTER. For LinFBB: To start LinFBB in X-Windows: Go to base directory and run "./xfbb.sh" in a xterm. To start LinFBB deamon: Go to base directory and run "./xfbb.sh -d &". The first time you start the BBS like this, it may ask you if you want to create some files. Just answer Y (for Yes) every time. Then those files are automatically created for you. The BBS should now be ready for use. Try a connect to the BBS. Do this by pressing F2. The BBS will ask you for your name, city, home-BBS and ZIP-code. Only for LinFBB: Daemon version of LinFBB: Go to 'bin' directory, then use the utility 'xfbbC' to connect (eg: xfbbC -c). If you have set up PORT.SYS to allow incoming Telnet connections to LinFBB, then you can also use this.. For example, if you defined LinFBB to listen on port 6300 (hex = 189C) for incoming Telnet connections, then you type: telnet sm6tky.ampr.org 6300 X-Windows version of LinFBB: Select the "Window" in menu, and then select "Console" to enter Console connection. Next you must define all the BBSs you want to forward to. You do this with the command EU. If you want to have forward to for example LA2D, you type EU LA2D. The BBS will say that this callsign is not known, and ask if you want to create it. You answer Y. Next you will see a line of different options for that user. You only have to type B. Now that callsign (LA2D) will be defined as a BBS. You must press ENTER once more to stop editing the user. Repeat this procedure with the callsigns of all the BBSs that you will forward to. 18
You terminate the BBS keyboard-session with the command B (Bye). Well, if all is ok, and you have not encountered any big problems so far, you can stop the BBS. In DosFBB you do this with Alt-F10 or Alt-x. In WinFBB you do this by pressing Alt-F4). In LinFBB you do this: Daemon version: Do 'ps ax', check for 'xfbbd' look after the process number and do 'kill ' On the newer versions use the command /A at the PBBS prompt to stop it. X-Windows version: Select "File" in menu, and then select "Exit" to shutdown the BBS. You can connect the TNCs, and in INIT.SRV you must change from NO to OK in the line that asks 'Mode test ?', or in WinFBB: Click on the WinFBB Configuration icon in LinFBB: Use INSTALL.SH in DosFBB: Use FBBSETUP to change the field "TEST MODE" to "NO". The TNC This software will work with different kinds of TNCs or TNC-interfaces: - TNC-2 or close clones. The EPROM of type 27256 must be replaced by a special EPROM with the WA8DED host-mode software, or by the German TF4, TF8, TF18 or similar. - PK-232 in host-mode. - Kantronics KAM in host-mode. You need a special driver called ESSKAM. - DRSI-card. - G8BPQ-node (uses TNCs in KISS-mode). The software for the TNC-2 host-mode EPROMs TF4 and TF8, may be included on the distribution-disks. If you cannot burn new EPROMs yourself, there are a lot of hams around who can. You can also send a new EPROM to F6FBB or FC1GHV (with return-postage and packing material, of course) and they will do the work for you. The TNC should work on 4.9 MHz. The standard is 2.5 MHz, but a modification for this is normally quite simple. In some cases it might be necessary to replace the Z80 and the Z80 SIO by A-versions. If you use standard TNC-2 with one of the mentioned host-EPROMs, you can start again now, and all should work fine. Make sure that the TNCs have the same baud-rate as you wrote in PORT.SYS, and that they really are connected to the COM-ports that you said in PORT.SYS. If you do NOT use a standard TNC-2 with DED-type host, but PK-232, BPQ, Kantronics KAM or DRSI-card, you must read about your special TNC-setup in one (or more) of the chapters PK-232, 19
BPQ, KAM, DRSI or TFPCX/TFPCR before you can start the BBS again. If the TNCs don't work ok with the software, you will see this when you start the BBS. You will have a lot of error-messages on the screen, and the TNCs may start to resync. Stop the program and go through all the setup once more. For WinFBB: You may need to check the port-speed in Windows, make sure it is the same for the port, as you have set the TNC and PORT.SYS to. 4.1 RUNFBB.BAT (only for WinFBB) RUNFBB.BAT (\FBB\BIN) This is the very first file that WinFBB will use. You will find it in \FBB\BIN-directory. You don't really need to do any changes in this file, unless you did some changes during the installationprocess. If you did, you must change the pathnames in RUNFBB.BAT exactly the same as you did during the installation. This is very important ! So look for the lines that I have marked with an satupdat.res del amsat.txt 20
:amsatend echo Backup of important files copy %fbb%\system\dirmes.sys %fbb%\backup\dirmes.s1 %FBB%\MAIL.IN > %FBB%\ERROR.LOG PA (days after changed to K) 0 # # parameters FOR BULLETINS # # BN -> BX (days after the message is written) 7 # # B$ -> BX (days after the message is written) 62
7 # # BY -> BX (days after changed to Y) 7 # # BX -> BK (days after changed to X) 14 # # BF -> BX (days after message is written) 14 # # BK -> BA (days after changed to K) 0 # # # Automatic generated return-messages for non-forwarded messages. # Each line may be max 255 characters long. Disable with only an 0. # # Timeout for valid forward-path (number of days + text, end with $W) 21 This message could not be forwarded, due to bad link.$W # # Unknown routing or wrong H-address (number of days + text, end with $W) 2 This message could not be forwarded, due to bad callsign or bad route.$W # # Max number of lines in a returned message: 10 # -----# # At the end of the file, you can have special lifetimes for special messages. # In the example below, messages that are TO LA6CU will be 365 days old, # messages FROM system will be 0 days, messages @LA will be 365 days. I have an # # in front of them, this means they are disabled right now. # List of lifetime-tests # # To/from/via Callsign Days @ VEST 365 @ LA 365 > LA6CU 365 < system 0 # # End of this file. # 4.11 SWAPP.SYS SWAPP.SYS (\FBB\SYSTEM) This file will reside in SYSTEM-directory. This file is used for automatically re-route messages. 63
This file normally changes the @BBS-address, but can also change the TO-field. You might not need so many callsigns etc. here, but you should make one line with only your callsign after the @. In that case the @BBS will be removed from messages to users in your own BBS. For the first tries, it is enough to have one line starting with @, and then your BBS-callsign. You can fill in the rest later. ########################## # SWAPP.SYS for FBB 7.00 # # for LA6CU by LA6CU # ########################## # # File SWAPP.SYS is used to change @BBS-addresses, TO-addresses etc # > changes TO-callsign # < changes FROM-callsign # @ changes @BBS # Combinations also allowed, like > LA8AK @ OZ2PAC. # # Other possibilities (recommended) is to delete own @BBS. # That is done by putting own BBS-call in first column. # # Swapping may use hierarchy. For instance: # @ F6FBB.FRA.EU @ F6FBB.FMLR.FRA.EU # Only the first full address will be swapped to the other # @ F6FBB @ F6FBB.FMLR.FRA.EU # All F6FBB addresses will be swapped to the other # @ LA8AK LA9K @ LA5IV LA9K @ LA6XXX @ HF EU @ WWW WW @ HFNET WW @ LA9WO LA9H @ TEST 4.12 INIT.SRV INIT.SRV (\FBB) First, be aware of this useful feature: If INIT.SRV does not exist, FBB looks for: INIT_D.SYS (for DosFBB) INIT_W.SYS (for WinFBB) INIT_L.SYS (For LinFBB) So it is possible to have for example DosFBB and WinFBB files in the PC at the same time, even if they need different INIT-files. This is useful at sites where you want to change from WinFBB to DosFBB from time to time. 64
This file is the next file that FBB looks into during startup. This file will be found in the main FBB-directory. All basic data is collected from this file. Use your standard -editor to edit the following lines: (all lines starting with # are comments) In WinFBB, INIT.SRV is created or updated with a small program called INSTWFBB.COM. This program may also be run inside WinFBB, when WinFBB is running, by clicking on Config at the top of the screen. In LinFBB, INIT.SRV is created or updated with a small program called INSTALL.SH. In DosFBB, INIT.SRV is created or updated with a small program called FBBSETUP.EXE. This program is organized as pages of menus, and you can edit or change any topic in your configuration. It is no longer necessary to edit the INIT.SRV file manually. The version of the software is now indicated in the first comment line. This will allow further automatic updates. # FBB7.00 # # Callsign and H-address (Do not include SSID !) LA1B.#BRG.NOR.EU # # SSID for the BBS 0 # # Qra locator JP20RH # # Qth (variable $c) Bergen # In the above lines you must replace the callsign and H-address with your own BBS-call and Haddress. You also must replace the SSID, that is the number after the callsign. In LA1B-6, the 6 is the SSID. If you do not want any SSID, type 0 here. You also must replace the QRA-locator with your own locator (ask some other ham for help on this, if you don't know the BBSs QRA-locator. Do NOT use the value from this example-file! You also must replace the QTH (don't make it too long...). If the QTH-name is short, you might add the QRA-locator here too, like I have done. Next we have some filenames and path-names. These filenames and paths are the same as used in the installation-procedure. If you did no changes in this during installation, you will not need to change any of these now. Note the syntax, and note that directory-names MUST end with a \ # Directory for files used by the BBS C:\fbb\system\ # # Directory for messages 65
C:\fbb\MAIL\ # # Directory for binary-messages C:\FBB\BINMAIL\ # # Directory for users DOS # Up to 8 drives may be specified, starting with drive A: # In this example drive A and B are not used, and therefore replaced by a * each. # *,*,C:\fbb\users\,*,*,*,*,* # # Directory for Yapp-files C:\fbb\users\yapp\ # # Directory for DOCS C:\FBB\DOCS\ # That was not so difficult ? Next, check the first-name of Sysop, and the callsign of Sysop. Here are MINE : # First-name of Sysop Per # # Sysops callsign LA6CU # In the following line you CAN (not necessary) replace the ***** with a callsign. If you do, that callsign will receive a copy of all Sysop-messages that arrives. You might want to put your own callsign there. You may also include more than one callsign, separated by space. # Callsign (and route if needed) that shall have copy of messages addressed to Sysop # (*** for no copy,
[email protected] if route) ***** # No need to change this: # Path and filename for import-file \FBB\MAIL.in # Here you must first write the code for the kind of monitor you use, and then you must have a number for how many minutes you want before the screen should go blank, after no activity on the keyboard. In this example I have a CGA-monitor, and my screen will go blank after 5 minutes since I last touched the keyboard. # Type video:0=CGA, 1=EGA, 2=VGA Time before screen-blank. 66
# 05 # Complete log gives you a log-file for every week. If you write NO here, no log-file will be made. The log-file will appear in the directory named LOG. Direct video uses fast BIOS-calls if you answer OK. If you plan to use Desqview or Windows (with DosFBB, that is..), you must change it to NO. Indication of channels will normally be OK (that means that monitored information on screen will be more complete, with callsign of user before every frame from each user, etc). # Complete log (OK or NO) OK # # Direct video (OK or NO) OK # # Indication of channels OK # Next we have Test Mode (NO - OK). If you type OK, the BBS will start, but will not access the TNC(s). Use this the first times, to make sure that everything works fine. When you are sure that all is well, connect the TNC(s) and change this to NO. Restart the FBB, and now the TNCs will be used, as normal. # Test-Mode (NO - OK) and WinFBB ONLY: watchdog: 1->9 = COM1->COM9 or # 81->84 = LPT1->LPT4. OK 81 # Forward type FBB is faster and more efficient than standard MBL-type forward. Use this whenever possible (OK). If you type NO, FBB-type forward will not be allowed. You may also use a parameter after OK/YES from this list (add the ones you want): 1 2 4 8 16 32 64 128 256 512 1024 2048 4096
: A space is mandatory before the @ in a send message command : The length of the fields of a hierarchical address is not tested to be 6 characters : The header line of a message is not truncated to the space before the 79th character : Header MBL/RLI : If there is no BBS field, the callsign of the BBS is sent to the PMS : Deletes the DATA messages sent to Sysop : Don't use the BID recovered from headers and use a new one : Accepts forwarding only from pre-declared BBS : WP Messages are not held. : XForwarding protocol has priority on FBB protocol. : Generation of an alternate BID like F6FBB-12345 (for dual BBS site) : Checksum unvalidated on XFwd. : Test of callsigns is less strict. Allows all "callsign" as long as they have one figure (0-9) anywhere in the callsign.
# Use (when possible) forward type FBB 67
OK # (or, you may include a number, like: OK 2048 or whatever..) The same goes for compressed forward. Compressed forward is very much faster, and should always be used. Parameter after "use compressed forwarding" give the options between compressed protocols: 1 = FBB compressed forwarding 2 = XFWD compressed forwarding “OK 3” allow both FBB and XFWD. # Use (when possible) compressed forward OK 3 # Hroute update validation. If you type OK, the HROUTE look-up will be validated. This takes some tens KB of memory. A route without hierarchical extension will be changed to hierarchical route if found in the HROUTE.SYS database. This database is automatically updated while receiving headers. # HROUTE look-up and database update validation OK # Information query. This ensures that the user will give his information. This will be helpful for the update of the white pages database. If "OK", the user will prompted until he answers to the queries. # User MUST give Name, HomeBBS, QTH and ZIPcode OK # Next we have 'Mask'. This is a default value that is given to all new users when they log on the BBS for the FIRST TIME. Select the things you want for all new users, and the values for them. If you for example want all new users to get Paging, and be in Guest mode, add 32 and 64, and put the result 96 in the file. If you want none of the things listed here, put in a 0. The "see-all-mail" mask will be active only if the user has the "read-all-messages" security code (see behind). # First connection mask. # 0 : disable mask. # 1 : Excluded. # 2 : Local. # 4 : Expert. # 8 : Sysop. # 16 : BBS. # 32 : Pagination on # 64 : Guest. # 128 : Modem. # 256 : List/read all personal messages 68
# 512 : Request for unproto beacon-lists allowed # 1024: Get list of new messages at each connect # Add up the values for your choices. 1568 # Next we have 'Security-codes'. Here we give 3 values. The first says what ALL users are allowed to do. The next says what Sysops are allowed to do when they connect the BBS, and the third says what a Sysop is allowed to do after he has successfully performed the SYS-command. The same applies here as above; choose the values you want and add them up. # Security-codes. # All users can: # 1 : Read all messages, including all personal messages. # 2 : Kill all messages. # 4 : Send SYS-command. # 8 : Use remote-Sysop commands (edit, forward etc). # 16 : Edit labels in YAPP, FBBDOS, DOC. # 32 : Can delete files in YAPP and FBBDOS. # 64 : Have access to all gateways. # 128 : Run dos-programs (command DOS in FBBDOS). # 256 : Have access to the entire hard-disk. # 512 : Have access to command /A (stop BBS) and /R (reboot PC). # # All: Sysop: Sysop after successful SYS-command: 0 127 1023 # Next we have warning-messages to Sysop (mask): #1 #2 #4 #8 # 16 # 32 # 64 # 128 # 256 # 512 1023
: Less than 1MB in disk : Error in system file (FORWARD, BBS, REJECT...) : Server error/warning : Ping-Pong warning : No-route warning : No NTS warning : Message file not found : Error in proposal : Message rejected in remote BBS : Message held in remote BBS
Next we have the time for cleanup of messages. This should be done in a low-traffic hour, as the BBS is completely shut down during cleanup. Type also the timeout-values you want, the default values here should be OK. Put also in the number of hours (+ or -) between the PCs local-time and UTC. # Time (hour) for cleanup of messages # (Forced disconnection of all links at housekeeping time+15 min.) 02 69
# # Time-out for normal use (minutes) and during forward (minutes) 15 5 # Max download-size (per period) for Yapp and via modem, in kbytes. 0 0 will disable it # 100 500 # # Hours +/- in relation to UTC 0 # Type how many callsigns you want (maximum) in each mail-beacon (variable $Q). If you precede the number by a B, also bulletins to local users (type BN or BY) will be broadcast in the mailbeacon. Like this: # Number of callsigns in mail-beacon B20 # Number of lines in scroll-buffer may be changed. Just remember that they use a lot of memory (each line takes 160 bytes of memory, but can be in high memory), so I advice you to use these values: # Number of lines in scroll-buffer # User Console Monitoring 1000 1000 1000 # Leave this one alone: # Text for forward-header (variables OK), appears LAST in the R:line. # Please do not change the contents and the order of the fields except the FBB$E field which is # only an information and can be removed. # $c is the QTH as declared before in this file. [$c] FBB$E $$:$R # Next you must decide how many BIDs to keep. For WinFBB and LinFBB: Normally you will have enough memory. So you may use the max. However, I found 10000 to be a good value. For DosFBB: Depending on how much memory you have. 3000 is a good value, but 10000 is better (hi). # How many BIDs are saved (32000 max) 3000 # 70
Leave the next one alone. This one means that bulletins that are older than (in this case) 30 days, will not be forwarded again from my BBS, and will go directly to X-status. Be aware: a too low value here will cause problems for other BBSs that you forward to.. # Lifetime for bulletins. Number of days from message is written 30 # You should answer 1 for memory-cache, followed by the list of topics you want to load into memory. The BBS will do these operations very much faster. # # Use memory-cache ? 0=No, 1=Yes (preferred). # and optional list of topics to put in memory-cache # # Topics : BID = Bulletins or messages identifiers # MSG = Message lists # HIE = Hierarchical information # SCR = Screen buffers # WPG = White Pages database # REJ = Reject/hold information # FWD = Forwarding information # 1 BID MSG WPG HIE SCR REJ FWD # List of routes to send WP update messages. First, keep this line blank until you have a WP network available, then give the route(s) to send your updates. # List of routes to send WP messages # LA1B LA6CU # Zip code of the BBS. Give the post code area where is the BBS. Mandatory. # ZipCode of the BBS # 31120 # Here you will give the parameters allowing the list of messages in unproto mode. This list can be interpreted by some terminal softwares (as TPK) and greatly reduce the traffic on the local frequency. The first parameter is the maximum backward number. If a unproto user asks a list which is lower than this number backward, he will be limited to this parameter (IE: if the current message number is 20000 and a user asks the list of the message 15000, he will be then limited to the 19500 if the backward number is 500). The second parameter is the speed of the unproto updates given in seconds. The frames will be sent with this period. The third parameter(s) have this meaning: 71
A = ACK messages V = transit private messages P = end-user private mail M = subject is replaced by stars in private mail (Bulletins are always displayed) Any unauthorized message will be unproto like 12345 # # 500 5 VPA # Leave this lines alone, unless you are absolutely sure you want to change it: # DRSI and TFPC interrupt (Hexadecimal, default FF and FE) [since DosFBB V7.00c2] FF FE Then you have two optional programs of batches which are called at the end of the initialization, and just before shutdown. If you don't need them, keep these lines empty. # # BBS-UP program (default empty) # # BBS-DW program (default empty) # You can change these colors if you like: # Color on texts: # # Black # Blue # Green # Cyan # Red # Magenta # Brown # Light grey # # # COLOR FONDS # # Status (top) 1 # Bandeau (middle) 7 # Text (bottom) 0 # Menus 4
:0 :1 :2 :3 :4 :5 :6 :7
Dark grey Light blue Light green Light cyan Light red Light magenta Yellow White
:8 :9 : 10 : 11 : 12 : 13 : 14 : 15
72
# # Color of characters # # Status (top) 7 # Bandeau (middle) 1 # Menus 14 # Text sent 10 # Text received 12 # UI (Headers) 15 # UI (traffic) 7 # Console 14 # Beacon 6 # Channel-marking 11 # You may change these lines if you like. These are the servers that are normally available in most FBB-BBSs, and they are automatically installed for you from the diskettes. So you can leave them alone. Or you can disable them with a # in front of each of these lines. Two built-in servers already exist, but you MUST declare them in this file to make them available. As they are built-in, the program-name MUST be replaced with stars. ----------# List of "servers" : # # To Program-name Description # REQCFG ****** Request configuration WP ****** WP server REQDIR REQDIR Request directory-listings from other BBSs. REQFIL REQFIL Request files from other BBSs. NEWDOC NEWDOC Upgrade files under DOCS. --------# # End of file # Ok. That was the INIT.SRV file. This file is VERY important, so check and double-check to make sure that you have it all OK. The best way to check it, is by using INSTWFBB for WinFBB, INSTALL.SH for LinFBB or FBBSETUP for DosFBB. 73
4.13 CRON.SYS First, be aware of this useful feature: If CRON.SYS does not exist, FBB looks for CRON_D.SYS (for DosFBB) CRON_W.SYS (for WinFBB) CRON_L.SYS (For LinFBB) So it is possible to have for example DosFBB and WinFBB files in the PC at the same time, even if they need different CRON-files. This is useful at sites where you want to change from WinFBB to DosFBB from time to time. This file is in the SYSTEM directory. The BBS looks in this file once every hour. If the hour and date is right, the BBS will execute the commands in this file. DOS-programs are run with X or D command, like X DOTHIS.EXE or D DOTHAT.EXE. When running BAT files, a COMMAND.COM is automatically first sent. That needs some more memory. Minute/Period option in the "M" command line: M port U 10/20 : Port nb is changed to USER mode and min/per to 10/20 CRON.SYS also accepts the literal port definitions of PORT.SYS. Ex: M Pactor U 10/20 In DosFBB the the screen is saved with D-command, and reappears after the program has terminated. With X the program will not write to the screen. # # File CRON.SYS. Here DOS-commands can be executed to fixed hours, # also Gateway, Yapp, Bip and Talk can be turned on or off. # Format: TALK YES (NO), BIP YES (NO), GATE 1 YES (NO), YAPP 2 YES (NO). # [As of 7.04i] to activate “all” ports you must setup the value 0 instead of 9 (GATE 0 or YAPP 0) # [As of 7.04g] changed 'FW 9' to 'FW 0' to start forward on all ports. # DOS-program is run like in FORWARD.SYS with D or X command. # # Minute/Period option in the "P" command line: # P port U 10/20 : Port nb is changed to USER mode and min/per to 10/20 # # Change mode on a port: M nb U : Port number nb is changed to USER mode. # M nb B : Port number nb is changed to BBS mode. # M nb G : Port number nb is changed to GUEST mode. # # As in FORWARD.SYS, you can use H for hour and D for day. # 0=sunday, 1=monday, … 6=saturday. # Also IF-ENDIF and IF-ELSE-ENDIF is allowed # # Possible formats for time: # IF H 0-9 All hours between 00 and 09. # IF H 0,9 Only at 00 and 09. # IF H 0,9-11 At 00, and all other hours between 09 and 11. 74
# IF G (same as IF H, but in UTC time) # IF D 0-2 Sunday, Monday Tuesday. # TALK NO BIP NO GATE 1 YES GATE 2 YES YAPP 1 YES YAPP 2 YES IF D 1-5 IF H 15-23 GATE 3 YES YAPP 3 YES ELSE GATE 3 NO YAPP 3 NO ENDIF ELSE IF H 8-23 GATE 3 YES YAPP 3 YES ELSE GATE 3 NO YAPP 3 NO ENDIF ENDIF X DOTHIS ARG1 ARG2 ARG3 D DOTHAT ARG1 ARG2 4.14 REJECT.SYS REJECT.SYS (\FBB\SYSTEM) This file is in SYSTEM-directory. With this file it is possible to reject or hold certain types or sizes of messages. The first letter of each valid line specifies the action: R = Reject H = Hold L = Local Hold
The message will not be received. The message will be received but held until the Sysop reviews. Only messages created on this BBS will be held.
# File for rejecting messages. They are rejected with N-BID: # # Type, from, @BBS, to, BID, maximum size: # # * and ? can be used as wildcards (as in MS-DOS) # R B TOTO ALL TATA * 0 75
RB RB H* LB
* * VENTE * VENTE * P1RAT * * * * *
* * * *
0 0 0 0
4.15 PROTECT.SYS PROTECT.SYS (\FBB\SYSTEM) First, be aware of this useful feature: If PROTECT.SYS does not exist, FBB looks for PROT_D.SYS PROT_W.SYS PROT_L.SYS
(for DosFBB) (for WinFBB) (For LinFBB)
So it is possible to have for example DosFBB and WinFBB files in the PC at the same time, even if they need different PROTECT-files. This is useful at sites where you want to change from WinFBB to DosFBB from time to time. This file is in the SYSTEM directory. In this file you can specify some directories in which you do NOT want any Sysop to be able to delete any files, without a special syntax. To delete files in protected directories, the command must look like this: DEL +FORWARD.SYS In an unprotected directory the command looks like this: DEL FORWARD.SYS So you can see that you need an extra '+' sign in protected directories. Example of PROTECT.SYS: \ \FBB \TOOLS 4.16 LANGUE.SYS LANGUE.SYS (\FBB\SYSTEM) This file is in the SYSTEM-directory. You do not need to change this file for the first startups. First there are 3 numbers. The text in the file explains how to use them. Next there is a list of all available languages. These names must be the same names as used in the .TXT and .HLP files in the directory called LANG. So, there must be an ENGLISH.TXT and ENGLISH.HLP there, if ENGLISH is in LANGUE.SYS file. After some comment-lines, there is a long list of prefixes, and the corresponding number of language that each user will be presented with for his first connect. The user himself, can change language later with OL-command in the BBS. Remember, only the "Number in PC at the time" decides how much memory the languages will 76
use. All languages will be available anyway, but if more then (in this case) 4 are in use at the same time, the BBS will swap the less used language to disk, and load a new one from disk. # # File that decides what language each user will use in the first # connect. He can change language himself later... # All prefixes not listed here, will receive language nr. 1 (English). # 3 parameters : # How many languages - How many in PC at the time - Console-language. # 17 4 1 # ENGLISH NORSK NORSK8 FRANCAIS SVENSKA SVENSKA8 DANSK DANSK8 SUOMI PORTUGUE ITALIANO DEUTSCH CATALA ESPAGNOL NEDERLAN RUSSE HRVATSKI # # 1 : English # 2 : Norwegian (7-bits) # 3 : Norwegian 8-bit # 4 : French # 5 : Swedish (7-bits) # 6 : Swedish 8-bit # 7 : Danish # 8 : Danish 8-bit # 9 : Finnish # 10: Portuguese # 11: Italian # 12: German # 13: Catalan # 14: Spanish # 15: Dutch # 16: Russian # 17: Croatian # CT* 10 CU* 10 77
C3* DU* D* EI* E* F* 9A*
13 1 12 1 14 4 17
etc. etc. 4.17 THEMES.SYS THEMES.SYS (\FBB\SYSTEM) The file THEMES.SYS is configures the theme-zone. The first word in each line is the "theme". The rest of the words on the same line, are the to-fields of messages that will fit in the theme. Empty line (like the TRASH), covers all the remaining to-fields. TRASH COMPUTER SOFTWA COMMERCE SATELLITE RESEAU DX IMAGES TECHNIQUE TRX ATV GAMES SCOUTS DIGEST BBS TPK ASSOCATION EDUCATION
IBM APPLE MAC AMIGA C64 OS2 MSDOS TRUCS UNIX LINUX ACHAT* VENTE* ECH* RECHER AMSAT SAT* UO22 KO23 UOSAT PACSAT DOVE KEP* SPACE FPAC* FLEX* RMNC THENET *DX* VHF UHF HF SHF QSL* EME CONTES PROPAG DIPLOM SUN JPG JPEG GIF IMAG* *FAX* SSTV 9600 MODEM TECHNI YAESU ICOM KENWOO ALINCO PYE KENW ATV SATTV JEUX GAMES SCOUT* *DIG FBB RLI REBBS MSYS TCPIP CLUS TPK REF URC ARRL DARC RASEC EDUC ECOLE SCHOOL
As of V7.04h (Dec 15, 2001) enhanced capabilities in the themes.sys file. This file is up-compatible with previous versions. Added parentheses and !, &, |, @ operators: & means "expression and expression" | means "expression or expression" (optional for up compatibility) ! means "not expression" @ means "via field" fra.achat ACHAT* & @FRA fra.vente VENTE* & @FRA 78
fra.echange cherche fra.satellite ww.satellite
ECH* & @FRA SEARCH CHERC* RECHER @FRA & (AMSAT | SAT* | UO22 | KO23 | UOSAT | PACSAT | DOVE | KEP* | SPACE | PHASE3 | ISS | PCSAT | NASA) @WW & (AMSAT | SAT* | UO22 | KO23 | UOSAT | PACSAT | DOVE | KEP* | SPACE | PHASE3 | ISS | PCSAT | NASA)
4.18 REDIST.SYS REDIST.SYS (\FBB\SYSTEM) REDIST is a built-in server for resending personal messages as bulletins. May be used for sending a bulletin in another area than the users own area. # # Configuration of the REDIST server # # Route for the local BBS (SP LOCBBS) LOCBBS=LA1B # Name of the BBS coverage LOCBBS_DESC=LA1B BBS # #Route(s) for local bulletins (SP LOCAL) LOCAL=LA6CU,LA1B # Coverage of the local BBS LOCAL_DESC=Bergen, LA1B and LA6CU BBSs # # Route(s) for regional bulletins (SP REGION) REGION=VEST # Name of the region REGION_DESC=Hordaland, Rogaland (Western Norway) # # Route(s) for national bulletins (SP NATION) NATION=NOR # Name of the country NATION_DESC=Norway # # Default destination DEFAULT_TO=ALLE # # Send a mail to the Sysop MAIL_Sysop=YES #
79
4.19 MEMO.SYS MEMO.SYS (\FBB\SYSTEM) This file was designed for DosFBB and works fine there. See comments on use with WinFBB at the end of this file. This file will substitute a text when pressing CtrL-F1 to Ctrl-F10. This text can hold variables and is limited to 255 characters. It can include $W variable (CR) and then will be formatted as more than one line. This file will have 10 lines, the first line corresponding to Ctrl-F1, and the last one to Ctrl-F10. If a line is not used, it must have a dot in first column. Example of MEMO.SYS file : $W$O BBS (FBB$E) in $c ($?).$W . . . . . . . $W Vy 73. Jean-Paul, F6FBB @ F6FBB.FMLR.FRA.EU$W$W/EX$W $W 73 Qro. Jean-Paul,
[email protected]$W$W/EX$W In WinFBB this does not work the same. It works only in the editor, and only Ctrl-F2, Ctrl-F3, Ctrl-F5 to Ctrl-F9 works. The rest are captured by Windows itself. 4.20 PK-232 HOST MODE If you plan to use a PK-232 with this software, you must make some changes. First, check again PORT.SYS. You must have a P in "Type host mode". For example: # #TNC NbCh Com MultCh Pacln Maxfr NbFwd MxBloc M/P-Fwd Mode Freq 1 7 1 1 230 4 1 10 30/60 UPYW 433.650 2 1 3 1 80 2 1 5 17/30 GPW 15/20m # Example of INITTNCx.SYS for PK-232: UNMAIL v LA7QR means Unproto MAIL v LA7QR RY10 " Retry 10 MN6 " Monitor 6 MC6 " Mcon 6
80
Example of MAINTx.SYS for PK-232: UR1 CTBBS ($c) was shut down for service $d $T. PK-232 host-mode commands (from F6AIW) :
4.21 G8BPQ driver G8BPQ-node (uses TNCs in KISS-mode, DRSI cards, etc...). If you plan to use BPQ-node with this software, you must make some changes. Before you start FBB, you must load the BPQ-program. From version 4.05 of BPQcode, separate ports can be declared. Level 2 connections issue to the MultCh in the same order as PORTs declared in the BPQCFG.TXT (G8BPQ distribution) file. First port corresponds to MultCh 0. Level 4 connections (from the network) always issue to MultCh 0. 81
In PORT.SYS you must use 2 in INTERFACE, and Q in type host mode. Version 4.05 or up is recommended. COM can be from 1 to 8, but will exclude existing COMs. Choosing 8 is a good solution to keep existing COMs. We recommend that you use COM 8. Only the INITTNCx.SYS for the 1st port must exist. You must check that there is only one INITTNCx.SYS file for all BPQ-ports, otherwise you will have big problems! The parameters for other ports will be taken by default, and then no conflict should happen between ports. If you want to define the streams differently on each port, you can do it with the INITTNCx.SYS file, but be sure to give the right configuration. INITTNCx.SYS will look like this: A1 R0 UMAIL M1 N1 If paclen is equal to 0, then the default BPQ paclen of the port will be taken, otherwise the specified paclen will overwrite the default BPQ paclen. If you have validated the gateway, you must configure ENABLE_LINKED=A in BPQCFG.TXT to give to the stream the callsign of the user. In BPQCFG.TXT you will require to set the TNCPORT section up for COM 8. As follows:TNCPORT COM=8 ENDPORT Here is an example of PORT.SYS with BPQ-node and 2 TNCs: # #Ports TNCs 1 2 # # #Com Interface Address (Hex) Baud 8 2 0 4800 # # #TNC NbCh Com MultCh Pacl Maxfr NbFwd MxBloc M/P-Fwd Mode Freq 1 8 8 0 230 4 1 10 30/60 UQYW VHF 2 1 8 1 80 1 1 5 30/60 UQYW HF # Example of INITTNCx.SYS for BPQ 4.05 (Only ONE INITTNCx.SYS): A1
Number of application 82
R0 Returns to node (0=No,1=Yes) UMAIL Unproto MAIL M1 Monitor (0=No,1=YES) N1 Number of first stream The parameters for other ports will be taken by default, For instance, as the first stream of the first port is 1, the first stream of the second port will be 9. (8 channels defined in PORT.SYS for port 1). This will be done automatically, and the second INITTNCx.SYS should not exist. In FORWARD.SYS there are a few changes, here is a short example: A LA2D # PB # C C SWITCH C C 2 LA2D # B LA2D F LA2D # ---------
Connect first BPQ switch. Connect LA2D on port 2 of BPQ.
For WinFBB If you are using WinFBB together with BPQ-code you have to copy the files BPQCODE.386 BPQDLL.DLL to the \WINDOWS\SYSTEM directory. These files are normally included in the BPQ program package. After this you starts BPQ in the same way as with DOSFBB, but before starting WINDOWS. The best is to start BPQCODE from AUTOEXEC.BAT. For LinFBB BPQ cannot be used with LinFBB... 4.22 Kantronics KAM in host-mode If you plan to use a KAM with this software, you must make some changes. For WinFBB: Use interface 6 in PORT.SYS. For DosFBB: Before you start the BBS, you must load the RS232 driver. You must use ESSKAM or ESS (ESS must be version 1.10 or higher). Do not use another driver such as COMBIOS or MBBIOS. Run it like this: 83
ESSKAM 1 ESSKAM 1 03F8 4
(Com1, Address and IRQ = defaults) (Com1, Address=03F8Hex, IRQ4)
The KAM must be in the right baudrate, and in Hostmode. You put it into Hostmode with these commands: INTF HOST PERM There is a special format for INITTNCx.SYS. For HF, use this: UNPROTO MAIL/ MONITOR ON/ MCOM ON/ MCON ON/ MRESP ON/ PID ON/ RETRY 15/ RESPTIM 0/ FRACK 2/ CHECK 30/ HID OFF/ For VHF use this: UNPROTO /MAIL MONITOR /ON MCOM /OFF MCON /ON MRESP /ON PID /ON RETRY /8 CHECK /30 HID /OFF As you can see, the position of the "/" is very important for HF/VHF ! In PORT.SYS you must use 1 for VHF and 2 for HF in MultCh. You must also use K in "Type host-mode". # # Same number of lines as number of TNCs. # #TNC NbCh Com MultCh Pacl Maxfr NbFwd MxBloc M/P-Fwd Mode Freq 1 4 1 1 230 4 1 10 30/60 UKYW 144.675 2 1 1 2 80 1 1 6 15/60 UKYW HF #
84
4.23 DRSI-card If you plan to use DRSI-card with this software, you must make some changes. Before you start FBB, you must load the DRSI-driver that comes with the DRSI-card. This must be TNCTSR-R or TNCTSR-L with a version-number higher or equal to 2.1. The first DRSI-card (MultCh 0 and 1) must be at address 300. The second DRSI-card (MultCh 2 and 3) must be at address 310. The third DRSI-card (MultCh 4 and 5) must be at address 308. The fourth DRSI-card (MultCh 6 and 7) must be at address 318. Before installing cards in the PC, use the program CHKADDR to verify that the addresses corresponding to the cards have a value of FF. If there is a problem, check your configuration to find what peripheral is already using this address. Install just one card at the time, and verify each cards presence with CHKADDR. When all cards are ok, configure the driver by means of the TAILORnn program (depending of the version). TNCTSR-S will be ok if you use only a few channels, while TNCTSR-L should be used for big configurations, up to 32 channels. One problem: What DRSI calls DRSI-PORT, is what we call MultCh in FBB ! What DRSI calls PORT, is what FBB calls port or TNC ! We always use FBB-names here... Each DRSI-card works like 2 radio-ports. The first DRSI-card is always MultCh 0 and 1, and the forth card is MultCh 6 and 7. If one radio-port is used on HF, that port must be the second port on the card. All the DRSI-cards together, work like only one COM. And this COM-port does not need to exist in the PC. You may call that port COM 7 or COM 8 and keep free the already existing COMS. Baud-rate does not matter, but should be set to a standard value, to avoid error-messages. Here is an example of PORT.SYS with 2 DRSI-cards (4 radios): # #Ports TNCs 1 4 # # #Com Interface Address (Hex) Baud 7 4 0 4800 # # #TNC NbCh Com MultCh Pacl Maxfr NbFwd MxBloc M/P-Fwd Mode Freq 1 8 7 0 230 4 1 10 30/60 UDYW 433.650 2 1 7 1 80 2 1 5 12/30 GDW 15/20m 3 8 7 2 230 4 1 10 36/60 UDYW 433.650 4 8 7 3 230 4 1 5 10/30 GDW 145.300 85
# If you are using DRSI-card, you also must change the INITTNC1.SYS. You will need only ONE file for all the ports. Example of INITTNC1.SYS that initializes 4 ports: MUIS U0 p0 1 64 10 4 4 10 100 18000 30 2 0 p1 1 64 10 4 1 16 100 18000 30 1 0 p2 1 64 10 4 4 10 100 18000 30 2 0 p3 1 64 10 4 4 10 100 18000 30 2 0 The same goes for MAINT1.SYS, only 1 file is needed for all 4 ports, like this: Y1 U 1 BBS ($c) was shut down for service $d $T. In FORWARD.SYS there is no changes. Use standard syntax. Well, I think that should be all (for DRSI). Oh, bye the way: DRSI cannot limit the number of connections per radio-port. But in FBB we still can have NbCh set to for example 1. When a station then connects to the BBS on that radio-port, and there already is one user connected there, the BBS will send a message to him: "Sorry, no more channels available" and disconnect him. 4.24 TFPCX / TFPCR / TFKISS (Hostmode KISS-driver) TFPCX / TFPCR / TFKISS (Hostmode KISS-driver) It is possible to link FBB to a TheNetNode or similar systems running on a separate PC with a simple 0-modem cable. For this TF-KISS, TFPCR or TFPCX can be used as com-driver, and the link must be defined as a KISSLINK in the node system. Another possibility is to use the driver with tnc's in kiss-mode etc. The only restriction is that Baycom modem do not work, but SCC cards do work. It must be called with the same interrupt as stated in INIT.SRV as TFPC-interrupt, or 0xFD by default (if the INIT.SRV does not specify it). It can be used with DosFBB or WinFBB running under WIN3.xx or WIN95. IMPORTAN : TFPCX, TFPCR or TFKISS always must be called before starting WINDOWS and/or FBB. Better add the call into your AUTOEXEC.BAT with a line like this (example using TFKISS): TFKISS -I:FD -B:9600 Comport 1 is default, but other ports as well as other parameters can be specified (look in your manual). Place the driver itself in your \FBB\BIN directory. 86
In PORT.SYS you must use 5 in INTERFACE, and D in type host mode. The interface behaves in many ways as WA8DED Hostmode. If you intend to use higher speed than 9600 baud you must use UART 16550 in your serial ports and PCs not slower than 386 40 MHz. Otherwise you probably will get errors during binary transfer or forward. Example of PORT.SYS: # FBB7.00 # #Ports TNCs 1 1 # #Com Interface Address (device) Baud 1 5 3F8 9600 # #TNC NbCh Com MultCh Pacln Maxfr NbFwd MxBloc M/P-Fwd Mode Freq 0 0 0 0 0 0 0 0 00/01 ----- File-fwd. 1 10 1 1 236 7 4 30 00/15 UDLY VHF/UHF/SHF # #TNC Nbs Callsign-SSID Mode #1 1 LA1B-1 B # # End of file. # Example of INITTNC1.SYS: I OZ7BOX M IUS @T2 150 W 10 P 255 O7 Y 10
# Set callsign # Monitor I, U and S-frames - only necessary with UNPROTO function active # T2 timer settings # Slottime # P-persistance # Maxframe # Number of channels
Other parameters can be set - look in your manual. Parameters can also be set with F7 - TNC commands. If you have outgoing on more than one channel at the time, you have to use SSID's in your forward connects for each channel. With Hostmode SSID's can be set for a channel using the L-command (send tnc-command) together with the I-command (Hostmode tnc-command - SET CALLSIGN). Examples (only part of the connect strings showed): Forward to the first call:
87
L I OZ7BOX-10 C C ...
# Use SSID -10 as your outgoing call # The connect strings
Forward to the second call: L I OZ7BOX-9 # Use SSID -9 as your outgoing call C C ... # The connect strings etc.... SSID's from -0 to -15 can be used, but NOT SSID's already in use. 5 BBS COMMANDS Here is an overview of what the BBS-commands do: ;: A command-line starting with a ; is ignored. Nothing happens, and there is no prompt back. ?: Reading the help file. Type ?[COMMAND] to obtain help on a basic command. >: "Break" between channels. Type > [CALLSIGN] [TEXT] to send a text to a connected callsign on another channel. The BBS will advice you that the text has been delivered. This text cannot be longer than one line. This command is not allowed in read-only mode. =: Connection between two channels. Type = [CALLSIGN] to get connected to a callsign on another channel. The callsign can be connected only if it is not busy in a command; the BBS should be idle (waiting for a command). If the callsign is not available, you may either wait or you may cancel your request. The callsign currently busy in forwarding tasks cannot be connected. Use Ctrl-Z to leave this mode. This command is not allowed in read-only mode. !: Provide a short and minimal information on the BBS usage. %: Use this command to see the status of all channels right now. A: Abort the BBS output at any time. When reading messages with paging, the commands N and C are available, too. Use N to skip the reading of the rest of current message, and start on the next message. Use C to read the rest of the message(s) without paging. B or Bye : Disconnects the BBS. Note that the "last listed" parameter is updated. When the user does a "hard disconnect", the last-listed parameter is NOT updated. 88
C: Enters the conference mode, multi-connection. CW : Shows a list of the callsigns involved in the current conference. D: Invokes the FBBDOS mode, or receives a file from the BBS if the command is followed by a file name. F: Switches to Server mode, and access to special commands. G: Accesses the Gateway mode, if gateway is allowed in the BBS. H: Shows short help. For help with specific commands, see the ? command. I: Information about this BBS. This command displays the file FRANCAIS.INF (or another language depending upon the configuration and the language attributed to the involved channel). I callsign : Gives the information on callsign taken from the white pages database. Callsign can include wildcards. ID : Shows how many records there are in the WP database. I@ bbs : Gives the users of BBS found in the WP database. IH route : Gives the users of the hierarchical route area from WP database (wildcards allowed). IN string : Gives the WP-records including "string" in the name from the WP database. IQ string : Gives the WP-records including "string" in the QTH from the WP database. IZ Zip : Gives the users of the ZIP code area from WP database (wildcards are allowed). J-commands list the callsigns heard by or connected on the BBS. JK : Shows the last 20 connected callsigns. JA : Connected callsigns on port A. 89
JB : Connected callsigns on port B, etc... J1 : Heard callsigns on port A. J2 : Heard callsigns on port B, etc... K-commands delete messages sent by you or to you. K msg# : Deletes a message identified by its number. KM : Deletes all the messages addressed to you, that you have already read. The messages not read will not be deleted. L: Lists the new messages since the last usage of this command. LA : List messages with status A. LB : Lists bulletins. LC [mask] : List the messages which "TO" filed matches with mask. * (star) allows to list all the messages and should be the default value. Type "LC *" to see all messages. LC alone gives the current mask. Mask is recorded for each user while disconnecting. LD> YYMMDD : Lists the messages received after the specified date. LD< YYMMDD : Lists the messages received before the specified date. LE : List messages that could not be forwarded. LF : List FORWARDED messages. LH : List HELD messages. LK : List KILLED messages. LM : Lists the messages TO YOU. LN : Lists the NEW messages TO YOU. 90
LP : List PRIVATE messages. LU : Lists all unread messages to/from the user. LX : List messages with status X. LY : List messages that have been read (status Y). LL 10 : Lists the last 10 messages. LR : Equivalent to L but the messages are listed in reverse order. LS text : Searches for a text in the messages titles. Usage of wildcards is allowed. LT : List Traffic (for NTS-messages). L$ : List bulletins with status $. L< Callsign : Lists the message originated from [Callsign]. The wildcards are allowed. L> Callsign : Lists the messages destined to [Callsign]. Wildcards are allowed. L@ [BBS] : Lists the messages VIA BBS if specified. L@ alone lists the message without route. The wildcards are allowed. L msg#- : Lists all messages, starting from msg# L msg#-msg# : Lists messages between the given numbers. M msg# File : Transfers the text of the message msg# to the file File. This file will be placed in the directory USERS or from the root in case of a Sysop user. MH msg# File : Identical, but the format is the R command.
91
MV msg# File : Identical, but the format is the V command. MA msg# File : Transfers the text of the message msg# to the file File. This file will be placed in the directory USERS or on the root in case of a Sysop user. The message is appended to the existing file. MHA msg# File : Identical, but the format is the R command. The message is appended to the file. MVA msg# File : Identical, but the format is the V command. The message is appended to the file. N: Enters or modifies the name (max 12 characters allowed). NH : Enters or modifies the Home BBS. A point deletes the current Home BBS. NL : Enters or modifies the QRA locator. NP : Modifies the password for the access via telephone modem. NQ : Enters or modifies the city (Qth). NZ : Enters or modifies the Zip Code. O: Displays the setting of various options. OL : Lists the available languages. OL number : Selects a language. ON : Shows the number-base for messages. See also ON number below. ON number : Defines the number of the thousand base for the messages. Example: ON 37 defines number 37000 as being the base for numbering the messages. Then the command R 25 will cause the message 37025 to be read, although R 36025 will actually read the message nr 36025. OP : Validates or disables the scrolling of pages. 92
OP nr of lines : Initializes the page scrolling OR : Validates or disables the ability to list all messages, if the user has access to the whole list of messages by default (See security code 256 of INIT.SRV). PG [program] : PG alone gives the list of PG programs available in the BBS. If followed by a program name gives the control to this program. The PG program can also be called by its name. If the name is the same that an existing command, the existing command will be replaced with the PG program. PS : Gives the list of servers available in the BBS. R-commands are for reading messages : Note: When reading messages with paging, the commands N and C are available, too. Use N to skip the reading of the rest of current message, and start on the next message. Use C to read the rest of the message(s) without paging. R msg# msg# : Reads the messages by their numbers. RM : Reads all the messages to you. RN : Reads all the NEW messages to you. RU : Read all unread messages to/from you. R> callsign : Read all messages to a callsign. R< callsign : Read all messages from a callsign. S[type] callsign : Sends a message or a bulletin. If the type is not specified, it will be processed as a private, provided the destination callsign is a valid one, otherwise it will be considered as a bulletin. SP callsign : Sends a private message. S callsign @ BBSCALLSIGN : Sends a message to a station AT another BBS through forward. BBSCALLSIGN can be an address of hierarchical type, for example F6FBB.FRA.EU. Type "SB ALL" to send a bulletin addressed to ALL. The message must be terminated by a Ctl Z or /EX followed by a return. Warning: the /EX must be in the first column.
93
SC Msg# Callsign @ BBSCALLSIGN : Copies a message or bulletin to the specified callsign. Such a copy will always be of the "personal" type. When relying to a CP Sysop message, the title is changed back to the original. SR [Msg# [title]] : Replies to a message already read or formerly suppressed, or to a message matching the specified number. If the title is not stated, it will be the title of the read message, with the mention "Re:" placed ahead. T: Pages the Sysop. Should the Sysop not be available within a minute, you will be advised accordingly and automatically returned to the normal BBS menu. TH : Gives access to the themes-zone. Lists messages by themes, as setup in the file THEMES.SYS. Available commands in this zone, are H (list themes) L (list messages in current theme) R msg# (read message in current theme) number (change to theme#) U: Uploads a file from the user to the server of the BBS. The file will be written in the root directory of the FBBDOS. The U command is to be typed at the BBS prompt, it is not necessary to go to FBBDOS first. V: Version number of this BBS software. It gives also the number of active messages, and the next message number. V msg# msg# : Reads the messages by their numbers, including the headers. VM : Reads all the messages TO you, including the headers. VN : Reads all the NEW messages TO you, including the headers. W: Lists the files which are within the user directory. This command can be followed by a mask specifying search criteria or a directory name; in the latter case, the directory contents will be listed. X: Toggles "normal" or "expert" status. "Normal" grants the extended menus, "expert" provides only minimal information. Y: Binary transfer program using the YAPP protocol. As a user, you should also have the YAPP 94
protocol available your end, in order to be able to transfer binary data. YD File : Downloads a file FROM the BBS TO you. YI [mask] : Lists the available binary files, and their description. YN [mask] : Lists the NEW binary files since your last connection. YU File : Uploads a binary file from you TO the BBS. You cannot replace or modify an already existing file. YW [mask] : Lists the available binary files. YZ Filename : Deletes the specified filename in the YAPP directory. Z Filename : Deletes the specified filename in the user directory. 6 SERVER -MODE The server commands are gathered in groups. C : Connections - Statistics. D : Documentation. Q : QTH locator. N : Ham Callsigns Directory ("Call-Book"). T : Satellite orbits computation. F : Switches back to BBS mode. B : Quit and disconnects 6.1 CONNECTIONS-statistics. Statistical data about the operation of the Server and the Traffic Log. O : Activity of the different groups. Percentage of usage for the different activities. G : Global statistics. - Number of active messages. - Number of connections. - Time of connections. - Peak traffic periods. L : Lists the connections (Traffic Log). For each and every connection, the channel - callsign - date and time - as well as the connection duration are indicated. These informations are listed in reverse 95
chronological order. H : Hourly usage. J : Daily usage. I : Users Callsign list. List of the callsigns that have connected the server. This list is given in alphanumeric order. F : Switches back to the Server main menu. B : Quit and Disconnect. 6.2 DOCUMENTATION-server You will find under these comments the information or documentations given by various hams. The documentation is organized like the image of a tree structure whose root is defined in INIT.SRV (C:\DOCS). The directories represent the topics and the files represent the documentation. The selection of the topics or the documentation is made through numeral command. The menu is presented with the form of one or several numbers followed with their description (topics or documentations). In the case of topics, the description corresponds to the name of the MsDos directory. This name is eleven characters long, the dot between the name and the extension will not appear. It is possible also to simulate the space character with an underscore character. In the case of documentation files, a label of 30 characters is associated to the name of the MsDos file. The label only will be presented to the user. To optimize the fill up of the screen, each line will contain two labels. In the case of a user, given the right of Sysop, the display will be different. One line will contain only the name of the MsDos file followed by its label. L : L gives the list of the documentation on the current chapter. D : Labeling of the files is made by the command D, reserved to Sysop, or automated through the NEWDOC server (See paragraph SERVERS, NEWDOC). Example : D BBS.DOC Documentation of the BBS. F : Switches back to the Server main menu. B : Quit and Disconnect. 6.3 QTH-locator server The QTH locator is made of 2 letters, 2 figures, and 2 letters yielding the geographical coordinates of a station. You can translate the QTH locator into Longitude/Latitude or vice-versa, compute the distance and azimuth between two QTH locator or compute your Log-Sheets for contests (adding together distances).
96
Q : Converts one QTH Locator into Longitude and Latitude. The West longitude and North latitude are given in degrees minutes, or grades. D : Distance and Azimuth computation between two QTH Locators. Computation of the distance and azimuth between two QTH Locators. The distance is given in Kilometers and the azimuth in degrees. C : Computation of the distance and azimuth between two QTH Locators. The distance is given in Kilometers and the azimuth in degrees. L : Converts the Longitude and Latitude into QTH Locator. The west longitude and north latitude can be given in degrees, degrees minutes, or grades. F : Switches back to the Server main menu. B : Quit and Disconnect. 6.4 Callsigns-directory You will find in this module the information that the users will have accepted to leave there: name, first name, address, phone number, etc... You will be able, as well, to update your own various information. N : Modify your name and address. R : Search for information about a user. I : List the connected callsigns. N : Modify your name and address. If the information in the file is erroneous, or should they have changed, you can modify them with this command. A space or a return as an answer to the question will not modify the content. If the content of the file is correct, you can skip modification by replying N to the modification request. R : Search for information about a user. If the user is known in the file, you will get information about him. You can concatenate the callsign of the user who is searched for behind the command. Ex.: R F6FBB will give information about F6FBB. I : List the callsigns of the users who are connected the server. This list is sorted in an alphanumeric order. F : Switches back to the Server main menu. B : Quit and Disconnect. 6.5 Satellite orbits server Satellite orbital parameters computation, and satellite characteristics. P : Display of orbital parameters. Selected satellite orbital parameters display. These parameters will be used for the computation. C : Amateur Satellites characteristics. F : Switches back to Server main menu. T : Satellite orbital computation. M : Manual editing of orbital elements. 97
To select a satellite, type the number (a list of the satellites can be obtained with the command L instead of the number). Once the satellite has been selected, you will have to supply the date and the time to be taken into account for the computation. If you only answer with a return character, the current date (or time) will be taken. The geographical position is the QTH Locator of the connected user, if it is known in the file. Otherwise, the QTH Locator of the server will be used as a default. Depending on the satellites, the computation step can be variable, and one line of parameters will be displayed per step. This line corresponds to a minimal elevation of -5 degree s, that means the satellite 5 degrees below the horizon. F : Switches back to the Server main menu. B : Quit and Disconnect. 7 FBBDOS COMMANDS The syntax of the various FBBDOS commands is very close to that of MsDos(R). Several specific commands have been added: PUT and GET for file transfers. XPUT, YPUT and XGET, YGET for binary file transfers. EDIT command for files editing. When entering FBBDOS, the prompt shows the virtual directory in which the user is located. There is no physical drive concept (A, C, etc...), the user is situated in a directory defined in the INIT.SRV file; this directory becomes the root of the available directory tree. Should the user be a Sysop, and if he successfully validated his privileges using the SYS command, the root of FBBDOS will be the root of the current drive. A file created by a user belongs to this user. Only the owner of the file, or a Sysop granted writing privileges (SYS command) are permitted to delete or modify this file. BGET file : A binary file is downloaded from the BBS. The Autobin protocol is used. BPUT file : A binary file is uploaded to the BBS. The Autobin protocol is used. CD directory : Changes the active directory. This command allows you to move within the directory tree by changing the active directory. "CD.." changes back by one directory "upstream" towards the root. COPY Origin Destination : Copies a file into another file. If the destination file already exists, it must belong to the user. DEL file : Deletes a file. A file cannot be deleted if it does not belong to the user. DIR [mask] : Displays all the files contained in the directory or these corresponding to the mask if it is specified. If the mask matches a directory name, the content of this directory will be listed.
98
DOS Program Arguments : Allows a remote Sysop (after SYS command) to run a DOS program. This program can not expect keyboard input. A list of arguments can be specified. The output to the screen will be send to the remote Sysop at the completion of the program. If the program expects inputs, after a time-out of 2'45, it will be aborted (if possible) and the normal operation will resume. DU [mask] : Gives the size of the tree, and local used disk. EDIT file : Edition of a text file, using the line editor. If the file already exists, it must belong to the user. Instructions on how to use the line editor is in a separate section of this documentation. EXIT : Exit FBBDOS and return to the BBS or server. GET file : Displays the content of an file. Such a display is never scrolled by pages, and ends with a Ctrl-Z, thus allowing file transfers from the BBS to the user. LIST mask : Displays all the files contained in the directory or these matching the mask specified. if the mask matches a directory name, the content of this directory will be listed. Each line displays the filename and a descriptive comment (cf YI command). MD directory : Creates a new directory. The new directory is appended next to the current directory. O: Display various options. OL : Lists the available languages. OL number : To select a language. OP : Validates or disables the scrolling of pages. OP nr of lines : Set how many lines per page in page scrolling. PRIV : Access to a private directory (or return to FBBDOS directories). Each user can have access to a private directory provided it has been defined by the Sysop (i.e. EU command). Several users may share a private directory. PUT file : Accepts an file from a user. The file must end with a Ctrl-Z to be validated. If the file already 99
exists, it should belong to the user. RD directory : Deletes a directory. A directory cannot be deleted as long as it is not empty. TYPE file : Displays the content of an file. Eventually, this list can be scrolled by pages. VIEW mask : Displays the content of all the archive files contained in the directory and corresponding to the specified mask. For DosFBB and WinFBB: This function uses the FV.COM shareware. Thanks to the authors of this last one. In LinFBB: the VIEW command in LINUX version calls for the FBB_VIEW program. (or any program defined by the variable $FBB_VIEW); fbb_view may be a shell script. WHERE filename : Command to find one or more files in FBBDos. Wildcards are allowed. XGET file [offset] : Only via telephone-modem: A binary file is downloaded from the BBS. The Xmodem protocol is used. This command works only on a PSTN modem port. If offset is specified, download will start from offset. X1GET file : Same as above, with 1K-Xmodem protocol. XPUT file : Only via telephone-modem: A binary file is uploaded to the BBS. The Xmodem protocol is used. This command works only on a PSTN modem port. YGET file : A binary file is downloaded from BBS. Via radio: Both YAPP and YAPPC protocols may be used. Via telephone-modem: YGET starts the YMODEM, YMODEM-batch or YMODEM-G protocols. YPUT file : A binary file is uploaded to the BBS. Via radio: Both YAPP and YAPPC protocols may be used. Via telephone-modem: YPUT starts the YMODEM protocol. This is NOT available if the BBS is running DosFBB ! ZGET file : Only via telephone-modem: ZGET starts download from the BBS using the YMODEM, YMODEM-batch or YMODEM-G protocols.
100
ZPUT file : Only via telephone-modem: YPUT starts upload to the BBS using the YMODEM protocol. This is NOT available if the BBS is running DosFBB ! 8 Sysop Commands Commands available under the BBS menu. DU callsign : Displays the information related to the given callsign. DB : Lists the BBS callsigns. DE : Lists the EXCLUDED callsigns. DF : Lists all PMS-users. DL : Lists the callsigns with LOCAL status. DM : Lists the callsigns with modem or Telnet access. DP : Lists callsigns which are using the page scroll. DS : Lists the SysopS callsigns. DX : Lists the EXPERT callsigns. E msg# : Edits the message # header. The message header is first displayed, then a string of options will allow you to edit the various fields of this header. A "return" terminates the edit. EM msg# : (N/A for LinFBB) Edits the body of a message. During edit the message is not being forwarded. EO : Edit the system options (linux only) [7.02d (Sep 07, 2000)]. Added MsgEdit for the full-screen editor for messages [7.03b (Jan 21, 2001). EU callsign : 101
Edits the main parameters of a user. The user's parameters are first displayed, then a string of options will allow you to edit the various parameters. A "return" terminates the edit. Most of fields can be cleared with a point. A user can be edited while connected and then action is immediate. Flags are : R : All mail (included personal) can be read P : Paging validated B : BBS S : Sysop X : Expert L : Local (Allowed to all commands on guest access). E : Excluded (cannot connect to the BBS) M : Modem/Telnet access U : Unproto (Allows unproto list requests/resyncs). I : Give the list of new messages on logon. F : PMS forwarding (allows forward but texts are like normal user). Other fields may be filled with informations: G number N name W password V directory H home-bbs Z zip-code
: selected language : name of the user : password of the user (obligatory for the PBBS Telnet forwarding) : private directory of the user (12 characters max) : home-bbs of the user : zip-code of the user
FA msg# BBS : Specifies that the message defined by its number will be forwarded to the specified adjacent BBS. FB BBS : Gives the list of messages waiting for forward to this BBS. FC Route : Gives the list of BBSs that will receive the messages with the specified route. If the route is a possible callsign, the BBS will look for BBS routing, if composed with digits will look for NTS routing, otherwise will look for bulletins (group) routing. FD msg# BBS : Removes the message # from the forward to the specified adjacent BBS. FG : Shows the partly received messages (may be resumed in next forward). FH BBS : Gives the hierarchical extension for BBS. FI BID command : BID maintenance. Command = ? : Gives message number and the message type of the BID/MID. + : Adds the BID/MID to the list. 102
-
: Deletes the BID/MID from the list.
FL [BBS] : Lists the messages in the forward-queue [for BBS if specified]. FN Msg# : List of the BBSs which are in the waiting list for this message number, and the BBSs already forwarded or named in the preamble. FP command callsign : Swap test. Command = @ : Gives the swap (if existing) for the via callsign. > : Gives the swap (if existing) for the to callsign. < : Gives the swap (if existing) for the from callsign. FR Argument : Forces reverse forwarding to BBS (or port), even if there is no pending mail. If the argument is a callsign of known BBS, reverse forwarding to this BBS will start. The argument can be a port number, in this case the reverse forwarding will start on that port, if 9 is specified then the reverse forwarding will start for all the ports. FS Argument : Stops the forwarding. If the argument is a callsign of known BBS, the forwarding to this BBS will be stopped. The argument can be a port number, in this case the forwarding will be stopped on that port, if 9 is specified then the forwarding will be stopped for all the ports. FT [BBS] : Lists the volume of the messages which are waiting for forward to all BBSs, or to only one BBS if the callsign of that BBS is specified. The command shows the volumes in real-time. FU Channel : Immediately disconnects the specified channel. FV : Recompiles FORWARD.SYS and its 'include files', the SWAPP.SYS and BBS.SYS and then starts the scanning of messages to update the forwarding list. This may be necessary after a FORWARD file change. FW Argument : Starts forwarding to BBS (or port). If the argument is a callsign of known BBS, forwarding to this BBS will start. The argument can be a port number, in this case the forwarding will start on that port, if 0 is specified then the forwarding will start for all the ports. [V7.04g] HO msg# : Puts a message in the HOLD-list. IE Callsign : Gives first the WP information using IL format (see below), and then prompts the deletion of the record. If the answer is Y, the record will be deleted, else you enter the edition mode. Type return to exit edition mode.
103
The commands are : U : Updates primary part with the temporary part (2 -> 1). N name : Changes the name of the user. 1H Route : Changes the primary route. 1Q Qth : Changes the primary Qth. 1Z Zipcode : Changes the primary ZipCode. 2H Route : Changes the temporary route. 2Q Qth : Changes the temporary Qth. 2Z Zipcode : Changes the temporary ZipCode. IL Callsign : Gives all the information of a callsign from the white pages database. IN substring : Gives the WP records including “substring” in Name [V7.00f02] IQ substring : Gives the WP records including “substring” in QTH [V7.00f02] Kx : The fact that a leading K is entered before a kill command with the letter K (I.E. KK, KK callsign : Deletion of any message to this callsign. K< callsign : Deletion of any message sent from this callsign. K@ route : Suppresses all the messages which have the specified route. KF : Suppresses all the messages already forwarded. $ msg# : Information about msg# forwarding: lists the BBS which have not yet received the message #. LU (RU) : Lists (or displays) all the personal messages which have not yet been read by their addressee. Mx : Same as the command "L", with the same syntax, but the BID is inserted at the beginning of the "SUBJECT"-field. This command allows you to do some search or to visualize BIDs in the message lists (commands MS, ML, etc...), i.e. ml 7 = ll 7; ms info = ls info. PR : 104
Enables or disables the printer from the console. The printer is automatically disabled on disconnect. PR> filename : validates and redirects the printing to a filename. (Works only in DosFBB) PR> - : validates and redirects the printing to the standard printer. (Works only in DosFBB) RE : Show and releases the HELD messages. SR [#msg] [+filename] [subject] : Reply to a message already read or formerly suppressed, or to a message matching the specified number and appends the contents of filename. If the subject is not stated, it will be the title of the read message, with the "Re:" placed ahead. SYS : Enables remote Sysop mode. A callsign validated as Sysop is permitted to access messages and files in the BBS according to the settings in PASSWD.SYS file. The SYS command will return a string of numbers corresponding to the position of a letter in a sentence located in the PASSWD.SYS file. If you send back the 5 letters (without any space) matching the 5 numbers, an OK will be sent out to confirm that the Sysop mode is granted. YL file : Modifies the description of an existing YAPP file. Other commands M: In the SATELLITE ORBITAL COMPUTATION menu, manual modification of the orbital parameters of the satellites. N Callsign : In the "Call-book" menu, this command allows to edit/modify call-book information of a user. S file : In the gateway and in command mode, send an file. W file : In the gateway, opens a capture file. The file is closed with another W command. YU Filename : In gateway mode and only from the console send a binary file to a remote system under the YAPP protocol. YD Filename : In gateway mode and only from the console receive a binary file from a remote system under the YAPP protocol. 105
/A : Immediate PBBS stop [V7.0b27] /K : Start housekeeping. /L : Software reboot. /M : Immediate software reboot. /R : Reboot the PC You will also find a list of all function-keys in the Console Commands chapter. 9 CONSOLE COMMANDS (Function-keys and other). There are a few differences in WinFBB from DosFBB. For WinFBB: Most of these commands will open a window. The server operation is NOT suspended while these windows stay open. F1 F2 F3 F4
-
Help. Connect to the BBS locally with the console-callsign. Disconnect a channel. Start or stop forwarding. Shows how many/big messages are waiting for forward right now (real-time). Click on the BBS(s) you want to start forward to, and click "Start Fwd". There are also buttons for "Start All" and "StopFwd", as well as import and export. F5 - Toggle monitoring on/off. F6 - Change console-callsign. That callsign is used when connecting to he BBS with F2 or via gateway F9. The callsign have Sysop-status. F7 - Program TNC directly. This allows a dynamic modification of the parameters which will be affected as default to the channels of the related port. These parameters will not be taken into account for the channels already connected, and will be transferred to the channel upon disconnect. The commands are specific to the TNC in use: WA8DED with a TNC2, Hostmode PK232 with a PK232, or the BPQ node. F8 - Not used F9 - Gateway, using console-callsign. F10 - Initiate a chat with a user (click on the user first). ALT-F1 - Not used ALT-F2 - Not used ALT-F3 - Start or stop forward-scan. Before starting scanning, FORWARD.SYS and its includefiles, BBS.SYS and SWAPP.SYS are recompiled. ALT-F4 - Quit FBB. ALT-F5 - Start a text-editor. ALT-F6 - Not used ALT-F7 - Show last connections. ALT-F8 - Not used 106
ALT-F9 - Not used ALT-F10- Not used ALT-B - Not used ALT-D - Not used ALT-R - Not used ALT-N - Not used ALT-S - Not used ALT-X - Not used CTRL-F1 to CTRL-F10 hold predefined texts, that are sent when pressing that key. The texts are in the file MEMO.SYS. Works only in the editor. Exceptions: CTRL-F1 and CTRL-10 are captured by Windows. CTRL-F4 exits the editor. In addition to the function-keys, there are quite a few push-buttons on the screen in WinFBB, in standard Windows-fashion. Click on them to get the wanted result. This should be selfexplanatory. Much information may be retrieved this way, and many things may be configured this way. In addition to the main FBB-window, you may want to have open at the same time the DISPLAY ALL CHANNELS and MONITOR windows (I do, hi). They may be re-sized to fit beside and under the main FBB-window. The windows position and size and saved if you stop the BBS. For LinFBB: No function-keys are available in LinFBB. For DosFBB: Most of these commands will open a window. The server operation is suspended while these windows stay open, but the user requests are queued and will not be lost. If no reply is given, the window will close down after a few seconds, and the default reply will not be taken into account. Do not forget to validate your replies with "Enter". F1 F2 F3 F4
F5
-
General help on all function-keys. Connect to the BBS locally with the console-callsign. Disconnect a channel. Start or stop forwarding. Manual forwarding request, or cancellation of current forwarding. If a number up to 8 is specified, the corresponding port will be scanned for forwarding. If the number 9 is specified, all ports will be scanned. If a callsign is specified, it will be scanned for forwarding. Preceding the callsign with + will force reverse even if there is no waiting mail, preceding the callsign with - will stop the forwarding and disconnect. - Toggle monitoring on/off. With monitor on, the lower part of the screen displays the monitored traffic, while the upper part of the screen shows traffic in the BBS. Number of lines in upper/lower part of the screen, can be adjusted with the arrow-up or arrow-down keys. 107
F6
- Change console-callsign. That callsign is used when connecting to the BBS with F2 or via gateway F9. The callsign have Sysop-status. F7 - Program TNC directly. This allows a dynamic modification of the parameters which will be affected as default to the channels of the related port. These parameters will not be taken into account for the channels already connected, and will be transferred to the channel upon disconnect. The commands are specific to the TNC in use: WA8DED with a TNC2, Hostmode PK232 with a PK232, or the BPQ node. F8 - Reboot PC. Can be done at once, or when all channels are free. F9 - Gateway, using console-callsign. F10 - Talk to a user (that have sent a T) or initiate a chat with a user. ALT-F1 - Shows pending forward(s). Shows number of personal messages, bulletins, and the total amount of kB waiting to be forwarded. ALT-F2 - Shows all callsigns connected to the BBS. ALT-F3 - Start or stop forward-scan. Before starting scanning, FORWARD.SYS and its includefiles, BBS.SYS and SWAPP.SYS are recompiled. ALT-F4 - Shows the last connected callsigns. ALT-F5 - Starts a very simple text-editor (use F1 for help there). ALT-F6 - Various "options" : Sysop is in ? Enables T-command. Beep at connect ? Show callsigns etc. on every channel ? Gateway allowed ? Justification on text typed from console ? Use screen editor ? ALT-F7 - Import messages from file. ALT-F8 - Export messages to file. Messages that are waiting to be forwarded to one BBS. These messages can be forwarded to a file. ALT-F9 - Exit to DOS. WARNING: the BBS operation is suspended all this time long. The users will not be disconnected, and their commands will be queued. Return to BBS by typing EXIT. ALT-F10- Stop the mailbox-program. Can be done at once, or when all channels are clear. ALT-B ALT-D ALT-N ALT-R ALT-S ALT-X
-
Blank screen. Save scroll-buffer to file. Allows reprogramming a telephone modem Redisplay screen. Show last DOS-screen. Press a key to return to BBS. Stop the BBS (same as ALT-F10).
CTRL-F1 to CTRL-F10 holds predefined texts, that are sent when pressing that key. The texts are in the file MEMO.SYS. Arrow -> Arrow or Ctrl -< PG-UP PG-DW HOME END
- Display next channel. - Display previous channel. - Return to the display of all channels. - Display the previous page if it exists - Display next page. - Display the first page. - Display the last page.
108
10 FULL SCREEN EDITOR (DosFBB) (Only for DosFBB, WinFBB has another editor) The editor is validated for answering messages, with Alt-F6. The Tiny-Edit is started with the Alt-F5 command. Normal operation of the BBS is maintained, the editing takes place in the console window, above the monitoring area of the display. Most of the text files can be edited with this editor despite of its simplicity. The most concerning drawback is the fact that the line length can not be longer than 79 characters. The language files (xxxx.TXT) therefore cannot be edited. Tabs are not generated and are presented on the display with a special character. During the editing, the usual BBS command set are no longer available, they are replaced by the tiny-edit commands. Upon activation of the editor, a dialog window ask for the filename to edit. The default directory is the directory "SYSTEM" as defined in INIT.SRV. Examples: FORWARD.SYS will edit SYSTEM\FORWARD.SYS FWD\F6FBB will edit SYSTEM\FWD\F6FBB It will be necessary to specify the full path for a file outside of the default directory root or located on another disk drive. If only the drive name is specified, the current directory on this drive is searched for the filename. Example: C:INIT.SRV will edit C:\FBB\INIT.SRV (while the current directory is c:\FBB). To edit a message, one should give the message number with a leading pound sign ('#'). Example : #42645 will edit the message number 42645. In case the edited file is a compiled one (i.e. FORWARD.SYS) it will be compiled again after the termination of tiny-edit Function-keys : F1 F2 F3 F8 F9 F10
: Help windows. : The edited file is appended to the incoming mail file of the BBS (MAIL.IN). : Insert file. : Save current file. : Save current file and exit. : Exit Tiny-Edit without saving ! Caution : No confirmation requested before closure of the current edit session.
109
Edit Commands : Almost all commands are available from the numeric key-pad. Up-arrow : The cursor moves up one line Down-arrow : The cursor moves to next line Right-arrow : The cursor moves forward one character. At the end of the line it moves to the beginning of the next line. Left-arrow : The cursor moves backward one character position. At the beginning of the line it moves back to the end of the former line. Page-down
: The cursor moves toward the end of the current page. If it is already at the end of page position, then the next page will be displayed. Page-up : The cursor goes back to the first line of the current page. If it is already at the first line, the former page will be displayed. Home : The cursor moves to the first character of the current line. End : The cursor moves to the character position next after the last character of the line. Insert : Toggle the insert editing mode. The cursor is an underscore while in insert mode. It is a cursor block in overwrite mode. Delete : Erase the character at cursor position, the cursor is not moved. Back-space : The character preceding is deleted and the cursor moves backwards one position. Ctl right-arrow : The cursor moves to the first character of the next word. Ctl left-arrow : The cursor moves to the first character of the previous word. Ctl home : The first page of the file is displayed and the cursor moves to the first line. Ctl end : The last page is displayed and the cursor goes to the last line of the file. Ctl Y : The current line is deleted. Ctl Q : The current line is deleted from the cursor position up to the end. 11 VARIABLES Variables definition: Most of the text files support usage of variables. These variables enable text or values to be placed, depending upon the context or the channels in use. These variables are defined with the $ sign, followed by a letter. The meaning will be different if the letter is in capital or in lower case. A second set of variables is defined with the % sign, followed by a letter. They can also be followed by a figure and in this case, this is a parameter whose value is function of the context. These particular variables are used in texts, usually as computation results. Do not use them in other places than text files (*.TXT). The $ sign will have to be written $$, if it is not to be considered as a variable. The % sign will have to be written %%. List of the variables: $0 - $9 : Temporary variables. 110
$A : @ BBS of the message header. $a : Year of the current date. $B : Inserts a Ctrl-G (Bell). $b : Zip code of the user. $C : Number of the next message. $c : City where the BBS is located. $D : Current date (Format : YYMMDD). $d : Current date (Format : DD-Dec). $E : Version number. $e : City of the connected user. $F : Minute of the hour for forwarding. $f : File appended to the message header. $G : Destination of the message header. $g : Number of gateway ports available. $H : Current time (Format : HH:MM). $h : Home BBS of the user. $I : First name of the connected user. $i : Date and time of the message header (Format MMDD/HHMM). $J : Date of the message header (Format YYMMDD). $j : Date of the message header (Format 29-Dec). $K : Time of the message header (Format : HH:MM). $k : List of the users involved in the conference. $L : Number of the last used message. $l : Filter value of LC command. $M : Number of the message header. $m : Frequency of the port in use. $N : Number of active messages. $n : Size of the message header. $O : BBS callsign. $o : SSID of the BBS. $P : Origin of the message header. $p : Number of lines of scroll page option, for the connected user $Q : List of the 8 callsigns which have new messages. $q : Base messages number of the user. $R : BID of the message header. $r : L or space character. L means that the message was locally created. $S : Subject of the message header. $s : Status of the message header. $T : Time of message header (Format : HH:MM). $t : Type of message header. $U : Callsign of the connected user. $u : Current drive in FBBDOS. $V : Sysop first name. $v : Complete route (with the hierarchical structure). $W : Inserts a carriage return. $w : Inserts an escape character. $X : Date of the last connection (Format : 881229). $x : Date of the last connection (Format : 29-Dec). $Y : Time of the last connection (Format : 12:30). $y : Year of message. 111
$Z : Last message read by the user (L command). $z : Zip Code of the BBS. $* : Number of active channels. $= : User's current channel. $! : User's current port. $^ : Number of allowed ports. $? : BBS QTH-Locator. $% : List of the connected users. $: : Connection duration (Format : 12mn 05s). $. : Machine operation time (Format : 12mn 05s). $$ : Character $ Second set of variables: (unformatted means that text is not padded with spaces) : %A : @ BBS of the message header, unformatted. %C : Gives the number of times a message has been read. %d : Nb of KB downloaded to the user. %E : Give the version code (Linux, Dos, Windows). %e : Date of software compilation (english only). [V7.00f02] %G : Destination of the message header, unformatted. %i : Date and time of the message creation (Format MMDD/HHMM). %I variable gives the name (if known) of the message sender from WP. [V7.04d] %J : Date of the message creation (format YYMMDD). %j : Date of the message creation (format 29-Dec). %K : Time of the message creation (format HH:MM). %k : Nb of kilobytes to forward to the connected station. %l : Nb of messages to forward to the connected station. %M : Number of the message, unformatted. %m : Maximum KB of download allowed on the port. %N : Gives the message number limited to the right 5 digits and modulo 65536. To be changed in the header definition of INIT.SRV. %n : Size of the message header, unformatted. %O : Sysop callsign. %P : Origin of the message header, unformatted. %R : Callsign with full path (e.g. F6FBB.FMLR.FRA.EU). %r : = D if the message holds data (7+) else is space. %T : Name of the current theme. %t : Number of bulletins in the current theme. %X : Number of messages for the user. %x : Number of new messages for the user. %y : Year of the message creation. %% : Character % 12 MISCELLANEOUS TOOLS A set of tools is available to the Sysop. These tools are for manual or automatic maintenance. In most cases, these tools should be handled with caution, the process can be dangerous for the files.
112
Avoid the use of those tools while the server is in operation (the F9 command, as for an example, in DosFBB), because the modification of some files during operation can yield unpredictable corruptions. Here is a list of the available tools: FBBSETUP.EXE INSTWFBB.COM INSTALL.SH EPURMESS.COM EPURWP.COM LOGSTAT.EXE SATUPDAT.EXE SLEEP.COM MAKEPG.COM SETUSER.COM CLEANUP.COM MAINTINF.COM CUT.COM FV.COM ISDAY.COM CLR_USER.COM For LinFBB: EPURMESS (works as EPURMESS.COM) EPURWP (works as EPURWP.COM) FBB_VIEW (works as FV.COM, but takes no parameters) FBB_ZM XFBBC FBB_VIEW 12.1 INSTWFBB.COM INSTALL.SH FBBSETUP.EXE
(for WinFBB) (For LinFBB) (for DosFBB)
INSTWFBB.COM: (Only for WinFBB) This program is a full-screen configuration of INIT.SRV and PORT.SYS. This program has its own program-icon, and can be started by double-clicking that icon. Most of the commands are self-documented. You must only follow the instructions. The changes in INIT.SRV can be done without rebooting the BBS, but changes in PORT.SYS will not affect the BBS until after a reboot of the BBS. INSTALL.SH: (Only for LinFBB) This is a configuration-program for LinFBB. It will configure the most important parts of the file INIT.SRV. Mind you, you will need to check the rest of INIT.SRV manually, too ! FBBSETUP.EXE: (Only for DosFBB) This program is a full-screen configuration of INIT.SRV and PORT.SYS. Most commands are well documented. You must only follow the instructions. 113
FBBSETUP will support multiple language files in same format as ENGLISH.OLH and ENGLISH.MNU if the DEFAULT.OLH and DEFAULT.MNU files do not exists (after a language is selected, the files become the DEFAULT.XXX files). Files normally belonging to FBBSETUP are: FBBSETUP EXE ENGLISH OLH ENGLISH MNU DEFAULT OLH DEFAULT MNU The DEFAULT files may first be created after the first run of FBBSETUP. All files will normally reside in \FBB\BIN directory. For all the above versions: If the INIT.SRV file does not exist, you will be prompted to create a new one. Be sure that you are in the FBB directory when running FBBSETUP.EXE. If the INIT.SRV is not of the right version, you will also be prompted, but be careful, as the results could be hazardous. The comments of the original file are not changed. 12.2 EPURMESS.COM EPURMESS is a tool which allows for modification of messages: status, removal, or archiving. This tool is called every night by the BBS in order to maintain the message list as a function of the time. The EPURMESS configuration is made by the text file EPURMESS.INI. The parameters which are contained are given as a suggestion, and can be edited later if needed, to suit the targeted archiving and the mass of messages and bulletins received. EPURMESS searches the current directory for its EPURMESS.INI initialization file. In that file, it will find out all the parameters for processing, as well as the file name for the report EPURMESS.RES (this file name can be changed in the EPURMESS.INI file). At the beginning of the process, EPURMESS first copies DIRMES.SYS into DIRMES.OLD to keep an archive trace of the previous file, then creates DIRMES.NEW, in which the processing will take place. At the end of the process, DIRMES.NEW will be copied into DIRMES.SYS. A report of the processing will be written in the EPURMESS.RES file. If the last update of the DIRMES.SYS file has been carried out more than 24 hours ago, EPURMESS will not make its process, in order to avoid any loss of data due to a possible clock error in the system. It will report the error in the EPURMESS.RES file. In such a case, after the reason of the error has been detected, it will be necessary to suppress the EPURMESS.RES report file, in order to re-enable the processing. The ARCHIVE line has two digits, the first one applies to private messages and the second to bulletins. The '1' digit validate the archiving while the '0' will suppress the messages once and for all. 114
It is possible to specify origins, destinations or routing for which the obsolete time (X status) are different from the default values. These particular cases are specified at the end of the file with the form of supplementary lines. Each line specifies a particular case. The line should begin with the character which specifies the field to be tested, then the content of the field and then the number of days before the status X is given. Ex : > ALL 1 The messages for ALL will be valid only one day. Example of EPURMESS.INI file: # File for deciding messages' lifetime.. # # Directory for messages \FBB\MAIL\ # # Directory for binary-messages \FBB\BINMAIL\ # # Directory for "killed" messages \fbb\OLDMAIL\ # # The file DIRMES.SYS (database-file) \fbb\system\DIRMES.SYS # # Old database-file (backup) \fbb\system\DIRMES.OLD # # New database-file (after EPURMESS (cleanup)) \fbb\system\DIRMES.NEW # # Result of cleanup is put into this file: \FBB\EPURMESS.RES # # Personal Bulletins (0=kill 1=archive in oldmail) 00 # # parameters in days: # # parameters FOR PERSONAL MESSAGES: # # PN -> PX (days after message is written) 30 # # PY -> PX (days after changed to Y) 7 115
# # PF -> PK (days after changed to F) 7 # # PX -> PK (days after changed to X) 0 # # PK -> PA (days after changed to K) 0 # # parameters FOR BULLETINS # # BN -> BX (days after the message is written) 7 # # B$ -> BX (days after the message is written) 7 # # BY -> BX (days after changed to Y) 7 # # BX -> BK (days after changed to X) 14 # # BF -> BX (days after message is written) 14 # # BK -> BA (days after changed to K) 0 # # Automatic generated return-messages for non-forwarded messages. # Each line may be max 255 characters long. Disable with only a 0. # # Timeout for valid forward-path (number of days + text, end with $W) 21 This message could not be forwarded, due to bad link.$W # # Unknown routing or wrong H-address (number of days + text, end with $W) 2 This message could not be forwarded, due to bad callsign or bad route.$W # # Max number of lines in a returned message: 10 -----# # List of lifetime-tests # # Type To Days #@ VEST 365 #@ LA 365 #> LA6CU 365 #< system 0 116
# # End of this file. # 12.3 EPURWP.COM EPURWP is a tool which allows updates and modifications of the white pages database. Two optional parameters may follow. The first will specify how many days will go by before a data is valid. If the temporary part of the record has not changed during this time, it will be considered as stable and transferred to the primary (used) part. The second parameter states how many days will go by before the record is deleted from the database. This is how many days go by with no updates or refreshes of this user's data. 12.4 LOGSTAT.EXE Statistical analysis software for the FBBLOG file written by FC1MVP. The configuration file for this software is in the text file LOGFBB.CNF, which should be located in the same directory. LOGFBB.CNF file layout : This file is made of several lines indicating: - BBS Callsign - the name of the Sysop port, a comment. - The abbreviated name of the 1st port, a comment. - The abbreviated name of the 2nd port, a comment. - and so on until the last port (8 ports maximum). - Three stars (***) at the beginning of the line means the end of the ports. - The BIOS screen access option. The BBS callsign must have 6 characters maximum. It will be truncated should it be longer. The abbreviated port name may have up to 10 characters, it is recommended to limit at 4 (ex VHF1 or HF2). A comma separates the abbreviated name from the comment which follows it, without any space. The comment may have 10 characters too (frequency). At the end of the comment, it is possible to add a comment which is internal to the CNF file, and which will not be used elsewhere, using the ":" as a separation.
117
If the BIOS line has a NON at the beginning, the screen access will be direct. The word OUI means that the screen access is made via the BIOS. The direct access improves the processing speed by 50 percent but is careless with DesqView. Example of LOGFBB.CNF file: F6FBB : BBS name. Sysop, at keyboard : port name @, comment. VHF, 144.675 : Port A, comment. VHF, 145.275 : Port B, comment. UHF, 430.675 : Port C, comment. HF, 21.107 : Port D, comment. SHF, 1299,675 : Port E, comment. MODEM, Telephone : Port F , comment. *** End of ports definition. NON : Screen access through BIOS (OUI) or Direct (NON). Software limitations: The software is able to handle a log file within the following limits: - Maximum number of days : 35, or 5 weeks if you chain 5 log files. - Maximum number of channels: 50 - Maximum number of ports : 8+1, corresponding to ports A to H handled by the BBS and the Sysop keyboard "port". - Maximum nr of callsigns : 300 (This is not the number of the call signs known by the BBS, but the number of calls which were used the BBS during the log period. In case an overflow occurs, the mention AUTRES for the callsign and 99 for the day will be displayed in the corresponding areas. Regarding the forward efficiency, only the stations which have actually forwarded will be given a value, the others will be mentioned "nc". Usage : On the same diskette (or the same disk) there should be at least the program LOGSTAT.EXE, the config file LOGFBB.CNF and enough disk free space for the result files to be created. The log file may stay on another diskette. For the startup you should type in LOGSTAT FBBLOG.nn (nn is the number of the week) or A: FBBLOG.nn (if the file is located on A:) The results are recorded into the files LOG.@, LOG.A ... LOG.T being the total of the logs. Archiving :
118
A suggestion: you should better archive your FBBLOG.nn file rather than the LOG.x files. You should ZIP them (or ARC or LZH) with the name LOG990nn.ZIP (.ARC or .LZH) with 990 standing for 1990 (000 will be for 2000...) and nn is the number of the week. Log structure : The number of resulting files created is equal to the number of ports of the BBS plus 2. The 2 supplementary files correspond to the console port and the sum of the various ports as being the total result. The first log, named LOG.@ corresponds to the Sysop log (console), the last one, named LOG.T is the summation of the ports. The files LOG.A to LOG.H are the logs of the various ports. Obviously, if a port has not been used, the corresponding file will not be created. For each LOG.x file, you find in the following order: - Diary of the connections per day (y-axix) and the time (x-axix) with the daily total at the end of the line and the hourly total at the bottom of each column. - The total connection time: it is the sum of the connection times of each user. For the LOG.T file, the total connection time per channel will also be given. - Mean time per connection : this is the total connection time divided by the number of connections. - Mean time per user : total connection time divided by the number of users. - Number of killed messages : self explanatory. - Number of read messages : idem. - Number of users. - A matrix of forwarded messages per day (y-axix) and per hour (x-axix) is made like before. This matrix will not appear if there has not been at least one forward on this port. - Number of forwarded messages: number of messages sent to another BBS or PMS. - Number of messages received in forward: number of messages transmitted by other BBS in forward. - Number of messages received in back-forward: number of messages received from another BBS when forwarding towards it. - Number of messages refused as already received. - An array giving the number and the size of the messages received from or sent to another BBS and the efficiency in Bits/s (Max 1200 !).
119
The BBS's are sorted by alphanumeric order, and the efficiency indication appears for callsigns having conducted only forwarding operations. This matrix will not appear unless there has been at least one BBS forwarded. - A matrix of the main functions utilized, with on the y-axix the callsigns sorted by alphabetical order, and on the x-axis the total time of connections in minutes, the number of connections, and the various functions used (see the comment following the array). In the LOG.T file, the X.F column (forced disconnection entered by the Sysop) is replaced by the number of killing commands. At the end of each column is the compound sum. Log of a specific station. - The LOGCALL program yields generation of a log for a specific station The principle of operation is the same as for LOGSTAT, except that a supplementary calling parameter is required to define the station. LOGCALL FBBLOG.33 FE1ZZZ The generated file will be of the same format as the FBBLOG, but it will enclose only the lines specific to the callsign. The name of the file will match the format FE1ZZZ.LOG, if the requested callsign is FE1ZZZ. While executing LOGSTAT FE1ZZZ.LOG, you will have the statistics related to that station (in the LOG.A, LOG.B, ...). If you specify the SSID, you will create a log corresponding only to the callsign and the specified SSID. Ex: LOGCALL FBBLOG.33 FE1ZZZ-2 Editing the file FE1ZZZ.LOG will allow you to display all the commands sent by that station. 12.5 SATUPDAT.EXE SATUPDAT.EXE will read messages from AMSAT copied via packet radio. This is the english version of AJOURSAT.EXE. This software was developed by F6BVP. It extracts keplerian elements both in NASA and AMSAT formats and updates the results into the satellites data base of the F6FBB's BBS (SATEL.DAT) Loading SATUPDAT without arguments will print the following message on your screen (between lines -----): ----------------------------------------------------------------------------------------Automatic update of satellites orbital parameters for F6FBB's bbs Version 1.77e - June 1991 - Bernard Pidoux, F6BVP
120
Usage: SATUPDAT [file name] Reading option: /a AMSAT format (default) /n NASA format Update option: /f merging new and old data (default) /u update only satellites present in the data base /s keep only satellites present in the input file -----------------------------------------------------------------This version 1.77e verifies checksum both for AMSAT files and NASA files. For automatic update of keplerian elements into F6FBB's bbs just create a virtu al BBS into BBS.SYS file. Its name could be AMSAT for example. Then declare the following forward in the file FORWARD.SYS : A AMSAT * G AMSAT P@ C C:\FBB\SYSTEM\SAT\AMSAT.TXT * -----CAUTION: The name of the disk unit and the path name should be the exact one of your configuration. In order to run automatically SATUPDAT when your computer boots, you must modify the batch file like the following example: In WinFBB (file RUNFBB.BAT): maint ********************** START of MAINT script ************************** cd %fbb% @echo off cd %fbb%\system\sat if not exist amsat.txt goto amsatend satupdat amsat.txt /n > satupdat.res satupdat amsat.txt >> satupdat.res del amsat.txt :amsatend cls echo cd %fbb% 121
In LinFBB : (There is no SATUPDAT for LinFBB yet) In DosFBB (file APPEL.BAT): :direct if not exist c:\fbb\system\sat\amsat.txt goto appel cd \fbb\system\sat satupdat amsat /n > satupdat.res satupdat amsat >> satupdat.res del amsat.txt cd \fbb :appel echo Running the BBS ^C for stopping sleep 3 serv -t if errorlevel 2 goto direct if errorlevel 1 goto suite :suite (Once again be careful with the disk name and directories !) SATUPDAT OPTIONS: The default extension for input file is .TXT, however you can specify another extension. Both arguments after the filename in the command line are optional: the first one indicates the reading format, either the AMSAT format or the NASA "2-line" format. The first one is selected by default. The second option is for the choice of update mode. By default the program will merge the old list with the new one (same if you select option /f). Old data of satellites which are not present in the input file are kept as is and the other one are updated. Option /u can be selected if you don't want to add new satellites to the one already present. Only keplerian elements from known satellites are updated. This prevents the list to grow with incoming satellites that you are not eventually interested in. Option /s, on the contrary, gives you the possibility to keep only in the data base the data from the satellites whose name is in the input file. This can help you to suppress old satellites from the data base. In all cases the program takes care of the permanent data of satellites such as the frequency (for doppler) and the step for computing the tracking (you must provide both manually only the first time). If the keplerian elements of the input file are older than the one already present in the BBS data base, the old one are kept. 122
The list is sorted by name in order to help the finding of the satellite name when someone is connected to the BBS. If elements for one satellite are duplicated in the input file, the program will look again for the newest data. Of course, if CRC computed by the program is not the same as the one in the input file, the program informs you that the CRC is BAD and it does not take the keplerian elements. In the batch file example given above you have certainly noticed that I call twice the program SATUPDAT with two different format arguments. The first time I ask the program to read the NASA format and the second time to read the default format AMSAT. The reason is that the probability for an error to occur in both formats for the same satellite is very small. Thus if an error occurs in one format the program will complete the update when he will found unaffected keplerian elements in the other format. Thanks to the recently adopted checksum by AMSAT! 12.6 SLEEP.COM Utility which spends the time (in seconds specified as argument) while doing nothing. It can be interrupted by a Ctrl-C, and allows interruption of a Batch file running. The syntax to call it is of the type : SLEEP nn nn is the number of seconds to wait. 12.7 MAKEPG.COM Utility used to generate .EXE (or .COM) program file out of the binary file (xxx.BIN) using English or French language. This program may not be used in some versions of FBB software !!! This program needs a .BIN-file (like WFBB.BIN) to convert to an .EXE or .COM file. If a BIN-file does not exist, the program will only be in english version (as a .COM or .EXE file). The syntax is of the type: MAKEPG program FR To generate a program in French MAKEPG program GB To generate a program in English. MAKEPG can transform the following programs: SERV.BIN -> SERV.EXE MAINTINF.BIN -> MAINTINF.COM 123
EPURMESS.BIN EPURWP.BIN
-> EPURMESS.COM -> EPURWP.COM
12.8 SETUSER.COM Utility giving the property of a file to a user for further use by FBBDOS. The syntax is of the type: SETUSER callsign filename. The command "SETUSER F6FBB TOTO" will allow F6FBB, and him only, to modify or delete the file TOTO. 12.9 CLEANUP.COM Utility killing all messages files unused and not defined in DIRMES.SYS. This program should be run in the SYSTEM directory. The syntax is of the type : CLEANUP mail_directory Be careful when using this utility. If another directory than MAIL or BINMAIL is specified, it should delete all the files of the directory. 12.10 MAINTINF.COM Utility maintaining the INF.SYS file. The INF.SYS file holds the users' database. In case of problem in INF.SYS file, goto the SYSTEM directory and run MAINTINF followed by a number of months. The records of users not connected within this number of months will be deleted and these users will be asked as for a new connection. The number 0 will not delete any record and only check the INF.SYS file. 12.11 CUT.COM Utility allowing to peak a part of a file and copy or append it to another file. The format is: CUT From-file To-file length offset [/A] To-file will have added up to length bytes of From-file, starting at offset. If the switch /A is specified, then data will be appended to To-file, otherwise To-file will be replaced. This small utility is useful to take parts or file, or to do copy/paste with either binary nor files.
124
Together with the specification of the offset in the XGET command, in case of crash, first note the amount of data already received (ie : 50300), save the part of the file already received, and then ask "XGET filename 50000". The transfer will start at offset 50000 and then you will be able to receive the end of the file. The paste the two parts, either with COPY command or with the CUT command. It is more secure to cut the first received part before as the last bytes should be garbaged. 12.12 FV.COM FV.COM is a small program used by the BBS when a user sends the "View (filename)" command. View contents of ARC, DWC, LBR, LZH, PAK, ZIP, ZOO files. Usage: FV [d:][\path\]filespec[.ext] [specs] [/p] [/b] [/w] [/r] [/c] [/x] Where: /P pauses after each full screen /B suppresses display of d:\path /W for wide display /R update file date /C displays comments /X convert sfx to archive 12.13 ISDAY.COM ISDAY is a small program to use if you want some program to run only on specific days. Format : ISDAY [/Nmday] [/Dday] [/Mmonth] [/H] mday = day of the month, 1 to 31 day = day in the week, 0=sunday .. 6=saturday month = month in the year, 1=january .. 12=december All parameters are anded. Each parameter can be specified as a value, or as an interval like "1,3,12-22", that is the first, third and 12th to 22nd ISDAY exits with ERRORLEVEL 0 if parameters match else with ERRORLEVEL 1 Example: ISDAY /D0-2 IF ERRORLEVEL 1 GOTO LABEL PROGRAM TO RUN ON SUNDAYS, MONDAYS and TUESDAYS :LABEL ... 12.14 CLR_USER.COM
125
Small program to clear all users's amount of downloaded kb. This is used to "reset" all users, so they will again be able to download the full quota of kilobytes from the BBS. 12.15 FBB_ZM (Only for LinFBB) Documentation for FBB_ZM This utility is for sending and receiving files with ZMODEM , YMODEM or XMODEM protocol. Receive file(s): fbb_zm [ rz | rb | rx ] where: rz = Receive file with ZMODEM rb = Receive file with YMODEM rx = Receive file with XMODEM Sending file(s): fbb_zm [ sz | sb | sx ] file(s)... where: sz = Send file with ZMODEM sb = Send file with YMODEM sx = Send file with XMODEM 12.16 XFBBC XFBBC is a tool that allows to talk with LinFBB daemon. Main features are: - remote connection to the xfbbd console - remote display of the traffic - remote display of the monitoring The command line is: xfbbC [-c | -m channel] [-h hostname] [-p port] [-i mycall] [-w password] without parameter, xfbbC defaults to "xfbbC -m 0" Command line options: -c : console connection. In this case, a callsign and a password must be provided. To provide them, you can use either command line options or environment variables. -m channel : monitoring request. channel may be 126
* 0 : traffic activity of all channels is displayed. * n : traffic activity of the channel "n" is displayed * -1 : monitoring of all ports -h : hostname of xfbbd (default localhost) -p : socket port for the communication to xfbbd (default 1525) -i : callsign for the console connection -w : password for the console connection. The password must be the exact string corresponding to the callsign as defined in the passwd.sys file of xfbbd. some environment variables may default the command lines options: -h -p -i -w
: XFBBC_HOST : XFBBC_PORT : XFBBC_CALL : XFBBC_PASS
12.17 FBB_VIEW (Only LinFBB) FBB_VIEW is a small program used by the BBS when a user sends the "View (filename)" command. View contents of ARC, DWC, LBR, LZH, PAK, ZIP, ZOO files. VIEW command of LINUX version calls fbb_view program (or any program defined by the variable $FBB_VIEW). fbb_view may be a shell script. 13 ASYNC PORT DRIVERS AND TELEPHONE MODEM You may need several external drivers for your BBS. For WinFBB: FBBCOMM.DRV BPQ For LinFBB: AF_AX25 domain socket AF_NETROM domain socket AF_ROSE domain socket 127
It is necessary to compile the Linux Kernel with SLIP (serial line). For DosFBB: ESS.COM ESSKAM.COM FBBIOS.COM BPQ TFPCX/TFPCR Installation of a TELEPHONE MODEM. 13.1 FBBCOMM.DRV FBBCOMM.DRV: (Only for WinFBB) The port-driver FBBCOMM.DRV is installed in Windows during the installation-process of WinFBB. FBBCOMM.DRV is automatically installed in your Windows as you install WinFBB from the diskette. So there is nothing for you to do. The driver is automatically installed into your SYSTEM.INI in the [boot] section as comm.drv=fbbcomm.drv. If in doubt, you may want to check this. 13.2 ESS.COM ESS.COM: (Only for DosFBB) ESS is an async port driver optimized for FBB software. It can drive either TNC2/PK232/clones or KAM. This small device driver is loaded as resident at the beginning of the machine initialization (TSR). One ESS handles one serial line and makes use of one IRQ. The COM number, the address of the serial interface and the IRQ number are given as parameters appended to the command line. The address should be given as a FOUR digit hex number. Example : Install ESS for COM1 at hex 03F8 and using IRQ 4: ESS 1 03F8 4 If only the COM number is specified, the address and the IRQ will default to the standard DOS value. Thus ESS 1 would have had the same effect than the example. Any address or IRQ number can be specified. Carefully check that the address and the IRQ number match the board you intend to use, special attention should be given to the IRQ number which should not already be used by another peripheral device in the machine. On a PC the IRQ's can not usually be shared.
128
Should there be more than one port to handle, several ESS can be cascaded. The IRQ should be different for each ESS, except for the case in which the interrupt sharing is supported by the serial card used. Example : ESS 1 03F8 4 ESS 2 02F8 3 This sequence will load ESS's for COM1 and COM2. ESS accommodates also the muxing arrangement of serial ports. Version 1.08 of ESS-driver (included with DosFBB distribution) must be used with the MUX ! 13.3 ESSKAM.COM ESSKAM.COM:
(Only for DosFBB)
ESSKAM works exactly as ESS.COM, but only for Kantronics Kam TNCs. 13.4 FBBIOS.COM FBBIOS.COM:
(Only for DosFBB)
FBBIOS is a serial line driver dedicated to the usage of a PSTN modem. Binary as well as file transfer are supported with the XMODEM protocol. FBBIOS handles one serial line, one IRQ is required. The COM number, the address of the serial interface and the IRQ number are given as parameters appended to the command line, the address should be specified in FOUR hex digits. Example : Install FBBIOS for COM1 at hex 03F8 and using IRQ 4: FBBIOS 1 03F8 4 If only the COM number is specified, the address and the IRQ will default to the standard DOS value. Thus FBBIOS 1 would have had the same effect than the example. Any address or IRQ number can be specified. Carefully check that the address and the IRQ number match the board you intend to use, special attention should be given to the IRQ number which should not already be used by another peripheral device. On a PC the IRQ's can not usually be shared. If the modem in use is at the HAYES standard, FBBIOS can modify the line speed according to the one of the incoming call connection. In this case the parameter 'A' should be appended to the command line to activate this feature. This is not true with some buffered modems using a junction 129
with a settled speed. Example : FBBIOS 1 03F8 4 A Upon receipt of the string CONNECT 1200 or CONNECT 2400, the driver will adjust its speed to the incoming call. From version 1.30, FBBIOS.COM can run up to 56 KBauds. Be sure that your computer is fast enough ! 14 SERVERS The BBS software offers various servers which are triggered when machinable messages are received. The number of offered servers is is without limit. The servers are activated when receiving a message whose destination had been given at the end of the INIT.SRV file. Declaration of servers at the end of INIT.SRV: -----# # List of servers : # # Destination Name of program # REQDIR REQDIR.COM REQFIL REQFIL.COM NEWDOC NEWDOC.EXE # # End of file INIT.SRV # Servers are exec programs whose behavior is explained in appendix 9. They should be found in the directory containing the exec program SERV.EXE and the configuration file INIT.SRV. When a private message is received, whose destination is defined in the INIT.SRV file, the corresponding program to the destination is called with the name of a temporary file on the command line. This temporary file contains a message function of the requested server (see description of servers below). At the completion of the server program, the incoming mail file is checked to import an answer, should there be one. The message addressed to the server and the temporary file are erased after this processing. Various services can be developed, time available has its limits, but the imagination has not! REQDIR REQFIL
: Request directory-listing from a BBS's files-area. : Request an -file from a remote BBS. 130
NEWDOC REQCFG MULTI
: Update DOC-area of the BBS. : Request a list of the BBS's configuration. : Send multiple identical messages to different addressees.
14.1 REQDIR server The REQDIR server sends back to origin of the special message the list of files (total or partial) of a directory. The standard command line of the message is used. The message should be of the private type and addressed to the BBS that we want to ask : SP REQDIR @ bbs-destination The title of the message contains two information, the mask of the selection (*.EXE, *.*, etc...) and the @ sign followed the return bbs, that is to say yours. The return message will be addressed to the sender of the request via the return BBS. The mask can not be specified. In this case, all the files will be listed. Mask @ bbs-return SP REQDIR @ F6ABJ.FRA.EU Title of message : YAPP\*.ZIP @ F6FBB.FMLR.FRA.EU Text of message : /EX We assume with this example that YAPP is a sub-directory of the USERS directory (this a suggested configuration). 14.2 REQFIL server REQFIL server allows to send back the file requested to the originator of the message. The message sent to REQFIL has a well defined syntax. The standard command line of message is utilized. The message should be of the private type and addressed to the BBS which we want to ask. SP REQFIL @ bbs-destination The title of the message contains two information, the name of the requested file and the @ sign followed by the return BBS, that is to say yours. The return message will be addressed to the originator of the request to the return bbs. filename @ bbs-return 131
The text of the message is not necessary, its content will not be taken into account by the service. Example : F6FBB BBS > SP REQFIL @ F6ABJ.FRA.EU Title of message : DEMOS\ESSAI.TXT @ F6FBB.FMLR.FRA.EU Text of message : /EX This example makes the assumption that DEMOS is a sub-directory of the USERS directory. The answer of the remote mailbox will be of the form : SP F6FBB @ F6FBB.FMLR.FRA.EU < F6ABJ Req File: DEMOS/ESSAI.TXT Contents of ESSAI.TXT file ... /EX 14.3 NEWDOC server The NEWDOC server allows a simple and fast update of the documentation database (topic DOCS of the server). This server will create the file and will give it a label. It will not create a directory if it doesn't exist. Therefore it is necessary to prepare the directory tree structure before. A message will give a summary to the originator. The standard command line for messages is used. The message should be of type private and addressed to the BBS which will be updated. SP NEWDOC @ bbs-destination The message title contains two information , the name of the file requested followed by the label to give to the file (see the description of the topics DOCS). Filename Label eventually on several words. The text of the message will be transferred in the documentation file. Example: F6FBB BBS > SP NEWDOC @ F6ABJ.FRA.EU Title of message : BBS\DOC_1.DOC This is the label of the documentation. 132
Text of message : This is the content of the documentation. .... End of documentation. /EX This example assumes that the BBS is a subdirectory of DOCS, thus one of the topics of the documentation. If the NEWDOC.SYS file is specified, the server will be limited to the callsigns declared in this file, one callsign in each line. Example of NEWDOC.SYS file: F6FBB FD1CDC 14.4 REQCFG server REQCFG server allows to send back the current configuration of the software. The message sent to REQCFG has a well defined syntax. The text of the message is not used. The message should be of the private type and addressed to the BBS which we want to ask. SP REQCFG @ bbs-destination The title of the message contains the @ sign followed by the return BBS, that is to say yours. The return message will be addressed to the originator of the request to the return bbs. @ bbs-return The text of the message is not necessary, its content will not be taken into account by the service. Example: F6FBB BBS > SP REQCFG @ FD1CDC.FMLR.FRA.EU Title of message : @ F6FBB.FMLR.FRA.EU Text of message : /EX The answer of the remote mailbox will be of the form: SP F6FBB @ F6FBB.FMLR.FRA.EU < F6ABJ ReqCfg V 1.2 (C) F6FBB 1992 - BBS F6FBB Software F6FBB Version 5.15 compiled on Feb 07 1993 Mem Us:14620 Mem Ok:148288 Bid:30000 Ports:4 Ch:12 FBB Ok BIN Ok 133
Available volumes : C: D: E: EMS V4.0 MSG BID HIE FWD REJ OVR SCR WPG Total
: 29 pages (464 KB) : 17 pages (272 KB) : No : 1 pages ( 16 KB) : 1 pages ( 16 KB) : 11 pages (176 KB) : 45 pages (720 KB) : 5 pages ( 80 KB) : 109 pages (1744 KB)
Languages 1 : ENGLISH 2 : FRANCAIS 3 : ESPAGNOL 4 : ITALIANO 5 : NEDERLAN 6 : DEUTSCH 7 : CATALA 8 : NORSK 9 : PORTUGUE 10 : DANSK 11 : SVENSK 12 : HRVATSKI 13 : FRANC8 Servers REQDIR REQFIL NEWDOC REQCFG AUTO7P 7PSERV MULTI Port 1 2 3 4
: Request of directory-listings : Request of files : Add to documentation : Request configuration from BBS : 7plus server : Server for 7PLUS files : Multi-addresses
Interface DRSI ESS/COM FBBIOS ESS/COM
Emulat. WA8DED KAM FBBIOS KAM
Ch 9 1 1 1
Mode UYWL GYW UYM GYW
Frequency NODE 15M/20M MODEM HF-PSK
134
14.5 MULTI server MULTI.EXE, server for FBB-BBS. (By LA6CU, Per) This server is used to send personal copies of special messages. The original is addressed to a special "call", and then there is automatically made personal copies to everyone that shall have one. MULTI may work in 2 ways. You may use one of them, or both. I use both at the same time. New in version 3.00: The server may use different languages. There is a new file MULTI.TXT (reside in SYSTEMdirectory) that holds all languages. There is one "module" for each language. See the text in MULTI.TXT for more info. 1: WITH DAT-FILES Installation: MULTI.EXE is put in the same directory as SERV.EXE. MULTI will read from INIT.SRV... In INIT.SRV, MULTI is included together with REQFIL, REQDIR etc. Example: # -----# REQFIL REQFIL REQDIR REQDIR CLUB MULTI TEST MULTI # In this example all messages sent to SP CLUB will be copied to all callsigns in the file CLUB.DAT, while messages sent to SP TEST will be copied to all callsigns in the file TEST.DAT. CLUB.DAT and TEST.DAT (in this example) must stay in the FBB-directory. You must make one such .DAT-file for every to-field you define in INIT.SRV. The .DAT-files must consist of callsigns (@BBS and H-addresses allowed) for all those that shall have a copy. There are 4 different copy-types. A (action) : This is the callsign that will receive the message, or perform the action described in the message. C (copy) : This callsign receives a copy of the message. I (information) : This callsign receives a copy for information. 135
H (hidden)
: This callsign receives a copy, but his callsign will not appear in the footnotes of the message, telling who has received a copy.
There may be more than one callsign on each line (starting with A, I, C or H) separated by a comma. There may be maximum 100 callsigns altogether. Comment-lines are extras, they MUST start with a # From version 3.00 there will also be a separate line with a letter corresponding to the language the server will use. What letter corresponds to what language, is explained in MULTI.TXT. Example of CLUB.DAT: E A LA6CU, LA1B, LA2D A LA6GDA I LA5RBA C LA6IM @ LA6IM H LA2GIA
62897 V:F1EBV [872] 043005485816MF 62897 V:F1EBV [872] 043005510701M> 62898 V:F1EBV [815] 043005514516MF 62898 V:F1EBV [815] 043005522901M> 62901 V:F1EBV [398] 043005530516MN B:26051_FC1HAQ V:F1EBV 043005530616MF 62901 V:F1EBV [398] 043005533313MW 64084B F:DF9WM T:ALL@EU [1161] S:Address Needed 043005572701M> 62931 V:F1EBV [2728] 043005580113XD 043005584516MF 62931 V:F1EBV [2728] 043006003012CB F6CDD-1 043006211401XT 043006303216CC FC1HAQ-1 VIA F6FBB-8,019101 043006323016MF 64081 V:FC1HAQ [281] 147
043006340716MF 64082 V:FC1HAQ [830] 043006354116M< 64086B F:DK3GI T:DXNEWS@EU [953] S:BY4AA in RTTY 043006443216M< 64089B F:OZ2FAR T:ALL@WW [1895] S:re qrt 043006452112CB F6CDD-1 043006465112MF 64086 V:F6CDD [953] 043006465212MF 64087 V:F6CDD [2632] 043006465312MF 64088 V:F6CDD [1626] 043006465312MF 64089 V:F6CDD [1895] 043006465412XB 043006474016M< 64090B F:VS6XQF T:ALL@WW [1748] S:CRY FOR TR-9500 043006490316M< 64091B F:DJ0AW T:ALL@WW [972] S:mfj-1278 043006534816M< 64092B F:DB2OS T:KEPLER@WW [3684] S:Elements 118. 043007002612CB F6CDD-1 043007005516M< 64095B F:VK5CGB T:ALL@WW [1166] S:RNARS PACKET 043007022116M< 64096B F:DF7MX T:COMMOD@EU [913] S:SUPPORT 043007034316M< 64097B F:I1ZEU T:ALL@EU [1096] S:ID1V 043007065416SQ *** BBS Quit All Xx lines in log are disconnections (eXit) XI Invalid callsign XE Excluded callsign XB is normal disconnection by the BBS (after a B command for instance) XT Time-out disconnection XF Forced disconnection (after a XI or XE) XM Too many errors XP Password error (modem) 16.8 nnnnn.SAT nnnnn.SAT (\FBB\SYSTEM\SAT) (Satellite characteristics). The nnnnn.SAT files (where nnnnn is the NASA catalog number for the satellite) will be displayed when the command C will be typed from the satellite menu. They are text files and are located in the SAT subdirectory. 16.9 NEWDOC.SYS NEWDOC.SYS (\FBB\SYSTEM) The NEWDOC server allows a simple and fast update of the documentation database (topic DOCS of the server). This server will create the file and will give it a label. It will not create a directory if it doesn't exist. Therefore it is necessary to prepare the directory tree structure before. A message will give a summary to the originator.
148
The standard command line for messages is used. The message should be of type private and addressed to the BBS which will be updated. SP NEWDOC @ bbs-destination The message title contains two information , the name of the file requested followed by the label to give to the file (see the description of the topics DOCS). Filename Label eventually on several words. The text of the message will be transferred in the documentation file. Example : F6FBB BBS > SP NEWDOC @ F6ABJ.FRA.EU Title of message : BBS\DOC_1.DOC This is the label of the documentation. Text of message : This is the content of the documentation. .... End of documentation. /EX This example assumes that the BBS is a subdirectory of DOCS, thus one of the topics of the documentation. If the NEWDOC.SYS file is specified, the server will be limited to the callsigns declared in this file, one callsign in each line. Example of NEWDOC.SYS file : F6FBB FD1CDC 16.10 GATEWAY.SYS This file may be used to configure the gateway of the BBS. Specially handy for Pactor use. # # GATEWAY CONFIGURATION # # Accept the following commands: # IF / ELSE / ENDIF # BEGIN : Command (sent) executed when entering the gateway port # END : Command (sent) executed when leaving the gateway port # FREQ : Affectation of a frequency / TNC command # # This only applies to the port named Pactor in PORT.SYS # 149
IF P Pactor # # Stop scanning when entering the gateway BEGIN X PTCTRX SCAN 0 # # Between 8:00 and 20:00 # IF H 7-20 # # Between 7:00 and 20:59 (day) # # default frequency BEGIN X PTCTRX F 14075 # # List of the frequencies displayed with command 'F' FREQ 1 14070 PTCTRX F 14070 FREQ 2 14071 PTCTRX F 14071 FREQ 3 14072 PTCTRX F 14072 FREQ 4 14073 PTCTRX F 14073 FREQ 5 14074 PTCTRX F 14074 FREQ 6 14075 PTCTRX F 14075 FREQ 7 14076 PTCTRX F 14076 FREQ 8 14077 PTCTRX F 14077 FREQ 9 14078 PTCTRX F 14078 FREQ 10 14079 PTCTRX F 14079 FREQ 11 14080 PTCTRX F 14080 FREQ 12 14081 PTCTRX F 14081 FREQ 13 14082 PTCTRX F 14082 FREQ 14 14083 PTCTRX F 14083 FREQ 15 14084 PTCTRX F 14084 FREQ 16 14085 PTCTRX F 14085 FREQ 17 14086 PTCTRX F 14086 FREQ 18 14087 PTCTRX F 14087 FREQ 19 14088 PTCTRX F 14088 FREQ 20 14089 PTCTRX F 14089 FREQ 21 21078 PTCTRX F 21078 FREQ 22 21084 PTCTRX F 21084 # # ELSE # # Between 0:00 and 6:59 and after 21:00 (night) # # default frequency BEGIN X PTCTRX F 3582 # # List of the frequencies displayed with command 'F' FREQ 1 3582 PTCTRX F 3582 FREQ 2 3583 PTCTRX F 3583 # 150
# ENDIF # # Restart scanning when leaving the gateway # STOP X PTCTRX SCAN 1 # ENDIF # # End of GATEWAY.SYS file # 17.1 STATIS.DAT STATIS.DAT (\FBB\SYSTEM) This binary file holds the information on all connections. This file is very important and must not be edited or changed otherwise the list of the connections could be lost. This file can only be opened for reading. It is organized with records, each record containing information on a connection. Never modify this file while the BBS is running. Structure of one record (C language) : typedef struct { char indcnx[7] char port long datcnx int tpscnx } statis
; ; ; ;
/* 7 /* 1 /* 4 /* 2
Callsign (Port x 32) + channel Date of the connection duration of the connection
; /* 14 bytes = length of one record
*/ */ */ */ */
Date is given as the number of seconds since January 1st, 1970 00:00. In C language, all strings are ended with a NULL (00 hex) character. 17.2 OPTIONS.SYS OPTIONS.SYS (\FBB\SYSTEM) This file holds the different options of the software. Each option is defined as an integer (2 bytes). struct { int beep int ok_chat
; /* 2 Connection beep validated ; /* 2 T command allowed
*/ */ 151
int ok_disp int separe int split int gate int justif int upd_fwd int sed
; /* 2 ; /* 2 ; /* 2 ; /* 2 ; /* 2 ; /* 2 ; /* 2
Indication of channels Position of the split line DOS screen is splitted Gateway validated Justification validated Message list is being rescanned Internal screen editor validated
*/ */ */ */ */ */ */
}; 17.3 DIRMES.SYS DIRMES.SYS (\FBB\SYSTEM) This binary file holds the information on all active messages. This file is very important and must not be edited or changed otherwise the list of the messages could be lost. This file can only be opened for reading. It is organized with records, each record containing information on a message. The first record of the file only contains the number of the last message. Never modify this file while the BBS is running. Structure of one record (C language) : #define NBBBS 80 #define NBMASK NBBBS/8 typedef struct { char type char status long numero long taille long date char bbsf[7] char bbsv[41] char exped[7] char desti[7] char bid[13] char titre[61] char free[16] long datesd long datech char fbbs[NBMASK] char forw[NBMASK] } bullist
; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ;
/* 1 Type of message (A,B,P,T) /* 1 Status of message ($,A,F,K,N,Y) /* 4 Number of the message /* 4 Size of message in characters /* 4 Date of message /* 7 Adjacent BBS giving the message /* 41 Route /* 7 Destination of the message /* 7 To field /* 13 BID or MID /* 61 Title of message /* 16 Reserved bytes /* 4 Date of the message creation /* 4 Date of last status change /* 10 Mask of BBSes to forward to /* 10 Mask of BBSes already forwarded
; /* 194 bytes = length of one record
*/ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */
A null type of message (00 hex) invalidates the record. 152
Dates are given as the number of seconds since January 1st, 1970 00:00. Masks are bit fields, number of bit corresponds to the number of the BBS in the BBS.SYS file. In C language, all strings are ended with a NULL (00 hex) character. 17.4 TPSTAT.SYS TPSTAT.SYS (\FBB\SYSTEM) This file holds the statistics of the rubrics. Deleting it will restart these statistics from scratch. Do not delete the file while the BBS is running. You will be prompted to create it when booting the software. The file is organized as 21 records. Each record is a long integer holding the number of seconds used for the current record. Each record correspond to the level (first number of the three numbers of the status bar). record 0 record 1 record 2 record 3 record 4 record 5 record 6 record 7 record 8 record 9 record 10 record 11 record 12 record 13 record 14 record 15 record 16 record 17 record 18 record 19 record 20
: Server menu : Message (sending or receiving) : Qra locator : Statistics : Documentations : Nomenclature : Trajectography : Unused : Sending bin message : FbbDOS menu : Gateway : Modem : Binary transfer : X forwarding : Mailbox usage : Forwarding : Console chat : YAPP : Conference : Editor : Themas area
17.5 WFBID.SYS WFBID.SYS (\FBB\SYSTEM) This binary file holds the last received BIDs. The number of records of this file is defined in the INIT.SRV file. This file is very important and must not be edited or changed otherwise the list of 153
the messages could be lost. This file can only be opened for reading. It is organized with records, each record containing information on a BID. This is a circular file and the first record of the file contains the pointer of the last overwritten record in the msg_number field. Never modify this file while the BBS is running. Structure of one record (C language) : typedef struct { char mode ; /* 1 Type of message (A,B,P,T) char fbid[13] ; /* 13 BID of the message long msg_number ; /* 4 Number of the message } bidfwd
; /* 18 bytes = length of one record
*/ */ */ */
In C language, all strings are ended with a NULL (00 hex) character. 17.6 INF.SYS INF.SYS file (\FBB\SYSTEM) This binary file holds the information on all users of the BBS. This file is very important and must not be edited or changed otherwise the list of the users could be lost. This file can only be opened for reading. It is organized with records, each record containing information on a user. Never modify this file while the BBS is running. Structure of one record (C language) : #define uchar unsigned char typedef struct { char callsign[7] char ssid } indicat
/* Callsign structure used in info */ ; ; ;
typedef struct { indicat indic indicat relai[8] long lastmes long nbcon long hcon long lastyap unsigned flags unsigned on_base
; ; ; ; ; ; ; ;
/* 8 Callsign /* 64 Digis path /* 4 Last L number /* 4 Number of connexions /* 4 Last connexion date /* 4 Last YN date /* 2 Flags /* 2 ON Base number
*/ */ */ */ */ */ */ */ 154
uchar uchar long ushort char char char char char char char char char char char char char char } info
nbl lang newbanner download free[20] thema nom[18] prenom[13] adres[61] ville[31] teld[13] telp[13] home[41] qra[7] priv[13] filtre[7] pass[13] zip[9]
; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ;
/* 1 Lines paging /* 1 Language /* 4 Date of new banner (lang.NEW) /* 2 Download size in KB /* 20 Reserved /* 1 Current thema selection /* 18 1st Name /* 13 Christian name /* 61 Address /* 31 City /* 13 home phone /* 13 job phone /* 41 home BBS /* 7 Qth Locator /* 13 PRIV directory /* 7 LC choice filter /* 13 Password /* 9 Zipcode
; /* 360 bytes = lenght of one record
*/ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */
Dates are given as the number of seconds since January 1st, 1970 00:00. In C language, all strings are ended with a NULL (00 hex) character. 17.7 YAPPLBL.DAT YAPPLBL.DAT (\FBB\SYSTEM) This is a binary file which holds the informations of the FbbDOS files. Do not edit or change this file, otherwise files of FbbDOS could be hidden or lost. #define LABEL_FIC 80 #define LABEL_NOM 40 #define LABEL_OWN 8 typedef struct { char nomfic[LABEL_FIC] char label[LABEL_NOM] char owner[LABEL_OWN] long index long date_creation char free[24] } Rlabel ; /* 160 bytes */
; /* 80 Filename (virtual path of FBB) ; /* 40 Label of the file ; /* 8 Callsign of the owner (no SSID) ; /* 4 Number of uploaded file (from 1) ; /* 4 date of the file creation ; /* 24 unused (padded with NULL)
*/ */ */ */ */ */
155
17.8 SATEL.DAT SATEL.DAT file (\FBB\SYSTEM\SAT) This binary file holds the information on the satellite data base of the BBS. This file is very important and must not be edited or changed otherwise the list of the satellites could be lost. This file can only be opened for reading. It is organized with records, each record containing information on a satellite. Never modify this file while the BBS is running. Structure of one record (C language) : typedef struct { char sat_name[18] int year double day int month int hour int minute int second double inclination double raan double eccentricity double a_perigee double mean_anomaly double a double mean_motion double dec_rate long revolution double frequency double v int step long last_upd long catalog int free[4] } satel
; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ;
/* 18 Name of the satellite /* 2 Year of reference /* 8 Day of reference /* 2 Month of reference /* 2 Hour of reference /* 2 Minute of reference /* 2 Second of reference /* 8 Inclination /* 8 R.A.A.N. /* 8 Eccentricity /* 8 Argument of perigee /* 8 Mean anomaly /* 8 must be 0.0 /* 8 mean motion /* 8 Decay rate /* 4 Epoch revolution /* 8 Frequency for doppler computing /* 8 must be 0.0 /* 2 Step of processing (minutes) /* 4 Date of last update /* 4 NASA Catalog Number /* 8 Unused
; /* 138 bytes : length of one record
*/ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */
In C language, all strings are ended with a NULL (00 hex) character. 17.9 WP.SYS WP.SYS file (\FBB\SYSTEM\WP) The WP.SYS file is composed of records. Each record is 194 bytes long. typedef struct { 156
char callsign[7] char name[13] char free char changed ushort seen long activ_date long temp_date char activ_homebbs[41] char temp_homebbs[41] char activ_zip[9] char temp_zip[9] char activ_qth[31] char temp_qth[31] } Wps;
; ; ; ; ; ; ; ; ; ; ; ; ;
// Callsign of the record // Name of the user // Unused // Flag (U, G, I) of modification // Number of updates // Date of active part // Date of temp part // Home BBS in active part // Home BBS in temp part // Zip code in active part // Zip code in temp part // Qth in active part // Qth in temp part
In C language, all strings are ended with a NULL (00 hex) character. This file should NOT be modified while the BBS software is running ! 17.10 MESS.WP MESS.WP file (\FBB\SYSTEM\WP). The MESS.WP file is an file composed of standard WP update lines. It has no size limit and will be sent as messages to the different routes defined for WP updates in INIT.SRV. The outgoing messages will be truncated to 5Kb sections if required. This file is read at the end of the BBS start-up. 18 APPENDIX APPENDIX 1 : EDIT Commands APPENDIX 2 : PK232 Host-Mode APPENDIX 3 : G8BPQ interface APPENDIX 4 : Kantronics KAM APPENDIX 5 : DRSI-card APPENDIX 6 : PROCESS NUMBERS AND HELP APPENDIX 7 : RECORDING A MESSAGE APPENDIX 8 : TRICKS AND TIPS APPENDIX 9 : FBB FORWARD PROTOCOLE APPENDIX 10: COMPRESSED FORWARDING APPENDIX 11: FORMAT OF ACK MESSAGES APPENDIX 12: REPLACEMENT CHARACTERS OR WILDCARDS APPENDIX 13: PROGRAMMING TECHNICS FOR SERVERS APPENDIX 14: CONTENTS OF THE DIRECTORIES APPENDIX 15: CONNECTION FILTERING APPENDIX 16: MESSAGE FILTERING APPENDIX 17: PG PROGRAMS DEVELOPMENT 157
APPENDIX 18: UNPROTO MESSAGE LISTS APPENDIX 19: EXTENSIONS TO THE YAPP PROTOCOLE APPENDIX 20: Telephone modem APPENDIX 21: File filtering APPENDIX 22: MAIL.IN (import messages directly) APPENDIX 23: Installation-help for LinFBB APPENDIX 24: TELNET installation for LinFBB and WinFBB APPENDIX 25: TFPCX / TFPCR / TFKISS (Hostmode KISS-driver) APPENDIX 26: EMS/XMS memory. APPENDIX 27: Using FBB with PE1CHL NET and the BPQ Hostmode Emulator APPENDIX 28: Conference-mode APPENDIX 29: Gateway-mode APPENDIX 30: TFWIN.DLL Kiss-interface for WinFBB32 APPENDIX 31: LOCK-files. APPENDIX 32: PTC-II Pactor TNC 18.1 APPENDIX 1: How to use the line-editor The FBBDOS offers a small line editor allowing the process of files. It can help the remote Sysop to maintain the system files of the software. The commands are straightforward, and for better efficiency, they can be chained on a single line. Here are the available commands: ? : Shows all commands that can be used in the editor. A : Adds a line after the current line. The text for the new line shall follow the letter A. If more commands are to follow after the text, the text must be ended with a "/" before next command. If the sign "/" itself is to used in the text, a "\" must be written just before the "/". If again the "\" is to be used inside the text as a valid character, it must be written twice ("\\"). The pointer will be at the start of the new line. B : Go to start of file. E : Go to end of file. F : Search for the first occurrence of a character (or string of characters) in the file. The search starts at the current line. The string of characters must be ended with a "/" if more commands are chained (see the paragraph on the A-command). I : Insert a line before the current line. Read about ending with a "/" in the paragraph on the Acommand. K : Delete the number of lines that are stated just before the letter K. Example: 3K If no number is used, then 1 line is deleted.
158
L : Move a number of lines from the current line. The number can be negative to move towards the start of the file. Examples: 5L -10L N : Toggle line-numbering on/off. P : Show a number of lines from the current line. Example 8P. This will show 8 lines, starting with the current line. R : Search and replace. Search for a string of characters and replace it with a new one. Example: RALL/ALLE will replace all ALL with ALLE from the current line to the end of the file. S : Save file. Q : Exit the editor without saving the file. Examples:: "EDIT>B5L10P" sets pointer at start of file. Move 5 lines down, and show 10 lines from there. "EDIT>B4L6K-2L1OP" sets the pointer to the start of file. Move down 4 lines. Delete 6 lines. Move back 2 lines, and show 10 lines. "EDIT>BFBonjour/K-2L5P" sets the pointer to the start of file, searches for "Bonjour", deletes the line containing "Bonjour", moves back 2 lines and shows 5 lines. "EDIT>BFBonjour/IC'est une nouvelle ligne avec un \/ dedans/-1L3P" sets the pointer to start of file. Searches for "Bonjour", inserts the new line. The new line also contains the character "/". Goes back 1 line and shows 3 lines. "EDIT>SQ"
save file and quit the editor.
18.2 APPENDIX 2: PK-232 HOST MODE If you plan to use a PK-232 with this software, you must make some changes. First, check again PORT.SYS. You must have a P in "Type host mode". For example: # #TNC NbCh Com MultCh Pacln Maxfr NbFwd MxBloc M/P-Fwd Mode Freq 1 7 1 1 230 4 1 10 30/60 UPYW 433.650 2 1 3 1 80 2 1 5 17/30 GPW 15/20m # Example of INITTNCx.SYS for PK-232: UNMAIL v LA7QR RY10 MN6 MC6
means " " "
Unproto MAIL v LA7QR Retry 10 Monitor 6 Mcon 6 159
Example of MAINTx.SYS for PK-232: UR1 CTBBS ($c) was shut down for service $d $T. PK-232 host-mode commands (from F6AIW) :
18.3 APPENDIX 3: G8BPQ driver G8BPQ-node (uses TNCs in KISS-mode, DRSI cards, etc...). If you plan to use BPQ-node with this software, you must make some changes. Before you start FBB, you must load the BPQ-program. From version 4.05 of BPQcode, separate ports can be declared. Level 2 connections issue to the MultCh in the same order as PORTs declared in the BPQCFG.TXT (G8BPQ distribution) file. First port corresponds to MultCh 0. 160
Level 4 connections (from the network) always issue to MultCh 0. In PORT.SYS you must use 2 in INTERFACE, and Q in type host mode. Version 4.05 or up is recommended. COM can be from 1 to 8, but will exclude existing COMs. Choosing 8 is a good solution to keep existing COMs. We recommend that you use COM 8. Only the INITTNCx.SYS for the 1st port must exist. You must check that there is only one INITTNCx.SYS file for all BPQ-ports, otherwise you will have big problems! The parameters for other ports will be taken by default, and then no conflict should happen between ports. If you want to define the streams differently on each port, you can do it with the INITTNCx.SYS file, but be sure to give the right configuration. INITTNCx.SYS will look like this: A1 R0 UMAIL M1 N1 If paclen is equal to 0, then the default BPQ paclen of the port will be taken, otherwise the specified paclen will overwrite the default BPQ paclen. If you have validated the gateway, you must configure ENABLE_LINKED=A in BPQCFG.TXT to give to the stream the callsign of the user. In BPQCFG.TXT you will require to set the TNCPORT section up for COM 8. As follows:TNCPORT COM=8 ENDPORT Here is an example of PORT.SYS with BPQ-node and 2 TNCs: # #Ports TNCs 1 2 # # #Com Interface Address (Hex) Baud 8 2 0 4800 # # #TNC NbCh Com MultCh Pacl Maxfr NbFwd MxBloc M/P-Fwd Mode Freq 1 8 8 0 230 4 1 10 30/60 UQYW VHF 2 1 8 1 80 1 1 5 30/60 UQYW HF # Example of INITTNCx.SYS for BPQ 4.05 (Only ONE INITTNCx.SYS) : A1 R0 UMAIL M1
Number of application Returns to node (0=No,1=Yes) Unproto MAIL Monitor (0=No,1=YES) 161
N1 Number of first stream The parameters for other ports will be taken by default, For instance, as the first stream of the first port is 1, the first stream of the second port will be 9 (8 channels defined in PORT.SYS for port 1). This will be done automatically, and the second INITTNCx.SYS should not exist. In FORWARD.SYS there are a few changes, here is a short example: A LA2D # PB # C C SWITCH C C 2 LA2D # B LA2D F LA2D # ---------
Connect first BPQ switch. Connect LA2D on port 2 of BPQ.
For WinFBB: If you are using WinFBB together with BPQ-code you have to copy the files BPQCODE.386 BPQDLL.DLL to the \WINDOWS\SYSTEM directory. These files are normally included in the BPQ program pack. After this you starts BPQ in the same way as with DOSFBB, but before starting WINDOWS. The best is to start BPQCODE from AUTOEXEC.BAT. For LinFBB: BPQ cannot be used with LinFBB... 18.4 APPENDIX 4: Kantronics KAM in host-mode If you plan to use a KAM with this software, you must make some changes. For WinFBB: Use interface 6 in PORT.SYS. For DosFBB: Before you start the BBS, you must load the RS232 driver. You must use ESSKAM or ESS (ESS must be version 1.10 or higher). Do not use another driver such as COMBIOS or MBBIOS. Run it like this: 162
ESSKAM 1 ESSKAM 1 03F8 4
(Com1, Address and IRQ = defaults) (Com1, Address=03F8Hex, IRQ4)
The KAM must be in the right baud rate, and in Hostmode. You put it into Hostmode with these commands: INTF HOST PERM There is a special format for INITTNCx.SYS. For HF, use this: UNPROTO MAIL/ MONITOR ON/ MCOM ON/ MCON ON/ MRESP ON/ PID ON/ RETRY 15/ RESPTIM 0/ FRACK 2/ CHECK 30/ HID OFF/ For VHF use this: UNPROTO /MAIL MONITOR /ON MCOM /OFF MCON /ON MRESP /ON PID /ON RETRY /8 CHECK /30 HID /OFF As you can see, the position of the "/" is very important for HF/VHF ! In PORT.SYS you must use 1 for VHF and 2 for HF in MultCh. You must also use K in "Type host-mode". # # Same number of lines as number of TNCs. # #TNC NbCh Com MultCh Pacl Maxfr NbFwd MxBloc M/P-Fwd Mode Freq 1 4 1 1 230 4 1 10 30/60 UKYW 144.675 2 1 1 2 80 1 1 6 15/60 UKYW HF # 18.5 APPENDIX 5: DRSI-card If you plan to use DRSI-card with this software, you must make some changes. 163
Before you start FBB, you must load the DRSI-driver that comes with the DRSI-card. This must be TNCTSR-R or TNCTSR-L with a version-number higher or equal to 2.1. The first DRSI-card (MultCh 0 and 1) must be at address 300. The second DRSI-card (MultCh 2 and 3) must be at address 310. The third DRSI-card (MultCh 4 and 5) must be at address 308. The fourth DRSI-card (MultCh 6 and 7) must be at address 318. Before installing cards in the PC, use the program CHKADDR to verify that the addresses corresponding to the cards have a value of FF. If there is a problem, check your configuration to find what peripheral is already using this address. Install just one card at the time, and verify each cards presence with CHKADDR. When all cards are ok, configure the driver by means of the TAILORnn program (depending of the version). TNCTSR-S will be ok if you use only a few channels, while TNCTSR-L should be used for big configurations, up to 32 channels. One problem: What DRSI calls DRSI-PORT, is what we call MultCh in FBB ! What DRSI calls PORT, is what FBB calls port or TNC ! We always use FBB-names here... Each DRSI-card works like 2 radio-ports. The first DRSI-card is always MultCh 0 and 1, and the forth card is MultCh 6 and 7. If one radio-port is used on HF, that port must be the second port on the card. All the DRSI-cards together, work like only one COM. And this COM-port does not need to exist in the PC. You may call that port COM 7 or COM 8 and keep free the already existing COMS. Baud-rate does not matter, but should be set to a standard value, to avoid error-messages. Here is an example of PORT.SYS with 2 DRSI-cards (4 radios) : # #Ports TNCs 1 4 # # #Com Interface Address (Hex) 7 4 0 #
Baud 4800
# #TNC NbCh Com MultCh Pacl Maxfr NbFwd MxBloc M/P-Fwd Mode Freq 1 8 7 0 230 4 1 10 30/60 UDYW 433.650 2 1 7 1 80 2 1 5 12/30 GDW 15/20m 3 8 7 2 230 4 1 10 36/60 UDYW 433.650 4 8 7 3 230 4 1 5 10/30 GDW 145.300 # If you are using DRSI-card, you also must change the INITTNC1.SYS. You will need only ONE file for all the ports.
164
Example of INITTNC1.SYS that initializes 4 ports: MUIS U0 p0 1 64 10 4 4 10 100 18000 30 2 0 p1 1 64 10 4 1 16 100 18000 30 1 0 p2 1 64 10 4 4 10 100 18000 30 2 0 p3 1 64 10 4 4 10 100 18000 30 2 0 The same goes for MAINT1.SYS, only 1 file is needed for all 4 ports, like this: Y1 U 1 BBS ($c) was shut down for service $d $T. In FORWARD.SYS there is no changes. Use standard syntax. Well, I think that should be all (for DRSI). Oh, bye the way: DRSI cannot limit the number of connections per radio-port. But in FBB we still can have NbCh set to for example 1. When a station then connects to the BBS on that radio-port, and there already is one user connected there, the BBS will send a message to him: "Sorry, no more channels available" and disconnect him. 18.6 APPENDIX 6: Process numbers and help Process number and on-line help identification. The various processing functions contained in the software are identified by three numbers displayed in the status banner. The first of those three numbers is the main process system (BBS, FBBDOS, Satellite Computation, etc...), the second number is the process function (in the BBS, list, message sending, etc..) and the third number is a sub-function (record of the message title, message, etc..) A complete description of these numbers would be useless and time consuming. They are mainly used for debugging purpose. The first number is also used to identify the help block out of the x.HLP file. Upon receipt of the "?" or the "H", the software searches the x.HLP file for a line of corresponding to the language in use, and of the format @@ number word in which "number" stands for the current processing level, and "word" stands for the word following the command "?" or "H". Example : you are inside FBBDOS, and you type in the command "? EDIT", the help block searched for must begin with the line: @@ 9 EDIT It may happen that a block matches several search keywords. It is enough to specify the various words separated by the character "|" (vertical bar), WITH NO SPACE. @@ 9 EDIT|EDITEUR List of the processing levels : 0 Connection. 165
2 Qra-Locator. 3 Statistics. 4 Information. 5 Nomenclature. 6 Satellite Orbital Computation. 9 FbbDos. 11 Telephone Modem 14 BBS. 15 Forward. 16 Gateway Sysop page. 17 YAPP. 18 Conference. 18.7 APPENDIX 7: Recording a message A message can be left by a user or within a forwarding connection. The recording mechanism is always the same. The recording command is always like : Sx desti @ bbs < exped $ ident + filename Only recipient field is mandatory, all other fields are optional. Appending a filename is a possibility reserved to the Sysop. The name must be complete, including logic unit and complete path (C:\FBB\SYSTEM\TEST.TXT). When receiving the command line, a first test checks if a route exists when a route has been specified, or if the message must be automatically routed when no route was specified. The title of the message is then asked to the user. If the title is a missing, the message is canceled and the user returns to the main menu. The text of the message is then asked to the user. The software checks possible preamble lines. These lines give information on the previous BBS having routed this message. They all begin by R: on first column. The BBS callsign is given behind the @ character within the preamble line. All adjacent BBS mentioned in this preamble will be included in the "already forwarded" list, and will not be concerned by this message. This list specific to each message can be displayed with the $ or FN command followed by the message number. When receiving a /EX in first column, or a Ctrl-Z, a message number is then assigned, The BID (or MID if private) and the list of adjacent BBS concerned by this message are created. All these information are sent to the user when acknowledging the message. In case of disconnection before the /EX or Ctrl-Z, the whole message will be lost, and the texts already stored are deleted.
166
All information about the message (sender, recipient, route, MID, title, etc...) are stored in the DIRMES.SYS file. The text of the message is stored in a sub-directory of the MAIL directory. The sub-directory is MAILn where n is the last digit of the message number. The name of the file corresponds to the message number 123 is M_000123.MES, the number is 6 digits wide, in this case it is in the sub-directory MAIL3. The message number uses a long integer (32 bits), the number boundary is very far (more than 4 billions !). 18.8: APPENDIX 8: Tricks and tips This rubric is yours, more than mine. I'll try to insert there all tricks you will tell me. Only for DosFBB: Using DesqView (c) -----------------------There is no particular problem when using DesqView. The minimum window size is 500 KB. You MUST use communication drivers, like ESS, COMBIOS or MBBIOS, as the software does not dispose of the whole process time. Communication errors displaying ---------------------------------------An error counter can be displayed in WinFBB: after the word "Resync" on the screen in DosFBB: just right of the date, on the first line of the screen. If you are using TNC2 with WA8DED software, these errors can be minor, but with PK232, error recovery is more difficult, and the system may reboot. With a correct operation of your system, this counter will not appear, or exceptionally. If errors are displayed, they can result from: - Using DOS 4.0 or 5.0 : The keyboard driver of these versions is very slow. You must use the ESS driver for RS232 (or COMBIOS). - A too hight baudrate, or RS232 defective cables. The baud rate can be selected down to 4800 Bds. It is not a good idea to go down 4800 Bds, as the performance of the software should be lower. - Change the LM324 fitting out some TNC RS232 line drivers by a TL074 or TL084. - HF detection in the TNC. Errors and resynchronizations will appear when the transmitter is running. There is no real cure, you must investigate. You can also use communication drivers like ESS, COMBIOS or MBBIOS if you are not still using them.
167
Repeat the last message number -------------------------------------The last message number displayed, read, killed, etc... can be utilized again with the # (pound) character. This short-cut allows as for an example to read a message after a list or to suppress it just after its reading. Example : F6FBB BBS > R 12351 The message is displayed ... F6FBB BBS > K # Message #12351 killed. F6FBB BBS > Problems with BPQ running as a Node ! (OZ1CBQ) --------------------------------------------------------------If you are using BPQ running as a node together with FBB you may have problems if your node is linked to other node systems as TheNet, TheNetNode, XNET, RMNC, FlexNet, etc. BPQ seems to have a compatibility problem with these node systems causing some hangups during incoming connects via the node system. The problem starts with lowering the available buffers and at last the system is hanging until a reboot has been done. Only cure for the time being is to run BPQ as a SWITCH only without node update (NODE=0 in BPQCFG.TXT) only allowing level_2 traffic. This brings another problem: When FBB runs together with BPQ running as a level_2 switch, it is only possible to have outgoing forward on two channels at the time. One channel using the callsign and one channel using the alias as first call in the forward file. Example 1st outgoing forward channel C C SWITCH C C 1 OZ7BOX-2 C C ....
; Callsign of the BPQ-switch ; Other connects
Example 2nd outgoing forward channel: C C SWITCH C C 1 ESBOX C C ....
; Alias_name of the BPQ-switch ; Other connects
PMS forwarding -------------------In INIT.SRV there is a flag 128 in the FBB-type-forward section. If this flag is set, only PMS-users that have been declared with the F-flag in the EU-command (Edit User) will be able to up/download messages to/from the BBS. The same users should also have the U flag set (in EU-command) to 168
enable them to send unproto resync requests to the BBS. Display looks wrong (Only WinFBB) --------------------------------------------If you get a wrong display of the windows of WinFBB, halt the software, delete windows\winfbb.ini and rerun the software. 18.9 APPENDIX 9: FBB forward protocol FBB software includes two forward protocols. The first one is standard with MBL/RLI protocol. The second one was developed to allow efficiency, particularly on long links where propagation time of data are long. The exchange of commands is reduced to a minimum, and not acknowledged to get time. The data transfer direction is changed every block of data, a block of data holding up to five messages. This uses the "pipeline" effect of long links (Nodes and digipeaters), and gain some time over short links (HF...). FBB protocol is very simple in its principle. It is based on MID/BID usage. The identification is made by the F letter in the SID (system type identifier contained in square brackets). All command lines must start in first column with the 'F' character. All command lines are ended by a return (CR) character. Suppose I call another BBS to forward some mail. When I connect another BBS using FBB protocol, I will receive the SID followed by a text and the prompt (">"). If the SID contains the F flag, I will send immediately my SID and the first proposal. Proposals looks like : FB P F6FBB FC1GHV FC1MVP 24657_F6FBB 1345 F> HH FB : Identifies the type of the command (proposal) P : Type of message (P = Private, B = Bulletin). F6FBB : Sender (from field). FC1GHV : BBS of recipient (@field). FC1MVP : Recipient (to field). 24657_F6FBB : BID or MID. 1345 : Size of message in bytes. F> : End of proposal. HH is optional. It is the checksum of the whole proposal in hexadecimal. ALL the fields are necessary. This kind of command must hold seven fields. If a field is missing upon receiving, an error message will be send immediately followed by a disconnection. A proposal can handle up to five FB command lines. If the total size of messages seems to be too important, the proposal can handle less lines. In FBB software, a parameter is defined in INIT.SRV file to tell the maximum size of the message block. It is set by default to 10KB. Example of proposal :
169
FB P F6FBB FC1GHV.FFPC.FRA.EU FC1MVP 24657_F6FBB 1345 FB P FC1CDC F6ABJ F6AXV 24643_F6FBB 5346 FB B F6FBB FRA FBB 22_456_F6FBB 8548 F> HH This proposal is limited to three FB lines, as the amount of messages overran the 10KB limit. When receiving the proposal, the other BBS will reject, accept or defer the message. This command is made by a FS line : FS -+= This means : - I don't want the first message (-). - I need the second message (+). - I defer the third message, as I'm still receiving it. In the new version 1 of FBB protocol there are 3 more responses: R, E or H: "FS +R++" means that the second message is rejected. Only works with new version of the protocol. The information is also written in the LOG like : MJ B:Message_Bid V:Callsign_Rejecting A warning message may be sent to the sending Sysop when his message is rejected (see INIT.SRV for more info on warning messages). The message is not marked as 'F', and still can be forwarded to another BBS "FS +H++" means that the second message is held. Only works with new version of the protocol. The information is also written in the LOG like: MH B:Message_Bid V:Callsign_Rejecting A warning message may be sent to the sending Sysop when his message is held (see INIT.SRV for more info on warning messages). "FS +E++" means that the second message has a format error. Only works with new version of the protocol. A warning message may be sent to the sending Sysop when his message proposal is wrong (see INIT.SRV for more info on warning messages). It should interesting to defer a message if you are still receiving it on a other channel, or if you think that the size is to big, or for another reason. The message should be proposed again at the next connection. FS line MUST have as many +,-,=, R, E, H signs as lines in the proposal. When receiving the FS lines, I can send the block of messages. Each message is made with the title on the first line, the text, and a Ctrl-Z in the last line. The is no blank line between the messages. Title of 2nd message Text of 2nd message 170
..... ^Z When the other BBS has received all the asked messages, it acknowledges by sending its proposal, and the system is reversed. If it has no message to send, it only sends a line: FF This line must not to be followed by a F>. If the other hand has no message, it sends a line: FQ and asks for the disconnection. Example: ---------F6FBB FC1GHV -------------------------------------------------------------------------------------Connects FC1GHV Connected [FBB-5.11-FHM$] Bienvenue a Poitiers, Jean-Paul. > [FBB-5.11-FHM$] (F6FBB has the F flag in the SID) FB P F6FBB FC1GHV.FFPC.FRA.EU FC1MVP 24657_F6FBB 1345 FB P FC1CDC F6ABJ F6AXV 24643_F6FBB 5346 FB B F6FBB FRA FBB 22_456_F6FBB 8548 F> HH FS +-+ (accepts the 1st and the 3rd). Title 1st message Text 1st message ...... ^Z Title 3rd message Text 3rd message ...... ^Z FB P FC1GHV F6FBB F6FBB 2734_FC1GHV 234 171
FB B FC1GHV F6FBB FC1CDC 2745_FC1GHV 3524 F> HH FS -- (Don't need them, and send immediately the proposal). FB P FC1CDC F6ABJ F6AXV 24754_F6FBB 345 F> HH FS + (Accepts the message) Title message Text message ...... ^Z FF (no more message) FB B F6FBB TEST FRA 24654_F6FBB 145 F> HH FS + (Accepts the message) Title message Text message ...... ^Z FF (still no message) FQ (No more message) Disconnection of the link. In this example, FBB protocol is used as the two BBS were identified by the F flag in the SID. If F6FBB had sent the SID [FBB-5.11-MH$] when answering FC1GHV, the protocol should be the standard MBL/RLI. All callsigns are only examples! 18.10 APPENDIX 10: Compressed forward FBB has 2 kinds of compressed forward: Compressed forward FBB. XFWD Compressed forward. Extension to the protocol. Compressed forward FBB The protocol utilized for the transfer of files compressed is an extension to the existing protocol. 172
The compressed forward is validated by the presence of the letter B in the SID [FBB-5.12BFHM$]. The transfer of compressed files can only take place under FBB protocol. The presence of the letter B in the SID without the F letter will remain without effect. The only difference as regard to the standard protocol is the submit line. It can specify the type of data contained in the compressed message. FA means that the transfer will be an compressed message. FB means that the message will be a binary compressed file (this last possibility is not yet implemented in the version 5.12). The submission of an message will be in the form : FA P FC1CDC F6ABJ F6AXV 24754_F6FBB 345 The submission of a binary file will be in the form : FB P FC1CDC F6ABJ F6AXV 24754_F6FBB 345 The transferred data are of a specific format. The transfer will be done in binary mode. This last one is derived of the YAPP protocol which is very reliable. All transfer is made of a header, a block of data, an end of message and a checksum. Each transfer is equivalent to the transfer of one message of the standard protocol and shall not be followed by a control Z, the end of file specifier is defined in another way. Format of header for an compressed message (submission FA) : 1 byte = 01 hex Length of the header 1 byte = Length from the title, including the two characters. Title of the message 1 to 80 bytes 1 byte = 00 hex Offset 1 to 6 bytes 1 byte = 00 hex Format of header for a binary compressed file (submission FB) : 1 byte = 01 hex Length of the header 1 byte = Length from the filename, including the two characters. Name of the file 1 to 80 bytes 1 byte = 00 hex Offset 1 to 6 bytes 1 byte = 00 hex To follow the French regulation, the title of the message or the file name is transmitted in a not compressed format. The offset is also transmitted in and specifies the offset at which the data should be inserted in the file (in case of a fragmented file). In the version 5.12, this parameter is not utilized and is always equal to zero. A data block contains from one to 256 bytes. It begins by two bytes which specify the format. Data block format :
173
1 byte = 02 hex Number of data 1 byte = 00 to ff hex. (00 if length = 256 bytes). Data bytes 1 to 256 bytes The last data block is followed by the end of file specifier and the checksum. End of file specifier format : 1 byte = 04 hex Checksum 1 byte = 00 a ff hex The checksum is equal to the sum of all the data bytes of the transmitted file, modulo 256 (8 bits) and then two's complemented. The checking of the checksum is very simple: The sum of the data from the file and the checksum received modulo 256 (ended with FF) shall be equal to zero. In case of a checksum error, the message or the file is not taken to account and the system issues a disconnect request after having sent the comment: *** Checksum error Extension to the protocol. XFWD compressed forward X forwarding Protocol is implemented. XForwarding now supports re-routing and swapping. Binary forwarding via telephone modem (FBB or XFWD) 18.11 APPENDIX 11: Format of ACK-messages The ACK messages on receiving have a simple and compact format. The aim is to have a message as short as possible in order to avoid an unnecessary usage of the network. The title of the message is the title of the original message with a leading "ACK:". Example: ACK:Title of the original message. These ACK messages are true messages strictly speaking. They carry the origin, the destination, the route and the MID but they are of a particular type, the type A (private are of type P, bulletins of type B, etc...). This difference allows the routing of these messages without the lines "R:". This is done again with the aim of avoiding an excessive load by data which are of no use in this case. To keep the compatibility with the existing forwarding protocol, the type of these messages is changed to P (private) if the receiving BBS of the forwarding does not know the type of ACK messages (specified in the SID [FBB-5.12-ABFHM$] by the letter A). In this case, the ACK 174
message will continue on its route as a private message. The ACK messages are of the following form: ACK:Message test. 20) { sprintf (r_buf, "Inside the C_FILTER\r"); } return (0); } 18.16 APPENDIX 16: Message filtering FBB software allows filtering messages. Filtering is not done by the BBS software but by external programs developed by users. When the BBS starts, the M_FILTER does not really need to be there. But at the first message, it must exist. If it does not exist at THAT time, it will not be checked again. So if a M_FILTER is added after that, the BBS must be rebooted for the filter to take effect. M_FILTER may be interactive and allows to incorporate some features like dedicated information for predefined callsigns, password filtering, etc... I did not develop such programs, but this is an open door to many applications. The M_FILTER program must be found by the PATH of MsDos. Its extension can be COM or EXE, and it must be little and fast as multitasking is stopped during the activity of this program. If this program is not found, it will not be called until the BBS is rebooted. The M_FILTER may also be created as a DLL. Both for WinFBB and DosFBB (!!). The filter must be installed in the path (\FBB\BIN) of Dos. The message filter is called (if found) each time a message is ready to be recorded (when Ctrl-Z or /EX is received). The decision to validate or not the message is function of the exit value of the M_FILTER program. The M_FILTER program (if found) is called with some arguments including a level number. This number is incremented each time the program is called in the same connection session. The first 187
time the level number will be 0. The line arguments given to the M_FILTER program are : - File name including the text of the message. - Type of the message (P, B, T). - Sender. - "To" field. - Record number of DIRMES.SYS file. The M_FILTER program ends with an exit value. This value is very important and tells the BBS what to do : 0 : Message is recorded. 1 : Message is killed 2 : Message is archived 3 : Message is held
(status = K). (status = A). (status = H).
/* * M_FILTER.C * * The message filter MUST be named M_FILTER (COM or EXE). * * This example only writes its call arguments in the TEST.MES file. * * It is called with 5 arguments : * File name of the message. * Type . * Sender. * To. * Number of the record in the DIRMES.SYS file. * * If it returns 0 : The message is accepted. * 1 : The message is killed (status K). * 2 : The message is archived (status A). * */ #include main(argc, argv) int argc; char **argv; { int i; FILE * fptr = fopen("TEST.MES", "at"); for (i = 0 ; i < argc ; fprintf(fptr, "%s ", argv[i++])); fputc('\n', fptr); fclose(fptr); 188
return(0); } 18.17 APPENDIX 17: PG programs PG programs development. PG programs are in the PG subdirectory. They are small programs allowing interactivity with the user. COM or EXE programs can be called. PG programs must be little as the amount of memory is limited and fast because the multitasking is stopped during its activity. To run a PG program and start a session, the user must type the command PG followed by the name of the program. The PG command alone gives the content of the PG subdirectory. The PG program is particularly developed for FBB software but can be an interface to a standard program. Each time a complete line (up to the return character) is received, the PG program is called with some arguments including a level number. This number is incremented each time the program is called in the same PG session. The first time the level number will be 0. The line arguments given to the PG program are : - Callsign (format as F6FBB-8). - Level number (0 is the first time, up to 99). - Flags of the user (binary number as user's mask of INIT.SRV). - Record number of the user in INF.SYS. - Received data (each word is a new argument). The PG program ends with an exit value. This value is very important and tells the BBS what to do : 0 : end of session and return to the BBS menu. 1 : the program will be called again and the level number is incremented. 2 : the user will be disconnected. 3 : the receive data will be sent as a BBS command and return to BBS. 4 : the receive data will be sent as a BBS command, level incremented. 5 : the program will be called again, but the level is not incremented. The data sent by the PG program to the standard output will be sent to the user. This allows a real interactivity between the user and the PG program.
189
Here is an example of a small program : /* * TST_PG.C * * Little test program of "PG" command for FBB BBS software. * * (C) F6FBB 1991. * * FBB software 5.14 and up. * * * This program echoes to the user what he types * or executes a BBS command preceded by "CMD" * until "BYE" is received */ #include main(int argc, char **argv) { int i; int level = atoi(argv[2]);
/* Get level from argument list
/* and transform it to integer /* Is level equal to 0 ? /* This is the first call printf("Hello %s, type BYE when you want to stop !\n", argv[1]); return(1); /* program will be called again
if (level == 0) {
} else { strupr(argv[5]); if (strcmp(argv[5], "BYE") == 0) { printf("Ok, bye-bye\n"); return(0); } else if (strcmp(argv[5], "CMD") == 0) { for (i = 6 ; i < argc ; i++) printf("%s ", argv[i]); putchar('\n'); for (i = 6 ; i < argc ; i++) printf("%s ", argv[i]); putchar('\n'); return(4); } else { printf("You told me : "); for (i = 5 ; i < argc ; i++) printf("%s ", argv[i]);
*/ */ */ */ */
/* Capitalize the first word /* is BYE received ?
*/ */
/* Yes, go on BBS
*/
/* is CMD received ? /* List line arguments /* sent by user
*/ */ */
/* List line arguments /* sent by user
*/ */
/* Yes, send command
*/
/* These are other lines /* List line arguments /* sent by user
*/ */ */ 190
putchar('\n'); return(1);
/* No, call again program
*/
} } } 18.18 APPENDIX 18: Unproto message lists FBB software allows sending unproto lists of message. This is validated separately on each port (letter L in PORT.SYS). Unproto address is FBB with the following header : fm F6FBB-1 to FBB ctl UI An unproto list line is sent on every validated port each time a message is recorded. The line is in the form : 12345 B 2053 TEST@ALL F6FBB 920325 This is the subject If a message number is missing or does not exist the line will be : 12346 # This allows a system listening to the UI packets on a frequency to create a list identical to the one of the BBS, and then the user will not have to connect the BBS to know the list of messages and bulletins. A control can be done on the number of the messages to check if a line is missing. If the remote system receives a new line, and a line is missing, it only has to send an unproto frame addressed to the BBS callsign like this : fm FC1EBN-3 to F6FBB-1 ctl UI ? 00002EE00E This will be taken in account only if the user has the U flag validated (EU command). If the user has not his flag validated in the BBS, he will receive a line like : fm F6FBB-1 to FBB ctl UI 12200 / callsign In this case, the the remote software MUST stop asking unprotoes. The first 8 digits are the hexadecimal number of the requested start of the list (here 00002EE0 -> 12000) and the last two digits are the sum of the four bytes anded with FF (0E). The BBS will then starts sending lines from the requested number up to the last message number. If the number requested seems to be too far from the current line, the BBS can readjust the request of "callsign" while sending : 191
fm F6FBB-1 to FBB ctl UI 12200 ! CALLSIGN 12201 B 2040 TEST@FRA F6FBB 920325 This is a bulletin 12202 # 12203 P 206 F6ABJ@F6ABJ F6FBB 920325 Hello Remy. etc... and then starts sending lines from 12201. The remote system must change its base number to 12201. If the number requested is greater than the last message received in the BBS, the BBS will send a line like : 12300 !! This indicates that the list in the remote system is up to date. The last received message in the BBS is 12300. The remote system can also connect the BBS and ask for messages in binary compressed mode using the following sequence : BBS Remote system -------------------------------------------------------------------------Connection request Connection. [FBB-5.14-ABFHM$] Welcome in Toulouse, Gerard. F6FBB BBS> [TPK-1.80-$] 1> F< #Msg Binary compressed message #Msg is sent using format described in appendix 10 1> Disconnect. From TPK version 1.80 (packet communication program developed by FC1EBN), this protocol is implemented. 18.19 APPENDIX 19: Extensions to YAPP-protocol These extensions are used in TPK 1.65a (and up) and FBB 5.14 and up. HEADER extension. The header now carries the DATE and TIME of the file being transmitted. [SOH] [Len] [Filename] [NUL] [File Size] [NUL] [Date] [Time] [NUL] 192
The Date and Time are the values reported by DOS, coded in 4 hexadecimal digits and are sent in (8 characters). The receiver has the choice of using either extended Yapp with checksum or normal Yapp. The normal Yapp reply is RF, as before and the receiver can keep the date and time information . The extended Yapp reply is : RT Receive_TPK and is coded : [ACK] [ACK] If the receiver reply is RT the protocol used will be what I have called YappC for Yapp with checksum. When the sender gets this packet he MUST use YappC. Data Packets extension. If the receivers reply is RT the protocol used will be YappC. The checksum allows detection of packets corrupted along the link, particularly on the RS232 lines where there is no error control or correction (or it's very poor!) Data packets : [STX] [Len] [Data] [Checksum] Checksum is the sum of all data bytes anded with FF in 8 bits like Xmodem. If the checksum is bad then the receiver must send a Cancel and enters CW state. Crash Recovery. A new field has been added to the resume reply to tell the sender if the receiver can use YappC or not. Resume is sent instead of RF (or RT). Resume reply for Yapp: (as used before by TPK and FBB) [NAK] [Len] [R] [NUL] [Received Length] [NUL] I I I I I +-- in as in the header I +-- as Resume ! I +------- len of the following bytes Resume reply for YappC: [NAK] [Len] [R] [NUL] [Received Length] [NUL] [C] [NUL] I Tells sender I can use YappC -----+ When the sender gets this packet then he must also use YappC.
193
18.20 APPENDIX 20: Telephone-modem The FBB software allows the connection of a telephone modem on a serial port. This section is split into these parts: Driver Type of modem Protocol Wiring for external modem Usage Example of PORT.SYS for DosFBB Example of PORT.SYS for WinFBB Example of PORT.SYS for LinFBB Example of INITTNCx.SYS for modem Example of FORWARD.SYS Driver: The modem must be declared in PORT.SYS. In WinFBB the necessary driver is in FBBCOMM.DRV. This driver replaces the original COMM.DRV supplied by Windows. In DosFBB it is necessary to use the FBBIOS.COM program. This driver performs BBS to Modem interfacing. It is therefore necessary to load FBBIOS prior to BBS start up. A line FBBIOS will be added ahead of APPEL.BAT file. See below an example of the APPEL.BAT file. Of course, the FBBIOS used will have to match the serial port on which the modem is to be connected (address and IRQ). In LinFBB it is necessary to compile the Linux Kernel with SLIP (serial line). The modem-driver will modify the RS232 speed according to the CONNECT info received from the modem : CONNECT 1200 set the driver to 1200 Baud. CONNECT 2400 set the driver to 2400 Baud. The driver is reset to the default speed rate (specified in PORT.SYS) at disconnect. At connect, the text ; "xxxx BBS. Phone Access" is sent by default. This can be modified by creating a file MODEM.ENT in the SYSTEM directory. You can specify in the PORT.SYS file that you accept connections, even if the user is not registered. In this case, the connection will be "read-only", the user has only a read only-access, he cannot download files or write messages, except to the Sysop. When a non-registered user is connected, he will be signified that he only has a "read only access", and will be prompted to go on. If he answers "Y", he will go to the BBS menu, else he will be asked again for a callsign.
194
Type of modem: Various experiments have been carried out with several different kinds of (external, or internal cards) modems. If possible, modems at 14.400 or better 28.800 bps should be used; the modem speed is to be declared in PORT.SYS. Some modems can work different speeds, with an internal speed conversion between the modem and the computer. For example, the modem can transmit and receive on the telephone line at 14400 bps and talk to the PC at 19200 bps. If the modem uses the HAYES protocol, the INITTNCx.SYS file must hold the correct HAYES init lines for the modem. Protocol: The configuration used is 1 start bit, 8 data bits, 0 parity, 1 stop bit, that is to say 10 bits words during the transmission. The Minitel standard is not supported (7 bits, even parity). The software being parameterized by default in 8 bits, it was not possible to modify this protocol, as the binary file transfers are carried out on 8 bits. NB.: FBBIOS/FBBCOMM.DRV handles XON/XOFF protocol during the transmissions. Wiring for external modems: The modem must be able to tell the BBS that a call has been detected with the remote modem carrier detection. This is the reason why all the RS232 signals are used by the BBS. The RS232 cable has to be wired up pin to pin with no inversion: pins 2, 3, 4, 5, 6, 7, 8, 20, and 22 of the DB25 connector. Usage: BBS users are not authorized to connect the BBS through a modem as per the default settings. The Sysop must declare the modem users. To do it, perform a user edition (EU call) and put M (for Modem) then W pass_word. A password made of the three last letters of the callsign can be attributed for the first connect. Then the user will be able to change it through the NP command. The authorized callsigns can be listed by the DM command. When a modem call occurs, once the modulations have been detected, the modem advises the BBS that a connection is effective on the telephone line. Then the BBS asks for the caller's call sign and password. The user is granted three tries before being disconnected. If everything is all right, the user can access the same commands like connected on a radio channel, he will have to disconnect using the B command. The log file is maintained for the connections through the modem channel. 195
Keep in mind to add a line in the LOGFBB.CNF file for the modem calls to be processed in the stats analysis by LOGSTAT. For WinFBB: FBBCOMM.DRV is already installed when Windows is started. So there is no more driver to install for the modem. For LinFBB: Make sure you have compiled the Linux kernel with SLIP (serial line), or if you compiled SLIP as module you must load this. For DosFBB: Example of APPEL.BAT with FBBIOS for a modem connected to COM3/IRQ4 : echo off break off echo Press ^C to interrupt ! sleep 3 fbbios 3 03E8 4 serv %1 etc........ Example of PORT.SYS file with 3 serial port used: COM1 for a TNC, COM2 for a TNC, COM3 for the modem. Example for DosFBB: FBBIOS will have been previously configured for COM3 (3E8, IRQ 4). # File for programming of channels and TNCs. # # Ports : How many ports (COM1, COM2, Etc...) # TNCs : How many TNCs and modems in use. With multiplexer # there can be up to 4 TNCs per port. # #Ports TNCs 3 3 # #In WinFBB ONLY THESE interfaces are available: # Interface : 2 = BPQ-node (BPQ in AA4RE-mode) # 4 = DRSI # 5 = TFPCR/TFPCX interface. Interrupt MUST be 0xFD or the same # as stated in INIT.SRV, if any.. # 6 = Windows-driver, replaces both ESS and FBBIOS. # 7 = TCP/IP. Needs WINSOCK.DLL. Put port-address as 17. # TNC-emulation is T (see below) 196
# 8 = TFWin.dll # BEWARE: The old interface 1 and 3 will NOT be used in WinFBB. Interface 6 replaces both. # (FBBCOMM.DRV). Neither ESS nor FBBIOS can be used with WinFBB ! # #In LinFBB ONLY this interface is available: # Interface 9 = Linux. Can work via serial port (D),via AX25 domain socket (X) or # via Telnet port (T). # #In DosFBB ONLY THESE interfaces are available: # Interface : 1 = Use external COMBIOS-driver (MBBIOS, ESS etc) # 2 = BPQ-node v 4.05 and up (BPQ in AA4RE-mode) # 3 = Telephone-modem with FBBIOS # 4 = DRSI card with driver # 5 = TFPCR/TFPCX interface. Interrupt MUST be 0xFD or the same # as stated in INIT.SRV, if any.. # Address : Address of port in hexadecimal (Needed for multiplexer). # In LinFBB: # Address is the device name (/dev/cua0). # Be sure you have the rights to access to the device (rw-rw-rw-). # When using kernel AF_AX25 socket, address is not used. # When using Telnet, address is the Telnet port in Hex (Hex 17 = Telnet port 23) # Baud : Ports baud rate. Ignored by BPQ, kernel AF_AX25 socket and Telnet. # # Use same number of lines as number of ports. # #Com Interface Address (Hex) Baud 1 1 3F8 9600 2 1 2F8 9600 3 3 3E8 1200 # # TNC : Number on TNC in use. Use 0 for file-forward ! # NbCh : Number of channels I want to use in the TNC. # Maximum available channels depend on firmware. # Com : Number of the COM-port. Com1, Com2 etc. # MultCh : Number of channel if port-multiplexer is used, otherwise 1. # In DRSI use values from 0 to 7, by KAM use 1/VHF and 2/HF. # Paclen : PACLEN on this TNC. # Maxframe : The maximum nb of frames the TNC will send at a time. # NbFwd : Number of channels for OUTGOING forward at same time. # MxBloc : Size of forward-block in kb. # M/P-Fwd : Minute of the hour for start of forward, and period # (how many minutes between each forward-start). # Port mode, one of these: # B : BBS-mode. # G : "Guest"-mode. # U : Normal-mode. # Type host-mode, one of these: # D : WA8DED # K : KAM Hostmode. # P : PK-232 197
# Q : BPQ v 4.x # T : Ethernet/TCP-IP # X : AX25 domain socket (for Linux) # Addition: One or more of these letters can be used too: # L : Send unproto beacon after each arriving mail. # M : Telephone-modem. # Y : Yapp allowed on this QRG. # W : Gateway allowed TO this QRG. # R : Modem port allowed in Read-only mode. # Freq. : Text to describe this port (max 9 characters, no space) # # Same number of lines as TNCs: # #TNC NbCh Com MultCh Pacln Maxfr NbFwd MxBloc M/P-Fwd Mode 1 5 1 1 230 2 1 10 10/60 UDW 2 4 2 1 250 3 2 5 12/30 UDYW 3 1 3 1 128 2 1 5 00/60 UM # # Special callsigns and modes for some channels. # #TNC Nbs Callsign-SSID Mode 1 1 LA1B-1 B # # End of file. #
Freq 144.675 430.675 MODEM
The “NbFwd” value for the Telephone modem must be '1' and not '0' as previously indicated! Same example for WinFBB: FBBCOMM.DRV is already loaded by Windows. # File for programming of channels and TNCs. # # Ports : How many ports (COM1, COM2, Etc...) # TNCs : How many TNCs and modems in use. # With multiplexer there can be up to 4 TNCs per port. # #Ports TNCs 3 3 # #In WinFBB ONLY THESE interfaces are available: # Interface : 2 = BPQ-node (BPQ in AA4RE-mode) # 4 = DRSI # 5 = TFPCR/TFPCX interface. Interrupt MUST be 0xFD or the same # as stated in INIT.SRV, if any.. # 6 = Windows-driver, replaces both ESS and FBBIOS. # 7 = TCP/IP. Needs WINSOCK.DLL. Put port-address as 17. # TNC-emulation is T (see below) 198
# 8 = TFWin.dll # BEWARE: The old interface 1 and 3 will NOT be used in WinFBB. Interface 6 replaces both. # (FBBCOMM.DRV). Neither ESS nor FBBIOS can be used with WinFBB ! # #In LinFBB ONLY this interface is available: # Interface 9 = Linux. Can work via serial port (D),via AX25 domain socket (X) # or via Telnet port (T). # #In DosFBB ONLY THESE interfaces are available: # Interface : 1 = Use external COMBIOS-driver (MBBIOS, ESS etc) # 2 = BPQ-node v 4.05 and up (BPQ in AA4RE-mode) # 3 = Telephone-modem with FBBIOS # 4 = DRSI card with driver # 5 = TFPCR/TFPCX interface. Interrupt MUST be 0xFD or the same # as stated in INIT.SRV, if any.. # Address : Address of port in hexadecimal (Needed for multiplexer). # In LinFBB: # Address is the device name (/dev/cua0). # Be sure you have the rights to access to the device (rw-rw-rw-). # When using kernel AF_AX25 socket, address is not used. # When using Telnet, address is the Telnet port in Hex (Hex 17 = Telnet port 23) # Baud : Ports baud rate. Ignored by BPQ, kernel AF_AX25 socket and Telnet. # # Use same number of lines as number of ports. # #Com Interface Address (Hex) Baud 1 6 3F8 9600 2 6 2F8 9600 3 6 3E8 1200 # # TNC : Number on TNC in use. Use 0 for file-forward ! # NbCh : Number of channels I want to use in the TNC. # Maximum available channels depend on firmware. # Com : Number of the COM-port. Com1, Com2 etc. # MultCh : Number of channel if port-multiplexer is used, otherwise 1. # In DRSI use values from 0 to 7, by KAM use 1/VHF and 2/HF. # Paclen : PACLEN on this TNC. # Maxframe : The maximum nb of frames the TNC will send at a time. # NbFwd : Number of channels for OUTGOING forward at same time. # MxBloc : Size of forward-block in kb. # M/P-Fwd : Minute of the hour for start of forward, and period # (how many minutes between each forward-start). # Port mode, one of these: # B : BBS-mode. # G : "Guest"-mode. # U : Normal-mode. # Type host-mode, one of these: # D : WA8DED # K : KAM Hostmode. # P : PK-232 199
# Q : BPQ v 4.x # T : Ethernet/TCP-IP # X : AX25 domain socket (for Linux) # Addition: One or more of these letters can be used too: # L : Send unproto beacon after each arriving mail. # M : Telephone-modem. # Y : Yapp allowed on this QRG. # W : Gateway allowed TO this QRG. # R : Modem port allowed in Read-only mode. # Freq. : Text to describe this port (max 9 characters, no space) # # Same number of lines as TNCs: # #TNC NbCh Com MultCh Pacln Maxfr NbFwd MxBloc M/P-Fwd Mode Freq 1 5 1 1 230 2 1 10 10/60 UDW 144.675 2 4 2 1 250 3 2 5 12/30 UDYW 430.675 3 1 3 1 128 2 1 5 00/60 UM MODEM # # Special callsigns and modes for some channels. # #TNC Nbs Callsign-SSID Mode 1 1 LA1B-1 B # # End of file. # The “NbFwd” value for the Telephone modem must be '1' and not '0' as previously indicated! Same example for LinFBB: Example of PORT.SYS file with 3 serial port used: COM1 (/dev/cua0) for a TNC, COM2 (/dev/cua1) for a TNC, COM3 (/dev/cua2) for the modem. # File for programming of channels and TNCs. # # Ports : How many ports (COM1, COM2, Etc...) # TNCs : How many TNCs and modems in use. With multiplexer # there can be up to 4 TNCs per port. # #Ports TNCs 3 3 # #In WinFBB ONLY THESE interfaces are available: # Interface : 2 = BPQ-node (BPQ in AA4RE-mode) # 4 = DRSI # 5 = TFPCR/TFPCX interface. Interrupt MUST be 0xFD or the same # as stated in INIT.SRV, if any.. # 6 = Windows-driver, replaces both ESS and FBBIOS. # 7 = TCP/IP. Needs WINSOCK.DLL. Put port-address as 17. # TNC-emulation is T (see below) 200
# 8 = TFWin.dll # BEWARE: The old interface 1 and 3 will NOT be used in WinFBB. Interface 6 # replaces both. (FBBCOMM.DRV). Neither ESS nor FBBIOS can be # used with WinFBB ! # #In LinFBB ONLY this interface is available: # Interface 9 = Linux. Can work via serial port (D),via AX25 domain # socket (X) or via Telnet port (T). # #In DosFBB ONLY THESE interfaces are available: # Interface : 1 = Use external COMBIOS-driver (MBBIOS, ESS etc) # 2 = BPQ-node v 4.05 and up (BPQ in AA4RE-mode) # 3 = Telephone-modem with FBBIOS # 4 = DRSI card with driver # 5 = TFPCR/TFPCX interface. Interrupt MUST be 0xFD or the same # as stated in INIT.SRV, if any.. # # Address : Address of port in hexadecimal (Needed for multiplexer). # In LinFBB: # Address is the device name (/dev/cua0). # Be sure you have the rights to access to the device (rw-rw-rw-). # When using kernel AF_AX25 socket, address is not used. # When using Telnet, address is the Telnet port in Hex (Hex 17 = Telnet port 23) # Baud : Ports baud rate. Ignored by BPQ, kernel AF_AX25 socket and Telnet. # # Use same number of lines as number of ports. # #Com Interface Address (Hex) Baud 1 9 /dev/cua0 9600 2 9 /dev/cua1 9600 3 9 /dev/cua2 1200 # # TNC : Number on TNC in use. Use 0 for file-forward ! # NbCh : Number of channels I want to use in the TNC. # Maximum available channels depend on firmware. # Com : Number of the COM-port. Com1, Com2 etc. # MultCh : Number of channel if port-multiplexer is used, otherwise 1. # In DRSI use values from 0 to 7, by KAM use 1/VHF and 2/HF. # Paclen : PACLEN on this TNC. # Maxframe : The maximum nb of frames the TNC will send at a time. # NbFwd : Number of channels for OUTGOING forward at same time. # MxBloc : Size of forward-block in kb. # M/P-Fwd : Minute of the hour for start of forward, and period # (how many minutes between each forward-start). # Port mode, one of these: # B : BBS-mode. # G : "Guest"-mode. # U : Normal-mode. # Type host-mode, one of these: # D : WA8DED 201
# K : KAM Hostmode. # P : PK-232 # Q : BPQ v 4.x # T : Ethernet/TCP-IP # X : AX25 domain socket (for Linux) # Addition: One or more of these letters can be used too: # L : Send unproto beacon after each arriving mail. # M : Telephone-modem. # Y : Yapp allowed on this QRG. # W: Gateway allowed TO this QRG. # R : Modem port allowed in Read-only mode. # Freq. : Text to describe this port (max 9 characters, no space) # # Same number of lines as TNCs: # #TNC NbCh Com MultCh Pacln Maxfr NbFwd MxBloc M/P-Fwd Mode Freq 1 5 1 1 230 2 1 10 10/60 UDW 144.675 2 4 2 1 250 3 2 5 12/30 UDYW 430.675 3 1 3 1 128 2 1 5 00/60 UM MODEM # # Special callsigns and modes for some channels. # #TNC Nbs Callsign-SSID Mode 1 1 LA1B-1 B # # End of file. # The “NbFwd” value for the Telephone modem must be '1' and not '0' as previously indicated! Example of INITTNCx.SYS file for HAYES modem : # ATZ ATS0=1 Example of FORWARD.SYS file to forward via modem. A protocol with correction (like MNP) must be used to avoid any modifications of texts. The HAYES command ATDT dials the line, and when the connection is established, the callsign (preceded with a "." to avoid echoing) is sent twice and then the password. The callsign is sent twice in case of a problem the first time. ^M is the variable. A LA1B # PC
