/======================================\
< T.A.G. Version 2.6d Menu Documentation >
\======================================/
/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
/\/\/\/ [>> Welcome to <<] \/\/\/\
| /\/ ______________ ______ ___________ \/\ |
| / / / /| / /| / /\ \ \ |
| / / TTTTTTTTTTTTTT/ AAAAAA /| GGGGGGGGGGG\/| \ \ |
|/\/ /\ TT | AA|___AA /| GG | GG/ /\ \/\|
|-< < > TT | AA/ AA /| GG | _____ < > >-|
|\/\ \/ TT | AAAAAAAAAAAA | GG | / /| \/ /\/|
| \ \ TT | AA | AA | GG |__GGGGGG | / / |
| \ \ TT | AA | AA | GG/ GG | / / |
| \/\ TT/ <> AA/ AA/ <> GGGGGGGGGGG/ <> /\/ |
\/\/\/\ /\/\/\/
\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/
/============================\
/ T.A.G. Bulletin Board System \
< Copyright (C) 1986-1993 >
\ The T.A.G. Team /
\============================/
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
>>> Table of Contents <<<
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Definition of Terms Used in this Document . . . . . . . . . . . . . . . 1
Access Restriction Flag or AR Flag . . . . . . . . . . . . . . . . . 1
Download Security Level or DSL . . . . . . . . . . . . . . . . . . . 1
Program Data or Pdata . . . . . . . . . . . . . . . . . . . . . . . 1
Program Key or Pkey . . . . . . . . . . . . . . . . . . . . . . . . 1
Security Level or SL . . . . . . . . . . . . . . . . . . . . . . . . 2
Special Flag or SF . . . . . . . . . . . . . . . . . . . . . . . . . 2
Description of Menu Header Information . . . . . . . . . . . . . . . . 2
Menu list number . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Menu number . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Menu name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Prompt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
General SL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
AR flag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Menu Starting Help Level . . . . . . . . . . . . . . . . . . . . . . 3
Help file ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Fallback menu . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Menu location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Flags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
<SL/DSL> access check . . . . . . . . . . . . . . . . . . . . . . 4
GSL <and/or> AR . . . . . . . . . . . . . . . . . . . . . . . . . 4
Time/Help <ON/OFF> . . . . . . . . . . . . . . . . . . . . . . . 4
Board <NORMAL/ON> . . . . . . . . . . . . . . . . . . . . . . . . 4
Menu name <NORMAL/PROMPT> . . . . . . . . . . . . . . . . . . . . 4
Description of Command Information . . . . . . . . . . . . . . . . . . 5
Command number . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Long description . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Short description . . . . . . . . . . . . . . . . . . . . . . . . . 5
Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
General SL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
AR flag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Program key . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Program data . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Flags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
<SL/DSL> access check . . . . . . . . . . . . . . . . . . . . . . 6
GSL <and/or> AR . . . . . . . . . . . . . . . . . . . . . . . . . 6
<Normal/Hidden> Command . . . . . . . . . . . . . . . . . . . . . 6
Sample command . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Predefined Menu Commands Available on All Menus . . . . . . . . . . . . 7
<space> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
<enter> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
\ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
FALLBACK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
===========================================================================
January, 1993 (Preliminary) Page i
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
>>> Table of Contents <<<
General Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Maximum Menus/Commands . . . . . . . . . . . . . . . . . . . . . . . 8
Executing commands with more than one character . . . . . . . . . . 8
Commands with a key of more than one character . . . . . . . . . . . 8
If commands act strange . . . . . . . . . . . . . . . . . . . . . . 8
Default command . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Blank Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
AUTOEXEC command . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Read Message Menu restrictions . . . . . . . . . . . . . . . . . . . 8
SDR Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Message Searches . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Command Definition Key . . . . . . . . . . . . . . . . . . . . . . . . 9
Text conventions . . . . . . . . . . . . . . . . . . . . . . . . . . 9
" | " . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
"< ... >" . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
"[ ... ]" . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Command flags . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
(*<#>) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
@ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
@! . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Linked Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Linked command example . . . . . . . . . . . . . . . . . . . . . . . 10
How T.A.G. handles link commands . . . . . . . . . . . . . . . . . . 11
Standard Program Keys Available from all Menus . . . . . . . . . . . . 12
"!" [@]<Filename>[.Ext] Display a text file . . . 12
"@" [<User #>] Page the SysOp . . . . . . 12
"#" Change sections . . . . . 13
"$" Version Information . . . 13
"^" [C]<Menu #> Goto another menu . . . . 13
"/" [C]<Menu #> Gosub another menu . . . 14
"\" [C] Return to saved menu . . . 14
"&" Sysop Status . . . . . . . 14
"*" [<User #> | I | T] Logoff system . . . . . . 15
"(" Menu information . . . . . 15
"|" [F]<Section #> Change to a section . . . 16
"[" Search Backward . . . . . 16
"]" Search Forward . . . . . . 16
"0" <Filename> Generate random message . 17
"1" <A|B|D|F|L|M|P|S|U|V> Execute function . . . . . 17
"A" @ Access validation manager (*3) . . . . . . . . . . . . . . 17
"B" @ Message board editor (*2) . . . . . . . . . . . . . . . . . 17
"D" @ Mini-DOS command system . . . . . . . . . . . . . . . . . . 17
"F" @ File board editor (*2) . . . . . . . . . . . . . . . . . . 17
"L" @ Batch protocol editor (*2) . . . . . . . . . . . . . . . . 17
"M" @! Menu editor (*3) . . . . . . . . . . . . . . . . . . . . . 18
"P" @ Single protocol editor (*2) . . . . . . . . . . . . . . . . 18
"S" @/@! System configuration editor (*2/*3) . . . . . . . . . . 18
"U" @ User log editor (*1) . . . . . . . . . . . . . . . . . . . 18
"V" @! Events editor (*2) . . . . . . . . . . . . . . . . . . . . 18
===========================================================================
January, 1993 (Preliminary) Page ii
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
>>> Table of Contents <<<
"." (*3) @! Shell to DOS . . . . . . . 18
"0" <Key> Execute Command Key . . . 19
"9" [M or F][$ or <Group Mask>] Change Group Mask . . . . 19
External DOOR Program Keys . . . . . . . . . . . . . . . . . . . . . . 20
":" [@][*]<Filename> RBBS door program (NEW format) . . . . . . . . 20
"_" [@][*]<Filename> RBBS door program (OLD format) . . . . . . . . 20
"=" [@][*]<Filename> DOOR.SYS and GAP(tm) door programs . . . . . . 21
"<" [@][*]<Filename> Execute a generic door program . . . . . . . . 22
Multinode Program Keys . . . . . . . . . . . . . . . . . . . . . . . . 23
"B" [Broadcast] . . . . . . . . . . . . . . . . . . . . . . . . . . 23
"M" [Message] . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
"W" [WhoIsOn] . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
"C" [Chat] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Main System Program Keys . . . . . . . . . . . . . . . . . . . . . . . 24
"A" List message areas . . . . . . . . . . . 24
"B" Bulletin system . . . . . . . . . . . . . 24
"C" Create auto-message . . . . . . . . . . . 24
"D" <0..40> User information functions . . . . . . . 25
"0" List user information that can be changed . . . . . . . . . 25
"1" Change the user's real name . . . . . . . . . . . . . . . . 25
"2" Change the user's address . . . . . . . . . . . . . . . . . 25
"3" Change the user's city & state . . . . . . . . . . . . . . . 25
"4" Change the user's zip code . . . . . . . . . . . . . . . . . 25
"5" Change the user's phone number . . . . . . . . . . . . . . . 25
"6" Change the user's computer type . . . . . . . . . . . . . . 25
"7" Change the user's ANSI colors . . . . . . . . . . . . . . . 25
"8" Change the user's birthday . . . . . . . . . . . . . . . . . 25
"9" Change the user's highest baud . . . . . . . . . . . . . . . 25
"10" Change the user's screen size (columns and lines) . . . . . 25
"11" Toggle the user's ANSI status . . . . . . . . . . . . . . . 25
"12" Toggle the user's color status . . . . . . . . . . . . . . . 25
"13" Change the user's logon password . . . . . . . . . . . . . . 25
"14" Change the user's external editor status . . . . . . . . . . 25
"15" Toggle the user's [PAUSE] status . . . . . . . . . . . . . . 25
"16" Toggle the user's onekey status . . . . . . . . . . . . . . 25
"17" Toggle the user's VT-100 type tab status . . . . . . . . . . 25
"18" Toggle the user's CLS status . . . . . . . . . . . . . . . . 25
"19" Change the user's mailbox configuration . . . . . . . . . . 25
"20" Change which bases the user new scans . . . . . . . . . . . 25
"21" Change menu to logon at (NOT supported) . . . . . . . . . . 25
"22" Change the user's help level . . . . . . . . . . . . . . . . 25
"23" Toggle the user's custom menu status . . . . . . . . . . . . 25
"24" Toggle the user's clear screen before message status . . . . 25
"25" Toggle the user's do not disturb status . . . . . . . . . . 25
"26" Change the user's phone number 2 . . . . . . . . . . . . . . 25
"27" Change the user's extra string 1 . . . . . . . . . . . . . . 25
"28" Change the user's extra string 2 . . . . . . . . . . . . . . 25
"29" Change the user's extra string 3 . . . . . . . . . . . . . . 25
===========================================================================
January, 1993 (Preliminary) Page iii
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
>>> Table of Contents <<<
"30" Change the user's extra date 1 . . . . . . . . . . . . . . . 25
"31" Change the user's extra date 2 . . . . . . . . . . . . . . . 25
"32" Change the user's extra number 1 . . . . . . . . . . . . . . 25
"33" Change the user's extra number 2 . . . . . . . . . . . . . . 25
"34" Change the user's extra number 3 . . . . . . . . . . . . . . 25
"35" Change the user's extra number 4 . . . . . . . . . . . . . . 25
"36" Change the user's extra character 1 . . . . . . . . . . . . 25
"37" Change the user's extra character 2 . . . . . . . . . . . . 25
"38" Change the user's extra character 3 . . . . . . . . . . . . 25
"39" Change the user's extra character 4 . . . . . . . . . . . . 25
"40" Change the user's extra phone number . . . . . . . . . . . . 25
"E" Send private mail . . . . . . . . . . . . 26
"F" <User #> Feedback . . . . . . . . . . . . . . . . 26
"H" Reply to author of auto-message . . . . . 26
"K" [B | C | T] Scan for messages / Word search . . . . . 27
"L" List matching users . . . . . . . . . . . 27
"M" [C] Scan for messages to the current user . . 27
"N" [G] New scan message sections . . . . . . . . 28
"O" Other bulletin board listing . . . . . . 28
"P" [A][R][I] Post a public message . . . . . . . . . . 28
"R" [D] Word validation and deletion . . . . . . 29
"S" Scan public messages . . . . . . . . . . 29
"U" Users with access . . . . . . . . . . . . 29
"V" Voting System . . . . . . . . . . . . . . 29
"W" Read the auto-message . . . . . . . . . . 30
"X" [N] Describe the current message section . . 30
"Y" Main system user information . . . . . . 30
"Z" Edit user macros . . . . . . . . . . . . 31
"2" @ Voting initialization system . . . . . . 31
"3" (*1) @ Read all private mail . . . . . . . . . . 31
"4" @ View Sysop Logs . . . . . . . . . . . . . 31
"5" <Password> Auto user validation . . . . . . . . . . 32
"6" @! Change the system time and date . . . . . 32
"7" Information on current message section . 32
"-" System status report . . . . . . . . . . 33
";" Execute TAGMAIL . . . . . . . . . . . . 33
">" Access the time bank . . . . . . . . . . 33
"?" [@]<xxxxx> Access the questionnaire . . . . . . . . 34
"~" [L | O][<Err>][*<#>] Shut down system . . . . . . . . . . . . 35
File System Program Keys . . . . . . . . . . . . . . . . . . . . . . . 36
"A" List File Areas . . . . . . . . . . . . . 36
"B" Browse Files . . . . . . . . . . . . . . 36
"C" [U] Clear the queue . . . . . . . . . . . . . 36
"D" Download a file . . . . . . . . . . . . . 37
"E" @ Exchange directory . . . . . . . . . . . 37
"F" Find text . . . . . . . . . . . . . . . 37
"G" Download batch queue . . . . . . . . . . 38
"H" [$[?][!]]<Filename> File Door Call . . . . . . . . . . . . . 38
"I" [G | @] View interior . . . . . . . . . . . . . . 39
"J" Upload batch . . . . . . . . . . . . . . 39
"K" [U] Remove from a batch queue . . . . . . . . 39
===========================================================================
January, 1993 (Preliminary) Page iv
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
>>> Table of Contents <<<
"L" List files . . . . . . . . . . . . . . . 40
"M" Users with access . . . . . . . . . . . . 40
"N" [G | C] New scan . . . . . . . . . . . . . . . . 40
"O" @ [R] Unlisted download . . . . . . . . . . . . 41
"P" Change pointer date . . . . . . . . . . . 41
"Q" [U] List queue . . . . . . . . . . . . . . . 41
"R" Remove files . . . . . . . . . . . . . . 42
"S" Scan for files . . . . . . . . . . . . . 42
"T" Type a file . . . . . . . . . . . . . . . 42
"U" Upload a file . . . . . . . . . . . . . . 43
"V" @ [G] Validate files . . . . . . . . . . . . . 43
"W" @ [R] Raw Directory . . . . . . . . . . . . . . 43
"X" [N] Describe section . . . . . . . . . . . . 44
"Y" File system user information . . . . . . 44
"Z" Set new scan . . . . . . . . . . . . . . 44
"2" @ Sort files . . . . . . . . . . . . . . . 45
"3" @ Edit files . . . . . . . . . . . . . . . 45
"4" @ Move files . . . . . . . . . . . . . . . 45
"5" List section information . . . . . . . . 45
"6" @! Change active directory . . . . . . . . . 46
Read Message Menu Program Keys . . . . . . . . . . . . . . . . . . . . 47
"A" Read current message again . . . . . . . 47
"C" Continuous read of messages . . . . . . . 47
"D" Default next message . . . . . . . . . . 48
"I" Ignore messages and go to next section . 48
"K" Kludge/technical information on message . 48
"N" Next message section . . . . . . . . . . 48
"P" [A][R][I] Post message in current section . . . . . 49
"Q" Quit read message menu . . . . . . . . . 49
"R" [A][R][E or P] Reply to current message . . . . . . . . 49
"S" Subjects of next few messages . . . . . . 50
"T" Toggle scan setting of current section . 50
"U" User info - current message author . . . 50
"V" Validate author of current message . . . 50
"W" Write current message to file/printer . . 51
"Z" Delete current message . . . . . . . . . 51
"+" Next message in thread . . . . . . . . . 51
"-" Previous message in thread . . . . . . . 52
"7" Information on the current message base . 52
===========================================================================
January, 1993 (Preliminary) Page v
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/============\
< Introduction >
\============/
The best way to look at the menu system is from the point of a programmer
as it could be seen as a mini-programming language. If you plan to create
your own menu system from scratch, I highly advise planning it out on paper
first or it is very likely that your prized creation will turn out much
less organized than you had planned. By planning, it is meant completely
define your menus and the commands which will go under them, before you
start.
The menu editor is set up into four levels. First, you see all the menus
you currently have defined and their numbers. Secondly, after choosing
which menu to edit, you see the header information for that menu which
includes the name, prompt, security definition, and various other flags and
values. Thirdly, when entering the command editor for the menu, you see a
list of commands currently defined under the chosen menu and their number.
Finally you choose and edit the definition of each command which includes
the menu display information, security definition, operation programming,
and various other flags and values.
Take a look at the menu system provided with the start up package for a
working example. There is no need to create a new menu system to run
T.A.G., the menu editor on most systems is only used to vary access on the
commands. Later when you become more comfortable with the system, you may
choose to create your own menu setup.
/=========================================\
< Definition of Terms Used in this Document >
\=========================================/
Access Restriction Flag or AR Flag:
A letter from "A" to "Z" indicating what special privilege an object
(whether it be a menu, a command, or a user) holds. Users must have a
particular AR flag set in order for a function depending on it to
operate. An AR flag setting of "@" on an object indicates no AR flag
check is performed.
Download Security Level or DSL:
A number from 0 to 255 representing what level of access an object
(whether it be a menu, a command, or a user), usually related to the
file transfer system, holds. Users must have an equal of higher DSL for
a function depending on it to operate.
Program Data or Pdata:
A string of characters representing special information a particular
program key may need in order to properly operate.
Program Key or Pkey:
A letter, number, or symbol identifying the specific operation a command
is supposed to perform.
===========================================================================
January, 1993 (Preliminary) Page 1
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
Security Level or SL:
A number from 0 to 255 representing what primary level of access an
object (whether it be a menu, a command, or a user) holds. Users must
have an equal or higher SL for a function depending on it to operate.
Special Flag or SF:
A letter from "A" to "X" that represents a set function with respect to
a user. See the table of special flag functions in the main T.A.G.
documentation for more details.
/======================================\
< Description of Menu Header Information >
\======================================/
Menu list number:
This field is for display only and indicates the list number of each
menu. The editing functions use this number as menu numbers can be in
any random order.
Menu number:
This field is a number from 1 to 255 used as a reference from or to
other menus with the goto and gosub commands. This number need not be
the same as the menu list number.
Menu name:
This field is the name or title of the menu displayed on the novice and
normal help levels. If custom help menus are being used for the novice
and normal help levels this field is never displayed. Standard
"Control-P <Color 0-9>" colors are allowed in the menu name, but they
will decrease the allowed number of characters.
Prompt:
This field is the last thing printed by T.A.G. on any help level before
waiting for input from the user (e.g. "Main Menu: "). Standard
"Control-P <Color 0-9>" colors are allowed in the prompt, but they will
decrease the allowed number of characters.
General SL:
This field is the general security level which specifies the SL or DSL
used to check access for a menu. How the GSL is used is determined by
the flag settings.
AR flag:
This field is the AR flag used to check access for a menu. How the AR
flag is used is determined by the flag settings.
===========================================================================
January, 1993 (Preliminary) Page 2
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
Menu Starting Help Level:
The starting help level can contain either a zero or a value from one to
four. Zero means the user starts at the help level s/he has defined as
their default help level, while a number from one to four indicates that
the user is forced to a specific help level no matter what their default
setting is. Normally most menus will be set to zero, however the read
message menu, for example, is often set to "2" or "1" to eliminate the
large menus for new users between messages.
Help file ID:
This field specifies a 7 character filename prefix for customized help
menus on a T.A.G. system; the field is blank when customized menus are
not being used. The prefix is followed by a "2" (Key help level), "3"
(Abbreviated help level), or "4" (Full command help level) depending on
which help level the file represents. Help level "1" (Expert help level)
does not have a file because that level is characteristic of not having
menus. Partial customizing is possible by only including the menu help
files you wish to replace; T.A.G. will automatically generate menus for
any customizing files it cannot find. Customizing files should be placed
in the Alternate Text File Directory.
For example, setting the help file ID to "MAIN" will cause T.A.G. to
look for the following files:
MAIN2.MSG - Key help level (help level 2).
MAIN3.MSG - Abbreviated help level (help level 3).
MAIN4.MSG - Full command help level (help level 4).
In addition to the above, ANSI help menus are supported. Just include a
"*.CLR" version of the above files and it will be used automatically
when appropriate for the user currently on-line. It is also possible to
just include "*.CLR" help files and allow T.A.G. to generate standard
text files for non-ANSI users.
T.A.G. also supports custom menus by security level. To create an SL
specific menu, you just append a -<SL> to the file name. The only
problem is that you may need to shorten your MENU names to accomplish
this, since "MAIN1-255" is one character too long! But "MAI1-255" is
just right.An SL specific custom menu overrides the normal custom menu.
If "MAI3-100.CLR" and "MAI3.CLR" both exist, a user with an SL of 100
will see the "MAI3-100" at help level 3.
Password:
This field specifies an optional password required for access to a menu.
If a password is specified, and it is incorrectly entered by the user,
s/he is sent to the fallback menu specified. It is not advisable to have
a password on a menu with a fallback pointer of zero, as that would
disconnect the user if incorrectly entered.
===========================================================================
January, 1993 (Preliminary) Page 3
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
Fallback menu:
This field specifies the menu which the system will go back to when some
type of error occurs. Possible errors include no commands being defined
on a menu, a corrupted menu file, incorrect password entry, or a user
not having access to a menu. A fallback menu of zero will send the
system into a fatal error state, logging the user off and returning the
system to the wait screen to wait for the next caller.
Menu location:
This field specifies to which of systems, the main system, the file
system, or the read message system the menu belongs. T.A.G. uses this
information to automatically load the proper system when changing menus.
Flags:
<SL/DSL> access check:
This flag determines whether T.A.G. will use the SL or the DSL of the
user to compare against the GSL defined in the menu for the access
check.
GSL <and/or> AR:
This flag determines how T.A.G. will use the GSL and AR flag combination
to determine a users access to the current menu.
The two possible settings are:
* "GSL and AR" indicates the user must satisfy the general security
level AND have the AR flag specified in order to use the menu.
* "GSL or AR" indicates the user must satisfy the general security
level OR have the AR flag specified in order to use the menu.
Time/Help <ON/OFF>:
This flag determines whether the "Time left: 00:00:00 ("?"=Help)" line
is displayed along with the menu prompt when a user is at this menu.
Board <NORMAL/ON>:
This flag determines whether the current message or file section is
force displayed along with the menu prompt when a user is at this menu.
Normally the current message or file section name is only displayed when
the user has the option to change sections.
Menu name <NORMAL/PROMPT>:
This flag determines whether a special long prompt system is used. When
active, the menu name becomes the prompt field and the normal prompt
field is no longer active. Having a menu name when this is active is not
possible, of course.
===========================================================================
January, 1993 (Preliminary) Page 4
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/==================================\
< Description of Command Information >
\==================================/
Command number:
This field is for display only and indicates the command number used as
a reference point for the editing functions.
Long description:
This field contains the full description of a command's operation. It is
used when T.A.G. generates a full help menu (help level 4). Obviously if
your system has custom help menus for this help level, this field will
never be displayed. Standard "Control-P <Color 0-9>" colors are allowed
in the long description, but they will decrease the allowed number of
characters.
Short description:
This field contains an abbreviated description of a command's operation.
It is used when T.A.G. generates a normal help menu, lists the commands
in the menu editor, and lists the commands when menu information is
requested. Standard "Control-P <Color 0-9>" colors are allowed in the
short description, but they will decrease the allowed number of
characters.
Key:
This field indicates what the user must type in order to activate this
command. Keys over one character in length can only be activated by
proceeding them with "//" unless the line input entry mode is chosen.
Special exceptions to this rule include number keys and those two
character keys beginning with "/", such as "/G". This field is also used
to generate the key help level menu.
General SL:
This field is the general security level which specifies the SL or DSL
used to check access for a command. How the GSL is used is determined by
the flag settings.
AR flag:
This field is the AR flag used to check access for a command. How the AR
flag is used is determined by the flag settings.
Program key:
This field is an operation indicating to T.A.G. what action the command
performs. It is a single character from the one of the three program key
tables later in this document. Please note that the location of the menu
determines which program keys are valid. File system program keys are
not active in the main system, and vise versa. Do not confuse this field
with the "Key" field, it has nothing to do with what the user enters in
order to activate the command.
===========================================================================
January, 1993 (Preliminary) Page 5
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
Program data:
This field specifies any additional information a particular program key
may need in order to operate. It may contain a file name, optional
special feature indicators, or many other things. Many commands do not
require any program data, others function in differing ways depending on
whether program data is present. See the program key tables later in
this document for more information.
Flags:
<SL/DSL> access check:
This flag determines whether T.A.G. will use the SL or the DSL of the
user to compare against the GSL defined in the command for the access
check.
GSL <and/or> AR:
This flag determines how T.A.G. will use the GSL and AR flag combination
to determine a users access to the current command. The two possible
settings are:
* "GSL and AR" indicates the user must satisfy the general security
level AND have the AR flag specified in order to use the command.
* "GSL or AR" indicates the user must satisfy the general security level
OR have the AR flag specified in order to use the command.
<Normal/Hidden> Command:
This field determines what command will appear on a T.A.G. generated
menu. Hidden commands appear on the menu information list if the user
has SysOp access or greater.
/==============\
< Sample command >
\==============/
Command number : 26
1. Long desc. : (/U)ser log editor and manager.
2. Short desc. : (/U)ser Edit
3. Key : /U
4. General SL : 250
5. AR level : Z
6. Program key : 1
7. Program data : U
8. Flags : SL access check, GSL or AR, Hidden Command
This command is activated by typing "/U" from the menu (as defined in line
#3). It is available to users with a SL of 250 <<OR>> the 'Z' AR flag. The
program key "1" specifies a specific function to T.A.G., and the program
data specifies the user log editor. This command is hidden so it will not
appear on T.A.G. generated menus. Please notice the danger with "GSL or AR"
commands. A user with a SL of 10 could conceivably enter the user editor if
their 'Z' flag is set. Of course the automatic protection in the user
editor will prevent anyone with SL 10 from changing much, but the problem
still exists.
===========================================================================
January, 1993 (Preliminary) Page 6
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/===============================================\
< Predefined Menu Commands Available on All Menus >
\===============================================/
Key Description
------- ---------------------------------------------------------------
<space> Reprint the current menu at the current help level.
<enter> (Same as space) Reprint the current menu at the current help
level.
? If user is at help level 1 (no help), this command will raise them
to help level three on this menu, otherwise it will advance the
user forward one help level (if possible) and reprint the menu.
\ Display the version and possible registration information about
the T.A.G. system currently running.
= When a user has a SL of at least CoSysOp level, this command will
display the current menu stack and print all accessible commands
along with the menu information about each. Note: Hidden commands
will ONLY appear in this list if the user performing the operation
has SysOp access or above. AUTOEXEC commands NEVER show on a menu
stack dump.
FALLBACK Falls back to the programmed fallback menu. Note: This command
will not function when the fallback menu is defined as zero.
===========================================================================
January, 1993 (Preliminary) Page 7
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/=============\
< General Notes >
\=============/
Maximum Menus/Commands
The maximum number of menus is 100.
The maximum number of commands per menu is 100.
Executing commands with more than one character
To execute Commands with a key of more than one character, excluding
numbers and those two character commands beginning with one of the
programmable command characters, such as "/" (i.e."/G"), the user must
precede them with "//" at the menu prompt (e.g. "//LOG" to execute the
LOG command).
If commands act strange
If a menu's Commands are acting strange, such as the bulletin command is
doing a file section browse instead, you have your menu location field
set to the wrong value. Main system program keys will not function in
the file section, as file system program keys will not function in the
main system.
Default command
A default command feature is available which will be executed if the
user should simply press carriage return at a menu. Simply define a
command with the command key of "<CR>" (without quotes of course) and
that command will be executed when the users pressed carriage return.
The best example of a use of this feature would be the reading messages
menu, where it is often desirable to have a carriage return take you to
the next message.
Blank Keys
Commands with a blank Command Key do not display on T.A.G. generated
menus. Blanking the command key on link command will save the trouble
of having to "Hide" each of the commands in a link chain.
AUTOEXEC command
T.A.G. allows automatic execution of a command whenever a menu is
loaded. To enable this function, the FIRST command key (even before the
# command) must be "AUTOEXEC". The AUTOEXEC command can have linked
commands. Auto executing commands are not displayed on the menu.
Read Message Menu restrictions
If a menu has a location of "Read Message System", you cannot GOTO or
GOSUB menus with any other location. The quit command (Pkey="Q") must
be used to exit these menus. Additionally, it is imperative that you
define a default "Read Message Menu" in your system configuration.
SDR Codes
The menu name and prompt fields may contain SDR codes.
Message Searches
All message searches use the users Real Name and Handle except in the
private Email area.
===========================================================================
January, 1993 (Preliminary) Page 8
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/======================\
< Command Definition Key >
\======================/
/================\
< Text conventions >
\================/
" | " OR operator which separates two or more items where only one of
those items may appear in the program data at any one time. For
example "<User #> | I | T" would be replaced by exactly one of
the following: A user number, the letter "I", or the letter
"T".
"< ... >" Description of a value which should replace this expression.
For example "<User #>" would be replaced by the appropriate
user number.
"[ ... ]" An optional item that may or may not be included depending on
the intended use.
/=============\
< Command flags >
\=============/
(*<#>) Indicates the command requires the specified SysOp password in
order to be used.
@ Indicates this command should restricted to privileged users such
as your lower level remote SysOps.
@! Indicates this command could be very dangerous in the hands of a
user with harmful intent. Only those users you trust completely
should be given access to these commands.
===========================================================================
January, 1993 (Preliminary) Page 9
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/===============\
< Linked Commands >
\===============/
Each command contains a flag which indicates whether it is linked to the
next command or not. If the flag is active, the system will immediately
execute the next command on the menu without prompting the user. Up to 20
commands may be in the link buffer at any one time. This means that a
single command could have 20 linked commands attached to it.
Normally when creating a linked set of commands, only the first command is
executable by the user. T.A.G. will allow linking into other real commands
(which the user can press a "key" for), but unless you have a specific
reason for doing so, all other commands in a chain should have a blank
"key" field.
If a linked command should change system locations (e.g. go into the file
section), all commands in the chain from that point forward will be
executed using the Pkey/Pdata definitions in that location. An example of
this would be creating a command on the main menu which first does a "goto"
to the file system, and then executes the download command.
If the system encounters a command in the link chain which is not
accessible to the user, the link buffer is immediately cleared and the user
will be dropped at whatever menu is currently active.
/======================\
< Linked command example >
\======================/
When creating a set of linked commands, the last command in the chain
should NOT have the link flag set. For example, to create a 3 command link
chain, they would be set up as follows:
Command 1:
| Key = Command user must type to execute
| Pkey/Pdata = Program information of first command
| Flag = Linked to Next
|
Command 2:
| Key = Blank
| Pkey/Pdata = Program information of second command
| Flag = Linked to Next
|
Command 3:
| Key = Blank
| Pkey/Pdata = Program information of third command
| Flag = No Linking
The existence of the global command "Execute Command Key" (Pkey="0";
Pdata=<KEY>) should be noted as it provides an easy way to limit the
duplication of access levels in multiple linked commands. See that command
for more information.
===========================================================================
January, 1993 (Preliminary) Page 10
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/================================\
< How T.A.G. handles link commands >
\================================/
When the user executes a command which has other commands linked to it,
T.A.G. first copies all of the linked commands into a link buffer and then
executes the first command in the chain.
Upon returning to any standard menu, the system will first check to see if
there are any commands in the link buffer. If so, the first one will be
pulled out of the buffer and executed. This process is repeated until no
commands exist in the link buffer.
In the case of the "Execute Command Key" command, if the command executed
contains linked commands itself, they are added to the link buffer before
any remaining commands from the original link. Thus the commands in the
executed command will be processed before continuing with the link of the
original command.
===========================================================================
January, 1993 (Preliminary) Page 11
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/==============================================\
< Standard Program Keys Available from all Menus >
\==============================================/
/=============================================================\
< "!" [@]<Filename>[.Ext] Display a text file >
\=============================================================/
Function : Display a text file
Pkey : "!"
Pdata : [@]<Filename>[.<Ext>]
[@] Indicates the file resides in the Alternate Text File
Directory instead of the Main Data File Directory.
<Filename> MS-DOS filename of the file to be printed.
.<Ext> Optional MS-DOS extension, if not ".MSG" and/or ".CLR".
This command displays a text file located in the Main Data File Directory
unless otherwise specified by the Pdata. If an extension is not included
with the filename, T.A.G. will assume the standard "*.MSG" and/or "*.CLR"
system. That is, if a "*.CLR" version exists and the user's ANSI graphics
are active, then it is displayed, otherwise the "*.MSG" is displayed.
If the multi-user option is active, the system will scan the multi-user
directory for the file if it cannot be found in the local directories.
/========================================================\
< "@" [<User #>] Page the SysOp >
\========================================================/
Function: Page the SysOp
Pkey: "@"
Pdata: [<User #>]
[<User #>] User number to whom the message is left to when the SysOp is
not available. Note: Option only available in the main system.
This command requests to chat with the SysOp by having him/her enter a
short reason, and then paging the operator at the keyboard. If sysop status
is set to "Available" or if the user types the chat password as the first
part of the chat reason, a visual and audio page will occur. If the SysOp
is not available of fails to respond to the page, an optional message can
be left to the user specified in the Pdata.
===========================================================================
January, 1993 (Preliminary) Page 12
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/=========================================================\
< "#" Change sections >
\=========================================================/
Function : Change message section, message number, or file section
Pkey : "#"
Pdata : None
This command allows user to change messages or sections in the current
system by entering a number. The command has the following action
depending on the menu location:
Location Action
------------------- ----------------------
Main System Change Message Section
Read Message System Change Message Number
File System Change File Section
NOTE: With the exception of the AUTOEXEC command, this command MUST be the
first command on the menu, but may be hidden if it causes a problem.
/=============================================================\
< "$" Version Information >
\=============================================================/
Function: Version information
Pkey: "$"
Pdata: None
This command prints the current T.A.G. version and possible registration
information.
/===========================================================\
< "^" [C]<Menu #> Goto another menu >
\===========================================================/
Function: Goto another menu
Pkey: "^"
Pdata: [C]<Menu #>
[C] Clear the menu stack before changing menus.
<Menu #> Number of the menu to send the user to.
This command changes to the menu number indicated in the Pdata.
===========================================================================
January, 1993 (Preliminary) Page 13
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/============================================================\
< "/" [C]<Menu #> Gosub another menu >
\============================================================/
Function: Gosub another menu (remember current menu and goto another)
Pkey: "/"
Pdata: [C]<Menu #>
[C] Clear the menu stack before changing menus.
<Menu #> Number of the menu to send the user to.
This command first saves the current menu number on the menu stack, and
then changes to the menu number indicated in the Pdata. A later command may
now exist to return to the previous menu (the menu number saved on the
stack). The "=" command can be used to find problems with menu stack
commands as it prints out the current menu stack in addition to menu
command information.
/==============================================================\
< "\" [C] Return to saved menu >
\==============================================================/
Function: Return to previously saved menu in menu stack
Pkey: "\"
Pdata: [C]
[C] After returning, clear the menu stack.
This command returns to the most recently saved menu number on the menu
stack. The "=" command can be used to find problems with menu stack
commands as it displays the current menu stack in addition to menu command
information.
/======================================================\
< "&" Sysop Status >
\======================================================/
Function: SysOp status
Pkey: "&"
Pdata: None
This command checks the status of the SysOp chat call. Basically it tells
the user whether it is on or off. The optional files "CHATON.MSG" and
"CHATOFF.MSG" may be used for customization, see their descriptions.
===========================================================================
January, 1993 (Preliminary) Page 14
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/=======================================================\
< "*" [<User #> | I | T] Logoff system >
\=======================================================/
Function: Logoff system
Pkey: "*"
Pdata: [<User #> | I | T]
<BLANK> The user will be asked if they are sure they wish to logoff the
system. If so T.A.G. will display the logoff message and hangup.
<User #> The user will be asked if they are sure they wish to logoff the
system, then whether they wish to leave a comment to the user
specified in the Pdata. Afterwards T.A.G. will display the logoff
message and hangup. NOTE: This option is only available from the
main system. If used in the file system it will function as the
<BLANK> option.
"I" Instant hangup. Nothing else will be displayed, T.A.G. will
simply hangup.
"T" Text file only. T.A.G. will display the logoff message and
hangup.
This command logs the user off the system.
NOTE:
It is NOT possible to leave a logoff message from the file transfer
system. It is possible however to create a sub-menu located in the main
system where the normal logoff sequence could be simulated though a
series of commands. All (G)oodbye commands would GOSUB this menu and if
a user aborted the logoff, it would simply RETURN to the previous menu
where they were located.
/==========================================================\
< "(" Menu information >
\==========================================================/
Function: Menu information
Pkey : "("
Pdata : None
This command will display the current menu stack and print all accessible
commands along with the menu information defined for each.
Note: Hidden commands will ONLY appear on this list if the user performing
the operation has SysOp access or above. This is a definable "=" key.
===========================================================================
January, 1993 (Preliminary) Page 15
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/=============================================================\
< "|" [F]<Section #> Change to a section >
\=============================================================/
Function : Change to a specific message section or file section
Pkey : "|"
Data : <Section #>
<Section #> The number of section which to change to.
This command changes to the message or file section specified in the
program data. The command has the following action depending on the menu
location:
Location Action
------------------- ----------------------
Main System Change Message Section
Read Message System Invalid
File System Change File Section
The section number specified MUST be the real section number, not the
dynamic one. Normal access checks are done by the system so that if the
user does not have access to the section, the change request will fail.
/=========================================================\
< "[" Search Backward >
\=========================================================/
Function : Search backward for next accessible message section, message
number, or file section
Pkey : "["
Pdata : None
This command will search backward (lower numbered sections/messages) from
the current section/message for the next accessible section/message. If
none is found, the user will remain in the current section/message.
/========================================================\
< "]" Search Forward >
\========================================================/
Function : Search forward for next accessible message section, message
number, or file section
Pkey : "]"
Pdata : None
This command will search forward (higher numbered sections\messages) from
the current section/message for the next accessible section/message. If
none is found, the user will remain in the current section/message.
===========================================================================
January, 1993 (Preliminary) Page 16
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/=================================================================\
< "0" <Filename> Generate random message >
\=================================================================/
Function : Generate random message
Pkey : "8"
Pdata : <Filename>
<Filename> MS-DOS filename of the message file
This command chooses a random message from the specified file and displays
it to the user. The file is in standard ASCII format with one blank line
separating each message. If the first line of the file begins with "~" it
is used as the header instead of the standard quote of the day header. Due
to the algorithm used, longer quotes have a better chance of being chosen
than shorter ones. <Filename> is search for in the AFILES, DFILES, and
MFILES directories, in that order.
/==========================================================\
< "1" <A|B|D|F|L|M|P|S|U|V> Execute function >
\==========================================================/
Function: Execute function
Pkey: "1" (See passwords and flags indicated below)
Pdata: <A|B|D|F|L|M|P|S|U|V>
"A" @ Access validation manager (*3)
This function allows creation, maintenance, and deletion of validation
records from the system. See the main T.A.G. documentation for more
information.
"B" @ Message board editor (*2)
This function allows creation, maintenance, and deletion of message
sections on the system. See the main T.A.G. documentation for more
information.
"D" @ Mini-DOS command system
This function allows limited access to the files on your system drives.
The main use of this is for maintenance of the text files on the system.
See the main T.A.G. documentation for more information.
"F" @ File board editor (*2)
This function allows creation, maintenance, and deletion of file
sections on the system. See the main T.A.G. documentation for more
information.
"L" @ Batch protocol editor (*2)
This function allows creation, maintenance, and deletion of batch
transfer protocols. See the main T.A.G. documentation for more
information.
===========================================================================
January, 1993 (Preliminary) Page 17
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
"M" @! Menu editor (*3)
This function allows creation, maintenance, and deletion of menus on the
system, along with the commands defined under each menu. See the main
T.A.G. documentation for more information.
"P" @ Single protocol editor (*2)
This function allows creation, maintenance, and deletion of single file
transfer protocols. See the main T.A.G. documentation for more
information.
"S" @/@! System configuration editor (*2/*3)
(*2 or *3 online, *3 from the wait screen).
This function allows the modification of the basic system configuration.
Full access to this command (*3) rates a "@!" flag level, while limited
access (*2) only designates a "@" flag level. See the main T.A.G.
documentation for more information.
"U" @ User log editor (*1) (*1 from the wait screen).
This function allows maintenance and deletion of the users in the user
log. See the main T.A.G. documentation for more information.
"V" @! Events editor (*2)
This function allows creation, maintenance, and deletion of system
events. See the main T.A.G. documentation for more information.
This command executes one of the available functions as specified by the
Pdata. After completion the user will be returned to the menu and system
where the command was called from.
/======================================================\
< "." (*3) @! Shell to DOS >
\======================================================/
Function: Shell to DOS
Pkey: "." (*3) @!
Pdata: None
This command allows a user, both locally or remotely, to shell to MS-DOS
and still remain on the system. Once the user is done, they simply type
"EXIT" at the MS-DOS command line, and they will be place back in T.A.G.
exactly where they left off. This command requires SysOp password #3 to be
entered before it will function.
WARNING:
This command should only be accessible to the most trusted users on your
system, if at all (normally full Cosysop or Remote Sysops only). Once a
user has shelled to DOS, they can do anything they want, including
erasing everything on your system!!
See the description of setting up a shell DOS system in the main T.A.G.
documentation for the necessary steps to make this command operational.
===========================================================================
January, 1993 (Preliminary) Page 18
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/=============================================================\
< "0" <Key> Execute Command Key >
\=============================================================/
Function : Execute Command Key
Pkey : "0"
Pdata : <Key>
This command searches the current menu for a command who's "Key" matches
the specified Pdata and executes it. One might think this is pretty
useless, but it comes in very handy for standardizing access on linked
commands. For example, if you were creating a command to change to a
specific message section and do a new scan on only that section. You could
just use the Pkey to the change the message section, and then the Pkey to
new scan only that section. Using this command however, you could change
to the message menu and actually execute the "(V)iew" command on the menu
(assuming standard T.A.G. menus here). If you ever changed the access on
the "(V)iew" command, you would not have to change the linked command's
access also since it actually uses the real "(V)iew" command to do its
work.
Calling linked commands from within a linked command is fully supported.
/===========================================================\
< "9" [M or F][$ or <Group Mask>] Change Group Mask >
\===========================================================/
Function : Change message or file section group mask
Pkey : "9"
Pdata : [M or F][$ or <Group Mask>]
"M" Change message section group mask
"F" Change file section group mask
"$" Ask user to enter desired group mask
<Group Mask> New value of the message/file group mask (may be blank)
This command changes the current message or file section group mask. All
sections which do not fit the specified mask will no longer be accessible.
Users are automatically changed to the first available message or file
section in the group. See the "Change to a specific message section,
message number, or file section" (Pkey="|") for information on how to send
the user to another section. If dynamic numbering is active, the sections
will be renumbered accordingly.
In the case where the user must specify the group mask, a group mask file
is displayed prior to requesting input.
For message sections this file can be:
MGRP.* Default file for message sections
MGRP-<SL>.* Override file for specific SL settings
For file sections this file can be:
FGRP.* Default file for file sections
FGRP-<DSL>.* Override file for specific DSL settings
===========================================================================
January, 1993 (Preliminary) Page 19
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/==========================\
< External DOOR Program Keys >
\==========================/
/====================================================\
< ":" [@][*]<Filename> RBBS door program (NEW format) >
\====================================================/
Function: Execute a RBBS door program (NEW format)
Pkey: ":"
Pdata: [@][*]<Filename>
[@] Call the door using the user's real name rather than user name,
which may be a handle.
[*] If this designator is present the notification " [ > D o o r
program activated ... <]" to the user is suppressed.
<Filename> Name of the program to execute.
This command creates the RBBS (tm) type external user information file
(DORINFO1.DEF) in the Main BBS Directory for door programs. The program
specified in the Pdata, also expected to be in the Main BBS Directory, is
then executed. The parameters defined in the generic door command are
passed on the command line in case the information is needed; normally it
will not be and may be ignored. Once the program has completed execution
the user will be returned to T.A.G. exactly where they left off. This door
format can be used to drive Door Master (tm) which can create many types of
door files including PCBoard (tm).
/====================================================\
< "_" [@][*]<Filename> RBBS door program (OLD format) >
\====================================================/
Function: Execute a RBBS door program (OLD format)
Pkey: "_"
Pdata: [@][*]<Filename>
[@] Call the door using the user's real name rather than user name,
which may be a handle.
[*] If this designator is present the notification "[>Door program
activated ... <]" to the user is suppressed.
<Filename> Name of the program to execute.
This command creates the RBBS (tm) type external user information file
(DORINFO1.DEF) in the Main BBS Directory for door programs. The program
specified in the Pdata, also expected in the Main BBS Directory, is then
executed. The parameters defined in the generic door command are passed on
the command line in case the information is needed; normally it will not be
and may be ignored. Once the program has completed execution, the user will
be returned to T.A.G. exactly where they left off. This is the old version
of the RBBS door system supported in previous versions of the board.
===========================================================================
January, 1993 (Preliminary) Page 20
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/========================================================\
< "=" [@][*]<Filename> DOOR.SYS and GAP(tm) door programs >
\========================================================/
Function: Execute DOOR.SYS and GAP(tm) door programs
Pkey: "="
Pdata: [@][*]<Filename>
[@] Call the door using the user's real name rather than user name,
which may be a handle.
[*] If this designator is present the notification "[>Door program
activated ... <]" to the user is suppressed.
<Filename> Name of the program to execute
This command creates the external user information file (DOOR.SYS) for the
defined standard door program in the Main BBS Directory. The program
specified in the Pdata, which is also expected to be in the Main BBS
Directory, is then executed. The parameters defined in the generic door
command are passed on the command line in case the information is needed;
normally it will not be and may
be ignored. Once the program has completed execution and exited the user
will be place back in T.A.G. exactly where they left off.
The DOOR.SYS file was submitted by the "Limited Release Software Group" and
is meant to be used as a STANDARD for ALL Bulletin Board Systems.
Specifications for this door information file appear in the DOORSYS.TXT
file included in the documentation archive.
===========================================================================
January, 1993 (Preliminary) Page 21
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/====================================================\
< "<" [@][*]<Filename> Execute a generic door program >
\====================================================/
Function: Execute a generic door program
Pkey : "<"
Pdata : [@][*]<Filename>
[@] Call the door using the user's real name rather than user name,
which may be a handle.
[*] If this designator is present the notification "[>Door program
activated ... <]" to the user is suppressed.
<Filename> Name of the program to execute
This command executes the program specified in the Pdata, which is expected
to be in the Main BBS Directory, passing it the following parameters on the
DOS command line:
Baud rate of user (e.g. 300, 1200, 2400, 9600)
Time left on-line in minutes
ID number of current user (user number)
First name
Last name
ANSI graphics status (0=Off or 1=On)
Communications port (1 to 4)
Once the program has completed execution and exited the user will be place
back in T.A.G. exactly where they left off.
Notes:
In the case where a user has more than two words in their user name (e.g.
"Fine and Tandy"), only the first two words are passed (e.g. "Fine and").
In the case where a user has only one word in their name, a "." (period) is
used as a spacer for the last name. Many doors will not function when a
user has only one word in their name, this will solve that problem.
A sample command call may be passed to DOS like on of the following:
DOOR.BAT 1200 42 215 John Smith 0 <or> DOOR.BAT 9600 250 1 Arthur . 1
This command is often used to door format generating programs such as
QuickDoor, used to generate PCBoard(tm) door files.
===========================================================================
January, 1993 (Preliminary) Page 22
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/======================\
< Multinode Program Keys >
\======================/
/=============================================\
< "`" [B|M|W |C<File>] Multinode Function >
\=============================================/
Function: Invoke Multinode Function
Pkey: "`"
Pdata: [B | M | W | C<File>]
This command invokes various multinode functions. Multinode functions are
only available if the multinode flag in the system config is set to "YES".
Note that it is not necessary to actually be running more than one node to
configure a system for multinode.
"B" [Broadcast] Broadcasts a message to all nodes currently logged on.
"M" [Message] Sends a (one-line) message to a single node.
"W" [WhoIsOn] Lists All nodes currently online
"C" [Chat] Invokes external chat door batch file. Creates (and
maintains) an RA style "USERON.BBS" dropfile, for use
with external chat doors for Remote Access. The version
of the USERON.BBS dropfile is controled by the optional
flagged functions in the system config. The Pdata must be
"C"<Batch Filename>
===========================================================================
January, 1993 (Preliminary) Page 23
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/========================\
< Main System Program Keys >
\========================/
/=============================================\
< "A" List message areas >
\=============================================/
Function: List message areas
Pkey: "A"
Pdata: None
This command lists the message sections available on the system. Normally
unaccessible sections are not listed, but the privilege settings in the
system configuration determine which unaccessible sections, if any, a user
can see. This list may be limited to certain boards by use of message
groups.
/==========================================\
< "B" Bulletin system >
\==========================================/
Function: Bulletin system
Pkey: "B"
Pdata: None
This command sends the user to the bulletin system. It displays the main
list of bulletins (BULLETIN.MSG) and allows the user to make their
selection. See the description of the files BULLETIN.MSG and BULLET@@.MSG
in the main T.A.G. documentation for further information.
/==============================================\
< "C" Create auto-message >
\==============================================/
Function: Create auto-message
Pkey: "C"
Pdata: None
This command allows the user to create a new auto-message which may be
displayed when users log onto the system (depending on the auto-message
system configuration setting). New users should not be allowed to use this
command normally, as they could post anything in this message.
===========================================================================
January, 1993 (Preliminary) Page 24
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/=====================================================\
< "D" <0..40> User information functions >
\=====================================================/
Function: User information functions
Pkey: "D"
Pdata: <0..40>
"0" List user information that can be changed
"1" Change the user's real name
"2" Change the user's address
"3" Change the user's city & state
"4" Change the user's zip code
"5" Change the user's phone number
"6" Change the user's computer type
"7" Change the user's ANSI colors
"8" Change the user's birthday
"9" Change the user's highest baud
"10" Change the user's screen size (columns and lines)
"11" Toggle the user's ANSI status
"12" Toggle the user's color status
"13" Change the user's logon password
"14" Change the user's external editor status
"15" Toggle the user's [PAUSE] status
"16" Toggle the user's onekey status
"17" Toggle the user's VT-100 type tab status
"18" Toggle the user's CLS status
"19" Change the user's mailbox configuration
"20" Change which bases the user new scans
"21" Change menu to logon at (NOT supported)
"22" Change the user's help level
"23" Toggle the user's custom menu status
"24" Toggle the user's clear screen before message status
"25" Toggle the user's do not disturb status
"26" Change the user's phone number 2
"27" Change the user's extra string 1
"28" Change the user's extra string 2
"29" Change the user's extra string 3
"30" Change the user's extra date 1
"31" Change the user's extra date 2
"32" Change the user's extra number 1
"33" Change the user's extra number 2
"34" Change the user's extra number 3
"35" Change the user's extra number 4
"36" Change the user's extra character 1
"37" Change the user's extra character 2
"38" Change the user's extra character 3
"39" Change the user's extra character 4
"40" Change the user's extra phone number
This command combines many commands which allow listing and changing most
of the current user's variable information. In the default menu system,
most of these commands are found on the Personal Data Menu.
===========================================================================
January, 1993 (Preliminary) Page 25
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/============================================\
< "E" Send private mail >
\============================================/
Function: Send private mail to a user
Pkey: "E"
Pdata: None
This command sends private mail to one or more users specified by the user
currently on-line. User's must have a SL equal to or above the normal
private mail level defined in the system configuration.
/===================================\
< "F" <User #> Feedback >
\===================================/
Function: Feedback
Pkey: "F"
Pdata: <User #>
This command sends a private message to the user specified in the Pdata. It
is mainly used for commands such as "Feedback to SysOp" (where the Pdata =
SysOp user number) or "Send a message to the Dungeon Master" (where the
Pdata = Dungeon Master user number).
/==========================================================\
< "H" Reply to author of auto-message >
\==========================================================/
Function: Reply to author of auto-message
Pkey: "H"
Pdata: None
This command sends a private message to the author of the current
auto-message, if it is possible. Replying to an anonymous auto-message is
handled like any other message, following the SL setting in the system
configuration.
===========================================================================
January, 1993 (Preliminary) Page 26
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/=========================================================\
< "K" [B | C | T] Scan for messages / Word search >
\=========================================================/
unction : Scan for messages sent to/from the current user
Pkey : "K"
Pdata : [B | C | T]
<Blank> Scan private messages from the user (in section 0)
"B" Scan Messages in the current section to or from the user
"C" Scan messages in the current section from the user
"T" Text search in the current section
This command scans for messages which the current user has sent. If "C" is
specified in the Pdata, the current section is scanned, otherwise the
private mail board is scanned. If the delete command is accessible, the
user may delete any or all of his message. Normally this command is setup
to allow a user to (K)ill any private mail they have previously sent.
/==============================================\
< "L" List matching users >
\==============================================/
Function: List users matching specified classification
Pkey: "L"
Pdata: None
This command allows another user to list the users currently on the system
who match the specified classification. The possible classifications are
user name, city, computer type, and first three digits of phone number.
This last option is not available when the generic mode is enabled in the
system configuration.
Partial match strings may be entered as desired.
/================================================================\
< "M" [C] Scan for messages to the current user >
\================================================================/
Function : Scan for messages to the current user
Pkey : "M"
Pdata : [C]
<Blank> Scan private messages (in section 0)
"C" Scan messages in the current section to a user.
This command scans for messages which are to the current user. If "C" is
specified in the Pdata, the current section is scanned, otherwise the
private mail board is scanned. Normally this command is setup to allow a
user to read any private mail they have waiting.
===========================================================================
January, 1993 (Preliminary) Page 27
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/====================================================\
< "N" [G] New scan message sections >
\====================================================/
Function: New scan message sections
Pkey: "N"
Pdata: [G]
<BLANK> Scan the current public message section for new messages.
"G" Scan all accessible public message sections for new
messages.
This command scans one or more public message sections for new messages. If
the user has posting access to any board scanned, T.A.G. will ask if they
wish to post a message on each board after the new scan is completed.
/=======================================================\
< "O" Other bulletin board listing >
\=======================================================/
Function: Other bulletin board listing
Pkey: "O"
Pdata: None
This command allows the user to list the current other bulletin board list
(BBSLIST.MSG), and if possible, add a bulletin of their choice to the
listing. Access to the add function is defined in the system configuration.
/================================================\
< "P" [A][R][I] Post a public message >
\================================================/
Function : Post message in current section
Pkey : "P"
Pdata : [A][R][I]
<Blank> Normal post (no file attaches/requests)
"A" Allow file attaches in net mail sections @
"R" Allow file requests in net mail sections @
"I" Ask for Node number and Display Node Info
This command posts a public message in the current section if the user has
the access required. It will also optionally allow file attaches and
requests in net mail sections assuming the user has met the security
requirements defined in the system configuration.
===========================================================================
January, 1993 (Preliminary) Page 28
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/=======================================================\
< "R" [D] Word validation and deletion >
\=======================================================/
Function : Word validation and deletion
Pkey : "R" @
Pdata : [D]
<Blank> Validate new words added to dictionary
"D" Delete word from dictionary
This command, based on the Pdata, allows validation of new words added to
the dictionary during a spell check or deletion of a specified word from
the dictionary.
/===============================================\
< "S" Scan public messages >
\===============================================/
Function: Scan public messages in current section
Pkey: "S"
Pdata: None
This command scans the subjects of the next few public messages in the
current section starting at the message number specified by the user. After
listing them, the user enters the normal read mode, where they may either
indicate the messages they wish to read, or enter "S" for the next few
message subjects.
/============================================\
< "U" Users with access >
\============================================/
Function: List users who have access to a message section
Pkey: "U"
Pdata: None
This command lists all the users who have access to the current public
message section. Access is determined by what is defined in the message
section configuration.
/========================================\
< "V" Voting System >
\========================================/
Function: Voting system
Pkey: "V"
Pdata: None
This command sends the user to the voting system. Voting questions are
defined in the voting initialization system. Users may only be allowed to
view the voting questions and results depending on their special flag
settings and the user
configuration.
===========================================================================
January, 1993 (Preliminary) Page 29
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/================================================\
< "W" Read the auto-message >
\================================================/
Function: Read the auto-message
Pkey: "W"
Pdata: None
This command reads the currently posted auto-message. If none is posted,
the command states so.
/===============================================================\
< "X" [N] Describe the current message section >
\===============================================================/
Function: Describe current message section
Pkey: "X"
Pdata: [N]
<BLANK> A simple error message is printed when a section description file
is missing.
"N" All error messages are suppressed when the section description
file is missing.
This command displays a text file containing a description of the current
message section. The files which contain the description have the name
"BOARD.*" for Fido style messages or "BOARD###.*" for Hudson (RA/QBBS)
style messages (### is the unique board number assigned to each section).
In either case, these files are located in the directory where the messages
are actually stored (set in the configuration for each message section).
Whether an error message is display when T.A.G. encounters a missing
section description file is determined by the Pdata.
For example:
Section #1 is a Hudson (RA/QBBS) message base with board number 7.
"BOARD007.*" should be located in the same directory as the *.BBS files.
Linking this command to the change section command would provide forced
descriptions of each message section.
/=======================================================\
< "Y" Main system user information >
\=======================================================/
Function: Main system user information
Pkey: "Y"
Pdata: None
This command gives a very extensive description of the user currently on
the system. It is very similar to the extended user listing in the user
editor.
===========================================================================
January, 1993 (Preliminary) Page 30
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/===========================================\
< "Z" Edit user macros >
\===========================================/
Function: Edit user macros
Pkey: "Z"
Pdata: None
This command allows the user to create and/or edit their macro definitions.
These macros can be activated by pressing Control-D, Control-E, Control-F,
or Control-R and may be used almost anywhere on the system.
/=======================================================\
< "2" @ Voting initialization system >
\=======================================================/
Function: Voting initialization system
Pkey: "2" @
Pdata: None
This command allows the user to create, change the voting questions on the
voting board. Old voting questions are not erased when using this command
unless the user so specifies.
/================================================\
< "3" (*1) @ Read all private mail >
\================================================/
Function: Read all private mail
Pkey: "3" (*1) @
Pdata: None
This command allows the user to read all private mail currently on the
system. Messages are read from newest to oldest by date sent. Users must
enter SysOp password #1 to use this command.
/==========================================\
< "4" @ View Sysop Logs >
\==========================================/
Function: View SysOp logs
Pkey: "4" @
Pdata: None
This command allows the user to display the SysOp logs (SYSOP.LOG and
SYSOP###.LOG). The logs for today and previous days may all be displayed
using this command.
===========================================================================
January, 1993 (Preliminary) Page 31
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/===============================================\
< "5" <Password> Auto user validation >
\===============================================/
Function: Auto user validation
Pkey: "5"
Pdata: <Password>
<Password> The password the user must enter to be validated.
This command allows users who know the specified password to validate
themselves on-line after logging on as new user (assuming they have access
to the command of course). All use of this command is saved in the SysOp
log. The file ACCESS.MSG is optionally displayed after a successful
validation. Note: You must have defined the special validation key "~" in
the access validation manager to specify the access level for the auto
validation command.
/==========================================================\
< "6" @! Change the system time and date >
\==========================================================/
Function: Change system time and date
Pkey: "6" @!
Pdata: None
This command allows a user to change the time and date on the system. Note:
This is only a software time set, hardware clocks usually require a special
program to set them.
WARNING:
If a user should set the date to a very incorrect value (such as 01/01/80)
the system will likely experience many problems, and may even refuse to
operate.
/=================================================================\
< "7" Information on current message section >
\=================================================================/
Function : Information on current message section
Pkey : "7"
Pdata : None
This command displays various information about the current message
section. The command is access sensitive and will reduce the information
displayed depending on the access of the user executing it.
===========================================================================
January, 1993 (Preliminary) Page 32
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/===============================================\
< "-" System status report >
\===============================================/
Function: System status report
Pkey: "-"
Pdata: None
This command displays the system status report exactly as seen on the wait
screen when T.A.G. is waiting for another caller.
/==========================================\
< ";" Execute TAGMAIL >
\==========================================/
Function: Execute TAGMAIL message service system
Pkey: ";"
Pdata: None
This command simply calls "TAGMAIL.BAT" after doing some organizational
setup required by the TAGMAIL program. TAGMAIL is an external message
system capable of interconnecting with Net/Matrix/Echo mail services. See
that program's documentation for more information.
/===============================================\
< ">" Access the time bank >
\===============================================/
Function: Access the time bank
Pkey: ">"
Pdata: None
This command allows the user to deposit on-line time for use in future
logon sessions, withdraw time from the bank to extend on-line time for this
session, or check the balance in the time bank. Limits for deposit and
withdrawal are specified in the system configuration.
===========================================================================
January, 1993 (Preliminary) Page 33
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/===================================================\
< "?" [@]<xxxxx> Access the questionnaire >
\===================================================/
Function: Access the questionnaire
Pkey: "?"
Pdata: [@]<xxxxx>
[@] When this designator is used, the questionnaire has no menu. The
filename created from the concatenation of the <xxxxx> string, the
letter "Q" and either .MSG or .CLR will contain the questionnaire.
<xxxxx> A string of from 1 to 5 characters which will be used as the first
characters of the questionnaire file to produce either xxxxxQ.*,
or xxxxx.* and xxxxxQ@@.* (where .* is either .CLR or .MSG and
where @@ are any two characters provided by the user in response
to the menu).
This command allows the user to answer a questionnaire either directly (@
option) or through a menu. If the menu method is used, the file xxxxx.CLR
or xxxxx.MSG (where xxxxx is the Pdata) is a menu which contains many
questionnaires. The user chooses the questionnaire by typing a two
character code associated with a particular questionnaire. That code (eg.
@@) is used to create the filename of the questionnaire (xxxxxQ@@.CLR or
xxxxxQ@@.MSG). Answers from the user are stored in the file xxxxxA@@.TXT.
If the @ option is used, the questionnaire file is xxxxxQ.CLR or xxxxxQ.MSG
and the answer file is xxxxxA.TXT.
===========================================================================
January, 1993 (Preliminary) Page 34
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/===========================================\
< "~" [L | O][<Err>][*<#>] Shut down system >
\===========================================/
Function: Shut down system
Pkey: "~" (*3) @!
Pdata: [L | O][<Error Level>][*<Password #>]
"L" The system will leave the user on-line when it shuts
down.
"O" The system will take the phone off-hook after
disconnecting the user when shutting down.
[<Error Level>] What error level should be passed to the MS-DOS command
interpreter after shutting down the system. The default
error level, if not specified, is "0" (zero).
[*<Password #>] SysOp password protection for the this command. The
password number may be "0" (no password) or a number from
"1" to "3" indicating the password number. The default is
SysOp password #3.
This command allows a user to shut T.A.G. down and drop to MS-DOS with a
specified error level. Remote shutdown is not normally needed, but it would
be handy to have if there was a serious problem with the system that could
not be fixed from the remote site. With a little planning this command
could be used to drop to DOS on limited memory systems where a shell DOS
would not be appropriate. Granted the user would be disconnected when the
system was re-booted, but it's better than nothing at all.
===========================================================================
January, 1993 (Preliminary) Page 35
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/========================\
< File System Program Keys >
\========================/
/==========================================\
< "A" List File Areas >
\==========================================/
Function: List file areas
Pkey: "A"
Pdata: None
This command lists the file sections available on the system. Normally
unaccessible sections are not listed, but the privilege settings in the
system configuration determine which unaccessible sections, if any, a user
can see. This list may be limited to certain boards by an optional section
mask. See the descriptions of section masks for more information.
/=======================================\
< "B" Browse Files >
\=======================================/
Function: Browse files
Pkey: "B"
Pdata: None
This command allows a user to view the files in the current section
starting at a specified file number. Other commands which can be preformed
include downloading files by number, uploading a file to the current
section, and listing a more detailed description of any file. When
downloading, a ratio check is preformed to see if the user is still in good
standing unless the section is flagged for no charge or the user does not
have a ratio check. Download CoSysOp's also have the ability to set the
file points on individual or groups of files. Files which are not validated
may or may not be available depending on the DSL setting in the system
configuration.
/==========================================\
< "C" [U] Clear the queue >
\==========================================/
Function: Clear the batch upload or download queue
Pkey: "C"
Pdata: [U]
<BLANK> Clear the download queue.
"U" Clear the upload queue.
This command will clear the current list of files in the batch upload or
download queue depending on the Pdata. The user is asked for verification
before actually clearing the list.
===========================================================================
January, 1993 (Preliminary) Page 36
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/==========================================\
< "D" Download a file >
\==========================================/
Function: Download a file from the current section
Pkey: "D"
Pdata: None
This command allows the user to specify a file or file mask for the file(s)
then wish to download in the current section. Files that appear in the
download directory of the section, but do not appear in the file listing
are not valid. A ratio check is preformed to see if the user is still in
good standing unless the section is flagged for no charge or the user does
not have a ratio check. Files which are not validated may or may not be
available depending on the DSL setting in the system configuration.
/=============================================\
< "E" @ Exchange directory >
\=============================================/
Function: Exchange to the upload/last directory
Pkey: "E" @
Pdata: None
This command can do one of two things. First, if the user is in a defined
file section, it will create a temporary section, after the last file
section, and assign the download and upload paths to the current section's
upload path. The filename of the section will be "FILES" because that is
what is used for differing upload directories. If the download and upload
paths of the current section are the same, this has no effect. Second, if
the user is in a temporary file section, they will be switched back to the
last defined file section they were in.
/====================================\
< "F" Find text >
\====================================/
Function: Find text in file name or file descriptions
Pkey: "F"
Pdata: None
This command prompts the user for part of a description. T.A.G. then will
search, depending on the users choice, either the current file section or
all accessible file sections, that are valid choices, for files with the
entered piece of description in their filename or description. The search
is not effected by text case. Files which are not validated may or may not
be available depending on the DSL setting in the system configuration.
===========================================================================
January, 1993 (Preliminary) Page 37
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/===============================================\
< "G" Download batch queue >
\===============================================/
Function: Download files in the batch queue
Pkey: "G"
Pdata: None
This command allows the user to download the files currently in the batch
transfer queue. A time check is made to see if the user still have enough
time to download the files, if not, they are asked to remove the ones they
do not want.
/=========================================\
< "H" [$[?][!]]<Filename> File Door Call >
\=========================================/
Function : Execute a file door call
Pkey : "H"
Pdata : [$[?][!]]<Filename>
"$" Ask user to enter a filename to be passed to the door.
"?" Allow wild card characters in the filename entered by the user
(Must specify "$" also).
"!" One or more file must exist in the current file section which
match the filename/filemask entered.
<Filename> Name of the program to execute
This command is designed to allow much easier implementation of file
related door operations. Before execution both a standard DORINFO1.DEF and
DOOR.SYS file are created.
The filename specified in the Pdata is executed with the following
parameters:
%1 Real baud rate of the user (port speed)
%2 Communications port
%3 ID number of current user (user number)
%4 Download pathname of the current file section
%5 Download filename of the *.DIR file of the current section
%6 Upload pathname of the current file section
%7 Upload filename of the *.DIR file of the current section
%8 User specified filename without the extension (if entered)
%9 Extension of the user specified filename (if entered)
Note: The upload filename will be the same and the download filename if the
upload and download pathnames are the same. Otherwise the upload
filename uses the default "FILES.DIR".
===========================================================================
January, 1993 (Preliminary) Page 38
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/========================================\
< "I" [G | @] View interior >
\========================================/
Function: View the files inside an *.ZIP, *.ARC, or *.PAK archive file
Pkey: "I"
Pdata: [G | @]
<BLANK> Match based on filemask in the current section only.
"G" Match based on filemask in all section.
"@" Match based on description. User prompted whether search is in
current section only or all sections.
This command allows a user to view the files inside a standard archive
file. The following file formats are supported:
1. "*.ZIP" files produced by PKWare's PKZIP/PKUNZIP programs.
2. "*.ARC" files produced by PKWare's PKPAK/PKUNPAK programs.
3. "*.ARC" files produced by SEA's ARC program. (though version 6.00).
4. "*.PAK" files produced by NoGate's PAK program.
If no file extension is specified, ".*" is assumed.
/=======================================\
< "J" Upload batch >
\=======================================/
Function: Upload files in the batch upload queue
Pkey: "J"
Pdata: None
This command allows the user to upload the files currently in the upload
queue. Afterwards several tests are preformed to try and catch all the
uploaded files, specifically those sent but not specified in the upload
queue. Due to differing protocols, it may not be possible to in all cases.
One should consider a specific batch upload section if this is a problem.
/====================================================\
< "K" [U] Remove from a batch queue >
\====================================================/
Function: Remove a file from the batch upload or download queue
Pkey: "K"
Pdata: [U]
<BLANK> Remove a file from the batch download queue.
"U" Remove a file from the batch upload queue.
This command allows the user to remove one file, by number, from the
current batch upload or download queue. File numbers are obtained by
listing the files in the appropriate queue.
===========================================================================
January, 1993 (Preliminary) Page 39
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/=====================================\
< "L" List files >
\=====================================/
Function: List available files in the current section with a file mask
Pkey: "L"
Pdata: None
This command allows a user to list the available files in the current file
section. The user is first asked to enter an optional file mask. If none is
entered, all files available are listed. Files which are not validated may
or may not be available depending on the DSL setting in the system
configuration.
/============================================\
< "M" Users with access >
\============================================/
Function: List users who have access to a message section
Pkey: "M"
Pdata: None
This command lists all the users who have access to the current file
section. Access is determined by what is defined in the file section
configuration.
/===================================\
< "N" [G | C] New scan >
\===================================/
Function: Scan file sections for new files
Pkey: "N"
Pdata: [G | C]
<BLANK> Ask user whether to search all sections or just current.
"G" Search all sections.
"C" Search current section.
This command scans one or more file sections for new files according to the
new file pointer date. Files which are not validated may or may not be
available depending on the DSL setting in the system configuration.
===========================================================================
January, 1993 (Preliminary) Page 40
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/============================================\
< "O" @ [R] Unlisted download >
\============================================/
Function: Unlisted file download
Pkey: "O" @
Pdata: [R]
<BLANK> Allow unlisted downloads from any directory if the user has
Download CoSysOp access or higher, otherwise restrict them to this
file section only.
[R] Restrict unlisted downloads to the current file section only.
This command allows a user to download files which may or may not appear in
any file listing. Whether the user is allowed to specify a pathname for the
file depends on the Pdata.
/==============================================\
< "P" Change pointer date >
\==============================================/
Function: Change the new scan pointer date
Pkey: "P"
Pdata: None
This command allows the user to change the current new scan pointer date.
This date defaults to the last time the user has called.
/=====================================\
< "Q" [U] List queue >
\=====================================/
Function: List files currently in the upload or download queue.
Pkey: "Q"
Pdata: [U]
<BLANK> List and summarize the files currently in the batch download
queue.
"U" List the files and descriptions currently in the batch upload
queue.
This command lists the files currently in the upload or download batch
queue. Summary totals are produced on the download queue for the total
Xmodem blocks, bytes, and estimated time.
===========================================================================
January, 1993 (Preliminary) Page 41
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/=======================================\
< "R" Remove files >
\=======================================/
Function: Remove one or more files from the current section
Pkey: "R"
Pdata: None
This command allows the user to remove one or more files from the current
section. The user is first prompted for a file mask, then the system will
display each matching file one at a time giving the option to delete the
file or proceed to the next matching file. Unless the user has Download
CoSysOp access, they will only be allowed to remove files they have
uploaded. Download CoSysops are given the option of whether to delete the
actual file in the directory and whether to remove the file's credit from
the user who uploaded it (if they can still be found in the user log).
Normal users automatically delete the actual file, and will remove credit
of the upload from themselves if it is being deleted on the same day it was
uploaded. Note that a disgruntled user might consider using this command to
delete everything they have uploaded.
/=========================================\
< "S" Scan for files >
\=========================================/
Function: Scan file sections for files matching a file mask
Pkey: "S"
Pdata: None
This command prompts the user for a file mask. If no extension is
specified, "*.*" will automatically be appended to the end of their entry.
T.A.G. will then search, depending on the users choice, either the current
file section or all accessible file sections, that are valid choices, for
files matching the mask entered. Files which are not validated may or may
not be available depending on the DSL setting in the system configuration.
/======================================\
< "T" Type a file >
\======================================/
Function: Type a file (ASCII download)
Pkey: "T"
Pdata: None
This command allows a user to view a specified file in ASCII format. No
check is made to see if the file is actually an ASCII file, so anyone
ignorant enough to try and type an archive, for example, will find
themselves with quite a mess on their screen. Files which are not validated
may or may not be available depending on the DSL setting in the system
configuration. Note that this command is equivalent to downloading the file
normally using the ASCII protocol.
===========================================================================
January, 1993 (Preliminary) Page 42
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/========================================\
< "U" Upload a file >
\========================================/
Function: Upload a file to the current section
Pkey: "U"
Pdata: None
This command allows the user to upload a file to the current section.
Checks are made to see if the file already exists in the listing and/or
already exists in the download directory. If the user is a download CoSysOp
and the file exists in the directory, but not the listing, T.A.G. will ask
to see if they wish to add the file to the download listing.
/=========================================\
< "V" @ [G] Validate files >
\=========================================/
Function: Validate files
Pkey: "V" @
Pdata: [G]
<BLANK> Validate files in the current section.
"G" Validate files in all sections.
This command allows the user to validate non-validated files in the current
section. A choice is given on whether to validate all files, validate
individual files, or validate individual files while setting file points.
The file points option also asks how many points to give the user who
uploaded the file. When validated, files are set to the current date so
normal users will see them on their new scan. If a user is designated as
having to wait until file validation for upload credit, credit is given to
the user automatically.
/========================================\
< "W" @ [R] Raw Directory >
\========================================/
Function: Raw directory
Pkey: "W" @
Pdata: [R]
<BLANK> Allow raw directory of any directory if the user has download
CoSysOp access or higher, otherwise restrict them to this file
section only.
[R] Restrict raw directories to the current file section only.
This command allows the user to request a directory of files actually on
the drive. The user is prompted for a path name and/or a file mask. Whether
the user is allowed to specify a path name for the directory depends on the
Pdata setting.
===========================================================================
January, 1993 (Preliminary) Page 43
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/===========================================\
< "X" [N] Describe section >
\===========================================/
Function: Describe current file section
Pkey: "X"
Pdata: [N]
<BLANK> A simple error message is printed when a section description file
is missing.
"N" All error messages are suppressed when the section description
file is missing.
This command displays a text file containing a description of the current
file section. The files which contain the section descriptions have the
same name as the section file name with the extension of ".MSG" or ".CLR".
These files are located in the Alternate Text File Directory. See the
"<BoardName>.*" file description in the main T.A.G. documentation for
specifics. Whether on not an error message is displayed when T.A.G.
encounters a missing section description file is determined by the Pdata.
For example: Section #1 has the file name of "MISC". MISC.MSG should appear
in the Alternate Text File Directory with a description of the
Miscellaneous Files section.
Linking this command to the change section command would provide forced
descriptions of each file section.
/=======================================================\
< "Y" File system user information >
\=======================================================/
Function: File system user information
Pkey: "Y"
Pdata: None
This command displays specific user information that effects a user in the
file section. This includes access, ratios, and file point status.
/=============================================\
< "Z" Set new scan flags >
\=============================================/
Function: Set board flags for new scan
Pkey: "Z"
Pdata: None
This command allows the user to specify which sections are searched during
a new scan. The user has the ability to toggle individual boards ON or OFF
the scan.
===========================================================================
January, 1993 (Preliminary) Page 44
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/=====================================\
< "2" @ Sort files >
\=====================================/
Function: Sort one or more file sections
Pkey: "2" @
Pdata: None
This command allows the user to sort one or more file sections by name,
size, date, times downloaded, or description. The sort may be in either
ascending or descending order. A choice is also given on whether to sort
the current section only, or all sections.
/=====================================\
< "3" @ Edit files >
\=====================================/
Function: Edit one or more files
Pkey: "3" @
Pdata: None
This command allows the user to edit one or more files from the current
section. The user is first prompted for a file mask, then the system will
display each matching file one at a time giving the option to edit each of
the displayed fields or go on to the next matching file.
/=====================================\
< "4" @ Move files >
\=====================================/
Function: Move one or more files to another file section
Pkey: "4" @
Pdata: None
This command allows the user to move one or more files from the current
section to other file sections. The user is first prompted for a file mask,
the system will display each matching file one at a time giving the option
to move the file to another section or go on to the next matching file.
/===================================================\
< "5" List section information >
\===================================================/
Function: Lists information about the current file section
Pkey: "5"
Pdata: None
This command lists information about the current file section as defined in
the Download Board Editor. The main use of this command is to find the
settings of a certain file section without having to go into the Download
Board Editor. It also displays the free space on the Upload disk drive and
the Download disk drive
===========================================================================
January, 1993 (Preliminary) Page 45
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/==================================================\
< "6" @! Change active directory >
\==================================================/
Function: Change active directory
Pkey: "6" @!
Pdata: None
This command allows a user to change the active download directory. A path
will be asked of the user, and then a temporary section will be created
after the last available section if it is valid. The section file name will
be set to "FILES" by default. Changing sections or using the exchange
command will put the user back into a real section.
===========================================================================
January, 1993 (Preliminary) Page 46
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/==============================\
< Read Message Menu Program Keys >
\==============================/
/=====================================================\
< "A" Read current message again >
\=====================================================/
Function : Read current message again
Pkey : "A"
Pdata : None
This command reads the current message (if any) again. If does not change
the users current message number.
/======================================================\
< "C" Continuous read of messages >
\======================================================/
Function : Continuous read of messages
Pkey : "C"
Pdata : None
This command switches the message system into continuous read mode. While
in this mode, messages are read one at a time in the current direction
until either no ore messages exist or the user aborts a message with the
space bar. Pressing control-N will not abort the continuous read process,
but will skip the remaining text in the current message.
===========================================================================
January, 1993 (Preliminary) Page 47
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/===============================================\
< "D" Default next message >
\===============================================/
Function : Default next message in current direction
Pkey : "D"
Pdata : None
This command goes to the next message in the current reading direction.
For example, if they are reading forward in the messages, it would produce
the next higher numbered message available to them.
/=================================================================\
< "I" Ignore messages and go to next section >
\=================================================================/
Function : Ignore messages and go to next section
Pkey : "I"
Pdata : None
This command ignores the remaining messages in the current section (sets
the user's new scan point to the last message) and goes to the next section
in the new scan. If the user is not doing a new scan, then they are simply
sent back to the menu from which they starting reading messages.
/==================================================================\
< "K" Kludge/technical information on message >
\==================================================================/
Function : Kludge/technical information on current message
Pkey : "K"
Pdata : None
This command displays the message flags, kludge lines, and other technical
information abort the current message.
/===============================================\
< "N" Next message section >
\===============================================/
Function : Next message section
Pkey : "N"
Pdata : None
This command skips the remaining messages in the current section and goes
to the next section in the new scan. The user's new scan pointer is left
at the message they were currently reading.
===========================================================================
January, 1993 (Preliminary) Page 48
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/==========================================================\
< "P" [A][R][I] Post message in current section >
\==========================================================/
Function : Post message in current section
Pkey : "P"
Pdata : [A][R][I]
<Blank> Normal post (no file attaches/requests)
"A" Allow file attaches in net mail sections @
"R" Allow file requests in net mail sections @
"I" Ask for Node number and Display Node Info
This command posts a public message in the current section if the user has
the access required. It will also optionally allow file attaches and
requests in net mail sections assuming the user has met the security
requirements defined in the system configuration.
/=================================================\
< "Q" Quit read message menu >
\=================================================/
Function : Quit read message menu
Pkey : "Q"
Pdata : None
This command exists from a menu located in the "Read Message System". This
is the only correct method of exiting from a menu of this type aside from
logging off the system. Read message menus cannot GOTO or GOSUB menus in
other locations.
/===================================================\
< "R" [A][R][E or P] Reply to current message >
\===================================================/
Function : Reply to current message
Pkey : "R"
Pdata : [A][R][E or P]
<Blank> Normal reply (ask user if public/private - no file
attaches/requests)
"A" Allow file attaches in net mail sections @
"R" Allow file requests in net mail sections @
"E" Force the reply to be private
"P" Force the reply to be public
This command allows the user to sent a reply to the author of the current
message (if any). It will also optionally allow file attaches and requests
in net mail sections assuming the user has met the security requirements
defined in the system configuration. The options to force the reply to be
public or private can be used in the case where separate commands for
public and private replies are desired.
===========================================================================
January, 1993 (Preliminary) Page 49
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/========================================================\
< "S" Subjects of next few messages >
\========================================================/
Function : Subjects of next few messages
Pkey : "S"
Pdata : None
This command displays a summary of subjects/from/to of the next 15 messages
in the current section. The user's read point is set to the last message
listed.
/=================================================================\
< "T" Toggle scan setting of current section >
\=================================================================/
Function : Toggle scan setting of current section
Pkey : "T"
Pdata : None
This command toggles the scan flag for the current message section. When
scanning is disabled, the section will not be scanned on a "(N)ew scan"
type command.
/=============================================================\
< "U" User info - current message author >
\=============================================================/
Function : User information - current message author
Pkey : "U" @
Pdata : None
This command shows the extended user listing of the author of the current
message if s/he can be found in the user log. This command should only be
available to SysOp's as it shows private information which should not be
available to the general public.
/=============================================================\
< "V" Validate author of current message >
\=============================================================/
Function : Validate author of current message
Pkey : "V" @
Pdata : None
This command validates the author of the current message if s/he can be
found in the user log. This command should only be available to SysOp's as
it changes the access level of the users in question.
===========================================================================
January, 1993 (Preliminary) Page 50
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/================================================================\
< "W" Write current message to file/printer >
\================================================================/
Function : Write current message to file/printer
Pkey : "W" @
Pdata : None
This command writes the current message to a text file. It allows the user
to optionally remove the message header to ANSI type messages where a
header would get in the way. This command should be restricted to SysOp's
as it allows users to place files on the hard drive at will. Certain
extensions are not permitted, including COM, EXE, BAT, etc. To write to the
printer, use LPTn, where n=Port number.
/=================================================\
< "Z" Delete current message >
\=================================================/
Function : Delete current message
Pkey : "Z"
Pdata : [Z]
<Blank> Delete current message and send receipt
[Z] Do not send delete receipt (zap)
This command deletes the current message assuming the user has access to do
so. Normal users may only delete mail to or from them (this includes both
their handle and real name). If a "Z" is not present in the program data,
a delete receipt is sent to the author of the message indicating you have
read the message.
/=================================================\
< "+" Next message in thread >
\=================================================/
Function : Next message in thread
Pkey : "+"
Pdata : None
This command reads the next message in the current reply thread. T.A.G.
does not currently support internal threading. An external utility must be
used to create the message threads.
===========================================================================
January, 1993 (Preliminary) Page 51
T.A.G. BBS Version 2.6d Menu Documentation
===========================================================================
/=====================================================\
< "-" Previous message in thread >
\=====================================================/
Function : Previous message in thread
Pkey : "-"
Pdata : None
This command reads the previous message in the current reply thread. T.A.G.
does not currently support internal threading. An external utility must be
used to create the message threads.
/==================================================================\
< "7" Information on the current message base >
\==================================================================/
Function : Information on current message section
Pkey : "7"
Pdata : None
This command displays various information about the current message
section. The command is access sensitive and will reduce the information
displayed depending on the access of the user executing it.
===========================================================================
January, 1993 (Preliminary) Page 52