ZCOMM User Manual
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 121
a function key where an unconditional return to the command prompt
is desired, even if keyboarded from the term function.
r [oldcmd] Search back through the history file of keyboarded lines
for the first line that oldcmd is a prefix of, and execute it. If
oldcmd is absent, execute the last locall entered keyboarded line.
EXAMPLE: history C:/tmp/junk.hst
del *.bak *.lst *.tmp *.foo
cd bazdir
r d
del *.bak *.lst *.tmp *.foo (command echoes)
SEE ALSO: history command
r7 [-options] [dir] [file ...] Receives with options 1 or more files
using MODEM7 batch protocol. An optional directory dir may be
specified. If pathname(s) have been supplied to the r7 command and
the sending program attempts to send more files than the number of
names supplied to the r7 command, the transfer is aborted. The
command is provided for compatibility with traditional programs that
do not support the superior YMODEM or ZMODEM protocols.
EXAMPLE: r7 -c Receive file(s) with MODEM7 Batch and CRC-16 (-c).
SEE ALSO: MODEM7 batch protocol, Chapter 12.
rb [-options] Receives with options 1 or more files using YMODEM batch
protocol. The rb command also receives files sent with SEAlink
protocol. Chapter 19 describes the available options. The pathname
and length of each file are transmitted in batch mode. If a file is
received in error (retries exhausted, etc.), the batch transfer will
terminate. If Restricted, a file received in error will be unlinked
(erased).
EXAMPLE: rb -y Receive file(s) with YMODEM replacing old files, if
any.
EXAMPLE: rb -g Receive file(s) with YMODEM-g.
Many programs claiming to support YMODEM actually use XMODEM with
1024 byte blocks; use ZCOMM's sx -k, rx and rx -g XMODEM commands
with these mutants.
SEE ALSO: YMODEM protocol, Chapter 12.
rb [-options] [dir] [file ...] Receives with options 1 or more files
using YMODEM batch protocol. An optional disk and/or directory dir
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 122
may be specified. The optional supplied pathnames file ... are
used in place of pathnames normally provided by the sending program.
If the sending program attempts to send more files than the number
of names supplied to the rb command, the transfer is aborted.
rc [-options] file Receives with options a single file using the Ward
Christensen XMODEM protocol, 128 or 1024 byte blocks, and CRC-16
instead of an 8 bit checksum. ZCOMM signals the sending program
that CRC-16 is to be used. After four errors while attempting to
receive the first sector, ZCOMM will cancel the CRC-16 option and
reverts to checksum operation.
The probability of an undetected transmission error is much less if
CRC-16 is used in place of the default 8 bit arithmetic checksum.
Omen Technology Inc Recommends use of the 16 bit CRC to maintain
data integrity at professional levels. Chapter 19 describes the
available options to the rc command. If Restricted, a file received
in error will be deleted.
EXAMPLE: rc foo.com
SEE ALSO: XMODEM-CRC protocol, Chapter 12.
read [file] Read file into the circular buffer. Once in the buffer,
it may be examined with the review command, searched for strings,
and cut and pasted to other files. If file does not fit into the
buffer, the buffer may be cleared with the kill command (or review k
subcommand) and subsequent read commands may be given to read more
of it. Review function commands are described in Chapter 22.
EXAMPLE: read allsig.tmp<ENTER><Home>
SEE ALSO: BROwse, seek commands
CAUTION: Iff a read command has left a transmit file open, entering
the term function will transmit the unread portion of the file. To
prevent this, close the file first with ALT-C or closetx.
receive Receives file(s) from a Kermit program. The other program
must be commanded to send the desired files.
SEE ALSO: get Kermit server access command
remote Enter Host state with unrestricted privileges to allow the
currently connected remote computer/terminal to issue commands.
When activated by the remote command, Host state will reset when the
modem carrier goes away. This command is useful for transferring
files between two machines with directly connected serial ports.
Remote may be prefixed with restrict to limit privileges.*
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 123
SEE ALSO: host command
remote cwd dirspec [password] Instructs the remote Kermit server to
change to the specified directory. The form of dirspec varies with
the remote system; it must be quoted if it contains special
characters or spaces. A password may be required by the remote
Kermit server.
SEE ALSO: Kermit Protocol, Chapter 12.
remote delete filespec Instructs the remote Kermit server to delete
the specified file(s). The form of filespec varies with the remote
system; it must be quoted if it contains special characters or
spaces.
remote dir dirspec Instructs the remote Kermit server to display the
specified directory on your screen. The form of dirspec varies with
the remote system; it must be quoted if it contains special
characters or spaces. The resulting information may be redirected
to a file with the >outfile command.
remote help Instructs the remote Kermit server to display help
information on your screen. The resulting information may be
redirected to a file with the >outfile command.
remote host host-command-string Instructs the remote Kermit server to
perform the specified command and display its output on your screen.
The form of host-command-string varies with the remote system; it
must be quoted if it contains special characters or spaces. The
resulting information may be redirected to a file with the >outfile
command.
EXAMPLE: remote host "kill -9 0" Terminates all your processes with
extreme prejudice.
SEE ALSO: !!command
remote print filespec Instructs the remote Kermit server to print the
specified file(s) on the remote system. The form of filespec varies
with the remote system; it must be quoted if it contains special
characters or spaces.
remote space [dirspec] Instructs the remote Kermit server to display
the free space in the specified directory on your screen. The form
of dirspec varies with the remote system; it must be quoted if it
contains special characters or spaces. The resulting information
may be redirected to a file with the >outfile command.
remote type filespec Instructs the remote Kermit server to type the
specified file(s) on your screen. The form of filespec varies with
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 124
the remote system; it must be quoted if it contains special
characters or spaces. The resulting information may be redirected
to a file with the >outfile command.
remote who Instructs the remote Kermit server to display the logged in
users on your screen. The resulting information may be redirected
to a file with the >outfile command.
reset Write the contents of the circular buffer if a receive file is
open, close all files, and reset the disk system. This allows
swapping diskettes.
reskeys Resets the Soft Keys to empty.
SEE ALSO: set command
restime * Resets elapsed time and counts of bytes transmitted and
received to zero. The restime command may be given in a script
immediately after login is completed to synchronize the elapsed time
counter with the beginning of chargeable connect time.
SEE ALSO: timestamp command, E test condition
restrict * Restricts ZCOMM for the following command on the same line.
This command is useful for testing.
EXAMPLE: restrict source /menu.t
RETurn Returns from a script subroutine accessed by a call, source, or
gosub command.
SEE ALSO: fail command
rewind Reset the buffer pointers for display, printer, and file output
used by the term function to the beginning of the circular buffer.
This will cause the term function to redisplay the data in the
circular buffer. Patterns will be rescanned. A typical use of the
rewind function is to allow replay of an editing session on a remote
machine, or to redisplay the material received if the initial
settings of the i, c, n or v modes were incorrect for the material
received from the remote.
N.B.: The rewind command does not reset the buffer free character
count. To write the data to disk, a write command (or ALT-W) must
be given before accepting new data from the remote.
SEE ALSO: t, b, w review subcommands
REView Review the data received from the host or read by the read
command. A screenfull is displayed at a time. Review function
commands are listed in Chapter 22.
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 125
ro [-options] file Receives with options a single file using non-
standard XMODEM-CRC protocol logic. OverThruster(TM) speeds file
downloads at the expense of error recovery. OverThruster operation
is controlled by the O numeric parameter. As fans of Buckaroo
Bonzai know, the OverThruster is not universally applicable. A
transmission error will almost always terminate an OverThruster file
download.
If Restricted, a file received in error will be unlinked (erased).
EXAMPLE: ro foo.com
SEE ALSO: O numeric parameter
rt [-options] [dir] [file ...] Receives with options 1 or more files
using Telink (FIDO) batch protocol. An optional disk and/or
directory dir may be specified. The optional supplied pathnames
file ... are used in place of pathnames normally provided by the
sending program. If pathname(s) have been supplied to the rt
command and the sending program attempts to send more files than the
number of names supplied to the rt command, the transfer is aborted.
The rt command is provided for compatibility with traditional
programs that do not support the superior YMODEM or ZMODEM
protocols.
EXAMPLE: rt -c
SEE ALSO: Telink protocol, Chapter 12.
rw [-options] file Receives with options a single file using the
People-Link WXMODEM protocol. Chapter 19 describes the available
options. If Restricted, a file received in error will be unlinked
(erased).
EXAMPLE: rw foo.com
rx [-options] file Receives with options a single file using the Ward
Christensen XMODEM protocol. CRC-16 is not the default because most
commercial comms programs only support the 8 bit checksum. Chapter
19 describes the available options. If Restricted, a file received
in error will be unlinked (erased).
EXAMPLE: rx foo.com
N.B.: The rc command should be used whenever possible instead of rx.
EXAMPLE: rx -g foo.txt Receive a single file with an ACKless XMODEM
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 126
protocol mutant incorrectly called "ymodem-g" by PCBoard and Qmodem
programs.
SEE ALSO: XMODEM protocol, Chapter 12.
rz [-options] Receives with options 1 or more files using ZMODEM batch
protocol. Chapter 19 describes the available options. Each file's
pathname is obtained from the sending program. The +, a, b, n, N,
r, and y options are accepted from the sending program, subject to
Restriced privileges. If the +, b, n, N, r, or y option is
specified to the receiver, it overrides any contrary options
specified to the sender. Only one of the a, b, or r options may be
specified. Only one of the +, n, N, or y options may be specified.
If a file is received in error (retries exhausted, etc.), the batch
transfer will terminate. If Restricted, a file received in error
will be unlinked (erased).
EXAMPLE: rz -y
SEE ALSO: Z mode
SEE ALSO: ZMODEM protocol, Chapter 12.
rz [-options] [dir] [file ...] Receives with options 1 or more files
using ZMODEM batch protocol. An optional disk and/or directory dir
may be specified. The optional supplied pathnames file ... are
used in place of pathnames normally provided by the sending program.
If the sending program attempts to send more files than the number
of names supplied to the rz command, the transfer is aborted. To
allow use of the rz command, Z mode (ZMODEM autodownload) should be
turned off with a dis -Z command.
s Displays status information.
LSR and MSR refer to the Line Status Register and Modem Status
Register of the modem port's 8250 UART device.
TYP refers to the type of serial chip detected. A National 16550A
shows as 1, an Intel 82510 shows as 2. Other chips (without high
speed enhancements) show as 0.
"Uncorrected errors" displays the e numeric parameter, which counts
the number of failed file transfers and "line hits" detected by the
term function.
If one or more scripts are active, the current line number (counting
from the first line in the script file) for each script level is
displayed.
Any patterns active as a result of a pattern or wait command are
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 127
displayed. An S indicates not matched (still searching), F
indicates that pattern has been matched.
SEE ALSO: ALT-S function key
s7 [-options] pathspec Send the files specified in pathspec using the
MODEM7 batch Protocol. Files which cannot be opened are skipped.
An empty pathspec sends all files in the current directory. A
directory name expands to all regular files in that directory.
If an error aborts a file transmission (retries exhausted, etc.),
batch transfers terminate.
EXAMPLE: s7 *.com Sends all *.com files
N.B.: The receiver must be commanded to receive the files. This
command is provided for compatibility with traditional programs that
do not support the superior YMODEM and ZMODEM protocols.
SEE ALSO: MODEM7 batch protocol, Chapter 12.
sb [-options] [PREFIX=p | ONAME=x] pathspec Send the files specified
in pathspec using True YMODEMTm Protocol. The pathname, length, and
modification time of each file are transmitted. Files which cannot
be opened are skipped. An empty pathspec sends all files in the
current directory. A directory name expands to all regular files in
that directory.
If an error aborts a file transmission (retries exhausted, etc.),
batch transfers terminate. The sb command will send files with
SEAlink protocol if the receiving program requests SEAlink.
EXAMPLE: sb -k *.com Sends *.com using 1024 byte packets.
N.B.: The receiver must be commanded to receive the files with an rb
command. Unix and OS/2 users: sb command cannot be used to send
source files that grow after the beginning of transmission.
SEE ALSO: YMODEM protocol, Chapter 12, SEAlink protocol, Chapter 12.
seek offset Iff a transmit file is open as a result of a f, open, or
read command, position the file read pointer to offset bytes from
the beginning of the file if offset is positive (or 0), or from the
end of the file if offest is negative. "Seek 0" rewinds the file to
its beginning.
EXAMPLE: open baz; seek -20000; read<ENTER>Home Reviews the last
20000 bytes of baz.
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 128
SEE ALSO: open, read, close
send [-options] pathspec Send the files specified in pathspec with the
Kermit protocol. The send command sends files to either a Kermit
server or a regular Kermit program.
EXAMPLE: send -a *.asm
set[s|c] [[_]sparam string] Set String parameter sparam to string. As
with all ZCOMM strings, the string must be enclosed by double quote
characters if it contains spaces, tabs, or semicolons. Character
escapes must be used to represent special characters, including
return and linefeed if needed.
An optional leading underscore (_) prepended to sparam causes the
string to be cleared by the next call command.
EXAMPLE: set mprefix ATDT sets the modem dialing prefix for tone (T)
EXAMPLE: set f8 \PXXXXX Assigns a five character automatically
generated password (\PXXXXX character escape described in Chapter )
to function key F8. Once programmed this way, the F8 key will
transmit five nonsense characters determined by the xpassword string
parameter and the remote system's name as stored in the remote
string parameter by the last call command.
EXAMPLE: set _f1 "logout\r" Assigns the string "logout<ENTER>" to F1
until the next call command.
The parameters that may be set with this command are described in
Chapter 24. Case is significant in parameter names.
Set without any arguments will display all non empty string
parameters and their values. If the v (verbose) numeric parameter
is non zero, all string parameters are displayed. The echo and lput
commands may be used to display string parameters ("echo %svar").
The setc command performs string substitutions and character escape
expansions on string before storing. The sets command performs
string substitutions on string before storing.
N.B.: Chapter 25 discusses string concatenation.
EXAMPLE: sets s2 "%z1" Assigns the second token (%z1) generated by
the split command to string parameter s2.
If other commands are to follow on the same line, a semicolon must
be used to separate the commands.
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 129
EXAMPLE: set s1 "su"; goto sendit Would be illegal if the ";" were
left out.
A string parameter may be set to empty with set sparam "" (empty
string enclosed by double quote characters).
EXAMPLE: pv1; set Displays all string parameters, including all Soft
Keys.
EXAMPLE: sets s8 "s9 EQUALS %s9" Substitutes the value of string
parameter s9 in the argument before assigning it to s8.
SEE ALSO: echo, if, keys, reskeys, ALT-K, commands
N.B.: When defining function keys to be called from within the term
function, do not use the t or f commands. Instead use the create or
open commands to prevent excessive term function recursion.
Assigning a string to a function key with the set command causes
that string to be sent to the remote when the key is used within the
term function. If the string begins with @, the remainder of the
string is executed as a ZCOMM command.
EXAMPLE: set f3 "@rb" Assigns the rb command to F3.
set[s|c] [_]sparam This form of the set command allows strings
containing double quote (") characters to be defined.
Given with string parameter sparam, but no string, set reads string
from the next line verbatim, with only the trailing CR/LF removed.
The line should not begin with a space or tab unless one is required
for string. This form may be used for entering strings containing
double quotes. If a script is active, the next line is read from
the current script file, otherwise the user is prompted for it.
N.B.: This form of the set command cannot be used as the predicate
of an if command. The argument should not appear as a label or
telephone directory entry.
EXAMPLE: set outahost
@o; pk3; sp 2400; set disks "abcd"; putw "\336ATM0H1\r" Programs
__________
15. Because a failed if command would skip to the next line, the
argument of the set command, and attempt to execute it as a script
line.
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 130
outahost to drop DTR ("o"), set 2400 baud, allow disks a,b,c, and d,
and send an ATM0H1 (go off hook) command to the modem to busy out
the telephone line.
setn sparam expression The setn command stores as a decimal number the
result of an arithmetic expression consisting of decimal numbers,
string variables, the length of string variables denoted with %, and
the oprators +, -, *, and /. The expression is evaluated strictly
left to right with 32 bit precision.
EXAMPLE: setn vv 1+vv
set? sparam condition The set? command stores a decimal number
representing the result of a test condition.
EXAMPLE: set? s0 S Stores the value of the S test condition
(transmission speed) in string variable s0.
sleep deci-seconds Sleep causes ZCOMM to pause for the specified
tenths of seconds. This command may be used in a script with one or
more put commands to login to a timesharing service. The presence
of a character in the keyboard buffer will cause the sleep command
to finish before the specified time.
The maximum sleep time is 32000 tenths of seconds. Applications
involving long sleep times may be better handled with the Host
Operation callout queue.
EXAMPLE: sleep 30 Pauses for 3 seconds.
Soft Keys The Soft Keys f5-f12, fs1-fs10, fc1-fc10, fa1-fa10, fins,
fdel, fhome, fend, fup, fdown, fleft, fright, fpgup, fpgdn, etc.
may be programmed by set commands given in script files, including
the "setup" entry in the distribution PHODIR.t file. The strings or
commands assigned to these keys may be displayed with the keys or
ALT-K command. To get a current list of the available soft keys
(and other string parameters), keyboard the following three
commands:
pv1
>keylist
set
close; pv0
source sourcefile Accept script commands from sourcefile. The source
and call commands may be nested with up to six[16] scripts open at
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 131
once.
If the script has a READ ONLY attribute, ZCOMM is unrestricted
during execution of the script.*
Command lines in files accessed by the source command must begin
with a tab, space, or label. Goto commands within sourcefile search
for labels in the same sourcefile. Gosub commands within sourcefile
access subroutines in the telephone directory accessed by the phones
string parameter.
EXAMPLE: bud source /usr/bin/caf/bin/callbud
This telephone directory entry pat calls a separate script file
containing commands to call a secret system. Placing this
information in a separate file keeps it out of the main telephone
directory file, which might be used on a number of computers.
SEE ALSO: gosub command
SPeed m Set the transmission speed ("baud rate") to m. If the speed
specified is odd, or equal to 110, two stop bits are transmitted;
otherwise one stop bit is transmitted.
EXAMPLE: speed 1200
N.B.: Some older U.S. Robotics modems cannot accept the sustained
full speed output ZCOMM is capable of. Using speed 2350 corrects
such a problem with the U.S. Robotics Courier 2400.
Some 1200 and 2400 bps modems work better (lower error rate) if the
speed is set to slightly less than the nominal 1200 or 2400. This
also applies to communications networks that cannot accept sustained
full speed data, and to serial ports whose bit rate clocks are
slightly fast.
EXAMPLE: speed 1181 Sets the speed to 1181 bits per second with two
stop bits.
NB: Timesharing minicomputers often transmit from their serial ports
data at higher speeds than they can accept. In extreme cases, a
timesharing port that supports interactive operation at 19200 bps
______________________________________________________________________
16. Deep nesting may require a decrease in circular buffer memory
allocation.
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 132
may not tolerate file uploads above 2400 bps.
NB: Operation at extra high speeds is affected by the operating
system version, device drivers, memory resident software, and the
computer's hardware design. Chapter 33 describes some of the well
known problems. The new generation NS16550AN or 82510 serial
interface circuits should be used instead of 8250's for best results
at high speed. This is important if special device drivers or TSR
programs increase interrupt latency.
SEE ALSO: 7e, 7o, 7m, 7s, 8n, 8g modes, handshake command
split svar Split (parse) string parameter svar into tokens stored in
string parameters z0...z9 using one or more of the characters in
string parameter ifs ("Internal Field Separator") to separate the
tokens. **
EXAMPLE: If string parameter s1 contains "hello there folks" and ifs
contains a space and tab, split s1 Assigns "hello" to z0, "there" to
z1, and "folks" to z2.
EXAMPLE: Let s0 contain "#1234567-This is big-time Parsing", and ifs
contain "#1256- ". The command split s0 Assigns "34" to z0, "7" to
z1, "This" to z2, "is" to z3, "big" to z4, "time" to z5, and
"Parsing" to z6.
SEE ALSO: y0...y127 string parameters, I,i,p test conditions, sets
command
split svar string ... uses one string for each token generated. An
empty string ("") assigns the rest of svar to the next token.
Otherwise, if tokens remain after the strings are exhausted, ifs is
used for parsing the remaining tokens.
EXAMPLE: If s0 contains "#1234567-This is ZCOMM Parsing", The
command split s0 "-" "" Assigns "#1234567" to z0 and "This is ZCOMM
Parsing" to z1.
EXAMPLE: If s0 contains "503-621-3746", The command split s0 "-" "-"
Assigns "503" to z0, "621" to z1, and "3746" to z2.
SEE ALSO: ss command, scripts, Chapter 99
ss svar regular-expression String Split svar according to regular-
expression. ** Regular expressions are described in Chapter 25.
The entire matched string (if any) is stored in the z0 string
parameter.
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 133
Matched groups are stored in the z1...z9 string parameters.
Parameters which do not receive a matched string or substring are
set empty.
EXAMPLE: If string parameter s0 contains
From: Captain Midnight To: HBO Inc.
then the command ss s0 "From: (.*) To: (.*)"
places "Captain Midnight" in z1 and "HBO Inc." in z2. In this case,
z0 will contain the entire contents of s0.
SEE ALSO: split command, regular-expressions Chapter 25
st [-options] pathspec Send the files specified in pathspec using the
Telink (FIDO) batch Protocol. The pathname, length, and
modification time of each file are transmitted. Files which cannot
be opened are skipped. An empty pathspec sends all files in the
current directory. A directory name expands to all regular files in
that directory.
If an error aborts a file transmission (retries exhausted, etc.),
batch transfers terminate.
EXAMPLE: st *.com Sends *.com
N.B.: The receiver must be commanded to receive the files.
SEE ALSO: Telink protocol, Chapter 12.
sum pathspec Checksums the named text files with an alogrithym
compatible with sum(1) on Version 7 Unix (sum -r on System III/V).
Carriage returns, and all characters starting with the first
instance of CPMEOF (^Z) are excluded. This processing allows
comparison of plain ASCII source files stored on the different
systems, but not binary files. The checksum is printed in octal,
followed by a count of 512 byte blocks and bytes read.
EXAMPLE: sum *.c Checksums all C source files in the current
directory.
SEE ALSO: crc, wc commands
sx [-options] file Send a single file using the Ward Christensen
XMODEM or XMODEM-CRC protocol. The receiving program may request
use of a 16 bit CRC, which is more accurate than the default
checksum. DOS/Unix files sent this way will have Control-Z (CPMEOF)
garbage characters appended to make the file length a multiple of
128.
EXAMPLE: sx foo.com
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 134
EXAMPLE: sx -k foo.com Sends foo.com using 1024 byte blocks
N.B.: The receiver must be commanded to receive the file with an rx
filename or rc filename command.
SEE ALSO: XMODEM, XMODEM-1k, XMODEM-CRC protocols, Chapter 12.
sz [-options] [PREFIX=p | ONAME=x] pathspec Send the files specified
in pathspec using ZMODEM Protocol.[17]
N.B.: If the remote supports ZMODEM AutoDownload, or accepts rz
followed by carriage return as a command to receive files with
ZMODEM protocol, only the sz command need be given. Otherwise, the
receiver must be commanded to receive the files with an rz command
or menu choice.
The +, a, b, n, N, r, y, and Z options are sent to the receiving
program. Only one of the a, b, or r options may be specified. Only
one of the +, n, N, or y options may be specified. The pathname,
length, and modification time of each file are transmitted. Files
which cannot be opened are skipped. An empty pathspec sends all
files in the current directory. A directory name expands to all
regular files in that directory.
If ONAME=x is given after the options (if any) and before the file
name(s), x will be used exactly as given as the COMPLETE destination
pathname instead of each file's actual pathname. It is the sender's
responsibility to use lower case for x unless the filename is really
supposed to be all caps.
EXAMPLE: sz -y ONAME=B:/spiked/secret /soviet/sdi/newlaser.doc
Results in the destination file secret on drive B: in the /spiked
directory. (Destination directories must exist and be writable).
If instead PREFIX=p is given after the options (if any) and before
the file name(s), p will be added to the destination pathname(s) as
a prefix. It is the sender's responsibility to use lower case for p
unless the prefix is really supposed to be all caps.
EXAMPLE: sz -y PREFIX=C:/foobaz/ /biff/bam/aardvark.wak
Results in the destination file "C:/foobaz/aardvark.wak"
EXAMPLE: sz *.com Sends all files with a .com extension.
__________
17. The receiver may use the sz command to send files by uploading an
sz command with the zcommand command.
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 135
EXAMPLE: sz -r ??log Crash Recovery sends only the new data if the
receiver has incomplete versions of these files.
EXAMPLE: sz -fn src/*.c src/*.h maildir
Sends only newer .c and .h files in the src subdirectory, and all
new files in the maildir subdirectory.
EXAMPLE: zcommand "sz -fn /bin /wp"
commands a remote ZCOMM system in Host Operation (unrestricted) to
send all new files in the /bin and /wp directories.
EXAMPLE: sz -Yn *.c Sends only newer versions of files that already
exist at the destination.
EXAMPLE: sz -Rf usera Sends all files in the usera directory and all
subdirectories thereof. Directories are not sorted when the R
option is used on 16 bit systems.
SEE ALSO: ZMODEM protocol, Chapter 12, Options, Chapter 19.
szb [-options] [PREFIX=p | ONAME=x] pathspec As above, but "falls
back" to YMODEM if the receiver cannot receive files with ZMODEM
protocol. Because of the YMODEM fallback, szb is not as error
resistant as the sz command.
t [-modes] [capturefile] Invokes the term function for conversational
access to the remote. Normally, ZCOMM will remain in the
termfunction until the user keyboards F1.
If capturefile is specified, any currently opten capture file is
closed and capturefile is opened. A file previously opened by "t
file" is not closed by a t command given without an argument.
EXAMPLE: t file1 Creates file1 to capture data sent by the remote in
interactive conversation.
SEE ALSO: create command
If a file upload begun by an f or open command were in progress, the
upload will resume with the t command subject to the g mode.
In host operation, "t file" begins data capture, and received
characters are not echoed. When the remote sends ETX, EOT, or
Ctrl-Z, file is closed and the term function exits.
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 136
EXAMPLE: t comments.txt<ENTER>
jabber ... jabber ... Ctrl-Z
Optional modes may be enabled to modify the display, storage, or
transmission of information.
Subcommands available from the term function are explained in
Chapter 21. Characters special to the term function are also
described in Chapter 21.
tcs M N The local display of ASCII characters can be remapped to suit
local requirements with the tcs (Terminal Character Set) command,
where M is the incoming character (1 to 127) and N is the desired
hardware character 1 to 255.
EXAMPLE: tcs 91 146 translates the ASCII [ character to the AE
character.
The command tcs by itself diasables these translations but does not
reset the translation table.
The command tcs 0 resets the entries in the translation table.
SEE ALSO: display command
timestamp * Iff a capture file is open, write out the circular buffer.
Then write a line containing the remote system name, number of
characters transmitted from disk, the number of characters received
to disk, average characters received per second, [18] the date and
time, and the term function status line information (time, modes,
etc.) to the file and to the display.
EXAMPLE: timestamp; echoc "End: %e Errors"
Timestamp: vif 0 127857 97/sec 1342:37 07-09-86
01 24 13:42 21:50 28672 2:1200 7e EhjSt >cis0709.tmp
Allsig Ends: 0 Errors
The character counts are reset when the corresponding files are
opened.
SEE ALSO: restime, ALT-E commands, E test condition, t string
parameter
__________
18. Since the last call or restime command.
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 137
trs svar string1 string2 String1 and string2 are first processed for
character escapes. Then translate string variable svar from the
character set in string1 into the character set in string2. *
Characters in String1 with no corresponding character in String2 are
deleted. Characters in svar not appearing in String1 are not
modified. The "trs" command may not be used in the body of a
"while" command.
EXAMPLE: trs s0 "\\{}" "/" Changes backslashes to slashes, and
removes "{" and "}" characters.
TYPe pathspec Type the specified file(s). This command closes any
open transmit file. ZCOMM automatically detects SQueezed files and
prints them in ASCII.* Type pauses/resumes printing with ^S.
Keyboarding ^C or Ctrl-Break cancels, and ^X skips to the next file.
<Ctrl-Home> clears the screen without pausing, avoiding scrolling.
SEE ALSO: browse, list, page commands, Unix b, bro, typ commands
EXAMPLE: type *.txt *.doc
unrestrict Prompts for a password and unrestricts ZCOMM if the
password exactly matches the contents of the unrestrict string
parameter. If unrestrict is empty or the given password does not
match in three attempts, the call is immediately terminated.
Unrestrict is used in Host Operation by a caller who wishes
unrestricted access to ZCOMM's computer to view confidential files
or perform maintenance.
EXAMPLE: unrestrict Prompts for a password (to match the unrestrict
parameter), then allows three tries to enter it correctly.
SEE ALSO: Host operation
usq pathspec * Unsqueeze the specified files back to their original
form. If pathspec is empty, ZCOMM checks all files in the current
directory and unsqueezes those that are found to be SQueezed. If
pathspec contains the name of a directory, all files in that
directory are checked. Iff a file has not been SQueezed, ZCOMM will
complain and proceed to the next file. ZCOMM checks the first word
of the file(s) to determine whether that file is SQueezed. If the
SQueezed file has been encrypted, such as a Demand Upgrade(TM) copy
of ZCOMM, ZCOMM will fetch the key file relative to the current
directory for use in decrypting.
N.B.: The original pathname and the keyfile pathname (if present),
stored in the SQueezed file is interpreted relative to the current
directory.
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 138
EXAMPLE: cd /tmp; usq a: Unsqueezes all the SQueezed files on A:,
placing the output files relative to /tmp.
EXAMPLE: usq ZCOMM.EQE Unsqueezes an encrypted Demand Upgrade(TM)
copy of ZCOMM. The key file (such as yampc08.key) must be in the
current directory.
videobios N Sets the video BIOS mode to N. This command is useful for
accessing the high resolution super EGA display text modes, such as
100 columns by 75 lines corresponding to high resolution 800x600
displays. The $ and # mumeric parameters must be separately set to
agree with the new BIOS video mode.
The action of the video ROM BIOS to specific values depends on the
particular EGA/VGA ROM BIOS used. To support boards using an
extended code in the bl register, calculate N = bl + (256 * al).
Some codes produce spectacular unpredictable results. This command
is restricted, and is available on medium model DOS flavors only.
EXAMPLE: videobios 3 Sets BIOS video mode 3 (80x25).
SEE ALSO: V and W numeric parameters
w Writes the contents of the circular buffer to the capture file.
wait [-mode] Wait activates the term function to search for each
pattern that has been defined with the pattern command. If a file
has been opened with the create or t file commands, buffer capture
continues during the wait command. If a file upload (inititated by
an f file command) was in progress, the upload will resume with the
wait command subject to the g mode.
Script execution resumes when the wait command returns because of a
pattern match, timeout, no carrier detect, or keyboarded F1. The
wait command's pattern search timeout is effective even if no search
patterns have been set with the pattern command.
SEE ALSO: pattern, put, putw commands, fN mode
wc pathspec Counts lines, words, printing characters, and all
characters for the specified files. The totals are then presented.
Characters beginning with CPMEOF (^Z) are excluded.[19] The count of
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 139
printing characters is useful for estimating laser toner and printer
ribbon usage.
EXAMPLE: wc *.c *.h
SEE ALSO: crc, sum commands
while condition rest-of-line Scripts must often repeat a command or
set of commands while some condition remains true. The while
command executes the command(s) on the rest of the line while
condition is true. Chapter 26 describes testable conditions. An
inadvertently generated while loop may be stopped by keyboarding
NUKE (ALT-N).
N.B.: The rest of the line must not contain an if command or
semicolons separating commands. While commands may not be nested.
EXAMPLE: pat 1 "ogin:"; while !1 put "\r" wait -f1 Repeatedly sends
a carriage return until the remote responds with "Login:".[20]
EXAMPLE: while "!1&&L<5" put "\r" wait -f1 Works as above, but only
tries 5 times.
x (eXit) Writes and closes any open files, releases ownership of the
serial port, then exits to the operating system without
disconnecting the phone line.[21] Exit status is the value of the ?
numeric parameter. This command is not allowed if Restricted.
xpc ... * The ZCOMMXPC flavor of ZCOMM supports the Tymnet(TM) X.PC
link level protocol with the xpc commands. See a following
subchapter of Chapter 18 for a more detailed description of the X.PC
packet driver and the xpc commands that control it.
______________________________________________________________________
19. The line and word counts agree with the Unix word count program,
but the character count will differ because of CR characters not
stored in most Unix text files. The Unix word count program does
not have a count of printing characters.
20. The "L" in "Login" is not searched for on purpose. On Unix
systems, the "l" is not always capitalized.
21. On some Unix systems, the operating system may alter the state of
the serial port after ZCOMM exits.
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 140
zcommandi COMMAND Send COMMAND with ZMODEM protocol, do NOT wait for
command completion.
EXAMPLE: zcommandi "!make whoopie"
zcommandic COMMAND Process COMMAND for string substitutions and
character escapes and send with ZMODEM protocol, do NOT wait for
command completion.
zcommandw COMMAND Send COMMAND to the remote with ZMODEM protocol.
ZMODEM assures an error free command upload. Wait for COMMAND to
complete on the remote. Store the command's exit value in the ?
numeric parameter, available to the ? test condition.
N.B.: With the exception of sz, no command that involves the serial
port may be the argument of zcommand.
EXAMPLE: zcommandw "sz foo.bar" Causes the remote to send a file
with ZMODEM protocol.
EXAMPLE: zcommandw "!ls -l | sz -a -" Causes a remote Unix system to
send a file containing a directory listing to ZCOMM.
As a special case, zcommandw with an empty command fetches the
remote's disk file system free character count. This quantity is
then available to the R test condition.
EXAMPLE: zcommandw ""; if "R>10000" sz hugefile Fetches the free
disk space from the remote, and sends hugefile if the destination's
free space is greater than 10000 kilobytes.
zcommandwc COMMAND Process COMMAND for string substitutions and
character escapes and send with ZMODEM protocol, wait for command
completion.
zmodem Used as a prefix to the p command to select the "zmodem"
parameters, or by itself to select the ZMODEM protocol for commands
which operate in a choice of protocols depending on past history.
EXAMPLE: zmodem
!!sz *.*
Uses ZMODEM to send a command to the remote machine to send all the
files in its current directory.
_ Enter a disgnostic routine that prints information about each
keystroke entered. Keyboarding LF (Ctrl-Enter) exits the _
(underscore) command. When a key is struck, the scancode, modified
scancode, and the shift state are displayed in decimal. The
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 141
modified scancode is either the raw scancode as returned by the BIOS
or 224 added to the ZCOMM internal code iff the raw scancode equals
224. The ZCOMM internal code for the key (usually the ASCII value)
is displayed in octal. This command may be used for exploring
keyboard encoding and preparing alternate keyboard mappings for use
with the mk command.
SEE ALSO: mk command
![%][~]command Execute command (either a program or a DOS built-in
command) as a subprogram. A leading % (percent sign) processes
Command for string parameter substitutions. See Chapter 18.6 for
details on DOS Gateways and Unix Shell Escapes.
SEE ALSO: obey command
!!host-command Sends the rest of the line (after !!) to a remote
ZMODEM program or Kermit server for execution on the server machine.
host-command is not processed for string parameters. This is a
convenient alternative to remote host host-command-string
particularly if host-command contains spaces.
label: A label begins at the first column and ends with a colon. One
or more commands may appear on the same line separated from the
label by white space. A label may have the same name as a directory
entry provided the directory entry appears first in the script file.
N.B.: a label differs from a directory entry, which does't end with
a colon. When ZCOMM encounters the next directory entry in script
processing, an automatic "return" is performed.
EXAMPLE: if 1 goto cond1
echo "Pattern 1 not matched"
cond1: echo "processing continues"
foosys speed 2400 666-1234 t
:comment A colon as first character in a command causes the rest of
the command line to be ignored. This is also useful for "commenting
out" commands in script files.
EXAMPLE: : this line does nothing at all
; Semicolon is a command delimiter which may be used in place of
RETURN to place multiple commands on a line. Since commands such as
echo, set, sb, pattern, list, and type take an indefinite number of
operands, the semicolon must be used to string such commands
together.
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 142
EXAMPLE: sb *.c; off Batch transmits all *.c files, then puts the
modem on hook and exits to DOS.
Semicolon is not a command delimiter if it is escaped by a backslash
or if it appears within a quoted string.
EXAMPLE: pat 0 ";" Sets pattern 0 to search for a semicolon.
Commands that take a fixed number of arguments may be strung
together without a semicolon unless otherwise noted.
EXAMPLE: port 1 speed 1200
<file Redirects input used by the command prompt and review function.
When reading input from file, certain characters are special:
~ Accept the next character verbatim.
| Sleep for one second.
'' Double quote echoes succeeding characters to the display with
highliting until the next double quote is encountered.
On end of file, a ^U is returned and input reverts to the keyboard.
The file rev on the demonstration disk is a typical file which might
be used with the < command.
>[>]outfile Redirects output from succeeding utility commands and
debug output (if the v numeric parameter is non zero) to outfile.
Capture from the circular buffer is also enabled, but there is no
automatic writing of the circular buffer to the file on close.
>>outfile appends to outfile. The output redirection is canceled by
the close command or by > without a filename. DOS predefined device
names such as "prn" may be used.
The syntax of ZCOMM's redirection differs from that used by DOS and
UNIX. ZCOMM's output must be redirected before the command(s) are
given, and the redirection stays in effect until explicitly
canceled. ZCOMM's command prompt is not redirected.
EXAMPLE: bdump file0
kill
>file1
dump file0
close
Dumps the contents of the modem input buffer to file0. Output is
then redirected to file1 and contents of file0 are displayed in side
by side hex/ascii format.
Note that the create and t filename commands do not redirect utility
command output to the file.
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 143
18.2 Function Key Commands
Some function keys are recognized at the command prompt. Function key
commands may not be mixed with any other character. For example,
keyboarding "t PgUp" elicits an error bell. Some scrips redefine the
function keys. The standard assignments may be restored with a gosub
setup command.
F2 From the command prompt, F2 enters term function.
SEE ALSO: t [file] command
Up Select the previous command in the command stack for reentry.
Down Select the next command in the command stack for reentry.
Home,PgUp,End Enter the review function.
F3...F10 Function keys F3 to F10 are programmed by set commands in the
"setup" directory in the distributed telephone directory. The key
definitions in PHODIR.t may be modified or removed at your
discretion.
F3 Receives files with YMODEM protocol, or XMODEM. [22]
F4 Invokes TurboLearn Script Writer(TM) to record keystrokes and
computer dialog, then generates a script using this information.
If ZCOMM is not currently connected to a system, the script called
by F4 prompts the user for telephone number, baud rate, and parity.
When recording is finished, the script prompts for a pathname to
store the completed TruboDial script in.
F5 On Unix systems, begin background operation and issue a sub shell
for the user. ZCOMM operation proceeds with screen output
suppressed. If ZCOMM should require keyboard input before the user
returns, ZCOMM waits for the user to return.
F6 Prompts for a file name, then receives that file with the XMODEM-
CRC protocol. ZCOMM will revert to the basic XMODEM protocol after
a few timeouts if the sender does not support CRC-16.
F7 Prompts for a file name, then transmits that file with XMODEM
protocol. If the file name includes wildcard characters, or if more
__________
22. ZCOMM generates a file name if the sending program does not
provide one.
(C) 1990 Omen Tech Inc Chapter 18 Function Key Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 144
than one file name is given, or if a directory name is given, YMODEM
protocol will be used.
F8 Generates and transmits a password based on the called system's
name and the string parameter xpassword. * This command is valid
only when called from the term function.
F9 Calls a script to add a new system entry to the Telephone
Directory. The script prompts for a system name, and checks for
duplications with entries currently in the Phone Directory. The
script prompts for comments which will display when that system is
called. Speed and parity are then prompted for, and the entry is
added to the end of the Phone Directory.
F10 Invokes the "help" command or help processor.
Shift-F1 List the Phone directory.
Shift-F2 Search Phone Directory for system names matching user
supplied string.
Shift-F3 List voice calls in the Phone Directory.
Shift-F4 Dsconnect the modem from telephone line (hang it up).
Shift-F5 Prompt for a system name and add a command to call it to the
circular dialing queue. List the queue contents.
Shift-F6 Run (execute) the circular dialing queue.
The following function keys are valid at the main command prompt,
from the term function, and from the review function.
Ctrl-Home Resets display modes and clears the screen.
ALT-C Writes the circular buffer to disk and closes any open send or
receive file(s). ZCOMM complains if no files were open.
SEE ALSO: close command
ALT-D Lists the current directory of the default disk.
SEE ALSO: dirr command
ALT-M Toggles keyboard mapping.
SEE ALSO: display mapkb command, N numeric parameter
ALT-R Enter the review function.
SEE ALSO: review command
(C) 1990 Omen Tech Inc Chapter 18 Function Key Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 145
ALT-S Displays status on the local screen only, even if ZCOMM is in
host operation.
SEE ALSO: s command
ALT-U Toggles 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. The u mode is reset by the call command.
SEE ALSO: u mode
ALT-W Writes the circular buffer to the receive file. Equivalent to
the main w command.
SEE ALSO: w command
F1...FA10 etc. The Soft Keys can be programmed (with "set" commands)
either to send a string of characters to the remote or to invoke a
ZCOMM command sequence. Iff the string begins with "@", the
remainder of the string is treated as a ZCOMM command. No strings
are sent to the remote from the command prompt or from the review
function.
The soft keys can be changed for each remote system or different
application programs, with set commands embedded in the appropriate
telephone directory entry. The ALT-K key displays the strings
assigned to these keys.
There are 48 soft keys, f1 to f12,fs1 to fs12,fc1 to fc12,fa1 to
fa12, plus some of the cursor keys. ( fs1 is obtained by Shift-F1.
fc1 is obtained by Ctrl-F1. fa1 is obtained by Alt-F1.) In
addition, the cursor keys may be reassigned to send strings to the
remote when in the term function. To list them, set the v (verbose)
parameter non zero ("pv1"), then give a "set" command. Most soft
keys have names beginning with f, and are described in Chapter 24.
18.3 Browse Command
BROwse pathspec browses through the specified files. If pathspec is
empty, all files are presented. For each matched pathname, the
filename, date, and length are displayed. The status line displays
some of the possible (one letter) commands.
EXAMPLE: >>>c:bro *.c
CFLOW.C 13:18:10 02-25-86 6072 ?
app, back, copy, Del, mv, next, page, sz, S, quit, {rR}ead, usq, view,
!, @
(C) 1990 Omen Tech Inc Chapter 18 Browse Command
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 146
a, A Prompts for a pathname and then appends the current file to it.
Both DOS and CP/M format files are handled correctly. The A choice
then deletes the file.
b Backs up to the previous file. Browse will not back up past a
deleted or renamed file.
c prompts for a target pathname. The resulting DOS command
copy file target is executed by a copy of COMMAND.COM. Target may
include the switches available with the DOS copy command. The
pathnames given must be legal for DOS, with \ separating directories
from filenames.[23]
EXAMPLE: c
Copy to: a:
SEE ALSO: "HINT" below
D Deletes the file.
SP, CR skip to the next file.
r, R The R subcommand first kills the circular buffer. Then read the
file (or as much as will fit) into the circular buffer, then call
the review function. The review function subcommands can be used to
page back and forth through the file, write portions of the buffer
to files, and so on. If review is exited with the file still open,
browse closes it. This subcommand is not available if Restricted.
SEE ALSO: review function
n Sends the file with the ZMODEM n option (send file only if the
source is newer than the destination).
S sends the selected file with XMODEM protocol. The user must start
an XMODEM receive on the other machine.
s sends the selected file with ZMODEM or YMODEM Protocol and 1kb
packets. If the other program has ZMODEM AutoDownload enabled (Z
mode) the file transmission will be automatic. Otherwise, the user
must start a YMODEM or ZMODEM receive on the other machine. The s
and S subcommands are useful when issued by a remote caller browsing
through files in a directory.
__________
23. Unless the DOS SWITCHAR has been changed to "/".
(C) 1990 Omen Tech Inc Chapter 18 Browse Command
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 147
t Tail reads the tail of the file into the circular buffer and
displays the last 24 lines.
Q, X Quit ends the file list. X is provided for the convenience of
users accustomed to the wash and sweep programs.
V, Ctrl-V View the file, whether it is a regular or SQueezed file.
! prompts for a DOS command and then attempts to execute it. Some DOS
commands that might be useful are rename, del, print, move, emacs,
mince, edlin, chkdsk, and chmod. When entering the DOS command, a
keyboarded % is replaced by the pathname of the currently selected
file.
Please refer to the ! command for details and caveats.
EXAMPLE: !emacs % calls EMACS to edit the selected file.
@ Prompts for a ZCOMM command, and then executes that command as if it
had been entered at the main command prompt. The @ subcommand
should not be used for any command that involves file names.
EXAMPLE: @display vt100
* Any other letter redisplays the file information and repeats the
prompt.
After the file list is exhausted, ZCOMM prints the free storage
remaining on the default disk.
HINT: Use a directory command to change the order in which the files
are presented for the browse command. For example, assume we have a
directory src on drive c: (hard disk) and a floppy drive F: with a
scratch disk inserted. The command sequence
dirt
f:
browse c:/src
displays each file in the src directory beginning with the newest.
Typing c tells ZCOMM you want to copy the file. When ZCOMM asks for
the filename, just hit <CR> and the file is copied. (The resulting
command to command.com is "COPY c:/src/file"). This sequence may be
used to "clean up" a directory.
18.4 DOS Gateway
A "Shell Escape" or "DOS Gateway" executes a DOS COMMAND (a program or
command) as a subroutine. If the first non white-space character of
the line is !, the entire line, less the !, is executed as a DOS
command, as if it were typed to DOS in the absence of ZCOMM. If the !
command is not the first command on the line, the command string must
(C) 1990 Omen Tech Inc Chapter 18 DOS Gateway
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 148
conform to ZCOMM's rules pertaining to strings. DOS Gateways are not
allowed if ZCOMM is RESTRICTED.
If the next character is % the rest of the command is processed for
string substitutions.
If DOS fails to execute COMMAND.COM, (actually, the program specified
in COMSPEC), the message Shell Escape DOS error return = N is
displayed. The usual DOS error returns are 1002,1005,1008,1010, and
1011, which are the DOS error return values + 1000:
2 File not found (COMMAND.COM)
5 Access Denied
8 Insufficient memory
10 Invalid environment
11 Invalid format
Return values less than 1000 are returned by the application but are
lost by current versions of COMMAND.COM. The return value is saved in
the ? numeric parameter and may be tested with the ? test condition.
EXAMPLE: !whereis thebeef.* Uses the public domain WHEREIS.COM program
to find certain files on the hard disk.
EXAMPLE: !dir >foo Generate a directory listing, with output
redirected by DOS to foo.
The command line keys !dir keys displays the soft keys, executes a DOS
"dir" command without arguments, and then displays the soft keys
again, while the command line !dir keys calls DOS to print directory
information for the file keys.
! commands are interpreted by DOS's COMMAND.COM; Batch files and
built-in commands may be invoked as well as programs. Some useful DOS
built-in commands are rename, copy, date, and time.
Caution should be exercised with commands that affect disk files if
ZCOMM has files open at the time. Programs that remain resident in
low memory (such as spoolers) should NOT be invoked from ZCOMM unless
they are already resident, as memory would become fragmented.
Invoking the DOS "print" command (if print isn't already resident) has
caused DOS to crash when ZCOMM exits.
Memory available for !command will be less than when the command is
given directly to DOS without ZCOMM running. The command "!chkdsk"
(C) 1990 Omen Tech Inc Chapter 18 DOS Gateway
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 149
will display the amount of memory available for subprograms.
NOTE: Some commands under some conditions may cause DOS to crash
immediately, after more commands are given, or when the user attempts
to return to DOS, especially if insufficient memory is available.
The EXEC functions of nonstandard operating systems are notorious
sources of interesting debugging experiences.
Before executing a ! command, ZCOMM restores the modem port's
Interrupt Service Routine's previous interrupt vector and interrupt
enable bits. ZCOMM also synchronizes the BIOS display driver. After
return from the DOS command, ZCOMM enables DTR, the ISR vector,
interrupts on the modem port, and resumes direct control of the
display.
If the command name begins with "%" (per cent sign) the remainder of
the command string is processed for string substitution (but not
character escapes).
EXAMPLE: set s0 this.txt
!%mv %s0 bakdir
If the command name (after an optional leading "%") begins with ~
(tilde), ZCOMM does NOT restore the modem port's Interrupt Service
Routine's previous interrupt vector and interrupt enable bits. The
called program may then access the modem with the ROM BIOS interrupt
hex 14, which is mapped to ZCOMM's modem service routines during the
execution of the !~ command.
When the modem is accessed this way, incoming characters are buffered
in ZCOMM's interrupt buffer, preventing loss of characters when
scrolling above 300 bits per second. Unlike the ROM BIOS routines
(which are a compromise to allow driving serial printers), the ZCOMM
int 14h handler does not depend on the state of DSR or CTS.
This interface allows other programs to perform specialized functions,
such as graphic screen operation or special CRT terminal emulation.
One such program is COMSH.EXE available on Compuserve's Programmers'
Special Interest Group (GO PCS-158).[24]
EXAMPLE: !~comsh
The ZCOMM BIOS EMULATOR replacing the int 14h modem service routine
accepts the standard BIOS INT 14h functions encoded in the AH register
__________
24. COMSH supports graphic images transmitted by Compuserve's Weather
Radar service.
(C) 1990 Omen Tech Inc Chapter 18 DOS Gateway
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 150
as described in the IBM Technical Reference Manual. Since the modem
port is selected by ZCOMM, the DX register is ignored. The character
ready status bit reflects whether ZCOMM's modem interrupt buffer has
one or more characters waiting.
The !~ command uses special logic to allow programs to exit gracefully
when carrier detect is lost.
(C) 1990 Omen Tech Inc Chapter 18 Protocol File Transfer OPTIONS
Comments
Post a Comment