This is a How-to for setting up DOS doors with BBBS/L and DOSEMU.


Requirements:

Before starting you need, of course, BBBS/L, DOSEMU, a DOS HD image (I use
DR-DOS 7.03 which you can find by going to http://www.google.com and
seaching for "dosemu & dr-dos") and a few doors. This how-to will explain
howto setup Barren Realms Elite but you can use almost any door (see notes
about doors that I could not get working). You will need the latest version
of DOSEMU with the Virtual patch compiled in, you need to use experimental
options to get this.

DOSEMU CONFIG:

After you have put your DOS image into /var/lib/dosemu, you will need to get
DOSEMU to use it as the DOS image otherwise DOSEMU will always use the
FreeDOS image supplied with it and this will not write to the HDs, which of
course is no good. If you downloaded the dr-dos image, I recommend renaming
it to dr-dos.img. In your /etc/dosemu.conf the $_hd_image line should look
something like:
$_hdimage = "drdos.hdimage drives/* "

This tells DOSEMU to use drdos.hdimage as the boot image and also to use
drives/*, the symbolic links to directories on your linux partions as the
actual D,E etc drives.

For drives/D which is where DOSEMU will find the doors in the
/var/lib/dosemu/drives directory you need to have a symbolic link for D to
the base dir of where you plan to put your doors. So if you put your doors
into /etc/ftn/doors/{door dir} then do (in /var/lib/dosemu/drives) 
ln -s /etc/ftn/doors/ d
This will create the link for dosemu to find the D:\ dos dir. You don't have
to do this if you use DR-DOS as it puts a redir to the Linux Partitions to
L:\ , so /etc/ftn/doors would become L:\ETC\FTN\DOORS.

Now in the bbbs home dir, type dos and you maybe presented with a copyright
and warning screen, you have to enter Y to continue to dos, this is the only
time you will see this screen. 

Now you need to create autoexec.bre. This will be called by the script from
BBBS/L to start BRE.

This is what mine looks like:

  ------------- START ------------

@ECHO Off
PATH C:\DRDOS;C:\EMUBIN;C:\
VERIFY OFF
SET DRDOSCFG=C:\DRDOS
CALL C:\EMUBIN\UXMACROS.BAT
LREDIR L: LINUX\FS\
d:
cd \doors\bre
call ld.bat
exitemu

  -------------- END --------------


At this point you can exit dosemu by using the command exitemu. Don't worry
about editing the ld.bat file as this is created by the script that calls
BRE.     

BBBS Config:

To add the doors to BBBS/L, you will need to edit menus/doormenu.* and add
the doors to your liking. Personally, I did away with the defaults as I
never set them up. For this example we will use 
1) Barren Realms Elite
as the example.

How you need to edit scripts/opendoor.bz. I found that the default config
for door.sys was completely incorrect so I have put a copy of my section of
opendoor.bz for make_doorsys as note 2

Then in opendoor.bz you need to edit main() and look for case 3
edit this to:
       case 3:{
                  logdoor(1);
                  make_doorsys(sprintf("door%u.sys",bv_nodenumber));
                  door=sprintf ("%s %u","bre.sh",bv_nodenumber);
                  system(door,1,0);
                  break;
                }
   
		.....



Now compile that using bzc.  Now we need to create the bre.sh file will will
exist in the BBBS/L home dir.

And here it is:

#!/bin/bash
recode ..pc /ftn/bbbs/door$1.sys

echo "SRDOOR -f d:\doors\bre\setup.$1" > /etc/fido/doors/bre/ld.bat
echo -e "\r" >> /etc/fido/doors/bre/ld.bat
echo -e "BRE \r" >> /etc/fido/doors/bre/ld.bat

dos -f /ftn/bbbs/dosemu/dosemu.bre

You may (and more than likely will have to) edit the script to suit your own
locations. If you edit the SRDOOR -F ... sectiomn, remember to think in DOS
:)

I put my dosemu files into a seperate dir so that my main BBBS dir is not so
cluttered. And this is what the file looks like:

$_xms = (1024)          # in Kbyte
$_ems = (1024)          # in Kbyte
$_ems_frame = (0xe000)
$_dpmi = (off)          # in Kbyte
$_dosmem = (640)        # in Kbyte, < 640
$_hardware_ram = ""     # list of segment values/ranges such as
$_emubat = "BRE"        # empty or 3 char., autoexec.bat -> autoexec.XX

Basically all this does is to tell DOSEMU and DOS to use autoexec.bre
instead of autoexec.bat
 



BRE CONFIG:

Setup BRE and then edit a setup.x (x for echo node that will have access) to
something similar to this.

[This is setup.1]
l:\ftn\bbbs\DOOR1.SYS
10   <- Line # of Username or First name
0   <- Line # of Last name (0 if prev line was full name)
20   <- Line # of IBM charaters (1/Y/G = yes)
20   <- Line # of ANSI support (1/Y/G/C = yes)
21   <- Line # of number of lines on the screen
2   <- Line # of baud rate
1   <- Line # of COM port
19   <- Line # of time left (minutes)
36   <- Line # of Real Name
Enter 0 for any value not supported.


You will again need to edit line one to tell BRE in dos terms where to find
the DOORx.SYS file created by BBBS/L.


You will now be able to log onto your BBS locally and play BRE. These
setting with some changed can be used for TAL and FE. Arrowbridge II and
other doors may need different setting but I will explain all in a later
version of this.



FUTURE:

I plan on expanding on this to including other doors games, InterBBS use,
several leagues for one door game and other things that people may
suggest.


Notes:

Note 1: Doors that I could not get working (as yet) 
	Lord, Lord II, TW, Lore (it worked but not for IBBS)

Note 2: make_doorsys section from my opendoor.bz
---------- START --------------
int make_doorsys(char fn) {
  int f;

  if ((f=fopen(fn,"wt"))!=-1) {
	fprintf(f,"COM%d\n%d\n8\n%d\n%d\n",bv_com,bv_baud,bv_nodenumber,115200);
	fprintf(f,"Y\nY\nY\nY\n%s\n%s\n%s\n%s\n",bu_name,bu_city,bu_phone,bu_phone);
	fprintf(f,"PASSWORD\n20\n%d\n%d\n%d\n%d\n",bu_ptimeson,bu_lasttime,(bf_timleft*60),bf_timleft);
        fprintf(f,"%d\n%d\nN\n124\n%d\n99/99/99\n",(bu_termcap & 15)>0,bu_pagelength,bv_confnro);
        fprintf(f,"1\n%s\n%d\n%d\n0\n8888\n",bu_protocol,bu_uploaded,bu_downloaded);
        fprintf(f,"%s\n%s\nNA\n%\n%s\n",bu_birth,bg_maindir,bg_sysop_name,bn_nick);
        fprintf(f,"%u\nY\nY\nY\n14\n10\n01/01/01\n%s\n",bv_nextevent,localtime(bv_logintime));
        fprintf(f,"00:00\n10\n0\n0\n0\nA User\n0\n0\n");
    fclose(f);
  }
}

---------- END ---------------


ChangeLog:

Oct 8 2001 : First Version dealing with a non IBBS setup for BRE


Contact Details:

Sean Rima @ 2:263/950
Fidonet Echos: BBBS.ENGLISH and others
ICQ: 679813
Email: sean@tcob1.net



This file is copyright (C) 2001 By Sean Rima, all copyrights and trademarks
are acknowledged.