/======================================\
< T.A.G. Version 2.5g 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. 2.5g - Copyright (C) 1986-1989 Robert Numerick, )
\________________ and Victor Capton. _________________/
\__________________________/
T.A.G. BBS Version 2.5g Menu Documentation
=========================================================================
>>> Table of Contents <<<
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Definition of Terms Used in this Document . . . . . . . . . . . . . . 2
Access Restriction Flag or AR Flag . . . . . . . . . . . . . . . . 2
Download Security Level or DSL . . . . . . . . . . . . . . . . . . 2
Program Data or PData . . . . . . . . . . . . . . . . . . . . . . 2
Program Key or PKey . . . . . . . . . . . . . . . . . . . . . . . 2
Security Level or SL . . . . . . . . . . . . . . . . . . . . . . . 2
Special Flag or SF . . . . . . . . . . . . . . . . . . . . . . . . 2
Description of Menu Header Information . . . . . . . . . . . . . . . 3
Menu list number . . . . . . . . . . . . . . . . . . . . . . . . . 3
Menu number . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Menu name . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Prompt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
General SL . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
AR flag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Help file ID . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Fallback menu . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Menu location . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Flags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
<SL/DSL> access check . . . . . . . . . . . . . . . . . . . . . 5
GSL <and/or> AR . . . . . . . . . . . . . . . . . . . . . . . . 5
Time/Help <ON/OFF> . . . . . . . . . . . . . . . . . . . . . . 5
Board <NORMAL/ON> . . . . . . . . . . . . . . . . . . . . . . . 5
Menu name <NORMAL/PROMPT> . . . . . . . . . . . . . . . . . . . 5
Description of Command Information . . . . . . . . . . . . . . . . . 6
Command number . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Long description . . . . . . . . . . . . . . . . . . . . . . . . . 6
Short description . . . . . . . . . . . . . . . . . . . . . . . . 6
Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
General SL . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
AR flag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Program key . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Program data . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Flags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
<SL/DSL> access check . . . . . . . . . . . . . . . . . . . . . 7
GSL <and/or> AR . . . . . . . . . . . . . . . . . . . . . . . . 7
<Normal/Hidden> Command . . . . . . . . . . . . . . . . . . . . 7
Sample command . . . . . . . . . . . . . . . . . . . . . . . . . . 8
=========================================================================
October 1, 1990 Page i
T.A.G. BBS Version 2.5g Menu Documentation
=========================================================================
>>> Table of Contents <<<
Predefined Menu Commands Available on All Menus . . . . . . . . . . . 9
<space> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
<enter> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
\ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
FALLBACK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
General Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Commands with a key of more than one character . . . . . . . . . . 9
Commands are acting funny . . . . . . . . . . . . . . . . . . . . 9
Command Definition Key . . . . . . . . . . . . . . . . . . . . . . 10
Text conventions . . . . . . . . . . . . . . . . . . . . . . . . 10
" | " . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
"< ... >" . . . . . . . . . . . . . . . . . . . . . . . . . . 10
"[ ... ]" . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Command flags . . . . . . . . . . . . . . . . . . . . . . . . . 10
(*<#>) . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
@ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
@! . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Section Masks . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Linked Command Information . . . . . . . . . . . . . . . . . . . . 12
Linked command example . . . . . . . . . . . . . . . . . . . . . 12
Standard Program Keys Available from all Menus . . . . . . . . . . 13
"!" [@]<Filename>[.Ext] Display a text file . 13
"@" [<User #>] Page the SysOp . . . . 13
"#" [<Mask>][;<Pkey><Pdata>] Change sections . . . 14
"$" Version Information . 14
"^" [C]<Menu #>[;<PKey><PData>] Goto another menu . . 15
"/" [C]<Menu #>[;<PKey><PData>] Gosub another menu . 15
"\" [C][;<Pkey><PData>] Return to saved menu . 16
"&" Sysop Status . . . . . 16
"*" [<User #> | I | T] Logoff system . . . . 17
"(" Menu information . . . 17
"|" [F]<Section #>[;<PKey><PData>] Change to a section . 18
"[" [<Mask>[;<PKey><PData>]] Search Backward . . . 18
"]" [<Mask>[;<PKey><PData>]] Search Forward . . . . 19
"1" <A | B | D | F | L | M | P | S | U | V> Execute function . 20
"." (*3) @! Shell to DOS . . . . . 21
External DOOR Program Keys . . . . . . . . . . . . . . . . . . . . 22
":" [@][*]<Filename> RBBS door program (NEW format) . . . . . . 22
"_" [@][*]<Filename> RBBS door program (OLD format) . . . . . . 23
"=" [@][*]<Filename> DOOR.SYS and GAP(tm) door programs . . . . 24
"<" [@][*]<Filename> Execute a generic door program . . . . . . 25
=========================================================================
October 1, 1990 Page ii
T.A.G. BBS Version 2.5g Menu Documentation
=========================================================================
>>> Table of Contents <<<
Main System Program Keys . . . . . . . . . . . . . . . . . . . . . 26
"A" [<Mask>] List message areas . . . . . . . . . 26
"B" Bulletin system . . . . . . . . . . . 26
"C" Create auto-message . . . . . . . . . 26
"D" <1..13, 15..23> User information functions . . . . . 27
"1" List the users information that can be changed. . . . . 27
"2" Change the user's address. . . . . . . . . . . . . . . . 27
"3" Change the user's city & state. . . . . . . . . . . . . 27
"4" Change the user's zip code. . . . . . . . . . . . . . . 27
"5" Change the user's phone number. . . . . . . . . . . . . 27
"6" Change the user's computer type. . . . . . . . . . . . . 27
"7" Change the user's ANSI colors. . . . . . . . . . . . . . 27
"8" Change the user's birthday. . . . . . . . . . . . . . . 27
"9" Change the user's highest baud. . . . . . . . . . . . . 27
"10" Change the user's screen size (columns and lines). . . . 27
"11" Toggle the user's ANSI status. . . . . . . . . . . . . . 27
"12" Toggle the user's color status. . . . . . . . . . . . . 27
"13" Change the user's logon password. . . . . . . . . . . . 27
"15" Toggle the user's [PAUSE] status. . . . . . . . . . . . 27
"16" Toggle the user's onekey status. . . . . . . . . . . . . 27
"17" Toggle the user's VT-100 type tab status. . . . . . . . 27
"18" Toggle the user's CLS status. . . . . . . . . . . . . . 27
"19" Change the user's mailbox configuration. . . . . . . . . 27
"20" Change which bases the user new scans. . . . . . . . . . 27
"21" Change menu to logon at (NOT supported). . . . . . . . . 27
"22" Change the user's help level. . . . . . . . . . . . . . 27
"23" Toggle the user's custom menu status. . . . . . . . . . 27
"E" [M] Send private mail . . . . . . . . . . 28
"F" <User #> Feedback . . . . . . . . . . . . . . 28
"H" Reply to author of auto-message . . . 28
"K" Read/delete sent private mail . . . . 29
"L" List matching users . . . . . . . . . 29
"M" Read waiting private mail . . . . . . 29
"N" [G | <Mask>] New scan message sections . . . . . . 30
"O" Other bulletin board listing . . . . 30
"P" Post a public message . . . . . . . . 30
"R" Remove a public message . . . . . . . 31
"S" Scan public messages . . . . . . . . 31
"U" Users with access . . . . . . . . . . 31
"V" Voting System . . . . . . . . . . . . 32
"W" Read the auto-message . . . . . . . . 32
"X" [N] Describe the current message section 33
"Y" Main system user information . . . . 33
"Z" Edit user macros . . . . . . . . . . 34
=========================================================================
October 1, 1990 Page iii
T.A.G. BBS Version 2.5g Menu Documentation
=========================================================================
>>> Table of Contents <<<
"2" @ Voting initialization system . . . . 34
"3" (*1) @ Read all private mail . . . . . . . . 34
"4" @ View Sysop Logs . . . . . . . . . . . 35
"5" <Password> Auto user validation . . . . . . . . 35
"6" @! Change the system time and date . . . 35
"-" System status report . . . . . . . . 36
";" Execute TAGMAIL . . . . . . . . . . 36
">" Access the time bank . . . . . . . . 36
"?" [@]<xxxxx> Access the questionnaire . . . . . . 37
"~" [L | O][<Err>][*<#>] Shut down system . . . . . . . . . . 38
File System Program Keys . . . . . . . . . . . . . . . . . . . . . 39
"A" [<Mask>] List File Areas . . . . . . . . . . . 39
"B" Browse Files . . . . . . . . . . . . 39
"C" [U] Clear the queue . . . . . . . . . . . 40
"D" Download a file . . . . . . . . . . . 40
"E" @ Exchange directory . . . . . . . . . 40
"F" [<Mask>] Find text . . . . . . . . . . . . . 41
"G" Download batch queue . . . . . . . . 41
"H" [N] Describe section . . . . . . . . . . 42
"I" [G | @ | <Mask>] View interior . . . . . . . . . . . . 42
"J" Upload batch . . . . . . . . . . . . 43
"K" [U] Remove from a batch queue . . . . . . 43
"L" List files . . . . . . . . . . . . . 43
"M" Users with access . . . . . . . . . . 44
"N" [G | C | <Mask>] New scan . . . . . . . . . . . . . . 44
"O" @ [R] Unlisted download . . . . . . . . . . 44
"P" Change pointer date . . . . . . . . . 45
"Q" [U] List queue . . . . . . . . . . . . . 45
"R" Remove files . . . . . . . . . . . . 45
"S" [Mask] Scan for files . . . . . . . . . . . 46
"T" Type a file . . . . . . . . . . . . . 46
"U" Upload a file . . . . . . . . . . . . 46
"V" @ [G | <Mask>] Validate files . . . . . . . . . . . 47
"W" @ [R] Raw Directory . . . . . . . . . . . . 47
"X" <Filename> File door call . . . . . . . . . . . 48
"Y" File system user information . . . . 48
"Z" Set new scan . . . . . . . . . . . . 49
"2" @ Sort files . . . . . . . . . . . . . 49
"3" @ Edit files . . . . . . . . . . . . . 49
"4" @ Move files . . . . . . . . . . . . . 50
"5" List section information . . . . . . 50
"6" @! Change active directory . . . . . . . 50
=========================================================================
October 1, 1990 Page iv
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
o=============================o
\ Introduction /
< ----------- by ------------ >
/ Victor Capton & Paul Loeber \
o=============================o
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.
=========================================================================
October 1, 1990 Page 1
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
/=========================================\
< 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.
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.
=========================================================================
October 1, 1990 Page 2
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
/======================================\
< 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.
=========================================================================
October 1, 1990 Page 3
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
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.
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.
=========================================================================
October 1, 1990 Page 4
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
Menu location:
This field specifies to which of two systems, the main system or the
file system, the menu belongs. T.A.G. uses this information to
automatically load the proper system when changing menus. (In versions
2.3a and prior this was the responsibility of the SysOp).
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.
=========================================================================
October 1, 1990 Page 5
T.A.G. BBS Version 2.5f 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.
=========================================================================
October 1, 1990 Page 6
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
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.
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 will appear on the menu information list if the
user has SysOp access or greater.
=========================================================================
October 1, 1990 Page 7
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
Sample command you may have created:
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. Care should
be taken as with all SysOp commands.
=========================================================================
October 1, 1990 Page 8
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
/===============================================\
< Predefined Menu Commands Available on All Menus >
\===============================================/
Key Description
------- ------------------------------------------------------------
<space> Reprint the current menu at the current help level.
<enter> Advance the user forward one help level (if possible) and
reprint the menu.
? 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 in 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.
FALLBACK Falls back to the programmed fallback menu. Note: This command
will not function when the fallback menu is defined as zero.
/=============\
< General Notes >
\=============/
To execute Commands with a key of more than one character, excluding
numbers and those two character commands beginning with "/" (such as
"/G"), the user must precede them with "//" at the menu prompt (e.g.
"//LOG" to execute the LOG command).
If a menu's Commands are acting funny, 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.
=========================================================================
October 1, 1990 Page 9
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
/======================\
< Command Definition Key >
\======================/
The remaining portion of this document uses the following 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.
=========================================================================
October 1, 1990 Page 10
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
/=============\
< Section Masks >
\=============/
A section mask option is available on a few selected commands. A section
mask specifies which file or message sections should be available for use
by the command in question. For example, it may limit which sections a
user may access "#" program key or limit which sections a (N)ew scan
command will check. The intended use of this option is to create
specialized menus with groups of certain sections.
When a command allows a section mask, the program data will contain:
[<Section Mask>]
[<Section Mask>]
A group of individual or range specifications separated by commas
(","). Individual specifiers are just a section number. Range
specifiers are inclusive starting and ending section numbers separated
by a dash ("-").
For example:
6. Program key : #
7. Program data : 2,10-15,5,20-25
This change section command will only allow the user to change to one
of the following sections: 2, 5, 10, 11, 12, 13, 14, 15, 20, 21, 22,
23, 24, 25.
Please note that a section mask does not effect the normal access
check. If the user normally does not have access to section 25, the
above command will not change that fact. The section mask only
specifies what sections the user may attempt to access.
=========================================================================
October 1, 1990 Page 11
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
/==========================\
< Linked Command Information >
\==========================/
A link command option is available on a few selected commands. A linked
command indicates that a second program key/program data combination
should be executed after the current one has completed. This second
program data may also contain another linked command if you can squeeze
it into the program data field, and so on.
When a command allows linked commands, its program data will contain:
[<PData1>;<PKey><PData2>]
<PData1> The program data of the normal command, if any.
";" Indicates that a link command follows.
<PKey> The program key of the link command.
<PData2> The program data of the link command.
Do NOT include any spaces between the ";", program key, or program
data.
Linked command example:
Command number: 1
1. Long desc.: (#)Change message sections - Enter the section #
2. Short desc.: (#)ChangeArea
3. Key: #
4. General SL: 10
5. AR level: @
6. Program key: #
7. Program data: ;XN
8. Flags: SL access check, GSL and AR, Normal Command
This command changes message sections using the "#" program key. After
changing sections, the linked command specified in the program data
(PKey="X", PData="N") will be executed. This will force the message
section description to be displayed each time a user changes message
sections.
=========================================================================
October 1, 1990 Page 12
T.A.G. BBS Version 2.5f 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.
/========================================================\
< "@" [<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.
=========================================================================
October 1, 1990 Page 13
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
/=========================================================\
< "#" [<Mask>][;<Pkey><Pdata>] Change sections >
\=========================================================/
Function: Change message or file sections
Pkey: "#"
PData: [<Section Mask>][;<PKey><PData>]
[<Section Mask>] Limiting set of sections to allow entry into.
[;<PKey><PData>] Linked command.
This command allows user to change boards in the current system by
entering a board number. If the menu is located in the main system, it
changes message sections; otherwise if it is located in the file system,
it changes file sections.
NOTE: This command MUST be the first command on the menu, but may be
hidden if it causes a problem.
The PData may optionally contain a section mask to limit the sections the
user is allowed to change to and/or a linked command to execute after
changing sections. See the descriptions of section masks and link
commands for more information.
/=============================================================\
< "$" Version Information >
\=============================================================/
Function: Version information
Pkey: "$"
PData: None
This command prints the current T.A.G. version and possible registration
information.
=========================================================================
October 1, 1990 Page 14
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
/===========================================================\
< "^" [C]<Menu #>[;<PKey><PData>] Goto another menu >
\===========================================================/
Function: Goto another menu
PKey: "^"
PData: [C]<Menu #>[;<PKey><PData>]
[C] Clear the menu stack before changing menus.
<Menu #> Number of the menu to send the user to.
[;<PKey><PData>] Linked command.
This command changes to the menu number indicated in the PData.
The PData may optionally contain a linked command to execute after
changing sections. See the description of linked commands for more
information.
/============================================================\
< "/" [C]<Menu #>[;<PKey><PData>] Gosub another menu >
\============================================================/
Function: Gosub another menu (remember current menu and goto another)
PKey: "/"
PData: [C]<Menu #>[;<PKey><PData>]
[C] Clear the menu stack before changing menus.
<Menu #> Number of the menu to send the user to.
[;<PKey><PData>] Linked command.
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.
The PData may also optionally contain a linked command to execute after
changing menus. See the description of link commands for more
information.
=========================================================================
October 1, 1990 Page 15
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
/==============================================================\
< "\" [C][;<Pkey><PData>] Return to saved menu >
\==============================================================/
Function: Return to previously saved menu in menu stack
PKey: "\"
PData: [C][;<Pkey><PData>]
[C] After returning, clear the menu stack.
[;<PKey><PData>] Linked command.
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.
=========================================================================
October 1, 1990 Page 16
T.A.G. BBS Version 2.5f 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 just a
definable "=" key.
=========================================================================
October 1, 1990 Page 17
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
/=============================================================\
< "|" [F]<Section #>[;<PKey><PData>] Change to a section >
\=============================================================/
Function: Change to a specific message or file section
PKey: "|"
Data: [F]<Section #>[;<PKey><PData>]
[F] Force entry into the message or file section,
ignoring access.
<Section #> The message or file section number to which to
change.
[;<PKey><PData>] Linked command.
This command changes to the message or file section specified in the
program data. An option is available to ignore access restrictions and
force the user into the specified section.
The PData may optionally contain a linked command to execute after
changing sections. See the description of linked commands for more
information.
/=========================================================\
< "[" [<Mask>[;<PKey><PData>]] Search Backward >
\=========================================================/
Function: Search backward for next accessible message or file section
PKey: "["
PData: [<Section Mask>[;<PKey><PData>]]
<BLANK> Move to next lower accessible public message or file
section.
<Section Mask> Move to next lower accessible section in the
specified limiting set of public message or file
sections.
[;<PKey><PData>] Linked command.
This command will search backward (lower numbered boards) from the
current message or file section for the next accessible section. If none
is found, the user will remain in the current section.
The PData may optionally contain a linked command to execute after
changing sections. See the description of linked commands for more
information.
=========================================================================
October 1, 1990 Page 18
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
/========================================================\
< "]" [<Mask>[;<PKey><PData>]] Search Forward >
\========================================================/
Function: Search forward for next accessible message or file section
PKey: "]"
PData: [<Section Mask>[;<PKey><PData>]]
<BLANK> Move to next higher accessible public message or
file section.
<Section Mask> Move to next higher accessible section in the
specified limiting set of public message or file
sections.
[;<PKey><PData>] Linked command.
This command will search forward (higher numbered boards) from the
current message or file section for the next accessible section. If none
is found, the user will remain in the current section.
The PData may optionally contain a linked command to execute after
changing sections. See the description of linked commands for more
information.
=========================================================================
October 1, 1990 Page 19
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
/==============================================================\
< "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.
"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 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.
=========================================================================
October 1, 1990 Page 20
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
"U" @ User log editor (*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 CoSysOps or Remotes 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.
Note:
COMMAND.COM must exist in the Main BBS Directory or the DOS path for
this command to function.
=========================================================================
October 1, 1990 Page 21
T.A.G. BBS Version 2.5f 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 "[>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 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).
Note:
COMMAND.COM must exist in the Main BBS Directory or the DOS path for
this command to function.
=========================================================================
October 1, 1990 Page 22
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
/====================================================\
< "_" [@][*]<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.
Note: COMMAND.COM must exist in the Main BBS Directory of the DOS path
for this command to function.
=========================================================================
October 1, 1990 Page 23
T.A.G. BBS Version 2.5f 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.
Note:
COMMAND.COM must exist in the Main BBS Directory for this command to
function.
=========================================================================
October 1, 1990 Page 24
T.A.G. BBS Version 2.5f 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.
COMMAND.COM must exist in the Main BBS Directory for this command to
function.
=========================================================================
October 1, 1990 Page 25
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
/========================\
< Main System Program Keys >
\========================/
/=============================================\
< "A" [<Mask>] List message areas >
\=============================================/
Function: List message areas
PKey: "A"
PData: [<Section Mask>]
[<Section Mask>] Limiting set of sections to list.
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 an optional
section mask. See the descriptions of section masks for more information.
/==========================================\
< "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.
=========================================================================
October 1, 1990 Page 26
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
/=====================================================\
< "D" <1..13, 15..23> User information functions >
\=====================================================/
Function: User information functions
PKey: "D"
PData: <1..13, 15..23>
"1" List the users information that can be changed.
"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.
"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.
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.
=========================================================================
October 1, 1990 Page 27
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
/============================================\
< "E" [M] Send private mail >
\============================================/
Function: Send private mail to one or more users
PKey: "E"
PData: [M]
<BLANK> Send private mail to one user.
"M" Send mass private mail to as many as 20 users.
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 to send
mail to anyone below CoSysOp access level.
/===================================\
< "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 specifies the SysOp user number) or "Send a message to the Dungeon
Master" (where the PData specifies the 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.
=========================================================================
October 1, 1990 Page 28
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
/========================================================\
< "K" Read/delete sent private mail >
\========================================================/
Function: Read/delete sent private mail
PKey: "K"
PData: None
This command allows a user to read and optionally delete private messages
they have sent to other users. Messages are displayed from oldest to
newest by date along with how many days old each message is.
/==============================================\
< "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" Read waiting private mail >
\====================================================/
Function: Read waiting private mail
PKey: "M"
PData: None
This command checks to see if the current user has any private mail
waiting in their mail box. If so, a short summary of the message(s) is
displayed, and the user is given the option of whether to proceed and
read them from the beginning, start at a specific message number, or
quit.
=========================================================================
October 1, 1990 Page 29
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
/====================================================\
< "N" [G | <Mask>] New scan message sections >
\====================================================/
Function: New scan message sections
PKey: "N"
PData: [G | <Section Mask>]
<BLANK> Scan the current public message section for new
messages.
"G" Scan all accessible public message sections for new
messages.
<Section Mask> Scan the specified limiting set of 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" Post a public message >
\================================================/
Function: Post a public message
PKey: "P"
PData: None
The command allows the user to post a public message on the current
public message section if they have posting access to it. Posting access
is defined in the message base configuration. Anonymous posting access is
also defined in the message base configuration with overrides defined in
the system configuration.
=========================================================================
October 1, 1990 Page 30
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
/==================================================\
< "R" Remove a public message >
\==================================================/
Function: Remove a public message
PKey: "R"
PData: None
This command allows a normal user to remove any message they have posted
on the current message section. Users with SubOp access to the current
board or CoSysOp access and above may remove any message.
/===============================================\
< "S" Scan public messages >
\===============================================/
Function: Scan public messages in current section
PKey: "S"
PData: None
This command scans the subjects of the next 10 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
10 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.
=========================================================================
October 1, 1990 Page 31
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
/========================================\
< "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.
/================================================\
< "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.
=========================================================================
October 1, 1990 Page 32
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
/===============================================================\
< "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 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 an error message is display when T.A.G. encounters a
missing section description file is determined by the PData.
For example: Section #1 has the file name of "GENERAL". GENERAL.MSG
should appear in the Alternate Text File Directory with a
description of the general message section.
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.
=========================================================================
October 1, 1990 Page 33
T.A.G. BBS Version 2.5f 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.
=========================================================================
October 1, 1990 Page 34
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
/==========================================\
< "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.
/===============================================\
< "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.
=========================================================================
October 1, 1990 Page 35
T.A.G. BBS Version 2.5f 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 withdrawl are specified in the system configuration.
=========================================================================
October 1, 1990 Page 36
T.A.G. BBS Version 2.5f 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.
=========================================================================
October 1, 1990 Page 37
T.A.G. BBS Version 2.5f 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.
=========================================================================
October 1, 1990 Page 38
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
/========================\
< File System Program Keys >
\========================/
/==========================================\
< "A" [<Mask>] List File Areas >
\==========================================/
Function: List file areas
PKey: "A"
PData: [<Section Mask>]
[<Section Mask>] Limiting set of sections to list.
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.
=========================================================================
October 1, 1990 Page 39
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
/==========================================\
< "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.
/==========================================\
< "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.
=========================================================================
October 1, 1990 Page 40
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
/====================================\
< "F" [<Mask>] Find text >
\====================================/
Function: Find text in file name or file descriptions
PKey: "F"
PData: [<Section Mask>]
[<Section Mask>] Limiting set of sections to search.
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.
/===============================================\
< "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.
=========================================================================
October 1, 1990 Page 41
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
/===========================================\
< "H" [N] Describe section >
\===========================================/
Function: Describe current file section
PKey: "H"
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.
/========================================\
< "I" [G | @ | <Mask>] View interior >
\========================================/
Function: View the files inside an *.ZIP, *.ARC, or *.PAK archive file
PKey: "I"
PData: [G | @ | <Section mask>]
<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, ".ZIP" is assumed.
=========================================================================
October 1, 1990 Page 42
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
/=======================================\
< "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.
/=====================================\
< "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.
=========================================================================
October 1, 1990 Page 43
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
/============================================\
< "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 | <Mask>] New scan >
\===================================/
Function: Scan file sections for new files
PKey: "N"
PData: [G | C | <Section Mask>]
<BLANK> Ask user whether to search all sections or just
current.
"G" Search all sections.
"C" Search current section.
[Section Mask] Limiting set of sections to search. Ask user whether to
search the subset of sections or just the current.
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.
/============================================\
< "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.
=========================================================================
October 1, 1990 Page 44
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
/==============================================\
< "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.
/=======================================\
< "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.
=========================================================================
October 1, 1990 Page 45
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
/=========================================\
< "S" [Mask] Scan for files >
\=========================================/
Function: Scan file sections for files matching a file mask
PKey: "S"
PData: [Section Mask]
[Section Mask] Limiting set of sections to search.
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.
/========================================\
< "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.
=========================================================================
October 1, 1990 Page 46
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
/=========================================\
< "V" @ [G | <Mask>] Validate files >
\=========================================/
Function: Validate files
PKey: "V" @
PData: [G | <Section Mask>]
<BLANK> Validate files in the current section.
"G" Validate files in all sections.
<Section Mask> Limiting set of sections in which to validate files.
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.
=========================================================================
October 1, 1990 Page 47
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
/=========================================\
< "X" <Filename> File door call >
\=========================================/
Function: Execute a file door call
PKey: "X"
PData: <Filename>
<Filename> Name of the program to execute
This command is designed to allow much easier implementation of file
related door operations. The specified filename is executed with the
following parameters:
Baud rate of user (e.g. 300, 1200, 2400, 9600)
Communications post (1 or 2)
ID number of current user (user number)
Download pathname of the current file section
Download filename of the *.DIR file of the current section
Upload pathname of the current file section
Upload filename of the *.DIR file of the current section
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".
/=======================================================\
< "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.
=========================================================================
October 1, 1990 Page 48
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
/=============================================\
< "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.
/=====================================\
< "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.
=========================================================================
October 1, 1990 Page 49
T.A.G. BBS Version 2.5f Menu Documentation
=========================================================================
/=====================================\
< "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
/==================================================\
< "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.
=========================================================================
October 1, 1990 Page 50