ProfitPress Mega CDROM2 Shareware Freeware (MSDOS)(1992)(Eng)

home *** CD-ROM | disk | FTP | other *** search

/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / BBS / TAGBBS / TAGD25G.ZIP / MENU25G.DOC < prev next >

Wrap

Text File | 1990-10-01 | 126.3 KB | 3,298 lines

/======================================\ < 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