[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
C. Detailed Switch Definitions
/A: Alarm (bell) is enabled on the Board computer if ON,
disabled if OFF. If left out, the bell will follow the ALARM
setting of the PCBOARD.SYS or DOOR.SYS. Default = OFF. ie.
"/A:ON", will override the PCBOARD.SYS or DOOR.SYS setting.
/B: /B:X, /B:M, /B:MS, /B:Z. These codes deal with line 25
of the display. If the application program tries to
position the cursor to line 25, some modem programs, such as
QMODEM, ignore the request, since line 25 contains the
MODEM's status information. This can be disastrous for some
programs which also write on this line, since it will appear
randomly on the user's screen. The /B:X will simply not
send any characters which are on line 25, and the /B:M will
move the characters to the line above (line 24).
If things do not appear correctly when the cursor gets to
the bottom of the screen, try adding /B:M to the command
line. Generally, you will want this switch for a drop to
dos function, if you are using a com program which will not
allow you to eliminate the status line. However, if your
com program (Such as QMODEM 4.0) does allow you to
eliminate the status line, it is highly recommended to do
so, and not use a /B:M.
DOORWAY will send a sequence which will position the cursor
at the bottom of the screen for both 24 and 25 line modem
programs. For maximum compatibility, it is highly
recommended to put /B:M or /B:MS in for ALL door programs,
unless it specifically causes a problem. Since line 24 and
25 will be going to line 24 if you do a /B:M, you may need
to put a /B:MS on a drop to dos and some text programs.
This tells DOORWAY to scroll the screen when it moves the
line from 25 to 24 (BIOS mode only), if the last line
written was line 24. Otherwise, you may find that line 24
gets overwritten once, when text is being printed. If you
are using the /L: and /B:M, this will already be taken care
of by the /L: switch.
A "Z" can also be placed in this sequence. It tells DOORWAY
to NOT write the very last character of the bottom line.
Some programs will write a character there, quite often a
space, making the remote's screen scroll, when it shouldn't.
Obviously, you will be missing a character on the right of
the screen if you do this, and a character is supposed to go
there. If the comm program on the remote end scrolls when
the bottom right character is written, then it will be
absolutely necessary to use the "Z".
The /B: switch can be eliminated entirely if you are using
DWCOMM on the remote end, as DOORWAY senses DWCOMM and will
configure properly for maximum compatibility and capability.
/C:DOS or /C:VIA. The /C: will cause COMMAND.COM to be
loaded. The /C:DOS will then exit to DOS and allow you to
perform DOS functions over the modem for remote computing.
Enter "EXIT" to return to the HOST. You do not need to be
in the same directory where the DROP TO DOS occured before
exiting from DOS. The VIA function will load the program
(or batch file) via COMMAND.COM. If you load via
COMMAND.COM, then path searching will be supported and the
path and extension of program name need not be given.
Obviously, the DOS function is not for a door at all, but
for a REMOTE drop to DOS function. You can do a DOORWAY
.... /C:DOS, either in a high security door, or in the
REMOTE batch file for REMOTE DROP TO DOS.
/CD Change Directory into the directory that the program is
in. If DOORWAY is being run from one directory and the
program being shelled is run from another directory, the
program may be unable to find some of it's files. Use this
switch to tell DOORWAY to change directories into the
directory the program is in prior to executing the program,
and then change back when execution is complete.
/D: Disable Disk writes. This switch will intercept all DOS
calls and not allow disk writes to take place. This can be
handy for a program like a game which insists on writing a
score file. It may cause problems for programs which
require writing to disk to run.
/E: Name of the EXIT MESSAGE file. No message if left out.
If graphics are ON, will search for the file with an .ANS
extension and use it if found. See earlier section on the
EXIT MESSAGE.
/F: Fast. Functional only if Graphics is 'ON' and in
non-direct (BIOS) screen mode. Some programs move the
cursor all over the place between characters written, (Quick
Basic compilers tend to do this). Each new locate of the
cursor normally generates an 8 character ANSI sequence to
send out the modem. For some games, this unnecessarily
slows down the action. The /F: will not send ANY ANSI
sequences on a cursor locate until a character is ready to
be written. However, since cursor relocates are not done
until a character is to be written, this gives the strange
effect of not seeing a Carriage Return have any effect until
a printable character is sent to the modem. It also has the
strange effect of having the cursor one right of where you
would expect, if you enter backspaces over something. There
are very few cases where this switch should be used, if in
doubt, leave it out.
/G: ANSI GRAPHICs enabled if ON, disabled if OFF, AUTO if A.
If left out, it will be as defined in the PCBOARD.SYS, or
DOOR.SYS file. Default is AUTO, which asks the remote if it
can support ANSI, and configures automatically. Forced on
automatically if DIRECT SCREEN is ON. (See /V switch)
/H: Halt shells to DOS. You may want to put a program into
a door which allows the user to shell to dos (such as LIST).
This switch will prevent the program from doing a shell to
DOS. Since a program may do a shell in a non-standard way,
be sure to verify this is operational with any program
before making it available to general users. If the alarm
is "on" DOORWAY will beep the HOST if anyone tries to shell
DOS. Never put in with a /C:DOS or the operation will fail
with an access denied error.
/I: Name of the WELCOME MESSAGE file. No message if left
out. If there are two files with the same name but one of
them has the extension of ANS, the ANS (ANSI GRAPHICS)
version will be used if graphics is on. See previous
section on INITIAL WELCOME.
/J: This switch is automatically determined and no longer
supported.
/K: KEYBOARD TIMEOUT TIMER. The /K: will accept a number
between 0 and 255 to define how long, after the last
character was received from the remote or local keyboard, to
wait before terminating the door and returning to the board.
The /K:0 is a special case which will override keyboard
timeouts totally, (recommended for drop to dos). Also, an
operand of "V" will reset the keyboard timer on each
character which is sent out the port. This is useful if you
have a door which sends out 10 minutes of text with no
keyboard input required. The user would otherwise be kicked
out of the door after about 4 minutes, since he hadn't
entered anything. Do not use a /K:V on something like
eatumup though, since the continuous movement of the
monsters will keep the keyboard from timing out. A /K:100V
will give a 100 second timeout, and reset the timer on
video.
/L: Add line feeds when cursor is positioned at the bottom
of the screen. Various ANSI.SYS's handle the scroll
differently when they get to the bottom of the screen. Some
do not do a BIOS scroll, but do the scroll directly without
doing a BIOS interrupt. Thus, if you do a DIR in DOS, it
will work until you get to the bottom of the screen; then,
all further lines will overwrite the bottom line. The /L:
will check for the cursor being addressed at the start of
the bottom line and add a Line Feed, if it is there. If
you have an ANSI.SYS which does the BIOS call, you will get
double line feeds if you add this switch. Another way of
fixing this is to use a different ANSI.SYS, or try the
ANSIPAT patch on your ANSI.SYS. It should work on most
MSDOS's. It is recommended to use the ANSIPAT, if it will
work, and leave this switch out. ANSI.COM from PC Magazine
is a very good alternative that does not need patching and
is highly recommended. It is not necessary to use this
switch in direct screen mode.
/M: Maximum time allowed. This will override the time
computed from the PCBOARD.SYS or DOOR.SYS file. It is in
minutes and has a maximum value of 32766 minutes. A time of
32767 minutes is entered, it will override timeouts
completely. Default is 10 minutes. Negative values will
cause an immediate abort.
NOTE: This is functional on registered
versions ONLY! The demo version
will always default to 10 minutes.
/N: NETWORK. If the /N: switch is set, all files will be
opened network compatible. Both the INITIAL WELCOME, and
EXIT MESSAGE will be opened share compatible, and if the
program being shelled opens a file, DOORWAY will change its
open command to a share compatible "Allow read - deny write"
open command. Note that the PCBOARD.SYS/DOOR.SYS file is
closed immediately after reading it, so there is no problem
accessing these from the program being shelled. COMMAND.COM
usually has a problem with this switch, so if you experience
lock-up's on drop to DOS, try eliminating this switch.
/O: Override the DOORWAY title screen. This can ONLY be done
after registering your copy of DOORWAY. When this switch is
used a short introduction screen will still give the user
name and time. A /O:T will also eliminate the delays
associated with the opening screen (recommended for drop to
dos). See REGISTRATION below.
/P: The program name with the extension and path if not in
the default directory. This MUST be the last switch on the
command line. Anything following the program name will be
passed to the program as a command line parameter for that
program. This is not used for a /C:DOS switch. The path to
the program can precede the program name if necessary. If
the program is a batch file then a /C:VIA must be used to
load the command interpreter.
/Q: Quick Basic. This switch tells DOORWAY that the program
being shelled is a Quick Basic ver. 4.0 program. Doorway
will intercept the DOS calls and tell the program that its
output is to be redirected. Without this switch, these
programs will do direct screen writes. If a program will
not send characters out the com port under DOORWAY, but can
be redirected by CTTY, Gateway or the ">" symbol, then this
switch may allow DOORWAY to redirect it as well. Note that
a program expecting redirected output may not send things
like colors, and cursor relocations. Do not use this switch
with a drop to dos, as COMMAND.COM will not operate
properly. You may want to experiment with each program and
determine if performance is better in direct screen write
mode (/V:D), or with this switch. It is recommended that
programs compiled with QB 4.5 or later use the /V:D switch
instead due to problems in the QB compiler when redirected.
/R: RETURN (abort). Each of these defines one character
with which to abort the program. The character, with which
to abort, will be the control equivalent if preceded by a
"", such as a for an ASCII 3. If the user enters the
control character, the sysop will see "EXTERNAL USER ABORT"
displayed. If the Sysop enters the return character, then
the user and Sysop will receive a message which says, "THE
SYSOP HAS REQUESTED YOU TO RETURN TO THE BOARD", and the
program will be aborted.
/S: Where to look for .SYS file. ie. \PCB\. Doorway can
tell if the PCBOARD.SYS is version 11-12 or version 14, and
will read and interpret each properly without being told. If
left out, then it will look in the same directory that
DOORWAY is in. If not found, then the Graphics, Alarm, User
time and User name settings will default to their "DEFAULT"
settings. Thus, this program is compatible with RBBS,
WILDCAT, GT, OPUS, RYBBS, QBBS, FORUM and GENESIS as well.
For those of you who are running other than PCBoard the
search for a .SYS file can be totally over-ridden. Entering
an /s:* on the command line and the delays associated with
looking for PCBOARD.SYS or DOOR.SYS and displaying the "NOT
FOUND" message will no longer occur. In order to reliably
run on RBBS, you must set RBBS up to continue its batch file
and not shell for doors. DOORWAY can also look for a
generic door file instead of pcboard.sys, by placing a "SYS"
where the com port normally goes in the command line.
/T: TRAP Characters. Each of these defines a character to
trap out of the input. If there is a in front of the
character, it will look for that control character. A @
will trap all extended codes. (See below).
/U: Get shadow buffer from multi-tasker. This is primarily
used for multi-taskers such as Desqview. If Desqview 386 is
mapping background video to addresses other than the normal
video card, this switch may be necessary. Usually you will
need to either select virtualize video in DV 386, or use
this switch. Using both appears to cause problems. If you
are not using a multitasker such as Desqview, do not use
this switch!
/V: Go into direct screen write mode. Instead of
redirecting the BIOS calls for VIDEO, this will tell DOORWAY
to check the Host's screen against an image DOORWAY
maintains. When it sees a difference, it will send it out
the modem. A /V:D will put it in direct screen mode, a /V:B
(the default) in BIOS call mode. You can add an additional
character to allow switching between modes, such as: /V:D
will start out in direct screen mode, but allow you to
toggle between modes with a control U (on remote end only).
A screen redraw can be accomplished by switching to BIOS and
back to DIRECT. It is highly recommended NOT to use
anything other than a 25 line mode on the com end for this,
on a DROP TO DOS. A /B:Z will be necessary, if your com
program doesn't support mode setting via ANSI. Otherwise,
the remote screen will scroll when the cursor reaches the
bottom right of the screen, and the remote end will get very
messed up. When a large portion of the screen has changed,
DOORWAY checks to see if the screen scrolled, and if it did,
sends a scroll to the remote. DOORWAY will check for up to 5
scrolls. If the HOST gets more than 5 scrolls ahead of the
remote, then DOORWAY will start rewriting the screen. If
this happens, you may want to enter a S (for such things as
a dir in DOS), and let the remote catch up with the HOST, so
they can get resynced. It is unlikely this will be
necessary unless the HOST is a very fast computer and the
modem is operating at a low baud rate (Enter a Q to
restart).
Redirection of the Host's screen occurs when there are
keyboard or timer interrupts. Thus the remote will be
updated as quickly as possible when the program is waiting
for a keyboard interrupt, and will still redirect, although
more slowly, when not checking keyboard interrupts.
/W: Pause at program termination. If you put in the /W:
switch, it will pause at the completion of a program. It
will not pause if there is a carrier loss, or if the program
was terminated by the Sysop. (Sysop has requested that you
return to BOARD).
/X: Load and use a translation table. The translation table
can be generated and modified by using the included
XTABLE.EXE program. Additional information can be found in
the translation table documentation included in this ZIP.
The translation table allows redefining any and all keys
from the remote to the host. Thus, if a program requires
entering an [F10] to exit, you can remap it to say a Q
(control Q). Some programs such as QEDIT use both the
character and the scan code for proper operation. DOORWAY
now supplies scan codes to the HOST's program. For instance,
entering the ESC key will put QEDIT into command mode, but
entering a [ or ALT 27 will instead cause an escape
character (back arrow) to be sent to the text file.
Of course, if an ESC character is received over the modem,
there is no way to tell which of these 3 methods were used
to generate the ESCAPE. DOORWAY has a default set of scan
codes, so when it sees an ESC, it tells QEDIT the ESC key
was pressed. If you want it to tell QEDIT that a [ was
pushed, then remap the ESC or some other key to a [
ESCAPE with XTABLE.EXE. Several other keys are handled
differently, most notably, the two sets of numbers (DOORWAY
defaults to the ones at the top of the keyboard), and the
two "-" and "+" signs (DOORWAY defaults to the white ones).
For more information on XTABLE, see the XTABLE.DOC file.
If you are running out of room on the command line (DOS only
lets you put 127 characters on a line), you can eliminate
the colons after the switches. It makes reading the line
more difficult, so it is not recommended to leave them out
unless you really need the space.
/Y: Printer trapping/redirection. If a /Y: is placed on the
DOORWAY command line, then any output to the printer will be
discarded. If a /Y:R is place on the command line, and
DWCOMM is used on the remote end, the printer will be
redirected over the modem to DWCOMM to either print or save
to a file.
/Z: Use a custom exit message instead of "RETURNING TO
BOARD". Thus /Z:EXITM will substitute the ASCII text in the
file EXITM for the normal returning message. Only one line
of information will be transmitted. For a long message, use
the /E: capability. You can personalize this so it says:
RETURNING TO DATA WORLD BBS, or CONTINUING TO THE NEXT STEP
in a multi door batch file.
/19: Use the DOS interrupt 19 for rebooting if a reboot is
ever necessary. DO NOT USE THIS SWITCH FOR NORMAL DOS
SYSTEMS. DOS will usually lock up with this interrupt.
However, under NTNX or some multi-taskers, this switch is
necessary for proper operation under a reboot condition.
/80: Force 80 column mode. This will force an application
program to stay in 80 column mode. The primary purpose of
this is to avoid a bug in some versions of Desqview 386,
which causes problems if a program writes to the screen in
40 column mode in the background.
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson