ZCOMM User Manual
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 181
message, NOW Compuserve asks you for a certain random 8 digit
account number to mail it to!) No sweat, just hit some PgUp's
until you see the account number on the screen. Now you can't
remember whether or not you typed a space after the last part of
you command to the remote. No problem, just exit review with x
and you'll see just where you were.
NOTE: This subcommand should not be used when scripts are active.
k Kill the capture buffer contents and return to the previous
function.
Ctrl-Z, Ctrl-PgDn Kill the rest of the buffer by setting the character
insertion pointer to just after the end of the current display.
ZCOMM then redisplays the last lines of the buffer and returns to
the previous function.
t Set the cut pointers to the top of displayed text, and sets the
bottom cut pointer to the end of the buffer. The t subcommand is
used with the b subcommand to specify which portion of the
circular buffer should be written to a file with the w
subcommand. (Text between the top and bottom pointers is
highlighted.)
b Set the bottom pointer to the beginning of the first line of
displayed text. If the top pointer had not been previously set,
or if the bottom pointer is before the top pointer, ZCOMM will
ring the bell and ignore the subcommand. Otherwise, the text on
the screen that was highlighted will now be displayed in normal
intensity as what is showing on the screen has just been
deselected. (Text between the top and bottom pointers is
highlighted.)
w, W Write (paste) the text between the top and bottom pointers to a
disk file or DOS device.[2] If the top pointer is not set, a
reminder is printed. ZCOMM prompts for a pathname. A blank file
name implies the modem.[3] If the bottom pointer is not set, the
rest of the buffer will be written. No log entry is made by this
subcommand. The W subcommand automatically appends the paste
data to an existing file. A directory for past files may be
specified with the DIRPX environment variable and/or the dirpx
__________
2. Useful DOS devices are PRN, LPT1, LPT2, and LPT3.
3. Data is sent to the modem at full speed with the current parity.
Normally, line feeds are not sent. With n mode, line feeds are
sent and carriage returns are suppressed. With b mode, data is
sent the way it was received.
(C) 1990 Omen Tech Inc Chapter 22 Review Function
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 182
string parameter.
q, F1, ALT-X Quit, return to previous function.
! Prompts for a DOS command, then attempts to execute it (DOS
Gateway).
@ Prompts for a ZCOMM command, then executes it.
(C) 1990 Omen Tech Inc Chapter 22 Numeric Parameters
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 183
23. NUMERIC PARAMETERS
Numeric parameters are set with the p command in the form px# where x
is the one letter name of the parameter and "#" is the numeric value.
Numbers may have an optional leading "-" (minus) sign. Numbers are
normally decimal, but hex numbers may be input as 0xHH, printing ASCII
character values may be entered as 0cC, and control characters may be
represented as 0^C.
Value Possible entries
65 65 0x41 0cA
3 3 0x3 0^C
Typing "p" without a parameter name displays the current values of the
numeric parameters in decimal.
EXAMPLE: pS5 sets the timeout interval in seconds waiting for XON
characters or positive flow control. to decimal 5 seconds.
EXAMPLE: pv-1 sets the v numeric parameter to -1, suppressing some
routine messages
# The # numeric parameter sets the number of lines used by the built
in display driver. The default value is 24. A value of 25 may be
used for applications which require access to all 25 display lines.
A small value may be used when running ZCOMM under TopView to fit
the information into a small window. The cls or reset command
should be given after setting the parameters to initialize the
screen driver to the new values. If running with a virtual screen
with TopView or DESQview, the # and $ numeric parameters are
limited to 24 by 80 maximum. Full screen applications may give
abnormal displays if these parameters are set too small.
Nonsensical values tend to produce nonsensical displays.
EXAMPLE: cls; p#9; reset clears the screen, sets a 9 line window,
and initializes the screen driver to the new value.
$ Sets the number of CRT columns. A cls or reset command should be
given after changing the $ numeric parameter. The default value
(80) is that returned by the BIOS video interrupt 15h call. This
parameter may be set to support 132 column displays if the 132
column display mode is set before ZCOMM is called.[1] ZCOMM does
__________
1. With most display BIOS ROMs, ZCOMM reads the columns and lines
values from the BIOS when starting up or regaining control after a
(C) 1990 Omen Tech Inc Chapter 23 Numeric Parameters
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 184
not support displays less than 80 columns wide. The display
hardware must use the same number of columns as the $ parameter if
the resultant presentation is to make any sense.
SEE ALSO: # and V numeric parameters
- If non zero, the DOS Gateway (used with the ! command, etc.) uses
the undocumented DOS 37h function to fetch the current value of
SWITCHAR.
If negative, ZCOMM uses DOS line input (function 0xA) for commands
given from the main prompt. This enables DOS command line editors
such as POLYboost [2] and CED. When these editors are active, they
(and not ZCOMM) interpret control, function and ALT- keys.
* Sets the CRT attribute for highlighted messages.
EXAMPLE: p*12 gives bright red.
Adding 1024 to this parameter forces ANSI SGR 1 to use this color.
? Count of the number of files sent or received with a protocol, and
the number of lines matched by the find command. A failed password
validation sets this negative. The exit status of subprograms is
stored in this parameter. Because of a bug in DOS COMMAND.COM, the
return value is valid only with Unix/Xenix flavors.
SEE ALSO: ? test condition
@ Sets the CRT attribute for the (normally) blinking messages such as
FILES OPEN. The numeric values are explained below, with the n
numeric parameter.
EXAMPLE: p@12 makes ZCOMM's normally blinking messages appear
bright red.
Adding 1024 to this parameter forces ANSI SGR 5 and 6 to use this
color.
If set non zero (the default), causes a drop of DTR, equivalent to a
bye command each time a telephone number is dialed as a command.
B If set non zero (the default), causes a bye command to be issued
each time a telephone number is executed as a command.
______________________________________________________________________
DOS Gateway.
2. POLYboost is a product of the POLYTRON corporation.
(C) 1990 Omen Tech Inc Chapter 23 Numeric Parameters
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 185
SEE ALSO: mcommand string parameter, number dialing commands
C If non zero, only display C ESC sequences per screen in the Review
Function, and count escape sequences when advancing or backing up
in the review buffer. Otherwise, ESC sequences are not counted.
E If non 0, substitute this for characters with bad parity detected
by the term function with e mode (Error Containment(TM)).
EXAMPLE: ena -7e; pE63 Substitute ? for characters received with
odd parity.
F Sets the CRT attribute for dim (faint) messages such as ANSI SGR2.
EXAMPLE: pF8 gives gray.
H In Host Operation, sets the timeout in seconds for entering a
command or string in response to a command or other prompt,
including the accept command. A value of 0 (the default) disables
this timeout.
K If non 0, executes keyboard BIOS calls to recover extended codes
from 101 key keyboards.
N When enabled with display mapkb, this parameter controls the
relationship between ANSI/VT52 Alternate Keypad mode (DECKPAM,
ESC=), ANSI Numeric Keypad mode (DECKPNM, ESC>), and the PC's
keyboard Num-Lock state.
0 causes ZCOMM to set the PC's keyboard Num_Lock state to match
Numeric Keypad mode when DECKPNM or DECKPAM is received.
32 causes ZCOMM to set the PC's keyboard Num_Lock state to the
opposite of Numeric Keypad mode when DECKPNM or DECKPAM is
received.
1 causes ZCOMM to set the PC's keyboard Num_Lock on in response to
either DECKPNM or DECKPAM.
2 causes ZCOMM to set the PC's keyboard Num_Lock off in response
to either DECKPNM or DECKPAM.
SEE ALSO: display, mk and ALT-M commands
O Controls OverThruster(TM) operation with XMODEM, XMODEM-1k, YMODEM,
and YMODEM-1k downloads. This parameter should be set as follows:
CompuServe XMODEM This OverThruster mode is known to be effective
on CompuServe. Negative numbers control the number of bytes
(C) 1990 Omen Tech Inc Chapter 23 Numeric Parameters
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 186
added to the window on XMODEM downloads from the network.
Larger numbers increase throughput, but cause improperly
interfaced MNP modems and network nodes to drop characters
under stress, disrupting the file transfer.
EXAMPLE: pO-512; ro file1.ext
Other XMODEM Positive numbers up to a system dependent value less
than the protocol block size increase throughput. Larger
values induce timeouts and/or retransmitted blocks. The
optimum value must be determined by experiment. If you see
the message: Retry 0: Received dup Sector very often, the
value should be reduced. 60 usually give best results with
MNP modems at 2400 bps. The optimum value varies depending on
the remote computer, modem(s), system traffic, and the network
node.
EXAMPLE: pO60; ro file1.ext
R If non zero, remove incomplete files received with a protocol
except those received with the + option (default 0).
S Timeout interval in seconds waiting for XON characters or positive
flow control (default 15). If an XON is not received within this
time, transmission resumes anyway. A value of 0 disables this
timeout.
T If Command Reentry has been enabled with the history command, the T
parameter prevents commands with fewer than T characters from being
stored in the history file. Excluding short and easy to type
commands from the history file makes it easier to find the commands
that are difficult to keyboard.
Setting T to a large number disables the storage of commands and
strings. This may be used to exclude passwords and other sensitive
information from the history file.
SEE ALSO: history command
V VIDEO BIOS display mode to switch the display to 132 columns in
response to a VT-100 DECCOLM mode set command. To support boards
using an extended code in the bl register, calculate N = bl + (256
* al).
A popular value is 35 for the Tseng, ATI, and other extended EGA
boards. The Genoa Super EGA Hi-Res likes 96. The Everex EVGA uses
28684. The default value of 0 inhibits this function.
(C) 1990 Omen Tech Inc Chapter 23 Numeric Parameters
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 187
W This numeric parameter supports Video7 and similar boards which
require a non 0 value in the AH register on INT 10h bios calls for
setting video modes (e.g., 132 columns). The value of the W
numeric parameter (default 0) is placed in the AH register when
attempting to switch video modes.
X On Unix flavors, preset to +1 if the XTERM environment variable
contains xterm, preset to -1 if the variable contains the string
401 indicating a Tektronix storage tube graphics terminal,
otherwise remains at 0. Positive values allow the term function to
use the X Windows xterm status line. Negative values inhibit
status line updates while Tek graphics are active.
Z Hot zone column used for keyboard entry with the message and
privatecommands. A space character keyboarded within the hot zone
finishes the line.
a The a parameter calibrates certain XMODEM and YMODEM protocol
timeouts. The default value is set during initialization to an
appropriate value for an IBM Personal Computer, PC-jr, DG/One, or
8mHz PC-AT (2000 for 4.77 mHz PC, 4000 for a PS2/30, 6000 for an 8
mHz AT, 12000 for a PS2/80). If ZCOMM is run on a non standard
machine, accelerator, or under a time slicing operating environment
such as TopView, these timeouts may be recalibrated with the a
numeric parameter. Larger numbers give longer timeouts. This
parameter should then be set with a pa# command in the telephone
directory setup entry. The value for this parameter will change if
ZCOMM is used with a different computer type or multitasking
operating system.
b Sets the video color for the screen border. The mapping of b
parameter values to color is hardware dependent. New values of the
b parameter take effect with the next screen clear.
c The c parameter sets the callout interval in seconds between scans
for outgoing messages. The default is 300 seconds (five minutes).
EXAMPLE: pc600 sets the interval between callout queue scans to 10
minutes.
SEE ALSO: Callout queue
d A non zero value (the default) causes incoming files received with
ZMODEM and full YMODEM Batch protocol to have their Date set to
that sent in the file header. ZMODEM's file management features
depend on the transmission of each file's modification date. Files
between two copies of ZCOMM will have the same creation date, even
if the two machines are in different time zones. When transferring
files to/from a Unix system, creation dates are interpreted
according to GMT or Universal Coordinated Time. File dating should
(C) 1990 Omen Tech Inc Chapter 23 Numeric Parameters
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 188
be enabled with a pd1 command in the telephone directory setup
entry.
SEE ALSO: z numeric parameter, ZONE environment variable
NOTE: Backdating file creation times may confuse some backup
programs.
e Indicates the number of errors, failed file transfers and the
number of characters received by the term function with parity
error, framing error or overrun.
EXAMPLE: if e>30 goto badline
If the term function increments the error count to 0[3] (from a
negative number), and E mode is set, the term function exits. This
allows the script to regain control in the event of a noisy line.
This condition is indicated by the e test condition being false
(0).
EXAMPLE: pe-20; ... wait; if !e goto badline
This parameter is reset to 0 by the call command.
SEE ALSO: e numeric parameter, E mode
SEE ALSO: e test condition (if, while commands)
f Fail time. Sets the default timeout in seconds for matching a
pattern. This timeout is reset whenever a character is received
from the remote. Timeout is suspended whenever a XOFF (DC3 or
Control-S) is keyboarded, and resumed when XON (DC1 or Control-Q)
is keyboarded. The f parameter value may be overridden for one
command by the ftime mode.
EXAMPLE: pf15 sets a default 15 second inactivity timeout for
pattern searches.
g Set the "gochar" (decimal). (See the ASCII/Decimal conversion
table in Chapter 36). The g parameter is reset to its default
(linefeed, 10) by the call command. (See documentation on the p
mode.)
__________
3. Refer to E mode description for caveats.
(C) 1990 Omen Tech Inc Chapter 23 Numeric Parameters
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 189
Some remote systems accept uploads with a ? (decimal 63) prompt for
each line. Optimum operation with such a system might call for
pg63 pp1000 pt4 f -tp file1
The pg63 sets the goahead character to question mark. The pp1000
sets the timeout to a long delay (10 seconds). The pt4 sets the
upload throttle to 40 milliseconds per characters, a speed which
allows the remote to echo somewhat slowly (assuming no tabs).
Finally, the command f -tp file sends file1 with Throttle and wait
for Prompt at end of line.
As a special case, if the "gochar" is set to 17 (called XON, DC1,
or ^Q) before the p mode is set, file transmission is stopped until
an XON is keyboarded or received from the remote.
EXAMPLE: pg17; ena -p
h Iff the h numeric parameter is set non zero, the h (Half Duplex)
mode causes characters transmitted by the term function to be
stored in the circular buffer as if they had been received from the
remote. This allows the review function to display them. Since
the echoed characters appear to have come from the remote, scripts
may be affected, especially pattern searches.
EXAMPLE: ph1; ena -h
i Set the interval between retries to n seconds.
EXAMPLE: pi4; call -200 busysys attack dials up to 201 times at 4
second intervals.
SEE ALSO: call -n command
j Sets the maximum connect time in seconds allowed restricted callers
in host operation. The default value of 0 does not restrict
connect time.
EXAMPLE: pj300 disconnects restricted callers at the first command
prompt after 5 minutes' connect time.
k When receiving data from the remote at high speeds (9600 or
faster), the display may fall behind data from the remote. Under
these conditions, keyboarding an interrupt character (often Ctrl-C,
or Break) will immediately stop the output from the remote, but the
display will continue to scroll for some time while the data in the
circular buffer is displayed. If this is objectionable, the k
(C) 1990 Omen Tech Inc Chapter 23 Numeric Parameters
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 190
parameter may be set to the remote's particular interrupt character
(in decimal). This parameter also affects the link command. When
this character is keyboarded, undisplayed data pending in the
circular buffer is skipped over. (This data is still available to
the review command. The call command resets this parameter to -1,
disabling its function.
EXAMPLE: Many DEC systems use ETX (Ctrl-C) to interrupt programs.
Many Unix users also use ETX for interrupting programs. The
command pk3 causes ZCOMM to skip buffered output from the remote.
Unix users using the default interrupt character of RUBOUT may give
the command pk127
l Selects LPTn for term function output when the l mode is set. In
addition, adding 8 to the number allows terminal emulation escape
codes to select "printer controller mode" iff the printer is ready
at the time. Adding 16 to the number allows "printer controller
mode" to be selected even if the printer is not ready at the time.
Default is 1 (LPT1).
EXAMPLE: pl2 selects LPT2.
EXAMPLE: pl9 selects LPT1 and allows the remote application to
enable "printer controller mode".
m Causes file transmission with the f file command to pause when a
character matching the decimal value is read from the file. That
character is NOT transmitted. When the file uploading is paused, a
keyboarded Ctrl-Q will resume transmission. The call command
resets the m parameter to -1 (which matches nothing).
EXAMPLE: pm12 Causes file uploading to pause on FormFeed (FF).
n Set the normal display attribute. The default of 7 gives a normal
white on black display. The numbers associated with the s, r, and
n are stored in the attribute byte of each character position
written in the corresponding mode.
The bit configuration (color display) is: Blink R G B Intensity R
G B with the leftmost the most significant.
Users with color monitors often use 2 (green) to avoid color
fringes caused by misconverged color monitors.
NOTE: the actual writing color attribute is not changed until the
next time the display is reset. Some attributes generate
unreadable displays. Other attributes generate text that can only
be seen on some monitors.
(C) 1990 Omen Tech Inc Chapter 23 Numeric Parameters
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 191
EXAMPLE: pn3 sets cyan; pn2 sets green.
o Iff non zero, allows overlap of file writing and incoming data from
the remote. This increases throughput when receiving files with B,
Extended Quick B, XMODEM, and YMODEM Batch protocols. ZCOMM sets
this to 1 on startup unless a PC-jr is detected.
p Pause sets the echo wait period (in hundredths of seconds) used
with the pattern command and the w and p modes. Larger numbers
give longer pauses. The default works well with most micro based
bulletin board systems. The p parameter is reset to its default of
70 (700 milliseconds approximately) by the call command.
SEE ALSO: p mode
q Sets the "gopause". When sending a file with a wait for "gochar" (
p mode), ZCOMM waits Gopause hundredths of seconds AFTER it
receives the "gochar". The q parameter also controls the time
delay after a normal pattern match or putw command.
The q parameter is reset to its default of 70 (700 milliseconds
approximately) by the call command. The default value allows time
for immediate echoes to be displayed and for the Hayes
SmartModem(TM) to respond to most commands.
SEE ALSO: p mode
r Set the attribute for "reverse video".
EXAMPLE: pr97 sets "reverse video" to blue on yellow.
Adding 1024 to this parameter forces ANSI SGR 7 to use this color.
SEE ALSO: n numeric parameter
s Set the attribute of the status line display (default 7, for
white). A value of 8 (grey) may be chosen to prevent the status
line display from distracting from the information being printed.
The low intensity grey also minimizes phosphor burn. Some other
possibilities are 2 for green, and 1 for blue (or underlined on the
monochrome board).
SEE ALSO: n numeric parameter
t Sets the throttle speed (delay between characters in hundredths of
seconds) used by the term function when uploading files with an f
-t file command. The default value of 4 corresponds to about 20
characters per second sending speed when t mode is enabled. Larger
numbers give slower transmission. The effective resolution of the
t parameter is limited by the timekeeping resolution of the
(C) 1990 Omen Tech Inc Chapter 23 Numeric Parameters
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 192
operating system; on PC-DOS the resolution is about 18 per second.
A negative value (-1 to -32767) may be used to specify a software
timing loop, with more negative values giving slower transmission.
The speed effect of a negative t value depends on the processor
speed and operating environment.
The t parameter is reset to its default by the call command.
SEE ALSO: t mode
u Sets the video attribute used to represent underline.
EXAMPLE: pu14 sets "underline" to yellow.
Adding 1024 to this parameter forces ANSI SGR 3 or 4 to use this
color.
SEE ALSO: n numeric parameter
v Sets the verbose level (default 0). A value less than zero
inhibits some routine messages. A value greater then zero causes
the set command to list all string parameters, including empty
string parameters. The screen erase after data calls in host
operation is disabled. Values greater than 1 display script
commands as they are fetched from the script file.* Larger values
give more detailed tracing information. A value of 50+ causes data
read by the read command to be displayed and acted upon by the term
function (when called) as if it had arrived from the remote.
NOTE: A v parameter value greater than zero affects scripts that
generate files with the > command.
w Controls the block length used by the CompuServe B Protocol. A
longer length increases throughput, but may overload some networks,
resulting in excessive retransmissions or failed transfers. With
the new Extended Quick-B protocol, the maximum block length is 1024
data bytes. A value of 0 (the default) allows the Compuserve
computer to control the block length, up to 1024 with Extended
Quick-B.
A negative value controls the upload block length but still allows
Compuserve to control the download block length (1024 with Extended
Quick B).
Uploads to Compuserve using longer block lengths are especially
sensitive to poor flow control, especially when error correcting
modems (MNP, etc.) are used. If B protocol uploads fail or require
excessive retransmissions, correct the flow control arrangements,
disable the modem's error correction, or try a smaller upload block
size.
(C) 1990 Omen Tech Inc Chapter 23 Numeric Parameters
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 193
The data contents of successfully transferred file(s) are not
affected by this parameter.
x Sets the port number linked with the link command.
SEE ALSO: link command, y numeric parameter
y Sets the transmission speed used by the linked port.
SEE ALSO: link command, x numeric parameter
z Set the timeZone in minutes behind GMT (Greenwich Mean Time).
EXAMPLE: pz300 sets timezone 300 minutes behind GMT for EST.
EXAMPLE: pz480 sets timezone 480 minutes behind GMT for PST.
SEE ALSO: d numeric parameter, ZONE environment variable
_ The _ numeric parameter controls the action taken by ZCOMM when a
fatal error (one that generates the "ZCOMM: Error..." message).
Any non zero value causes DTR to be dropped (disconnect the modem).
A value greater than 100 causes ZCOMM to exit to the operating
system. The NUKE key does not invoke this processing.
EXAMPLE: p_101
23.1 Kermit Numeric Parameters
The Super-Kermit parameters control Kermit protocol transfers. They
are set with the kermit px# command. Their current values may be
displayed with a kermit p command. These parameters rarely need
changing for most systems. They can be changed in case of difficulty
with Kermit transfers, especially with mainframe programs or obscure
microcomputer Kermit impelementations.
Certain of these parameters require character values expressed in
decimal. The ASCII code chart in Chapter 36 gives the decimal value
of all ASCII characters.
When transferring files with Kermit programs operating on IBM
mainframes with half duplex front ends, the kermit i parameter should
be set to 1, and the kermit s parameter set to the longest response
time expected, perhaps 45 seconds.
EXAMPLE: kermit pi1; kermit ps45
(C) 1990 Omen Tech Inc Chapter 23 Numeric Parameters
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 194
SEE ALSO: Kermit protocol in Chapter 12
7 If non zero, force seven bit line transmission with eighth bit
quoting Kermit transmission even if ZCOMM is otherwise using eight
bits no parity. This parameter is reset by the call command.
8 If non zero, force 8 bit transparent Kermit transmission even if
ZCOMM is otherwise using seven bit line transmission. Normally, the
Kermit file transfer commands use 7 bit line transmission and
attempt to negotiate 8th bit quoting if one of the 7 bit modes (7e,
7o, 7m, 7s) is used. This parameter is reset by the call command.
a Incoming packet-start character, default 1 (SOH).
A Outgoing packet-start character, default 1 (SOH).
b Block check type requested: 1=1 byte checksum, 2=2 byte checksum,
3=3 byte CRC-16 (default). Selecting a type 1 checksum instead of
type 3 will increase throughput by 2-4 percent[4] at the expense of
weaker error checking. The probability of undetected errors when
using Kermit in checksum mode instead of CRC-16 increases
dramatically with noisy lines and longer packets.
c Control prefix in incoming data, default 35 (pound sign).
C Control prefix in outgoing data, default 35 (pound sign).
d Delay in seconds before initial sending, default 0.
e Incoming end of line character, default 13 (CR).
E Outgoing end of line character, default 13 (CR).
i Use IBM line turnaround, default 0 (don't use IBM line turnaround).
The Kermit x numeric parameter sets the turnaround character. This
may be necessary when communicating with IBM mainframes with half
duplex front ends.
l Maximum outgoing packet length, default 1000, 1000 maximum. A value
greater than 94 implies Kermit long packets. The receiving program
may force shorter packets.
L Maximum incoming packet length, default 1000, 1000 maximum. A value
greater than 94 implies Kermit long packets. This sets a limit; the
sending program may use shorter packets.
__________
4. for 96 byte packets
(C) 1990 Omen Tech Inc Chapter 23 Numeric Parameters
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 195
p Sets the number of padding characters (default 0) to send before and
after each transmitted packet.
SEE ALSO: kermit y numeric parameter
r If non zero, remove incomplete files received with a protocol except
those received with the + option (default 0).
s Timeout interval in seconds waiting for XON characters or positive
flow control (default 15). If an XON is not received within this
time, transmission resumes anyway. A value of 0 disables this
timeout.
t Override timeout interval in seconds for incoming packets. The
default of 0 allows the other program to specifiy the timeout.
T Timeout interval for outgoing packets, default 4 seconds.
v Eighth bit quoting character, default 38 (ampersand). Sliding
Window size in Kermit packets, 1 minimum, 31 maximum, 15 default.
Setting w to zero disables the sliding window.
x IBM turnaround character, default 17 (XON).
y Pad character to send, default 0 (NUL).
SEE ALSO: kermit p numeric parameter
23.2 X/Y/ZMODEM Numeric Parameters
These parameters control XMODEM, YMODEM, and ZMODEM protocol
transfers. They are set with the z px# command available with ZMODEM
flavors of ZCOMM. Their current values can be displayed with a z p
command. These parameters rarely need changing in normal
environments.
b If non zero, ZMODEM sends a break when it is sending a file and
receives a retransmission request. This mode of operation may be
used with high speed modems to clear unwanted characters from the
modem's buffer during error recovery. Usually, the modem must be
given a configuration command to set the proper action to take when
receiving a break signal.
B Sets the duration of the break signal in tenths of a second, default
2 (200 milliseconds).
c Enables Cybernetic Data Recovery(TM) on XMODEM and YMODEM transfers.
Setting this parameter to 0 accommodates programs with non standard
XMODEM/YMODEM protocols and slightly quickens file transfers. The
default value of 1 provides optimum reliability for XMODEM and
YMODEM transfers with programs that meet the XMODEM/YMODEM spec.
(C) 1990 Omen Tech Inc Chapter 23 Numeric Parameters
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 196
Setting this parameter to -1 disables the quick file compare
provided by the r option.
C Sets the number of times ZMODEM will attempt to send a command (as a
result of a zcommand command) (default 11).
d Sets a delay time in tenths of seconds that the sz command will wait
for a ZMODEM packet in response to the rz<ENTER> string it sends to
the remote before sending a ZMODEM packet. This facilitates
automatic ZMODEM uploads to VMS, which interrupts programs with the
Ctrl-X character. The call command resets this parameter to its
default of 1. Higher values increase the startup time when the
receiving ZMODEM program is started before the sender.
e If non zero, escape all control characters. This allows ZMODEM
transfers to operate over data PBX and other systems that freak out
when they receive control characters.
f Flow control mask, only used with Unix/Xenix systems. Setting this
to 0 (the default) disables hardware (RTS/CTS) flow control for
Xenix/Unix systems with broken hardware flow control. On Xenix/Unix
systems where only CTS flow control works properly, set this to 8192
to allow CTS flow control only.
F Sets the pause after each data subpacket sent with the sz command
when the F option is used, or when failing flow control is detected.
The default value of 1 causes a one tenth second delay.
SEE ALSO: F option On some Unix operating systems the pause will be
rounded up to the next second or two.
l Normally, the ZMODEM "packet length" ("block length") is the file
length. Setting this parameter non zero forces ZMODEM to close a
frame and wait for an ACK after each # bytes (default 0). This
makes ZMODEM behave like XMODEM, YMODEM, or JMODEM, which wait after
each block/packet for an acknowledgement before going on to the next
block. The packet length may be adjusted to prevent buffer overflow
in data PBX systems. The call command resets this parameter to 0.
L (Default 0) If non zero, overrides the nominal length of data
subpackets within each ZMODEM frame. A smaller value speeds error
recovery on noisy lines, a large value (maximum 1024) reduces the
overhead of CRC characters. The call command resets this parameter
to 0.
Please note that streaming ZMODEM has no direct equivalent to
XMODEM/YMODEM/JMODEM block length unless the zmodem l parameter is
set non zero. In the absence of errors, ZMODEM normally sends the
entire file without pause. If somebody claims ZMODEM's 1024 byte
subpacket length is slowing things down by more than one half per
cent, he doesn't understand ZMODEM and should be ignored.
(C) 1990 Omen Tech Inc Chapter 23 Numeric Parameters
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 197
n Sets the number of NULLS (default 0) sent before each ZDATA frame.
Some buffered modems (Fastcomm) have a firmware bug which loses
characters when changing the direction of transmission. This causes
data frames to fail with a CRC or other error. ZMODEM n parameter
values in the range of 100 to 150 have obviated this syndrome.
P When set to 2 (the default), purge the transmit buffer and force a
receiver response when a CR/LF sequence (indicating a PC-Pursuit
DATA LOSS message) is detected. A value of 1 does not purge the
transmit buffer. A value of 0 disables special processing of CR/LF
sequences received by the sending ZMODEM.
w If non 0, restrict the ZMODEM transmit window to the specified
number of bytes. Setting this parameter to N requests
acknowledgements from the receiver every N/4 characters. ZCOMM then
waits for acknowledgements from the receiver whenever it has sent N
more characters than it has received acknowledgements for. This
parameter is useful with networks with defective flow control, and
with networks that store an excessive number of characters in
transit. The call command resets this parameter to 0.
W Adjusts the number of characters the ZMODEM receiver will silently
ignore when searching for the beginning of a new frame. This may be
set larger to accomodate networks with excessive in transit storage,
smaller to speed error recovery from long error bursts on direct
connections. The call command resets this parameter to the default
(1400).
Z Number of minutes (default 0) to adjust the file modification date
when using the Telink or Clink/SEAlink file transfer protocol to
transfer a file between different time zones.
The timeout parameters below may be set lower for faster X/YMODEM
error recovery when transferring files between two micros, higher to
accomodate extremely sluggish systems. Only in pathological cases is
it necessary to modify these parameters. The call command resets
these parameter to their defaults.
p Timeout in tenths of seconds for gaps within a packet (default 100).
r If non zero, remove incomplete files received with a protocol except
those received with the + option (default 0).
R When non 0, limits the number of bytes of file comparision used with
the sz and rz -rr option. This parameter may be set to a value
between 2048 and 32000 (1 billion on 32 bit systems). This
parameter is given to the receiving program.
SEE ALSO: -rr option
(C) 1990 Omen Tech Inc Chapter 23 Numeric Parameters
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 198
s Timeout interval in seconds waiting for XON characters or positive
flow control (default 15). If an XON is not received within this
time, transmission resumes anyway. A value of 0 disables this
timeout.
t XMODEM, YMODEM, and ZMODEM Receiver timeout in tenths of seconds
waiting for a packet or command acknowledgement (default 100).
T Transmitter timeout in tenths of seconds waiting for a packet
(default 600).
(C) 1990 Omen Tech Inc Chapter 23 String Parameters
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 199
24. STRING PARAMETERS
Case is significant in parameter names.
ZCOMM provides two types of string parameters, permament and
temporary. Permanent string parameters are always defined, and most
perform specific defined functions. The permanent string parameters
are described below. The names of the permament string parameters may
be displayed with the command sequence pv1; set given at the command
prompt. Without the pv1 only non empty string parameters are
displayed.
Temporary string parameters* are created by the set, sets, accept, and
grab commands when they do not reference a permament string parameter.
Temporary string parameter names begin with any letter except y and
may have up to 16 letters or digits.
The contents of temporary string parameters may be accessed and
modified when ZCOMM is Restricted. New temporary string parameter
names may not be created when ZCOMM is Restricted.
The set command without arguments displays the current values and
maximum string length for each of the non-empty string parameters. To
set a parameter empty, enter "" as the parameter string (e.g., set
txlog ""). Certain string parameters may be entered with ZCOMM's
character escapes.
When a string parameter is executed, it may be either sent to the
remote as a string or executed as a command if its first character is
@.
EXAMPLE: set f7 "logout\r" programs F7 to send a string to the remote.
EXAMPLE: set f7 "@echo logout" programs F7 to display logout on the
screen.
In strings sent to the remote, a \336 (octal 336) character causes a
pause in transmission[1] (controlled by the p numeric parameter),
which may be used to send multiple commands with one string.
An optional underscore prepended to the name of a permament string
parameter causes that string parameter to be cleared by the next call
command.
__________
1. Not including the mput command
(C) 1990 Omen Tech Inc Chapter 24 String Parameters
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 200
The following string parameters may not be accessed or modified by the
set command or in string expansions when ZCOMM is Restricted:
backtab bbs break bs esc etx exrc f1...f12 fs1...fs12 fc1...fc12
fa1...fa12 fcdel* fcdown* fcend* fchome* fcins* fcleft* fcpgdn*
fcpgup* fcright* fcup* fdel fdown fhome fins fleft fnp5* fpgdn
fpgup fright fup id0...id3 intolink* l linkpass* m oncloserx
onclosetx onexit outahost outalink* password pw0...pw3 quitcmd rub
tab unrestrict xpassword*
The following may not be modified by the set command when ZCOMM is
restricted:
answerback baudstr blankfill call1** call2 call3* callers*
calllog* callpath** challenge dircx dirpx dirfx dirrx dirsx disks
dport e emdir entstr eolstr helpfile home hprompt lib lpnono
mcommand mconnect menu messages mprefix mprompt msuffix n1 n2 n3
phones picture plog private rcmdlog* rdisks remote rname* rxlog*
telno tmp tname* twxfile txlog* welcome xhelpfile
The following parameters can never be modified by the set command: ano
args c d drive e h oname1...oname5 pwd s t w y y0...y127 yb yf
String Parameters for Remote Operation:
answerback baudstr bbs call1** call2 call3* callers callpath**
challenge dircx dirfx dirrx dirsx disks emdir exrc helpfile home
hprompt intolink* linkpass* menu messages oncloserx onclosetx
outahost outalink* password private pwd rcmdlog* rdisks rmtcmd*
rname* rmtcheck* tname* twxfile unrestrict welcome xhelpfile
String Parameters for Protocol File Transfer:
adlopts aulopts dirrx dirsx oncloserx onclosetx
String Parameters for Non Protocol File Transfer:
blankfill dircx dirfx eolstr
String Parameters for Interactive Operation:
backtab break bs dirpx entstr esc etx lpnono mprompt Soft Keys tab
rub xpassword*
String Parameters for Scripts:
ano args c d e h ifs item lib oncloserx onclosetx onexit
oname1...oname5 remote rxcnt s s0...s9 t tmp y y0...y127 yb yf
String Parameters for Making Calls:
l m mcommand mconnect mprefix msuffix telno
String Parameters for Log Keeping:
callers* calllog* plog rcmdlog* rxlog* txlog*
Other String Parameters:
helpfile home kermreset menu onexit picture phones quitcmd
adlopts Contains option(s) to be used for ZMODEM AutoDownloads.
EXAMPLE: set adlopts "r" Use the r option (crash recovery) for
files automatically downloaded with ZMODEM.
(C) 1990 Omen Tech Inc Chapter 24 String Parameters
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 201
alds An optional string to be used for controlling Alternate Long
Distance Services. On Unix systems, allows assignments to the ALT
keys a to z.
ano After invoking one of the date related string parameters, the ano
string contains the last two digits of the year.
answerback When term is in q (TWX) mode, an answerback is sent in
response to an incoming ENQ. The format of Answerback is
determined by the Western Union Telegraph Company. It typically
consists of
\r\nNAME CITY\r\n\021
as entered by the set command using character escapes. (In the
TWX protocol, the 021 (XON) at the end of the answerback turns on
the tape reader.) The answerback string must begin with CR,LF.
args contains the complete calling sequence to the current script
level.
EXAMPLE: call ge,upl accesses the genie telephone directory entry
and stores ge.upl in args.
aulopts Contains option(s) to be used with the sz command. aulopts is
processed by the sz command before any options given to the
command itself.
backtab Assigns a string or command to the BACKTAB (Shift TAB) key.
baudstr When ZCOMM gets a connect in host operation, ZCOMM executes
baudstr.
EXAMPLE: set baudstr "@gosub .%lib/baud.t"
bbs May contain a shell escape command to activate a Bulletin Board
program via a DOS Gateway. The bbs string parameter is always
processed as a shell escape command, and should not include a
leading "!". For security reasons, it should specify an absolute
pathname.
EXAMPLE: set bbs "~bbsprog"
blankfill When transmitting a file with the term function with p, r,
or w modes, ZCOMM sends the contents of blankfill (if set) to
prevent the remote from receiving a blank (empty) line. (Some
programs interpret a blank line as an exit from text entry.) ZCOMM
Character Escapes must be used to represent control characters.
If blankfill is empty, nothing is sent. The call command resets
blankfill to empty.
(C) 1990 Omen Tech Inc Chapter 24 String Parameters
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 202
break Stores a string or command to be executed by the Ctrl-Break key
instead of the default 100 ms break.
EXAMPLE: Some Novation modems cannot pass a break signal:
set break "@break putw %B\336\ 1\r putw %U\336\ 0\r"
Causes the break key to send a break to get the modem's attention,
then tells the modem to send the break itself, and finally
restores
the modem's ersatz "transparent" mode.
SEE ALSO: break command
bs Stores an alternate string or command to be executed by the
backspace key when in the term function.
c When the h or s string parameters is accessed, the hundredths of a
second are stored in the c string parameter. The accuracy and
precision of this quantity depend on the operating environment.
call1 ** Sets the string to be sent to the modem or command to be
executed before each time ZCOMM scans for outgoing message control
scripts. Typically this would consist of a modem command
disabling autoanswer, to allow outgoing calls. This string is not
used if callpath is empty.
EXAMPLE: set call1 "ATMS0=0\r" (Hayes Modem)
call2 Sets the string to be sent to the modem or command to be
executed each time ZCOMM begins to wait for a call in Host State.
Typically this would command the modem to enable autoanswer for
incoming calls.
EXAMPLE: set call2 "ATMS0=1\r" (Hayes Modem)
call3 * Sets the string to be sent to the modem or command to be
executed each time ZCOMM begins waiting for incoming calls.
Typically this would consist of a lput command to display an
informational message on the local screen. Note that such a
message will remain on the screen for long periods of time,
possibly creating an afterimage on the CRT display.
EXAMPLE: set call3
@lput "\n\nAwaiting Incoming Call. Press F1 to exit.\n"
(C) 1990 Omen Tech Inc Chapter 24 String Parameters
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 203
callers A pathname in which a log of successful host state logins is
kept. If callers is null (the default), no log is kept.
calllog * The filename that contains the log of successful autodialed
calls. If empty (the default), this function is disabled. A
typical entry with 6.3 minutes connect time with a system called
cis02 is shown.
C 2143:22 01-25-84 1200 c:226-0627 63 cis02
callpath ** Sets the ambiguous pathname that scans for scripts to
transmit outgoing messages. If empty (the default), no scans are
made.
EXAMPLE: set callpath "/tmp/outmsg.*"
NOTE: The "disks" string parameter must be set to include any
drive specified in "callpath".
SEE ALSO: call1, call2 string parameters
challenge is executed when the caller connects and handshakes to
determine transmission speed. This script runs without
restriction, and should check for carrier after each reading of
data.
EXAMPLE: set challenge "@gosub .%lib/challeng.t"
d Is set to the date when called, in the form "mmdd".
EXAMPLE: t cia%d.TXT If the date is December 7, ZCOMM enters the
term function with capture to KGB1207.txt
EXAMPLE: create -st+ cbbs%d.tmp
SEE ALSO: h, t string parameters
drive Is set to the current default disk drive letter when ZCOMM
starts and when logging into a new disk drive with an A: command.
mprompt, hprompt string parameters
dircx
dirpx
dirfx
dirrx
(C) 1990 Omen Tech Inc Chapter 24 String Parameters
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 204
dirsx String parameters for default/override directories. Their uses
are described in Chapter 15.
disks Contains the disks that may be logged into with with the d:
command where "d" is the drive letter, or that may appear as part
of a pathname. If empty (the default), drive letters are not
checked. This parameter should be set to prevent local or remote
users from hanging the system by accessing an off-line disk drive.
This string must be entered in lower case.
EXAMPLE: set disks "abc"
SEE ALSO: home, rdisks string parameters
dport Contains the name of the active communications port, otherwise
empty.
SEE ALSO: port command
drive Contains the drive letter of the current default DOS disk drive.
emdir A directory pathname for incoming electronic mail files. emdir
affects twxfile unless twxfile is an absolute path. emdir is also
used for incoming electronic mail using the YMODEM Batch protocol
in the absence of a login.
EXAMPLE: set emdir "/memo"
entstr If entstr is set, ZCOMM sends the contents of entstr when ENTER
(carriage return key) is keyboarded in the term function, unless n
mode is in effect. ZCOMM Character Escapes must be used to
represent control characters. If entstr is empty, a carriage
return is sent. The "call" command resets entstr to empty.
EXAMPLE: set entstr "\3"
sends an ETX (octal 3) when Enter is keyboarded. This is handy
for some computer systems that expect keyboarded lines to be
terminated with something other than the usual carriage return.
NOTE: The characters in entstr are always sent at full speed.
SEE ALSO: eolstr string parameter
eolstr When transmitting a file with the term function with p, r, or w
modes, ZCOMM sends the contents of eolstr (if set) to terminate
the line. ZCOMM Character Escapes must be used to represent
control characters. If eolstr is empty, a carriage return is
sent. The "call" command resets eolstr to empty.
(C) 1990 Omen Tech Inc Chapter 24 String Parameters
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 205
EXAMPLE: set eolstr "\r."
sends a carriage return followed by a period at the end of each
line read from the transmit file.
NOTE: The characters in eolstr are always sent at full speed.
SEE ALSO: entstr, blankfill string parameters
esc Stores an alternate string or command to be executed by the ESC
key when in term function.
etx Stores an alternate string or command to be executed by ETX
(Ctrl-C) when in the term function.
exrc Is sent to the modem/executed when an interactive Host Operation
session logs out.
EXAMPLE: set exrc "@handshake off; set disks c" turns off flow
control handshaking and resets the disks parameter in case
privileged (unrestricted) callers modify this parameter.
h is set to the hour of the day in the form hhmm.
EXAMPLE: echo "It is now %h Hours"
displays: It is now 1930 Hours.
SEE ALSO: hh, mm, d, t string parameters
helpfile The pathname that contains the online help file. You may
wish to set this in the phone directory "setup" entry. Iff
helpfile begins with the character @, the rest of helpfile is
treated as a Zcomm command.
SEE ALSO: xhelpfile string parameters, help command, T test
condition
hh is set to the hour of the day in the form hh.
EXAMPLE: echo "It is now hour %h."
displays: It is now hour 09.
SEE ALSO: h, mm, d, t string parameters
home When ZCOMM is invoked, home is set to the current directory.
When the "cd" command is given without an argument, the directory
is changed to the contents of home. When ZCOMM is Restricted,
absolute pathnames (those beginning with \ or /) must have home as
a prefix. This restricts unprivileged users to the directory
(C) 1990 Omen Tech Inc Chapter 24 String Parameters
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 206
given in home and/or its subdirectories on any of the disks
allowed by the disks string parameter. When changing the value of
home, use slashes (/) and not backslases (\), and do not use a
disk identifier.
SEE ALSO: disks string parameter
hprompt Overrides the default host operation command prompt.
SEE ALSO: mprompt, drive, pwd string parameters
id0-id3 General purpose string parameters that may be used to hold ID
strings (user account numbers) for script login applications.
ifs The "Internal Field Separator" string contains the default
characters to be used by the split command to parse a string into
fields.
item * When the expand command is executing a script, the item string
parameter is set to the pathname of the matched file.
intolink * A command that is executed or a string sent to the modem
when ZCOMM enters the link command.
EXAMPLE: set intolink "\r" sends CR to the linked computer.
EXAMPLE: set intolink "@portx 0f8,2" selects a nonstandard link
port.
SEE ALSO: linkpass, outalink string parameters
kermreset A string (up to 32 characters) may be sent by Pro-YAM's
Kermit when it attempts to recover from a transmission error. The
default value for this string is empty. Two metacharacters are
special: \336 inserts a one second pause, \335 sends a break.
l l (letter l) indicates selection of a long distance carrier for
calls to other area codes. It is set to "1" as a default. l may
be set to the access code of the particular alternate long
distance service desired with a "set" command.
SEE ALSO: m string parameter
lib A string variable which may be used to indicate the directory
containing scripts.
linkpass * If set, callers must enter this password when accessing the
link command.
(C) 1990 Omen Tech Inc Chapter 24 String Parameters
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 207
lpnono Do not send any of the characters in lpnono to the printer.
lpnono may use ZCOMM Character Escapes to represent control
characters.
EXAMPLE: set lpnono "\023" prevents the printer from receiving the
DC3 (XOFF) character that places some printers off line.
EXAMPLE: set lpnono "\7" prevents the printing of bell characters.
SEE ALSO: l mode
m m is used to indicate selection of a long distance carrier for
calls within the same area code. It is set to "1" as a default.
m may be set to the access code of the particular alternate long
distance service desired with a "set" command. It is separate
from the l string parameter because the default "1" prefix may not
work if the area code is given, but some alternative long distance
services require the area code to be specified for calls within
the same area code.
SEE ALSO: l string parameter
mcommand A command that is executed instead of ZCOMM's built in
dialing routine.
This may be either "gosub dial" which would access the "dial"
entry in the phones file, or "source /dial" which would access the
script from a separate file. The second method allows a separate
"dial" file for each machine, but requires one more file to be
kept track of.
Note that mcommand does not start with an @. The default value is
empty, disabling this function.
EXAMPLE: set mcommand "gosub dial"
SEE ALSO: telno string parameter
mconnect A command that is executed or string that is sent to the
modem when the modem makes a connection. A typical use is to set
transparent mode for some Novation modems. The default value is
empty, disabling this function.
menu The filename that contains the script accessed by the menu
command.
EXAMPLE: set menu /host/menu.hst
(C) 1990 Omen Tech Inc Chapter 24 String Parameters
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 208
messages Messages entered with the message command are appended to
this pathname. By convention, this file should be readable when
ZCOMM is running in Restricted host mode.
EXAMPLE: set messages "/host/messages"
mprefix A command that is executed or a string that is sent to the
modem as a prefix to dialing a number. The default ATD works with
the Hayes Smartmodem(TM) 1200. ATDT instructs the modem to use
DTMF (Touch Tone(TM)) dialing instead of pulse dialing. Character
escapes may be used.
mm is set to the minute of the hour. It expands to the form mm.
EXAMPLE: echo "It is now %h minutes past the hour"
displays: It is now 30 minutes past the hour.
SEE ALSO: h, hh, d, t string parameters
mprompt Overrides the default main command prompt.
EXAMPLE: set mprompt "\r\E[1m%drive:\L%pwd <<<\E[m " Sets the host
operation command prompt to display the current disk drive (%c)
and directory (%pwd) highlighted (\E[1m) and in lower case (\L).
N.B.: If you access Unix systems with ZCOMM, choose an mprompt
string that is distinct from your Unix prompt.
SEE ALSO: hprompt, drive, pwd string parameters
msuffix A command that is executed or a string sent to the modem after
the last digit in the phone number. Most intelligent modems
require the default value of "\r".
n0-n9 General purpose string parameters.
oname1...oname5 contains the information stored by the args string
parameter for each level.
oncloserx Optional user exit commands to execute after each file is
received with a protocol file transfer.* Its use is described in
Chapter 12.
onclosetx Optional user exit commands to execute after each file is
sent with a protocol file transfer.* Its use is described in
Chapter 12.
onexit Optional commands to execute as ZCOMM exits to the operating
system.
(C) 1990 Omen Tech Inc Chapter 24 String Parameters
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 209
EXAMPLE: set onexit "@echo GOODBYE!!"
outahost A command that is executed or a string sent to the modem when
ZCOMM exits host operation with a F1 or ALT-N key.
EXAMPLE: set outahost ATZ\r sends the ATZ command to a Hayes modem
to restore its default no autoanswer state.
outalink * A command that is executed or a string sent to the modem
when ZCOMM exits the link command.
EXAMPLE: set outalink "@kill; px0" clears the circular buffer and
prevents restricted callers from accessing the link command.
SEE ALSO: intolink string parameter
password Changes the password callers must enter to gain access to
your computer when ZCOMM is in host operation. If password is
empty no password will be demanded.
EXAMPLE: set password "Change This Already"
SEE ALSO: challeng.t script, demand command
phones The filename that contains the telephone directory entries and
associated commands used with the call and gosub commands. The
default is "/PHODIR.t". The default may be changed at
installation time by the putsnp program. The DOS environment
variable PHONES will override the default when ZCOMM is started.
Finally, a set command may be used to change the telephone
directory once ZCOMM has started.
picture The filename used by the ALT-Z command to "zap" a copy of the
display memory to the specified file.
plog The filename that contains the file transfer performance log. If
empty (the default), this function is disabled.
private Pathname that messages are stored into by the private command.
This file should NOT be readable when ZCOMM is running in
Restricted host mode.
EXAMPLE: set private "/private"
pw0-pw3 General purpose string parameters for holding passwords. If
defined with a set _pw0 "secretpw" command, it will be cleared
(C) 1990 Omen Tech Inc Chapter 24 String Parameters
Version 17.61 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 210
with the next call command.
pwd This parameter is set to the current working directory by each cd
and pwd command.
quitcmd Sets the string to be sent to the modem or command to be
executed when a protocol file transfer has been completed if the
ALT-Q key was typed during that transfer.
EXAMPLE: set quitcmd t\r\336\r\336\r\025off\r would send t<ENTER>,
a pause, <ENTER>, a pause, <ENTER>, and ^Uoff<ENTER>. This
sequence may be useful for automatically logging off Compuserve
after downloading a file.
SEE ALSO: ALT-Q special key
rcmdlog * The filename that contains the log of commands issued
remotely (in Host Operation) along with the time, transmission
speed, and the name of the caller. If set to "prn", the commands
are logged on the printer. A highly buffered printer, hard disk
file or ramdisk file is recommended because this file will be
opened and closed for each host command. If empty (the default),
this function is disabled.
EXAMPLE: set rcmdlog D:rcmds
rdisks Contains the disks that may be logged into with with the d:
command where "d" is the drive letter, or that may appear as part
of a pathname, when ZCOMM is Restricted. If empty (the default),
drive letters are not checked against this parameter. (Drive
letters are always checked with the disks parameter.) The rdisks
parameter is used to prevent restricted remote users from
accessing private data files. This string must be entered in
lower case.
EXAMPLE: set rdisks "c"
SEE ALSO: home, disks string parameters
remote ZCOMM reads The full name of the remote system from the
telephone directory entry when the call command is given.
EXAMPLE: call omen using the omen entry in the distributed
PHODIR.t file assigns omen-tech to the remote string parameter.
In Host Operation, the caller's name is read into remote.
SEE ALSO: call command, xpassword string parameter, \PXXXX
(C) 1990 Omen Tech Inc Chapter 24 String Parameters
Comments
Post a Comment