ZCOMM User Manual
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 91
reasserted to allow the modem to originate or answer another
call.[5]
SEE ALSO: o, off commands
call [-N] [name][.path][,modifier] Prepare ZCOMM for a new task and
invoke an entry in the Phone Directory.
The 7, A, a, b, C, c, E, e, g, H, h, i, j, n, o, P, p, q, r, S, s,
t, u, v, w, X, x, Z, and z modes are reset. The d mode is set. The
e, f, g, k, m, p, q, t, w, Kermit 8, zmodem C, e, l, L, p, t, T, w,
and W parameters are reset to their default values. The search
patterns are erased. Permanent string parameters set with the set
_svar command are set to empty.
If path has been specified, it is searched for a line beginning with
name. Otherwise, ZCOMM searches the telephone directory. An
optional modifier (string with a leading comma), if specified, is
not used in the directory search.
If the search is successful, the entire directory entry name is
copied to the remote string parameter. The complete argument
entered on the command line is stored in the args string parameter
visible to the called script. If the script has a READ ONLY
attribute, ZCOMM is unrestricted during execution of the script.
ZCOMM then executes the commands on the rest of the line (if any),
and on succeeding lines beginning with a space or tab. If the v
numeric parameter is greater than zero, each command from the file
is displayed on the screen before it is executed.
It is not necessary to type the entire name as it appears in the
telephone directory, as ZCOMM will find the first entry that name is
a prefix of. Iff name is empty, execution begins with the first
line of path.
EXAMPLE: call cis1200
call cis1
call cis.C:/newscript
EXAMPLE: call genie,upl Invokes the genie telephone directory entry
with the modifier ,upl available to the called script.
______________________________________________________________________
4. The modem must be configured to use Data Terminal Ready (DTR).
5. Most dialing scripts include an initial bye command to make sure
any previous call is disconnected.
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 92
The call command is not limited to making connections. For example,
"call host" in the distribution PHODIR.t file conditions a Hayes
compatible modem to answer incoming calls silently, set parameters,
and activates ZCOMM's host operation.
Most directory entries include a telephone number to dial. If ZCOMM
is used with an autodial modem, the number of retries N (default
none) may be specified.
EXAMPLE: call -40 cbbs-r Attempts 40 retries before giving up.
The interval between retries is set by the i numeric parameter.
EXAMPLE: pi4 Sets the interval between retries to 4 seconds.
Words To the Wise: Abuse of the retry feature by continually calling
busy numbers may incur the wrath of the Telephone Company.
Especially with Message Unit Accounting, Big Brother may be watching
your telecommunications habits. Some long distance services (MCI,
Sprint, AT&T, etc.) charge for unsuccessful calls, especially if the
phone is allowed to ring (or ring busy) for more than a few seconds.
Consult your telephone company about legal limits to the number and
frequency of retries.
Since some computer services will disconnect within a short time if
no login is attempted, you should start communicating as soon as the
modems are connected. ZCOMM sounds the bell after making the
connection if retries have been specified.
The source, gosub and call commands may be nested with up to six
command/phones file descriptors open at once.[6] A label may be the
target of a call command provided the trailing colon is included in
name.
cat pathspec For Unix users, a synonym to the type command (q.v.).
cd [dir] Change to directory dir. If Restricted, dir is checked for a
parent directory ("cd .."), and absolute paths ("cd /src") not
prefixed by the home string parameter. Giving cd without an
argument changes to the directory stored in the home string
parameter.[7] ZCOMM then stores the current directory in the pwd
__________
6. Deep nesting may require a decrease in the circular buffer memory
allocation, see Chapter 15.
7. The home parameter is set to the current directory when ZCOMM is
invoked, but may be changed with the set command.
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 93
string parameter and displays it unless the v numeric parameter is
less than 0.
EXAMPLE: cd /tmp
N.B.: When operating restricted, the home string parameter must
point to a valid directory in order to enforce the intended
directory path restriction.
SEE ALSO: cdd and pwd commands, home and pwd string parameters
cd D:dir When a disk drive is specified with the cd command, the
current directory on that drive is changed but ZCOMM remains logged
in on the current drive and directory. If Restricted, dir is
checked for a disk drive ("cd b:/foo") not contained in the disks
string parameter.
EXAMPLE: cd D:/tmp
cdd D:dir Change to (log in to) disk D and then to directory dir on
the specified disk. If dir is not specified, the root directory is
assumed. ** This is a shorthand equivalent to a D: command followed
by a chdir dir command.
SEE ALSO: cd command
chat Enter the term function to chat keyboard to keyboard. Characters
typed by either keyboard are echoed to both ends, and RETURNS echo
as RETURN/LINEFEED. In Host Operation, chat exits if the caller
types Ctrl-Z.
Chat will become hostile if the other end also echoes characters.
(Try it sometime on a timesharing system; it's fun.)
close Writes the contents of the circular buffer iff a receive file is
open, then closes the receive and transmit files. ZCOMM complains
if no files were open.
SEE ALSO: nolog command
closerx Iff a receive file is open, writes the circular buffer then
closes the receive file.
SEE ALSO: nolog command
closetx Closes the transmit file, if it is open.
SEE ALSO: nolog command
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 94
cl Clears the screen.
cls Resets display modes and clears the screen.
CONFerence Enters the term function with a 1 line window for composing
commands and text. Chapter 21.5 gives details.
crc pathspec Print the CRC-32 and character count for the specified
files. The crc command verifies the identity of two (or more)
copies of a file. Iff the lengths and CRC-32's of two files are the
same, the files are almost certainly identical. Comparing files
with the crc command is faster than transmitting a second copy for
character by character comparisons.
EXAMPLE: "crc", "crc *.c"
HINT: To generate a file containing the CRC's of the files in the
current directory:
>crc.lst
crc *.*
close
After the files are copied, run the commands above (with a different
file name), then compare the two files with DIF.EXE to detect any
that have changed.
SEE ALSO: sum, wc commands
Source for a public domain Unix/DOS version of CRC is available.
create [-modes] outfile If a receive capture file is open as the
result of a create or t filename command, write the circular buffer
and close it. Then create outfile for use with the term function
with modes. The create command is especially useful when you don't
want to enter the term function immediately.
EXAMPLE: create -ys /tmp/cbbs.tmp[8]
SEE ALSO: > command
createx outfile Similar to the create command, but does not open
outfile if a file with the same pathname already exists. The
resulting error message may be suppressed by setting the v numeric
__________
8. The y mode overwrites any existing file with the same name. The s
mode strips most control characters from the resulting disk file.
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 95
parameter negative. Scripts may test for success with the r test
condition. The createx command may be used to manage semaphores to
lock resources or work entries used by multiple instances of a
program. The createx command is available on Unix and OS/2 flavors.
SEE ALSO: kill command
del pathspec Delete the specified files. No message is printed if one
or more of the specified files could not be deleted. No
confirmation is requested for mass deletes.
WARNING: As with all ZCOMM pathspec specifications, a directory name
expands to all files in that directory.
N.B.: Do not attempt to delete an open file on DOS, especially the
history file.
SEE ALSO: browse command
demand password Scripts must often verify a caller's identity by
asking for a password. The ZCOMM password command allows a caller
three chances to enter a given password. Failure results in
disconnection.
Password is processed for character escapes and string
substitutions. All security restrictions on string parameters are
enforced.
If the result is empty, no password is demanded. Otherwise the user
is prompted to enter a string matching password in the correct case.
Keyboard input is not echoed.
Three attempts to enter password are allowed. If the password is
not correctly entered, DTR is pulsed to force the modem to
disconnect the caller, and the ? numeric parameter is set negative.
EXAMPLE: demand %password Requires the caller to enter a string
matching the contents of the password string parameter.
dir pathspec Display pathnames matching pathspec alphabetized across
the page. Wildcard filename expansions are alphabetical.
EXAMPLE: dir
EXAMPLE: dir y*.c *.h
dirr pathspec Displays the directory with length and creation date of
each file. dirr displays the number of files matched, number of
blocks, number of kb in those files, and estimated transmission time
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 96
at the current transmission speed assuming the fastest protocol
available (ZMODEM or YMODEM-g). XMODEM and Kermit transfers take
longer than the displayed estimates. Wildcard filename expansions
are alphabetical.
dird pathspec Long Form directory, sorted by date.
dirt pathspec Long Form directory, reverse sorted by date.
dirl pathspec Long Form directory, sorted by file length.
dirs pathspec Long Form directory, reverse sorted by file length.
dirx pathspec Long Form directory, sorted by file extension.
DISable{-modes} Disable mode(s) affecting the term function. Chapter
20 describes modes affecting the term function.
EXAMPLE: dis -t Disables throttle (t mode).
display [[no]dismode] ... Without an argument, prints the display
modes. Display modes preceded by NO are turned off. With one or
more arguments, turn on the specified display mode(s). If an
argument is preceded by no, the specified display mode is turned
off.
If an emulation is specified, it must be the first argument.
display command argument changing the terminal emulation (vt100,
lsi-adm3a, 3101, dumb) disables nlmode and overstrike.
The display modes are:
vt100 Emulate DEC VT-100 and VT-102 display codes and most Teletype
5425 codes. VT-52 and Zenith H-19 codes are the default.
lsi-adm3a Emulate Lear Siegler ADM3a and Televideo 9xx control
codes.
dasher Emulate Data General Dasher terminals.
3101 Executes IBM 3101 and TI 940 escape codes.
wyse Emulate Wyse terminals in native mode, allow switching the
keyboard to keyscan mode.
dumb Only null, bs, tab, cr and lf are executed, all others
display. As in real life, dumb takes precedence over vt100,
vt52, and lsi-adm3a emulation.
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 97
inhibit Inhibits the display (nothing prints).
SEE ALSO: Q mode
nlmode Received newlines (linefeed) display as return/linefeed.
bell=visual Instead of sounding on the speaker, bell characters
cause flashing notes to appear on the screen.
overstrike Overstruck characters are displayed in bold face or
underline (reverse video on CGA) as appropriate.
autowrap The 81st character prints on a new line with possible
scrollup.
rautowrap Allow a backspace from the lest margin to reverse wrap to
the last character position on the previous line.
8bit Decode 8bit control characters and G1 character set.
stat=off Disables ZCOMM's status line.
warpdrive Provides higher display speed without scrolling flicker,
but causes noise (snow/chromablizzard) with CGA display
adapters.
mapkb Allow escape codes from the remote or a file to active
alternate keyboard mapping. The keyboard mapping is defined
with a series of mk commands, such as those contained in the
std.mk (standard keyboard) or 101.mk (101 key extended
keyboard) files. Other XXX.mk files may be provided; the
first few lines of these files indicate the keyboard
configuration they set up. ZCOMM comes initialized with the
std.mk mapping, which requires NumLock to be on.
EXAMPLE: source std.mk Defines a VT100 keyboard mapping for
standard PC and PC-AT keyboards.
The term function keyboard mapping enabled by the mapkb
command may override some ZCOMM functions.
A display nlmode nobell=visual Turns on nlmode display mode and
turns off the visual bell.
EXAMPLE: display vt100 Enables VT100/VT102 emulation used by many
computer systems.
SEE ALSO: tcs command
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 98
dump pathspec Dump the named files in a side by side hex/ASCII format,
similar to the CP/M users' group DUMP program. The ending character
number is also displayed. Zero length files are not displayed.
echo[c|f] string Echo a line containing a single argument string in
reverse video. Tabs should not be used with the echo command. The
echoc command also echoes its argument to the capture file (if
open), without reverse video. The echof command echoes its argument
to the capture file only.
EXAMPLE: echoc "File not Accepted" Outputs a line to the screen and
to the capture file.
EXAMPLE: echo "Dave, This conversation can serve no further
purpose." Displays a line on the screen only.
SEE ALSO: lput command, r numeric parameter, character escapes
egrep[m] regular-expression pathspec ** Display lines in the specified
files matching regular-expression. Regular Expressions are
discussed in Chapter 25.
The egrepm command finds a line matching regular-expression in each
of the specified files, and then pages through the file beginning
with the matched line. At the end of each screen, ZCOMM accepts the
same subcommands used with the findm command.
EXAMPLE: egrep "^Subject:" *.* Displays all lines that begin with
"Subject:".
SEE ALSO: findmore command
The egrep implementation does not strip the trailing CR/LF from
lines read from the disk. This affects use of the $ regular
expression magic character. When using the $ magic character, the
CR/LF at the end of normal lines must be represented as "..$".
egrepq regular-expression pathspec ** Silently searches the specified
files for the first line matching regular-expression. Upon a
successful search, the contents of this line are stored in the z0
string variable and the ? numeric parameter is incremented. The
egrepq command is useful for fetching password information from a
disk file.
SEE ALSO: obey command, findq command
else Execute the command(s) on the rest of the line if the last if
test performed on the current script level was false.
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 99
N.B.: While else statements in programming languages are connected
to a particular if statement according to syntax, the connection in
ZCOMM is to the last if statement executed on the level, regardless
of goto's.
ENAble {-modes} Enable mode(s) affecting the term function. Chapter
20 describes modes affecting the term function.
EXAMPLE: ena -h Enables half-duplex (local echo) Half-duplex mode
causes the term function to display keyboarded characters.
estimate length [speed] Use the specified length and optional
specified effective speed when displaying information for the next
receive file. A length of 0 bypasses the length substitution. Once
a speed (in effective bits per second) is given, it is used for all
locally displayed transmission time calculations until the next
speed or port command.
EXAMPLE: estimate z2 Uses the file length stored in string variable
z2 in calculating the transmission time estimate for the next
received file.
EXAMPLE: speed 19200; estimate 0 2400 Use an effective transmission
speed of 2400 for transmission time estimates instead of the 19200
bps interface speed.
exit [code] Exit to the operating system with optional code.
SEE ALSO: x, o, off commands
EXPand sourcefile pathspec ** For each pathname in pathspec, execute
the commands in sourcefile with the string parameter item set to the
current pathname. The commands in sourcefile must not themselves
contain wildcards (* or ?) or directory pathnames. If no files
match pathspec, sourcefile is not executed. If the script executed
has a READ ONLY attribute, ZCOMM is unrestricted during execution of
the script.
EXAMPLE: expand plxupl 001* Executes the script plxupl once for each
file matching the wild card specification 001*.
EXAMPLE: expand a *.arc where the file a contains:
obey "!pkxarc -v %item >> arclist"
lists the contents of all .arc files to arclist.
Chapter 99 explains the use of this command in more detail.
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 100
f [-modes] file The f (think of "file") command initiates transmission
of file with the term function. One or more term function modes
(described in Chapter 20) may be enabled with the optional modes
flag.
If q (TWX) mode is enabled, transmission pauses until the called
system's answerback restarts it with an XON, or until g mode is set.
Otherwise, any XOFF induced transmission pause is reset.
Once the file has been opened with the f command, a pattern match or
keyboarding F1 or ALT-X will exit the term function with file
incompletely transmitted. The rest of the file may be transmitted
by the t, F2, or wait commands.
EXAMPLE: f -px message Uploads message paced by the p mode, which
sends a carriage return and pauses at the end of each transmitted
line until the remote responds with the prompt character (default
line feed). The x mode makes the term function return to the script
after the file has been transmitted.
EXAMPLE: set eolstr "\r."; pp1000; pg58; f -p file Is useful for
uploading a prepared message to a CompuServe bulletin boards using
the "SIG" editor (not FILGE). The eolstr setting sends a carriage
return and period after each line to prevent the CompuServe software
from reformatting the message. Pp10000 Sets the pause timeout to a
long time. Pg58 Sets the prompt character to ":". f -p file
Transmits the file.
SEE ALSO: b, g, p, r, n, t, w, x, X modes, eolstr string parameter,
t and wait commands
fail Terminate the current expand command, otherwise return from the
current script level with failure status.
If called directly by another level of script, that level is
terminated.
The fail command also causes the term function to exit, to allow a
function key to be programmed with a macro that exits the term
function.
If called implicitly by a number presented for dialing, fail
terminates the current dialing attempt. If no retries are left, the
call is abandoned.
fg Indicates ZCOMM is running in the foreground with a user at the
keyboard.
SEE ALSO: bg command, df test condition
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 101
fget outfile * Gets 8 bit raw data from the modem to outfile without
any protocol. No data is displayed on the screen. Keyboarding F1
terminates recording; any other keyboarded character is sent to the
remote. Iff the g numeric parameter is set to to some value other
than its default of 10 (line feed), the fget command terminates upon
reading and storing a character matching the g numeric parameter.
The fget command also terminates recording on loss of carrier detect
signal.
This command can be used when the flow of data from the remote
cannot be regulated. The maximum rate attainable without loss of
data is limited by the maximum interrupt latency of the operating
system and active device drivers. The time required to write a 512
character buffer to disk may also limit the maximum average data
rate. Each 512 character block must be written before the modem
interrupt input buffer overflows with new data. If the startup time
for a floppy disk is excessive, better results will be obtained
writing to a hard disk or ramdisk[9] if a suitable device is
available. Tests with an IBM Personal Computer, DOS 2.1, and a
Maynard Electronics hard disk suggest that no characters are lost at
9600 baud. (Your results will vary depending on your configuration
and programming habits. California estimates lower.)
EXAMPLE: fget rawdata
find string pathspec Find and display lines containing matches to
string in the specified files. Lower case characters in string
match either case; upper case characters in string match upper case
characters only. If string contains spaces, tabs, or semicolon, it
must be enclosed by double quote characters. ZCOMM C style escapes
may be used to represent control characters and string parameters to
be searched for. Assuming normal DOS files (with CR/LF at the end
of each line), a \n at the beginning of string forces a match to the
beginning of a line. A \r at the end of string (\n if the file(s)
have no returns in them) forces a match at the end of the line.
The file name being searched and its length are displayed in the
status line. For each line that contains a match to string, the
file name (if more than one file), line number, and the text of the
line are displayed.
EXAMPLE: find count *.c Finds all occurrences of count or COUNT in
the named files.
__________
9. See comments on Extended Memory ramdisks in Chapter 33.
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 102
SEE ALSO: egrep command
FINDMore string pathspec Findmore finds a line matching string in each
of the specified files, and then pages through the file beginning
with the matched line. Otherwise, it is similar to the find
command. When the screen is filled up, the prompt More? appears.
Typing space displays another screenfull. Typing n skips to the
next instance of string that has not yet been displayed. Typing ^Q
or ^S displays one more character from the file. Typing ^X skips to
the next file.
SEE ALSO: egrepm, page commands
findq string pathspec Silently searches the specified files for the
first line matching string. The processing of string is identical
to the find command described above. Upon a successful search, the
contents of this line are stored in the z0 string variable and the ?
numeric parameter is incremented. The findq command is useful for
fetching password information from a disk file.
SEE ALSO: egrepq command
finish Terminates Kermit server operation on the remote system.
fput file * Puts data from file to the remote at maximum speed without
any protocol. After each 512 characters, the number of characters
transmitted is displayed in the status line, and the keyboard is
polled. Any key will abort the transfer. This is the fastest way
ZCOMM can transmit characters to the modem, with possible peak
speeds greater than 19kb. This command is useful for testing RS232
peripherals at high peak rates such as 56 kilobaud.
EXAMPLE: fput datafile
fpute file * Echoplex transmit a file to the remote, waiting for the
correct echo to each character transmitted (for Throttle/10
seconds). The echoed character is sent to the CRT screen. If fpute
receives a space as an echo to a tab, fpute waits for the spaces to
stop echoing for at least 100 milliseconds before resuming
transmission. Transfer speed thus suffers when tabs are present in
the transmitted file unless the remote can be set to echo tabs as
tab characters instead of expanding them to spaces. Throughput is
less than 1/3 of normal because of the echo delay.
Fpute counts each time the correct character is not echoed as an
error.
With n mode, fpute transmits only a linefeed at the end of each
line. With r mode, fpute transmits only a carriage return at the
end of each line. Most applications would use one of these modes.
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 103
CPMEOF (Ctrl-Z) terminates the file transmission unless b mode is
set.
Because fpute waits for the correct echo to each character sent,
fpute should be used for transmitting characters to programs that
echo exactly.
Often it is easy to write a simple receive routine to synchronize
with the sender by echoing each character received. On some
microcomputer systems, the device "TTY:" does just that. Fpute is
especially useful for "spoon feeding" files to the serial inputs of
microcomputers and minicomputers.
SEE ALSO: f command
get filespec Instructs a remote Kermit server to the transmit the
specified file(s), then receives them. The form of filespec varies
with the remote system; it must be quoted if it contains any special
characters or spaces. The get command only operates with a Kermit
server; use kermit rb to receive files from a regular Kermit
program.
goback label Search the current script file for label: and execute
commands starting at that line. The goback command begins the
search at the beginning of the file. It is faster than the goto
command which begins the search at the current line.
SEE ALSO: goto command
gosub name[.path] Call a script as a subroutine. The phone directory
is searched for name unless another file is specified with .path.
Gosub has the same action as the call command (q.v.), but does not
reset modes, disconnect the modem, or modify the remote parameter.
EXAMPLE: gosub dosig Executes the dosig entry in the telephone
directory.
EXAMPLE: gosub .%lib/baud.t Executes the commands in c:/yam/baud.t
assuming the lib string parameter contains c:/yam.
SEE ALSO: call command
goto label Search the current script file for label: and execute
commands starting at that line. A label begins at the first column
and ends with a colon (:). Iff label precedes the current script
line, the goback command will locate the target label more quickly.
The goto command is valid only within a script or telephone
directory entry. Please refer to Chapter 99 for examples using the
pattern, if, goto, and source commands.
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 104
grab svar Grab reads a line from the currently open transmit file into
the specified string parameter svar. Unless b mode is on, all
characters starting with the first CR and/or LF are discarded. Grab
inhibits transmission of the open file until g mode is explicitly
set by a command.
On end of file the transmit file is closed and the string parameter
is set empty. End of file can be tested with the t test condition.
SEE ALSO: putv command
HAndshake {off|sw|on|cts|dsr|dcd|both|slow} Some modems and printers
cannot accept continuous full speed data. These devices send
control characters (XOFF and XON) for flow control, or generate a
hardware flow control signal on the CTS, DSR, or DCD pin. The
Handshake command controls the modem port hardware handshake
(default sw).[10]
If hardware handshaking is selected, an ON to OFF transition on the
specified line pauses transmission, and an XON character will not
override the hardware restraint.
After a timeout set by the S numeric parameter (default 60 seconds),
or if characters are in the keyboard input buffer, a warning message
is displayed, the restraint is released, and characters are sent.
As a special case, handshake on obeys output flow control with the
CTS input signal, asserts input flow control with the RTS output
signal, and disables the transmission of XOFF characters when the
modem input buffer becomes nearly full.
Some computers do not support concurrent disk and serial I/O at high
speeds. The handshake slow command drops the RTS signal to the
modem during disk writes when receiving files with YMODEM-g or
ZMODEM.
The command handshake both allows either CTS or XOFF to pause
output, in addition to asserting input flow control with the RTS
output.
The handshake dcd command enables d mode (q.v.). Subsequently,
selecting a different type of handshaking will disable d mode.
__________
10. ZCOMM automatically disables its software (XON/XOFF) flow control
when using XMODEM, YMODEM and similar protocols that require all
256 byte codes. These protocols will not work if the modem is set
for software flow control.
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 105
The "handshake off" command disables all flow control except for the
term function.
The handshake command releases flow control (allows data to flow if
it had been stopped by handshaking).
Changing the communications port with the port or portx command
disables hardware handshaking.
SEE ALSO: S numeric parameter
EXAMPLE: handshake cts Turns on CTS handshaking.
help The help command uses the helpfile or xhelpfile string parameter
depending on whether ZCOMM is in host operation. Normally, the help
command displays a command summary, pausing every 24 lines.
If the string parameter begins with the character @, ZCOMM uses the
rest of the parameter as the initial command to access a pop-up help
program. The contents of the f string parameter are added to this
command, separated by a space. Thus, if helpfile contains "@yhp
/umanh.hlp", giving the help command from the main prompt executes
the DOS command "yhp /umanh.hlp main".
If the called program leaves a file yamhelp.tmp containing script
commands in the current directory, ZCOMM executes this file with a
source command and then deletes it.
SEE ALSO: f, helpfile, xhelpfile string parameters, source command
history [histfile] Opens histfile for use as a dual 64 entry history
file for commands entered both at the ZCOMM command prompt and
online with the term function. Histfile is a random access file
used as a pair of circular buffers to save commands for recall.
Only a file created by a previous history command may be used with
the history command. If the specified histfile does not exist, it
is created. Histfile stores commands with T or more characters
where T is the value of the T numeric parameter.
If histfile is not specified with the history command, the current
history file is updated and closed.
The history command may be given with a different file name whenever
desired to access useful commands saved from previous sessions with
a particular host or application.
When history is enabled, the Up and Down function keys scroll
through previously entered commands. Ctrl-P and Ctrl-N may be used
in place of Up and Down respectively. An old command so selected
may be edited with editing keys described in Chapter 17 and executed
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 106
with the <ENTER> key.
In the term function, the history accessed with the Up and Down keys
is displayed and edited in the status line. [11] A Ctrl-X clears the
recalled text and restores normal status line and keyboard
operation.
EXAMPLE: history /tmp/favbbs.hist
SEE ALSO: r command, T numeric parameter
N.B.: Do not give the history command before you have entered any
secret passwords from the keyboard as these will be saved in the
history file. The history command without an argument closes the
history file and disables command recall. Alternatively, the T
numeric parameter may be set to a large value to inhibit storing of
passwords in histfile.
Normally, histfile should be an absolute pathname to insure that the
same file will be used regardless of the directory from which ZCOMM
is called from.
The history command is not available when Restricted.
N.B.: Do not attempt to delete an open file on DOS, especially the
history file.
host The host command conditions ZCOMM to accept incoming calls
unattended. Host operation is described in Chapter 27. The EXIT
key F1 terminates Host Operation.
N.B.: The host command is normally given only by a script that sets
parameters to their appropriate values. Use the "host" entry in the
distributed PHODIR.t file as a prototype for your application.
SEE ALSO: remote command
if condition command ... The if command provides powerful condition
testing for scripts. If executes the command(s) on the rest of the
line if condition is true. Otherwise, execution continues
immediately with the next script line. Chapter 26 describes the
testable conditions.
SEE ALSO: else, on commands
ife condition cmd1 ...; cmd2 ... Execute cmd1 ... if condition is
true; otherwise skip to the first semicolon in the rest of the line
__________
11. Unix/Xenix flavors only support Backspace editing in this mode.
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 107
and resume execution (unconditionally) with cmd2. Iff a semicolon
is not present, execution resumes at the end of the line, useful
within the body of a while command.
EXAMPLE: set f5
@ife %s1 echo "s1 =%s1"; else echo "s1 not set"
(Without the "else", the right half will always execute.)
kbdlock N * Controls acceptance of keyboarded characters by the term
function and during protocol file transfers. If N is non zero, the
term function does not act upon key strokes. If N is greater than
1, key strokes have no effect on protocol transfers. The Ctrl-Break
key and the command prompt reset kbdlock to 0. If N is 257, the
Ctrl-Break key does not reset Kbdlock. Kbdlock does not affect the
k test condition or the accept command. Characters typed while
kbdlock is on will become available at the next command prompt,
accept command, or when kbdlock is reset unless typeahead is purged
with the purgek command.
SEE ALSO: purgek command, Ctrl-Break key
kbdmon [file] captures keystrokes to file. If file exists, it is
appended to. Function keys are denoted by an 0xFF character
followed by the code returned by the BIOS. The kbdmon command
without an argument closes the file. This command is not available
when Restricted.
kermit By itself, selects Kermit or Kermit related parameters for use
by the !!, p, rb, and sb commands.
Kermit rb [-options] Kermit rb receives files using the Kermit file
transfer protocol. Chapter 19 describes the available options.
File names are given by the sending program. The Kermit programs
must have compatible parity settings as described in Chapter 12,
Kermit Protocol.
Kermit rb receives files from a regular Kermit program; use the get
command to receive files from a Kermit server.
EXAMPLE: kermit pi1; kermit rb Downloads files from an IBM
mainframe.
ZCOMM's term function will sense the remote Kermit's parity setting
and download files without user intervention When the remote Kermit
starts sending, if K (Kermit autodownload) mode is enabled (the
default).
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 108
Kermit sb [-options] pathspec Kermit sb sends the specified files to
either a regular Kermit program or a Kermit server. Chapter 19
describes the available options. The Kermit programs must have
compatible parity settings as described in Chapter 12, Kermit
Protocol.
EXAMPLE: kermit pi1; kermit sb file ... Sends the specified files
to an IBM mainframe.
keys, ALT-K Keys displays the definitions the user has assigned to the
function keys.
ki Clears the y0...y127 string parameters and causes circular buffer
writing operations to ignore data from the remote which has already
been displayed. This data is still available to the review
function.
EXAMPLE: The script fragment
pat 1c "///BEGIN///" "@ki create -+ print.fil"
pat 2c "///END///" "@close"
wait -f30000
will capture the data that arrives between "///BEGIN///" and the end
of the string "///END///". Other data from the remote will not be
captured to disk. The long pattern match fail time (30000 seconds)
makes the the cycle repeat almost indefinitely.
SEE ALSO: W mode
kill Erases (flushes) all data stored in the circular buffer and
restores the buffer pointers to their initial positions.
kill [-signum] procnum Available on Unix and OS/2 flavors, this form
of the kill command supports interprocess communications. If signum
is absent, the kill command checks for the existence of the
specified process, but does not send it a signal. Success sets the
? numeric parameter to 0, otherwise -1.
SEE ALSO: createx command, Unix kill(1)
l, ll, ls, lx For Unix users, synonyms for the dir commands.
learn lfile TurboLearn(TM) Script Writer records timing information
and term function keystrokes to lfile. The TurboLearn program
tlearn.exe then generates a script using this data. Normally,
learning is initiated after the connection has been established, but
before the first prompt is received from the remote. This is best
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 109
accomplished with the F4 key, which activates the tlearn telephone
directory entry.
Function keys, cursor keys, reassigned keys, and scripts[12] should
not be used while learning.
When accepting passwords and other sensitive information, systems
sometimes acknowledge each keyboard character with #, *, x, or X,
instead of the keyboarded character itself. When this happens, do
not type characters faster than the remote responds to them.
The resulting script should be examined for evidence of keyboarding
mistakes, line noise, and dependence on prompts that change each
time you access the system.
The comments below apply when the tlearn script is not used.
EXAMPLE: kill
123-4567; learn lfile
From the ZCOMM main command prompt, enter the desired phone number.
When ZCOMM connects, the learn command enters the term function with
learning (recording) turned on.
<keyboard the operations you wish recorded>
Login to the bulletin board as usual. If you make keyboarding
mistakes, you can edit the script file later.
ALT-C F1
Terminate learning with ALT-C, and return to the main command prompt
with the F1 key.
!tlearn lfile >newscript
From the main command prompt, execute the TurboLearn program tlearn
with a DOS Gateway.
After recording, the tlearn program reads lfile and generates a
series of pattern and put script commands to let ZCOMM search for
the prompts and respond with the proper keystrokes. The resulting
script file newscript may be accessed with the source command.
__________
12. Other than the dialing script
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 110
Alternatively, the last command above may be replaced with
!tlearn -d newdirname lfile >>phones.t
to add the new script to the end of your telephone directory.
The -d dirname causes tlearn to prepend the given new directory
entry name newdirname and the telephone number to the resulting
script commands. The redirection characters >> add the script
commands to the end of your telephone directory.
You can also use the -d newdirname option to tlearn to prepare a new
directory entry in a separate file. Then you can edit this file and
add it somewhere within your telephone directory.
The tlearn program also accepts a -r option to suppress a "return"
command normally emitted at the end of the generated script. This
tlearn option allows one to append an "off" command to the generated
script.
link * Link two serial ports. The link command allows remote access
to a computer or other device connected to another port. For
example, if port 1 is connected to an autoanswer modem and port 2 is
connected to a local timesharing machine, the link command would
allow dial-up callers access to the timesharing machine. Chapter
18.5 describes the link command.
list pathspec The list command uses standard DOS character output
routines and any installed CRT device driver instead of ZCOMM's own
CRT driver. The printer can be enabled with ^P given to DOS (not
ZCOMM). List the specified file(s).
This command closes any open transmit file. ZCOMM detects SQueezed
files and prints them in ASCII.* List pauses/resumes printing with
^S. Keyboarding ^C cancels, and ^X skips to the next file (it might
take a few whacks of the keyboard to get ZCOMM to hear it.) The list
command defaults to a type command when ZCOMM is in host operation.
EXAMPLE: list *.cq
SEE ALSO: browse, type, page commands
lput string Displays string on the console display. String is
processed for character escapes. Lput is useful for scripts sending
cursor control codes to the screen. Control characters and escape
sequences used with the lput command are always decoded with ZCOMM's
default extended VT52/Z19 emulation, which also recognizes ANSI "ESC
[" sequences, regardless of which display emulation is selected.
Unlike the echo command, lput does not display in reverse video and
does not add a carriage return/linefeed to its argument.
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 111
SEE ALSO: echo command
lputp string Outputs string to the line printer. String is processed
for character escapes. Strings with embedded nulls (represented
with the \000 character escape) may be used. The lput command
should not be used if the printer is jammed, out of paper, or off
line. These conditions may be tested with the l test condition.
This command is not allowed when ZCOMM is Restricted.
EXAMPLE: if l lputp "\E\017" If the printer is ready, ZCOMM sends
ESC SI to select compressed printing on an IBM 80 CPS printer.
SEE ALSO: l numeric parameter, l test condition, \dNNN (decimal)
character escapes
menu Execute script commands from the file name stored in the string
parameter menu.
message The message command allows a caller to keyboard a message
which will be appended to a file specified by the string parameter
messages. The message command allows the caller to type in up to 64
lines of text. A blank line terminates the message. This command
is intended for short messages; long messages should be uploaded
with a file transfer protocol. Keyboarding is controlled by the Z
numeric parameter, which sets the hot zone column after which a
keyboarded space character begins a new line.
mk [scancode shiftstate class string] Assign term function keyboard
mapping. Without an argument, mk resets and disables keyboard
mapping. The mk command is described in Chapter 28.
SEE ALSO: N numeric parameter, _ command
more pathspec See page command.
mput string The mput command transmits string to the remote at full
speed. String is processed for character escapes. Unlike the put
and putw commands, mput does not display characters coming from the
remote (they are held in the interrupt buffer). Control and other
special characters may be entered with character escapes. If a
carriage return should be sent, it must be explicitly coded with \r
at the end of the string.
SEE ALSO: put, putw commands
nolog * Suppress generation of the next log entry (of any kind).
EXAMPLE: mysys nolog speed 1200 123-4567 t
Suppresses the log entry that would otherwise be made if the calllog
string parameter is set.
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 112
nulls n When accessing ZCOMM in host operation, nulls sets the number
of nulls (default 0) sent after each linefeed to allow slow
terminals time to scroll.
EXAMPLE: nulls 4
o Terminates a data call by dropping DTR (Data Terminal Ready). DOS
ZCOMM drops Clear To Send (CTS) as well as DTR if hardware flow
control was selected with the handshake command. A bye or speed n
command must be given to reassert DTR before making or answering
another data call.[13] The o command does not release ownership of
the serial port.
SEE ALSO: speed, bye, off, port commands
obey string Sometimes one wishes to execute the contents of a string
parameter as a ZCOMM command. Other times one needs to reference a
pathname stored in a string parameter in the context of a command
that does not itself perform string substitution on its argument(s).
Obey executes string as a ZCOMM command. Character escapes in
string are substituted before execution.
EXAMPLE: obey ">>%s0" Redirects the output of utility commands to
the pathname stored in string parameter s0.
EXAMPLE: pat 19c "OBEY-LAST" "@obey %y2" Sets pattern 19 to execute
the previous line received from the remote when the string "OBEY-
LAST" is received.
N.B.: The remainder of the line after the obey command will be
executed unless execution of string is terminated by a return or
fail command. The construction obey "if xxx goto foo" May be used
only if no commands follow the obey command's string argument.
N.B.: Backslashes in file names used with the obey command must be
escaped.
N.B.: When the obey command is used to substitute file names, file
names containing separator or operator characters such as & may
change the syntax of the resulting command. For instance, the
pathological but legal DOS filename foo&&999.bar would cause obey if
f%thisfile gosub dofile to expand to if ffoo&&999.bar gosub dofile
to parse as a test for a match to an illegal pattern 999.
__________
13. Most telephone directory entries include a speed command.
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 113
off Disable the modem by dropping DTR (Data Terminal Ready), [14]
release ownership of the serial port, and exit to the operating
system. DOS ZCOMM drops Clear To Send (CTS) as well as DTR if
hardware flow control was selected with the handshake command.
Exit status is the value of the ? numeric parameter.
The next program must select the port and initialize it to reassert
DTR before making or answering another data call.
SEE ALSO: bye, x, o, port commands
on [condition rest-of-line] * Executes rest-of-line if condition is
true. Condition is tested after each command line executes, unless
a return or fail command is executed, or when pattern is the last
command on the line. An on command without predicate (on a line by
itself) cancels the on command active at that script level.
EXAMPLE: on
The term function may be accessed with the wait command and no
patterns active to force an exit on loss of carrier detect or
pattern search timeout. Otherwise, ZCOMM could remain in term
function until a command is keyboarded. Typical commands to use
with the on statement are goto, return, off, and abort. Chapter 26
describes the testable conditions.
One active on statement is available for each level of script. The
on statement does not propagate to succeeding script levels.
When rest-of-line is executed, the on statement at that level is
cancelled. An on command cancels any previous on command at that
script level.
EXAMPLE: on !c goto fooend Branches to fooend if the carrier drops
out.
SEE ALSO: wait, if commands
NB: No other commands may be on the line after the on command except
for its predicate.
open [-modes] file Opens file for transmission with the term function
with modes. The open command should be used when you don't want to
enter the term function immediately, or are already in it. In other
situations, it may be necessary to open the file before dialing to
__________
14. The modem must be configured to use Data Terminal Ready (DTR).
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 114
allow transmission immediately after connection, without the delay
of opening the file from a floppy disk.
SEE ALSO: seek, read, close commands
page pathspec Type the file(s) specified in pathspec a screenfull at a
time. When the screen is filled up, the More? prompt appears.
Typing space displays another screenfull. Typing ^X skips to the
next file. Typing ^K or ^C terminates the command. This command
closes any open transmit file. ZCOMM automatically detects SQueezed
files and prints them in ASCII.*
EXAMPLE: page *.doc
SEE ALSO: browse, type, list, findmore commands
PATtern [n[cilpv$] string [action]] (n = 0...24) The pattern command
allows ZCOMM to search for up to 25 different responses from a
remote computer, and take action based on which of those responses
(or none) was "seen". A pattern match can execute specified script
command(s) "on the fly" (c modifier) or return control to the
calling script with an indication of which pattern was matched.
The pattern command causes the next t, f, or wait command (term
function) to search for string in the data received from the
remote/modem. String must be entered exactly as it will be received
from the modem, in the same case and with the same embedded spaces
or tabs. Control characters must be represented with ZCOMM
character escapes. The metacharacter \256 matches any single
character. ZCOMM %string substitutions may be used to define search
patterns. If the % character is to be searched for, it must be
represented as \045.
Parity, NULL, RUBOUT, XON, and XOFF characters received from the
remote do not affect pattern searches. If Kermit AutoDownload (K
mode) is set, strings with SOH (Ctrl-A) cannot be matched. If
ZMODEM AutoDownload (Z mode) is set, strings with CAN (Ctrl-Z)
cannot be matched. If B protocol (c mode) is set, strings with DLE
or ENQ cannot be matched.
Strings of up to 33 characters each may be specified for
simultaneous search by the term function. The search patterns are
"global" among all script levels; a pattern command in a subroutine
affects the patterns set by the calling script(s) and vice versa.
The term function returns when one of the patterns is matched or
when the term function times out with f seconds with no characters
from the remote, as determined by the f numeric parameter, or when
carrier detect is lost. The first wait, t or f command given after
the pattern command begins the search.
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 115
When one of the patterns is matched, that pattern is marked as found
and its corresponding action is executed (if present). ZCOMM will
remain in the term function until there is a pause in data
transmission from the remote[15] unless the i or c modifier is used.
The following modifiers may be used. The c, i, and l modifiers are
mutually exclusive.
c The pattern is marked as found and action executed (if
present). The term function then continues searching.
Matching this pattern does not cause a return from the term
function. The condition for this pattern will test true, but
the n test condition is not affected.
i (Immediate) The pattern is marked as found and action executed (if
present). The term function then returns immediately.
l (line end delay) The pattern is marked as found and action
executed (if present). The term function then returns after
the first LF character following the matched string.
p (permanent) A pattern with the p modifier is not reset by the
pattern command without arguments. Patterns with the p
modifier may be used to search for disconnect messages within
an entire script. Permanent patterns are reset by the call
command, each item in the outcall queue, and an explicit
pattern command referencing that particular pattern number.
EXAMPLE: pattern 20 "\nCLR" "@off" Disconnects and exits ZCOMM
if the phrase CLR is seen immediately following an LF.
v (verbose) The v modifier displays a message when the pattern is
matched. This is often useful when debugging scripts when the
large amount of output generated by large v numeric parameter
values is not desired.
EXAMPLE: pat 5v "Finished Already."
$ Sometimes the only way to recognize a prompt (as distinct from
the same string embedded in other data) is to require the
prompt to be the last thing sent by the remote, before a
pause. The $ modifier allows string to be matched only if the
remote pauses for 1 to 2 seconds after transmitting the last
__________
15. Pause length is specified by the q numeric parameter.
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 116
character in string.
The optional action is a string to be sent to the remote, or
executed as a command if it begins with "@". Action is executed the
instant the last character of the pattern is matched, even if the i
modifier is not used. Action must not use the goto, f, t, or wait
commands.
The pattern command without any arguments clears the patterns that
don't have the p modifier, and terminates pattern searching. The
other events that terminate pattern search are a match to a pattern
that does not have the c modifier, a pattern search timeout, the
call, abort, or quit commands, a major error, or the NUKE key.
EXAMPLE: pat 0c$ "" "\21"
Sends one XON character every time there is a pause in output from
the remote. This recovers from situations where the remote computer
stops because it receiveed a spurious XOFF character, or lost an XON
character.
In the pattern n string command, if string contains a repeating
sequence such as foo in foofoobar, the search may be unsuccessful if
part of the phrase is received immediately prior to the desired
string (foofoofoobar).
port n Change the modem port to COMn. On DOS, the legal values for n
are 1...18.
Selecting a new port normally selects software handshaking
("handshake sw"). The PCDOS flavor enables both hardware and
software handshaking ("handshake both") iff the port speed exceeds
2400 bps and the Clear To Send (CTS) signal is active at the time
the port command is given.
Standard Ports (PCDOS):
COM1 3F8 IRQ4 (Standard IBM)
COM2 2F8 IRQ3 (Standard IBM)
NON STANDARD PORTS:
COM3 3E8 IRQ4 (Alternate)
COM4 2E8 IRQ3 (Alternate)
COM5 2B8 IRQ3 (Columbia)
COM6 2B8 IRQ2 (Alternate for IBM)
COM7 2E8 IRQ5 (Alternate "COM3")
COM8 3E8 IRQ5 (Alternate "COM4")
COM9 Uses the port address and interrupt vector previously set by
the portx command.
COM11-COM18 IBM PS/2 COM1-COM8 ports
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 117
COM1 and COM2 are the standard serial ports defined by the IBM
Technical Reference Manual.
COM3 and COM4 are supported by many serial cards and modem boards.
COM3 and COM1 share the same dedicated hardware interrupt line, and
these ports may not be used at the same time. Likewise, COM4 and
COM2 may not be used at the same time.
Columbia computers support COM5.
COM6 to COM8 are alternate configurations that may be accessed by
cross jumpering between printer port decoders and serial port
enables on some multifunction boards.
COM7 and COM8 support alternative definitions for "COM3" and "COM4"
respectively.
COM11 to COM18 correspond to "COM1" to "COM8" on IBM PS/2 computers.
Only one of COM12-COM18 may be used at a time unless using the
special OS/2 comm driver for that board.
Since ZCOMM uses the interrupt line on the selected port, no other
program or device driver may use the same port address and/or
interrupt vector concurrently. Certain disk controllers and mice
interfaces use IRQ2 and IRQ5. Do not use IRQ2 on a PC-AT (the extra
8259 is not reset). IRQ5 is sometimes used by network cards and
printer ports. Do not select COM3 to COM18 unless you are familiar
with the I/O addresses and interrupt vectors used in your machine.
Ports sharing the same interrupt vector (IRQ number) cannot be used
concurrently.
The port command sets the d mode (which suppress the No Carrier
Detect message).
EXAMPLE: port 2
DOS ZCOMM begins with COM1 unless overidden by the DPORT environment
variable.
EXAMPLE: C>set DPORT=2
On Unix, the argument of the port command is a character special
file in the /dev directory. Unix and Xenix flavors have no default
port. If the DPORT environment variable is set, that port will be
selected when ZCOMM initializes. Otherwise, a port is selected by
the startup and/or dialing script. Typical values are tty01
(386/ix) and tty2A (Xenix).
EXAMPLE: DPORT=tty1A; export DPORT
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 118
SEE ALSO: handshake command, dport string parameter
portx hbase,irq * To support specialized multiport serial interfaces,
the portx command selects a communications port with a specified
hexadecimal base address hbase and Interrupt Request Line irq (3 <=
irq <= 7). The portx does not check its argument for validity. The
consequences of an invalid selection are quite undefined. The
specified base address and IRQ number are assigned to COM9, where
they may be used by the port command and the x numeric parameter.
The status line and s command will indicate COM9. This command not
available on X.PC, Unix, Xenix, or OS/2.
EXAMPLE: portx 3f8,4 Selects a comm port with a base address of 3f8,
using IRQ4.
SEE ALSO: intolink string parameter
private The private command allows a caller to keyboard a message
which will be appended to a file specified by the private string
parameter. The private command allows the caller to type in up to
64 lines of text. A blank line terminates the message. This
command is intended for short messages; long messages should be
uploaded with a file transfer protocol. Keyboarding is controlled
by the Z numeric parameter, which sets the hot zone column after
which a keyboarded space character begins a new line.
purgek Purge any characters the user may have typed ahead.*
purgel Purge any unprocessed characters received from the modem Line
(remote).*
put string The put command transmits string to the remote. Use the
put command for transmittting commands to a modem or a remote
computer system. String is processed for character escapes.
Control and other special characters may be entered with character
escapes described in Chapter 25. If a carriage return should be
sent, it must be explicitly coded with \r at the end of the string.
EXAMPLE: put "myname\r" Sends myname followed by carriage return to
the modem.
A \336 (octal 336) character causes a pause in transmission
(duration controlled by the p numeric parameter). This pause allows
one string to contain multiple commands.
EXAMPLE: put "\336ATZ\r\336\336ATX1 M0 S0=1\r" Pauses, sends ATZ\r,
pauses (twice because some modems take longer to reset!), and then
sends ATX1 etc. to the modem.
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 119
Transmission with put is controlled by the 7, 8, h, p, w, and t
modes.
SEE ALSO: putw, mput, putv commands
putw string The putw command transmits string to the remote, and
pauses for a period of time (determined by the q numeric parameter)
before returning from the term function to allow characters to echo.
Other than that final pause, putw operates the same as the put
command.
N.B.: Putw should not be used when the next operation will be a
pattern or wait command. If the expected response starts before the
putw command finishes, the following wait command will never get to
"see" what it is waiting for. In general, the putw command should
only be used as a short-cut for sending a command when the response
is known in advance and can be safely ignored.
SEE ALSO: put, mput commands
putv svar The putv command transmits svar to the remote without any
translation of character escapes. Putv does not append a carriage
return or line feed to the transmitted string.
EXAMPLE: putv s0; put "\r"
SEE ALSO: put, mput commands
pwd Print Working Directory displays the current directory pathname,
and stores it in the pwd string parameter.
EXAMPLE: pwd
SEE ALSO: cd command
pxN Set Numeric parameter x to value N. If x and N are blank, display
the numeric parameters which can be set by this command and their
current values. This command is not allowed if Restricted. Numeric
parameters are described in Chapter 23.
EXAMPLE: ps8 Sets the status line attribute to 8 (grey), suitable
for composite video displays.
EXAMPLE: pv-1 Sets the v numeric parameter ("verbose") to -1,
suppressing some routine messages. More negative values suppress
more routine messages.
EXAMPLE: pd1 Sets the d numeric parameter to 1, causing files
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 120
received with ZMODEM or full YMODEM protocol to be stored with the
modification date transmitted with the file.
EXAMPLE: pk3 Sets the k numeric parameter to 3, which kills pending
output stored in the circulat buffer when ETX (Ctrl-C) (decimal 3)
is keyboarded in the term function.
queue { add [string] | clear | delete [n] | list | run } Manipulate
and execute a queue of commands for dialing numbers or other
suitable functions. The queue contains 20 slots numbered 0 to 19.
queue clear clears all queue entries.
queue add [string] adds string to the queue after processing for
string substitutions. The string is added to the first empty
queue slot available. If string is absent, it is taken from
the next script line. A typical string would be a command to
call a system: call telegodzilla
Script entries used with the circular dialing queue should end
with a t command, which will enter the term function. To stop
the queue at that point, use the ALT-N (NUKE) key. NUKE
queue delete [n] Delete then nth queue entry, or the currently
executing entry if n is not present.
queue list lists the non empty queue entries.
queue run begins execution of the queue entries. The ALT-N (NUKE)
key, a fatal errror or any keyboarded character present after
the execution of the command in the entry terminates the queue
run command.
The queue commands are independant of the Outcall Queue available in
Host Operation.
EXAMPLE: The script fragment:
queue clear
while q set? s0 Q queue add "echo %s0"
queue list
Sets each queue entry to echo its own queue number, then lists the
queue entries.
SEE ALSO: q and Q test conditions, Shift-F5 and Shift-F6 function
keys
quit * Causes an immediate return to the command prompt from any
script level. Quit may be used within a command string assigned to
(C) 1990 Omen Tech Inc Chapter 18 Main Commands
Comments
Post a Comment