ÜÜÜÜÜ ÜÜÜÜ ÜÜÜÜÜÜÜ ÜÜÜ ÜÜÜÜÜ ÜÜÜÜ ÜÜÜÜÜÜÜ Ū°Ū Ū Ū°Ū Ū ß Ū°Ū ß Ū°Ū Ū°Ū Ū°Ū Ū ß Ū°Ū ß ²±² Ū ²±² ²±² ²±² ²±² ²±² ²±² ±²± Ū ±²± ±²± ±²± ±²± ±²±ÜÜ ±²± °Ū° Ū °Ū° °Ū° °Ū° °Ū° ßß°Ū° °Ū° ±²± Ū ±²± ±²± ±²± ±²± ±²± ±²± ²±² Ū ²±² ²±² ²±² ²±² ²±² ²±² Ū°Ū Ū Ū°Ū Ū Ū°Ū Ū°Ū Ū°Ū Ū Ū°Ū Ū°Ū ßßßßß ßßßß ßßß ßßßßß ßßßßß ßßßß ßßß DCT BBS Lister v0.05į By Dan Traczynski December 27, 1996 Copyright (C) 1996 Dan Traczynski. All rights reserved. -=-=- The latest version of this and other DCT Productions may be downloaded from the Internet at: http://www.worldnet.net/island/dct.htm Ü ÜÜÜÜÜÜÜÜÜÜÜ ÜÜ ÜÜÜÜÜÜ Ü Ü ÜÜÜÜÜÜ ÜÜ ÜÜÜÜÜÜÜÜÜÜÜ Ü Ū Ū ŻŻ ŽŽ Ū Ū Ū Ū ßßßßßßßßß ßß ßßßßßß ß ß ß ß ßßßßßß ßß ßßßßßßß Ū Ū ² ² ² ² ± ± Table of Contents ± ± ° ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ° Features ................................... o1 Files in this Archive ...................... o2 Installation ............................... o3 The Configuration Program .................. o4 SCRUTIL.EXE Explained ...................... o5 Distribution & Disclaimer .................. o6 Things to look for in upcoming releases .... o7 ° History - Notes from the Past .............. o8 ± ² Ū ÜÜÜÜÜÜÜÜÜÜÜ ÜÜ ÜÜÜÜÜÜ Ü Ü ÜÜÜÜÜÜ ÜÜ ÜÜÜÜÜÜÜÜÜÜÜ Ü ² Ch.1 ± Features Of DCTList ° ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ -ž- Supports both DORINFOx.DEF and DOOR.SYS allowing it to be run on virtually any bulletin board system. -ž- Lightbar selector for you eLiTe d00ds. -ž- Users may upload and view ANSI ads for each BBS. -ž- Language support. -ž- SysOp-definable user interface. -ž- Problem users can be locked out. -ž- Optional user censor (allowing you to filter out swearing). -ž- Colour configuration. -ž- Users may edit/delete BBSs they have created. -ž- The BBS list format may be configured. -ž- Optionally sorts BBSs into alphabetical order. -ž- Users may download a list of the BBSs in the database in five different formats. -ž- Fully integrated search mode. The user interface is exactly the same in search mode as it is in normal listing mode. -ž- Full user logging (even the SysOp-User chats are logged!). -ž- User time-out after a configurable amount of time. -ž- Multi-tasker capability. -ž- Internal SysOp-User full-screen chat mode. -ž- Even creates alternating GOODBYE.ANS/ASC files to show to your users! ° -ž- It's FREEWARE! No unregistered beeps, delays, or disabled features! ± ² Ū ÜÜÜÜÜÜÜÜÜÜÜ ÜÜ ÜÜÜÜÜÜ Ü Ü ÜÜÜÜÜÜ ÜÜ ÜÜÜÜÜÜÜÜÜÜÜ Ü ² Ch.2 ± File List ° ÄÄÄÄÄÄÄÄÄ The following files were distributed in the original archive (except DCTLIST.CFG and DEFAULT.BLL). Required Files ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ DCTLIST.EXE The main DCTList executable. CONFIG.EXE The configuration program for DCTList. DCTLIST.CFG The configuration file that is created when CONFIG.EXE is run. *.BLS You'll need one of the .BLS files for DCTList to run. The two included in this archive are DCTLIST.BLS and NEWLOOK.BLS. Run CONFIG's local test mode to see how they both look and select the one you like best. *.BLL These are the DCTList language files, of which you'll need one of them for DCTList to run. DEFAULT.BLL is created when CONFIG is first run. Supplementary Files ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ These files may be deleted to save HD space without adversely affecting DCTList. * AGEN005.ZIP * Alternating GOODBYE.ANS generator utility. This program will take a few random entries from the BBS database and stick them into an ANSI and ASCII file to show to the users when they logoff. Definitely worth taking a look at. DCTLIST.TXT DCTList documentaion. It may be a good idea to keep this around. UPGRADE.DOC Quick upgrade information from DCTList v0.03 or v0.04. TO005.EXE Required if upgrading from DCTList v0.03 or v0.04. BBSAD.Q-A Example RemoteAccess questionnaire for running DCTList in AutoAdd mode. BBSAD.SCR Example Concord script file for running DCTList in AutoAdd mode. DCTLIST.LOK Used if you want to lock out certain users from DCTList. May be deleted if no users are locked out. DCTLIST.FLT Used if you want to filter out inappropriate language. May be deleted if the censor is disabled. DCTLIST.BAD Used if you want to prevent certain BBSs from being added to the list. SCRUTIL.EXE Screen Definition File Utility. Allows the interface of DCTList to be modified. SCRUTIL.CTL Sample control file that may be used with SCRUTIL.EXE. FILE_ID.DIZ A short description of DCTList for use on BBSs. ° OTHER.DCT Other products released by DCT Productions. ± ² Ū ÜÜÜÜÜÜÜÜÜÜÜ ÜÜ ÜÜÜÜÜÜ Ü Ü ÜÜÜÜÜÜ ÜÜ ÜÜÜÜÜÜÜÜÜÜÜ Ü ² Ch.3 ± Installation Guide ° ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ If you are upgrading from DCTList v0.03 or v0.04, overwrite the old files with the new, then run TO005.EXE. After that, run CONFIG to update the DCTList configuration file. There is no way to upgrade directly to v0.05 from v0.02, so a fresh installation is recommended. Installation is very fast and easy. First of all you must create a directory for DCTList to reside in and then run CONFIG.EXE to configure it to your system. You may also wish to edit DCTLIST.FLT if you will be using the censor. DCTList does not have to be run from the directory it resides in, as it automatically looks for all of its files in its home directory. Have your BBS call DCTList via a command-line similar to "C:\DOORS\DCTLIST\DCTLIST.EXE /PC:\BBS". The "/P" parameter is only required if the drop file will not be in the current directory when DCTList is run. If your BBS supports memory-swapping, it would be a good idea to do so (if you don't, there may not be enough memory to shell out to the external transfer protocols and archivers). If you choose to allow file transfers within the door, you may configure up to nine protocols in CONFIG.EXE (nine should be more than enough). The only limitation to the protocols that you may use is that they MUST be able to log the transfer in DSZ.LOG and support batch transfers (so Xmodem is out of the picture). You must also remember to set the DSZLOG environment variable prior to the user entering DCTList so the door can find the DSZ.LOG file. Refer to the protocols' documentation for more information on the DSZLOG environment variable. If you have allowed users to download the BBS list via an external protocol, you may also wish to insert your BBS ad into the archive that the user downloads. This can easily be done by copying your BBS ad to the DCTList directory and renaming it to BBS.AD. If DCTList locates the BBS.AD file in its home directory, it will include that everytime a user downloads the list. If you would like to have users who run boards themselves automatically add their BBSs to the list, you may execute DCTList with the "/A" parameter. This switch is designed so that when a new user logs on, you can ask him if he runs a BBS, then execute DCTList if he does. Using the "/A" parameter will take him directly into the "Add BBS" menu and then terminate after he adds or aborts the BBS entry. The two sample script files BBSAD.Q-A and BBSAD.SCR have been included in this archive for use with RemoteAccess and Concord. If you decide to use one of them, you may have to change the directory names within it. The minimum security to add a BBS to the list is ignored when DCTList is run in AutoAdd mode. Command-Line Parameters ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ /A śłś Invoke AutoAdd mode. DCTList begins in the "Add BBS" menu then terminates after adding the BBS entry or aborting the operation. /Bxxx śłś Specify locked baud rate (i.e. /B38400). This overrides whatever is set in CONFIG. /Dxxx śłś Instruct DCTList to load an alternate screen definition file than the one specified in CONFIG (i.e. /DNEWLOOK). /L śłś Local mode (logs in with the SysOp's name). /Nx śłś Specify node number (not really needed unless you want it to read DORINFO2.DEF for node 2 etc). /Pxxx śłś Specify path to drop file (i.e. /PC:\BBS). /Q śłś Starts DCTList with the lightbar on the quit option and also bypasses the introduction logo if it is enabled. /S śłś Specify user's security level. /U śłś Tells DCTList not to create a user file. /W śłś A DOS only network is present. External ANSI Files ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ New in v0.03, support has been added so that parts of the program support more customisation by allowing you to design your own ANSI screens. The following files, if they exist, will replace the internal displays. Note that these files are not required in order for the door to function properly. LOGO.ANS This replaces the default "DCTList" logo that is displayed upon startup. If the "Intro Screen" option in CONFIG.EXE is turned OFF, this file will not be displayed, regardless of whether it exists. GOODBYE.ANS If this file exists, it will be displayed instead of the "Returning to BBS" string on exit. Be creative. :) LOCKOUT.ANS This is shown if the user is locked out. NOANSI.ASC If the user's terminal does not support ANSI, this file is displayed instead of the hard-coded message. INUSE.ANS Message telling the user that someone else is using the door on a separate node and that he cannot enter the ° door at this time. ± ² Ū ÜÜÜÜÜÜÜÜÜÜÜ ÜÜ ÜÜÜÜÜÜ Ü Ü ÜÜÜÜÜÜ ÜÜ ÜÜÜÜÜÜÜÜÜÜÜ Ü ² Ch.4 ± The Configuration Program ° ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ CONFIG.EXE contains all of the utilities you will require to operate the door, and offers a pull-down menu interface for easy configuration. The following is a summary of CONFIG's menued interface. File ĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶ Save & Exit ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Saves the current configuration and exits back to the operating system. Exit (No Save) ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Exits back to the operating system without saving any changes made. Local Test Mode ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Allows you to test DCTList locally to see if the current configuration satisfies your needs. If there are more than one screen definition files in the DCTList directory, you will be given the option to select the one for DCTList to load. Program Info ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Displays the copyright and program information. Shell to DOS ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Invokes a temporary DOS shell. View Log File ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Allows you to view the log file created by DCTList. Toggles ĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶ Intro Screen ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Normally when DCTList loads, it will display an introduction screen. If you would like DCTList to go directly to the main list menu, you can use this option to disable it. User Logging ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ DCTList contains support to log all of the users' activities while in the door. If this option is enabled, a log file will be created, and those who enter with SysOp access may also view the log file by pressing the key defined in System > Options > Log View Key. Confirm Exit ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Normally DCTList will confirm if the user wishes to exit the door when he selects the QUIT option or presses [ESC] in the main menu. Disabling this option will bypass that and let the user out right away. Auto Capitalise ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ By default, DCTList will automatically capitalise the BBS name, SysOp name, location, software, and BBS hours. Sometimes users may want to add entries that do not conform to the way DCTList capitalises them. Simply disable this and the users will be allowed to enter strings in any case they wish. Show ANSI Char ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ When DCTList lists the BBSs on the screen, it will display the 'ų' character after the BBS number to signify that an ANSI ad exists for that entry. If you do not like this, simply turn off this option. Init FOSSIL ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This setting should normally remain at YES, but if you lock the port at a high speed and are getting garbage, set it to NO. Auto Sort ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ If you do not wish to have DCTList sort the BBS entries in the list, you may disable it through this switch. Dupe Check ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ When a user enters or edits a BBS, DCTList will scan the BBS name and SysOp name for duplicates and reject the entry if a duplicate is found. If you do not wish for DCTList to perform duplicate checking, this switch will disable it. User Censor ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Sometimes users enter language that is inappropriate to the BBS. If you do not want these users doing so, you may enable this option and enter the unwanted words into the file DCTLIST.FLT. Mask Character ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ If the user censor is enabled, this character will be used to strike out the undesired words. Colours ĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶ This menu allows you to modify DCTList's colour scheme. System ĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶ General ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This sub-menu will allow you to configure the general information that DCTList requires to run. SysOp Name ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The name of the SysOp that you would like users to see. BBS Name ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Your board's name. SysOp Security ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ There are some options in DCTList which are best left accessable only to the SysOp. By setting the SysOp security, you will ensure that users cannot use and abuse these options. Add Security ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ If you would like to prevent lower level users from adding BBSs to the database, you can configure the minimum add security here. The only time the add security is overridden is when DCTList is run with the "/A" command-line parameter. Locked Baud ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ For ease of use, you can configure the locked baud rate here, thus eliminating the need for it on the command-line. If it is also specified on the command-line, it overrides whatever is entered here. Valid baud rates are 2400, 2400, 4800, 9600, 19200, 38400, and 57600. Deletion Days ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Because BBSs are always going up and coming down, DCTList offers this feature to keep the database up-to-date without any SysOp intervention. If a BBS is not verified for the number of days specified here, it is deleted during maintenance. Set deletion days to a value of zero to disable the feature. User Time-Out ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ To prevent users from entering the door and sitting at some prompt until their time runs out, you can specify a user time-out. This will kick the users out of the door if they do not type anything within the number of seconds specified here. Language File ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ You may use this option to tell DCTList to load an alternate language file. Images File ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The way DCTList presents itself to the user can be configured, and this option will allow you to select which screen definition file DCTList will load. Options ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ These are the extra options in DCTList that SysOps may wish to play around with. Log View Key ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ If a user with SysOp security enters the door and user logging has been enabled, he may press the key defined here to view the log file. Search Defs ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ When a user decides to search the database for certain entries, he will be given a menu asking him which BBS fields to search. You can configure the default fields to be searched in this sub-menu. Number Format ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This is the phone number format that is to be used. Use a '#' to force a digit to be entered, an 'x' to allow anything to be entered, or any other character. If you would like to let users enter whatever they wish, leave this string blank. Changing this string after the lister has been installed could have unpredictable results. Here are some examples: Entering: Could result in: Description: ###-###-#### 604-123-4567 Default. 604-###-#### 604-123-4567 This way the user doesn't have to enter the area code. (###) ###-#### (604) 123-4567 Some people prefer it this way. (+##)####-#### (+11)1234-5678 European format. Border Type ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The border lines may be configured to look one of three ways. The first method is a simple solid line in the colour defined in Colours > Border Lines. The second method involves a random mixture of one colour and its bright counterpart (ie. red and bright red), and the third is a combination of the second type with grey mixed in for effect. Extra Field ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ One of the many powerful features of DCTList is the extra data field. This field allows you to add your own custom entry to each BBS in the list. Some examples of this would be the NUP, years online, disk space, number of users, etc. Simply specify a name for the field and it will be used. Force Entry ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ If you feel that the extra field is important enough to force users to enter something, enable this option. Description ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Since ten characters may not be an adequate enough space to fully describe the extra data field, you may specify a short one-line description of the field which will be displayed on the bottom of the screen. List Format ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This is the format that is used when displaying the BBS list. The following codes may be used to display different fields. Imbedded codes: Colour changing codes: %N BBS Name @0 Uses the colourful writing scheme. %S BBS SysOp %P Phone Number @1 Blue @9 Light Blue %L Location @2 Green @A Bright Green %V Last Verified @3 Cyan @B Bright Cyan %O Software @4 Red @C Light Red %M Minimum Baud @5 Violet @D Pink %B Maximum Baud @6 Brown @E Yellow %H Hours @7 White @F Bright White %Y Pay? (Yes/No!) @8 Grey %C Creation Date %E Extra Field Transfers ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This sub-menu does not have to be configured, but a large part of DCTList will not be available if you do not configure the file transfer options. Archiver ÄÄÄÄÄÄÄÄÄÄÄÄÄÄ When the user chooses to download the BBS list, it will be compressed before it is sent. DCTList has been programmed to work with a variety of different archiving utilities. It will support PKZip, LHA, ARJ, and RAR. If you select RAR or ARJ as the external archiver, there is a change that you may experience some problems. These two archivers require a lot of memory to run, so if you choose to use one of these two protocols, try them out first to be sure they work. Arc Path ÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This field is automatically configured for you when you select an archiver, provided that it is in the path. Otherwise, enter the path that the archiver can be found in. File Prefix ÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This is the prefix of the BBS list file name when a user downloads the list. For example, entering "FUDD" would result in something like FUDD.ZIP being downloaded. Max Ad Size ÄÄÄÄÄÄÄÄÄÄÄÄÄÄ If you do not want users uploading huge ANSI ads (or huge files that may not even be ANSI ads), you can define a limit to the size of the uploaded file. Set this to a value of zero if the size does not matter. D/L Defaults ÄÄÄÄÄÄÄÄÄÄÄÄÄÄ When a user downloads the BBS list, he will be shown a menu asking him which formats he would like to download the list in. You can configure the default formats in this sub-menu. Editor ĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶĶ Languages ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The language editor will allow you to customise almost all of the strings displayed by DCTList. Imbedded codes may be used in some of the strings to represent different things. The following imbedded codes may be used in the language prompts. %U Converts to the name of the user. %S Converts to the name of the BBS. %1 A miscellaneous code that varies with different strings. One thing to note is that the sums of the lengths of language strings 114-116 cannot exceed 68 characters due to space restrictions on the screen. Protocols ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Two of the most useful features DCTList has are the abilities to let the users download the database in various formats and to allow users to upload ANSI BBS ads. This is accomplished through the use of external transfer protocols. Installing an external protocol is extremely easy, and CONFIG already comes with six pre-configured protocols. Auto Config ÄÄÄÄÄÄÄÄÄÄÄÄÄ If the protocol you wish to install is either IceZmodem, DSZ, GSZ, CEXYZ, SuperZmodem, or HS/Link, CONFIG has the ability to automatically configure the protocol for you. Simply select this option, then type in the directory that the executable for the protocol can be found in. Hotkey ÄÄÄÄÄÄÄÄÄÄÄÄÄ When the user is selecting a protocol, a box will appear with all of the protocols listed in them. In addition to the user being able to move the lightbar to the desired option, he may also press the key configured here to activate the protocol. Name/Desc ÄÄÄÄÄÄÄÄÄÄÄÄÄ Name of the protocol that is shown to the user. DL Log Key ÄÄÄÄÄÄÄÄÄÄÄÄÄ Keyword to look for in the log file which indicates a file download. UL Log Key ÄÄÄÄÄÄÄÄÄÄÄÄÄ Keyword to look for in the log file which indicates a file upload. DL Cmd-Line ÄÄÄÄÄÄÄÄÄÄÄÄÄ Command-line to send a file of all the BBSs in the list to the user. The following codes may be used in the command-line. *P = COM Port *B = Baud Rate *F = File Name UL Cmd-Line ÄÄÄÄÄÄÄÄÄÄÄÄÄ Command-line to receive an ANSI BBS ad from the user. The following codes may be used in the command-line. *P = COM Port *B = Baud Rate *D = Download Directory BBS Database ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Allows you to make changes to the BBS database without having to ° load up DCTList. ± ² Ū ÜÜÜÜÜÜÜÜÜÜÜ ÜÜ ÜÜÜÜÜÜ Ü Ü ÜÜÜÜÜÜ ÜÜ ÜÜÜÜÜÜÜÜÜÜÜ Ü ² Ch.5 ± SCRUTIL.EXE Explained ° ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ SCRUTIL.EXE is the program which will allow you to customise the way DCTList looks to the users. It is completely command-line driven, and will import or export ANSI images to/from the screen definition file. Command-Line Parameters ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ SCRUTIL [Def File] [/?] [/CREATE] [/ADD ] [/EXTRACT ] [/IMPORT [Ctl File]] [/EXPORT [Ctl File]] [Def File] The definition file is the image file that SCRUtil will work with and what DCTList will load and use. If it is not specified, the default DCTLIST.BLS will be used. [/?] Displays a brief help screen summarizing the commands. [/CREATE] Creates a default definition file with no images in it. It is then up to you to add the images in. [/ADD ] This option will add an ANSI file into the definition file. The variable is the image number that the ANSI file will be added as. specifies the ANSI file to add. [/EXTRACT ] This option is the reverse of ADD. Instead of adding the ANSI, SCRUtil will extract it and save it as . [/IMPORT [Ctl File]] This option will allow you to import a group of images at once. In order to do this, you must first create a control file listing all of the file names and image numbers. The format is the same as with the ADD parameter. If [Ctl File] is not specified, the default SCRUTIL.CTL is used. The following is a sample control file: 0 MFTR1.ANS 1 MFTR2.ANS 53 GENBOTL.ANS 54 INTRLOGO.ANS 55 LOCKOUT1.ANS 56 NOANSI.ANS 57 HELP.ANS If this were the file, MFTR1.ANS would be added as image 0, MFTR2.ANS as image 1, and so on. [/EXPORT [Ctl File]] This parameter is the reverse of the IMPORT parameter, and takes the same arguments as the IMPORT parameter. If the above sample control file were used, image 0 would be exported to MFTR1.ANS, image 1 would be exported to MFTR2.ANS, and so on. A sample SCRUTIL.CTL file has been included with this archive. Imbedded Codes ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ There are two different types of imbedded codes that may be used in the image files. The first type is a simple "@" followed by a character, and the second is an "@" followed by a character, a string, then the terminating pipe (|) character. Explanations follow. @1..@E These codes will change the colour to one configured in CONFIG. They represent the following colours: @1 Uppercase Characters @2 Lowercase Characters @3 Numbers @4 Punctuation @5 Hi-ASCII @6 Prompt Square Brackets @7 Prompt Dots @8 Lightbar Foreground @9 Lightbar Background @A Disabled Options @B Border Lines @C Square Brackets in View BBS @D Input Fields @E Search Highlight @V This code is converted to a four-character representation of the current DCTList version. @K| This code allows you to have text printed to the screen in the multicoloured scheme. For example, "@KHello!|" is the equivalent of "@1H@2ello@4!" @R| This code will allow you to write strings using the border line colour scheme. That way, a code such as "@RÄÄÄÄÄÄÄÄÄ|" would print the line randomly alternating between one colour and its bright counterpart (ie. red and bright red). @O| This code is used to display options that the lightbar will be on. The reason for this is that when the main menu is displayed and the options are drawn on the bottom of the screen, some may be greyed out, but only on certain occasions. Using something like "@OA|", for example, would display the "Add BBS" prompt greyed out if the user could not add an entry, but would display it normally if he could. These are the legal s that may be used. @OA| Add BBS @ON| Next Page @OP| Previous Page @OQ| Quit/Stop @OU| Upload/View ANSI @OE| Edit BBS @OD| Delete BBS ° @OV| Verify BBS ± ² Ū ÜÜÜÜÜÜÜÜÜÜÜ ÜÜ ÜÜÜÜÜÜ Ü Ü ÜÜÜÜÜÜ ÜÜ ÜÜÜÜÜÜÜÜÜÜÜ Ü ² Ch.6 ± Distribution & Disclaimer ° ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ DCTList is copyrighted (C) 1996 by Dan Traczynski. All Rights Reserved. I encourage you to distribute it, but DO NOT change any of the files within the original archive. DCTList may not be included on CD-ROM collections. The archive should be named DCTBL005.ZIP, preferably kept in its ZIP format. The author, Daniel Traczynski, will take no responsibility to anything that this program may or may not do to your system. Although the program has been tested thoroughly, no guarantee can be given that it will do what it was made to do. Nevertheless, if anything should happen, the user is totally responsible and the author will be under no obligations whatsoever. By using this program you agree to this ° disclaimer. ± ² Ū ÜÜÜÜÜÜÜÜÜÜÜ ÜÜ ÜÜÜÜÜÜ Ü Ü ÜÜÜÜÜÜ ÜÜ ÜÜÜÜÜÜÜÜÜÜÜ Ü ² Ch.7 ± Things to look forward to ° ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Many of the features that I add to this door are requests made by SysOps, so if you would like to see a new feature added to this door, by all means send me e-mail and I will try to add in your request. I can be reached at dan.traczynski@als.dudd.uniserve.com. If you do not have Internet e-mail access, I can also be contacted via the ° FidoNet RA_Util echo. ± ² Ū ÜÜÜÜÜÜÜÜÜÜÜ ÜÜ ÜÜÜÜÜÜ Ü Ü ÜÜÜÜÜÜ ÜÜ ÜÜÜÜÜÜÜÜÜÜÜ Ü ² Ch.8 ± History ° ÄÄÄÄÄÄÄ + Added a new feature/Something was improved. - Removed something. * General comment. > Bug fix. Version 0.05į -=- December 27, 1996. > If the SysOp broke into chat while the user was viewing the log file, the chat screen borders wouldn't be drawn. Fixed. > When answering NO to the delete BBS prompt, the selection bar would not be redrawn. Fixed. > Pressing HOME or END wasn't updating the "Next" and "Prev" stats accordingly. Fixed. + Added /D, /Q, /S, and /U command-line parameters. > Corrected the cause of the RTE #100 that was happening occasionally. - Removed /V parm. + Screen now redraws better when exiting SysOp-User chat mode. + If Ctrl-R is pressed, the screen will now be redrawn no matter what prompt the user is at. + The user interface is now configurable by the SysOp. * Removed a LOT of useless code and optimised some of the routines. + Added language support. + The display of ANSI files is now FAST! + The configuration program looked really hideous, so it's been changed and now looks much better. + The exit door confirmation, auto capitalisation, and duplicate BBS checking can now be disabled. + The border lines can now be configured to be one solid colour in addition to the two mixed colours or two colours+grey. + The 'ų' character that is displayed next to an entry to denote that an ANSI ad exists can now be disabled. > If the DCTLIST.LOK or .FLT files are deleted, DCTList no longer recreates them as 0 byte files the next time it runs. + Added the DCTLIST.BAD file. > Fixed a problem with the percentage bar not always being displayed correctly when downloading the lists. + Many improvements made to the documentation. > DCTList no longer displays those annoying SAUCE entries at the end of ANSI files, nor does it display characters below ASCII #27. Version 0.04į -=- July 13, 1996. -=- Bug fix release. > Under some circumstances, deleting a BBS would cause the database indices to get screwed up. + Added the GOODBYE.ANS generator. Version 0.03į -=- July 5, 1996. > If the phone number format was changed so that it was a length greater than the default one of 12 characters, the listing would be screwed up. Fixed. + Any BBSs that have been added since the user last entered the door are now pointed out to him/her. + Added a local download of the BBS list, so the SysOp can copy the BBS list to another directory regardless of whether downloading has been enabled. - Removed support for the internal communication routines as it was very unstable and the file transfers would sometimes crash. This means that a FOSSIL driver must be installed, but you will most likely have one loaded already since all BBSs that I know of require one to operate. + Users may now download the BBS list in Terminate 4.00, Telix 3.22, Telemate 4.20, or Lync 3.0 format in addition to the text format. > Oops! It was possible for a user to delete a BBS s/he hadn't created. Now users may only delete BBSs that they've created unless they have SysOp access. + Fixed up the protocol configuration; added many more options. + Added multiple external protocol support. + When downloading the BBS list, the SysOp can now have DCTList include an ad for his BBS in the archive. + The pause prompt is now animated. > It was possible to set the lightbar background to a value higher than 7 in CONFIG.EXE. Fixed. + The user time-out can now be configured. + Finished off the user logging. + Users may now upload and view ANSI ads for each BBS. * If there is an ANSI ad for a BBS, a 'ų' is shown after the BBS number when listing the BBSs. * DCTList no longer needs to be told what drop file to use. It now simply searches for both DORINFOx.DEF and DOOR.SYS and loads the first one it finds or terminates if neither exist. + Added the extra field option. + Added the changing line 24. + The SysOp-User chat sessions are now logged to CHAT.LOG if user logging is enabled. + Added the /A parameter and sample script files for use with Concord and RemoteAccess. > Fixed a bug in the chat mode if the user hit backspace and was on the first column and row of his window. + The BBS list format may now be configured. + Added the search mode. Users can find a BBS by entering a search string or specifying how many days old the listed BBSs should be. + Added an INUSE.FLG file so there shouldn't be any runtime errors on multi-node systems. + Added the external ANSI file support. > DCTList would crash if more than 255 BBSs existed in the database. Fixed. + Added two more colours to configure: Input Fields and Search Highlight. + Users may now press their up/down keys to switch fields when entering or editing a BBS entry. Version 0.02į -=- May 22, 1996. + Added the full-screen chat mode. > If a user was entering the message nets that the BBS was part of and hit ESC, the "Enter nets this BBS is part of" prompt wasn't being removed before the "Abort? Y/N" prompt was displayed over it. + The opening screen can now be disabled in CONFIG.EXE. + The colours may now be configured. + DCTList now sorts the BBSs into alphabetical order. + DCTList now converts BBS names and other fields into their proper case (but words like 'BBS' are not converted to 'Bbs'). + Added Alt-J: Jump to DOS. + Users may now edit and delete BBSs that they created. + Finished off the automatic BBS deletion feature. + Added CONFIG.EXE (no more messy text configuration files). + Users may now download the BBS list as a text file via an external transfer protocol. + Added support to configure how the phone number format will look. Version 0.01į -=- March 22, 1996. * First release to įeta testers only. ° ° ± ± ± ± ² ² ² ² Ū Ū ÜÜÜÜÜÜÜÜÜ ÜÜ ÜÜÜÜÜÜ Ü Ü Ü Ü ÜÜÜÜÜÜ ÜÜ ÜÜÜÜÜÜÜ Ū Ū Ū Ū ŻŻ ŽŽ Ū Ū ß ßßßßßßßßßßß ßß ßßßßßß ß ß ßßßßßß ßß ßßßßßßßßßßß ß