Contents of the SPAWN.DOC file
by Wayne Robinson
The Quantum Zone
A Public Domain utility for Searchlight
SPAWN may be used as an autodoor or as a regular door. Its sole
purpose it to regulate the execution of multiple doors without
the use of a batch file. SPAWN will not break between doors if a
user presses Ctrl-C or Ctrl-Break allowing the user to drop to
DOS. Replaceable parameters are allowed up to a limit of 20. You
may run up to 10 doors from a single execution of SPAWN.
SPAWN.EXE the executable file
SPAWNn.CFG list of doors to execute
SPAWN.DOC this file
SPAWNn.CFG must be present in the default directory in order for
SPAWN.EXE to run. Parameters are passed to SPAWN from SLBBS in
the normal way, (%B = baudrate). Please pay attention to the
order in which you pass these parameters as they must be refered
to in SPAWN.CFG (explained below). The parameters must be
separated by a single space. Note the first parameter is not a
replaceable parameter. This is the index number for SPAWNn.CFG.
SPAWN.EXE 1 %U %P %B
^ ^ ^ ^
1 2 3 4
SPAWN will save these parameters indexed
by their position in the command line.
1 = SPAWN will use spawn1.cfg
2 = name of user (%U)
3 = port (%P)
4 = baudrate (%B)
I find that it is best to run SPAWN with force color and
terminate support from SL.
This is an ASCII file containing a two line entry for each door
SPAWN is to run. The lower case n, represents an index number.
The execution line for SPAWN.EXE has, as its firt parameter, this
number. If a 1 is passed as the first paramter, SPAWN will use
SPAWN1.CFG for its configuration. A 2 and SPAWN2.CFG is used. In
this way, you may define more than one cfg file in a single
The first line of SPAWNn.CFG is the door name, with extension,
followed by a list of parameter indexes separated by spaces, or
by constant parameters which are designated by adding @ to the
beginning of the paramter. The indexes refer to the parameters'
positions in the command line which was passed to SPAWN by SLBBS.
Example SPAWN1.CFG entry
GOODR.EXE;2 @5 <--::
c:\utility;2 <--:: This is one entry
The example in figure 2, if used with the command line in
figure 1 would execute Lotto with two paramters passed. The '2'
references the second command line parameter ans would be the
user's name, %U. The second parameter passed to Goodr would be
the constant 5. SPAWN will remove the leading '@' before passing
the 5 to Lotto. You may pass any kind of data this way, so long
as it does not contain spaces (@SYSOP is ok but @WAYNE ROBINSON
is not). This method allows you to remove some of the paramters
from the autodoor command line. You should only have to put the
SL replaceable parameters and the SPAWNn.CFG index there.
Parameters which do not change from user to user can be placed in
the spawn.cfg definition. This is is a serious enhancement over
version 1, since it will allow you to use many more paramters.
Previously 20 was the maximum, and you couldn't fit that many on
the autodoor command line anyway. Please note that there is added
a semi-colon to separate the program from the parameters in each
entry's first line. This is different from version 1.0.
The second line of each SPAWNn.CFG entry contains the path to the
door program and the SPAWN mode switch (see figure 3), separated
by a semi colon. Note that the entry for Beep, uses '.' as the
designation for the current directory. If you wish for a door to
execute in the current directory use this notation. Do not leave
the path blank. Remember too, that if you execute in the current
directory the door program must either be there are in the DOS
1 = Execute the door in the current directory and do not
toggle comm support before and after the door.
2 = Change drive / directory to the path provided, run
the door and return to the default path. Do not
toggle comm support before and after.
3 = Execute the door in the current directory and toggle
comm support before and after the door.
4 = Change drive / directory to the path provided, run
the door and return to the default path. Toggle comm
support before and after.
SPAWN does not clean up the screen after each program it runs.
This is left to the individual door programs. This will allow you
to display more than one door's output on the same screen. SPAWN
directly supports switching I/O types before and after any door
which can afford you more flexibility. COMTOG is no longer
needed. You should set up SPAWN with full comm support and use
the proper mode switch (3 or 4) to have SPAWN toggle SL's comm
support off before a door, then on after it.
This version of SPAWN has been completely rewritten in Turbo
Pascal 5.5 and runs much faster than the original PDQ version.
It is also much better behaved in memory.
SPAWN is the property of the author and is a free utility. This
means if someone charged you for it in any fashion, they ripped you
off. This program is intended for distribution via electronic means
only when access to it is free. The only exception is if it is
bundled with other SL utilities in disk form for the convenience of
The author of SPAWN makes no warrantee reqarding this software.
If you use it and your files are corrupted or your machine
explodes, it is your fault entirely. If you decide to use SPAWN,
you agree to this stipulation. Some states do not allow such
exclusions. If you live in one of these places, you may not use
The latest version of SPAWN and other utilities can be freq'd or
d/l'd from The Quantum Zone. If you have a problem with a
utility, it may already be fixed. Check your file dates and let
me know what the problem is. It may just be an older version.