home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 2 BBS
/
02-BBS.zip
/
orion41x.zip
/
OrionCBCS.Doc
next >
Wrap
Text File
|
1998-10-10
|
330KB
|
8,448 lines
Note 1> EveryWhere you see AdeptXbbs in this doc, it also applies
To Orion CBCS/2, except for the copyright info of course,
Orion CBCS/2 is Copyright (c) 1998 Mario D'Ulisse.
----------------------------------------------------------------------
AdeptXBBS
Bulletin Board for IBM 32-bit OS/2
Version v1.0x
Copyright (c) 1993 - 1996 by AdeptSoft
portions Copyright (c) 1991-1994 M. Kimes
All Rights Reserved
AdeptSoft, AdeptXBBS, GateKeeper,
are trademarks of AdeptSoft.
"XBBS" Copyright (c) 1988 - 1994 by M. Kimes. The "XBBS" name is a
Trademark of M. Kimes.
----------------------------------------------------------------------
What's new in this documentation
4/20/97
Updated to reflect the 1.09.11 Hagar build.
4/5/97
Modified documentation to align with Adept 1.09.xx (Hagar) builds
2/26/97
Added information on menutypes 52,53,55.
Added information about external message editors
Added information about importing a local text file
Added information about MsgToUserOn.cmd
Added information about new meta commands DA, DB, DC, DE, DD
Added information new chat server, CSERVER.EXE & deleted CHATSERVER.EXE
Added information on Dorinfo1.def drop file support
Added references to Other Related Documentation
Updated the section in Upgrading Adept.
Updated the section on Noteworthy Info.
Updated contact information
Added information on Bug Reporting.
Added snoval.com to ftp sites.
Added information about Integrated Menu Editor.
4/3/96
Changed Registering AdeptXBBS section.
3/30/96
Added information to the .menu example on page 28.
Added information to menutypes 10,11,15,16,17,20,28.
Added information to the setting up of DOOR games over the
internet.
Added /R documentation to the UNUKE section.
Reworked the NNTP setup and Internet Email setup information.
Added Hagar's Quirks.txt as an appendix
TABLE OF CONTENTS
NOTEWORTHY INFO..................................................1
INTRODUCTION.....................................................2
WHAT IS ADEPTXBBS?............................................. 2
FEATURES OF ADEPTXBBS:......................................... 2
LIMITATIONS:................................................... 3
SYSTEM REQUIREMENTS:........................................... 3
MULTI I/O. BOARDS:............................................. 3
COPYRIGHT INFORMATION:......................................... 4
DISCLAIMER:.................................................... 4
3RD PARTY DEVELOPERS:.......................................... 4
ACKNOWLEDGMENTS:............................................... 4
FEATURE REQUESTS:.............................................. 5
REPORTING BUGS................................................. 5
OTHER RELATED DOCUMENTATION.................................... 6
INSTALLING ADEPTXBBS............................................ 9
SETTING THE LOCAL LOOPBACK..................................... 9
UPGRADING FROM PREVIOUS VERSIONS............................... 10
COMMAND LINE OPTIONS:.......................................... 11
CONVERTING FROM OTHER BBS PROGRAMS:............................ 11
BBS CONFIGURATION............................................... 12
GENERAL SETTINGS:.............................................. 12
DIAL STRINGS:.................................................. 14
CPU PRIORITIES:................................................ 15
DIRECTORIES USED BY ADEPT:..................................... 16
TEXT FILES USED BY ADEPT:...................................... 17
THE TRASHCAN FILE:............................................. 20
THE PHONECAN FILE:............................................. 21
THE QUOTES FILE:............................................... 21
SETTING UP NEWS FILES:......................................... 22
RIP GRAPHICS:.................................................. 22
SETTING UP INTERNODE CHAT WITH THE CSERVER:.................... 22
TESTING YOUR ADEPTXBBS SETUP USING NAMED PIPES:................ 22
ADEPTXBBS MENU INTERFACE........................................ 24
CREATING .MENUS:............................................... 25
MENU TYPES:.................................................... 31
ADEPTXBBS MULTI LANGUAGE SUPPORT:.............................. 70
LANGUAGE.TEXT CONFIGURATION:................................. 71
ADEPT USER HELP TOPICS:........................................ 73
ADEPTXBBS META VARIABLES........................................ 76
EVENT FILE CONFIGURATION........................................ 81
QUESTIONS AND ANSWERS ABOUT THE EVENTS FILE:................... 83
UNUKE - ADEPTXBBS USER BASE UTILITY............................. 85
COMMAND LINE PARAMETERS:....................................... 85
ENVIRONMENT VARIABLES:......................................... 85
FREQUENTLY ASKED QUESTIONS CONCERNING UNUKE:................... 86
INTERNET CAPABILITIES........................................... 87
WHAT IS TELNET?................................................ 87
WHAT IS FTP?................................................... 87
WHAT IS USENET AND NEWSGROUPS?................................. 87
WHAT IS IRC?................................................... 88
HOW TO SETUP NODE(S) FOR TELNET & SOCKETS:..................... 88
HOW TO SETUP NNTP SUPPORT:..................................... 89
TO SETUP E-MAIL (SMTP) SUPPORT:................................ 92
HOW TO INSTALL IRC2 (INTERNET RELAY CHAT) SUPPORT:............. 95
USE VMODEM WITH ADEPT AND THE INTERNET MODULE:................. 95
FILE AREA CONFIGURATION..........................................96
FILE AREA EDITOR:.............................................. 96
FILE AREA SECURITY:............................................ 97
FILE_AREAS FILE CONFIGURATION:................................. 98
ADDING FILES TO YOUR NEW ADEPT BBS:............................ 100
BFSMAKE:....................................................... 102
USING CD-ROMS & MULTI-CHANGER CD-ROMS WITH ADEPT:.............. 104
FLIST - AN "ALL-FILES" LIST CREATOR FOR ADEPT:................. 104
REINDEXFILE - ADEPT FILE SYSTEM REINDEXING PROGRAM:............ 105
MESSAGE AREA CONFIGURATION...................................... 107
MESSAGE AREA EDITOR:........................................... 107
MESSAGE AREA SECURITY:......................................... 107
MESSAGE_AREAS FILE CONFIGURATION:.............................. 108
XMSG - ADEPTXBBS MESSAGE BASE UTILITY/PACKER:.................. 110
ENABLEING EXTERNAL MESSAGE EDITOR SUPPORT...................... 112
REMOTE SYSOP IMPORTING OF LOCAL TEXT FILES..................... 112
Reply to a different Message Area.............................. 112
MAILER CONFIGURATION............................................ 113
LINE SPECIFIC MAILER SETTINGS:................................. 113
ADDRESS SETTINGS:.............................................. 114
NODELIST INFORMATION:.......................................... 115
XSENDPM - FIDO FILE SENDING UTILITY:........................... 115
FAX CONNECTS:.................................................. 115
SETTING UP DOORS UNDER ADEPTXBBS................................ 115
SAMPLE BATCH FILES FOR SINGLE NODE SYSTEMS:.................... 119
FILE TRANSFER PROTOCOL (FTP):.................................. 121
APPENDIX....................................................... 122
EXAMPLE .MENU FILES:........................................... 122
ADEPTXBBS USER BASE STRUCTURE:................................. 130
ADEPTXBBS MESSAGE BASE STRUCTURES:............................. 133
BITMAPS FOR THE FFLAGS:...................................... 134
BITMAPS FOR THE XFLAGS:...................................... 135
STRUCTURE FOR THE ADEPTXBBS MESSAGE BASE .INDEX FILE:.......... 135
STRUCTURE FOR THE ADEPTXBBS FILE SYSTEM - FILE.DATA FILE:...... 135
Adept "Qirks" - Hints and Tips:................................ 137
1
For the latest versions:
FTP Site : ftp://hobbes.nmsu.edu
_____________________
_ _ NOTEWORTHY INFO _
_____________________
Wide Beta version 0.90 was released Jan. 17, 1995.
Version 0.94 on March 15, 1995.
Version 0.96 on May 7, 1995.
Version 0.97 on May 29, 1995.
Version 0.98 on August 5th, 1995.
Version 1.00 on August 7th, 1995.
Version 1.01 on August 8th, 1995.
Version 1.04 on September, 2nd, 1995.
Version 1.05 on October, 7th, 1995.
Version 1.06 on December, 22, 1995.
Version 1.07 on February 28, 1996.
Version 1.08 on February 26, 1997.
Version 1.09 on March 31, 1997.
Version 4.1x of Orion CBCS/2 on Oct 10, 1998.
2
__________________
_ _ INTRODUCTION _
__________________
AdeptXBBS is an OS/2 bulletin board program written in 'C'. AdeptXBBS
fully exploits all the features that make OS/2 the operating system of the
future and today. AdeptXBBS is extremely well threaded in order to give
you that 'instant' response you expect from OS/2.
What Is AdeptXBBS?
AdeptXBBS is a 32-bit, Multi-thread, Multi-user, PM BBS for 32-bit OS/2.
AdeptXBBS incorporates the best that is OS/2! AdeptXBBS is designed to
give you speed, reliability, power and flexibility in one package.
Almost everything about AdeptXBBS can be customized. All the text
displayed in the PM system, to every prompt and menu. AdeptXBBS gives
you robust support for DOS and OS/2 doors using DOOR.SYS, Dorinfo1.def
and Session Info (ask us about Session Info) drop file.
Features Of AdeptXBBS:
The AdeptXBBS file system has support for...
o Multi-CD rom changers
o FILE_ID.DIZ
o File Tagging
o Virus Checking
o Archive Conversion
o Archive Viewing/Extraction
o Files.BBS importing
o Password protected files and file areas
o Age limited files, and file areas
o Extensive file security and area security
o Xmodem, Ymodem, Ymodem-G, Sealink, Zmodem and ZedZap protocols
o User configurable file lists
o Mark files as offline (single CD-ROM, multiple CD-ROM support
o Mark files as hidden by downloadable
The AdeptXBBS message base system has support for...
o Password Protection
o Extensive security features
o Context sensitive searches
o Message tagging
o .QWK, Bluewave, FidoNet Point and Text exporting
o Last Read Pointer Manipulation
o Unlimited Message Areas, Message Per Area and Message Size.
(The current file system (FAT, and HPFS) will break before the
BBS does)
o Full Screen and Text Message Editors
o Full Reply Linking/Threading
o On the fly compression of messages.
o Message encryption
3
The AdeptXBBS mailer has support for...
o Read/Write of PATH, SPTH, INTL, TOPT, FMPT, SEEN-BY, MSGID and MSGTO
Kludges
o Reading/Processing of ASSOC, EID and VIA (Stripping)
o FTS-001 through FTS-009 FidoNet standards
o Around 20 additional FSC proposals
o File Attaches, File Requests
o WAZOO, EMSI and DietIFNA mail sessions
o Complete events handling, with external program support
o FidoNet v7 Nodelist support
o Auto Execution of a fax program for FAX connects
o AREAFIX with auto add and auto forward capabilities
o TIC processing with forwarding
o Completely and seamlessly integrated into the BBS software
The AdeptXBBS BBS has support for...
o DOS and OS/2 Doors, using the DOOR.SYS, Dorinfo1.def and Session Info
drop files
o The ability to run redirected OS/2 programs
o Completely custom menu system
o Completely custom prompts system
o Multi-Lingual support
o TTY, ANSI, AVATAR, ANSI-TE2 graphics, auto ANSI and ANSI-TE2 detection
o Multi-node, multi-user chat
o Internet Telnet Support
o Named Pipe Support
o Internal REXX program processing and execution
Limitations:
DOS doors/games do not work over the Internet, most OS/2 doors/games
should work over Telnet. (The DOS limitation does not exist if you are
using SIO's VMODEM).
System Requirements:
AdeptXBBS requires OS/2 v2.0, v2.1, v2.11, v2.99 or OS/2 Warp in order to
run. OS/2 v3 w/IAK or IBM TCP/IP required for Internet capabilities.
AdeptXBBS requires 2 Megabytes of FREE ram and at least 5 megs of free
disk space. A MODEM is optional.
IMPORTANT-- AdeptXBBS requires a HPFS partition!
Multi I/O. Boards:
AdeptXBBS has been tested with the following boards.
DigiBoard - Nonintelligent series works with Ray Gwinn's SIO drivers.
The intelligent series works well with the BBS, but does not
have DOS support.
Equinox - No DOS support with SIO, but handles more nodes better than
the G-TEK boards.
4
G-TEK - Has DOS support with SIO. Currently being used on the
support BBS.
Copyright Information:
AdeptXBBS and it's support programs are not to be modified or
distributed in modified form without the express written permission of
AdeptSoft.
AdeptSoft, AdeptXBBS, GateKeeper and are trademarks of AdeptSoft.
"XBBS" Copyright (c) 1988 - 1994 by M. Kimes. The "XBBS" name is a
Trademark of M. Kimes
AdeptSoft holds an exclusive license to develop and distribute shareware
and commercial versions of the XBBS-OS/2 BBS program by M. Kimes.
All support programs Copyright 1993-96 AdeptSoft, except where otherwise
noted. All other trademarks and copyrights belong to their respective
owners.
Disclaimer:
There is no warranty, period. Even if there was we are NOT responsible
for its actions. If the mailer dials Iraq and sits on the line for 12
hours AT&T will be very happy with you. If the BBS hiccups and all of a
sudden you have 3 gigs of free disk space when you originally had 5 megs
free, consider yourself lucky for having a large hard drive. i.e. We
cannot take responsibility for what this program does. We have tried in
well over a year of beta testing to remove as many of the bugs as
possible and it has not to our knowledge done either of the above
things, but who knows.
3rd Party Developers:
If you are looking to develop a door game for OS/2 BBS's please contact
us. Of if you are looking at writing a AdeptXBBS specific module.
We include in this archive v0.99 of our File System .DLL's with basic
documentation, including examples of how to make use of the AdeptXBBS
File System. ALL the functions in the fSys DLL's are also duplicated in
the latest revision of the REXX engine.
Acknowledgments:
All the people acknowledge below in some way or another contributed to
this program. I tried to remember everyone I could and I am sure I
missed a few. If you feel your name should be here please contact us
and we will add it. Thanks to everyone who have helped me out over the
5
last year a half, helped beta test this program and contributed ideas
and suggestions. And thanks to those who remained the programs biggest
critics, yet at the same time it's greatest supporters. Special thanks
to Mark Kimes.
Stefan Andersson Scott Baldwin Kimberly Bobrow Vince Coen
Vicci Conway Mario Dulisse Brady Flowers Chris Griffin
Mike Hammers Rich Hawley Jason Klank Koen Koster
Joe Lemere Scott Livingston Paul Lockley Andrew Lozier
Pam Lunsford Eddy Matthews Barry Mcmenomy Julie Niesen
Eric Miller Fred Miller Steve Mohacey David Moskowitz
Pete Norloff Jim Mullins Jason Perlow Dan Polivy
David Prentice Ronen Raz Graham Reid Kevin Royalty
Bill Schaeffer Jason Schuster Horace Skinner Joey Snell
Brian Snyder Brent Pranger Mark Wheeler Scott Wilkos
CONTACTING AdeptSoft:
--------------------
Now that Adept is freeware, you can obtain real-time Help by joining
the Internet Relay Chat channel #adept
You can also FTP to hobbes.nmsu.edu.com to get specific files and
information. Log in with the name anonymous.
Feature requests:
----------------
At the moment we have locked down the current feature set. If a
suggestion comes along that we feel really should be in a future
version, we will do our best to add it. If the feature you want is not
in the current version, please fill out the wish form included with this
Bug Reports:
-----------
Send all bug reports to:
E-mail: mario.dulisse@sympatico.ca with the subject of <orionbugs>.
Internet Relay Chat (IRC) Support:
---------------------------------
You can find many Adept Sysops ready to help live on IRC. Use your favorite
IRC client to log on to irc.isonline.com:6667 and join room #adept.
6
OTHER RELATED DOCUMENTATION
Depending on how much you plan on customizing AdeptXBBS, you may find
the following documentation files useful. They are included in the
Full distribution archive and at the FTP site snoval.com.
ADPREXX.DOC -- Explainations and examples of Adept specific REXX
Functions.
adeptrexxchatfuncs.doc -- AdeptREXX Chat specific functions.
adeptrexxcomfuncs.doc -- AdeptREXX Communications specific functions.
adeptrexxfsysfuncs.doc -- AdeptREXX File System specific functions.
adeptrexxmiscfuncs.doc -- AdeptREXX Miscellaneous REXX stuff.
Pages 7, and 8 were eliminated with the release of the freeware
version of AdeptXBBS.
9 _______________________
_ _ INSTALLING AdeptXBBS _
__________________________
First Time Install:
There is no installation program, what u have to do is create an
\Adept dir on an *HPFS* formatted drive. There is no other choice, it
must be hpfs formatted or adept will not run.
Once you have created the \adept dir, simply place the ad109FXX.zip file
in that dir and using infozips "unzip.exe" unzip the archive. The unzip
will create the proper subdirs, and place the adept files in those subdirs.
To set up your new 2 node BBS cd to the \adept dir and
type: Adept /Nodes 2 /Setup
This will start adeptxbbs as a two node bbs and will put it in setup
mode so you can configure your nodes for proper com ports, bbs options
etc. Once configured choose Shutdown from the Adept menu, do *NOT* close
Adept by double clicking on the left hand corner shutdown button, if
you do, all your hard work configuring it will be lost. You must use the
shutdown option to save your configuration.
Once you've done that (again cd to the \adept dir if you left it for some
reason) and type Adept /Nodes 2 to bring up your 2 node Adeptxbbs. Adept
should come on line intialize your modems and the status box should say
waiting for call.
Congratulations you now have a fully functional 2 line bbs.
One of the first things that you want to do is create YOUR user record.
To do this, YOU MUST LOG ON LOCALLY. Once you've completed the New User
Logon, you can hang up, and Edit your User Record by selecting
EDIT --> USERS from the pulldown menus
Setting the Local Loopback:
--------------------------
Adept REQUIRES the local loopback to be set in order for the Multiline
Chat to work.
This Also means that you must have either Network support or the
Internet Access Kit (IAK) installed.
To set the loopback, add the following line to either your Tcpstart.cmd
or your Startup.cmd file:
ifconfig lo 127.0.0.1
Then reboot your computer.
If you don't have the required Network or IAK support installed or if you
can't/dont want to set the loopback, Adept will work without Multiline
Chat if you use the /NOCHAT command line switch when starting Adept.
Adept /Nodes 4 /NOCHAT
10
Upgrading From Previous Versions:
--------------------------------
It is always best to backup your existing BBS software BEFORE you
install a new version.
1.07->1.08.xx: Simply upgrade like normal. If you run ChatServer.Exe
delete it and replace it with the new CServer.Exe.
1.08XX->1.09.xx: You will have to convert your menus from the old 1.07
style to the new 1.09 style. To help you do this I have included
Menucvt.Cmd menu converter. Put the menucvt.cmd in yur \adept\menus dir
and run it *ONCE*!!! It will convert your old style menus to the new
format.
Old Style:
W,42,Who's On Line,,0
New Style:
BEGINMENUITEM
KEY W
MENUCOMMAND 42
DISPLAYCOLOR 0
MINSEC1 50
ENDMENUITEM
After verifing your menus have been converted correctly, simply follow the
following instructions.
To upgrade to a new version of Adept, copy the archive file to your
Adept directory and unzip it.
11
Command Line Options:
All command line options should be proceeded by a '/' or '-', you can
mix and match the two.
/DONTSTARTCHAT - Don't start up the chat server.
/DONTSLAM - Start up nodes in a slow manner to keep the CPU from
being hit hard.
/EXCEPT - Turn on ADEPT's exception handling
/FTP - Turn on ADEPT's FTPD support
/HELP or /? - Will display a help dialog with commands and our
/H or /h contact information.
/NODES ## - This specifies the number of nodes to bring on-line.
/NOINIT ## - This specifies a node number not to initialize on
startup. This can be repeated as many times as you
want in the command line. This option is great for if
you want to bring all the nodes on-line, but are using
one of the com ports, so you can specifically tell the
BBS/Mailer NOT to try to access that port until you
want it to.
/NOEXCEPT - Run Adept without exception handling.
/NOHELP - Turns off the loading of the PM help subsystem.
/NNTP - Turn on NNTP (newsgroups) support
/NOSTAT - Start Adept without the status window.
/NOSYSLOG - Turns off System Logging
/REXXCHAT - Default. Turns on the new REXX Chat functions
/SETUP - Will bring the software up in Setup mode. It will
not try to access any com ports. This is like using
/NOINIT for all nodes.
/SHOWEMSI - Will enables a verbose logging of EMSI handshaking for
debugging purposes only.
/SLOW - Adds a pause to startup
/SYSLOG - Default. Turns on System Logging
/VERSION - Will display the current version information.
/VERBOSE - Turns on Detailed System logging
CONVERTING From Other BBS Programs:
There are conversion programs included with this BBS software.
\Adept\Convert\Mxtoadp.zip - Maximus User Conversion Utility
\Adept\Convert\Ratoadp.zip - Remote Access User Conversion Utility
\Adept\Convert\Wc2adpt.zip - WildCatPro User Conversion Utility
12
_______________________
_ _ BBS CONFIGURATION _
_______________________
Configuring ADEPT Via Pull-down Menus:
General Settings:
Accessed from Config->Active Line->General Settings...
+--------------------------------------------------------------------+
: Line # General Settings :
+--------------------------------------------------------------------+
: :
: +-- Basic Modem Strings ------------------+ +------------------+ :
: : : : Logon Security : :
: : Answer : ATA| : +------------------+ :
: : Init : v~^ATM0| : :
: : Dial Pref : v~^ATDT : x Use Telnet Timers :
: : Dial Suf. : | : x No Carrier Detection:
: : : x Use Socket Port :
: +-----------------------------------------+ x Use Telnet Port :
: x ATO on DATA :
: +-----------------------------------------+ :
: : Port Name : COM1 Ring Response : RING : :
: : Answer on Ring : 1 : :
: +-----------------------------------------+ :
: :
: +-- BPS Rates ------------------------------+ :
: : : :
: : Initial BPS : 19200 Mn. BPS : 1200 : +--------------+ :
: : Mn. Mail BPS : 1200 Mn. Call BPS : 2400 : | Fax Setup | :
: : Mx. Call BPS : 19200 x Locked : +--------------+ :
: : : :
: +-------------------------------------------+ :
: :
: +----+ +------+ +----+ :
: : OK : :Cancel: :Help: :
: +----+ +------+ +----+ :
+--------------------------------------------------------------------+
'v' - Drops DTR '^' - Raises DTR
'~' - 1 Second Delay '`' - 1/10th of a Second
'|' - Carriage Return '\\' - Escape Character
Com Port:
This can be a Com port or a named pipe. AdeptXBBS will work
with any valid communications serial port and or named pipe.
Answer on Ring:
This is the number of rings to answer the modem on. You can
choose any number. If there is a 10-15 second delay between
rings AdeptXBBS will reset the counter.
Ring Response:
13
This is the 'RING' statement to look for from the modem.
For example if you have distinctive ring you can have the
BBS look for 'RING1' instead of 'RING'
Use Telnet Timers:
This option tells the Mailer/BBS to use a completely different
set of timing sequences for Telnet and VMODEM sessions.
No Carrier Detection:
This option is used if you are configuring this node to be
an internet node for your BBS. If people will be telneting
into it instead of dialing into it, use this option.
Use Socket Port:
This option should be used if you are using this node as an
internet node for people to telnet into. If you are using
VMODEM for this node, do not check this box.
Use Telnet Port:
This option should be used if you are using this node as an
internet node for people to telnet into. If you are using
VMODEM for this node, do not check this box.
ATO on Data:
This option is recommended if you are using AdeptXBBS to
send/receive faxes with a modem other than a CLASS 2 fax
modem.
Logon Security:
This will bring up a dialog of security settings a user must
meet in order to be allowed on this node.
Answer:
This is the string to send to the modem to make it answer
the phone when a call comes in.
Init:
This is the string transmitted to the modem to initialize
it. AdeptXBBS will not work properly if the modem is set to
Auto Answer.
Dial Pref:
Dialing prefix, this is the string to send to the modem to
dial a number.
Dial Suf:
Dialing suffix, this is the string to send to the modem to
finish a dialing sequence.
Initial BPS:
This is the initial baud rate to initialize the modem at.
Locked: Check this box to lock the port at the initial BPS.
14
Mn BPS: Minimum BPS to allow users to connect at.
Mn Mail BPS: Minimum BPS to allow mail sessions.
Mn Call BPS: Minimum BPS to initiate a mail session.
Mx Call BPS: Maximum BPS to initiate a mail session.
Fax Setup: Fax Modem setup screen
Fax Setup:
Accessed from Config->Active Line->General Settings->Fax Setup
+-----------------------------------------------+
: Fax Modem Settings for Line x :
+-----------------------------------------------+
: :
: +-- Basic Modem Strings ------------------+ :
: : : :
: : Answer : ATA| : :
: : Init : v~^ATM0| : :
: : Dial Pref : v~^ATDT : :
: : Dial Suf. : | : :
: : : :
: +-----------------------------------------+ :
: :
: +-----------------------------------------+ :
: : Class 2 Modems (Supra, PPI, Zoom) : :
: +-----------------------------------------+ :
: +-----------------------------------------+ :
: : Class 2.0 Modems (USR v.Everything) : :
: +-----------------------------------------+ :
: +-----------------------------------------+ :
: : Class 1 Modems (Hayes Optima) : :
: +-----------------------------------------+ :
: +-----------------------------------------+ :
: : Zyzel Modems : :
: +-----------------------------------------+ :
: +--------------------+ :
: : Return to Defaults : :
: +--------------------+ :
: :
: _ ATO on DATA +----+ +------+ +----+ :
: : OK : :Cancel: :Help: :
: +----+ +------+ +----+ :
+-----------------------------------------------+
Dial Strings:
Accessed from Config->Active Line->Dial Strings...
15
+--------------------------------------------------------------------+
: Line # Dial Strings :
+--------------------------------------------------------------------+
: Dial Pre1: Dial Pre5: :
: Dial Suf1: Dial Suf5: :
: :
: Dial Pre2: Dial Pre6: :
: Dial Suf2: Dial Suf6: :
: :
: Dial Pre3: Dial Pre7: :
: Dial Suf3: Dial Suf7: :
: :
: Dial Pre4: Dial Pre8: :
: Dial Suf4: Dial Suf8: :
: :
: +------+ +--------+ +------+ :
: : OK : : Cancel : : Help : :
: +------+ +--------+ +------+ :
+--------------------------------------------------------------------+
CPU Priorities:
Accessed from Config->Active Line->CPU Priorities...
+--------------------------------------------------------------------+
: CPU Priorities :
+--------------------------------------------------------------------+
: +-- BBS Priorities ----------------------------------------------+ :
: : : :
: : Main: <----X-----------> 2 Local: <----X-----------> 2: :
: : <X---------------> 1 <X---------------> 1: :
: : : :
: +----------------------------------------------------------------+ :
: : +-- Line # CPU Priorities -------------------------------------+ :
: : : :
: : Mailer: <----X-----------> 2 Send: <------------X---> 3: :
: : <X---------------> 0 <X---------------> 0: :
: : : :
: : BBS: <----X-----------> 2 Export: <----X-----------> 2: :
: : <X---------------> 0 <X---------------> 0: :
: : : :
: : Outside: <----X-----------> 2 Recv: <------------X---> 3: :
: : <X---------------> 0 <X---------------> 0: :
: : : :
: +----------------------------------------------------------------+ :
: :
: +------+ +--------+ +------+ :
: : OK : : Cancel : : Help : :
: +------+ +--------+ +------+ :
+--------------------------------------------------------------------+
Accessed from pressing right mouse button on user window.
16
+--+-----------------------------------------------------------------+
: : BBS: Local :
+--+-----------------------------------------------------------------+
: User Name User Town Time Remaining Loc :
: :
: :
: :
: +--------------------------+ :
: : Edit User : :
: : Chat : :
: : ---------------------- : :
: : Time -> : :
: : ---------------------- : :
: : Hang Up : :
: : Lockout : :
: : Moron : :
: : ---------------------- : :
: : Change Font : :
: : ---------------------- : :
: : Paste to KB Buffer : :
: : Paste to Output : :
: : ---------------------- : :
: : Redraw Screen : :
: Mouse Pointer -> x+--------------------------+ :
: :
: Click with right mouse button on local screen. :
: :
: :
: :
+--------------------------------------------------------------------+
Directories Used By Adept:
The following directory entries are defaults and some can be changed:
.\ (default) -- Where configuration files are kept.
.\Logfiles -- Where logfiles are kept.
.\Events -- Where Adept keeps its event files.
.\Files -- Where Adept keeps its B-Tree style file
system.
.\Help -- Where Adept keeps its help files.
.\Convert -- Where Other BBS -to- Adept converters are
kept.
.\Samples -- Sample menus and rexx files.
.\Mailer -- Where Adept keeps all its mailer related
files.
.\Mailer\Aborted_Files -- Where aborted mail files are kept.
.\Mailer\NodeList -- Where the node list is kept.
.\Mailer\Outbound_Mail -- Where outbound mail is kept.
.\Mailer\Packets -- Where packets are kept (unused at this
point).
.\Mailer\Password_Inbound_Mail (see Mailer section).
.\Mailer\Public_Inbound_Mail (see Mailer section).
.\Mailer\Unlisted_Inbound_Mail (see Mailer section).
.\Mailer\Flags -- Where flag files are kept.
.\Mailer\Hold -- Where GateKeeper places outbound .TIC files.
.\Mailer\Scripts -- Not Yet Used -
17
.\Menus -- Where menus and REXX scripts are kept.
(Main.Menu, Main?.Menu menus, Main.Cmd
Main?.Cmd, AtEnd.Cmd, AtEnd?.Cmd REXX
scripts).
.\Message_Bases -- Where all message bases are kept.
.\Personal_Mail -- This is where AdeptXBBS stores it's PMI
message Indexes.
.\System -- Where system related files are kept.
(Message_Areas, File_Areas, Library_Areas,
Addresses, Archivers, Computers,
Language.Text, Groups).
.\System\Line? -- Where temporary data files are kept for each
node
(? equals the node number in decimal).
.\System\MiscNews -- Where miscellaneous news is kept.
.\System\SysNews -- Where system news is kept.
.\Temp_Directories -- Where temporary files are kept (for
example, when viewing archive files)
.\Text -- Where text files are kept
(*.ASC, *.ANS, *.RIP, *.AVT).
Text Files Used By Adept:
AdeptXBBS text files. Filenames and where they are shown.
Text files have a name and extension. The regular filename extension
is .ASC which means this is a regular ASCII text file. If the user
has ANSI color turned on, Adept will look for a file with the same
name, but with the extension .ANS. If the user has Avatar support
turned on, a text file with the extension .AVT is search for. If the
user has RIP graphics support enabled, a text file with the extension
.RIP is searched for.
If the files with the alternate extensions (.ANS .AVT .RIP) are not
found, then the default .ASC file is used.
If any of these files are not found, the file is not shown and the
error is ignored. You as the Sysop must create these text files if you
wish them to be displayed. These files may use meta variables.
File Names:
BadAge.ASC -- is displayed for users failing the too young or
too old BBS settings.
BadPass.Asc -- Shown before the user is logged out after
they have failed to enter the proper
password after 'Max Attempts' attempts.
Shown before 'BadPass.Menu' menu is
auto-executed.
BadPassword.ASC -- Shown every time after a user types in the
wrong password.
BeforeNew.ASC -- Shown after 'NewUser.ASC' (and text line
#194) (text line #21 is shown immediately
after this file)
Bullet.ASC -- Shown after News.ASC
CantFind.ASC -- Shown when the users name is not found.
Download.ASC -- Shown before a user starts a download.
18
DumbUser.Asc -- Shown when user can't figure out how to
type their name correctly after 'Max
Attempts' attempts.
Shown before 'DumbUser.Menu' menu is
auto-executed if it exists.
DupePhone.ASC -- Shown when the phone number entered is
found to be a duplicate of another users
phone number.
FileAreas.ASC -- If this file exists, then it is shown in
place of the default file area listing.
FileAreas###.ASC -- If this file exists, it will be shown
before the FileAreas.ASC would have been
shown. ### is the security level to show to.
FixUser.ASC -- Shown before the edit new user menu
(EditYou.MNU) is executed.
FPassChng.ASC -- is now displayed when forcing an user
to change their password.
FunctionKeyxx.Asc -- Where 'xx' is a function key number
corresponding to the press of a function key
by the SysOp. This is not tested and may not
be working, but the code is in there.
GetPassword.ASC -- Shown before the user types in their password.
GoodBye.Asc -- Shown when using a menu item 1000 style
logoff.
HappyBirthday.ASC -- Shown when it is the users birthday.
Levelxx.Asc -- Where 'xx' is the users security level
#1 Shown after correct password has been
type in.
LockedOut.ASC -- Shown when a user is locked out of the system.
Login.ASC -- Shown when the user first logs on, before they
enter their name.
LoginX.ASC -- Shown when the user first logs on to the Node specified
by the X, before they enter their name. If a
LoginX.ASC is not found, Login.asc/ans is shown.
LogonMsg.ASC -- Shown before the user enters their first
logon message (only if the 'first logon
message' bit is set)
MsgAreas.ASC -- If this file exists, then it is shown in
place of the default message area listing.
MsgAreas###.ASC -- If this file exists, it will be shown before
the MsgAreas.ASC would have been shown. ###
is the security level to show to.
MsgToUserOn.Cmd -- (if it exists in the menus dir) will
be executed when a message is entered to a
user who is currenlty on line.
(An Example MsgToUserOn.Cmd is included)
NewBirthday.ASC -- Shown before the user enters their birthdate.
News.ASC -- Shown after Welcome.ASC
19
NewUser.ASC -- Shown to new users before they enter their
user info. (text line #194 is shown
immediately after this file)
NoAccess.Asc -- Shown when a regular users security level is
below that necessary to log into a node
(login security)
NoMoreTime.ASC -- Displayed before carrier is dropped on a
user that has run out of time.
NoNewUsers.Asc -- Shown when the new users security level is
below that necessary to log into a node
(login security)
NoRoom.ASC -- Shown to a new user when there is no room
for new users.
PageSysop.ASC -- Shown just before the Sysop is paged for a
chat request.
PhoneCan.ASC -- Shown when the users phone number has been
found in the phone 'trash can' file. See
below for format.
Preregister.ASC -- Shown to a new user when the system only
accepts pre-registered users.
Quotes -- Shown upon login, logoff or before a new
menu is displayed. See below for format.
ReAsk.ASC -- Shown before ReAsk.Menu is executed. The
ReAsk text file and menu are executed if
the user exists and the users 'ReAsk' flag is
false. The 'ReAsk' system is used to fill in
missing fields in the user record.
timeadjusted.asc -- Shown if a users session has been modified to
end early because of a Forced Event.
Trashcan.ASC -- Shown when the users name has been found in
the 'Trash can' file. See below for format.
TooLow.ASC -- Shown if a user tries to access a menu item that
his security does not allow him to use.
TooManyPages.ASC -- Shown when a user has paged the Sysop too
many times. This checks the Max Page Attempts
field found in the config pull-down menus.
TooOld.ASC -- Shown if a user tries to access a menu item that
he is too Old to access.
TooYoung.ASC -- Shown if a user tries to access a menu item that
he is too Young to access.
Upload.ASC -- Shown before a user starts an upload.
Welcome.ASC -- Shown after the user has entered their
password and before the news files are shown.
WelcomeX.ASC -- Shown after the user has entered their
password and before the news files are shown for
the Node specified by X. If the WelcomeX.ASC
is not found then Welcome.asc/ans is shown
xxxx.Asc -- Where 'xxxx' is the name of the user group
the user belongs to. Shown after Levelxx.Asc
(if it exists) ie. After successful password
input.
xxx.Desc -- Shown before reading messages in a certain
message area. Typically used to describe the
contents of the message area. Where 'xxx'
is the message area name. This file should be
located in the same directory as the
Message_Bases.
20
xxx.Rules -- Shown when "U" is pressed while reading
messages in a certain message area. Typically
used to post echo mail area rules. Where 'xxx'
is the message area name. This file should be
located in the same directory as the
Message_Bases.
YouMoron.Asc -- Shown when SysOp logs user out with the
moron menu item. This could be used in
several ways, for instance, the SysOp could
put a message in 'YouMoron.Asc' that says
'SysOp needs system now. Logging you off'
Miscellaneous Files Used By Adept
xxxxx.menu.bin -- Compiled menu file which Adept recompiles
on-the-fly.
The TRASHCAN File:
------------------
By creating a trashcan file, you can limit the number of crank BBS
callers.
This file will be scanned when a new user logs in. It will look at the
name
they enter and refuse them entry if their name is found in the trashcan.
"\Adept\System\Trashcan" uses the following format:
; - Comment
: - Compares Last Name
! - Look in name
- Exact Compare
!Look_anywhere_in_name
:Compare_with_last_name
;Comment
This is a exact compare
example:
;This is the Trashcan File
:Butthead
!Hacker
John Doe
In the example above, the first line is a comment, the 2nd line
tells AdeptXBBS to compare the user's last name to 'Butthead', if
it matches, this user won't be allowed to login. The 3rd line tells
AdeptXBBS to look anywhere in the name for a match of 'Hacker'. So,
if the user logged with the name Joe Hacker, Hacker Bob, or
Joe Hackerson, he wouldn't be granted access. The last line will
look for an exact match. So, if the person logs in with the name
John Doe, they won't be granted access. If they log in with the
name Johnny Doe, they will get access.
21
The PHONECAN File:
By creating a phonecan file, you can limit the number of crank BBS
callers.
This file will be scanned when a new user logs in. It will look at the
phone number they enter and refuse them entry if their number is found
in the trashcan.
"\Adept\System\Phonecan" uses the following format:
!look_in_number
Exact Compare
;Comment
example:
;This is the Phonecan File
!911
!1-800
!1-900
555-1212
1-800-111-2222
In the example above, the first line is a comment, the 2nd line tells
AdeptXBBS to look in the number for a match of '911', any phone number
that has this pattern in it will match. So, if the user inputs 342-9110,
it will match. The 3rd line will look for a match of '1-800' anywhere in
the number that the user has typed in. Same for the 4th line. The 5th
and 6th lines will look for an exact match of those numbers.
The QUOTES File:
By creating a quotes file, you can send your users a quote when they
logoff your bbs.
"\Adept\System\Quotes" uses the following format:
%%
Quote of the day - We have nothing to fear but fear itself...
%%
Quote of the day - A penny saved is a penny earned...
%%
Quote of the day - Make new friends but keep the old.
Some are silver and the others are gold
%%
22
Setting Up News Files:
Naming convention is: anynameyouwant.news.asc (.ans,.rip or .avt). The
files are placed in the \Adept\System\SysNews or the
\Adept\System\MiscNews directory. The *.news.asc file is required. The
.ans, .rip or .avt files are optional. News will be shown to the user
if the user's last login date preceeds the date of the *.news.asc file.
Note that the date comparison is always made between the user's record
and the .asc file, even if the .ans file is displayed. To have the news
file display for at least a week, date the *.news.asc file a week into
the future.
If you have a news file that you want shown to the user every time they
login, make a *.news.asc (.ans, .rip or .avt) file and place it in the
\Adept\Text directory.
To enable news:
From the pull-down CONFIG->BBS->BBS Action Flags menu, add the USE ANSI
NEWS option.
From the pull-down CONFIG->BBS->New User Defaults menu, add the SEE
SYSTEM RELATED NEWS option.
RIP Graphics:
We have been told that .RIP graphics does work in adept and has been
tested. In v0.94.10 I added a new multi-threaded display that will
display the rip screen remotely while displaying the ANSI version
of the screen locally. This should be a nice change from seeing all
those wonderful .RIP codes fly across your local screen. If a .RIP
screen does not exist, the .ANS or .ASC equivalent of that file will
be shown instead. For a user to see the .RIP screens, the Sysop must
toggle the RIP option in the user's record. This is found in the USER
EDITOR for each user.
Setting up Internode Chat with the Cserver:
If you run more than one node, you probably would like the ability for
these nodes to communicate with each other.
One condition that you must have to run CServer is to have the local loop
back in place. Do set this run 'ifconfig lo 127.0.0.1' in your
tcpstart.cmd or startup.cmd files when you boot.
Once local loop back is set, you can start the chat server in a separate
session BEFORE starting up Adept. To do this, open an OS/2 window and Type:
CSERVER.EXE #
(Where the # is the number of nodes on your system)
Then start up Adept the way you normally do. Now, your users can access
the chat menu that comes with Adept to page or chat back and forth with
other users that are online.
Testing Your AdeptXBBS setup using Named Pipes:
If you would like to test your configuration of Adept, but do not have
another modem or phone line to call in to your own system, you can use
NAMED PIPES. To do this, you'll need a terminal program that supports
23
this. One such program is LiveWire. Other term programs probably
support this, but I don't know of any others at this time. To set this
up, do the following steps in Adept:
Select line x
Config
Active line
General Settings
Port Name ( Type in: \Pipe\anyname_you_want)
Initial BPS (57600 or whatever)
Okay
Shutdown
The \Pipe\anyname_you_want establishes the communications channel but at
this point it is open ended. Now the communications package must be
configured to provide the other end. Instead of selecting a normal COM
port select Pipe and duplicate the Pipe_name entry from the BBS setup in
the Pipe name under LiveWire. Make sure you type in the entire entry as
you did in Adept (\Pipe\anyname_you_want). After you do this, you
should see yourself logged on your BBS.
NOTE: DOS doors will not work while connected via a Pipe. Most OS/2
doors should though.
24
______________________________
_ _ AdeptXBBS MENU INTERFACE _
______________________________
Menu files are plain ASCII files which describe the functions available
at the current menu.
Menu files are named 'xxxx.Menu' (where 'xxxx' is the menu name) Fields
on each line are separated by commas, so commas are not allowed in the
text.
Menu files can have ASCII and ANSI files associated with them, or can
create their own generic type ascii menu.
Menu files are stored in the \Adept\Menus directory. The following are
descriptions of default menus:
Main.Menu or Main?.Menu -- This is executed after the user has logged
in successfully. Main?.Menu is tried
before Main.Menu So a SysOp could set up
a main menu based on a node number basis.
If Main?.Menu doesn't exist, Main.Menu is
executed. The '?' should be substituted
with the node number.
DumbUser.Menu -- This is executed when a user forgets their
name. And answers N 'Max Attempts' times.
(SysOp configurable).
BadPass.Menu -- This is executed when a user forgets their
password and gets it wrong more then the
specified number of maximum tries.
AtLogin.Menu -- This is executed every time a user logs on
just before the new message, new files
options are executed if they are turned on.
EditYou.Menu -- This one is kinda scary. Runs after the
new user routine. It must be exited
with a menu item 1001 otherwise strange
things _will_ happen.
ReAsk.Menu -- This menu is an auto-execute menu which
is executed if the 'ReAsk' bit in the
users record is not set. It is executed
after the entering of the password.
This menu would be used to fill in, say,
blank fields in the users record.
NewUser.Menu -- Executed when a new user logs in.
25
Creating .Menus:
The following Menu Functions are available.
BEGINMENU - Mark the begining of a menu.
ENDMENU - Mark the end of the a menu.
Everything before and after the above are ignored by the menu parser.
PROMPT - Menu Prompt Text
PROMPTCOLOR - Menu Prompt Color
0 - White 8 - Light Grey
1 - Black 9 - Dark Grey
2 - Dark Blue 10 - Light Blue
3 - Dark Green 11 - Light Green
4 - Light Blue 12 - Cyan
5 - Dark Red 13 - Light Red
6 - Dark Magenta 14 - Light Magenta
7 - Brown 15 - Yellow
DISPLAYFILE - File to display to users instead of menu item text
MENULOCATION - Currently location on the BBS
MENUFLAGS - Menu option flags.
The above options can be anywhere within the BEGINMENU and ENDMENU
options, but are preferably at the top of the menu to assist in
readability.
BEGINMENUITEM - Begin Item Definition
ENDMENUITEM - End Item Definition
All of the below functions are ONLY available within the menu item
definition. All of the below are relayed to the 'KEY' keyword. The
'KEY' keyword contains the key that represents the menu item.
KEY - Key to assign to the menu item.
MENUCOMMAND - Command to execute when the 'KEY' is pressed.
DISPLAYSTRING - String to display to user when displaying the menu items
along with or without a Display File.
DISPLAYCOLOR - Initial color for the display string
0 - White 8 - Light Grey
1 - Black 9 - Dark Grey
2 - Dark Blue 10 - Light Blue
3 - Dark Green 11 - Light Green
4 - Light Blue 12 - Cyan
5 - Dark Red 13 - Light Red
6 - Dark Magenta 14 - Light Magenta
7 - Brown 15 - Yellow
DATAOPTION - Optional data for the menu command
MINAGE - Minimum age allowed to use this command
MAXAGE - Maximum age allowed to use this command
MINSEC1 - Minmum security level (based on users security #1) to use
command
MAXSEC1 - Miximum security level (based on users security #1) to use
command
MINSEC2 - Minmum security level (based on users security #2) to use
command
MAXSEC2 - Miximum security level (based on users security #2) to use
command
26
STARTTIME - Start time that this command becomes available. (24hr)
ENDTIME - Ending time that this command becomes unavailable. (24hr)
MINONLINETIME - Minimum time user is online before they can use this
command.
MAXONLINETIME - Maximum time a user can be online before command becomes
unavailable.
MINCALLS - Minimum calls that the user has made to the BBS before
command becomes available.
MAXCALLS - Maximum calls that the user has made to the BBS before
command becomes unavailable.
MINPOSTS - Minimum number of messages posted before user can access
this command.
MAXPOSTS - Maximum number of messages posted before command becomes
unavailable.
MINUPLOADS - Minimum number of uploads needed to access this command.
MAXUPLOADS - Maximum number of uploads before command becomes unavailable.
MINDOWNLOADS - Minimum number of download needed to access this command.
MAXDOWNLOADS - Maximum number of downloads before command becomes
unavailable.
GROUP - Group number that the user needs to belong to to access
command.
PORTFLAGS - Type of port needed (TCP, Comm, Pipe) to access command.
FLAGS1 - User flag comparison for access to this command flags #1
FLAGS2 - User flag comparison for access to this command flags #1
BitValues for Flags
1 1
2 2
3 4
4 8
5 16
6 32
7 64
8 128
9 256
10 512
11 1024
12 2048
13 4096
14 8192
15 16384
16 32768
17 65536
18 131072
19 262144
20 524288
21 1048576
22 2097152
23 4194304
24 8388608
25 16777216
26 33554432
27 67108864
28 134217728
29 268435456
30 536870912
31 1073741824
32 2147483648
GENDER - Genders (YES, Genders I.E. MFO (Male, Female, Other or
whateever you have defined in the language.text as possible
genders)) allowed to access this command.
27
NEWLOCATION - Location to set when user executes this command for
calls to items/functions that do not set the system
location.
All of the above may exist within a BEGINMENUINITEM/ENDMENUITEM in any
particular order.
Sample Main.Menu:
BEGINMENU
PROMPT \n [
?
for Help ] \r\n [
{T0 minutes left
]
PROMPTCOLOR 0
DISPLAYFILE MainMenu.ASC
MENULOCATION Main Menu
MENUFLAGS 4
BEGINMENUITEM
KEY -
MENUCOMMAND 1
DISPLAYCOLOR 0
DATAOPTION main.menu
MINSEC1 30
MINSEC2 30
ENDMENUITEM
BEGINMENUITEM
KEY ?
MENUCOMMAND 10
DISPLAYCOLOR 0
DATAOPTION Commands.cmd
ENDMENUITEM
BEGINMENUITEM
KEY M
MENUCOMMAND 1
DISPLAYSTRING [M]essage Menu
DISPLAYCOLOR 0
DATAOPTION Message.Menu
MINSEC1 30
MINSEC2 30
ENDMENUITEM
BEGINMENUITEM
KEY O
MENUCOMMAND 1
DISPLAYSTRING [O]ffline Mail
DISPLAYCOLOR 0
DATAOPTION OFF-MAIL.Menu
MINSEC1 30
MINSEC2 30
ENDMENUITEM
BEGINMENUITEM
KEY F
MENUCOMMAND 1
DISPLAYSTRING [F]ile Menu
DISPLAYCOLOR 0
DATAOPTION Files.Menu
MINSEC1 30
MINSEC2 30
ENDMENUITEM
BEGINMENUITEM
KEY S
MENUCOMMAND 1
DISPLAYSTRING User [S]etup
DISPLAYCOLOR 0
DATAOPTION EditUser.Menu
MINSEC1 30
MINSEC2 30
ENDMENUITEM
28
BEGINMENUITEM
KEY G
MENUCOMMAND 1
DISPLAYSTRING [G]ood-bye
DISPLAYCOLOR 0
DATAOPTION LogOff.Menu
ENDMENUITEM
BEGINMENUITEM
KEY B
MENUCOMMAND 1
DISPLAYSTRING [B]ulletin Menu
DISPLAYCOLOR 0
DATAOPTION Bullet.Menu
MINSEC1 30
MINSEC2 30
ENDMENUITEM
BEGINMENUITEM
KEY U
MENUCOMMAND 1
DISPLAYSTRING [U]ser & BBS Stats
DISPLAYCOLOR 0
DATAOPTION Stats.Menu
MINSEC1 30
MINSEC2 30
ENDMENUITEM
BEGINMENUITEM
KEY I
MENUCOMMAND 1
DISPLAYSTRING [I]nternet Menu
DISPLAYCOLOR 0
DATAOPTION Internet.menu
MINSEC1 30
MINSEC2 30
ENDMENUITEM
BEGINMENUITEM
KEY D
MENUCOMMAND 1
DISPLAYSTRING [D]oors Menu
DISPLAYCOLOR 0
DATAOPTION Door.Menu
MINSEC1 30
MINSEC2 30
ENDMENUITEM
BEGINMENUITEM
KEY X
MENUCOMMAND 1
DISPLAYSTRING Sysop Menu
DATAOPTION Sysop.Menu
MINSEC1 100
MINSEC2 100
ENDMENUITEM
BEGINMENUITEM
KEY C
MENUCOMMAND 1
DISPLAYSTRING [T]eleconference
DISPLAYCOLOR 0
DATAOPTION teleconf.menu
MINSEC1 30
MINSEC2 30
ENDMENUITEM
29
BEGINMENUITEM
KEY E
MENUCOMMAND 10
DISPLAYSTRING [E]mail
DISPLAYCOLOR 0
DATAOPTION Sendemail.srx
MINSEC1 30
MINSEC2 30
ENDMENUITEM
BEGINMENUITEM
KEY Y
MENUCOMMAND 48
DISPLAYSTRING [Y]ell at the SysOp!
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
BEGINMENUITEM
KEY W
MENUCOMMAND 42
DISPLAYSTRING [W]ho is online
DATAOPTION 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
BEGINMENUITEM
KEY V
MENUCOMMAND 11
DISPLAYSTRING [V]iew Recent Callers
DISPLAYCOLOR 0
DATAOPTION Adread.srx
MINSEC1 30
MINSEC2 30
ENDMENUITEM
BEGINMENUITEM
KEY L
MENUCOMMAND 43
DISPLAYSTRING User [L]ist
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
ENDMENU
PROMPT
The first line of the menu file describes the prompt is ansi
or text format
PROMPTCOLOR
Menu Color if not using DISPLAYFILE
MENULOCATION
Where the menu is i.e Main Menu
DISPLAYFILE
Usually a .asc or .ans file that has a graphical representation of your
menu.
MENUFLAGS
There are four menu flags: (use the number or combination of numbers)
1 Quote every time
This means that an attempt to display a quote will happen
every time the menu is displayed depending on the 'quote
odds' in the BBS settings.
30
The quote odds are based on a 100 percent scale. 50 would
mean you would get a quote only half the time.
2 Quote once only
This means that an attempt to display a quote will happen the
first time the menu is displayed depending on the 'quote
odds' in the BBS settings. But after a quote is shown once,
there will not be another quote for that menu.
4 First on [ENTER]
This means that if the user hits enter, the first menu item
is the default choice.
8 Both menu and Menu file
This means that if you have a menu display file, both it and
the menu 'output strings' will be replaced. The display file
will be shown before the 'output strings'
If you dont want or need a certain menu option, then leave it out. For
example, if you don't want a color or text menu displayed, then leave the
keywords out. For example:
PROMPT \n [
?
for Help ] \r\n [
{T0 minutes left
]
PROMPTCOLOR 0
MENULOCATION Main Menu
MENUFLAGS 4
This leaves all fields blank except the prompt text.
Extra Notes About .Menu Files:
o A menu file may have comments in it if the first character on
the line is a semi-colon ';'.
o If there is not a menu file in the first line of the menu
description, then the 'output strings' of every command are
displayed in the order that they appear.
o Meta variables can be place in the data field for each menu
item. This allows for great flexibility in creating menu
commands.
o Menus should have a file extension of '.Menu' or '.Cmd'.
o There should be (in almost every case) a Main.Menu (or
Main?.Menu for a particular node number.) This is the menu
which is started after the user logs into the system. Adept
will look for a Main?.Menu first and if one is not found for
that line, then Main.Menu is used.
If you have a Main?.Cmd or Main.Cmd REXX script in the
.\Menus directory it will be used instead of Main.Menu See
AdptREXX.Doc for more info.
o Adept uses a 'New User' menu called, appropriately enough,
NewUser.Menu This is an auto-execute menu that is called right
after the NewUser.ASC and BeforeNew.ASC files are shown to the
user. All the commands in this menu will be executed in the
order that they are found. If you don't want a question to be
asked, feel free to delete that line. Be creative! If you have
an 'EditYou.Menu' file it will be executed after NewUser.Menu
31
o 'EditYou.Menu' can be created if you want to give the new user
a chance to edit their info before it is saved.
o Adept supports a special menu which helps a SysOp get complete
information from a user after they have converted to Adept from
another BBS. ReAsk.Menu is an auto-execute menu which is run if
ReAsk.Menu exists and the 'ReAsked' flag in the user record is
set to false. Each command in this menu is executed one after
another. When the menu is complete the 'ReAsked' flag is set to
true. Also, the file 'ReAsk.ASC' is shown before the menu is
executed.
Menu Types:
----------------------------------------------------------------------
Menu Type: 0
----------------------------------------------------------------------
Option Data: Menu Name
Description:
Go to another menu. Name of menu is in the data field.
BEGINMENUITEM
KEY O
MENUCOMMAND 0
DISPLAYSTRING [O]nline Games
DISPLAYCOLOR 0
DATAOPTION Door.menu
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 1
----------------------------------------------------------------------
Optional Data: Menu Name
Description:
Gosub to another menu. Name of menu is in the data field.
you can only go 9 gosubs deep. If you wish to have more nested
menus (more than 9) then use the (0) goto menu command.
BEGINMENUITEM
KEY O
MENUCOMMAND 1
DISPLAYSTRING [O]nline Games
DISPLAYCOLOR 0
DATAOPTION Door.menu
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 2
----------------------------------------------------------------------
Optional Data: Menu Name
Description:
Return from a gosub'ed menu. Returns to the previous menu.
BEGINMENUITEM
KEY -
MENUCOMMAND 2
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
32
----------------------------------------------------------------------
Menu Type: 3
----------------------------------------------------------------------
Optional Data: Menu Name
Description:
Clear all gosub'ed menus.
BEGINMENUITEM
KEY +
MENUCOMMAND 3
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 4
----------------------------------------------------------------------
Optional Data: Menu Name
Description:
Go to another menu and ask for a password. The data field should
read MenuName;Password
BEGINMENUITEM
KEY O
MENUCOMMAND 4
DISPLAYSTRING [O]nline Games
DISPLAYCOLOR 0
DATAOPTION Door.menu;zaxxon
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 5
----------------------------------------------------------------------
Optional Data: Menu Name
Description:
Gosub to another menu and ask for a password. The data field
should read MenuName;Password
BEGINMENUITEM
KEY O
MENUCOMMAND 5
DISPLAYSTRING [O]nline Games
DISPLAYCOLOR 0
DATAOPTION Door.menu;zaxxon
MINSEC1 30
MINSEC2 30
ENDMENUITEM
---------------------------------------------------------------------
Menu Type: 6
----------------------------------------------------------------------
Optional Data: Menu Name
Description:
Gosub a forced-return menu (This type of menu returns after any
command is selected)
BEGINMENUITEM
KEY *
MENUCOMMAND 6
DISPLAYSTRING Sysop Menu
DATAOPTION Sysop.Menu
33
MINSEC1 100
MINSEC2 100
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 7
----------------------------------------------------------------------
Optional Data: Menu Name
Description:
Gosub an auto-execute menu (This type of menu executes all the
commands in the menu file, then returns)
BEGINMENUITEM
KEY U
MENUCOMMAND 7
DISPLAYSTRING [U]ser Setup
DISPLAYCOLOR 0
DATAOPTION User.menu
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 10
----------------------------------------------------------------------
Optional Data: Menu Name
Description:
Execute a REXX script file in cached mode. Name of file is in the
data field. The current line number is passed as the first
argument to the REXX script.
The line number must be the first argument pass back to any Adept
REXX functions. If the REXX script returns "-1" then Adept will
exit as if the user has logged off. In other words, if the rexx
script ended with:
EXIT -1
The user would be logged off. Note, this is when the rexx script
is called from the regular menu system.
BEGINMENUITEM
KEY O
MENUCOMMAND 10
DISPLAYSTRING [T]oday's Callers
DISPLAYCOLOR 0
DATAOPTION Callers.cmd
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 11
----------------------------------------------------------------------
Optional Data: Menu Name
Description:
Execute a REXX script file in NON cached mode. Name of file is in
the data field. The current line number is passed as the first
argument to the REXX script.
The line number must be the first argument pass back to any Adept
REXX functions. If the REXX script returns "-1" then Adept will
exit as if the user has logged off. In other words, if the rexx
script ended with:
EXIT -1
34
The user would be logged off. Note, this is when the rexx script
is called from the regular menu system.
BEGINMENUITEM
KEY R
MENUCOMMAND 11
DISPLAYSTRING [R]egister
DISPLAYCOLOR 0
DATAOPTION c:\adept\tabs\register.erx
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 15
----------------------------------------------------------------------
Optional Data: Message base
Description:
Read messages forward with no prompting for message number.
You may also put data in the item data field. This data is the
message base to read from. It also switches the users current
message area to that area.
So if you had "Headline New" in the item data field for any
of those menu items, it would switch to the "Headline News" message
area, and then prompt the users to read the messages there.
BEGINMENUITEM
KEY R
MENUCOMMAND 15
DISPLAYSTRING [R]ead Messages
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 16
----------------------------------------------------------------------
Optional Data: Menu Name
Description:
QuickScan message (to, from, subject)
You may also put data in the item data field. This data is the
message base to read from. It also switches the users current
message area to that area.
So if you had "Headline New" in the item data field for any
of those menu items, it would switch to the "Headline News" message
area, and then prompt the users to read the messages there.
BEGINMENUITEM
KEY Q
MENUCOMMAND 16
DISPLAYSTRING [Q]uickscan Messages
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
35
----------------------------------------------------------------------
Menu Type: 17
----------------------------------------------------------------------
Optional Data: Menu Name
Description:
Scan message headers
You may also put data in the item data field. This data is the
message base to read from. It also switches the users current
message area to that area.
So if you had "Headline New" in the item data field for any
of those menu items, it would switch to the "Headline News" message
area, and then prompt the users to read the messages there.
BEGINMENUITEM
KEY S
MENUCOMMAND 17
DISPLAYSTRING [S]can Messages
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 20
----------------------------------------------------------------------
Optional Data: Message Base
Description:
Read messages forward, with prompting.
You may also put data in the item data field. This data is the
message base to read from. It also switches the users current
message area to that area.
So if you had "Headline New" in the item data field for any
of those menu items, it would switch to the "Headline News" message
area, and then prompt the users to read the messages there.
BEGINMENUITEM
KEY R
MENUCOMMAND 20
DISPLAYSTRING [R]ead Messages
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 25
----------------------------------------------------------------------
Optional Data:
Description:
Globally read msgs from current newest message
BEGINMENUITEM
KEY N
MENUCOMMAND 25
DISPLAYSTRING [N]ew Messages
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
36
----------------------------------------------------------------------
Menu Type: 26
----------------------------------------------------------------------
Optional Data:
Description:
Globally read messages, stop at each area
BEGINMENUITEM
KEY N
MENUCOMMAND 26
DISPLAYSTRING [N]ew Messages
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 28
----------------------------------------------------------------------
Optional Data: Message Base
Description:
Searches current message area for keywords in the
to, from, subject and message body.
You may also put data in the item data field. This data is the
message base to read from. It also switches the users current
message area to that area.
So if you had "Headline New" in the item data field for any of
those menu items, it would switch to the "Headline News" message
area, and then prompt the users to read the messages there.
BEGINMENUITEM
KEY S
MENUCOMMAND 28
DISPLAYSTRING [S]earch
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 31
----------------------------------------------------------------------
Optional Data:
Description:
Export mail - Text format
BEGINMENUITEM
KEY X
MENUCOMMAND 31
DISPLAYSTRING e[X]port Text Mail
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 32
----------------------------------------------------------------------
Optional Data: Menu Name
Description:
Export mail - Fido packet format
37
BEGINMENUITEM
KEY X
MENUCOMMAND 32
DISPLAYSTRING e[X]port Fido Mail
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 33
----------------------------------------------------------------------
Optional Data: Menu Name
Description:
Export mail - QWK format
BEGINMENUITEM
KEY X
MENUCOMMAND 33
DISPLAYSTRING e[X]port QWK Mail
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 34
----------------------------------------------------------------------
Optional Data: Menu Name
Description:
Export mail - Bluewave format
BEGINMENUITEM
KEY X
MENUCOMMAND 34
DISPLAYSTRING e[X]port BW Mail
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 35
----------------------------------------------------------------------
Optional Data: Menu Name
Description:
Export mail - format based on user preference
BEGINMENUITEM
KEY D
MENUCOMMAND 35
DISPLAYSTRING [D]ownload Mail
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 36
----------------------------------------------------------------------
Optional Data:
Description:
Import mail - allows user to upload a mail packet
38
BEGINMENUITEM
KEY U
MENUCOMMAND 36
DISPLAYSTRING [U]pload QWK Mail
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 41 Ex. D,41,Display Stats,,0
----------------------------------------------------------------------
Optional Data:
Description:
Display user status
BEGINMENUITEM
KEY D
MENUCOMMAND 41
DISPLAYSTRING [D]isplay User Stats
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 42
----------------------------------------------------------------------
Optional Data:
Description:
Who is on-line
BEGINMENUITEM
KEY W
MENUCOMMAND 42
DISPLAYSTRING [W]ho's online
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 43
----------------------------------------------------------------------
Optional Data:
Description:
List users
BEGINMENUITEM
KEY L
MENUCOMMAND 43
DISPLAYSTRING [L]ist users
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 45
----------------------------------------------------------------------
Optional Data:
Description:
Edit your user record
39
BEGINMENUITEM
KEY E
MENUCOMMAND 45
DISPLAYSTRING [E]dit User Record
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 46
----------------------------------------------------------------------
Optional Data:
Description:
Adjust accessible file areas
BEGINMENUITEM
KEY A
MENUCOMMAND 46
DISPLAYSTRING [A]djust file areas
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 47
----------------------------------------------------------------------
Optional Data:
Description:
Adjust accessible message areas
BEGINMENUITEM
KEY A
MENUCOMMAND 47
DISPLAYSTRING [A]djust message areas
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 48
----------------------------------------------------------------------
Optional Data:
Description:
Page SysOp
BEGINMENUITEM
KEY Y
MENUCOMMAND 48
DISPLAYSTRING [Y]ell at Sysop
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 49
----------------------------------------------------------------------
Optional Data:
Description:
Display help (If 'text' in data field, help on 'text' will be
shown)
40
BEGINMENUITEM
KEY ?
MENUCOMMAND 49
DISPLAYSTRING [?]Help
DISPLAYCOLOR 0
DATAOPTION Download
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 50
----------------------------------------------------------------------
Optional Data:
Description:
Adjust tags on off-line mail export and to support TAGGED menu
commands 119, 120, 121, 122.
BEGINMENUITEM
KEY T
MENUCOMMAND 50
DISPLAYSTRING [T]ag mail areas
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 51
----------------------------------------------------------------------
Optional Data: FileName.### (Using .ASC as the extension will cause the
BBS to display the default graphics format
for the user)
Description:
Display a text file. You can also enter a filename;flags Where
'flags' are flags to determine how the file is displayed.
1 - Pause if normal text file
2 - Translate thru Metas AND Literal
4 - Allow aborting (saying N)o )
16- Display "Hit Enter" at the end of the text file
32- No literal translation.
64- No meta translation
128- Clear the screen before displaying text file
If no flags are specified, the default is 7 (which is 1, 2, and 4)
Example of the item data field: MyFile.Txt;71
71 = 1, 2, 4, and 64
BEGINMENUITEM
KEY S
MENUCOMMAND 51
DISPLAYSTRING [S]how info
DISPLAYCOLOR 0
DATAOPTION MyFile.Txt;71
MINSEC1 30
MINSEC2 30
ENDMENUITEM
41
----------------------------------------------------------------------
Menu Type: 52
----------------------------------------------------------------------
Optional Data:
Description:
Show all Chat Channels
BEGINMENUITEM
KEY C
MENUCOMMAND 52
DISPLAYSTRING [C]hat Channels
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 53
----------------------------------------------------------------------
Optional Data:
Description:
List all users in a Chat Channel
BEGINMENUITEM
KEY L
MENUCOMMAND 53
DISPLAYSTRING [L]ist Users in Channel
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 55
----------------------------------------------------------------------
Optional Data:
Description:
Display Who is currently online
BEGINMENUITEM
KEY W
MENUCOMMAND 55
DISPLAYSTRING [W]ho's Online
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 60
----------------------------------------------------------------------
Optional Data:
Description:
Select message area
BEGINMENUITEM
KEY A
MENUCOMMAND 60
DISPLAYSTRING [A]rea Change
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
42
----------------------------------------------------------------------
Menu Type: 61
----------------------------------------------------------------------
Optional Data:
Description:
Select file area
BEGINMENUITEM
KEY A
MENUCOMMAND 61
DISPLAYSTRING [A]rea Change
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 62
----------------------------------------------------------------------
Optional Data: Name of Message Area
Description:
Find message area (name of area in data field)
BEGINMENUITEM
KEY S
MENUCOMMAND 62
DISPLAYSTRING [S]witch to Email area
DISPLAYCOLOR 0
DATAOPTION E-mail
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 63 Ex. S,63,[S]witch to Games,Dos-Games,0
----------------------------------------------------------------------
Optional Data: Name of File Area
Description:
Find file area (name of area in data field)
BEGINMENUITEM
KEY S
MENUCOMMAND 63
DISPLAYSTRING [S]witch to Games
DISPLAYCOLOR 0
DATAOPTION Dos-games
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 64
----------------------------------------------------------------------
Optional Data: 1/-1
Description:
Next/Previous message area (1 in data field means next area, -1 in
data field means previous area)
BEGINMENUITEM
KEY >
MENUCOMMAND 64
DISPLAYSTRING [N]ext area
DISPLAYCOLOR 0
43
DATAOPTION 1
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 65
----------------------------------------------------------------------
Optional Data: 1/-1
Description:
Next/Previous file area (1 in data field means next area, -1 in
data field means previous area)
BEGINMENUITEM
KEY <
MENUCOMMAND 65
DISPLAYSTRING [P]revious Ares
DISPLAYCOLOR 0
DATAOPTION -1
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 70
----------------------------------------------------------------------
Optional Data:
Description:
List files in current area
BEGINMENUITEM
KEY L
MENUCOMMAND 70
DISPLAYSTRING [L]ist File In This Area
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 71
----------------------------------------------------------------------
Optional Data:
Description:
Search files in current area. Asks for search string
BEGINMENUITEM
KEY C
MENUCOMMAND 71
DISPLAYSTRING [C]urrent Area String to Match
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 72
----------------------------------------------------------------------
Optional Data:
Description:
Search files in current area newer than specified date. Asks for
search string and date.
44
BEGINMENUITEM
KEY C
MENUCOMMAND 72
DISPLAYSTRING [C]urrent Area Date & String to Match
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 73
----------------------------------------------------------------------
Optional Data:
Description:
New files in current area. asks for date.
BEGINMENUITEM
KEY N
MENUCOMMAND 73
DISPLAYSTRING [N]ew files in Current Area
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 74 Ex. 5,74,All Date to Match,,15
----------------------------------------------------------------------
Optional Data:
Description:
New files in all areas, searched sequentially.
BEGINMENUITEM
KEY A
MENUCOMMAND 74
DISPLAYSTRING New Files in [A]ll Areas
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 75 Ex. 7,75,All A-Z Listing,,15
----------------------------------------------------------------------
Optional Data:
Description:
List ALL files in alphabetical order.
BEGINMENUITEM
KEY A
MENUCOMMAND 75
DISPLAYSTRING [A]-Z listing
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 76
----------------------------------------------------------------------
Optional Data: Search String
Description:
Search files in all areas. Asks for search string.
45
BEGINMENUITEM
KEY A
MENUCOMMAND 76
DISPLAYSTRING [A]ll String to Match
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 77
----------------------------------------------------------------------
Optional Data:
Description:
List files in current area, in dated order newest to oldest.
BEGINMENUITEM
KEY F
MENUCOMMAND 77
DISPLAYSTRING [F]ile list Current Area
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 78
----------------------------------------------------------------------
Optional Data:
Description:
List files in current area, in alphabetical order. A->Z
BEGINMENUITEM
KEY L
MENUCOMMAND 78
DISPLAYSTRING [L]ist File In This Area
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 84
----------------------------------------------------------------------
Optional Data:
Description:
View archive
BEGINMENUITEM
KEY V
MENUCOMMAND 84
DISPLAYSTRING [V]iew Archive contents
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 85
----------------------------------------------------------------------
Optional Data:
Description:
Download file(s) - asks for file name(s)
46
BEGINMENUITEM
KEY D
MENUCOMMAND 85
DISPLAYSTRING [D]ownload file(s)
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 86 Ex. R,86,[R]ules Download,c:\bbs\rules.txt,0
----------------------------------------------------------------------
Optional Data: filename
Description:
Download file contained in data field. This will only work for
remote callers
BEGINMENUITEM
KEY R
MENUCOMMAND 86
DISPLAYSTRING [R]ules Download
DISPLAYCOLOR 0
DATAOPTION rules.txt
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 90
----------------------------------------------------------------------
Optional Data:
Description:
Upload file(s) - Asks for file names, unless the 'upload blind'
bit is turned on for the file area and blind uploading is possible
with the users current protocol. (blind uploading means the
transfer comes first, with the file names and descriptions
determined afterwards)
BEGINMENUITEM
KEY U
MENUCOMMAND 90
DISPLAYSTRING [U]pload files
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 91
----------------------------------------------------------------------
Optional Data:
Description:
Upload specific file. (file in data field)
BEGINMENUITEM
KEY U
MENUCOMMAND 91
DISPLAYSTRING [U]pload picture
DISPLAYCOLOR 0
DATAOPTION pic.gif
MINSEC1 30
MINSEC2 30
ENDMENUITEM
47
----------------------------------------------------------------------
Menu Type: 100
----------------------------------------------------------------------
Optional Data:
Description:
OR user attributes 1 with number in data field
----------------------------------------------------------------------
Menu Type: 101
----------------------------------------------------------------------
Optional Data:
Description:
AND user attributes 1 with number in data field
----------------------------------------------------------------------
Menu Type: 102
----------------------------------------------------------------------
Optional Data:
Description:
OR user attributes 2 with number in data field
----------------------------------------------------------------------
Menu Type: 103
----------------------------------------------------------------------
Optional Data:
Description:
AND user attributes 2 with number in data field
----------------------------------------------------------------------
Menu Type: 104
----------------------------------------------------------------------
Optional Data:
Description:
OR user flags 1 with number in data field
----------------------------------------------------------------------
Menu Type: 105
----------------------------------------------------------------------
Optional Data:
Description:
AND user flags 1 with number in data field
----------------------------------------------------------------------
Menu Type: 106
----------------------------------------------------------------------
Optional Data:
Description:
OR user flags 2 with number in data field
----------------------------------------------------------------------
Menu Type: 107
----------------------------------------------------------------------
Optional Data:
Description:
AND user flags 2 with number in data field
----------------------------------------------------------------------
Menu Type: 110
----------------------------------------------------------------------
Optional Data: Character of Protocol
Description:
Set user file transfer protocol to letter contained in data
field
48
BEGINMENUITEM
KEY X
MENUCOMMAND 110
DISPLAYSTRING [X]modem
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 111
----------------------------------------------------------------------
Optional Data: Number/Letter of Computer Type
Description:
Set user computer type to number in data field (number is
index into 'Computers' file)
BEGINMENUITEM
KEY I
MENUCOMMAND 111
DISPLAYSTRING [C]hange to IBM
DISPLAYCOLOR 0
DATAOPTION 1
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 119
----------------------------------------------------------------------
Optional Data:
Description:
Read msgs from current newest message in TAGGED areas ONLY.
BEGINMENUITEM
KEY N
MENUCOMMAND 119
DISPLAYSTRING [N]ew Messages
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 120
----------------------------------------------------------------------
Optional Data:
Description:
Read messages, stop at each TAGGED area only.
BEGINMENUITEM
KEY N
MENUCOMMAND 120
DISPLAYSTRING [N]ew Messages
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
49
----------------------------------------------------------------------
Menu Type: 121
----------------------------------------------------------------------
Optional Data: Message Base
Description:
QuickScan message (to, from, subject) in TAGGED areas.
You may also put data in the item data field. This data is the
message base to read from. It also switches the users current
message area to that area.
So if you had "Headline New" in the item data field for any
of those menu items, it would switch to the "Headline News" message
area, and then prompt the users to read the messages there.
BEGINMENUITEM
KEY Q
MENUCOMMAND 121
DISPLAYSTRING [Q]uickscan Messages
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 122
----------------------------------------------------------------------
Optional Data: Menu Name
Description:
Scan message headers in TAGGED areas.
You may also put data in the item data field. This data is the
message base to read from. It also switches the users current
message area to that area.
So if you had "Headline New" in the item data field for any
of those menu items, it would switch to the "Headline News" message
area, and then prompt the users to read the messages there.
BEGINMENUITEM
KEY S
MENUCOMMAND 17
DISPLAYSTRING [S]can Messages
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 130
----------------------------------------------------------------------
Optional Data:
Description:
Change address (address line 1, lines 2 and 3 if those bits
are set in BBS flags.
BEGINMENUITEM
KEY A
MENUCOMMAND 130
DISPLAYSTRING [A]ddress change
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
50
----------------------------------------------------------------------
Menu Type: 131
----------------------------------------------------------------------
Optional Data:
Description:
Change ANSI color flag
BEGINMENUITEM
KEY 1
MENUCOMMAND 131
DISPLAYSTRING [1]ANSI Color
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 132
----------------------------------------------------------------------
Optional Data:
Description:
Change high ASCII (chars 128-255) flag
BEGINMENUITEM
KEY 2
MENUCOMMAND 132
DISPLAYSTRING [2]Use High Ascii
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 133
----------------------------------------------------------------------
Optional Data:
Description:
Change cold input flag (not hot key)
BEGINMENUITEM
KEY O
MENUCOMMAND 133
DISPLAYSTRING hot keys [O]ff
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 134
----------------------------------------------------------------------
Optional Data:
Description:
Change screen length
BEGINMENUITEM
KEY S
MENUCOMMAND 134
DISPLAYSTRING [S]creen length
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
51
----------------------------------------------------------------------
Menu Type: 135
----------------------------------------------------------------------
Optional Data:
Description:
Change pause flag
BEGINMENUITEM
KEY M
MENUCOMMAND 135
DISPLAYSTRING [M]ore prompt
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 136
----------------------------------------------------------------------
Optional Data: NONE
Description:
Change handle
BEGINMENUITEM
KEY A
MENUCOMMAND 136
DISPLAYSTRING [A]lias
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 137
----------------------------------------------------------------------
Optional Data:
Description:
Change password
BEGINMENUITEM
KEY P
MENUCOMMAND 137
DISPLAYSTRING [P]assword
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 138
----------------------------------------------------------------------
Optional Data:
Description:
Change screen width
BEGINMENUITEM
KEY W
MENUCOMMAND 138
DISPLAYSTRING [W]idth of screen
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
52
----------------------------------------------------------------------
Menu Type: 139 Ex. 0,139,Change Phone,,0
----------------------------------------------------------------------
Optional Data:
Description:
Change phone number(s) (home phone. data, business and fax
phones if these bits are set in the BBS flags)
BEGINMENUITEM
KEY P
MENUCOMMAND 139
DISPLAYSTRING [P]hone number
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 140 Ex. E,140,Interest,,0
----------------------------------------------------------------------
Optional Data:
Description:
Change interests
BEGINMENUITEM
KEY
MENUCOMMAND 140
DISPLAYSTRING [I]nterests
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 141
----------------------------------------------------------------------
Optional Data:
Description:
Change information to be shown to other users
BEGINMENUITEM
KEY S
MENUCOMMAND 141
DISPLAYSTRING [S]how user info?
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 142
----------------------------------------------------------------------
Optional Data:
Description:
Change expert mode
BEGINMENUITEM
KEY E
MENUCOMMAND 142
DISPLAYSTRING [E]xpert menus
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
53
----------------------------------------------------------------------
Menu Type: 144
----------------------------------------------------------------------
Optional Data:
Description:
Change ANSI cursor movement flag
BEGINMENUITEM
KEY U
MENUCOMMAND 144
DISPLAYSTRING [A]nsi movement
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 145 Ex. E,145,Edit Flags,,0
----------------------------------------------------------------------
Optional Data:
Description:
Changes protocol, new msgs flag, new files flag, limit file
list flag, see news flag, ask download flag, user available
flag and last but certainly not least EBCDIC conversion flag.
BEGINMENUITEM
KEY E
MENUCOMMAND 145
DISPLAYSTRING [E]dit user flags
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 146
----------------------------------------------------------------------
Optional Data:
Description:
Change file transfer protocol
BEGINMENUITEM
KEY P
MENUCOMMAND 146
DISPLAYSTRING File Transfer [P]rotocol
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 147
----------------------------------------------------------------------
Optional Data:
Description:
Change new message at logon flag
BEGINMENUITEM
KEY S
MENUCOMMAND 147
DISPLAYSTRING [S]how new msgs at logon
DISPLAYCOLOR 0
54
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 148 Ex. N,148,Toggle New Files At Login,,0
----------------------------------------------------------------------
Optional Data:
Description:
Change new files search at logon
BEGINMENUITEM
KEY N
MENUCOMMAND 148
DISPLAYSTRING [N]ew files at logon
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 149
----------------------------------------------------------------------
Optional Data:
Description:
Change limit file list flag
BEGINMENUITEM
KEY L
MENUCOMMAND 149
DISPLAYSTRING [L]imit file list
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 150 Ex. N,150,Toggle News,,0
----------------------------------------------------------------------
Optional Data:
Description:
Change see misc. news
BEGINMENUITEM
KEY N
MENUCOMMAND 150
DISPLAYSTRING [N]ews Toggle
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 151
----------------------------------------------------------------------
Optional Data:
Description:
Change ask download
BEGINMENUITEM
KEY A
MENUCOMMAND 90
DISPLAYSTRING [A]sk download
DISPLAYCOLOR 0
55
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 152
----------------------------------------------------------------------
Optional Data:
Description:
Change user available for chat flag
BEGINMENUITEM
KEY A
MENUCOMMAND 152
DISPLAYSTRING [A]vailable for chat
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 154
----------------------------------------------------------------------
Optional Data:
Description:
Change full screen editor flag
BEGINMENUITEM
KEY 8
MENUCOMMAND 154
DISPLAYSTRING [8]Full Screen Editor
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 155
----------------------------------------------------------------------
Optional Data:
Description:
Change mail export type
BEGINMENUITEM
KEY X
MENUCOMMAND 155
DISPLAYSTRING [X]port mail type
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 156
----------------------------------------------------------------------
Optional Data:
Description:
Set birthday (should be used from NewUser.Menu ONLY)
If the user is too young or too old , this will _end_ the
current BBS session!!
56
BEGINMENUITEM
KEY B
MENUCOMMAND 156
DISPLAYSTRING [B]irthday
DISPLAYCOLOR 0
MINSEC1 10
MINSEC2 10
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 157
----------------------------------------------------------------------
Optional Data:
Description:
Change clear screen
BEGINMENUITEM
KEY C
MENUCOMMAND 157
DISPLAYSTRING [C]lear screen
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 158
----------------------------------------------------------------------
Optional Data:
Description:
Change computer type
BEGINMENUITEM
KEY S
MENUCOMMAND 158
DISPLAYSTRING [S]et computer type
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 159
----------------------------------------------------------------------
Optional Data:
Description:
Change gender (should be used from NewUser.Menu ONLY)
Use sparingly.
BEGINMENUITEM
KEY G
MENUCOMMAND 159
DISPLAYSTRING [G]ender
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 161 Ex. A,161,Change to Avatar,,0
----------------------------------------------------------------------
Optional Data:
Description:
Change to Avatar
57
BEGINMENUITEM
KEY A
MENUCOMMAND 161
DISPLAYSTRING [A]vatar graphics
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 162
----------------------------------------------------------------------
Optional Data:
Description:
Change ANSI-TE2
BEGINMENUITEM
KEY T
MENUCOMMAND 162
DISPLAYSTRING ANSI-[T]E2
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 163
----------------------------------------------------------------------
Optional Data:
Description:
Change 8 dot 3 names (will convert long names down to 8.3)
BEGINMENUITEM
KEY S
MENUCOMMAND 163
DISPLAYSTRING [S]hort file names
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 164
----------------------------------------------------------------------
Optional Data:
Description:
Change Avatar/Ansi Flags
BEGINMENUITEM
KEY C
MENUCOMMAND 164
DISPLAYSTRING [C]hange Avatar/Ansi
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 165
----------------------------------------------------------------------
Optional Data:
Description:
Change View off-line mail status
58
BEGINMENUITEM
KEY V
MENUCOMMAND 165
DISPLAYSTRING [V]iew mail while packing?
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 166
----------------------------------------------------------------------
Optional Data:
Description:
Change default archiver
BEGINMENUITEM
KEY S
MENUCOMMAND 166
DISPLAYSTRING [S]et default archiver
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 167
----------------------------------------------------------------------
Optional Data:
Description:
Deposit Bank Time
BEGINMENUITEM
KEY D
MENUCOMMAND 167
DISPLAYSTRING [D]eposit time
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 168
----------------------------------------------------------------------
Optional Data:
Description:
Withdraw Bank Time
BEGINMENUITEM
KEY W
MENUCOMMAND 168
DISPLAYSTRING [W]ithdraw time
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 190
----------------------------------------------------------------------
Optional Data: Menu Name
59
Description:
Toggle a bit in user attributes 1 (bit can be 1 thru 32)
bit number is in data field
----------------------------------------------------------------------
Menu Type: 191
----------------------------------------------------------------------
Optional Data: Menu Name
Description:
Toggle a bit in user attributes 2 (bit can be 1 thru 32)
bit number is in data field
----------------------------------------------------------------------
Menu Type: 192
----------------------------------------------------------------------
Optional Data: Menu Name
Description:
Toggle a bit in user flags 1 (bit can be 1 thru 32)
bit number is in data field
----------------------------------------------------------------------
Menu Type: 193
----------------------------------------------------------------------
Optional Data: Menu Name
Description:
Toggle a bit in user flags 2 (bit can be 1 thru 32)
bit number is in data field
----------------------------------------------------------------------
Menu Type: 200
----------------------------------------------------------------------
Optional Data: 'To Name';'Subject';'AreaNum';'1' or '0';Node Number
Description:
Write message, no optional data needed. If no optional data is used
the message is treated as a normal message entry option. Public or
Private messages may be posted via this method, uses the options
set for the area you are posting in.
The force to data requires a name and will take a optional subject
if a ; is placed between the name and subject.
To Name : Name of person to force message to
Subject : Subject to force message to be pasted as
AreaNum : Message area number to post message in
1 or 0 : Return to message area user was in when they posted the
message or stay in the new messages area. 1 - Return 0
- Stay
Node Number: Node number to force message to if it is NetMail, this
must be a full 5-D Address. i.e. 1:18/210.0@Fidonet
BEGINMENUITEM
KEY F
MENUCOMMAND 200
DISPLAYSTRING [T]his is a command
DISPLAYCOLOR 0
DATAOPTION Sysop;Comment from {U0;2;1
MINSEC1 30
MINSEC2 30
ENDMENUITEM
BEGINMENUITEM
KEY C
MENUCOMMAND 200
DISPLAYSTRING Comment
DISPLAYCOLOR 0
DATAOPTION ;;2;1;1:368/210.0@fidonet
ENDMENUITEM
60
In this example it would go to Area 2, Post a Message to Sysop, with
the Subject of 'Comment from 'User Real Name' and after the message
was saved or aborted it would return to the message area the user
was in when this command was executed.
All data on this command is optional. If you do not specify a name
to force the message to it will then try the name in the force to
field in the message configuration, if that doesn't exist it will
default to Sysop.
----------------------------------------------------------------------
Menu Type: 201
----------------------------------------------------------------------
Optional Data: 'Force To Name';'Subject';'AreaNum';'1' or '0';Node
Number
Description:
Write message to user name specified in area 'forced to' data and
marks the message as private.
The force to data requires a name and will take a optional subject
if a ; is placed between the name and subject.
To Name : Name of person to force message to
Subject : Subject to force message to be pasted as
AreaNum : Message area number to post message in
1 or 0 : Return to message area user was in when they posted the
message or stay in the new messages area. 1 - Return 0
- Stay
Node Number: Node number to force message to if it is NetMail, this
must be a full 5-D Address. i.e. 1:18/210.0@Fidonet
BEGINMENUITEM
KEY C
MENUCOMMAND 201
DISPLAYSTRING Comment to the Sysop
DISPLAYCOLOR 0
DATAOPTION Sysop;Comment from {U0;10;1
ENDMENUITEM
BEGINMENUITEM
KEY C
MENUCOMMAND 201
DISPLAYSTRING Comment
DISPLAYCOLOR 0
DATAOPTION ;;2;1;1:368/210.0@fidonet
ENDMENUITEM
In this example it would go to Area 2, Post a Message to Sysop, with
the Subject of 'Comment from 'User Real Name' and after the message
was saved or aborted it would return to the message area the user
was in when this command was executed.
All data on this command is optional. If you do not specify a name
to force the message to it will then try the name in the force to
field in the message configuration, if that doesn't exist it will
default to Sysop.
----------------------------------------------------------------------
Menu Type: 300
----------------------------------------------------------------------
Optional Data: 'Prompt/Question'
Description:
Get string input from user and temporarily store it. Prompt is in
data field.
61
BEGINMENUITEM
KEY N
MENUCOMMAND 300
DISPLAYSTRING [N]ame
DISPLAYCOLOR 0
DATAOPTION What is your name?
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 303
----------------------------------------------------------------------
Optional Data: Menu Name
Description:
temporarily stores text in data field as last user input.
BEGINMENUITEM
KEY N
MENUCOMMAND 303
DISPLAYSTRING Name
DISPLAYCOLOR 0
DATAOPTION joe
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 400
----------------------------------------------------------------------
Optional Data: 'Chat Area'
Description:
Internode chat, with Area defined in data field
BEGINMENUITEM
KEY C
MENUCOMMAND 400
DISPLAYSTRING [C]hat Area
DISPLAYCOLOR 0
DATAOPTION Chat Area
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 601
----------------------------------------------------------------------
Optional Data:
Description:
Toggles ANSI color flag
BEGINMENUITEM
KEY T
MENUCOMMAND 601
DISPLAYSTRING [T]oggle ANSI Color
DISPLAYCOLOR 0
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 602
----------------------------------------------------------------------
Optional Data: NONE
Description:
Toggles high ASCII flag
62
BEGINMENUITEM
KEY T
MENUCOMMAND 602
DISPLAYSTRING [T]oggle high ascii
DISPLAYCOLOR 0
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 603
----------------------------------------------------------------------
Optional Data: NONE
Description:
Toggles MORE prompt flag
BEGINMENUITEM
KEY T
MENUCOMMAND 603
DISPLAYSTRING [T]oggle MORE prompt
DISPLAYCOLOR 0
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 604
----------------------------------------------------------------------
Optional Data: NONE
Description:
Toggles clear screen flag
BEGINMENUITEM
KEY T
MENUCOMMAND 604
DISPLAYSTRING [T]oggle Screen Clear
DISPLAYCOLOR 0
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 605
----------------------------------------------------------------------
Optional Data: NONE
Description:
Toggles cold input flag
BEGINMENUITEM
KEY T
MENUCOMMAND 605
DISPLAYSTRING [T]oggle Hot Keys
DISPLAYCOLOR 0
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 606
----------------------------------------------------------------------
Optional Data: NONE
Description:
Toggles show address flag
BEGINMENUITEM
KEY S
MENUCOMMAND 606
DISPLAYSTRING [S]how Address?
DISPLAYCOLOR 0
ENDMENUITEM
63
----------------------------------------------------------------------
Menu Type: 607
----------------------------------------------------------------------
Optional Data: NONE
Description:
Toggles show phone flag
BEGINMENUITEM
KEY S
MENUCOMMAND 607
DISPLAYSTRING [S]how Phone?
DISPLAYCOLOR 0
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 608
----------------------------------------------------------------------
Optional Data: NONE
Description:
Toggles show real name flag
BEGINMENUITEM
KEY T
MENUCOMMAND 608
DISPLAYSTRING [T]oggle Real name
DISPLAYCOLOR 0
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 609
----------------------------------------------------------------------
Optional Data: NONE
Description:
Toggles no kill flag
BEGINMENUITEM
KEY T
MENUCOMMAND 609
DISPLAYSTRING [T]oggle No Kill
DISPLAYCOLOR 0
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 610
----------------------------------------------------------------------
Optional Data: NONE
Description:
Toggle deleted flag
BEGINMENUITEM
KEY T
MENUCOMMAND 610
DISPLAYSTRING [T]oggle Deleted
DISPLAYCOLOR 0
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 611
----------------------------------------------------------------------
Optional Data: NONE
Description:
Toggle expert flag
64
BEGINMENUITEM
KEY T
MENUCOMMAND 601
DISPLAYSTRING [T]oggle Expert Mode
DISPLAYCOLOR 0
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 612
----------------------------------------------------------------------
Optional Data: NONE
Description:
Toggle twit flag
BEGINMENUITEM
KEY T
MENUCOMMAND 612
DISPLAYSTRING [T]oggle Twit Flag
DISPLAYCOLOR 0
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 613 Ex. N,613,Toggle New Files,,0
----------------------------------------------------------------------
Optional Data: NONE
Description:
Toggle new files flag
BEGINMENUITEM
KEY N
MENUCOMMAND 613
DISPLAYSTRING [N]ew Files toggle
DISPLAYCOLOR 0
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 614 Ex. N,614,Toggle New Msgs,,0
----------------------------------------------------------------------
Optional Data: NONE
Description:
Toggle new messages flag
BEGINMENUITEM
KEY N
MENUCOMMAND 614
DISPLAYSTRING [N]ew Messages toggle
DISPLAYCOLOR 0
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 615
----------------------------------------------------------------------
Optional Data: NONE
Description:
Toggle download new messages flag
----------------------------------------------------------------------
Menu Type: 616
----------------------------------------------------------------------
Optional Data: NONE
Description:
Toggle download new file list flag
----------------------------------------------------------------------
Menu Type: 617
----------------------------------------------------------------------
Optional Data: NONE
Description:
Toggle see misc. news flag
----------------------------------------------------------------------
Menu Type: 618
----------------------------------------------------------------------
Optional Data: NONE
Description:
Toggles ask download flag
----------------------------------------------------------------------
Menu Type: 619
----------------------------------------------------------------------
Optional Data: NONE
Description:
Toggles novice flag
----------------------------------------------------------------------
Menu Type: 620
----------------------------------------------------------------------
Optional Data: NONE
Description:
Toggles point mail only flag
----------------------------------------------------------------------
Menu Type: 622
----------------------------------------------------------------------
Optional Data: NONE
Description:
Toggles locked out flag
----------------------------------------------------------------------
Menu Type: 623
----------------------------------------------------------------------
Optional Data: NONE
Description:
Toggles chat availability
----------------------------------------------------------------------
Menu Type: 624
----------------------------------------------------------------------
Optional Data: NONE
Description:
Toggles protected from user list display
----------------------------------------------------------------------
Menu Type: 625
----------------------------------------------------------------------
Optional Data: NONE
Description:
Toggles misc. news display
----------------------------------------------------------------------
Menu Type: 626
----------------------------------------------------------------------
Optional Data: NONE
Description:
Toggles limit file list to current area
----------------------------------------------------------------------
Menu Type: 628
----------------------------------------------------------------------
Optional Data: NONE
Description:
Toggles verified flag
65
----------------------------------------------------------------------
Menu Type: 629
----------------------------------------------------------------------
Optional Data: NONE
Description:
Toggles ANSI TE2 graphics
----------------------------------------------------------------------
Menu Type: 630
----------------------------------------------------------------------
Optional Data: NONE
Description:
Toggles RIP graphics
----------------------------------------------------------------------
Menu Type: 631
----------------------------------------------------------------------
Optional Data: NONE
Description:
Toggle AVATAR graphics
----------------------------------------------------------------------
Menu Type: 632
----------------------------------------------------------------------
Optional Data: NONE
Description:
Toggle off-line mail monitoring
----------------------------------------------------------------------
Menu Type: 640
----------------------------------------------------------------------
Optional Data: NONE
Description:
Pack up and download off-line mail
----------------------------------------------------------------------
Menu Type: 655
----------------------------------------------------------------------
Optional Data: NONE
Description:
Change archiver
----------------------------------------------------------------------
Menu Type: 656
----------------------------------------------------------------------
Optional Data: NONE
Description:
Edit file transfer list (tagged files)
----------------------------------------------------------------------
Menu Type: 700
----------------------------------------------------------------------
Optional Data: NONE
Description:
Tag all areas for off-line mail
----------------------------------------------------------------------
Menu Type: 701
----------------------------------------------------------------------
Optional Data: NONE
Description:
Untag all areas for off-line mail
66
----------------------------------------------------------------------
Menu Type: 702
----------------------------------------------------------------------
Optional Data: NONE
Description:
Toggle a specific area for off-line mail and to support TAGGED
menu commands 119, 120, 121, 122
----------------------------------------------------------------------
Menu Type: 703
----------------------------------------------------------------------
Optional Data: NONE
Description:
Change type of mail export (Text, QWK, Fido, etc)
----------------------------------------------------------------------
Menu Type: 704
----------------------------------------------------------------------
Optional Data: NONE
Description:
Message area Last message Read Editing
BEGINMENUITEM
KEY L
MENUCOMMAND 704
DISPLAYSTRING [L]MR Editing
DISPLAYCOLOR 0
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 800 Ex. D,800,[D]rop to Dos\r\n,cmd.exe,0
----------------------------------------------------------------------
Optional Data: Program Name (CMD.EXE)
Description:
Run OS/2 type door. Pgm must use stdin/stdout for
I/O... and allow itself to be killed. Data field
contains door to run.
BEGINMENUITEM
KEY D
MENUCOMMAND 800
DISPLAYSTRING [D]rop to dos\r\n
DISPLAYCOLOR 0
DATAOPTION cmd.exe
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 801 Ex. E,801,,cmd.exe /c lord.bat {LN {H0,0,,,5
----------------------------------------------------------------------
Optional Data: Program Name/Batch File (CMD.EXE /c Batch.Cmd)
Description:
Spawn a separate session. data field contains door to run.
Can be used for any door program that accesses the com port
in a more traditional (and complicated) fashion. (includes
DOS doors)
This is the one to use for 99% of all DOORS!
BEGINMENUITEM
KEY E
MENUCOMMAND 801
DISPLAYSTRING [L]ORD
DISPLAYCOLOR 0
DATAOPTION CMD.EXE /c lord.cmd {LN
ENDMENUITEM
67
----------------------------------------------------------------------
Menu Type: 802 Ex. U,802,[U]ser Editor\r\n,SysEditR.Exe,0
----------------------------------------------------------------------
Optional Data: Program Name/Batch File (CMD.EXE /c Batch.Cmd)
Description:
Run OS/2 type door. (same as 800 but assumes a program which
is more friendly to having its I/O. redirected thru pipes
to the com port.)
BEGINMENUITEM
KEY A
MENUCOMMAND 802
DISPLAYCOLOR 0
DATAOPTION advent.exe {LN
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 803
----------------------------------------------------------------------
Optional Data: Program Name/Batch File (CMD.EXE /c Batch.Cmd)
Description:
The type 803 door works exactly like a type 802 except that it
sets and allows you to set several 32-bit semaphores giving
you and the BBS more interaction.
They are as follows.
\SEM32\ChildDone\Line#
\SEM32\Carrier\Line#
\SEM32\TimeTick\Line#
We will activate the \SEM32\Carrier\Line# when a user drops
carrier. This then gives you 10 minutes to complete your
task and return to the BBS software. If you issue
a \SEM32\ChildDone\Line# and exit we will handle everything
normally.
Next the TimeTick warns you of when the user has 3, 2 and 1
minute remaining. We will issue it three times.
These should help make your programs more aware of Adept and
Adept more aware of them.
BEGINMENUITEM
KEY A
MENUCOMMAND 803
DISPLAYCOLOR 0
DATAOPTION advent.exe {LN
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 810
----------------------------------------------------------------------
Optional Data: Program Name/Batch File (CMD.EXE /c Batch.Cmd)
Description:
Spawn a separate session. Inherits Adepts environment.
(same as 801.. ahem..)
BEGINMENUITEM
KEY E
MENUCOMMAND 810
DISPLAYSTRING [L]ORD
DISPLAYCOLOR 0
DATAOPTION CMD.EXE /c lord.cmd {LN
ENDMENUITEM
68
----------------------------------------------------------------------
Menu Type: 811
----------------------------------------------------------------------
Optional Data: Program Name/Batch File (CMD.EXE /c Batch.Cmd)
Description:
Spawn a separate session. Inherits OS/2's default environment.
BEGINMENUITEM
KEY E
MENUCOMMAND 811
DISPLAYSTRING [P]oker
DISPLAYCOLOR 0
DATAOPTION CMD.EXE /c Poker.srx
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 815
----------------------------------------------------------------------
Optional Data: Program Name/Batch File (CMD.EXE /c Batch.Cmd)
Description:
See 801 and 810. Session is in foreground (default is
background)
BEGINMENUITEM
KEY E
MENUCOMMAND 815
DISPLAYSTRING [L]ORD
DISPLAYCOLOR 0
DATAOPTION CMD.EXE /c lord.cmd {LN
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 900
----------------------------------------------------------------------
Optional Data:
Description:
Personal Mail Check
BEGINMENUITEM
KEY C
MENUCOMMAND 900
DISPLAYSTRING [C]heck Mail
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 950
----------------------------------------------------------------------
Optional Data:
Description:
Shuts down the BBS! This is EXTREMELY powerful! It will cause
the BBS to shut itself down after the last user logs off.
BEGINMENUITEM
KEY S
MENUCOMMAND 950
DISPLAYSTRING [S]hut down BBS
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
69
----------------------------------------------------------------------
Menu Type: 999
----------------------------------------------------------------------
Optional Data: 'Area Number'
Description:
Logoff with option to leave a message to the sysop. The area
number that you want the message to be placed in should be entered
in the data field.
After the user has entered the message, it will display
'Goodbye.Asc' and then prompt #202.
BEGINMENUITEM
KEY L
MENUCOMMAND 999
DISPLAYSTRING [L]ogoff
DISPLAYCOLOR 0
DATAOPTION 10
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 1000 Ex. ~,1000,Goodbye/Logoff,,0
----------------------------------------------------------------------
Optional Data: NONE
Description:
Log use off, displays Goodbye.Asc and Prompt #202 (language.text)
before hanging up.
BEGINMENUITEM
KEY L
MENUCOMMAND 1000
DISPLAYSTRING [L]ogoff
DISPLAYCOLOR 0
MINSEC1 0
MINSEC2 0
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 1001
----------------------------------------------------------------------
Optional Data: NONE
Description:
Instant log off.
BEGINMENUITEM
KEY ~
MENUCOMMAND 1001
DISPLAYSTRING [F]ast Logoff
DISPLAYCOLOR 0
DATAOPTION 10
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
Menu Type: 1002
----------------------------------------------------------------------
Optional Data: NONE
Description:
Log off and Re-Login without hanging up the line.
70
BEGINMENUITEM
KEY R
MENUCOMMAND 1002
DISPLAYSTRING [R]e-Login
DISPLAYCOLOR 0
DATAOPTION 10
MINSEC1 30
MINSEC2 30
ENDMENUITEM
----------------------------------------------------------------------
AdeptXBBS Multi Language Support:
The AdeptXBBS software includes Multi-Lingual support. The following is
a example 'Languages' file. The Language file is the configuration
file for the multilingual support. The languages file has three
fields delimited by a comma. The first parameter is the name of the
language, the second is the Identifier for the language and the third
is the root dir in which that language resides.
You can have up to 36 languages. If the need arises we can expand
this number, but in order to assure that the mailer is still
operational on all levels we decided to limit it to the keys 1-0 and
A - Z.
-- BEGIN: 'Languages' file ---
English ,ENG,D:\Adept\
French ,FRN,D:\Adept\French\
Spanish ,SPN,D:\Adept\Spanish\
Finish ,FIN,D:\Adept\Finish\
-- END: 'Languages' file ---
If the user chooses French the BBS will look in the following
directories for the language support files.
\Adept\French\System
\Adept\French\Menus
\Adept\French\Text
You should place all the files that you would normally put in the
71
\Adept\System, \Adept\Menus and \Adept\Text sub-dir in the language
directories corresponding to the language they refer to.
If a user chooses a language and the BBS cannot find the Language.text
file in the \Adept\Languagename\System sub-dir it will default to the
language.text in the \Adept\System dir.
Language.text - Contains some clues on how to edit the Language.Text
file.
Language.Text Configuration:
Language.Text is the prompts file, but with the low ASCII chars
eliminated as control chars. (the need to edit them is eliminated) In
place of the single ASCII chars are 5 character strings which take
their place.
The strings are in the format: [xxx] the 'xxx's denote a type of
command for that line of text. There are currently 23 possible
command types:
[Str] - Means to return the string to the calling subroutine.
(normally string is sent to user)
When a line has [Str] in it, DO NOT remove it. If the line
does not have [Str] in it, DO NOT add it.
[Log] - Means log this line to the log screen.
[Loc] - Means show this line locally only.
[Ans] - Means show this line to users with ANSI cursor movement on.
[Asc] - Means this line is for ASCII users only. (ANSI is not on)
[Run] - Means try to execute the rexx program specified on this
line.
[Fil] - Means show this file.
NOT IMPLEMENTED
[Cmd] - Means send this line to CMD.EXE.
NOT IMPLEMENTED
[Clr] - Means show this line to users that have color on.
[Pse] - Means pause at this line.
[8bt] - Means this line contains high ASCII characters.
[Cls] - Means clear the screen.
[Exp] - Means show this line to experts only.
[Twt] - Means show this line to Twits only.
[Nov] - Means show this line to novice users only.
[Hlp] - Means show help file.
NOT IMPLEMENTED
[Mnu] - Means execute this menu.
NOT IMPLEMENTED
[Mta] - Means that META commands should be converted
(i.e. {M1, {UG, {W1, etc.)
[Cvt] - Means that literals should be converted
(i.e. \x1B, \r, \n, etc.)
[Rem] - Means send this line to the remote end only.
[Slg] - Write to screen log. (this may be backwards with [Log])
[Sts] - Means write this to Adept screen in status window.
[Wav] - Means play a .WAV sound file. The filename follows the [Wav]
command. Wildcards OK. MMPM/2 should be installed.
------------------
72
Execution Commands
------------------
[Str], [Log], [Loc], [Run], [Fil], [Cmd], [Hlp], [Mnu], [Rem], [Slg],
[Sts],[Wav]
Should be the last command before the text on the line, because they
cause that command to be executed immediately.
----------------
Special Commands
----------------
[Pse], [Cls]
Any text following these commands is ignored.
----------------
Convert Commands
----------------
[Mta], [Cvt] Will change the text on the line.
[Mta] will cause all 'smart text' commands such as {M0, {U3, {L1 to
be converted to the proper text. (See the Meta Variables section)
[Cvt] will cause string 'literals' to be converted. A string literal
is the same as a 'C' string literal such as \x1B (ESCape), \r (return),
\n (new line) If a line doesn't have 'smart text' or string 'literals'
then you don't need to use these commands, because they can slow the
display of the text down.
-------------
Flag Commands
-------------
[Ans], [Asc], [Clr], [8bt], [Exp], [Twt], [Nov]
determine who should see the line. ANSI is considered different than
ANSI color because some terminals support ANSI cursor movement, but
not color.
If you have an ANSI line it would probably be okay to turn on
highlighting "[1m" because highlighting is usually supported even on
dumb terminals.
You can put the flag commands in front of the Execution, Special or
Convert commands.
You can use a combination of these flags to determine which lines are
sent to the user. Any order is okay and a user has to match all flags
on a line to be shown that line. If the line were:
[Ans][Clr][8bt]Hello there!
Then the user would have to have ANSI, Color and high ASCII chars
turned on to see that line!
---------------------
In 'Language.Text' you use the format: #xx to start a line of text.
Language.Text is the file you edit. When Adept runs and sees a new
Language.Text file, it will compile Language.Text into the file
Language.Text.Compiled then Adept will create an index file called
Language.Text.Index
73
Adept User Help Topics: (and when they are used)
(not all topics are currently found in Adept.Help)
Setup File -- Setting access to files areas.
List FileAreas -- List command when setting up file area
access.
All FileAreas -- All areas command when setting up file
areas.
FileSetup Prompted -- when asking for access to each file area
one at a time.
FileSetup Lorange -- When setting Low file area of a range.
FileSetup Hirange -- When setting High file area of a range.
FileSetup RangePick -- When setting range.
FileArea Inquire -- When inquiring which areas.
Setup Msg -- When setting access to message areas.
List MsgAreas -- List command when setting up message areas.
All MsgAreas -- All areas command when setting up message
areas.
MsgSetup Prompted -- When asking for access to each message
area one at a time.
MsgSetup Lorange -- When setting Low message area of a range.
MsgSetup Hirange -- When setting High message area of a range.
MsgSetup RangePick -- When setting range.
MsgArea Inquire -- When inquiring which areas.
Calendar -- When asking for which calendar to display.
ChatHelp -- When in Internode chat
Chat Reason -- When requesting a SysOp chat
Edit You -- When selecting options in 'EditYou'
function.
User Interests -- When getting one line of user interests.
User Address -- When setting one of three user address
strings.
User city -- When setting city
User state -- When setting state/province.
User Zipcode -- When setting ZIP/postal code.
User Phone -- When setting one of four phone numbers.
User Password -- When setting password.
User Handle -- When setting handle.
User Showaddress -- When setting show address flag.
User Showphone -- When setting show phone # flag.
User Showreal -- When setting show real name flag.
User ANSI -- When setting ANSI (movement) flag.
User Color -- When setting ANSI color flag.
User HighASCII -- When setting High ASCII flag.
User Gender -- When setting gender.
User Novice -- When setting novice flag.
User Expert -- When setting expert flag.
User FSE -- When setting full screen editor flag.
Download Mail -- When asking whether a user wants to
download mail packet.
User Rolling -- When setting rolling prompts flag.
User Mailtype -- When setting mail packet type.
74
User Pause -- When setting more prompt flag.
User Hot -- When setting hot keys flag.
User Clear -- When setting clear screen flag.
User Width -- When setting screen width.
User Length -- When setting screen length.
User Computer -- When setting computer type.
User Protocol -- When setting file transfer protocol.
User Archiver -- When setting default archiver.
User Newmsgs -- When setting read new msgs flag.
User Newfiles -- When setting view new files flag.
User TypeFList -- When setting type of file list.
User Shownews -- When setting show news flag.
User AsktoDL -- When setting ask download flag.
User Available -- When setting Internode chat flag.
User EBCDIC -- When setting EBCDIC conversion flag.
Download1 -- When asking for files to download.
Upload1 -- When asking for which file to be uploaded.
Tag1 -- When asking for files to be tagged.
I1_Msgnum -- When asking which message number to read.
Lib Mask -- When asking for a library area file mask.
Lib Read -- When reading library file.
Lib Search -- When searching for library file.
Text delete -- When deleting lines in text editor.
Are You Sure -- When at a 'are you sure' prompt.
Text edit -- When editing a line in the text editor.
Text insert -- When inserting a line in the text editor.
Msg To -- When setting who message is to.
Msg From -- When changing message from.
Msg Subj -- When changing message subject.
Autodownload --
NewFileDate -- When asking for a new files date.
User Search -- When searching user list.
User Name -- When user enters name at login.
Are You You? -- When name not in user records.
Password -- When asking for password at login.
Scan All Mail? -- When asking if we should scan all mail.
MsgArea Selection -- When changing message areas.
FileArea Selection -- When changing file areas.
LibArea Selection -- When changing library areas.
Area Password -- When asking for an area password.
Text Title -- When getting name when creating a text
file.
Abort Text -- When aborting creation of text file.
Menu Password -- When asking for menu password.
File Matchstring -- When asking for a file search string.
I1_Logoff Msg -- When asking for logoff comment.
User Birthmonth -- When asking for user birthday month.
User Birthday -- When asking for user birthday day.
User Birthyear -- When asking for birthday year.
Quote Reply -- When asking if we are quoting in reply.
Msg Locate--from -- When locating message with from field.
Msg Locate--to -- When locating message with to field.
Msg Locate--subj -- When locating message by subject.
Msg Locate--body -- When locating message by contents.
75
Msg Locate--all -- When locating message by all of the above.
Scan Page -- Scan messages more prompt.
Search String -- When getting a search string (for showing
text files)
File Read -- When show any text files in a directory.
View Arc -- When viewing archive
View Arc Member -- When viewing archive member.
Msg Destaddr -- When asking for address to send message
to (NetMail)
Addr Correct -- Is address correct?
Msg Private -- Is message private?
Msg Anonymous -- Is message anonymous?
76
______________________________
_ _ AdeptXBBS META VARIABLES _
______________________________
Adept supports the use of META variables in all text files. Meta
variables are used to display a value, known by the system, to the user.
Meta variables are in the format {xx where 'xx' is the META variable.
(at a future date, the '{' (brace) may be a configurable value)
Current supported META variables:
System
S0 -- Number of calls to the BBS
S1 -- Minimum age of user allowed on BBS
S2 -- Maximum age of user allowed on BBS
S3 -- Maximum users on BBS
S4 -- Maximum mail connection attempts
S5 -- Maximum times a user can page the SysOp
S6 -- Name of BBS
S7 -- SysOp name
S8 -- Current BPS rate
SA -- Status (As shown in Pm Status box)
SB -- Modem Connect String (String returned by modem on
successfull Connect)
SC -- BBS Uptime in DDHHMMSS format
SD -- OS/2 Boot Time in YYMMDDHHMMSS format
SE -- Current OS/2 Uptime in DDHHMMSS format
User
U0 -- Name
U1 -- Handle
U2 -- Address
U3 -- Home phone
U4 -- Interests (one line of text)
U5 -- Computer type # (line # of computer in 'Computers'
file)
U6 -- Computer type string
U7 -- ID number
U8 -- Point ID number
U9 -- Birthdate yy/mm/dd
UA -- Credit
UB -- Minute limit
UC -- Time used so far today (on previous calls)
UD -- Time allowed per day
UE -- Number of times called
UF -- Uploaded # of files
UG -- Downloaded # of files
UH -- Uploaded # KBytes
UI -- Downloaded # KBytes
UJ -- Uploaded # KBytes today
UK -- Downloaded # KBytes today
UL -- Max upload KBytes per day
UM -- Max download KBytes per day
UN -- Security Level 1
UO -- Security Level 2
UP -- Flags 1 (bit flags as integer)
UQ -- Flags 2 (bit flags as integer)
UR -- Attributes 1 (bit flags as integer)
US -- Attributes 2 (bit flags as integer)
UT -- Screen length
UU -- Screen width
UV -- Last msg area #
77
UW -- Last file area #
UX -- Protocol (letter)
UY -- Archiver (letter)
UZ -- Time per call (outdated??)
V3 -- Age
V4 -- Graphics (1=on 0=off)
V5 -- Group in
V6 -- Number of messages posted
V7 -- Uploaded # of files (9 chars long) (all right
justified)
V8 -- Downloaded # of files (9 chars long)
V9 -- Uploaded # KBytes (9 chars long)
VA -- Downloaded # KBytes (9 chars long)
VB -- Uploaded # KBytes today (9 chars long)
VC -- Downloaded # KBytes today (9 chars long)
VD -- Max upload KBytes per day (9 chars long)
VE -- Max download KBytes per day (9 chars long)
VF -- Name (36 chars, left justified)
VG -- Handle (36 chars, left justified)
VH -- MaxBankTime
VI -- Time in Bank
VJ -- Calls Today
VK -- Total Minutes used since first call
VL -- Users First Name (Ie Tom)
VM -- Last User on this Node (Ie Thomas Jefferson)
O7 -- Banked time (in minutes)
O9 -- City
P1 -- Address (2 of 3)
P2 -- State
P3 -- Zip/Postal code
P4 -- Data phone
P5 -- Fax phone
PF -- Offline mail packing method (QWK, Fido, Bluewave etc.)
PI -- Scan for new mail at logon (ON/OFF)
PJ -- Scan for New Files at logon (ON/OFF)
Q9 -- File transfer protocol name or 'None'
QA -- Archiver name or 'none'
QB -- Max mail packet size in bytes
(the below display the text ON or OFF according to the flag in
the user record)
O1 -- ANSI
O2 -- Color
O3 -- High ASCII
O4 -- No More prompts
O5 -- No Clear screens
O6 -- Cold input (i.e. not hot keys)
P6 -- Avatar
P7 -- ANSI/TE2
PM -- Displays a YES/NO/MORE prompt
PN -- Turns off non-stop display
PO -- Turns on non-stop display
P9 -- Available for Internode chat
PE -- Monitoring Mail (ON/OFF)
Message Area (some variables are based on text found in Language.Text)
M0 -- Name of area
M1 -- # msgs in current area
78
M2 -- Last msg read in current area
M3 -- # of msg area
M4 -- Last msg read + 1
M5 -- Description
M6 -- Name of area (12 characters long, left justified)
M7 -- # msgs in area (5 chars long, right justified)
M8 -- last msg read (5 chars long, right justified)
M9 -- # of msg area (5 chars long, left justified)
MA -- Last msg read + 1 (5 chars long, left justified)
MB -- Description (48 chars long, left justified)
MC -- Current msg number
MD -- Msg from (based on text #361)
ME -- Msg date
MF -- Msg to (based on text #363)
MG -- Msg private flag (based on text #352)
MH -- Msg read flag (text #353 if read, #354 if not read)
MI -- Msg deleted flag (text #355)
MJ -- Msg NetMail (text #356)
MK -- Msg EchoMail (text #357)
ML -- Msg keep (text #358)
MM -- Msg w/ file (text #370)
MN -- Msg request flag (text #371)
MO -- Msg update request flag (text #372)
MP -- Msg Kill/sent flag (text #373)
MQ -- Msg crashmail flag (text #374)
MR -- Msg sent flag (text #375)
MS -- Msg host flag (text #376)
MT -- Msg hold flag (text #377)
MU -- Msg anonymous (text #378)
MV -- Msg originating zone (text #379)
MW -- Msg originating net (text #380)
MX -- Msg originating node (text #381)
MY -- Msg originating point (text #382)
A2 -- Msg destination zone (text #383)
A3 -- Msg destination net (text #384)
A4 -- Msg destination node (text #385)
A5 -- Msg destination point (text #386)
A6 -- Msg subject header (text #387 if request, text #388 or
#389 if not)
A7 -- Msg subject (text #390)
A8 -- Msg subject (20 characters long, left justified)
A9 -- Msg from (20 characters long, left justified)
AA -- Msg to (20 characters long, left justified)
AB -- Msg # (5 characters long, left justified)
DA -- Who the message was to
DB -- The Message Subject
DC -- Area name message was posted to
DD -- Node number of receipient
DE -- Area number the message was posted to
Q1 -- Msg area name (M0???)
Q2 -- Msg area number (M3??)
Q3 -- Msg area description (M5??)
Q4 -- # msgs in area (M1??)
Q7 -- Prints '*' if last read is less than current # of msgs.
' ' if not
Q8 -- Prints '+' if current area is tagged for offline mail.
' ' if not
QC -- Time/date msg was received (24 characters)
QD -- # times msg read (5 characters, right justified)
79
File area
A0 -- Area name
A1 -- Area number
R0 -- Filearea description
Library area
L0 -- Area name
L1 -- Area number
Time (user time)
T0 -- Minutes left in session
T1 -- ????
T2 -- Seconds left in session
Date (current date/time)
D0 -- Month abbreviated (Jan, Feb, etc)
D1 -- Day abbreviated (Mon, Tue, etc)
D2 -- Year
D3 -- Month number
D4 -- Day number
D5 -- Month name (complete name)
D6 -- Day name (complete name)
D7 -- Time (HH:MM:SS)
D8 -- Date/Time (Dayofweek Month Dayofmonth HH:MM:SS Year)
_or_ (Mon Jan 1 00:00:01 1996)
Input
I0 -- Copies in last user input
Download / Upload stats
K0 -- Uploaded bytes (total)
K1 -- Downloaded bytes (total)
K2 -- Uploaded bytes (today)
K3 -- Downloaded bytes (today)
K4 -- Max upload bytes per day
K5 -- Max download bytes per day
K6 -- Download bytes left today
K7 -- Download KBytes left today
K9 -- Upload bytes left today
KA -- Upload KBytes left today
Misc
H0 -- Com port handle
LN -- Line number (1, 2, 3, etc)
PA -- cycle thru color scheme and return next ANSI color in
cycle
PB -- Press any key to continue prompt
PC -- Press [ENTER] prompt
PD -- Pause for 1/2 second
PG -- Pause for 1/30 second
PH -- Spinning cursor (return next cycle.. use with PA)
Q5 -- Add 1 to number of lines printed
Q6 -- Add 1 to number of lines printed
QF -- User storage??
QG -- Turns on U2_MONITOR_MAIL?
(All ANSI commands will be set to blank if user doesn't have
color turned on)
Foreground ANSI Color
F1 -- Black
F2 -- Dark blue
80
F3 -- Dark green
F4 -- Dark cyan
F5 -- Dark red
F6 -- Dark magenta
F7 -- Brown
F8 -- Light gray
F9 -- Dark gray
FA -- Blue
FB -- Green
FC -- Cyan
FD -- Red
FE -- Magenta
FF -- Yellow
FG -- White
Background ANSI color
B1 -- Black
B2 -- Dark blue
B3 -- Dark green
B4 -- Dark cyan
B5 -- Dark red
B6 -- Dark magenta
B7 -- Brown
B8 -- Light gray
Other ANSI
CL -- Clear to end of line
CS -- Clear screen
QE -- Last ANSI color
81
______________________________
_ _ EVENT FILE CONFIGURATION _
______________________________
Events are interruptions during the normal BBS day. Such interruptions
might include polling for mail or door maintenance. The events.text.x
(x being the node number) file is located in the \Adept\Events
directory. Below is the format of that file:
Comments begin with semicolons and can be on any line.
Any text after a semicolon is ignored.
Keywords:
EVENTBEGIN -- Begins description of an event.
EVENTEND -- Ends description of an event.
NAME -- Name of the event
START -- Starting time of event in HH:MM format.
END -- (temporary) Ending time in HH:MM format.
LENGTH -- Length of event in minutes
COMMAND -- Command to spawn at beginning of event. If this is
a .CMD file, that file should be located in the
\Adept directory.
FLAGS -- Flags to control event
1 = Forced (event must run)
2 = Recv Mail only (doesn't call out)
4 = Send mail only (doesn't answer ring)
8 = No File REQuests
16 = BBS calls allowed
32 = Send Crash Mail
64 = Send Crash Mail no matter what the cost is
128 = Cost must be less than MAXCOST
256 = Cost must be more than MINCOST
512 = Cost must equal MAXCOST
1024 = Wait for COMMAND to finish before continuing
2048 = Clear outbound call counters at beginning of event
4096 = Reboot OS/2 at beginning of event
8192 = Reserved (not currently used)
16384 = Close com port before running COMMAND and open upon
return
32768 = Shutdown Adept at beginning of event
*** Add numbers together to combine flags.
ex: 24 = 8 (no FREQs) and 16 (BBS calls OK)
MINCOST -- Minimum cost (see flags)
MAXCOST -- Maximum cost
DAYOFWK -- Day of week to execute
1 = Sunday
2 = Monday
4 = Tuesday
8 = Wednesday
16 = Thursday
32 = Friday
64 = Saturday
256 = Weekdays (Mon. thru Fri.)
512 = Weekends (Sat. -n- Sun.)
82
1024 = All Days
Add numbers to combine days
DAYOFMONTH -- Day of month to execute. Use w/ MONTH
MONTH -- Month to execute. Use w/ DAYOFMONTH
Using the above combo can cause execution to happen
on a certain day of a certain month. If day of month
is set and month is not set (0) then it event will
occur on that day every month.
CALLTIME -- Time (in seconds) between calls
MAXBAD -- Max bad calls
MAXTRIES -- Maximum connects allowed
An Example Events.text.1 file:
EVENTBEGIN
START 00:00
END 00:05
DAYOFWK 1024
FLAGS 2048
COMMAND Cmd.Exe /c Bbsmaint.Cmd
NAME Daily Midnight Maintenance
MINCOST 0
MAXCOST 10000
MAXBAD 10
MAXTRIES 200
EVENTEND
EVENTBEGIN
START 00:06
END 04:59
DAYOFWK 1024
FLAGS 80
COMMAND Cmd.Exe /c Mail.Cmd
NAME My regular BBS mail event
MINCOST 0
MAXCOST 10000
MAXBAD 10
MAXTRIES 200
EVENTEND
EVENTBEGIN
START 05:00
END 06:00
DAYOFWK 1024
FLAGS 10
COMMAND Cmd.Exe /c Poll.cmd
NAME Poll for mail
MINCOST 0
MAXCOST 10000
MAXBAD 10
MAXTRIES 200
EVENTEND
EVENTBEGIN
START 06:01
END 23:59
DAYOFWK 1024
FLAGS 80
83
COMMAND Cmd.Exe /c Mail.Cmd
MINCOST 0
MAXCOST 10000
MAXBAD 10
MAXTRIES 200
EVENTEND
Questions And Answers About the Events File:
Q. Must the event items cover a 24 hour contiguous period? The
docs do not state this.
A. If a time is not covered during a 24 hour period Adept will do
nothing. It won't have any current flags or parameters to work
with, so it would be best to cover the 24 hour period.
Q. What is the purpose of the length entry? What happens if it's value
does not equal [ EVENTEND - EVENTBEGIN ]?
When should it not be equal to [ EVENTEND - EVENTBEGIN ]?
A. LENGTH was originally used, and is only there for compatibility.
START and END actually determine the length of the event.
Q. MIN/MAXCOST - What are these? How do you determine what the value
should be?
A. It determines the minimum, and the maximum amount of money per unit
of time before a call will be placed to a remote system. For
instance, if you specified that a system costs 20 cents a minute to
call, and you have the max cost set at 15 cents, Adept will not call
that system. But if your max cost is set at 30, then the call would
be placed. You set the cost of the call with the nodelist compiler.
Q. It looks like some entries for EVENT FILE CONFIGURATION are not
required. Which are required and which are not?
A. If an entry in the event is '0' then it is not necessary to save it
in the event file. 0 is default. The entries are not saved to
conserve some disk space. Also some entries have other defaults if
not included. These are:
Maxbadcalls=5 Maxtries=30 AveTimeBetweenCalls=1800
Q. Is the value for the unstated seconds part of START is 00 and 59 for
END. Is this a correct assumption? Are they both 00 and 00?
A. Events are granular by the minute, not by the second. You can put
seconds in there, but they will be ignored for the START and END
So in the context of the question. They are both 00.
84
Q. If CALLTIME is not specified what algorithm does the program use?
A. Default is 1800 seconds, or 30 minutes.
Q. In what situation is value zero valid for the FLAG and DAYOFWK
fields?
A. If the DAYOFWK is set to 0, then event won't occur. If FLAGS is set
to 0, then the mailer would work OK (very plain operation but it
should work) , but BBS calls would not be allowed.
Q. Explain what a flag value 1024 means.
A. 1024 means wait until the COMMAND is done executing before resuming
operation of Adept. Because we are using OS/2 we don't need to wait
for the command to end before we resume Adept. But if there is a
reason to wait for the COMMAND to finish, then set this flag.
Q. If I set a short BEGIN-END time then I could presume that the next
event will not execute until the .CMD in this event is completed.
Suppose the .CMD completes in 2 minutes, does ADEPT move on to the
next event or wait doing nothing until the EVENTEND time?
A. Adept will do nothing until it reaches the next event start time.
Q. What are the Call/Try counters and when should they be reset?
A. These record how many attempts have been made to call a system, and
how many of those calls were bad. Adept uses them to see if it
should stop trying after so many attempts at reaching the system.
Most systems would reset these each day. But that is up to the
SysOp. If you set MAX attempt to 30 then Adept would attempt to call
any system up to 30 times. If it reaches the system, has a
successful session, it will no longer attempt to call them. If you
reset the call counters every day, then Adept would try up to 30
times a day to call a system. If you reset the counters every 3
days, Adept would try 30 times over a 3 day period (usually all
those calls would be on the first day, if the average times between
calls is short).
85
_________________________________________
_ _ uNuke - AdeptXBBS USER BASE UTILITY _
_________________________________________
uNuke is a user data base packing program for AdeptXBBS. This also
means that it will adjust last read pointers for all message areas
based on the newly packed user file. In other words, if a user record
is purged, then their last read pointers for each area must also be
purged.
How to install uNuke:
Copy uNuke.Exe to the AdeptXBBS directory. uNuke expects to operated
from that directory.
Command Line Parameters:
Parameters in brackets [] are optional.
uNuke [/Exx] [/Dxx or /Mxx] [/Q] [/K]
/Exx Set the 'Exempt' security level. Where 'xx' is the
security level. Any user with a security level greater
than or equal to this number will not be purged from the
user data base. They are considered 'Exempt' from purging.
/Dxx Set the maximum number of inactive DAYS.
/Mxx Set the maximum number of inactive MONTHS.
Where 'xx' is the number of inactive days or months.
You should use either days or months, but not both. If you
try to use both, the months figure will be ignored.
/K uNuke will kill backups of the user data base when it has
completed the packing process.
/Q Quiet Mode. The speed of uNuke will be approx. 500%
faster! Though your mileage may vary. In normal mode, the
user names are shown on the screen with a message showing
whether or not they have been purged.
/R Renumbers user ids starting with 1.
/? Gives a quick list of parameters.
---------
Examples:
---------
uNuke /Q /D60 /E6
uNuke will operate in quiet mode, will purge users not on in over 60
days and users level 6 and above will not be purged.
uNuke /M6
uNuke will purge users not on in 6 months.
NOTE: All command line parameters are optional.
Environment Variables:
uNuke will look for the existence of two environment variables to aid
in its adjustment of the last read pointers. By default, uNuke will
look in the \Adept\Message_Bases directory for all *.LMR files. You
can change the default behavior with the following environment
variables:
XMSG -- Changes the default message base location from
\Adept\Message_Bases to whatever you specify.
Example: SET XMSG=H:\Adept\MsgBases
86
XXMSG -- Tells uNuke to also search these directories (yes, plural is
okay) for more *.LMR files. Separate multiple directories
with semicolons.
Example: SET XXMSG=H:\Adept\Messages;M:\Message_Bases;
Frequently Asked Questions Concerning uNuke:
What would cause uNuke to purge a user record?
----------------------------------------------
uNuke will purge a user record if any of the following conditions are
met:
1. Blank 'Name' field. If there is no name, then uNuke will purge the
record. Being that uNuke is a 'C' program, a NULL as the first
character of the 'Name' field would be considered a blank name.
2. 'U_DELETED' bit is set in the user record 'Attribs' field.
If this flag is set, then the user record is purged. The only time
this will NOT work, is if the U_NOKILL bit flag is also set.
'U_NOKILL' means that this user record should never be purged.
3. If 'Maximum Inactive Days' is set and they have not been on in
that time. They will NOT be purged if they are exempt or the
U_NOKILL flag is set.
4. If 'Maximum Inactive Months' is set and they have not been on in
that time. They will NOT be purged if they are exempt or the
U_NOKILL flag is set.
What will keep uNuke from purging a user record?
------------------------------------------------
1. If the 'U_NOKILL' bit is set in the 'Attribs' field. This will
prevent uNuke from purging the record in nearly all cases. The
_only_ exception is if the user 'Name' field is blank.
2. Their security level meets or beats the 'Exempt' security
parameter. If the user 'Security1' field is greater than or equal
to the 'Exempt' parameter, then they will not be purged, unless the
'U_DELETED' bit is set in the 'Attribs' field.
3. The user will not be purged if they have been on more recently than
the inactivity parameter.
When should I run uNuke?
------------------------
uNuke tends to rearrange user records at will, therefore, AdeptXBBS
should be taken off-line when you decide to pack a user data base.
AdeptXBBS expects to place a user record back where it found it. If
you tried purging while AdeptXBBS is on-line, you risk corruption of
the user data base.
87
___________________________
_ _ INTERNET CAPABILITIES _
___________________________
AdeptXBBS offers seamless integration into the Internet for E-MAIL,
TELNET, FTP, FINGER, NEWSGROUPS, IRC, mailing list services and others
as they come along. At the current moment the Internet package for
AdeptXBBS includes:
NNTP Import of newsgroups
NNTP Posting
E-Mail SMTP
Telnet
IRC
FTP
AdeptXBBS's Internet modules requires a TCP/IP stack in order to
function properly.
What is Telnet?
---------------
Telnet is a function that you can use to access other computers on
the Internet like a BBS or a weather server or game. Once you have
opened a Telnet connection to another computer you can access the
files and run programs on the remote computer. To telnet to a
computer, you need to know it's name. This can either be in words,
like "snoval.com" or as a numeric address, like 204.157.220.247
What is FTP?
------------
FTP stands for file transfer protocol. FTP allows you to copy files
from a remote computer to your local host. Thousands of sites provide
anonymous FTP service, allowing you to download everything from FAQ's
& online books, to updates an drivers for operating systems, to public
domain and shareware utilities and games etc.etc.
What is Usenet and Newsgroups?
------------------------------
Usenet is the set of people who exchange articles tagged with one or
more universally-recognized labels, called "newsgroups" (or "groups"
for short). If the above definition of Usenet sounds vague, that's
because it is! It is almost impossible to generalize over all Usenet
sites in any non-trivial way. Usenet encompasses government agencies,
large universities, high schools, businesses of all sizes,home computers
of all descriptions, etc, etc.
88
What is IRC?
------------
IRC stands for "Internet Relay Chat" a service where users can "talk"
via typing to people around the world. IRC is a multi-user chat
system, where people convene on "channels" (a virtual place, usually
with a topic of conversation) to talk in groups, or privately.
How to setup Node(s) for Telnet & Sockets:
To enable the Internet features, go to the Config->BBS->Internet
Options menus. Telnet Server and Socket Server support is supported
in this version. Set the ports you want the servers to sit on. For
Telnet the default in port 23, for Sockets we default to 6530.
+--------------------------------------------------------------------+
:v: Internet Facilities :
+--------------------------------------------------------------------+
: :
: Your Full Domain: :
: :
: [X] Telnet Server Port Number: 23 Status: ACTIVE :
: [X] Socket Server Port Number: 6530 Status: ACTIVE :
: :
: [ ] SMTP Send SMTP Server: :
: :
: Message Area # to place incomming E-Mail: :
: :
: [ ] NNTP Client Status: INACTIVE :
: :
: Server: Poll (In Minutes): :
: :
: Available Groups (0) Active Groups :
: +------------------------------+ +-------------------------------+ :
: : : : : :
: : : : : :
: : : : : :
: : : : : :
: : : : : :
: +------------------------------+ +-------------------------------+ :
: +------------------------+ +-------------------------+ :
: : ADD >> : : << REMOVE : :
: +------------------------+ +-------------------------+ :
: +----------+ +-----------+ +----------+ :
: : OK : : Cancel : : Help : :
: +----------+ +-----------+ +----------+ :
+--------------------------------------------------------------------+
After setting up the Telnet and Socket options you can then pick one
of the nodes to be the recipient of the Telnet and Socket connects.
To do this, go to the Config->Active Node->General Settings and check
the Telnet and the Socket options, also check the Use Telnet Timers
box. Any node can support BOTH a Telnet and a Socket connect!
89
+--------------------------------------------------------------------+
: Line # General Settings :
+--------------------------------------------------------------------+
: :
: +-- Basic Modem Strings ------------------+ +------------------+ :
: : : : Logon Security : :
: : Answer : ATA| : +------------------+ :
: : Init : v~^ATZ| : :
: : Dial Pref : v~^ATDT : [X]Use Telnet Timers :
: : Dial Suf. : | : [X]No Carrier Detection:
: : : [X]Use Socket Port :
: +-----------------------------------------+ [X]Use Telnet Port :
: [ ]ATO on DATA :
: +-----------------------------------------+ :
: : Port Name : Ring Response : RING : :
: : Answer on Ring : 1 : :
: +-----------------------------------------+ :
: :
: +-- BPS Rates ------------------------------+ :
: : : :
: : Initial BPS : 57600 Mn. BPS : 1200 : +--------------+ :
: : Mn. Mail BPS : 1200 Mn. Call BPS : 2400 : | Fax Setup | :
: : Mx. Call BPS : 57600 [X]Locked : +--------------+ :
: : : :
: +-------------------------------------------+ :
: :
: +----+ +------+ +----+ :
: : OK : :Cancel: :Help: :
: +----+ +------+ +----+ :
+--------------------------------------------------------------------+
If you ONLY want to allow telnet or sockets on that node check the one
you wish to allow. But it is recommended that you allow both. It is
also recommended that you keep the sockets on port 6530 so that anyone
using a terminal that supports sockets can 'call' your BBS. Sockets are
faster and cleaner then Telnet. They are also binary by nature and will
allow clean file transfers, something not always possible over telnet.
Note: The Initial BPS & Mx. Call BPS is usually the same as the locked
speed of the Dialup modem that is connected to the Internet, and
the Port name (Type in: \Pipe\anyname_you_want).
After setting up the telnet/socket node(s) you have to save the new
settings with the ShutDown On/Off-Hook option in the Pull Down Menus
How to setup NNTP Support:
This is the first version of the BBS software with native Internet
Newsgroup Support via NNTP! Messages posted in the Internet Newsgroups
areas from either QWK or Bluewave will also be exported to the net via
NNTP. There are no special configuration options needed, no special
changes need to be made to your QWK or Bluewave utilities.
90
Note: For the NNTP Posting option a Domainname (or Static #IP depending
on the Internet providers configuration) is required. If you do
not have a dedicated SLIP or PPP line, you can still receive
newsgroups though.
To setup NNTP go to the Config->BBS->Internet Options and fill in your
domainname and name of your NNTP News Server. This name will be
specified by your Internet provider. For example, your domainname might
be: adeptbbs.hsonline.net and your NNTP News Server might be:
news.hsonline.net
Next click on The NNTP Client
option checkbox. (It is best that you already have your SLIP, PPP or
TCP/IP network running with the news server available). The BBS should
be able to handle it if you are not connected to the to the NET.
+--------------------------------------------------------------------+
:v: Internet Facilities :
+--------------------------------------------------------------------+
: :
: Your Full Domain: my.full.domainname :
: :
: [X] Telnet Server Port Number: 23 Status: ACTIVE :
: [X] Socket Server Port Number: 6530 Status: ACTIVE :
: :
: [ ] SMTP Send SMTP Server: :
: :
: Message Area # to place incomming E-Mail: :
: :
: [X] NNTP Client Status: ACTIVE :
: :
: Server: my.news.server Poll (In Minutes): 2 :
: :
: Available Groups (0) Active Groups :
: +------------------------------+ +-------------------------------+ :
: : : : : :
: : : : : :
: : : : : :
: : : : : :
: : : : : :
: +------------------------------+ +-------------------------------+ :
: +------------------------+ +-------------------------+ :
: : ADD >> : : << REMOVE : :
: +------------------------+ +-------------------------+ :
: +----------+ +-----------+ +----------+ :
: : OK : : Cancel : : Help : :
: +----------+ +-----------+ +----------+ :
+--------------------------------------------------------------------+
*** If you do not have a dedicated SLIP or PPP line, you can still
receive newsgroups. First, shut down Adept. Then connect to your
SLIP or PPP account. After you are connected, start up Adept with
91
the /NOINIT 1 (assuming that line 1 is the line that we don't want
to use because it's in use by the Internet Dialer). Then go into the
CONFIG->BBS->Internet Options and fill in your NNTP News Server.
This name will be specified by your Internet provider.
Next click on the NNTP Client option checkbox. When the software
first connects to the server it will pull down the available
newsgroup list. This could take 5-10 minutes. After you have the
list it is recommended that you then decide what newsgroups you
would like to get.
There will be a file in the \Adept\Usenet dir called Available.List
that will also contain a list of available newsgroups. You can pick
the newsgroups to turn on and off from the Config->BBS->Internet
Options Menu.
Note: Before turning on the newgroups that you want to recieve,
FIRST configure and add the newsgroups via the pulldown menu's
Edit->Message Areas and make sure that you turn the option
[X] UseNet for the newsgroup areas ON.
If you look at the \adept\system\message_areas file, a newsgroup
should be configured similar to this:
AREABEGIN
NAME Icomp.lang.rexx
NUMBER 76
DESC [UseNet] comp.lang.rexx
ORIGIN AdeptSoft Support BBS
USENET comp.lang.rexx
FLAGS 8456
ADDRESS 1:231/1320.0@Fidonet
AREAEND
AREABEGIN
NAME Icomp.sys.palmtops
NUMBER 77
DESC [UseNet] comp.sys.palmtops
ORIGIN AdeptSoft Support BBS
USENET comp.sys.palmtops
FLAGS 8456
ADDRESS 1:231/1320.0@Fidonet
AREAEND
The option Poll (in minutes) is the time in minutes between each
time that AdeptXBBS will Poll the NNTP Server to check if there is
new mail in the enabled Newsgroups.
After setting up the NNTP options you have to save the new settings
with the ShutDown On/Off-Hook option in the Pull Down Menus
92
How To Setup E-mail (SMTP) Support:
The steps to getting SMTP working are precise. One missing step is
going to stop it from working properly.
1) Edit your config.sys.
Add the following line to your config.sys (note the lack of
trailing backslash):
SET ADEPT=<DRIVE>:\ADEPT
For example: SET ADEPT=D:\ADEPT
While you're at it, you should add in the following lines as
well for good measure... (edit to your liking)
SET TZ=MST7MDT
SET XMSG=D:\ADEPT\Message_Bases
SET XOUTBOUND=D:\ADEPT\MAILER\OUTBOUND_MAIL
SET XNODELIST=D:\ADEPT\MAILER\NODELIST
2) Create imail directory.
Make a subdirectory under \adept called imail
For example: md D:\ADEPT\imail
4) Create another .cmd file or add to the end of the .cmd file that
you use to start your PPP / SLIP connection. This .cmd should run
SENDMAIL after your have established your PPP / SLIP connection.
ex:
sendmail -bd -q30m -d
5) Edit the sample Sendmail.cf included with Adept.
You must use an editor that does NOT expand Tabs. Either use E
or Qedit. Do NOT use Tedit! Do NOT change anything that you
don't know about. There are volumes of books on sendmail if you
feel the urge to edit other areas of this. When you reach that
point, you won't need to be reading this anymore.
6) At line numbers 34 and 35, change to match your host name. For
example:
# My host name
Dwadeptbbs
Cwadeptbbs
7) At line number 59, change to match your domain name. For example:
# My domain name
DDhsonline.net
93
8) Search for all instances of :\ (colon black slash) and confirm
that the correct path is set for your system.
9) At line number 457, change the paths to match your system. The
SMTP2ADEPT.EXE is located in your \adept directory by default.
10) Determine where to put the SENDMAIL.CF
From a cmd prompt type SET ETC
Copy your edited sendmail.cf to this directory.
11) Create Adept Internet Email Message Area
Now you need to create an area for receiving and sending SMTP
Mail. From the EDIT->MESSAGE BASES pulldown menu, ADD a new
message area for your internet email. Check the Internet E-Mail,
Force Private, No Origin Lines, and Compression boxes. Be sure
to click on Save Changes. (Do NOT try to combine your Private and
Internet E-Mail into one message base)
Then click on CONFIG->BBS->INTERNET OPTIONS pulldown menu. Click
on the SMTP Send box after you have entered your SMTP Server Name
and specified which message base is to be the internet E-Mail
base. Confirm that "Your Full Domain" is correct and accurate
as well.
The next page shows an example of what the Internet Options
screen should look like.
94
+--------------------------------------------------------------------+
:v: Internet Facilities :
+--------------------------------------------------------------------+
: :
: Your Full Domain: adeptbbs.hsonline.net :
: :
: [X] Telnet Server Port Number: 23 Status: ACTIVE :
: [X] Socket Server Port Number: 6530 Status: ACTIVE :
: :
: [X] SMTP Send SMTP Server: mail.hsonline.net :
: :
: Message Area # to place incomming E-Mail: 5 :
: :
: [X] NNTP Client Status: ACTIVE :
: :
: Server: news.hsonline.net Poll (In Minutes): 15 :
: :
: Available Groups (0) Active Groups :
: +------------------------------+ +-------------------------------+ :
: : : : : :
: : : : : :
: : : : : :
: : : : : :
: : : : : :
: +------------------------------+ +-------------------------------+ :
: +------------------------+ +-------------------------+ :
: : ADD >> : : << REMOVE : :
: +------------------------+ +-------------------------+ :
: +----------+ +-----------+ +----------+ :
: : OK : : Cancel : : Help : :
: +----------+ +-----------+ +----------+ :
+--------------------------------------------------------------------+
12) Shutdown Adept
Do not just close the program, do an orderly shutdown.
13) Reboot
Reboot your computer to make sure the config.sys changes take
effect, and run the BBS.
After you have connected to your Internet Provider, you
should now have SMTP up and running.
14) Notify your SMTP Provider
You may need to notify your SMTP provider to have him forward
your mail to your domain. Note, that the nature of SMTP is
that if you are not connected to the internet, mail may be
95
returned.
15) You can now send and receive internet e-mail.
The naming convention is either the users name or handle. All
mail addressed to your domain will be imported into the
Internet E-Mail area, but users will only be able to read that
mail which is addressed to either their name or handle. SMTP
outbound converts all spaces to periods, and does the reverse
on inbound to the board. So Julie Strietelmeier on the BBS
adeptbbs.hsonline.net will be converted to
Julie.Strietelmeier@adeptbbs.hsonline.net
Note that SMTP does NOT like periods in SMTP mail. It will
convert Steven P. Crandall to Steven.P..Crandall (note 2
periods after the P) Upon return mail, it will address it to
Steven P Crandall (note two spaces). Have the users change
their name/handle to remove the space to correct this problem.
If you don't have a way of testing your setup, you can send
a test e-mail to julies@hsonlinet.net , and I'll respond
quickly. Or you can telnet into snoval.com and send
yourself one.
How To Install IRC2 (Internet Relay Chat) Support:
In the directory \adept\menus there is a file located called
IRC2.Cmd
The sample AdeptXBBS menu's already contains a working Internet
menu, called Internet.Menu located in the \adept\menus directory.
The menu commandline for IRC is 'I, 11,[I]RC,irc2.cmd,0' (without
the quote marks). The Irc2.cmd is a working and ready to go Rexx
script with some IRC Servers listed in here.
If your located outside the U.S. it's advisable to edit this script
and replace the IRC servers with some servers that are located in
your own country or nearby, else there could be a long startup time
because of the lags on the Internet.
Use VMODEM with Adept and the Internet Module:
You may find that you would like to use Ray Gwinn's VMODEM with the
internet module. If you use VMODEM, you can then have your users play
door games over telnet connects. Without VMODEM, the will be unable to
do this.
To setup VMODEM, read the instructions that come with SIO. In Adept,
you set up the node as usual but instead of having INTERNET TIMING,
USE TELNET SOCKET, and USE SOCKET PORT boxes all checked, just check
the INTERNET TIMING box.
96
_____________________________
_ _ FILE AREA CONFIGURATION _
_____________________________
File Area Editor:
Accessed from Edit->File Areas...
+--+-----------------------------------------------------------+--+--+
: : File Area Editor : : :
+--+-----------------------------------------------------------+--+--+
: Name: Number: + Flags ----------------+ :
: : : :
: Desc: : x Free Downloads : :
: : x No Uploads : :
: Addr: : x No Downloads : :
: : x Down Back? : :
: DL Path: : x Up Back? : :
: : x Charge for Files : :
: UL Path: : x ULs Not Listable : :
: : x ULs Not Downloadable: :
: UL Time Back: FTP Name: : x No File List : :
: : x Common File List : :
: +----------------------+ : x Upload Blindly : :
: : File Area Security : : x Copy from Drive : :
: +----------------------+ : x No New File Scan : :
: +-----------+ +-----------+ +------------+ : :
: : Prev Area : : Next Area : : List Areas : : :
: +-----------+ +-----------+ +------------+------------------------ :
: +---------+ +---------+ +---------+ :
: : Add : : Insert : : Delete : +------------------+ :
: +---------+ +---------+ +---------+ : SAVE CHANGES : :
: +------+ +------+ +------------------+ :
: : Ok : : Help : :
: +------+ +------+ :
: Changes are *NOT* saved until you click on :
: <Save Changes> :
+--------------------------------------------------------------------+
Name : Place the name of the file area in this field.
Number: Place the # for this file area in this field.
Desc: This is where you can place the description of the file
area.
Addr: This field is not yet currently used, but will be used for
internal TIC processing at some point.
DL Path: This is the default path for files in the current area.
UL Path: This is the default path for uploads to the current
area.
Free Downloads : Check this box to make all downloads free in
this area.
97
No Uploads : Check this box to turn upload off for this area.
No Downloads : Turn off downloads for this area.
Down Back : Give back the users download time.
Up Back : Give back the users upload time.
FTP Name: In order to use Adepts Built in FTPD, each area should
have an FTP Name.
Charge for Files : This is not fully implemented but you will be
able to assign a cost on a per file basis to
be taken from the users credit.
ULs Not Listable : Uploads will not show up in file listing.
ULs Not Downloadable : Enabling this will make new uploads non-
downloadable.
No File List : N/A
Common File List : Default
Upload Blindly : If the user has Zmodem, Ymodem or Sealink
chosen it will let them upload the files before
asking them for a description.
Copy From Drive : Copy files from download path.
No New File Scan: When this is checked, this file area will
not be included in a new file scan.
File Area Security:
+--+-----------------------------------------------------------------+
: : Area Security - (Area Name) :
+--+-----------------------------------------------------------------+
: +---------+ +---------+ +---------+ :
: Password: Age: : OK : : Cancel : : Help : :
: +---------+ +---------+ +---------+ :
:+- Download Security ----------------------------------------------+:
:: Sec Level 1: Sec Level 2: ::
:: Flags 1 ::
:: x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x ::
:: Flags 2 ::
:: x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x ::
:: ::
:+------------------------------------------------------------------+:
:+- Upload Security ------------------------------------------------+:
:: Sec Level 1: Sec Level 2: ::
:: Flags 1 ::
:: x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x ::
:: Flags 2 ::
:: x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x ::
:: ::
:+------------------------------------------------------------------+:
98
:+- SysOp Security -------------------------------------------------+:
:: Sec Level 1: Sec Level 2: ::
:: Flags 1 ::
:: x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x ::
:: Flags 2 ::
:: x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x ::
:: ::
:+------------------------------------------------------------------+:
+--------------------------------------------------------------------+
Password : Password required to upload a file into this area.
Age: Minimum age required to upload or download in area.
Download Security:
Sec Level 1: Sec Level 2:
Set security level #1 & #2 to the minimum security level required
to Download from the current area. Mark the flags you will
require the user to have in order to download files in this area.
Both the flags and the security levels must pass in order to
download files.
Upload Security:
Sec Level 1: Sec Level 2:
Set security level #1 & #2 to the minimum security level required
to upload from the current area. Mark the flags you will require
the user to have in order to upload files in this area. Both the
flags and the security levels must pass in order to upload files.
SysOp Security:
Sec Level 1: Sec Level 2:
Set security level #1 & #2 to the minimum security level required
to gain access to the sysop functions in the current area. Mark
the flags you will require the user to have in order to gain
access to the sysop functions in this area. Both the flags and
the security levels must pass in order to use the sysop
functions.
SysOp functions in the file area are not completely finished.
But will include such options as setting costs for files. Set
Download paths. Set file passwords. Set individual file security
levels and flags.
File_Areas File Configuration:
Path and name of control file : \Adept\System\File_Areas
This is the file that Adept creates when you edit the file areas using
the pull-down menus. You can edit this file with a standard text editor.
AREABEGIN - This directive marks the beginning of a area definition
NAME - This defines the file area name
NUMBER - This defines the file area number
99
AGE - This defines the minimum age required to access the area
DESC - This is the description of this area
SEC1 - This is the minimum sec required to access this area
when compared with the users security level #1
SEC2 - This is the minimum sec required to access this area
when compared with the users security level #2
FLAGS1
FLAGS2
WSEC1 - This is the minimum sec required to upload files in
this area, this is compared with user sec level #1
WSEC2 - This is the minimum sec required to upload files in
this area, this is compared with user sec level #2
WFLAGS1
WFLAGS2
SSEC1 - This is the minimum sec required to access sysop
functions for this file area.
Compared with security level #1
SSEC2 - This is the minimum sec required to access sysop
functions for this file area.
Compared with security level #2
SFLAGS1
SFLAGS2
FLAGS
PASSWORD - Password required to access this file area.
MAXAGE - Maximum age of user to be able to access area
DLPATH - Download Path
ULPATH - Upload Path
COSTPERK - Cost Per K
AREAEND - This directive marks the end of a area definition
An Example File_Areas File:
AREABEGIN
NAME New Files
NUMBER 1
DESC ** UPLOAD New Files Here **
DLPATH D:\UPLOADS
ULPATH D:\UPLOADS
SSEC1 100
SSEC2 100
FLAGS 3105
AREAEND
AREABEGIN
NAME MIDI Files
NUMBER 2
DESC .MID Files
DLPATH D:\MIDI
ULPATH D:\UPLOADS
SSEC1 100
SSEC2 100
FLAGS 3105
AREAEND
AREABEGIN
NAME MOD Files
100
NUMBER 3
DESC .MOD and .S3M Files
DLPATH D:\MODS
ULPATH D:\UPLOADS
SSEC1 100
SSEC2 100
FLAGS 3105
AREAEND
AREABEGIN
NAME WAV Files
NUMBER 4
DESC .WAVs and .VOC Files
DLPATH D:\WAVS
ULPATH D:\UPLOADS
SSEC1 100
SSEC2 100
FLAGS 3105
AREAEND
AREABEGIN
NAME Adept
NUMBER 5
DESC Software / Info for use with Adept
DLPATH C:\ADEPTFIL
ULPATH D:\UPLOADS
SSEC1 100
SSEC2 100
FLAGS 3105
AREAEND
Adding Files To Your New Adept BBS:
To add files to your new bbs, you need to create the file areas using
the EDIT->FILE AREAS pulldown menu. Then actually create all the
directories on your hard drive and add the files to them. Then you
may either use BFSMAKE (explained later in this section) or another
file area editor. One such program is Fileed23.zip which is available
on the support bbs and the ftp site.
When a user uploads a file the following things occur in the following
order.
1. When the transfer completes the BBS software determines if the file
or files uploaded are known archives based on the information in the
Archivers file. If the file is an archive the following is done to that
file:
The BBS software searches your path for a file called TestUpload.Cmd.
If this file is found it executes the file with the following command
line parameters:
CMD.EXE /c TestUpload.Cmd <fullfilename> <line#> <handle> <filename>
<extension>
<fullfilename> - Complete path/filename
101
<line#> - Line number
<handle> - handle to open com port
<filename> - Plain file name, no path, no extension
<extension> - Just extension.. no '.'
This CMD file may test the upload in whatever manner it sees fit. For
example: unzip -t, virus scan.. both.. neither.. whatever.. It could
also move the file for safe keeping.. etc.
If file does NOT pass the test, there should be a file in the Adept
directory called <filename>.Error This tells Adept the file did not
pass the test.
2. If the file passes that test, then the DIZ extraction is attempted.
The command line is identical to the previous one.
CMD.EXE /c ExtractDIZ.Cmd <fullfilename> <line#> <handle> <filename>
<extension>
This CMD file just looks for a description of some kind. Could be a
FILE_ID.DIZ, .DOZ... DESC.SDI whatever the format.. If it finds a
description it should create a text file with the description in it
The filename is:
\Adept\System\Line#\<filename>.Description
If the software doesn't find this file, it will ask for a description.
3. There is also a conversion command file called Convertxxx.CMD Same
commandline where 'xxx' is the extension of the upload itself. If a
.ZIP file is uploaded, the software looks for ConvertZIP.Cmd
CMD.EXE /c ConvertZIP.Cmd <fullfilename> <line#> <handle> <filename>
<extension>
If the conversion takes place, a file should be created in the Adept
directory called <filename>.NewName It should contain just the
filename of the file. For instance, if a file went from FROOD.ARC to
FROOD.ZIP Then 'Frood.NewName' would be created and it would have a
single line:
FROOD.ZIP
The file should be in the same path as the original.
If ALL fails and the file is marked as BAD, the BBS will execute the
file BadUpload.CMD with the following command line parameters.
Ex: "BadUpload.CMD Node FileName_With_Path Filename File_Extention"
The BadUpload.CMD file can be used to 'move' bad uploads into a
storage area for the sysop to check at a later date.
Converting a Files.BBS to the Adept Filebase Format:
102
BFSMake:
AdeptXBBS does not support Files.BBS directly, but does provide a tool
to import them into the AdeptXBBS FileBase. There are several problems
with the Files.BBS format that make even converting them difficult.
There are several different 'standard formats' for the Files.BBS and
there is absolutely nothing that can be done to automatically
distinguish these formats from each other.
The four most common Files.BBS formats are as follows. At the present
time, only formats #3 and #4 are supported by BFSMake.
Format #1:
-- Begin Sample Files.BBS Format #1 --
FILENAME.EXT ######## ##-##-## First line of description to 80 chars
| second line begins after the pipe.
| This is the format used by the PCBoard
| DIR## lists.
NEXTFILE.EXT ######## ##-##-## Once again description begins here
| and continues here.
-- End Sample Files.BBS Format #1 --
Format #2:
-- Begin Sample Files.BBS Format #2 --
FIRSTFIL.EXT ######## ##-##-## The whole description on ONE line and
.. can go on for 255 characters.
BFSMake will support one line
descriptions up to 1024 characters.
-- End Sample Files.BBS Format #2 --
Format #3:
-- Begin Sample Files.BBS Format #3 --
FILENAME.EXT First line of description to 1024 chars.
FILE1.EXT First line of description to 1024 chars.
-- End Sample Files.BBS Format #3 --
Format #4:
-- Begin Sample Files.BBS Format #4 --
FILENAME.EXT First line of description to 1024 chars.
Second line of description to 1024 chars.
Third line of description to 1024 chars.
FILE1.EXT First line of description to 1024 chars.
Second line of description to 1024 chars.
Third line of description to 1024 chars.
-- End Sample Files.BBS Format #4 --
Several new features of BFSMake make it well suited to systems that
have one or more CD-ROMs online. Description files (Files.BBS,
00_index.txt or 00index.txt) can be copied from a file area to
directory \Adept\Files.List. The description file in Files.List must
be renamed to area_num.BBS, where area_num is the number of the file
area in the File_Areas configuration file. The area_num.BBS file can
then be edited if necessary to conform to files.bbs format #3 or #4.
BFSMake is run from the \Adept subdirectory. It will read your
File_Areas file. It will then proceed on a two pass system. On the
first pass it will scan EVERY directory in the File_Areas list and
103
import all the file names in every directory into an index. On the
second pass it will start with the first file area and look in
directory \Adept\Files.List for an area_num.BBS file. If not found,
the file area directory is searched in order for a Files.BBS,
00_index.txt or 00index.txt file. The selected description file is
searched from top to bottom for the file names at which time the
file description is matched to the index created on the first pass.
All your file areas need to be configured in the File_Areas file in
order for BFSMake to be able to find them and import the file lists.
** BEFORE RUNNING BFSMAKE, always delete the files in the
\Adept\Files directory **
Setting up ratios:
File ratios work in one of two ways.. it either works as a per byte
ratio or a per file ratio, but not both at once.
For ratios to work, the user must be in a user group. Second, the
group must have a ratio set. (ie. it must be non-zer0...)
Once you have that set, you can give the user a 'ratio credit'. In
other words, the SysOp can start the user out with something other than
0 uploaded bytes (or files) For instance, if the SysOp used a byte
ratio (byte ratio is in K-bytes) The SysOp could give the user a ratio
credit of say, 500 (or 500K) and that would count as 500K uploaded by
the user. This helps them get past the first few file xfers.
Lets say the user had a record that looked like the following, the SysOp
has set up a per file ratio or 10 DLs to 1 UL, and the user has entered
a single filename at the prompt.
User: UL=0 files DL=5 files
Group: Ratio=10 (or 10 to 1) Credit=0
In this case, Adept will add 1 to the DL (to check the ratio as if
they were going to download the file) The DL number is then divided
by the upload number (to avoid division by 0, the smallest number of
uploads for the calculation will be 1)
So in this case, the users download ratio would be 6 to 1.. which meets
the 10 to 1 criteria, and the file is added to the download list.
Next example:
User: UL=4 files DL=43 files
Group: Ratio=10 Credit=0
User enters a filename, Adept adds 1 to the DL number.. which becomes
44 for the ratio calculation. the ratio calculation would be 44/4
this yields 11 which is invalid, it exceeds the 10 to 1 ratio, and the
user will not be able to add the file to the download list.
Next example:
104
User: UL=2 files DL=51 files
Group: Ratio=8 Credit=5
User enters filename, Adept adds 1.. 52 files.. user has uploaded 2
files plus has a credit of 5.. 7 ULs.. 52/7 = 7 Or 7 to 1 which
passes the 8 to 1 ratio test.
The same numbers will work for byte ratios. Just make the numbers a wee
bit larger. But the calculations are exactly the same.
Ratios are always in effect if they are turned on in a user group.
They aren't temporarily off until a set amount is exceeded.
Using CD-ROMS & Multi-Changer CD-ROMS With Adept:
AdeptXBBS has built in support for CD-ROM drives. As users select
files they wish to download, a special file queue automatically takes
the needed files from the CD-ROMS, places them in a temp directory,
for you to download. This is all done in the background and will
prevent the constant disk swapping that sometimes occurs on multi-cd
rom changers especially when 2-5 users all want different files from
different drives. The area or file should be marked for 'Copy from
Drive' in order to activate this feature.
NOTE: When listing Files From Inside Adept on a large system when a
user does a [S]earch or [W]ide area search or more commonly when the
caller accidentally chooses Continuous display, they can abort the scan
by pressing CTRL-K or CTRL-S
fList - An "all-files" List Creator For Adept:
Command line parameters:
------------------------
/Ccfgfilename - Change the default configuration file name from
fList.Cfg
Example: /Cmybbs.cfg
/? - Short help screen.
Configuration file key words:
-----------------------------
BBSNAME xxx - Where 'xxx' is your BBS name. 60 chars max.
INCLUDEAREAS xxx - Where 'xxx' are Area numbers to include in this
list.
A sequence of areas may be specified using the following format:
xxx-xxx
For instance, if you wanted areas 1 thru 10 in the list, you would say:
INCLUDEAREAS 1-10
Multiple sequences may be separated by commas:
INCLUDEAREAS 1-10,31-45,99
105
You can have up to 10240 included areas.
PREPENDFILE xxx - Where 'xxx' is the name of a text file which
should be at the top of the file list.
APPENDFILE xxx - Where 'xxx' is the name of a text file which
should be added to the bottom of the file list.
OUTFILE xxx - Where 'xxx' is the name of the file list. Default
is 'Files/AllFiles.List'
DATESORT - Flag to tell the program to sort by date. Default
is by filename.
REVERSESORT - Flag to tell the program to sort in reverse order.
May be combined with DATESORT to start your list
with the most current files.
Example configuration file:
----[cut here]----
BBSNAME The Abandoned Land
INCLUDEAREAS 1-40,60-70,99
DATESORT
REVERSESORT
----[cut here]----
This example file includes file areas 1 thru 40, 60 thru 70 and 99,
and is sorted in dated order with newest files first.
ReIndexFile - Adept File System Reindexing Program:
Run this program from your \Adept directory. It will delete your
current file system indexes and build them from scratch using the
data in \Adept\Files\Files.Data
It will not reindex descriptions at this time, as Adept has a built in
function to do that.
NOTE: This program will use all the CPU you can give it.. it is a CPU
hog and proud of itself for it. So, run this program when you don't
mind if a few other processes get slowed down a wee bit.
Program requires a /NUKE command line parameter to run. This makes
sure the sysop wants to run this program which destroys the current
file system indexes and rebuilds them from scratch. No /NUKE? no
deleting of indexes.
Program updated to use fSys.Dll for it's interaction with the file
system.
Due to these changes, the program is smaller! but it may also be a
touch slower. This is because it operates on one file at a time,
rather than a block of 100 files at a time. Reindexing happens on
about 100 files per second on my system. Your mileage will vary.
ReadArc.Cmd - Archive Command Processor:
Don't delete or touch this, it knows what to do all by itself. :-)
The format of the ReadArc.Cmd file is:
%1 %2 %3 %4 %5 %6 %7 %8 %9
106
________________________________
_ _ MESSAGE AREA CONFIGURATION _
________________________________
Message Area Editor:
Accessed from Edit->Message Areas...
+--+-----------------------------------------------------------+--+--+
: : Message Area Editor : : :
+--+-----------------------------------------------------------+--+--+
: Name: Number: + Flags ----------------+ :
: : : :
: Desc: : x EchoMail : :
: : x NetMail : :
: Addr: : x UseNet : :
: : x Internet E-mail : :
: Force To: : x Force Public : :
: : x Force Private : :
: Path: : x Anonymous Messages : :
: : x No Origin Line : :
: Msg Time Back: : x Compression : :
: : x ANSI Color Required : :
: +-------------------+ : x Macros in Text : :
: : Msg Area Security : : x Require Real Name : :
: +-------------------+ : x Assoc w/ File Area : :
: +-----------+ +-----------+ +----------+ : x Force to Same Name : :
: : Prev Area : : Next Area : :List Areas: : : :
: +-----------+ +-----------+ +----------+ : : :
: +--------+ +--------+ +--------+ +-----------------------+ :
: : Add : : Insert : : Delete : +-----------------------+ :
: +--------+ +--------+ +--------+ : SAVE CHANGES : :
: +------+ +------+ +-----------------------+ :
: : Ok : : Help : :
: +------+ +------+ :
: Changes are *NOT* saved until you click on :
: <Save Changes> :
+--------------------------------------------------------------------+
Name : Place the name of the message area in this field.
Number: Place the # for this message area in this field.
Desc: This is where you can place the description of the message
area.
Addr: Origin Address to use for this message area
Force To: Name to force all messages in this area to.
Path: Path to message files if not using the default.
Msg Time Back: Give the user the time back that it took to write
the message.
x EchoMail - Check this if this is a FidoNet EchoMail Area
107
x NetMail - Check this if this is a FidoNet NetMail Area
x UseNet - Check this if this is a UseNet Newsgroup
x GroupMail - Check this is this is a Internet E-mail Area
x Force Public - Force All Messages Public
x Force Private - Force All Messages Private
** NOTE Check Force Public and Force Private to give the user a
choice.
x Anonymous Messages - Allow anonymous messages
x No Origin Line - Don't add a Origin and tear line to messages
x Compression - Turn on the fly compression on.
x ANSI Color Required - User requires ANSI color to read this area.
x Macros in Text - Allow Adept META Commands in the text.
x Require Real Name - Require the users real name, else uses their
handle.
x Assoc. w/ File Area - Associated with a file area.
x Force to Same Name - For to force to name.
Message Area Security:
+--+-----------------------------------------------------------------+
: : Area Security - (Area Name) :
+--+-----------------------------------------------------------------+
: +---------+ +---------+ +---------+ :
: Password: Age: : OK : : Cancel : : Help : :
: +---------+ +---------+ +---------+ :
:+- Read Security --------------------------------------------------+:
:: Sec Level 1: Sec Level 2: ::
:: Flags 1 ::
:: x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x ::
:: Flags 2 ::
:: x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x ::
:: ::
:+------------------------------------------------------------------+:
:+- Write Security -------------------------------------------------+:
:: Sec Level 1: Sec Level 2: ::
:: Flags 1 ::
:: x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x ::
:: Flags 2 ::
:: x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x ::
:: ::
:+------------------------------------------------------------------+:
108
:+- SysOp Security -------------------------------------------------+:
:: Sec Level 1: Sec Level 2: ::
:: Flags 1 ::
:: x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x ::
:: Flags 2 ::
:: x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x ::
:: ::
:+------------------------------------------------------------------+:
+--------------------------------------------------------------------+
Password - Password required to enter a message into this area.
Age: Minimum age required to post or read messages in area.
Read Security:
Sec Level 1: Sec Level 2:
Set security level #1 & #2 to the minimum security level required
to read messages in the current area. Mark the flags you will
require the user to have in order to read messages in this area.
Both the flags and the security levels must pass in order to read
messages.
Write Security:
Sec Level 1: Sec Level 2:
Set security level #1 & #2 to the minimum security level required
to write messages in the current area. Mark the flags you will
require the user to have in order to write messages in this area.
Both the flags and the security levels must pass in order to write
messages.
SysOp Security:
Sec Level 1: Sec Level 2:
Set security level #1 & #2 to the minimum security level required
to gain access to the sysop functions in the current area. Mark the
flags you will require the user to have in order to gain access to
the sysop functions in this area. Both the flags and the security
levels must pass in order to use the sysop functions.
Message_Areas File Configuration:
Path and name of control file : \Adept\System\Message_Areas
This is the file that Adept creates when you edit the message areas
using the pull-down menus. You can edit this file with a standard text
editor.
AREABEGIN - This directive marks the beginning of a area definition
NAME - This defines the message areas name
NUMBER - This defines the message area number
AGE - This defines the minimum age required to access the area
DESC - This is the description of this area
SEC1 - This is the minimum sec required to access this area
when compared with the users security level #1
SEC2 - This is the minimum sec required to access this area
when compared with the users security level #2
109
FLAGS1
FLAGS2
WSEC1 - This is the minimum sec required to write a messages in
this area, this is compared with user sec level #1
WSEC2 - This is the minimum sec required to write a messages in
this area, this is compared with user sec level #2
WFLAGS1
WFLAGS2
SSEC1 - This is the minimum sec required to access sysop
functions for this message area. i.e. delete mail, read
private mail.
Compared with security level #1
SSEC2 - This is the minimum sec required to access sysop
functions for this message area. I.e. Delete mail, read
private mail.
Compared with security level #2
SFLAGS1
SFLAGS2
FLAGS
ADDRESS - FidoNet Address to use for posted Net/EchoMail
messages.
PASSWORD - Password required to access this message area.
FORCETO - Name to force, force to messages to
ECHO - Nodes to Forward/Receive mail from
ORIGIN - Origin to use for this message area
PATH - Drive/Path to place message area files for this area
MAXAGE - Maximum age of user to be able to access area
AREAEND - This directive marks the end of a area definition
For more information on FidoNet and setting up echomail, see the
MAILER section of this documentation.
An Example Message_Areas File:
AREABEGIN
NAME General
NUMBER 1
DESC Local Messages
WSEC1 5
WSEC2 5
SSEC1 100
SSEC2 100
FLAGS 2376
AREAEND
AREABEGIN
NAME Private Mail
NUMBER 2
DESC E-Mail
SSEC1 100
SSEC2 100
FLAGS 2308
AREAEND
AREABEGIN
NAME Fos2bbs
NUMBER 3
DESC [FidoNet] OS/2 BBS Discussions
110
WSEC1 5
WSEC2 5
SSEC1 100
SSEC2 100
FLAGS 2328
ADDRESS 1:231/1320.0@Fidonet
AREAEND
AREABEGIN
NAME Fadeptsoft
NUMBER 4
DESC [FidoNet] Adept Software
WSEC1 5
WSEC2 5
SSEC1 100
SSEC2 100
FLAGS 2328
ADDRESS 1:231/1320.0@Fidonet
AREAEND
AREABEGIN
NAME Netmail
NUMBER 99
DESC Netmail
RSEC1 100
RSEC2 100
WSEC1 100
WSEC2 100
SSEC1 100
SSEC2 100
FLAGS 32
ADDRESS 1:231/1320.0@Fidonet
AREAEND
Xmsg - AdeptXBBS Message Base Utility/Packer:
XMSG.EXE is a utility that will pack your messages areas per your
instructions. It can trim an area to a desired number of messages,
delete messages that have been read, delete messages of a certain
age.
Usages:
XMSG -A<actionfile> Performs commands listed in <actionfile>
XMSG -P [LoBd#] [HiBd#] (options) Packs out deleted messages
XMSG -T [LoBd#] [HiBd#] [#mess] (options) Trim to specified #
XMSG -D [LoBd#] [HiBd#] [#days] (options) Delete older than # days
XMSG -R [LoBd#] [HiBd#] (PRIVATE) (options) Deletes received messages
XMSG -K [LoBd#] [HiBd#] (options) Kills junk msgs by (option) criteria
XMSG -U [LoBd#] [HiBd#] Untags all msgs in an area
Note: when passing an argument, like the F option below, that requires
two words as one argument, use quotes to surround both the option and
its following argument, like XMSG -K 30 30 MC:\Message_Bases\ N100
"FHector Plasmic"
111
Note also that XMSG uses the asshole files HeadEdit creates.
Options (separated by a space if more than one used):
B (delete backups)
M<Drive:\Path\> (alternate message base path) [REQUIRED]
N<#LMRs> (Number of LMR pointers (must match w/ HeadEdit.CFG))
[REQUIRED]
Note: pass 0 to use XBBS-OS/2's Last Read Pointers
D (don't pack this pass--Valid for -T, -K and -D)
H<buffer> (if board(s) exceed this number, packing will take place to
[#mess])
F<fromname> (-Kill Junk criterion)
T<toname> (-Kill Junk criterion)
S<subject> (-Kill Junk criterion)
P (partial subject match causes Junk to be -Killed)
! (provide verbose info)
C<#bytes> (compress while packing if msg>#bytes)
U (uncompress while packing)
A (any match (F, T or S) causes Junk to be -Killed)
L (don't use asshole files)
E (archive dead msgs to XARC.###)
V (don't verify presence of deleted msgs before packing)
X (don't create XIDX.### hash files)
Z (use DosNewSize to assure contiguous allocation -- ware the HPFS bug)
Actionfile lines are command lines without the leading - on the first
argument.
There should be one 'command line' per line terminated by cr/lf.
Lines beginning with ; are comments.
XMSG is sensitive to the order of its arguments.
It's best to create a .cmd files that calls XMSG as a nightly event.
Ex.
xmsg -p 2 2 B N0
- Packs out deleted messages in message area #2, deletes the backup
files and changes the LMRs.
xmsg -r 3 5 B N0
- Packs out the received messages, in message areas #3 through #5,
deletes the backup and changes the LMRs.
xmsg -t 1 1 1000 B N0
- Trims message area #1 messages to 1000 messages, deletes the backup
and changes the LMRs.
xmsg -t 3 27 1000 B N0
- Trims message areas #3 through #27's messages to 1000 messages,
deletes the backup and changes the LMRs.
112
External Message Editor Support
-------------------------------
To enable the external editor support simple create
\adept\menus\extfseX.cmd where 'X' is the node number.
So if you want to enable the external editor for node #1,
create \adept\menus\extfse1.cmd. This will allow you to limit
the external editor to only certain nodes. You can also use
this CMD file to give your users a choice of mulitple external
editors. (See the included ExtFSeX.Cmd, You will have to rename
it to ExtFSe1.cmd for it to work with line 1. This little REXX
script will give you an option of several editors. I have also
included ice-ed.bat as an example of how to call IceEd.)
Remote SysOp's importing local text files
-----------------------------------------
Anyone with a security level #1 (SEC1) of 99 OR MORE, will be able to
import a local text file into a msg from within Adept's full screen editor.
To import a text file, press CTRL-K L. You will then be prompted for a
filename.
Reply to a different Message Area
---------------------------------
There are now three (3) ways you can reply to a message.
[R] = Reply in CURRENT message area.
[*] = Reply in NETMAIL message area.
[~] = Reply in E-MAIL message area.
Adept will search for the users Netmail address but YOU will have to enter
the proper E-Mail address as Adept cant extract it from the original
message.
After finishing the message, Adept will return you to your place in the
message area you were reading.
113
__________________________
_ _ MAILER CONFIGURATION _
__________________________
Line Specific Mailer Settings:
Accessed from Config->Active Line->Mailer Settings...
+--+-----------------------------------------------------------------+
: : Line # Mailer Settings :
+--+-----------------------------------------------------------------+
: :
: +-- EMSI Strings ----------------+ +-- Flags -----------------+ :
: : : : : :
: : Phone # : (###) ### - #### : : x No Mailer : :
: : BPS Rate : 14400 : : x Versions 7 Nodelist : :
: : Flags : CM,XA,OS2,V32b,V42b : : x Call collision detect : :
: : : : : :
: +--------------------------------+ +--------------------------+ :
: :
: Mail Proc. Cmd : cmd.exe /c mail.cmd %s :
: :
: +-- Costs ---------------+ +-- Errors --------------+ :
: : : : : :
: : Mx. Mail K : 1024 : : Mx. Resyncs : 200 : :
: : : : : :
: : Mx. Mail Secs : 3600 : : Mx. Xfer Errs : 0 : :
: : : : : :
: : : : x Recv. From unknown : :
: : : : x Send to Unknown : :
: +------------------------+ +------------------------+ :
: +------+ +--------+ +------+ :
: : OK : : Cancel : : Help : :
: +------+ +--------+ +------+ :
+--------------------------------------------------------------------+
--- EMSI Strings -------------------------------
Phone #: This is the phone number displayed during a EMSI session.
BPS Rate: This is the Maximum BPS rate, it is displayed during a EMSI
session.
Flags: These are the flags for your system passed during a EMSI
session.
--- Flags --------------------------------------
No Mailer: Turns the Mailer On/Off (Check it for OFF)
Version 7 Nodelist: Tells XBBS to use a version 7 Nodelist, XBBS also
supports a version 6 Nodelist.
Call collision detection:
----------------------------------------------------------------------
Mail Proc. Cmd : This is the filename to run for mail processing.
----------------------------------------------------------------------
114
--- Costs --------------------------------------
Mx. Mail K : Maximum size of mail in K to send from this node. This
is also used to set the maximum K that someone can
FREQ from this node.
Mx. Mail Secs : Time limit is seconds to disconnect a stalled transfer.
--- Errors -------------------------------------
Mx. Resyncs: Maximum number of transfer resyncs before aborting a
transfer
Mx. Xfer Errs: Maximum number of transfer errors before the mailer
aborts the session
Recv. From unknown: Tells XBBS it's Ok to receive mail from unlisted
nodes.
Send to unknown: Tells XBBS it's Ok to send mail to unlisted nodes.
Address Settings:
Accessed from Config->Active Line->Mailer Addresses...
+--+---------------------------------------+
: : Addresses :
+--+---------------------------------------+
: +-----------------------+-+ +---------+ :
: : ##:###/###.#@******** :^: : OK : :
: : ##:###/###.#@******** : : +---------+ :
: : : : +---------+ :
: : : : : Change : :
: : : : +---------+ :
: : : : +---------+ :
: : :v: : Help : :
: +------------------------+-+ +---------+ :
+------------------------------------------+
: +-------------------------------------+ :
: : : :
: +-------------------------------------+ :
: +---------+ +----------+ :
: : ADD : : Delete : :
: +---------+ +----------+ :
: :
+------------------------------------------+
This screen is used to input all your net addresses. You can also
manually edit the file this screen creates which is the
\Adept\System\Addresses file. If you have more than one node and each
node is assigned different addresses, you can create an Addresses.1,
Addresses.2 ect... FidoNet specs only allow for 8 character max domain
names. Any domain name over 8 characters is not to fido specs, and Gate
Keeper may not operate as you expect. Use large domain names at your
own risk. At least the first 8 characters must be unique.
115
Nodelist Information:
AdeptXBBS uses and supports the FidoNet Version 7 nodelist. AdeptXBBS
does not come with it's own internal nodelist compiler. There are
several nodelist compilers that can produce a Version 7 nodelist, these
can be obtained from our support BBS or FTP sites. QNODE and FASTLST
are two such compilers.
XSENDPM - FIDO File Sending Utility:
XSENDPM.EXE copyright (c) 1993-95 by M. Kimes all rights reserved
Overview:
========
XSENDPM is a simple PM program that allows you to send files via
XBBS-OS/2 or AdeptXBBS.
XSENDPM supports drag-and-drop to its WPS object and also provides an
"open dialog"-style interface to allow the user to select files to send.
Files to send may be typed into an entry field or selected from
listboxes. Version 7 nodelists are supported for lookup of sysop names
and information about nodes.
See GS.EXE for a command line alternative.
Installation:
============
Edit the file XSEND.CMD that comes with AdeptXBBS to contain the proper
drive letters and paths for your AdeptXBBS Outbound and nodelist
directory.
Usage:
=====
Drag a file onto XSENDPM's WPS object or double-click the object to
start XSENDPM. You'll get a dialog that allows you to specify to whom
you want the file sent and some other options. Brief help is available
from within the program.
Warranty:
========
There is no warranty expressed or implied. You're on your own,
goodnight.
FAX Connects:
First you need to have the following 3rd party programs:
BGFAX (BGFAX150.ARJ) - or latest version
Ray Gwinn's SIO Drivers (SIO153.ZIP) - or latest version
Both of these programs can be found from the same places you download or
FTP other OS/2 shareware.
Modify your config.sys:
SET BGFAX=C:\BBSFAX
SET FAX=DEBUG
116
* modify C:\BBSFAX to your directory where BGFAX is installed.
* SET FAX=DEBUG if you wish to log extra info about what BGFAX does.
DEVICE=C:\sio\SIO.SYS (COM2:57600,02F8,3,-) (COM3:57600,03E8,5,-)
DEVICE=C:\sio\VSIO.SYS
* Adjust your ports / IRQ's accordingly.
Modify AdeptXBBS modem Init's:
Here are 3 examples using different modems under Adept:
COM2:Hayes Optima 288 V34, COM4:USR V.Everything and CLASS 2 type
modems.
A) Hayes:
Answer: AT+FAE=1;A|
* this is adaptive answering for class 1 modems
INIT: ATH0|~AT+FCLASS=1|~AT&C1&D2S95=43|
DIAL: AT+FCLASS=0DT
Modify or create the following:
\Adept\fax1.cmd has the following: (FAX1.CMD)
rem *** fax1.cmd for my node 1 - Hayes Optima V34 - Locked 57600!
SU LOCK 0
c:\bbsfax\BGFAX2.EXE /FHAY:965_252_1974 C:\FAXWORKS h%1 q
SU LOCK 57600
B) CLASS 2.0 USRobotics Courier V.Everything
Please make sure the following three items are true before proceeding...
[ 1] Your modem is not set to "Auto Answer" mode (Register S0 must
equal 0)
[ 2] DIP switch #5 is in the "Supress Auto Answer" position.
[ 3] You have already put all relevant DATA commands for the BBS into
NVRAM.
Note that, generally fax (AT+F) commands CANNOT be stored in NVRAM.
From the ADEPT main window: Config -> Active Line -> General Settings
make the following entries in the fields indicated:
Answer: AT+FAA=1;A|~AT+FNR=1,1,1,1|
Init: v~~~ATZ|AT=FCLASS=2.0|~AT+FLI="301 808 1099"|
117
Dial Prefix: AT+FCLASS=0DT
Dial Suffix: |
Answer on RING: 2
RING Response: RING
"ATO on Data" shound NOT be checked.
Modify or create the following:
\Adept\fax2.cmd has the following: (FAX2.CMD)
rem *** fax1.cmd for my node 1 - USR Courier V.Everything - Locked
115200!
D:\bbsfax\BGFAX2.EXE /FCO:04 D:\FAXWORKS h%1 F
If you have trouble receiving FAXes, you may need to adjust the /FCO:nn
value to maybe /FCO:02 or /FCO:08 depending on your computer speed.
D:\FAXWorks is the directory that the FAXes will be received in. If you
have FAXworks on your system, FAXworks will perform any of its
operations
on this received FAX file as if it had been received by FAXWorks.
The FAXTYPE parameter, "F" above, is set in this case to receive FAXes
in TIFF Class F format which is compatible with FAXWorks for OS/2.
See the BGFAX documentation for further information and options.
Info Only
_________
+FCLASS=0DT Enables data mode operation on outgoing calls
+FCLASS=2.0 Enables FAX mode operation
+FLI="123 346 7890" Sets your FAX ID (up to 20 characters)
+FNR=1,1,1,1 Tells modem to let BGFAX know connect speed, etc.
If you make use of any of the special dial strings in
[ADEPTXBBS] Config -> Active Line -> Dial Strings
They too must start with AT+FCLASS=0 followed by any special modem
commands, then followed by the DT dial command. The suffix can remain
"|".
After making the changes you will need to do a SHUTDOWN of ADEPT
C) Class 2 type modems (Supra v.32bis, PPI, ZOOM, ect.)
Answer: ata|
118
Init: v~^~atz|
v~^~at+fcr=1;+fdcc=1,3,0,2,0,0,0,0|
v~^~at+faa=1;+flid="512 926 5152"|
DialPref: v~^~ATDT
DialSuf: |
Note: DO NOT check> "ATO"....!
Modify or create the following:
\Adept\fax1.cmd has the following: (FAX1.CMD)
rem *** fax1.cmd for a CLASS2 type modem - Locked 38400!
SU 2 LOCK 0 Note:
BGFAX2 /FAX E:\FAXWORKS h%1 z or E:\BGFAX h%1 f
SU 2 LOCK 38400
INFO ONLY:
^^^^^^^^^
1. +fcr=1 enables fax reception (Not required for
CLASS 2.0)
2. +flid="713 555 1212" sets your FAX ID, up to 20 characters
+fli="713 555 1212" for a CLASS 2.0 modem
3. +fdcc=1,5,0,2,0,0,0,0 enable high resolution, 14400, 1D
compression
4. +fdcc=1,3,0,2,0,0,0,0 enable high resolution, 9600, 1D compression
5. +fdcc=1,5,0,2,1,0,0,0 enable high res, 14400, 1D and 2D
compression
Do not attempt to give a 9600 maximum speed send/receive "Fax Modem" the
+fdcc=1,5 string, as it will cause unpredictable results.
______________________________________
_ _ SETTING UP DOORS UNDER AdeptXBBS _
______________________________________
DOS and OS/2 Doors can be run successfully under Adept. Doors are online
games that your users can play against other users or computer players.
These instructions assume that you have at least a limited knowledge of
how to set up doors.
In the following examples, we refer to using the DOOR.SYS drop file. If
you prefer and your door supports it, Adept also creates a Dorinfo1.def
drop file.
First you need Ray Gwinn's SIO comm drivers for OS/2. These can be
downloaded or ftp'ed from various sources or you will be able to find
them on the Adept Support BBS. After you install them, you need to make
sure that the undocumented '-' feature is used. Here's what the
appropriate
lines in your config.sys should look like:
REM DEVICE=C:\OS2\BOOT\COM.SYS
REM DEVICE=C:\OS2\MDOS\VCOM.SYS
REM ......... Ray Gwinn's SIO Com drivers ........
DEVICE=C:\SIO\SIO.SYS (1, 3F8, 4,-)
119
DEVICE=C:\SIO\VSIO.SYS
DEVICE=C:\SIO\VX00.SYS
Here, OS/2's original com drivers have been commented out and the SIO
drivers are used with the '-' switch. In this example, only COM1 is
setup. Consult the SIO documentation for more information on setting up
these drivers for your system.
Ray Gwinn's SIO drivers are also important if you have the AdeptXBBS
Internet module and want to allow users that telnet into your system to
be able to play doors. To allow doors to be accessible to users that
have telnetted in, you have to setup and run VMODEM which comes in the
SIO zip file. Please read the VMODEM documentation for more info.
The following are the steps that would be used to set up the popular
game Trade Wars 2002 for DOS.
1. Unzip the game into its own directory and install it according to the
directions.
2. Add the following entry to your door.menu file:
1 ,801,,cmd.exe /c twar.bat {LN {H0,0
Pressing 1 will now start the door, passing it the line number and
the user's handle.
3. Create a file called twar.bat in your \Adept directory.
Below is a sample of what your twar.bat should look like. Edit it to
use your drive and path information. Notice that DOOR.SYS is copied
from the \Adept\System\Line%1 The DOOR.SYS file is created by Adept and
placed in the Line%1 directory. The %1 is the current node. So, if
someone started the door on node 2, a '2' would be substituted for the
'%1' character.
If your door game does not support the DOOR.SYS or Dorinfo1.def drop file,
then you must obtain a drop file converter. These can be downloaded or
FTP'd from other BBSes.
4. If you run a multinode system, you must tell the door which directory
to look in for your DOOR.SYS drop file. Do not use the batch files
below that copy the drop file to the door game directory if you are
running a multinode system. If you do, things will not work
correctly when more than one user is playing the same door at the
same time. Usually multinode compatible doors will have config
files that must be made that tell where to look for the drop file.
Sample Batch Files for Single Node Systems:
----twar.bat------
D:
CD \doors\tw
del door.sys
copy c:\adept\system\line%1\door.sys
tw2002 NOEMS
del door.sys
120
c:
cd\adept
-----------------
Note: You also need to add the following line to your AUTOEXEC.BAT file:
SET TWNODE=1
(This is just for setting up Tradewars)
Here are some other examples of batch files that run door games:
----Barren Realms Elite batch file------
D:
CD \DOORS\BRE
del door.sys
copy c:\adept\system\line%1\door.sys
SRDOOR
BRE
del door.sys
c:
CD \adept
----------------
----Mines of Gorr batch file------
D:
CD \doors\mog
del door.sys
copy c:\adept\system\line%1\door.sys
gorr door.sys
del door.sys
c:
cd \adept
----------------
----Iron Ox (OS/2 Version) cmd file-------
D:
CD \doors\ox
copy c:\adept\system\line%1\door.sys
/ironox /PORT
del door.sys
c:
cd\adept
----------------
____________________
121
FTP
Adept now has a FTP server built into the BBS software. This is the
first alpha that it is available. Users log into the server with
the name that they use on the BBS. If you wish to allow Anonymous
users you need to create a account on the BBS called Anonymous.
The server will user the Anonymous accounts settings in order to
decide what areas and files the user has access to.
The server ALWAYS has an exception handler guarding it for now
since it is alpha. Uploading of files is not permitted with
this build of the server for security reasons.
There is a new tag FTPNAME in the file area editor. It allows you
to define the name of the directory shown to represent that area
on the server. If you don't put a name it will use the area name
but I sugest you use a name, all lower case, 8 chars or so in
length instead of the area name (it could be the area name if you
wish).
The server will honor users time and file and age limits.
To start the ftp server add the /FTP command line option to
Adept. Adept.exe /ftp
122
______________
_ _ APPENDIX _
______________
Example .MENU Files:
The following is an example of a MAIN.MENU file:
BEGINMENU
PROMPT \n [
?
for Help ] \r\n [
{T0 minutes left
]
PROMPTCOLOR 0
DISPLAYFILE MainMenu.ASC
MENULOCATION Main Menu
MENUFLAGS 4
BEGINMENUITEM
KEY -
MENUCOMMAND 1
DISPLAYCOLOR 0
DATAOPTION main.menu
MINSEC1 30
MINSEC2 30
ENDMENUITEM
BEGINMENUITEM
KEY ?
MENUCOMMAND 10
DISPLAYCOLOR 0
DATAOPTION Commands.cmd
ENDMENUITEM
BEGINMENUITEM
KEY
MENUCOMMAND 2
DISPLAYCOLOR 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
BEGINMENUITEM
KEY ~
MENUCOMMAND 1000
DISPLAYSTRING Goodbye/Logoff
DISPLAYCOLOR 0
ENDMENUITEM
BEGINMENUITEM
KEY M
MENUCOMMAND 1
DISPLAYSTRING [M]essage Menu
DISPLAYCOLOR 0
DATAOPTION Message.Menu
MINSEC1 30
MINSEC2 30
ENDMENUITEM
BEGINMENUITEM
KEY O
MENUCOMMAND 1
DISPLAYSTRING [O]ffline Mail
DISPLAYCOLOR 0
DATAOPTION OFF-MAIL.Menu
MINSEC1 30
MINSEC2 30
ENDMENUITEM
BEGINMENUITEM
KEY F
MENUCOMMAND 1
DISPLAYSTRING [F]ile Menu
DISPLAYCOLOR 0
DATAOPTION Files.Menu
123
MINSEC1 30
MINSEC2 30
ENDMENUITEM
BEGINMENUITEM
KEY S
MENUCOMMAND 1
DISPLAYSTRING User [S]etup
DISPLAYCOLOR 0
DATAOPTION EditUser.Menu
MINSEC1 30
MINSEC2 30
ENDMENUITEM
BEGINMENUITEM
KEY G
MENUCOMMAND 1
DISPLAYSTRING [G]ood-bye
DISPLAYCOLOR 0
DATAOPTION LogOff.Menu
ENDMENUITEM
BEGINMENUITEM
KEY B
MENUCOMMAND 1
DISPLAYSTRING [B]ulletin Menu
DISPLAYCOLOR 0
DATAOPTION Bullet.Menu
MINSEC1 30
MINSEC2 30
ENDMENUITEM
BEGINMENUITEM
KEY U
MENUCOMMAND 1
DISPLAYSTRING [U]ser & BBS Stats
DISPLAYCOLOR 0
DATAOPTION Stats.Menu
MINSEC1 30
MINSEC2 30
ENDMENUITEM
BEGINMENUITEM
KEY I
MENUCOMMAND 1
DISPLAYSTRING [I]nternet Menu
DISPLAYCOLOR 0
DATAOPTION Internet.menu
MINSEC1 30
MINSEC2 30
ENDMENUITEM
BEGINMENUITEM
KEY D
MENUCOMMAND 1
DISPLAYSTRING [D]oors Menu
DISPLAYCOLOR 0
DATAOPTION Door.Menu
MINSEC1 30
MINSEC2 30
ENDMENUITEM
BEGINMENUITEM
KEY X
MENUCOMMAND 1
DISPLAYSTRING Sysop Menu
DATAOPTION Sysop.Menu
MINSEC1 100
MINSEC2 100
ENDMENUITEM
124
BEGINMENUITEM
KEY C
MENUCOMMAND 1
DISPLAYSTRING [T]eleconference
DISPLAYCOLOR 0
DATAOPTION teleconf.menu
MINSEC1 30
MINSEC2 30
ENDMENUITEM
BEGINMENUITEM
KEY E
MENUCOMMAND 10
DISPLAYSTRING [E]mail
DISPLAYCOLOR 0
DATAOPTION Sendemail.srx
MINSEC1 30
MINSEC2 30
ENDMENUITEM
BEGINMENUITEM
KEY Y
MENUCOMMAND 10
DISPLAYSTRING [Y]ell at the SysOp!
DISPLAYCOLOR 0
DATAOPTION yellsb.cmd
MINSEC1 30
MINSEC2 30
ENDMENUITEM
BEGINMENUITEM
KEY W
MENUCOMMAND 42
DISPLAYSTRING [W]ho is online
DATAOPTION 0
MINSEC1 30
MINSEC2 30
ENDMENUITEM
BEGINMENUITEM
KEY V
MENUCOMMAND 11
DISPLAYSTRING [V]iew Recent Callers
DISPLAYCOLOR 0
DATAOPTION Adread.srx
MINSEC1 30
MINSEC2 30
ENDMENUITEM
ENDMENU
Example DOOR.MENU:
BEGINMENU
PROMPT \r
PROMPTCOLOR 0
DISPLAYFILE DOOR.ASC
MENULOCATION Online Games
MENUFLAGS 4
BEGINMENUITEM
KEY ?
MENUCOMMAND 51
DISPLAYCOLOR 0
DATAOPTION Commands.Asc
ENDMENUITEM
BEGINMENUITEM
KEY \
MENUCOMMAND 0
DATAOPTION Door.Menu
ENDMENUITEM
125
BEGINMENUITEM
KEY T
MENUCOMMAND 3
DISPLAYSTRING Gosub main menu
DATAOPTION Main.Menu
ENDMENUITEM
BEGINMENUITEM
KEY *
MENUCOMMAND 3
DISPLAYSTRING Gosub main menu
DATAOPTION Main.Menu
ENDMENUITEM
BEGINMENUITEM
KEY M
MENUCOMMAND 1
DISPLAYSTRING Gosub main menu
DATAOPTION Message.Menu
ENDMENUITEM
BEGINMENUITEM
KEY U
MENUCOMMAND 1
DISPLAYSTRING Gosub main menu
DATAOPTION EditUser.Menu
ENDMENUITEM
BEGINMENUITEM
KEY -
MENUCOMMAND 2
DISPLAYSTRING Return to previous menu
DISPLAYCOLOR 0
ENDMENUITEM
BEGINMENUITEM
KEY
MENUCOMMAND 2
DISPLAYSTRING Return to previous menu
DISPLAYCOLOR 0
ENDMENUITEM
BEGINMENUITEM
KEY ~
MENUCOMMAND 1000
DISPLAYSTRING Goodbye/Logoff
DISPLAYCOLOR 0
DATAOPTION LogOff.Menu
ENDMENUITEM
BEGINMENUITEM
KEY 1
MENUCOMMAND 801
DISPLAYCOLOR 0
DATAOPTION cmd.exe /c pit.bat {LN {H0
ENDMENUITEM
BEGINMENUITEM
KEY 2
MENUCOMMAND 801
DISPLAYCOLOR 0
DATAOPTION cmd.exe /c ghost.bat {LN
ENDMENUITEM
BEGINMENUITEM
KEY 3
MENUCOMMAND 801
DISPLAYCOLOR 0
DATAOPTION cmd.exe /c bbscr.bat {LN
ENDMENUITEM
126
BEGINMENUITEM
KEY 4
MENUCOMMAND 801
DISPLAYCOLOR 0
DATAOPTION cmd.exe /c tw2.cmd {LN {H0
ENDMENUITEM
BEGINMENUITEM
KEY 5
MENUCOMMAND 51
DISPLAYCOLOR 0
DATAOPTION c:\\opus\\lord\\scores.asc;10
ENDMENUITEM
BEGINMENUITEM
KEY 6
MENUCOMMAND 801
DISPLAYCOLOR 0
DATAOPTION cmd.exe /c lord.bat {LN
ENDMENUITEM
BEGINMENUITEM
KEY 7
MENUCOMMAND 801
DISPLAYCOLOR 0
DATAOPTION cmd.exe /c jet.bat {LN
ENDMENUITEM
BEGINMENUITEM
KEY 8
MENUCOMMAND 801
DISPLAYCOLOR 0
DATAOPTION cmd.exe /c usurp.bat {LN
ENDMENUITEM
BEGINMENUITEM
KEY C
MENUCOMMAND 10
DISPLAYCOLOR 0
DATAOPTION C:\Adept\ADUtils\Casino\ADCasino.Erx
ENDMENUITEM
BEGINMENUITEM
KEY A
MENUCOMMAND 800
DISPLAYCOLOR 0
DATAOPTION advent.exe {LN
ENDMENUITEM
BEGINMENUITEM
KEY D
MENUCOMMAND 801
DISPLAYCOLOR 0
DATAOPTION cmd.exe /c dd2.cmd {LN
ENDMENUITEM
BEGINMENUITEM
KEY E
MENUCOMMAND 801
DISPLAYCOLOR 0
DATAOPTION cmd.exe /c chess.cmd {S8 {H0 {U0
ENDMENUITEM
BEGINMENUITEM
KEY B
MENUCOMMAND 801
DISPLAYCOLOR 0
DATAOPTION cmd.exe /c bre.bat {LN
ENDMENUITEM
127
BEGINMENUITEM
KEY G
MENUCOMMAND 801
DISPLAYCOLOR 0
DATAOPTION cmd.exe /c lore.bat {LN
ENDMENUITEM
BEGINMENUITEM
KEY H
MENUCOMMAND 801
DISPLAYCOLOR 0
DATAOPTION cmd.exe /c exs.bat {LN
ENDMENUITEM
BEGINMENUITEM
KEY F
MENUCOMMAND 801
DISPLAYCOLOR 0
DATAOPTION cmd.exe /c fod.bat {LN
ENDMENUITEM
BEGINMENUITEM
KEY I
MENUCOMMAND 801
DISPLAYCOLOR 0
DATAOPTION cmd.exe /c ox.cmd {LN
ENDMENUITEM
BEGINMENUITEM
KEY J
MENUCOMMAND 801
DISPLAYCOLOR 0
DATAOPTION cmd.exe /c rungrunt.bat {LN
ENDMENUITEM
BEGINMENUITEM
KEY K
MENUCOMMAND 801
DISPLAYCOLOR 0
DATAOPTION cmd.exe /c quant.bat {LN
ENDMENUITEM
BEGINMENUITEM
KEY L
MENUCOMMAND 801
DISPLAYCOLOR 0
DATAOPTION cmd.exe /c lod.cmd {LN {H0
ENDMENUITEM
BEGINMENUITEM
KEY P
MENUCOMMAND 10
DISPLAYCOLOR 0
DATAOPTION advpoker.Erx
ENDMENUITEM
ENDMENU
Example FILES.MENU:
BEGINMENU
PROMPT \n [
?
for Help ] [
{T0 minutes left
]
PROMPTCOLOR 12
DISPLAYFILE FileMenu.ASC
MENULOCATION File Menu
MENUFLAGS 4
BEGINMENUITEM
KEY -
MENUCOMMAND 1
DISPLAYSTRING Gosub to File Menu
DATAOPTION Files.Menu
128
MINAGE 0
ENDMENUITEM
BEGINMENUITEM
KEY ?
MENUCOMMAND 10
DISPLAYCOLOR 0
DATAOPTION filehelp.cmd
ENDMENUITEM
MENUCOMMENT ; ---- The Below Commands are copied in every menu ----
BEGINMENUITEM
KEY M
MENUCOMMAND 1
DISPLAYSTRING Gosub to Message Menu
DATAOPTION Message.Menu
MINAGE 0
ENDMENUITEM
BEGINMENUITEM
KEY !
MENUCOMMAND 1
DISPLAYSTRING Gosub to Doors Menu
DATAOPTION Door.Menu
ENDMENUITEM
BEGINMENUITEM
KEY T
MENUCOMMAND 3
DISPLAYSTRING Go to Top Menu
DISPLAYCOLOR 0
ENDMENUITEM
BEGINMENUITEM
KEY *
MENUCOMMAND 3
DISPLAYSTRING Go to Top Menu
DISPLAYCOLOR 0
ENDMENUITEM
BEGINMENUITEM
KEY ~
MENUCOMMAND 1001
DISPLAYSTRING Goodbye/Logoff
DISPLAYCOLOR 0
ENDMENUITEM
BEGINMENUITEM
KEY G
MENUCOMMAND 1
DISPLAYSTRING Goodbye/Logoff
DISPLAYCOLOR 0
DATAOPTION LogOff.Menu
ENDMENUITEM
BEGINMENUITEM
KEY
MENUCOMMAND 2
DISPLAYSTRING Return to previous menu
DISPLAYCOLOR 0
ENDMENUITEM
MENUCOMMENT ; ---- Begin Custom Menu Commands -----
BEGINMENUITEM
KEY L
MENUCOMMAND 78
DISPLAYSTRING [L]ist File In This Area
DISPLAYCOLOR 15
ENDMENUITEM
129
BEGINMENUITEM
KEY F
MENUCOMMAND 10
DISPLAYSTRING [F]long list
DISPLAYCOLOR 15
DATAOPTION c:\adept\menus\adeptfile.erx
ENDMENUITEM
BEGINMENUITEM
KEY N
MENUCOMMAND 74
DISPLAYSTRING [N]ew files
DISPLAYCOLOR 15
ENDMENUITEM
BEGINMENUITEM
KEY S
MENUCOMMAND 76
DISPLAYSTRING [S]earch Area
DISPLAYCOLOR 15
ENDMENUITEM
BEGINMENUITEM
KEY D
MENUCOMMAND 85
DISPLAYSTRING [D]ownload file(s)
DISPLAYCOLOR 15
ENDMENUITEM
BEGINMENUITEM
KEY P
MENUCOMMAND 146
DISPLAYSTRING [P]rotocol Selection
DISPLAYCOLOR 15
ENDMENUITEM
BEGINMENUITEM
KEY U
MENUCOMMAND 90
DISPLAYSTRING [U]pload file(s)
DISPLAYCOLOR 15
ENDMENUITEM
BEGINMENUITEM
KEY >
MENUCOMMAND 65
DISPLAYSTRING [>] Next file area
DISPLAYCOLOR 15
DATAOPTION 1
ENDMENUITEM
BEGINMENUITEM
KEY <
MENUCOMMAND 65
DISPLAYSTRING [<] Previous file area
DISPLAYCOLOR 15
DATAOPTION -1
ENDMENUITEM
BEGINMENUITEM
KEY V
MENUCOMMAND 84
DISPLAYSTRING [V]iew Archive contents
DISPLAYCOLOR 15
ENDMENUITEM
BEGINMENUITEM
KEY E
MENUCOMMAND 670
DISPLAYSTRING [E]dit Files List
DISPLAYCOLOR 0
ENDMENUITEM
130
BEGINMENUITEM
KEY G
MENUCOMMAND 1
DISPLAYSTRING [G]oodbye
DISPLAYCOLOR 15
DATAOPTION LogOff.Menu
ENDMENUITEM
BEGINMENUITEM
KEY C
MENUCOMMAND 10
DISPLAYSTRING Change Group
DISPLAYCOLOR 0
DATAOPTION c:\adept\Afan\AfanG.Erx
ENDMENUITEM
BEGINMENUITEM
KEY A
MENUCOMMAND 10
DISPLAYSTRING Change Area in Group
DISPLAYCOLOR 0
DATAOPTION c:\adept\Afan\AfanG.Erx
ENDMENUITEM
BEGINMENUITEM
KEY +
MENUCOMMAND 10
DISPLAYCOLOR 0
DATAOPTION c:\cdcar\cdcar.cmd
ENDMENUITEM
ENDMENU
AdeptXBBS User Base Structure:
The following is the structure for the AdeptXBBS user file.
The following flags are used for the 'user.attribs' bits.
#define U_ANSI 0x00000001 - Ansi Movement
#define U_COLOR 0x00000002 - Ansi Color
#define U_HIGHASCII 0x00000004 - High Ascii
#define U_NOMORE 0x00000008 - No? More? Prompts
#define U_NOCLEAR 0x00000010 - Don't Clear Screens
#define U_COLD 0x00000020 - No Hot Keys
#define U_NOSHOWADDRESS 0x00000040 - Don't show address in user
list
#define U_NOSHOWPHONE 0x00000080 - Don't show phone numbers
in user list
#define U_NOSHOWREAL 0x00000100 - Don't show real names in
user list
#define U_NOKILL 0x00000200 - User cannot be
killed/deleted
#define U_DELETED 0x00000400 - User marked as deleted
#define U_EXPERT 0x00000800 - User set for expert mode
#define U_TWIT 0x00001000 - User is a twit!
#define U_NEWFILES 0x00002000 - New files search at logon
#define U_NEWMSGS 0x00004000 - New message search at
131
logon
#define U_DLNEWMSGS 0x00008000 - Auto download mail packets
at logon
#define U_DLNEWFILELIST 0x00010000 - Auto download new file
list at logon
#define U_SEENEWS 0x00020000 - Sees new news
#define U_ASKDL 0x00040000 - Ask logoff before download
#define U_NOVICE 0x00080000 - User set to novice
#define U_NOROLL 0x00100000 - no rolling prompts
(obsolete)
#define U_POINTONLY 0x00200000 - FidoNet point mail only
#define U_LOCKEDOUT 0x00400000 - User locked out
#define U_AVAILABLE 0x00800000 - Available for multi-node
chat
#define U_LISTPROTECTED 0x01000000 - Not shown in user list
#define U_MISCNEWSOK 0x02000000 - Sees misc. news
#define U_LIMITFLIST 0x04000000 - Limit file list to current
area
#define U_EBCDIC 0x08000000 - EBCDIC <-> ASCII
Conversion
#define U_VERIFIED 0x10000000 // user call back
verified, turn this off,
they get // verified
again.. (if BBS verifies)
#define U_ANSITE2 0x20000000 - User supports Ansi-TE2
Special Chars
#define U_RIPSCRIPT 0x40000000 - User has RIP Support
#define U_AVATAR 0x80000000 - User has Avatar Support
The following flags are used for 'user.attribs2' bits.
#define U2_FSE 0x00000001 - User Full Screen Message
Editor
#define U2_OFF_AFTER_MAIL 0x00000002 - Log off after mail
download
#define U2_MONITOR_MAIL 0x00000004 - Monitor mail
export/packing
#define U2_INT_NEW_FILES 0x00000008 - include new files in mail
packet
#define U2_INC_BULLETS 0x00000010 - include bulletins in mail
packet
#define U2_INC_WELCOME 0x00000020 - include welcome screen in
mail packet
#define U2_DEFAULT_QWK 0x00000040 - Default use to QWK mail
#define U2_DEFAULT_FIDO 0x00000080 - Default use to FidoNet
Point Mail
#define U2_DEFAULT_TEXT 0x00000100 - Default to text export
#define U2_DEFAULT_BLUE 0x00000200 - Default to Bluewave Mail
#define U2_AVTANS 0x00000400 - Can handle both ANSI and
Avatar
#define U2_8DOT3 0x00000800 - Convert long names to 8.3
names
typdef struct _AdeptXBBS_User_Info
{
CHAR name[36]; // Users Name
CHAR handle[36]; // Users Handle
132
CHAR address[60]; // Address line 1
CHAR address1[60]; // Address line 2
CHAR address2[60]; // Address line 3
CHAR city[20]; // Users City/County
CHAR state[5]; // Users State
CHAR zipcode[10]; // Users ZipCode
CHAR home_phone[21]; // Users home phone number
CHAR data_phone[21]; // Users data phone number
CHAR fax_phone[21]; // Users fax phone number
CHAR bus_phone[21]; // Users business/office number
CHAR interests[78]; // Interest Line
CHAR SysOpComment[78]; // Room for SysOp comment
USHORT banktime; // Time in the bank
USHORT computer_type; // Computer type
LONG userid; // User ID
SHORT pointid; // Point Mail ID
time_t initial_logon; // Time/Date of initial logon
time_t expires; // Time/Date user expires
time_t last_logon; // Time/Date of last logon
time_t logon_today; // Last time the user logged on
today
SHORT birthyear; // Birth Year
CHAR birthmonth; // Birth Month
CHAR birthday; // Birth day
CHAR gender; // Gender
LONG credit; // User credit
LONG minlimit; // Minimum limit
LONG group; // Group number the user
belongs to
LONG currlastread; // Last read pointer for
current area
LONG time_today; // Number of minutes user used
today
LONG time_per_day; // Time limit per day
LONG time_per_call; // Time limit per call
LONG numcalls; // Number of total calls user
made to BBS
LONG ulnum; // Total number of uploads
LONG dlnum; // Total number of downloads
LONG ulk; // Total uploads in K-bytes
LONG dlk; // Total downloads in K-bytes
LONG uktoday; // Uploads in K-bytes made
today
LONG dktoday; // Download in k-bytes made
today
LONG ukperday; // Max k-bytes user can upload
a day
LONG dkperday; // Max k-byes a user can
download a day
LONG numposts; // Number of messages ever
written
LONG security1; // Security level #1
LONG security2; // Security level #2
LONG flags1; // Sysop definable 32 flags
133
LONG flags2; // Sysop definable 32 flags
LONG attribs; // User attributes
LONG attribs2; // User attributes
SHORT length; // Screen length
SHORT width; // Screen width
SHORT lastmsgarea; // Last message area user was
in
SHORT lastfilearea; // Last file area user was in
CHAR lastprotocol; // Last protocol user chose
CHAR lastarchiver; // Last archiver user chose
LONG forsysop; // unused
CHAR interface; // obsolete
CHAR exp; // unused
SHORT leech_percent; // File leech ratio
SHORT maxbanktime; // Maximum time user can have
in bank
SHORT timecredit; // Current time user has credit
for
SHORT callstoday; // Number of calls user made to
BBS today
LONG totalminsever; // Total minutes users has used
ever
LONG netmaildebits; // Total spent on NetMail
time_t lastpwchange; // Time/Date of last password
change
time_t lastlistednewfile // Time/Date user last listed
new files
ULONG filekcredit; // Amount of file k-byte credit
user has CHAR unixid[8];
// Users Unix Specific ID
UCHAR _unused[94]; // reserved for future use
UCHAR mailtags[128]; // Message areas tagged for
off-line mail
UCHAR usermsg[128]; // Message areas user can
access
UCHAR userfile[128]; // File areas user can access
ULONG passwordcrc; // User password CRC
ULONG passwordcrc2; // User password CRC2
USHORT max_mail_pkt; // Max msgs to pack for off-
line mail
CHAR reasked; // Has user answered the ReAsk
questionairre
CHAR reserved[75]; // reserved for future user
} ADEPTUSER, *PADEPTUSER;
AdeptXBBS Message Base Structures:
*.Data - Structs
typedef struct _AdeptXBBS_Message_Header
{
CHAR MajorVersion; // Minor revision number of this
message style
CHAR MinorVersion; // Minor revision number of this
message style
USHORT StructLen; // The length of this data structure
134
CHAR from[60]; // Who the message is from
CHAR to[60]; // Who the message is to
CHAR subj[70]; // The subject of the message
CHAR date[35]; // Date the message was written
CHAR indate[4]; // Import date
ULONG msgnum; // Current message number
ULONG timesread; // Number of times the message has been
read
time_t timerecv; // Time user received this message
ULONG length; // Length of message stored in .Text
Data file
LONG start; // Pointer to starting byte in .Text
Data file
ULONG Extra1; // Extra space // Was going to be for
reply
ULONG Extra2; // Extra space // linking instead came
up with
ULONG Extra3; // Extra space // a better method
USHORT o_zone; // Messages origin zone
USHORT o_net; // Messages origin net
USHORT o_node; // Messages origin node
USHORT o_point; // Messages origin point
USHORT d_zone; // Messages destination zone
USHORT d_net; // Messages destination net
USHORT d_node; // Messages destination node
USHORT d_point; // Messages destination point
USHORT cost; // Cost to send this message
USHORT fflags; // FidoNet related flags
USHORT xflags; // XBBS related flags
ULONG iflags; // Internet related flags
ULONG oflags; // Other network related flags
} XMSG, *PXMSG;
Bitmaps For The fflags:
#define MSGPRIVATE 0x0001 /* private message, */
#define MSGCRASH 0x0002 /* accept for forwarding */
#define MSGREAD 0x0004 /* read by addressee */
#define MSGSENT 0x0008 /* sent OK (remote) */
#define MSGFILE 0x0010 /* file attached to msg */
#define MSGFWD 0x0020 /* being forwarded */
#define MSGORPHAN 0x0040 /* unknown dest node */
#define MSGKILL 0x0080 /* kill after mailing */
#define MSGLOCAL 0x0100 /* FidoNet vs. local */
#define MSGXX1 0x0200 /* */
#define MSGXX2 0x0400 /* STRIPPED by FidoNet<tm> */
#define MSGFRQ 0x0800 /* file request */
#define MSGRRQ 0x1000 /* receipt requested */
#define MSGCPT 0x2000 /* is a return receipt */
#define MSGARQ 0x4000 /* audit trail requested */
#define MSGURQ 0x8000 /* update request */
/*----------------------------------------------------*/
135
Bitmaps For The xflags:
/*------------------------------------------------------*/
#define MSGDELETED 0x0001 /* deleted message, */
#define MSGANON 0x0002 /* anonymous message */
#define MSGECHO 0x0004 /* unmoved echo message */
#define MSGNET 0x0008 /* unmoved net message */
#define MSGHOLD 0x0010 /* file attached to msg */
#define MSGHOST 0x0020 /* being forwarded */
#define MSGSCANNED 0x0040 /* FidoNet scanned */
#define MSGKEEP 0x0080 /* don't delete */
#define MSGTREATED 0x0100 /* soft cr's & lf's removed */
#define MSGPACKED 0x0200 /* message LZSS compressed */
#define MSGGSCAN 0x0400 /* GroupMail scanned */
#define MSGRSCAN 0x0800 /* rfc0822 scanned */
#define MSGARCHIVED 0x4000 /* Message stored */
#define MSGTAGGED 0x8000 /* used by offline readers */
/* */
/*------------------------------------------------------*/
Structure For The AdeptXBBS Message Base .Index File:
*.Index - Structs
typedef struct _AdeptXBBS_Index_Structor
{
SHORT to; // Checksum of the to field
SHORT from; // Checksum of the from field
SHORT subj; // Checksum of the subject field
LONG // 32-bit CRC of the MSGID
LONG msgidserialno; // MSGID Serial Number
LONG replycrc; // REPLYID 32-bit CRC
LONG replyserialno; // REPLYID Serial Numver
} ADEPTINDEXES, *PADEPTINDEXES;
Structure For The AdeptXBBS File System - File.Data File:
typedef struct _File_Data_Struct
{
UCHAR Name[31]; // File Name
ULONG Size; // File Size
UCHAR User[20]; // Uploader Name (Truncated at 20
chars)
UCHAR Password[13]; // Password required to download file
ULONG Path; // Pointer to path in File.Paths file
ULONG SecLevel; // Min Security level required to
download
UINT Area; // Area this file belongs to
ULONG Flags; // For internal use
ULONG Desc; // Pointer to description in
File.Descriptions
LONG TimesDL; // Times the file has been downloaded
SHORT Group; // Group this file belongs to
SHORT Age; // Min Age Required to download the
file
SHORT Cost; // Cost of the file
FDATE Date; // File Date
} ADPFILESYS, *PADPFILESYS;
----------------------------------------------------------------------
136
The FileBase uses a commercial, copywritten index that we cannot
distribute the actual code to without charging a fee. Therefore we
have wrapped all the index and FileBase code into a .DLL that allows
complete control over the file system. This .DLL is not complete
finished yet, in fact the BBS doesn't use it yet, only FILEDIT does.
From these structures you could at least get needed info from the
FileBase system.
137
Quirks I've found with AdeptXbbs (Or what to try when adept does wierd
things)
----------------------------------------------------------------------
1> Adept refuses to accept inbound mail or files, or sometimes won't send
outbound mail.
- Try going to \adept\mailer\aborted_files dir and if there's anything at
all in there delete the files that are there then go back to the
adept\mailer dir and look for a file called aborted_files_list or
something similar, if it's there delete the bugger. Now got to the
adept\flags dir and delete everything in there too. Your mailer should
start working normally again.
2> Adept crashes on startup no matter what command line u give it or how
many nodes you try to startup.
- I've found this to be the case when something gets left in the
\adept\imail dir, clean it out, and while your at it go to the
\adept\internet\smtpout dir and clean it out too as well as
\adept\internet\nntpout dir, clean those out and adept should come up
again.
- If it still crashes on you, chances are either your events files in
\adept\events dir got clobbered (delete them abd rebuild them, I've
taken to storing backups of all my events files in a temp dir under
\adept\events and deleteing them wholesale if it happens) so you'll
have to delete em and recreate them from scratch. Adept should now
come up..
- If it still crashes chances are excellent that your Line_X_Configuration
files (where x is the node number) or your bbs_Configuration or
Local_configuration files have been clobbered delete em all and start
adept with adept /setup /nodes X where x is how many nodes u want to
setup.
Adept will come up and let you reconfigure your nodes, do it then
shutdown adept from the shutdown pullodown menu option to save your new
configs. (At this point with adept shutdown is a good time to back up
those config files in case it happens again someday. While your at it
backup and save Users and Users.Name.Index. Now start adept with
"adept /nodes X" where x is how many nodes you configured above. Adept
should come up running.
3> Adept hangs (and locks the desktop) when a certain user calls in. ONLY
when that user calls in and it hits the personal mail scan.
- I've had this happen when the personal mail index file for that user got
clobbered somehow. What I do is delete everything in
\adept\personal_mail then with adept shutdown do a xmsgs to pack the
base, a side effect of packing thew message base, is that the pmi files
get rebuilt from scratch.
Startup adept and that problem user should be able to logon normally
now.
- Either you or a user keeps getting told that you have new mail waiting
at logon, this to is due to a corrupt pmi file, either repeat the above
or in this case since it's not catastrpohic, you can simply delete that
users file in \adept\personal_mail dir. That should cure it.
4> You've configured nntp but it's not working.
- Ok. turn the nntp server off in config\bbs\internetoptions pulldown menu
then mae sure you've got your nntp areas created and properly tagged as
usenet in the message area editor, note that you have to check *ONLY*
the usenet flag and you *MUST* enter the newsgroup name in the tag field
of the editor, the top line name can be anything you want but the tag
*MUST* match the name of the newsgroup.
138
Now delete everything in the \adept\usenet dir, then goto the config
internet options menu, put in a poll time (I use 15 minutes here) and
then check the nntp server box, it should say active (I'm assuming
you've entered your newservers address in the newserver field on this
same page, if not do it *BEFORE* you check the nntpserver flag to
active), now watch your modem it should have a steady stream of incoming
data (I.e the rx light should be flashing like mad), at this point you
have to wait for the avilable groups list to be downloaded to your
machine, click on ok of that page and get out of the setup. wait for the
modem lights to stop flashing (this can take up to 20 minutes depending
on how many groups your server is carrying). Once the lights stop
flashing go back to the internet options setup and wait for the
avilable groups box to fill, it should tell you how many groups are
available, you will see that number counting up as it loads the list.
Once the list is loaded simply select the group you want and hit add,
the group shoul appear on the right under selected groups. Do that for
each group you created a message area for. Do *NOT* add groups for which
you haven't configured a message area for. If you want to add such a
group, get out of the setup option by clicking on ok, and go to the
message editor and set up the message area first. then you can come back
and add that group. Once you have it the way you want it do a shutdown
of adept, again from the shutdown pulldown, then with adept down goto
the \adept\usenet dir and backup everything in that dir.
This gives you something to restore if you ever have to clean out that
dir again. Now fire up adept, when it comes up it will wait however many
minutes you configured the poll for then start downloading your selected
groups.
(Note: the first time it connects it will download *EVERY* message in
the groups that you selected as active, after that it will just pull
down new messages when it polls, but be aware it can take some time to
download 2000 messgaes in a group. If you want to see the progress click
on the nntp status button in the adept status window.) Thats it, you
should have nntp flowing at this point.
5> Adept traps at random locations and refuses to stay up for more then an
hour.
- Here when it does that, it usually means the file system (os2's file
system not the adept files base) has taken a hit and needs to have a
chkdsk run on it. So heres what you do, shutdown adept if its running,
shutdown os/2, boot to a command line by hitting alt F1 when u see the
OS2 box in the upper left hand corner of your monitor (or boot from the
install disks, whichever turns your crank.) and when your at the command
line issue a chkdsk /f:2 on the drive adept lives on. Hopefully you know
how to run chkdsk, if not check the online reference or the os/2 users
guide. After the chkdsk has completed (might be a good time to run it on
your other drives too) you can reboot os/2 normally.
But don't restart adept yet, what you want to do now is make sure you
have no corrupt dll's or exe's. SO unzip a fresh copy of the dlls' and
the adept and cserver exes and put them in the proper directory, (Again
I advise making a backup off all the dll's and exe's so u won't have to
unzip the archive again if needed) once all the files have been
refreshed startup adept normally. Chances are excellent that it will
stay up as intended now.
6> One other thing, if you still have traps and adept shuts down
periodically (like after a day or 2) I've found adept to be rock solid
if you shut it down via the event subsystem at say 3am every morning
when no users are on. This has two advantages, it refreshes all the
memory variables by reloading adept, and two it gives u a chance to run
things like unuke (which *REQUIRES* that adept be shutdown before
running). You can automate the shutdown and restart by doing something
139
like this: Create a runadept.cmd file and in it put this:
:top
adept /nodes X
goto top
As you can see when the event shutsdown adept at 3 am, the looping cmd
file will restart it and you'll have a fresh copy of adept in memory,
clearing out any corrupt variables or memory leaks that may exist.
Obviosuly you can do many neat things in that cmd file (like packing the
user base or message base) before having it restart adept. Use your
imagination, I run all my doors maintenance during the shutdown period,
which ensures no user is online to screw up a doors maint run by being
logged into the door.
I also backup my user and user index files, pack the message base and
start an ftp mail session with my feed to bring in the echomail via ftp.
I don't wait for the ftp to finish, but use the os/2 start command to
spawn the ftp transfer program. you can do many things in that cmd file.
Be creative <G>.
These are some of the quirks I've come across since starting with adeptxbbs
back when it was at version .50 or thereabouts. Adept has come a long way
but like any software it has it's quirks. Hopefully these tips will save
somebody the hours of headscratching trying to figure out why it doesn't
work!!
Mario Dulisse
Sysop The DogStar BBS
An AdeptxBBS board
Hagar on irc #Adept