home *** CD-ROM | disk | FTP | other *** search
Text File | 1997-08-07 | 51.5 KB | 1,155 lines |
- ═════════════════════════════════════════════════════════════════════════════
-
- █▀▀█▀▀█ █▀▀▀▀█▄ ▀█▀▀▀█▄ ▀█▄ ▀█ ▀█▀█▄ ▀█▀▀█▄ █▀▀▀▀█▄
- █ █ █ █ █ █▀█ █ █ ▀█ █ ▀█ █ █
- █ █ █ ▄█▄▄▄█▀ █ ▀█ █ ▀█▀▀▀█ █ █ █ █
- █ █ █ █ ▀█ █ ▀█ █ █ █ █ ▄█ █ █
- ▄█▄ ▀█▄▄▄▄█ ▄█ ▄█ ▄█ ▀██ ▄█ ▄█ ▄█▄▄█▀ ▀█▄▄▄▄█
-
- ─────────────────────────────────────────────────────────────────────────────
-
- Tornado Bulletin Board System
- Copyright (c) 1995-97 Konstantin Klyagin [2:461/22] & Tornado Team.
-
- ═════════════════════════════════════════════════════════════════════════════
-
- Table of content Feci quod potui, faciant
- ════════════════ meliora potentes.
-
- 1. Development history ......................................... XX
- 2. Program features ............................................ XX
- 3. About this document ......................................... XX
- 4. Hardware and software requirements .......................... XX
- 4.1. Hardware requirements .................................. XX
- 4.2. Software requirements .................................. XX
- 4.3. Additional hardware and software........................ XX
- 5. User interface .............................................. XX
- 5.1. Call waiting mode ...................................... XX
- 5.2. User session ........................................... XX
- 5.3. Colors customizing ..................................... XX
- 6. The Tornado workcycle ....................................... XX
- 6.1. Command line parameters ................................ XX
- 6.2. Errorlevel codes ....................................... XX
- 6.3. Flagfiles .............................................. XX
- 7. Customizing ................................................. XX
- 7.1. Text color setting codes ............................... XX
- 7.2. Macros ................................................. XX
- 7.3. Setting time intervals ................................. XX
- 7.4. .A?? filenames ......................................... XX
- 7.5. Access levels and user semaphores ...................... XX
- 7.6. Messages language customizing .......................... XX
- 7.7. User menu customizing .................................. XX
- 7.8. Running the Tornado under mailer........................ XX
- 7.9. Some notes about multiline mode ........................ XX
- 8. Advanced features ........................................... XX
- 8.1. Built-in DoorWay ....................................... XX
- 8.2. ManualSend (tm) ........................................ XX
- 8.3. SaveTagList (tm) ....................................... XX
- 8.4. The Tornado Upgrade Manager (tm) ....................... XX
- 8.5. Registration Resume (tm) ............................... XX
- 8.6. Private Uploads (tm) ................................... XX
- 9. Other info .................................................. XX
- 9.1. Acknowledgements ....................................... XX
- 9.2. Distribution and the author's responsibility ........... XX
- 9.3. Support ................................................ XX
- 9.4. The author.............................................. XX
- 9.5. Trademarks ............................................. XX
-
-
- 1. Development history
- ══════════════════════
-
- The Tornado is a program to create and arrange BBS (Bulletin Board
- System). There is a lot of such programs, the most popular are Remote-
- Access, Maximus, PCBoard, SuperBBS, etc. But it's always interesting
- to do it by oneself. So dealing with the BBS programs setting and cus-
- tomizing on my own BBS, I noticed some inconveniences. This forced me
- to think about developing my own BBS program. This was happened on 26
- July 1995. That day I've created the TORNADO.PAS file in the Borland
- Pascal 7.0 IDE - really amazing Borland Inc. product. The Tornado is
- my try (it's up on you to judge whether is it succesful ;) to join the
- strengthes of the programs of such class, assembling them with own fe-
- atures (as well as with bugs - there are many of them, surely). I paid
- special attention to comfortable work, number of features increase,
- and thorough debugging. So if you've noticed some inconveniences or
- errors, you ought to contact me for them to be removed.
-
-
- 2. Program features
- ═══════════════════
-
- - Text configuration files;
- - Built-in ANSI, TTY and AVATAR terminals support;
- - Built-in XModem, XModemCRC, XModem1K, XModem1KG, YModem, YModemG
- and ZModem file transfer protocols;
- - Customizable messages languages support;
- - Free choice of the I/O device used to interface to COM-port (UART,
- FOSSIL, DigiBoard, Int 14h);
- - Built-in DoorWay-like shell enables remote access to the host sys-
- tem without installing any additional software;
- - SaveTagList (tm). Saving a list of files tagged as being to be
- downloaded after user's hangup;
- - Registration Resume (tm). Resuming of registration procedure in
- case of carrier loss;
- - Tornado upgrade manager (tm). Automatic increasing of user's ac-
- cess level after predefined amount of calls; the Tornado may be
- told to notify the user by placing a message to a message area;
- - Working under multitasking operating systems;
- - Local work mode;
- - Local UpLoad/DownLoad;
- - Support of *.MSG, Hudson, Squish ¿ JAM messagebase formats;
- - Logging all the events to logfile;
- - Multilevel user menus;
- - Convenient SysOp turbointerface;
- - Loading overlay to XMS and EMS;
- - IEMSI protocol support;
- - Multiline work;
- - Tornado Relay Chat: realtime conferencing under multiline working;
- - Viewing archive files by a user;
- - Support of the EXITINFO.BBS and DORINFO.DEF formats;
- - Other features making working with the Tornado pleasant for both
- the SysOp and users.
-
-
- 3. About this document
- ══════════════════════
-
- Creating this documentation, I decided not to follow usual for docu-
- mentation of such kind rules, which are based on thoroughly commented
- configuration files. This documentation covers just major guidelines
- of the Tornado using, as well as possibly unclear matters. All the va-
- riables of the main configuration file are commented so they will just
- be referred to by full variable name and section title.
-
-
- 4. Hardware and software requirements
- ═════════════════════════════════════
-
- 4.1. Hardware requirements
- ──────────────────────────
-
- For the Tornado to work, such hardware configuration is needed:
-
- - IBM PC XT/AT, PS/2 or 100%-compatible computer;
- - Monochrome or color display;
- - /if external modem is used/ Communication (COM) port;
- - Hayes-, Courier-, or Microcom-compatible internal or ext. modem.
-
- NOTE: The OS/2 Tornado version assumes the configuration is conside-
- rable to run OS/2 itself.
-
- 4.2. Software requirements
- ──────────────────────────
-
- For the Tornado to work, such hardware configuration is needed:
-
- ■ DOS version:
- - MS/PC DOS 3.30+ or DR-DOS 3.41+.
-
- ■ OS/2 version:
- - OS/2 2.1+;
- - fossil communication driver (e.g. sio).
-
- 4.3. Additional hardware and software
- ─────────────────────────────────────
-
- The hardware and software mentioned below isn't necessary for the
- Tornado to work, but they will improve work and spread possible area
- the Tornado use:
-
- - EMS/XMS memory (used for swapping program while running external
- applications and commands, as well as for loading TORNADO.OVR
- overlay file);
- - Disk caching programs;
- - Multitasking operating systems and shells (OS/2, MS Windows, Desq-
- View, TopView, VM/386, PC-MOS/386, etc.) which enable running mul-
- tiple Tornado copies to work in multiline mode.
-
- 5. User interface
- ═════════════════
-
- The Tornado has quite easy-to-use interface which has two modes:
- call waiting mode and user session mode.
-
- 5.1. Call waiting mode
- ──────────────────────
-
- Launched without -C and -B switches, the Tornado works in auto mode
- which assumes autonatic calls responding. In this mode, such informa-
- tion is displayed:
-
- - Log Echo window (events list);
-
- - Clock in the upper right corner;
- NOTE: You can disable clock (TORNADO.CTL=>[Miscellaneous]->Clock).
-
- - A window in the lower right corner which displays information abo-
- ut the last 8 BBS users (username, session time, the session up-
- and download size);
-
- - Statistics window (the lower left corner) which displays some bo-
- ard statistics (total calls number, total registered users number,
- number of user messages, number of up- and downloaded files);
-
- - Status line with the help on hotkeys and modem "lights" (CTS -
- clear to send, DSR - data send ready, DR - data ready, RI - ring
- indicator, CD - carrier detected) - at the bottom of the screen.
-
- In this mode are used such hotkeys:
-
- ┌────────┬─────────────────────────────────────────────────────────┐
- │ Hotkey │ Action │
- ├────────┼─────────────────────────────────────────────────────────┤
- │ Alt-A │ Forced call answer │
- ├────────┼─────────────────────────────────────────────────────────┤
- │ Alt-L │ Entering the Tornado in the local mode (similar to the │
- │ │ -L command switch) │
- ├────────┼─────────────────────────────────────────────────────────┤
- │ Esc │ Stopping. In case of call answerring - immediate hangup,│
- │ │ in the call waiting mode - exiting the Tornado │
- └────────┴─────────────────────────────────────────────────────────┘
-
- 5.2. User session
- ─────────────────
-
- While user session all user screen output is copied to SysOp local
- screen (but status line toggled on/off by F10 hotkey). Status line
- displays the user's name, location, access level and time remaining
- for this day, as well as modem "lights", or "Local mode" message if
- local mode is used. Such hotkeys are available in this mode:
-
- ┌────────┬─────────────────────────────────────────────────────────┐
- │ Hotkey │ Action │
- ├────────┼─────────────────────────────────────────────────────────┤
- │ F1 │ Displays help on the hotkeys │
- ├────────┼─────────────────────────────────────────────────────────┤
- │ F2 │ Current session information │
- ├────────┼─────────────────────────────────────────────────────────┤
- │ F10 │ Toggle status line on/off │
- ├────────┼─────────────────────────────────────────────────────────┤
- │ Alt-C │ Chatting with user │
- ├────────┼─────────────────────────────────────────────────────────┤
- │ Alt-E │ User data editing │
- ├────────┼─────────────────────────────────────────────────────────┤
- │ Alt-G │ "Gluck" (makes user think that connection is bad) │
- ├────────┼─────────────────────────────────────────────────────────┤
- │ Alt-H │ Forced session termination and hangup │
- ├────────┼─────────────────────────────────────────────────────────┤
- │ Alt-I │ Displaying a textfile to user │
- ├────────┼─────────────────────────────────────────────────────────┤
- │ Alt-J │ DOS shell (without session break) │
- ├────────┼─────────────────────────────────────────────────────────┤
- │ Alt-L │ Lockout (throwing the user away) - terminating the │
- │ │ current session and making the user disable to reenter │
- │ │ the BBS until increasing his/her zero access level by │
- │ │ the SysOp (using user editor) │
- ├────────┼─────────────────────────────────────────────────────────┤
- │ Alt-S │ Change access level │
- ├────────┼─────────────────────────────────────────────────────────┤
- │ Alt-T │ VIewing list of files tagged by user for download │
- ├────────┼─────────────────────────────────────────────────────────┤
- │ Up/Down│ Increase/decrease user time by 1 min. respectively │
- │ Arrow │ │
- ├────────┼─────────────────────────────────────────────────────────┤
- │ PageUp │ ManualSend (tm) - send previously selected in the File │
- │ │ Manager files to user │
- └────────┴─────────────────────────────────────────────────────────┘
-
- 5.3. Colors customizing
- ───────────────────────
-
- Colors are customized via changing the TORNADO.CTL [Colors] section
- parameters in the apptopriate way. Each parameter sets a color for one
- or several visible screen items. "Blinking" parameter deals with blin-
- king mode. See comments to the parameters in the [Colors] section of
- the sample TORNADO.CTL configuration file for more details.
-
-
- 6. The Tornado workcycle
- ════════════════════════
-
- 6.1. Command line parameters
- ────────────────────────────
-
- -K<filename> - set configuration filename;
- -C<num> - set COM-port number to <num> while running under
- mailer;
- -B<baud> - set connection speed to <baud> while running mai-
- ler;
- -O<filename> - path to and filename of the overlay (in case of
- TORNADO.EXE and TORNADO.OVR files being in dif-
- ferent directories or on different drives);
- NOTE: only valid for DOS version;
- -H<handle> - handle of the communication port;
- NOTE: only valid for OS/2 version;
- -U<user_name> - set name of user entering BBS to <user_name>;
- NOTE: instead of space (" ") must be used under-
- line symbol ("_");
- -L - local work mode;
- -E<time> - time <time> until the next event;
- -N<node_number> - set number of node in case of multiline working;
-
- 6.2. Errorlevel codes
- ─────────────────────
-
- 0 : Normal termination.
- 10 : Work has been stopped at the operator request.
- 200 : Open/read error of the TORNADO.RES file.
- 201 : Open/read error of the main configuration file (TORNADO.CTL).
- 202 : None language descripting file (*.LNG) found in the Tornado
- system directory.
- 203 : Default access level (set in the TORNADO.CTL=>[NewUsers]->Se-
- curity) not found in the LIMITS.CTL file.
- 204 : Opening error of the main menu file (TORNADO.CTL=>[Miscella-
- neous] -> MainMenu).
- 205 : Work directory (TORNADO.CTL=>[System]->Path) not found.
- 206 : Modem initialization error.
- 207 : Open/read error of the users base file (USERS.TOR).
- 208 : Open/read error of the logfile (TORNADO.LOG).
- 209 : Open/read error of the overlay (TORNADO.OVR).
- 210 : Open/read error of the system messages file (TORNADO.MSG).
- 211 : Runtime error. It's desired to inform the author.
- 212 : Not enough memory to run the Tornado.
-
- 6.3. Flagfiles
- ──────────────
-
- While working the Tornado creates so-called flagfiles in the direc-
- tory set in the TORNADO.CTL=>[Files&Dirs]->FlagsDir parameter. They're
- composed from preset filename listed below, and the extension equal to
- line tumber. For example, TOR_FILE.001 flagfile means that line #1
- user has uploaded a file.
-
- Flagfiles filenames:
-
- TOR_RUN - a line with the <extension> number is running;
- TOR_MAIL - user has posted a message to a mail area;
- TOR_FILE - user has uploaded a file to a file area;
- TOR_NCHT - is the SysOp available for chat for now (present flagfile
- means chat is disabled).
-
-
- 7. Customizing
- ══════════════
-
- 7.1. Text color setting codes
- ─────────────────────────────
-
- Color of messages text can be set by using in *.LNG files such commands:
-
- \00 - black;
- \01 - blue;
- \02 - green;
- \03 - cyan;
- \04 - red;
- \05 - magenta;
- \06 - yellow;
- \07 - white;
- \08 - bright black;
- \09 - bright blue;
- \10 - bright green;
- \11 - bright blue;
- \12 - bright red;
- \13 - bright magenta;
- \14 - bright yellow;
- \15 - bright white.
-
- If to replace "\" with "%" the command will impact to the background
- color.
-
- "|" symbol means line break.
-
- The same commands can be used for color customizing for showing file
- descriptions. They should be placed into the FILES.BBS file.
-
- 7.2. Macros
- ───────────
-
- In the text and *.LNG files such macroses can be used:
-
- $NAME - user name;
- $ALAS - user alias;
- $PSWD - user password;
- $DAOB - birthday date;
- $SYSO - SysOp name;
- $BBSN - Board name;
- $LOCA - user location;
- $ORGZ - organization;
- $HPHN - home phone;
- $BPHN - work phone;
- $LDTE - last call date;
- $ADR1 - net addresses;
- $ADR2 ──┤
- $ADR3 ──┘
- $CMNT - commentary;
- $DATE - current date;
- $TIME - current time;
- $SECR - access level;
- $FARE - current filearea name;
- $FGRP - current filegroup name;
- $FNUM - current filearea number;
- $MARE - current message area name;
- $MGRP - current message group name;
- $MNUM - current message area number;
- $ULDS - amount of files uploaded by the user;
- $DNLS - amount of files downloaded by the user;
- $ULKB - total size of files uploaded by the user;
- $DLKB - total size of files downloaded by the user;
- $TTME - time for the user per day according to his/her access level;
- $ETME - time remaining;
- $CALN - number of call to the BBS;
- $FDTE - the first call date;
- $LDTE - the last call date;
- $PROT - name of protocol used for transferring files;
- $LINS - number of lines on screen (taken from user settings);
- $LANG - name of current language of messages;
- $EMUL - name of emulated terminal ("ANSI", "AVATAR", or "TTY");
- $MORE - pause after each screen (yes/no);
- $HKEY - using hotkeys (yes/no);
- $SELK - size of files selected by user;
- $SELN - number of files selected by user;
- $LIMK - daily size limit on downloading files
- $ETTM - prognosed time of transferring all the files;
- $BAUD - connection speed.
-
- If to place some quantity of the "X" symbol after the macro, the macro
- value will be adjusted to the length of <"X" symbols quantity> plus 5
- symbols of the macro itself. This is useful for placing macro's value
- to frames and tables.
-
- 7.3. Setting time intervals
- ───────────────────────────
-
- Some parameters of the configuration files use time intervals. These
- intervals may contain one or more time intervals separated by comma.
- The simplest example is
-
- 23:00-05:30
-
- that means that the interval covers time from 11:00 p.m. to 5:30 a.m.
- daily. One can specify days of week for the command to be executed,
- for example:
- 1.10:00-5.16:00
-
- that means that the interval covers time from 10:00 a.m. to 4:00 p.m.
- for 5 days per week - from Monday to Friday. A number followed by a
- period, that appears before time interval, means day of week number
- (where Sunday is 0, Monday is 1, Tuesday is 2, etc.). Complex
- intervals are allowed, like one below:
-
- 1.22:00-5.06:00,6.00:00-7.24:00
-
- that means 10 p.m. to 6:00 a.m. for Monday to Friday and whole
- Satruday and Sunday; or
-
- 1.09:00-1.17:00,2.09:00-2.15:00,3.12:00-5.18:00,6.21:00-6.23:30
-
- standing for: 9:00 a.m. to 5:00 p.m. on Monday, 9:00 a.m. to 3:00 p.m.
- on Tuesday, 12:00 a.m. to 6:00 p.m. from Wednesday to Friday, 9:00
- p.m. to 11:30 p.m. on Saturday, and no intervals on Sunday.
-
- 7.3. .A?? filenames
- ───────────────────
-
- Files with preset names and .ANS/.ASC/.AVT extensions (depending on
- whether the terminal supports ANSI screen codes or no) and located in
- the directory set in current *.LNG file ( [Files]->TxtFiles ) will be
- displayed in such a way:
-
- WELCOME - before request for scanning message areas and file areas;
- LOGOFF - at the end of user working with the BBS via selecting cor-
- responding menu item;
- LOCKOUT - at user lockout (forced by SysOp termination of user work
- with getting impossible to enter the BBS under the same na-
- me any further). If such a user tries to enter the BBS af-
- ter having been locked out, he/she will be shown this file
- once again and the system will hang off;
- NEWUSER1 - after positive answer to the question about beginning of
- registration of the new user;
- NEWUSER2 - just after ending of the new user registration;
- BADUSER - at entering of the user listed in the bad users list;
- GOODUSER - at entering of the user listed in the good users list;
- TOOSLOW - at entering of the user connected at the speed less than
- minimal one (set in TORNADO.CTL => [Modem] -> Min_Speed);
- NOTAVAIL - at request for SysOp in ádmissible time.
-
- Each message language is given path to the menu files and text .ASC/
- .ANS/.AVT files in the corresponding .LNG-file.
-
- 7.4. Access levels and user semaphores
- ──────────────────────────────────────
-
- To separate privileges of different users, there exist so-called ac-
- cess levels (or security levels). They define a possibility for user
- to make an action. If user's access level is less than the one needed
- for the action to be done, the user won't do this action anyway.
-
- Actions to be allowed/forbidden are described in the configuration
- file. Access levels and corresponding limits are set in the LIMITS.CTL
- configuration file. The default access level assigned to a user while
- registration is set by the TORNADO.CTL=>[NewUsers]->Security parameter.
-
- If, suppose, it's necessary to allow/forbid some actions to the
- users of the same access level (and therefore of the same limits), and
- it's undesirable to change limits, one should use flagd which provide
- very comfortable and flexy tool of privileges customizing. Flag is an
- uppercase letter (just flag) or set of those uni-letter flags. User
- info contains specific for the user flag string. If it contains all
- the necessary flags to do an action, this action is allowed, otherwise
- it isn't.
-
- Examples:
-
- User flag string │ Needed flags │ Action status
- ─────────────────┼──────────────┼──────────────
- ABCD │ ABD │ Enabled
- ABCD │ ACF │ Disabled
- ABCDEFGHIJKLMNOP │ AJO │ Enabled
- A │ ABC │ Disabled
-
- The default registration flags are set in the TORNADO.CTL->NewUsers
- ->Security parameter. They must be separated form access level value
- by a space (" "). This is true for all the parameters dealing with ac-
- cess level (e.g., FILEAREA.CTL->List_Security; MSGAREA.CTL->Read_Secu-
- rity; etc.).
-
- 7.5. Messages language customizing
- ──────────────────────────────────
-
- All the Tornado messages to user are customizable. All the messages
- and paths to text and menu files are set using language .LNG-files lo-
- cated in the Tornado system directory. At the very beginning of a user
- registration, the user is asked to choose a language among available
- to work with the BBS. This menu is composed of titles described in the
- .LNG-files. If there is just one .LNG-file, it's automatically assumed
- as default.
-
- Each .LNG-file contains 3 sections:
-
- [Main] -- with just one parameter:
- Name -- Title of messages language;
-
- [Files] -- defines paths to be used to search the language files, as
- well as their filenames;
- TxtFiles -- path to the text files (.ASC/.ANS/.AVT) for the language;
- Menus -- path to the menu files for the language;
- News -- path to the news file for the language;
-
- [Language_Section] -- section containing messages bodies; see sample
- .LNG-files supplied for more detailed info.
-
- 7.6. User menu customizing
- ──────────────────────────
-
- Menus are an important part helping a user to choose an action to do.
- Like all the other Tornado configuration files, menu files are in text
- form. They must be located in the directory specified by the [Files]
- ->Menus of the appropriate language file. Menu files are a .MNU exten-
- sion as default and contain 2 sections:
-
- [Header] -- contains global settings and is composed of 3 parame-
- ters:
- DisplayFile -- file to display (.ASC/.ANS/.AVT) depending on the cho-
- osen terminal emulation. If none is set, a list of the
- menu items will be shown;
- Prompt -- a string to be shown while waiting for the user to
- choose; may contain macroses and color sequences;
- WriteHotKeys -- "Yes" or "No"; defines whether to show hotkeys list
- after having shown all the menu items and before disp-
- laying the string defined by the "Prompt" parameter;
-
- and
-
- [Menu] -- A set of strings defining each choose variant. For
- example:
-
- Gosub_Menu+ "files" ABC 0 "\14(\15F\14) \02öá⌐½δ |" F
- ^^^^^^^^^^^(1) ^^^^^(2) ^^^(3) ^(4) ^^^^^^^^^^^^^^^^^^^^^^^^^^(5) ^(6)
-
- where
- (1) The action to be done on choosing this menu item. "Gosub_Menu"
- in the example means going to another menu file;
- NOTE: a plus sign ending the action identifier means this action is
- the "autoexec" one (i.e. it'll be done just after displaying
- menu).
- (2) Optional data (additional info needed to implement the action;
- in the example they contain menu file name to be gone to in case
- of choosing this menu item);
- (3) Flags authorizing access to this menu item;
- (4) Minimal access level (zero in the example means this item is
- accessible foe any user of access level greater than zero);
- (5) Text to be displayed for this item; the example text contains
- color sequences; see Chapter 7 for more info about them;
- (6) Hotkey to activate item (in the example - the "F" key).
-
- Below is the actions list with brief description and optional data:
-
- ──────────────────────────────────────────────────────────────────────
- Action : Gosub_Menu
- Effect : Going to another menu
- Optional data : Menu file name
- ──────────────────────────────────────────────────────────────────────
- Action : DownLoad
- Effect : File(s) download. If filename is specified as optional
- data, this file will be downloaded; otherwise a user
- will be prompted to tag file in the current file area.
- Optional data : Filename to download / None
- ──────────────────────────────────────────────────────────────────────
- Action : UpLoad
- Effect : File upload to the directory specified in the optional
- data, or to the directory specified by the ULPath
- parameter of the current file area description.
- Optional data : Directory for upload / None
- ──────────────────────────────────────────────────────────────────────
- Action : UpLoad_Priv
- Effect : Special action for the Private uploads (tm) feature.
- A user is asked for user name the files will be sent
- to, then these files will be uploaded and .LST-file
- will be created. After the adressee having entered the
- BBS he/she will be proposed to download these files.
- Optional data : Directory for upload
- ──────────────────────────────────────────────────────────────────────
- Action : Return
- Effect : Return to the previous menu
- Optional data : None
- ──────────────────────────────────────────────────────────────────────
- Action : LogOFF
- Effect : Session ending
- Optional data : None
- ──────────────────────────────────────────────────────────────────────
- Action : Change_FGroup
- Effect : Change file group of the number specified in the opti-
- onal data or chosen from a list if none specified;
- Optional data : File group number / None
- ──────────────────────────────────────────────────────────────────────
- Action : Change_FArea
- Effect : Change file area. If its number is specified in the
- optional data, this area becomes the current one,
- otherwise user is prompted to choose an area from the
- list.
- Optional data : File area number / None
- ──────────────────────────────────────────────────────────────────────
- Action : User_Info
- Effect : Information about user whose name is specified in the
- optional data.
- Optional data : User name
- ──────────────────────────────────────────────────────────────────────
- Action : Msg_Post
- Effect : Compose a message to the mail area with number
- specified in the optional data, or to the current one
- if none number specified.
- optional data.
- Optional data : Mail area
- ──────────────────────────────────────────────────────────────────────
- Action : FileList
- Effect : Shows filelist in the current file area or file area
- with the number specified.
- optional data.
- Optional data : File area number / None
- ──────────────────────────────────────────────────────────────────────
- Action : Display_File
- Effect : Display a file with filename specified in the optional
- data and path specified by the [Files] -> TxtFiles
- variable of the current .LNG-file.
- Optional data : Filename
- ──────────────────────────────────────────────────────────────────────
- Action : Page_SysOp
- Effect : Call sysop for chatting on topic specified it the
- optional data. User will be asked for topic if none
- specified.
- Optional data : Chat topic
- ──────────────────────────────────────────────────────────────────────
- Action : Shell
- Effect : Entering built-in DoorWay
- Optional data : None
- ──────────────────────────────────────────────────────────────────────
- Action : Change_MsgGroup
- Effect : Change message group to the one with number specified
- in the optional data or chosen from the list if none
- number specified.
- Optional data : Message group number/ None
- ──────────────────────────────────────────────────────────────────────
- Action : Change_Msg_Area
- Effect : Change message area to the one with number specified
- in the optional data or chosen from the list if none
- number specified.
- Optional data : Message area number.
- ──────────────────────────────────────────────────────────────────────
- Action : Msg_Read
- Effect : Reading messages in the message area with number spe-
- cified in the optional data or in the current one if
- none number specified.
- Optional data : Message area number
- ──────────────────────────────────────────────────────────────────────
- Action : Msg_List
- Effect : Listing messages in the message area with number spe-
- cified in the optional data or in the current one if
- none number specified.
- Optional data : Message area number
- ──────────────────────────────────────────────────────────────────────
- Action : Display_Text
- Effect : Displays text specified in the optional data
- Optional data : Text to be displayed
- ──────────────────────────────────────────────────────────────────────
- Action : System_Info
- Effect : Show system information
- Optional data : None
- ──────────────────────────────────────────────────────────────────────
- Action : Goto_Menu
- Effect : Going to menu specified in the optional data. Unlike
- GoSub_Menu, return to the previous menu is disable.
- Optional data : Menu file name.
- ──────────────────────────────────────────────────────────────────────
- Action : Exec
- Effect : Launch a program
- Optional data : Program/command name
- NOTE: Such macroses may be used:
- *P - Number of the used communication port;
- *B - Connection speed;
- *H - COM-port handle (for OS/2 version only)
- *G - Using ANSI-graphics (1 - yes, 0 - no)
- *F - The user first name;
- *L - The user last name;
- *T - Time remaining for the user
- For example:
- door.exe /c*P /b*B
- will be expanded into
- door.exe /c1 /b2400
- if COM1 is used and connection speed is 2400 bps
- ──────────────────────────────────────────────────────────────────────
- Action : Scan_NewFiles
- Effect : Scanning all file areas for new files since the last
- user session.
- Optional data : None
- ──────────────────────────────────────────────────────────────────────
- Action : Scan_PrivMail
- Effect : Scanning all the message areas for unread messages to
- the user.
- Optional data : None
- ──────────────────────────────────────────────────────────────────────
- Action : Send_Msg
- Effect : Send a message to a user connected via another line
- while running in multiline mode
- Optional data : None
- ──────────────────────────────────────────────────────────────────────
- Action : Set_Msg_Off
- Effect : Disables getting messages from users on other lines
- while running in multiline mode
- Optional data : None
- ──────────────────────────────────────────────────────────────────────
- Action : Set_Msg_On
- Effect : Opposite to Set_Msg_Off
- Optional data : None
- ──────────────────────────────────────────────────────────────────────
- Action : Line_List
- Effect : List of users on others BBS lines
- Optional data : None
- ──────────────────────────────────────────────────────────────────────
- Action : Change_Param
- Effect : Changes user parameter, specified in optional data by
- one of such letters:
- A - location;
- B - work/education place;
- C - network addressess;
- D - password;
- E - home phone;
- F - work/modem phone;
- G - date of birth;
- H - display lines;
- I - messages language;
- J - transfer protocol;
- K - using ANSI-sequences;
- L - pause after each screen;
- M - using of hotkeys;
- N - using of "framed" input fields;
- O - alias.
- Optional data : Parameter letter.
- ──────────────────────────────────────────────────────────────────────
- Action : ArcView
- Effect : Viewing an archive file from the current file area or
- the specified archive file.
- Optional data : Path to and name of the archive file/
- ──────────────────────────────────────────────────────────────────────
- Action : Re_Login
- Effect : Re-enter the BBS using another username without dis-
- connect.
- Optional data : None
- ──────────────────────────────────────────────────────────────────────
- Action : Todays_Callers
- Effect : Displays list of today callers.
- Optional data : None
- ──────────────────────────────────────────────────────────────────────
- Action : News
- Effect : Viewing news.
- Optional data : None
- ──────────────────────────────────────────────────────────────────────
- Action : Conference
- Effect : Enter the Realtime Conference while running in multi-
- line mode.
- Optional data : None
- ──────────────────────────────────────────────────────────────────────
- Action : Questionarie
- Effect : Based on the specified in the optional data .Q-A file
- questioning of a user.
- Optional data : .Q-A file name
- ──────────────────────────────────────────────────────────────────────
- Action : Next_FileArea
- Effect : Quick going to the next file area.
- Optional data : None
- ──────────────────────────────────────────────────────────────────────
- Action : Prev_FileArea
- Effect : Quick going to the previous file area.
- Optional data : None
- ──────────────────────────────────────────────────────────────────────
- Action : Next_MsgArea
- Effect : Quick going to the next message area.
- Optional data : None
- ──────────────────────────────────────────────────────────────────────
- Action : Prev_MsgArea
- Effect : Quick going to the previous message area.
- Optional data : None
- ──────────────────────────────────────────────────────────────────────
- Action : Next_FileGroup
- Effect : Quick going to the next file group.
- Optional data : None
- ──────────────────────────────────────────────────────────────────────
- Action : Prev_FileGroup
- Effect : Quick going to the previous file group.
- Optional data : None
- ──────────────────────────────────────────────────────────────────────
- Action : Next_MsgGroup
- Effect : Quick going to the next message group.
- Optional data : None
- ──────────────────────────────────────────────────────────────────────
- Action : Prev_MsgGroup
- Effect : Quick going to the previous message group.
- Optional data : None
- ──────────────────────────────────────────────────────────────────────
-
-
- 7.7. Running the Tornado under mailer
- ─────────────────────────────────────
-
- As you may already have seen, run without parameters the Tornado is
- switched to auto mode. But it's not comfortable if you're using mai-
- lers which are used in different networks like FIDONet. To eliminate
- this unconvenience, there exist a way to run the Tornado under the
- mailer. The explanation below assumes you're using T-Mail, but even if
- you prefer another one, all is done in the similar way. So first of
- all it's necessary to put
- ---
- Process BBS exebbs.bat *P *B *T *H
- ---
- line into the T-MAIL.CTL file. This line means that at request to the
- BBS will be launched EXEBBS.BAT file with *P (port), *B (connection
- speed), *T (line number), *H (time to the nearest event) given as pa-
- rameters. The EXEBBS.BAT must contain the following lines:
- ---
- cd <path_to_the_Tornado>
- tornado exe -c%1 -b%2 -n%3 -e%4
- ---
- Given a -B or -C parameter, the Tornado assumes itself running under
- mailer and the connect already established. (Refer to Chapter 5 for
- more info about the Tornado command-line parameters.)
-
- 7.8. Some notes about multiline mode
- ────────────────────────────────────
-
- If You are familiar to features of multiline work of the Sf-Mail or
- T-Mail mailers, you shouldn't get confused with the Tornado multiline
- mode. The Tornado uses just one configuration file for all the lines.
- It's obvious, however, that at least communication ports specifica-
- tions must differ depending on line(s), i.e. each line must possess
- its own port. For this to be done, for ALL the *.CTL files such syntax
- is assumed:
- ----------------
- {N,N1,N2,...,Nx} Parameter Value
- ----------------
- where N,N1,N2,...,Nx - lines numbers,
- Parameter - configuration parameter set to <Value>
-
- for example
- ----------------
- [System]
- {1} BBSName "Pulse BBS line 1"
- {2} BBSName "Pulse BBS line 2"
-
- [Modem]
- {1} Port 1
- {2} Port 2
- ---------------
-
- Parameters without the "{N}" modifier are considered as similar for
- all the lines. So all seems to be quite simple. You are just to set
- parameters which must differ depending on line(s) and to run the Tor-
- nado in several windows (depending on amount of lines) under any mul-
- titasking environment with command line parameter
- -N<node_number>
- where <node_number> is a number of the line to be used.
-
-
- 8. Advanced features
- ════════════════════
-
- The Tornado has a plenty of advanced (service) features which make
- work with it more comfortable and easy.
-
- 8.1. Built-in DoorWay
- ─────────────────────
-
- The Tornado implements remote access of a user to the host computer
- file system. Entering the DoorWay is done via selecting "DoorWay" menu
- item. In order to provide secutity, there used thorough ranking of
- commands availability according to users' access level. The DoorWay
- configuration file, DOORWAY.CTL, is commented in detail, so you can
- refer to it for further information. You can get a list of commands
- with brief description by entering HELP command. To get available pa-
- rameters of a command, once just need to follow it by "/?" switch.
-
- 8.2. ManualSend (tm)
- ────────────────────
-
- I often faced to unconvenience of sending to a user a file located
- not in any file area. So I decided to ease this task up. Well, if the
- SysOp was asked for a file and a user would get it immediately, SysOp
- doesn't need anymore to place the file into a file area and do the
- other not-so-funny things making the user wait. The only thing needed
- is to press PgUp, to select a directory containing files to send, then
- to select files to send (INS key) and to press Enter. All is done!
-
- 8.3. SaveTagList (tm)
- ─────────────────────
-
- Have you ever seen tortures of a poor user who have disconnected be-
- cause of noised line after having selected files to download, and af-
- ter re-connection had to re-select all the needed files? It's obvious
- that it'd be very comfortable to save taglist so that the user won't
- need to re-select files at re-entering, thus freeing the session time.
- Taglist saving mode (SaveTagList) is activated by the TORNADO.CTL =>
- [Miscellaneous] -> Save_Tag_List parameter. Catalog to store list fi-
- les for each user is set by the TORNADO.CTL => [Files&Dirs] -> Sa-
- ve_Tag_Path parameter. Name of these files is username's CRC32 in he-
- xadecimal format, the preset extension is .LST.
-
- 8.4. The Tornado Upgrade Manager (tm)
- ─────────────────────────────────────
-
- The Tornado Upgrade Manager changes users' access level on some no-
- table events (10th or 100th call, someone's birthday, etc). The SysOp
- can define conditions for change access level to take effect (to pre-
- vent "increase" from 10th level, manually assigned to the user, to the
- default 2nd level, or other misunderstandings likewise). The user may
- be informed about the change either by message from the SysOp or by
- displaying the appropriate .ANS/.ASC/AVT file. The change will be ac-
- tual either while the change day or till other changes. For further
- info on customizing the Tornado Upgrade Manager please refer to com-
- mented sample configuration file UPGRADER.CTL
-
- 8.5. Registration Resume (tm)
- ─────────────────────────────
-
- If the registration process has been terminated because of discon-
- nect, user don't need to restart it from the very beginning anymore.
- Since the registration process is rather long and boring, while phone
- lines often are noised, the re-registration process may get almost
- everlasting and very annoying. That's why the Registration Resume is
- of great use. The Registration Resume is activated by the TORNA-
- DO.CTL=>[NewUsers]->Reg_Resume parameter.
-
- 8.6. Private Uploads (tm)
- ─────────────────────────
-
- This feature enables users to exchange with files using the BBS as a
- temporary storage. There exist special catalog for such operations.
- It's specified by the TORNADO.CTL => [Files&Dirs] -> Priv_Uploads_Dir
- parameter. The files to some user will only be downloaded by the ad-
- dressee user and then will be deleted. Filelists are stored in the
- .LST files located in the directory specified in the TORNADO.CTL=>[Fi-
- les&Dirs]->Save_Tag_Path parameter. See also menu action Upload_Priv.
-
-
- 9. Other info
- ═════════════
-
- 9.1. Acknowledgements
- ─────────────────────
-
- The author would express a great gratitude to the all who helped de-
- veloping and testing the Tornado, noticed and informed the author abo-
- ut errors. Special thanks to:
-
- ■ Alex Radzishevskiy (2:461/113@fidonet.org) - one of my best friends
- and the Tornado Team programmer. He has created the Tornado window
- interface, the DoorWay, and other useful stuff. He was one of the
- founding fathers of the Tornado project. He has been forced to leave
- Kharkov (on June 30,1996), now he lives in Petropavlovsk-Kamchatskiy,
- Russia. He is going to return to Kharkov in several years. [Tornado
- Team].
-
- ■ Vlad Bakaev (2:461/76@fidonet.org, dandy@sline.esc.kharkov.ua) - yet
- another my friend and programmer of the Tornado Team. He is author
- of the modules interfacing with the FILES.BBS file, parsing text
- configuration files, etc. He is keeping working hard on the Tornado
- project. The Tornado Co-Author. [Tornado Team].
-
- ■ Vadim Kostoglodoff (2:461/588@fidonet.org,vadim@sline.esc.kharkov.ua)
- The Tornado Internet provider. [Tornado Team].
-
- ■ Maxim Lyashenko (2:461/585@fidonet.org) - the author of the macroses
- treating module and some other string-related stuff. Active tester.
- [Tornado Team].
-
- ■ Jack Lensky (2:461/686@fidonet.org). Active tester. [Tornado Team].
-
- ■ Dima Orlov (2:461/27@fidonet.org, do@free.kpi.kharkov.ua) - he has
- been taking active part in developing the project from the very be-
- ginning till now; besides, almost all the source code has been typed
- using really perfect DOS-shell CONNECT (The IBM HandShaker), Dima
- being one of its authors.
-
- ■ Alex Shakhajlo (2:461/700@fidonet.org) - active testing since the
- first versions, useful notes and advices.
-
- ■ Alexey Solomonov (2:5030/142@fidonet.org) - kindly offered source
- code and perfect mailer Sf-Mail, the Tornado interface being a pla-
- giate of the Sf-Mail one ;). [Santa Fox Team].
-
- ■ Anton the Deinow (2:5030/143@fidonet.org) - kindly offered source
- code of his libraries, active testing and useful advices. [Santa Fox
- Team].
-
- ■ Vladimir Lazarenko (2:461/106@fidonet.org,vlad@sline.gtm.kharkov.ua)
- - testing, translation of commentaries in the configuration files
- into English.
-
- ■ Oleg Deribas (2:461/13@fidonet.org) - active testing and creative
- thoughts about new features of the Tornado, helping the author to
- implement them; creating useful utilities.
-
- ■ Peter Suchkow (2:5030/51@fidonet.org) - the Tornado distribution wi-
- thin the frameworks of the GSS project; he has taken active part in
- promoting the Tornado abroad exUSSR.
-
- ■ Vadim Vasilenko (2:461/588.44@fidonet.org, vadushka@sline.gtm.khar-
- kov.ua) - translation of the documentation into English; active
- user-side ;) testing.
-
- ■ TurboPower SoftWare, Async stuff;
-
- ■ Mark May & Vadim Rumyantsev, library of messagebases treating;
-
- ■ Special great gratitude to the Borland International Inc for excel-
- lent development tool Borland Pascel 7.0;
-
- ■ Special great thanks to ex-compatriot Vitaly Miryanov for perfect
- Virtual Pascal compiler which has been used to assemble the OS/2
- version of the Tornado;
-
- ■ Now, thanks to me :)
-
- 9.2. Distribution and the author's responsibility
- ─────────────────────────────────────────────────
-
- This version of the Tornado is a freeware. This means you can feel
- free to use it in the way you like BUT any commercial purpose without
- preliminary agreement of the author. The Tornado is distributet in the
- "as is" form, accordingly to the common international AS IS principle.
- This means, that the author isn't responsible in any way for any dama-
- ge or loss caused by using the Tornado. You are using it at your own
- risk.
-
- 9.3. Support
- ────────────
-
- The Tornado program is distributed within frameworks of the
-
- ─────────────────────────────────────■■■■■─────■■■■■────■■■■■──
- ──General───────────────────────────■─────────■────────■───────
- ──────────Software─────────────────■──■■■──────■■■──────■■■────
- ───────────────────Support────────■────■─────────■────────■────
- ──────────────────────────────────■■■■■─────■■■■■────■■■■■─────
-
- project.
-
- The most recent versions are available immediately at the author's bo-
- ard (main Tornado support board) Pulse BBS:
-
- Phone : [0572] 47-4765
- Work Time : 23:00-07:00
- BBS : present
- Freqs : allowed
- FIDO : 2:461/22
-
- NOTE: WorkTime means Kiev time (UTC +3)
-
- If You are FIDONet member, you can FReq the most recent beta-version
- using TORNADO (DOS version) or TORNADO2 (OS/2 version) alias, as well
- as alpha-version - using ALPHA or ALPHA2 aliases respectively.
-
- Besides, there is TORNADO fileecho used to distribure recent versions
- of the Tornado and various utilities for it.
-
- The Tornado is also supported within the TORNADO.SUPPORT and GSS.GENE-
- RAL echoconferences of the FIDONet.
-
- If you are provided with the Internet connectivity, you can FTP the
- most recent Tornado version at these FTP servers:
-
- ftp://gss.bm.spb.ru/gss/commun/
- ftp://itl.net.ua/pub/msdos/serial/
- ftp://opera.kharkov.ua/msdos/bbs/
-
- Or via WWW:
-
- Konst's Web Site : http://sline.gtm.kharkov.ua/~konst
- Tornado Web Site : http://www.danbbs.dk/~alexie/tor/
-
-
- If You feel irresistible desire to thank the author for his work, just
- contact me, and we together with the Tornado Team programmers will
- appreciate it in any form with pleasure.
-
- 9.4. The author
- ───────────────
-
- If You have any ideas or propositions concerning the Tornado, you can
- contact me is such ways:
-
- - call me by voice phone (380-572-474765) at a reasonable time (this
- is home phone) and ask Konstantin;
-
- - if You are kharkovite or plan to visit Kharkov, you can visit so-
- called "prooliovka" - weekly party of the Kharkov FIDOnet members,
- that takes place at Tuesdays 18:00 in the Gogol' St. (just in front
- catholic church);
-
- - mail me to such net addressess:
-
- FIDONet : 2:461/22 (Konstantin Klyagin)
- 2:461/76 (Vlad Bakaev, co-author)
-
- E-Mail : konst@sline.gtm.kharkov.ua,
- konst@antisocial.com,
- k0nst@usa.net,
- Konstantin.Klyagin%p0.f22.n461.z2@fidonet.org
-
- 9.5. Trademarks
- ───────────────
-
- Registered and unregistered trademarks:
- ─────────────────────┬───────────────────────────────────────────
- Tornado │ Konstantin Klyagin & Tornado Team
- Upgrade manager │ Konstantin Klyagin & Tornado Team
- SaveTagList │ Konstantin Klyagin & Tornado Team
- ManualSend │ Konstantin Klyagin & Tornado Team
- Registration Resume │ Konstantin Klyagin & Tornado Team
- RemoteAccess │ Andrew Milner & Wantree Development Corp.
- Maximus │ Scott Dudley
- Borland Pascal 7.0 │ Borland International, Inc.
- Sf-Mail │ SantaFox Team
- T-Mail │ Andy Elkin
- Fido, FidoNet │ Tom Jennings and Fido Software
- OS/2 │ International Business Machines Corp.
- MS-DOS │ MicroSoft Corp.
- ─────────────────────┴───────────────────────────────────────────
-