home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Beijing Paradise BBS Backup
/
PARADISE.ISO
/
software
/
BBSDOORW
/
ZCOMMDOC.ZIP
/
ZCOMMDOC.AG
< prev
next >
Wrap
Text File
|
1995-03-21
|
77KB
|
1,771 lines
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 181
return.
21.1 Major Modes of Operation
The term function can operate in several Major Modes affecting
keyboarded characters.[2]
Terminal Emulation Normal mode operates according to the terminal
emulation selected. Keyboard mapping with set and mk commands is
effective.
Conference The conference command (described at the end of this
chapter) provides local editing of keyboarded characters before
transmission.
Chat The chat command links two keyboards interactively.
21.2 Major Sub-Modes
Doorway Doorway is activated with the ALT-= key to allow function and
alt keys to be passed to certain BBS systems.
Scancode Scancode passes raw scancodes to VP/ix and similar
applications.
21.3 Command Characters
In the term function, soft key definitions override the keys' normal
functions.
ALT-= Toggles the term function keyboard handling between normal,
doorway, and scancode operation.
In doorway operation, ALT, cursor, and function keys are transmitted
as NULL followed by the raw scan code. This is especially useful
when operating the PC Board ProDoor full screen editor.
In scancode operation, raw scan codes are transmitted for use by
VP/ix and other programs that require raw IBM keyboard scan codes.
Both doorway or scancode operation override all term function key
bindings escept for ALT-= which toggles between these forms of
operation.
__________
2. Not all Major Modes are supported on all operating systems.
(C) 1994 Omen Tech Inc Chapter 21 Term Function
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 182
Backspace Normally the term function sends backspace to the remote
without any special processing. This is ideal for most systems
where backspace implies deletion of the character immediately to the
left of the cursor. Other systems, including VMS, use RUBOUT for
this function. The GCOS system uses the # character for this
function. The special requirements of these systems can be
optimally accomodated by assigning a string or series of commands to
the BS key. Chapter 99 provides some examples.
F1, ALT-X Return from the term function. ALT-X is an alternate to F1
in case the user has assigned his own string or command to F1.
F2, PgUp, PgDn, ALT-R Enter the review function displaying data
starting with either the first character received after the last
character keyboarded (except space, Ctrl-Q, or Ctrl-S), or about 48
lines back if less than 400 characters have been received since the
last character keyboarded. This allows the output from the last
command to be conveniently reviewed. Review then awaits the next
command.
F2 followed by "k" is a handy way to clear both the screen and the
circular buffer.
Up Enter remote command recall and select the previous remote command
for editing in the status line. Backspace, and Ctrl-W may be used
for editing the line. Ctrl-U and Ctrl-X clear the line's contents
and restore normal term function operation.
Down Enter remote command recall and select the next remote command
for editing in the status line.
Home Enter review function, displaying text starting at the beginning
of the buffer. ALT-R is an alternate to F2 in case the user has
assigned his own string or command to F2.
F3...F10, FS1...FS4 Chapter 19 describes the functions that the
"setup" entry in the sample PHODIR.t file assigns to these keys.
Ctrl-Break Sends a 200 millisecond (default) break signal to the
remote. The function of this key may be reassigned with a set
command.
NOTE: Some modems do not correctly pass a break signal to the
remote.
Ctrl-Shift-2 Some remote computer systems may require sending the NULL
(000) character. NULL may be keyboarded by Ctrl-Shift-2.
^F Iff q (TWX) term option is in effect, transmit the string parameter
answerback to the remote. This is equivalent to HEREIS on a
Teletype(TM) machine.
(C) 1994 Omen Tech Inc Chapter 21 Term Function
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 183
Enter Iff n term option is set, send a newline (LF). Otherwise, send
the contents of entstr (default CR) to the remote.
^Q Iff a transmit file is open and its transmission has been stopped
by a XOFF, transmission is resumed. Resumes counting of the
inactivity timeout associated with the wait and pattern commands.
Otherwise no special treatment.
Rubout The ASCII delete (rubout) character (hex 7F, octal 177) is
generated by Ctrl-Backspace (the left arrow above the ENTER key on
the PC keyboard). The "Del" key near the lower right of the
keyboard does not generate delete, but may be programmed to do so
with a "set fdel \177" command.
^S Iff a transmit file is open, transmission is stopped. Otherwise ^S
is transmitted. ^S also suspends counting of the inactivity timeout
associated with the wait and pattern commands.
ALT-B Sends a 100 millisecond break signal to the remote.
NOTE: Some modems do not correctly pass the break signal to the
remote.
ALT-N The NUKE key exits from the term function with a message and
cancels any scripts or functions that may have been executing.
ALT-1 Prompts for a DOS command, then executes that command as a
subroutine.
EXAMPLE: ALT-1 whereis *.lst
ALT-2 Prompts for a ZCOMM command, then executes that command. A
particularly useful command is "create file" which creates a capture
file without having to return to the main command prompt. Care
should be exercised not to force excessive recursion by issuing a
command (such as t or f) which would invoke the term function
recursively.
EXAMPLE: ALT-2 create capture.fil
EXAMPLE: ALT-2 display vt100
ALT-E Resets the elapsed time indication to zero.
ALT-F Full Duplex resets local echo of keyboarded characters.
ALT-H Toggles Half duplex in the sequence 0 (full duplex), 1 (local
echo), and 2 (local echo CR as CR LF). SEE ALSO: h numeric
parameter
(C) 1994 Omen Tech Inc Chapter 21 Term Function
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 184
ALT-I Three way toggle of i and I (Image) term option. When toggling
to I (super image) term option, ZCOMM's display emulation is set to
dumb to disable all escape sequences, most importantly those that do
strange things when used in the wrong context. When toggling out of
I term option, dumb terminal emulation is turned off.
ALT-J Toggles j (Jabberwrite) term option (q.v.).*
ALT-K Displays the contents of the soft keys.
ALT-L Ctrl-PrtSc Toggles the line printer on flag. If the printer is
being turned on, printing commences with the next character received
from the remote.
ALT-M Toggles keyboard mapping.
SEE ALSO: display mapkb command
ALT-O Toggles Overstrike display, and restores the normal CRT
attribute.
ALT-P Toggles the parity the term function uses between 8 bits no
parity, 8 bits graphics, 7 bits plus even parity, 7 bits plus odd
parity, 7 bits marking parity (8th bit set), and 7 bits spacing
parity (8 bit reset).
ALT-V Four way toggles v term option between normal, show control
characters as ^C, denote characters with parity bit (in addition to
the above) set by prepending a tilde (~), and display all characters
in hex.*
21.4 Control Characters
The following characters are recognized by the term function when they
are received from the remote.
ENQ, DLE If c or C (Compuserve) term option and v term option is not
in effect, engage the Compuserve B+ Protocol. This protocol is used
with the FILTRN program and the SIG/ACCESS DOW and UPL commands.
See Compuserve's CP-MIG user group documentation for more
information. Iff enabled, these codes are acted upon when drained
from the interrupt input buffer and are not passed to the circular
buffer.
The following received characters are recognized by the term function,
regardless of parity, when they are fetched from the circular buffer
for the display.
Modem Error Detected modem errors (parity error, framing error, break,
overrun) are counted in the e numeric parameter. The E numeric
parameter may be used to represent modem errors as specific,
(C) 1994 Omen Tech Inc Chapter 21 Term Function
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 185
searchable characters.
A detected overrun is displayed as a large fuzzy rectangle (hex B2).
ETX EOT Ctrl-Z When receiving a message with the TWX protocol (in Host
Operation) these control characters will terminate the message.
ENQ Iff q (TWX) term option or VT100 emulation ("display vt") is in
effect, transmit the answerback string parameter to the remote.
This is equivalent to HEREIS on a Teletype(TM) machine.
BELL Generates a tone in the speaker unless visual bell display is
enabled ("display bell=visual"). If the display has fallen behind
the incoming data, ZCOMM suppresses the bell due to the relatively
long time required to perform a bell ring. If a file is being
transmitted with the term function, a bell character will pause
transmission for a short time. (Some computers send bell characters
to indicate their input buffers are becoming overloaded.)
FF If c term option is enabled, erase the screen.
XOFF Suspends file transmission from ZCOMM. XOFF is excluded from
pattern searches and does not display unless v term option is set.
After a timeout determined by the Kermit s numeric parameter
(default 60 seconds), transmission will resume even if no XON
character is received.[3]
XON Resumes file transmission from ZCOMM. XON is excluded from
pattern searches and does not display unless v term option is set.
NULL, Rubout (Hex 7F) and NULL (0) are not displayed unless ZCOMM is
in i (image) or v term option. They are excluded from pattern
searches.
21.5 Buffer Writing
If e (Emacs) term option is set, a buffer dump is performed before
each keyboarded character is sent to the remote, since normal XOFF
based flow control is assumed to be disabled.
When the free space in the circular buffer is nearly exhausted, ZCOMM
sends an XOFF character to the remote[4] and writes the buffer
contents to the receive file[5] (if any). The circular buffer is also
__________
3. There is no timeout if the parameter is 0.
4. Assuming e term option is not in effect.
(C) 1994 Omen Tech Inc Chapter 21 Term Function
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 186
written to the receive file as a result of a "w" command, ALT-W key,
or once per second if j term option is in effect.
When the circular buffer is written to a receive file, several control
characters are treated specially if i (image) term option is not set.
Iff s term option is set, all control characters, except for those
listed below, are excluded from the received file.
NULL ACK BELL XON XOFF RUBOUT ESC These characters are excluded from
the file. Most "escape sequences" are also filtered form the
cpature file. NULL, DELETE, XON, and XOFF are excluded from pattern
searches.
ETX, EOT These characters close the file if q term option is in
effect, as when ZCOMM is receiving a message in host state using TWX
protocol.
Ctrl-Z (CPMEOF) Iff z term option is enabled, close the file.
Otherwise this character is discarded.
LF Iff n (nlmode) term option is on, a CR is written to the file
before the LF. Linefeed is always passed to the file.
CR Iff a term option is in effect, a CR LF sequence is written to the
file. Otherwise, if s term option is on, CR is only written to the
file as a response to an LF in the circular buffer.
BS Backspace is written to the file unless s term option is in effect,
in which case it, and the last character written in the disk file,
are deleted by backspacing the file write pointer. This simulates
the function of backspace on common CRT terminals.
NOTE: This backspacing of the file write pointer operates the same
as Teco and Emacs editors; it does not stop at the beginning of the
line. Backspacing over tab characters is tricky because it may take
several backspaces to eliminate the spaces corresponding to one tab
character, but only one is needed to eliminate the tab character in
the output file.
HT, FF These characters are always passed to the file, even if s term
option is in effect. If ss term option is in effect, FF is not
passed to the file.
______________________________________________________________________
5. An XON is sent to the remote after this automatic buffer write
operation.
(C) 1994 Omen Tech Inc Chapter 21 Term Options
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 187
22. Term Function OPTIONS
The term function options described in this chapter affect the
operation of the f, put, wait, and t commands. The b, n, p, r, w
options are mutually exclusive.
All options except f and n are reset by the call and init commands.
Term function options may be set with flags to the conference, create,
enable, disable, f, open, t, and wait commands.
The call command resets ZCOMM and the communications port to 8 bits no
parity.
! Negates the sense of the following options. The ! modifier is not
used with the 7 and 8 options.
EXAMPLE: t -Z!tl enables ZMODEM AutoDownload and turns off throttle
and line printer output.
7e 7o 7m 7s Sets 7 bits plus {Even Odd Marking Spacing} parity for
transmission with the put, f, and t commands, and file transfers
using the Kermit protocol. The parity setting does not affect the
information content of received characters.[1] If 7e or 7o option
is used, each incoming byte of Kermit packets is checked for parity
for extra accuracy in file transfers.
Some applications require 7 bit transmission. Even parity is often
used for TWX and IBM mainframe communications. 7m option sets the
parity bit to "marking" (8th bit set to ONE), sometimes used with
DEC minicomputers and IBM mainframes.
7s option masks data transmitted by the term function to 7 bits
(spacing is equivalent to binary 0).
If a paritied option is specified, the term function counts each
character received with the opposite parity as an uncorrected
error.
The call command resets ZCOMM and the communications port to 8 bits
no parity (8n).
EXAMPLE: ena -E7e enables Error Containment(TM) with 7 bits even
__________
1. The term function normally strips the parity bit unless 8g
(graphics) option is set.
(C) 1994 Omen Tech Inc Chapter 22 Term Options
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 188
parity.
SEE ALSO: E mode
8n Sets 8 bits no parity (default) for transmission with the Kermit,
and t commands. The call command resets ZCOMM and the
communications port to 8 bits no parity (8n).
8g Some PC based bulletin boards send line drawing characters intended
for IBM display adapters encoded with the 8th bit set. 8g term
option uses 8 data bits with no parity. All 8 bits are also passed
to the display, allowing the special graphics characters to be
displayed, including those sent by many IBM-PC bulletin boards. 8g
term option must not be used when the remote is sending 7 bits with
marking, even, or odd parity,
8o 8e 8e sets the hardware to 8 bits even parity; 8o sets the hardware
to 8 bits odd parity.* The 8e and 8o term option ares used only
with very specialized applications. No known dial-up systems use
either of these options. Most modems do not support 8e or 8o
option.
SEE ALSO: 7e and 7o options
A Sends characters from the remote to DOS, bypassing ZCOMM's CRT
driver. A option allows a screen driver such as FCONSOLE.DEV to
pcocess extended ANSI or special terminal codes which ZCOMM would
not otherwise understand. The A option affects the term function
only. When using the A option, the term function status line
should be disabled with a "display stat=off" command if the display
driver uses all 25 CRT lines. Fansi-Console(TM) or other drivers
with definable scrolling regions may be set to scroll only the top
24 lines, leaving the 25th line free for ZCOMM's status
information.
WARNING: Fansi-Console and ANSI.SYS allow input data from the
remote to redefine keys and/or cause commands to be executed. Such
capabilities pose a security breach. For example, an innocuous
looking message could contain an invisible escape sequence to make
your "keyboard" issue "del \COMMAND.COM" the next time you strike
the ESC key.
EXAMPLE: display stat=off; t -A disables Zcomm's status line and
routes characters from the remote to DOS standard output.
SEE ALSO: list command
a Addlf adds a linefeed to each carriage return received from the
remote. This is displayed as newline (return/linefeed). The same
action takes place if addlf is in effect when the term function is
(C) 1994 Omen Tech Inc Chapter 22 Term Options
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 189
writing the circular buffer to a file. This term option is useful
when the data from the remote contains carriage returns but no
linefeeds. The a term option may be used with the s (Strip control
characters) term option.
NOTE: i (image) term option supersedes a term option.
EXAMPLE: read nolffile.txt; create -a withlf.txt; w; close reads
nolffile.txt into the circular buffer, then writes it to withlf.txt
with linefeeds added.
b Binary term option of file transmission with the f file command.
All 8 bits are sent. This is handy for uploading binary files
using the f command to adjacent machines without any useful file
transfer protocol.
Don't confuse this mode with the protocol file transfer commands
which send files with error correcting protocols. Also don't
confuse this with the i term option which affects files received
with the term function.
NOTE: The fput command can also be used to send a binary file when
no monitoring of the remote's responses is needed.
EXAMPLE: f -b binfile
c, C Compuserve mode allows the remote computer to invoke the
Compuserve B protocol. c causes formfeed from the remote to clear
the screen, C does not. When enabled with c or C term option, the
Compuserve B protocol uses ENQ and DLE for special functions.
EXAMPLE: t -c
SEE ALSO: w numeric parameter
D Delays detection of carrier detect loss. * When carrier detect is
lost, D term option causes ZCOMM to wait up to two seconds for
carrier detect to return. If carrier detect returns within that
two seconds, ZCOMM pauses another two seconds to allow the modems
time to stabilize. D term option allows file transfers to continue
in the presence of interruptions from call waiting or cellular
radio communications dropouts. The modem's carrier dropout timer
must be lengthened to two seconds to accomodate such droputs
without disconnecting by adding a Hayes S10=20 command to the modem
initialization string sent by the dial telephone directory entry.
d (Dropout) Disables the No Carrier Detect message otherwise
generated by the term function and protocol file transfers when the
communications port detects a loss of carrier detect. This term
option is useful when operating with direct connections that do not
(C) 1994 Omen Tech Inc Chapter 22 Term Options
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 190
properly drive the carrier detect line. The call command sets d
term option; the standard dialing scripts cancel it when the modem
reports a connection.
NB: Enabling d mode disables the term function from checking for
loss of carrier detect signal. Disabling d mode enables this
checking.
EXAMPLE: ena -d
E Error Containment(TM) When the remote is transmitting continuously,
a single "line hit" may garble many characters before the hardware
can recover. E term option makes the term function send an XOFF
(^S) character to stop the transmission of data when a "line hit"
is detected. A line hit is detected by the presence of a break
signal or framing error. If the 7e, 7o, 7m, or 7s term option is
set, ZCOMM also detects parity errors as line hits.[2] After a
brief pause, an XON (^Q) is sent to resume transmission.
E term option does not effect protocol transfers. It is effective
only when the remote recognizes XOFF to stop transmission. E term
option cannot be used with programs such as EMACS which use ^S and
^Q as editing commands; it should not be used with X.PC.
EXAMPLE: create -+E7e capture.fil creates capture.fil for output,
appending it to any existing instance of the file, enabling 7 bits
even parity and Error Containment.
SEE ALSO: E and e numeric parameters
e EMACS editors and a few other programs use the ASCII flow control
characters XON and XOFF as commands. These characters cannot be
used for their normal flow control functions with EMACS. Emacs
term option suppresses the automatic transmission of XOFF (^S) and
XON (^Q) when ZCOMM's circular buffer fills up. Opening a receive
file with the t file command cancels EMACS term option, but it may
be turned back on later. ("t -e file" won't activate e term
option.)
When capturing data to a file with e (Emacs) term option on, the
user must manually stop the data from the remote and dump the
buffer with the w command or the Alt-W key. Keyboarded characters
__________
2. Many medium speed modems, including 1200 and 2400 bps units, do
not generate framing errors in response to line hits. When such
modems are used, parity must be used to detect line hits.
(C) 1994 Omen Tech Inc Chapter 22 Term Options
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 191
automatically trigger a buffer write.
EXAMPLE: create capturefile; t -e
SEE ALSO: j mode
f Full duplex. ZCOMM does not echo keyboarded characters to the
screen.
FN Overrides the default pattern match fail time for the current wait
command to N seconds absolute. A value of 0 suppresses this
timeout.
EXAMPLE: wait -F5 searches for a pattern match, and will fail after
five seconds.
fN Sets the pattern match fail time for the current wait command to N
seconds of inactivity. A value of 0 suppresses this timeout.
EXAMPLE: wait -f5 searches for a pattern match, and will fail after
five seconds of inactivity.
SEE ALSO: f numeric parameter
g resumes sending the file once in the term function, equivalent to
an XON character. Disabling g causes a file queued for
transmission to wait for an XON character. Enabling g mode (ena
-g) will resume file transmission after a grab command.
SEE ALSO: grab command
G, GG G term option (the default) allows the term function to
recognize XON and XOFF flow control. A number of characters may be
sent before ZCOMM responds to XOFF. GG term option prevents the
term function from recognizing XON and XOFF flow control.
As a special case, disabling G term option allows the interrupt
driven output routines in ZCOMM to respond immediately to XOFF and
XON characters instead of waiting for the term function to receive
and act upon them. A consequence of this selection is that the
term function may be "stuck" waiting for the interrupt level
routines, while at the same time the interrupt level routines are
"waiting" for an XON character. A spurious XOFF or lost XON
character can cause this deadlock. The S numeric parameter should
be set to an appropriate value to allow timeout and recovery from
this condition.
EXAMPLE: f -!G asciifile.txt
(C) 1994 Omen Tech Inc Chapter 22 Term Options
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 192
H,h Half Duplex Displays keyboarded characters as they are sent to the
host. H term option causes keyboarded carriage return to be echoed
as cr/lf.
Two half duplex term options are provided to match computer systems
that send a linefeed in response to carriage return ("t -h") and
others that give no echo at all to carriage return ("t -H").
SEE ALSO: h numeric parameter
i If a file is being received with the Term function, Image term
option allows all characters received, including NULLS, to be
output when the capture buffer is written to disk. Image term
option makes the review function act upon ESCAPE characters. Image
term option overrides the a, s and z term options. Image term
option does not override the A, c, C or Z term options, and does
not control the parity bit. Image option causes capture files
opened with the -+ (append) option to preserve all data currently
present in the disk file, including any CP/M EOF characters.
EXAMPLE: t -i
SEE ALSO: I, v and 8g term options, ALT-I key, fget command
The fget command is faster as there is no display of the received
data.
Image term option does not affect transmitted data.[3]
I Super Image term option sets completely transparent 8 bit data
capture with the term function. In addition, the A, c, C, and Z
term options are superceded, XON, XOFF, ENQ are not executed.
Super Image term option is useful for capturing binary data from
sources that require keyboard or script intervention. If the
incoming data contains random escape sequences, ZCOMM's terminal
emulation decoding of escape sequences should be suppressed.
Either v term option should be set, or a display dumb command
should be given.
J On Unix and Xenix systems, the J term option smooths the display of
data coming from slow serial lines by accepting data in smaller
chunks. It may be used for interactive applications where jerky
output is unesthetic. J term option increases CPU utilization and
context switching overhead.
__________
3. The b (Binary) term option modifies files transmitted with the
term function.
(C) 1994 Omen Tech Inc Chapter 22 Term Options
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 193
SEE ALSO: ALT-J
j * The jabberwrite term option causes the term function to dump the
circular buffer to disk once a second if a receive file is open,
without interrupting the data flow from the remote. This avoids
the delay required when dumping the entire buffer to disk, but may
cause loss of data if the output device is too slow, or if its
driver software inhibits data interrupts from the remote. It
should not be used with the PCjr because the PCjr disk cannot
overlap i/o with disk activity.
EXAMPLE: t -j
K Enables automatic downloading of files with the Kermit protocol.
The y term option applies to Kermit AutoDownload.
l (letter l) List unit (Printer) on. Since ZCOMM buffers the
printer, it needn't be as fast as the incoming data as long as the
buffered data doesn't exceed the circular buffer size. The rewind
command may be used to get extra copies of the received data
(assuming it all fits in the circular buffer). The list unit is
accessed with the rom bios printer interface (int 17h).
EXAMPLE: t -l enables printer spooling.
EXAMPLE: disable -l disables printer spooling.
NOTE: If ZCOMM is terminated before all of the circular buffer is
output to the printer, the remainder of the data will be lost.
SEE ALSO: The ALT-L key toggles printing starting with next
character received from the remote. The l numeric parameter
selects the printer device. The lpnono string parameter allows
unwanted control characters to be filtered from the printer.
n sends newline (lf) only when transmitting a file with the term
function (no CR). Keyboarded CR is sent as a newline. When
receiving a file to disk with the term function, Newline is stored
on disk as CR LF. n term option causes newlines to be displayed as
CR LF. The n term option is not reset by the call command.
EXAMPLE: f -n file
p,P When transmitting a file with the term function, the contents of
eolstr (CR by default) are sent at the end of each line. Prompt
term option then waits for a prompt character ( g numeric
parameter[4]) from the remote after each line transmitted from a
(C) 1994 Omen Tech Inc Chapter 22 Term Options
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 194
file. If GOchar is not received, the wait times out and
transmission proceeds in the same manner as with w term option.
The duration of this timeout is controlled by the p numeric
parameter. The q numeric parameter controls the pause between
recognizing GOchar and resuming transmission. This pause is not
reset by characters from the remote.
EXAMPLE: f -p file
SEE ALSO: g, p, q numeric parameters
As a convenience, P term option implicitly sets GOchar to 17. As a
special case, if GOchar is set to 17 (called XON, DC1, or ^Q)
before the p term option is set, file transmission is stopped until
an XON is keyboarded or received from the remote.
EXAMPLE: f -P file
q (TWX term option) Setting q term option causes the term function to
guarantee the contents of the circular buffer have been written to
disk[5] and then transmit the answerback string parameter in
response to ENQ. An ACK from the local keyboard or a transmitted
file also transmits the answerback. An EOT or carrier loss closes
the receive file and exits the term function.
Q Quiet inhibits the term function display of data from the remote.*
The status line, ZCOMM messages, and output from utility commands
are not affected. The Q term option may be used to suppress
unwanted characters during modem initialization, logins, etc.
SEE ALSO: display inhibit command
r CR term option sends the contents of eolstr (CR by default) at the
end of each line transmitted from a file with the f command. There
is no pause at the end of each line.
EXAMPLE: f -r file
______________________________________________________________________
4. The default for numeric parameter g (GOchar) is linefeed .
5. On DOS, the file is written, closed, and reopened. The TWX
protocol assumes that transmitted information has been safely
stored before an answerback is sent in response to ENQ.
(C) 1994 Omen Tech Inc Chapter 22 Term Options
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 195
S SuperStrip term option strips Form Feed (FF) from the file in
addition to the actions of s term option.
EXAMPLE: t -S capture.txt
s Strip all Control Characters except LF, FF, HT, and BS when
capturing to a file with the term function. Most escape sequences
are completely removed, especially common ANSI codes for setting
colors and positioning. In s term option, a BS character causes
ZCOMM to attempt to erase the previous character from the output
file with an fseek() function call. This is guaranteed to work
only if the output is to a disk file and sufficient characters come
after the BS to overlay the "erased" character.[6] An LF is stored
in the file as CR LF to make up for the CR that is discarded in s
term option. XON, XOFF, and DEL (RUBOUT) do not display when s
term option is in effect. The a (Addlf, add linefeed to carriage
return) term option may be used with the s term option.
NOTE: i (image) term option supersedes s term option editing.
When displaying file(s) with the cat, more, type, page, bro/v, and
bro/p commands, stop when ^Z (CP/M EOF) is read.
sss In addition to the above, sss inhibits the display of blank lines.
SEE ALSO: display vt100 command
t Some remote systems cannot accept input at full speed. Throttle
term option slows the sending of characters to the remote. The
speed is controlled by the t numeric parameter. The default value
slows transmission to about 50 words per minute. The t term option
does not affect protocol transfers.
EXAMPLE: f -t command.fil
SEE ALSO: t numeric parameter
TN Sets the pattern match fail time for the current wait command to N
seconds absolute. In addition, the term function will return
(without matching any patterns) after an enabled Kermit,
Compuserve-B, or ZMODEM automatic file transfer (successful or
otherwise).
EXAMPLE: wait -T99 searches for a pattern match, and will fail
__________
6. This backspace simulation does not stop at a virtual left margin.
(C) 1994 Omen Tech Inc Chapter 22 Term Options
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 196
after 99 seconds.
u Enables Upper case conversion of keyboard and file characters sent
with the term function (t, f, F2 commands). The answerback and
programmed strings are not affected. Protocol file transfers are
not affected.
EXAMPLE: ena -u
SEE ALSO: ALT-U key
v View control characters as ^C. In addition to the above, vv term
option denotes characters with the parity bit set by prepending a
tilde (~). Finally, vvv term option prints incoming characters in
hex.* The v term option override the A, c, C, and Z term option.
EXAMPLE: t -iv bincapt.fil captures binary data from the modem to
bincapt.fil, with control characters displayed legibly.
NOTE: View term option is distinct from the file transfer view
option.
V On VMS create capture files with VMS variable length CR carriage
return record format. The default is Stream_LF record format.
w Wait term option. When sending files with the term function, send
the contents of eolstr (CR by default) at the end of each line, and
then wait until echoes from the remote have stopped. Useful for
sending files to bulletin boards where the remote needs time to
prepare for the next text line. The p numeric parameter controls
the length of this wait, which is reset by each character received
from the remote.
EXAMPLE: f -w file
W Enable writing from the circular buffer to capture file (default
enabled).* The echof and echoc commands are not affected.
SEE ALSO: ki command
x,X EXit from the term function when EOF is encountered on transmitted
file. In addition, X term option causes the term function to exit
when the file upload is interrupted by reading a character matching
the value of the m numeric parameter. The x term option is the
standard way for a script to regain control after uploading a file
with the term function.
EXAMPLE: f -x upload.txt
(C) 1994 Omen Tech Inc Chapter 22 Term Options
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 197
SEE ALSO: m numeric parameter
y Yes it is OK to clobber a file already on disk when receiving to a
file. If absent, the operator is given a choice of appending to
the current file (a), erasing it (y) or aborting (n). This term
option is reset at each command line and at each obey and function
key, pattern action, or downloaded command. This term option is
not allowed if ZCOMM is Restricted.
Z (Case is significant!) enables ZMODEM AutoDownload of commands and
files when the term function is active (this is the default). The
term function recognizes ZMODEM AutoDownload at 300 bps and higher
speeds.
EXAMPLE: dis -Z disables ZMODEM AutoDownload.
ZMODEM AutoDownload performs a security check to reject Trojan
Horse messages. The challenge may be disabled with an ena -yZ
command, resulting in a time savings when using some modems.
z Close file when CPMEOF (^Z) is encountered while writing the
capture buffer. On DOS flavors, z term option also appends a
CTRL-Z (CP/M EOF) to the end of files created with the apd, create,
t file, browse/a, browse/A, review/w, review/W, and > commands.
Otherwise, ^Z is ignored.
+ When capturing data to a file already on disk, append the new data
to the old file. The last block of the old file is searched for
the CP/M EOF character unless i or I term option is set. The +
term option is reset at each command line and at each obey and
function key, pattern action, or downloaded command. This term
option is not allowed if ZCOMM is Restricted.
22.1 Real Time Status Line
A real time status line is displayed when DOS and OS/2 ZCOMM are in
the term function. The left part of this status line is also
displayed when ZCOMM is in Host Operation awaiting a call.
The first character position shows a blinking W if the circular buffer
is being written to disk. Otherwise, the first character position
shows an L if the keyboard has been locked by a kbdlock command, or C
if the Caps Lock key is activated.
The second position shows an X if hardware handshaking is enabled and
Clear to Send (CTS) is not received from the modem, or if an XOFF
character has been received (software handshake). This also happens
when a file upload is using the p term option with GOchar = 17 (17 is
decimal for XON) and ZCOMM has stopped at the end of a line.
Otherwise, an M is shown to indicate Keypad Mapped operation for
(C) 1994 Omen Tech Inc Chapter 22 Term Function Status Line
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 198
terminal emulation. Otherwise, an N appears if the Num Lock key is
activated and the K numeric parameter is 0 (84 key keyboard).
SEE ALSO: handshake command, Terminal Emulation, Chapter 29.
The third position displays the real time status of the following five
conditions. If more than one of the conditions is active at once, the
displayed character will represent the condition listed first.
X if the buffer has nearly filled up and ZCOMM has sent an XOFF to
suspend data transmission from the remote.
E when ZCOMM has sent an XOFF to suspend data transmission for Error
Containment(TM).
S if the term function is searching for one or more strings (defined
by the pattern command).
W if term is waiting for a character echo before resuming
transmission.
w if term is waiting for a fixed time before sending the next
character or returning from a putw or wait command.
The display column and row numbers are displayed next with the home
position equivalent to 1, 1. DOS's idea of the time of day is next.
The minutes of elapsed time follow the time of day, modulo 24 hours
(1440 minutes). The elapsed time is reset by the ALT-E function key,
restime command, and telephone number autodial.
If carrier detect is absent, an L( Local) appears after the elapsed
time. The X.PC version will display c, p, or L in this position
depending on whether ZCOMM is in character state, packet state, or
Local (no carrier detect).
The number of free characters in the Circular Buffer appears next. If
a capture file is open, the number of characters written to the file
is displayed instead. Otherwise, if a file is being uploaded ( f file
command), the number of characters sent is displayed instead of the
Circular Buffer free character count.
A user programmed message may be displayed in right side of the status
line with the statliner string parameter. Otherwise, the right side
of the status line shows the communications port,[7] transmission
speed ("baud rate") and the parity.
__________
7. Virtual channel number for X.PC
(C) 1994 Omen Tech Inc Chapter 22 Term Function Status Line
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 199
The next field represents the term options that are enabled. If the
b, n, p, r, or w term option is set, that letter shows. If p term
option is set with with GOchar equal to XON (decimal 17), a P is
shown.
The v term option causes the view indicator to show ^ if control
characters are being displayed in the style ^C where C is the
alphabetic character corresponding to the control character. The
indicator shows ~ if characters with the 8th bit set are being
displayed with a leading ~.
Setting the a, c, e, h, i, j, l, q, s, t, u, x, and z term options
causes the corresponding letter to be displayed. The c, h, and s term
functions are displayed in upper case if their value is greater than
1.
ON HOOK is displayed if the computer has disabled DTR (Data Terminal
Ready). The speed command should be used to assert DTR and allow the
modem to go off hook (connect to line), e.g., "speed 1200".
If a transmit file is open, a < followed by the transmit file name is
shown.
If the file upload has been stopped by a grab command, Stopped(grab)
is diplayed.
If a receive capture file is open, a > followed by the file name is
shown.
EXAMPLE: LX 01 24 23:57 ET 0:46 L 31424 1:1200 8n p^t <upload.fil
The keyboard has been "locked" by a kbdlock 1 command. File upload
has been stopped by an XOFF character. The cursor in in column 1,
line 24. The elapsed time is 46 seconds. Carrier is not present (L).
There are 31424 free bytes in the circular buffer. Transmission speed
is 1200 bits per second. Transmitted word length is 8 bits no parity
(8n). Since a speed of 1200 selects 1 stop bit, operation is the same
as "8-N-1" mentioned by many bulletin board systems. The p term
option makes file upload pause at the end of each line for a prompt
character. View term option is set (ena -v). Finally, t term option
slows the transmission of each character from a soft keys or file.
The disk file upload.fil is being uploaded.
The s numeric parameter sets the status line display attribute. The
default of 7 provides normal video. With some displays, you can set
it to dim with a ps8 command so it won't distract you. It may be
disabled with an "ESC x 1" sequence.
SEE ALSO: statliner string parameter
(C) 1994 Omen Tech Inc Chapter 22 Term Function Status Line
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 200
22.1.1 X Windows status line When operating under some versions of
the X Windows xterm program, Unix flavors display a status line
indicating Carrier Detect, elapsed time, and buffer free size.
22.2 Conference Command/Local Editing
When the conference command is given, two cursors appear. The usual
cursor will follow text as it arrives from the remote computer. A
block cursor in the conference window follows the text you enter.
While entering text to the conference window, the standard ZCOMM
editing keys described in Chapter 18 may be used to correct
keyboarding mistakes.
When you keyboard ENTER, LF, or ESC, or when you fill up the
conference window, ZCOMM queues the line for transmission. The
conference window cursor disappears while the line is queued for
transmission.
The line is transmitted as soon as the previous line (if any) has been
sent. When transmission begins, the conference window is cleared and
the conference cursor reappears, allowing the next line to be
keyboarded. Attempts to keyboard characters into the conference
window before transmission begins will ring the bell and be discarded.
When in the conference command, the function keys operate the same way
as they normally do in the term function. The review subcommands (F2,
PgUp, etc.) may be used to review portions of the conversation that
have scrolled off the main screen. The exit command F1 causes any
characters entered in the conference window to be discarded.
The following characters are passed directly to the remote and are not
entered into the conference window: ETX SI DLE XON XOFF DC2 DC4 (^C ^O
^P ^Q ^S ^R ^T).
Transmission from the conference window is controlled by the t, p, and
w term options and their associated parameters. If none of these term
options are set, the line is transmitted at full speed. If Half
Duplex term option h is set, ZCOMM echoes the line as it is
transmitted. If H is set, a linefeed is transmitted and displayed
after the carriage return.
(C) 1994 Omen Tech Inc Chapter 22 Review Function
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 201
23. REVIEW FUNCTION
Review function commands page, search, cut, paste, and otherwise
manipulate captured data stored in the circular buffer.
The review function displays the approximate location of the displayed
text within the circular buffer as a percentage of the buffer contents
on the status line. Unless i term option is in effect, escape
characters are printed as $ (dollar sign) so they will not interfere
with scrolling.
Review subcommands consist of a single character preceded by an
optional numeric argument. (The default value is 1.) The numeric
digits and the command are not echoed as they are entered. For
example, keyboarding 69+ moves down 69 lines.
You don't have to wait for the screen to fill before entering the next
review subcommand. This comes in handy with the n subcommand. Since
the N subcommand searches in the reverse direction, you can thumb
through messages (by searching for the subject header) very quickly,
knowing that you can back up if you went past something interesting.
23.1 Review Subcommands
Defined soft keys are executed from review iff they do not conflict
with the permanent definitions.
Ctrl-L, Ctrl-Home Ctrl-L (form feed) clears the screen and refreshes
the display without moving it. Ctrl-L is useful after an error
printout within review, or after a subcommand that writes to the
screen such as ALT-D or ALT-S.
a Toggles the autowarp display mode, then refreshes the display.
If the autowrap display mode is enabled, long lines can be
viewed, but will cause lines at the top of the screen to scroll
off.
G Go to the Nth line and display from there. If N is omitted, go
to the end instead.
Home Display starting at the beginning of the capture buffer.
r, R If a file is open as a result of a read command, read some more
of the file into the buffer, replacing about 3/4 of the previous
buffer contents (all if R subcommand). A successful r subcommand
erases the pointers set by the t and b subcommands. The data
read in from the file may overwrite the data currently displayed
on the screen. In this case, ZCOMM displays data starting with
the oldest.
(C) 1994 Omen Tech Inc Chapter 23 Review Function
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 202
F2, PgUp, ^B, * Display the Nth previous page (one line overlap is
provided).
SP, PgDn, ^F Clear screen and display the next Nth page.
s, / Accept a search string, terminated by RETURN. This string may
have character escapes. Search through the buffer for the Nth
instance of string. Lower case characters in string match either
case; upper case characters in string match upper case characters
only. The display starts with that line. If the search is
unsuccessful, ring bell. The search begins at the top of the
display.
SEE ALSO: ?, n, N subcommands
? Prompts for search string as above, then searches backwards for
the Nth occurrence of string starting with the line above the top
of the buffer.
n Next searches for Nth occurrence of the previously entered string
in the direction of the last "/" or "?" subcommand. Typical
usage would be to search for the first occurrence with the "/"
subcommand, then use "n" to find more matches.
N Next searches for next Nth occurrence of the previously entered
search string in the opposite direction to the original "/" or
"?" subcommand.
UpCursor, - Backup N lines and redisplay.
DownCursor, +, Ctrl-J(LF) Move the display down N lines and redisplay.
End Go to the buffer end (where the most recent data is) and display.
x eXit returns to the previous function, and makes the term
function redisplay the last page of buffer contents.[1] This
restores the screen and keyboard to the same state they were in
before review was entered. The x subcommand allows you to see
where you were if you were in the midst of keyboarding a command
to the remote when you entered review.
EXAMPLE: Suppose you are typing in a line of commands and you
need to "thumb back" through the remote's output for some vital
nugget of information. (After you enter a 20 line email reply
__________
1. When the term function takes control, which is immediately if
review was called from the term function.
(C) 1994 Omen Tech Inc Chapter 23 Review Function
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 203
message, NOW Compuserve asks you for a certain random 8 digit
account number to mail it to!) No sweat, just hit some PgUp's
until you see the account number on the screen. Now you can't
remember whether or not you typed a space after the last part of
you command to the remote. No problem, just exit review with x
and you'll see just where you were.
NOTE: This subcommand should not be used when scripts are active.
k Kill the capture buffer contents and return to the previous
function.
Ctrl-Z, Ctrl-PgDn Kill the rest of the buffer by setting the character
insertion pointer to just after the end of the current display.
ZCOMM then redisplays the last lines of the buffer and returns to
the previous function.
t Set the cut pointers to the top of displayed text, and sets the
bottom cut pointer to the end of the buffer. The t subcommand is
used with the b subcommand to specify which portion of the
circular buffer should be written to a file with the w
subcommand. (Text between the top and bottom pointers is
highlighted.)
b Set the bottom pointer to the beginning of the first line of
displayed text. If the top pointer had not been previously set,
or if the bottom pointer is before the top pointer, ZCOMM will
ring the bell and ignore the subcommand. Otherwise, the text on
the screen that was highlighted will now be displayed in normal
intensity as what is showing on the screen has just been
deselected. (Text between the top and bottom pointers is
highlighted.)
w, W Write (paste) the text between the top and bottom pointers to a
disk file or DOS device.[2] If the top pointer is not set, a
reminder is printed. ZCOMM prompts for a pathname. A blank file
name implies the modem.[3] If the bottom pointer is not set, the
rest of the buffer will be written. No log entry is made by this
subcommand. The W subcommand automatically appends the paste
data to an existing file. A directory for past files may be
specified with the DIRPX environment variable and/or the dirpx
__________
2. Useful DOS devices are PRN, LPT1, LPT2, and LPT3.
3. Data is sent to the modem at full speed with the current parity.
Normally, line feeds are not sent. With n term option, line feeds
are sent and carriage returns are suppressed. With b term option,
data is sent the way it was received.
(C) 1994 Omen Tech Inc Chapter 23 Review Function
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 204
string parameter.
q, F1, ALT-X Quit, return to previous function.
! Prompts for a DOS command, then attempts to execute it (DOS
Gateway).
@ Prompts for a ZCOMM command, then executes it.
(C) 1994 Omen Tech Inc Chapter 23 Numeric Parameters
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 205
24. NUMERIC PARAMETERS
Numeric parameters are set with the p command in the form px# where x
is the one letter name of the parameter and "#" is the numeric value.
Numbers may have an optional leading "-" (minus) sign. Numbers are
normally decimal, but hex numbers may be input as 0xHH, printing ASCII
character values may be entered as 0cC, and control characters may be
represented as 0^C.
Value Possible entries
65 65 0x41 0cA
3 3 0x3 0^C
Typing "p" without a parameter name displays the current values of the
numeric parameters in decimal.
EXAMPLE: pS5 sets the timeout interval in seconds waiting for XON
characters or positive flow control. to decimal 5 seconds.
EXAMPLE: pv-1 sets the v numeric parameter to -1, suppressing some
routine messages
# The # numeric parameter sets the number of lines used by the built
in display driver. The default value is 24. A value of 25 may be
used for applications which require access to all 25 display lines.
A small value may be used when running ZCOMM under TopView to fit
the information into a small window. The cls or reset command
should be given after setting the parameters to initialize the
screen driver to the new values. If running with a virtual screen
with TopView or DESQview, the # and $ numeric parameters are
limited to 24 by 80 maximum. Full screen applications may give
abnormal displays if these parameters are set too small.
Nonsensical values tend to produce nonsensical displays.
EXAMPLE: cls; p#9; reset clears the screen, sets a 9 line window,
and initializes the screen driver to the new value.
$ Sets the number of CRT columns. A cls or reset command should be
given after changing the $ numeric parameter. The default value
(80) is that returned by the BIOS video interrupt 15h call. This
parameter may be set to support 132 column displays if the 132
column display mode is set before ZCOMM is called.[1] ZCOMM does
__________
1. With most display BIOS ROMs, ZCOMM reads the columns and lines
values from the BIOS when starting up or regaining control after a
(C) 1994 Omen Tech Inc Chapter 24 Numeric Parameters
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 206
not support displays less than 80 columns wide. The display
hardware must use the same number of columns as the $ parameter if
the resultant presentation is to make any sense.
SEE ALSO: # and V numeric parameters
- If non zero, the DOS Gateway (used with the ! command, etc.) uses
the undocumented DOS 37h function to fetch the current value of
SWITCHAR.
If negative, ZCOMM uses DOS line input (function 0xA) for commands
given from the main prompt. This enables DOS command line editors
such as CED. When these editors are active, they (and not ZCOMM)
interpret control, function and ALT- keys.
* Sets the CRT attribute for highlighted messages.
EXAMPLE: p*12 gives bright red.
Adding 1024 to this parameter forces ANSI SGR 1 to use this color.
? Count of the number of files sent or received with a protocol, and
the number of lines matched by the find command. A failed password
validation sets this negative. The exit status of subprograms is
stored in this parameter. Because of a bug in DOS COMMAND.COM, the
return value is valid only with Unix/Xenix flavors.
SEE ALSO: ? test condition
@ Sets the CRT attribute for the (normally) blinking messages such as
FILES OPEN. The numeric values are explained below, with the n
numeric parameter.
EXAMPLE: p@12 makes ZCOMM's normally blinking messages appear
bright red.
Adding 1024 to this parameter forces ANSI SGR 5 and 6 to use this
color.
A If non 0, selects a prefix character which allows ALT characters to
be generated by keyboards without ALT keys. This parameter is
supported on VAX/XMS and Unix platforms; please refer to the
platform specific addendum file for specifics.
______________________________________________________________________
DOS Gateway.
(C) 1994 Omen Tech Inc Chapter 24 Numeric Parameters
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 207
B If set non zero (the default), causes a bye command to be issued
each time a telephone number is executed as a command.
SEE ALSO: mcommand string parameter, number dialing commands
C If non zero, only display C ESC sequences per screen in the Review
Function, and count escape sequences when advancing or backing up
in the review buffer. Otherwise, ESC sequences are not counted.
D A nonstandard raw bit rate source is required to support
transmission speeds above 115200, as well as intermediate bit rates
(64000, 156000). Non standard raw bit rate sources can be
accomodated with the
E If non 0, substitute this for characters with bad parity detected
by the term function with e term option (Error Containment(TM)).
EXAMPLE: ena -7e; pE63 Substitute ? for characters received with
odd parity.
F Sets the CRT attribute for dim (faint) messages such as ANSI SGR2.
EXAMPLE: pF8 gives gray.
G This parameter controls the number of bytes loaded into the 16550A
transmit FIFO (First In First Out) storage register on each
interrupt. This parameter is effective only with PCDOS machines
using FIFO buffered UART devices.
For maximum efficiency, ZCOMM fills the 16 byte transmit FIFO when
the UART generates a FIFO Empty interrupt. Once loaded, data
transmission from the transmit FIFO cannot be stopped. Many bytes
may be sent after the modem sends XOFF or asserts hard flow control
restraint. Well engineered modems accept a large number of bytes
after exerting flow control restraint, but some don't.
The number of bits in the binary representation of this parameter
are counted to control the number of bytes loaded into the FIFO
each time the 16550A interrupts with an empty transmit FIFO
register. To improve Zcomm's responsiveness to flow control
restraint, set this parameter to 0.
EXAMPLE: pG0
H In Host Operation, sets the timeout in seconds for entering a
command or string in response to a command or other prompt,
including the accept command. A value of 0 (the default) disables
this timeout.
(C) 1994 Omen Tech Inc Chapter 24 Numeric Parameters
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 208
I Set the size of disk I/O buffer used for protocol file transfers.
Suitable values are 2048, 4096, 8192, and 16384. It may be
necessary to specify a CBSIZE environment variable larger than
10240 to prevent the circular buffer from competing with disk I/O
buffers for near heap space. Too large a value may exhaust memory,
induce receiver timeouts, cause disconnects(!), or generate
spurious errors on file transfers.
If your copy of ZCOMM is running on a floppy disk system or a slow
hard disk, a larger value may give better results. A large value
may also be used in extra high speed direct connect file transfers
where the I and the zmodem l numeric parameters are both set to
8192 or 16384 on the receiving system.
EXAMPLE: pI4096
Please understand that the B parameter has nothing to do with
anything you've heard about 128, 1024 or 8192 byte XMODEM style
blocks. Normally, ZMODEM's block size is the entire file.
K
PCDOS On the PCDOS flavor, if non 0, executes keyboard BIOS calls
to recover extended codes from 101 key keyboards. This causes
lockups with defective BIOS versions.
UNIX/VMS On Unix and VMS flavors, when ZCOMM reads an ESC character
and the K numeric parameter is 1 (the default), succeeding
characters in the keyboard buffer are read to detect encoded
function or ALT keys.
If the K numeric parameter is set to 0, ZCOMM will not
recognize escape codes representing function keys, allowing
the function key codes to be passed to the remote computer.
Setting the K numeric parameter to 0 activates the term
function's special processing of ENQ (Ctrl-E) and SYN (Ctrl-
V).
N When enabled with display mapkb, this parameter controls the
relationship between ANSI/VT52 Alternate Keypad mode (DECKPAM,
ESC=), ANSI Numeric Keypad mode (DECKPNM, ESC>), and the PC's
keyboard Num-Lock state.
0 causes ZCOMM to set the PC's keyboard Num_Lock state to match
Numeric Keypad mode when DECKPNM or DECKPAM is received.
32 causes ZCOMM to set the PC's keyboard Num_Lock state to the
opposite of Numeric Keypad mode when DECKPNM or DECKPAM is
received.
(C) 1994 Omen Tech Inc Chapter 24 Numeric Parameters
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 209
1 causes ZCOMM to set the PC's keyboard Num_Lock on in response to
either DECKPNM or DECKPAM.
2 causes ZCOMM to set the PC's keyboard Num_Lock off in response
to either DECKPNM or DECKPAM.
SEE ALSO: display, mk and ALT-M commands
O Controls OverThruster(TM) operation with XMODEM, XMODEM-1k, YMODEM,
and YMODEM-1k downloads. This parameter should be set as follows:
CompuServe XMODEM OverThruster is known to be effective on
CompuServe. Negative numbers control the number of bytes
added to the window on XMODEM downloads from the network.
Larger numbers increase throughput, but cause improperly
interfaced MNP modems and network nodes to drop characters
under stress, disrupting the file transfer.
EXAMPLE: pO-512; ro file1.ext
Other XMODEM Positive numbers up to a system dependent value less
than the protocol block size increase throughput. Larger
values induce timeouts and/or retransmitted blocks. The
optimum value must be determined by experiment. If you see
the message: Retry 0: Received dup Sector very often, the
value should be reduced. 60 usually give best results with
MNP modems at 2400 bps. The optimum value varies depending on
the remote computer, modem(s), system traffic, and the network
node.
EXAMPLE: pO60; ro file1.ext
P After a "speed" command, if you give a p command (display
parameters), the P parameter value will indicate the type of serial
I/O UART chip detected. ZCOMM automatically detects and enables
the FIFO on the NS16550A, NS16550AFN, and Intel 82510 chips.
EXAMPLE: Zcomm port 1 speed 19200 p
0 Indicates a standard 8250 or 16450 UART with no special
features.
1 Indicates an NS16550AN or NS16550AFN with 16 deep receive FIFO.
These are the preferred chips.
2 Indicates an Intel 82510 with 3 deep receive FIFO.
The sequence "port 1 pP1 speed 19200" bypasses ZCOMM's verification
(C) 1994 Omen Tech Inc Chapter 24 Numeric Parameters
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 210
checks normally performed on the FIFO configuration and may allow
defective FIFO logic on certain chips to be used. This incantation
is not required for the NS16550AN or NS16550AFN.
The sequence "pP-1 speed 2400" should be used with the Western
Digital WD16550 chip to disable the brain damaged FIFO on that
chip. The WD16550 FIFO has been observed to lose data when
transmitting at 2400 bps and slower speeds. The minimum speed for
normal transmit FIFO operation with the WD16C550 may vary with
different computers.
Q PCDOS VIDEO BIOS display mode to switch the display to 80 columns.
Default is 3 (80x25).
R If non zero, remove incomplete files received with a protocol
except those received with the + option (default 0).
S Timeout interval in seconds waiting for XON characters or positive
flow control (default 30). If an XON is not received within this
time, transmission resumes anyway. A value of 0 disables this
timeout.
T If Command Reentry has been enabled with the history command, the T
parameter prevents commands with fewer than T characters from being
stored in the history file. Excluding short and easy to type
commands from the history file makes it easier to find the commands
that are difficult to keyboard.
Setting T to a large number disables the storage of commands and
strings. This may be used to exclude passwords and other sensitive
information from the history file.
SEE ALSO: history command
V PCDOS VIDEO BIOS display mode to switch the display to 132 columns
in response to a VT-100 DECCOLM mode set command. To support
boards using an extended code in the bl register, calculate N = bl
+ (256 * al).
A popular value is 35 for the Tseng, ATI, and other extended EGA
boards. The Genoa Super EGA Hi-Res likes 96. The Everex EVGA uses
28684. The default value of 0 inhibits this function.
W This numeric parameter supports Video7 and similar boards which
require a non 0 value in the AH register on INT 10h bios calls for
setting video modes (e.g., 132 columns). The value of the W
numeric parameter (default 0) is placed in the AH register when
attempting to switch video modes.
X On Unix flavors, preset to +1 if the XTERM environment variable
contains xterm, preset to -1 if the variable contains the string
(C) 1994 Omen Tech Inc Chapter 24 Numeric Parameters
