home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Beijing Paradise BBS Backup
/
PARADISE.ISO
/
software
/
BBSDOORW
/
ZCOMMDOC.ZIP
/
ZCOMMDOC.AH
< prev
next >
Wrap
Text File
|
1995-03-21
|
78KB
|
1,771 lines
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 211
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.
Y Control byte for the NS16550AN/NS16550AFN FCR register. If you
don't know what the FCR does, don't change this parameter. It has
been suggested that a different value (129) may improve
multitasking under DESQview when multiple copies of ZCOMM 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
be enabled with a pd1 command in the telephone directory setup
entry.
(C) 1994 Omen Tech Inc Chapter 24 Numeric Parameters
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 212
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[2] (from a
negative number), and E term option 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 term option
SEE ALSO: e test condition (if, while commands)
Unless the q file transfer option is used, each file skipped as a
result of ZMODEM selective transfer increments this parameter.
f Fail time. Sets the default timeout in seconds for matching a
pattern. A value of 0 suppresses this timeout. 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 term option.
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 37). The g parameter is reset to its default
(linefeed, 10) by the call command. (See documentation on the p
term option.)
__________
2. Refer to E term option description for caveats.
(C) 1994 Omen Tech Inc Chapter 24 Numeric Parameters
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 213
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 term option 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)
termoption 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) 1994 Omen Tech Inc Chapter 24 Numeric Parameters
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 214
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 term option is
set. In addition, adding 8 to the number allows terminal emulation
escape codes (DEC "media copy enter printer controller") 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.
As a special case, setting this parameter to 0 forces ZCOMM to use
DOS handle 4 (STDPRN, device PRN:) for printer output. Doing so
may generate spurious "Abort, Retry, Ignore, Fail" messages from
some versions of DOS. DOS 5.0 generates spurious "Write Fault"
messages with some parallel port adapters; changing from the
parallel port on an AST Advantage board to a recent Chinese "AT
Multi I/O" board eliminated the DOS error messages.
When using DOS handle 4 for printing, a legitimate printer problem
will generate the "Abort, Retry, Ignore, Fail" message. Normally
you would wish to correct the printer problem and keyboard "r" for
Retry. If the printer problem cannot be corrected, keyboard "f"
(Fail) a few times and ZCOMM will disable printing by setting the l
numeric parameter to -1. Printing can be enabled later by
resetting the l numeric parameter.
The default value is 1 (BIOS LPT1, ignore terminal emulation
printer commands).
EXAMPLE: pl2 selects LPT2.
EXAMPLE: pl9 selects LPT1 and allows the remote application to
enable "auxiliary print" and/or "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).
(C) 1994 Omen Tech Inc Chapter 24 Numeric Parameters
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 215
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.
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 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 term options. 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 term option
q Sets the "gopause". When sending a file with a wait for "gochar" (
p term option), 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 term option
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.
(C) 1994 Omen Tech Inc Chapter 24 Numeric Parameters
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 216
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. Throttle controls the term function sending speed
only when t term option is enabled.
The default value of 4 corresponds to about 20 characters per
second. Larger numbers give slower transmission. The effective
resolution of the t parameter is limited by the timekeeping
resolution of the 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 term option
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 og 1 or greater enables
logging of files skipped by selective ZMODEM file transfers. 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.
(C) 1994 Omen Tech Inc Chapter 24 Numeric Parameters
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 217
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. The
maximum B+ block length is 1024 data bytes. A value of 0 (the
default) allows the Compuserve computer to control the block
length. A negative value controls the upload block length but
still allows Compuserve to control the download block length.
Uploads to Compuserve using longer block lengths are sensitive to
poor flow control, especially when error correcting modems (MNP,
etc.) are used. If B+ uploads fail or require excessive
retransmissions, correct the flow control arrangements, disable the
modem's error correction, or try a smaller upload block size.
The data contents of successfully transferred files 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
(C) 1994 Omen Tech Inc Chapter 24 Numeric Parameters
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 218
24.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 37 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
SEE ALSO: Kermit protocol in Chapter 13
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 term
options (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[3] 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.
__________
3. for 96 byte packets
(C) 1994 Omen Tech Inc Chapter 24 Numeric Parameters
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 219
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.
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
(C) 1994 Omen Tech Inc Chapter 24 Numeric Parameters
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 220
24.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.
EXAMPLE: z pl16384
Forces ZMODEM packet length of 16384 (default packet length is
infinite).
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 make it clear its transmit buffer
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.
Setting this parameter to -1 disables error checking 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.
d Some operating systems, most notably VAX/VMS, use ^X to stop
programs. ZMODEM uploads consist of a "rz" command to start the rz
program followed by a ZMODEM packet. If the ^X in the ZMODEM packet
(C) 1994 Omen Tech Inc Chapter 24 Numeric Parameters
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 221
causes problems, the zmodem d parameter can be used to delay the
initial ZMODEM packet until the rz program initializes itself. The
zmodem d parameter sets a delay in tenths of a second on ZMODEM
sends (uploads) between the "rz" command and the first packet.
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.
Use 32768 for newer SCO systems that support CRTSFL.
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.
J See discussion of the zmodem k parameter immediately below.
k (PCDOS versions only) On YMODEM and ZMODEM downloads, the zmodem k
parameter causes ZCOMM to pause transmission every k kilobytes by
asserting flow control restraint, and flushing disk writes. This
does no require any special cooperation from the sending program
beyond properly configured flow control. If the zmodem k parameter
is non zero and the I numeric parameter is set, flushing is
performed every I bytes.
The zmodem J parameter controls the time delay between flow control
assertion and buffer flushing. The zmodem K parameter controls the
time delay between buffer flushing and the de-assertion of flow
control.
SEE ALSO: I numeric parameter, Error Messages chapter (interrupt
latency)
K See discussion of the zmodem k parameter immediately above.
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
(C) 1994 Omen Tech Inc Chapter 24 Numeric Parameters
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 222
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.
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.
Error recovery when ZMODEM is used with networks that store an
excessive number of characters in transit can usually be improved by
restricting the window size. The call command resets this parameter
to 0.
Setting this parameter non zero also causes the sz command to
perform an extra step that actively prevents an ALT-F given to a
receiver from generating a spurious successful file transfer
completion.
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
(C) 1994 Omen Tech Inc Chapter 24 Numeric Parameters
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 223
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.
EXAMPLE: z pR30000
SEE ALSO: -rr option
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) 1994 Omen Tech Inc Chapter 24 String Parameters
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 224
25. 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) 1994 Omen Tech Inc Chapter 25 String Parameters
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 225
String parameters may be up to 129 characters in length except as
noted. TAB characters count as one character each.
The following string parameters may not be accessed or modified by the
set command or in string expansions when ZCOMM is Restricted:
alta...altz 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:
MODEM answerback altprompt baudstr blankfill call1** call2 call3*
callers* calllog* callpath** cellular 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 nodename oname1...oname5 parity pwd s speed t w
y y0...y127 yb yc yf
String Parameters for Remote Operation:
answerback baudstr bbs call1** call2 call3* callers callpath**
cellular 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 toptions
String Parameters for Interactive Operation:
Soft Keys altprompt backtab break bs dirpx entstr esc etx lpnono
mprompt parity rub tab toptions xpassword*
String Parameters for Scripts:
ano args c d e h ifs item lib oncloserx onclosetx onexit nodename
oname1...oname5 remote rxcnt s s0...s9 t tmp toptions y y0...y127
yb yc yf
String Parameters for Making Calls:
MODEM 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
(C) 1994 Omen Tech Inc Chapter 25 String Parameters
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 226
MODEM (Note this variable name is UPPER CASE to allow importing
from the environment.) When the advanced dialer described in
Chapter 8 is used, MODEM contains the file name of the modem
specific dial routine to use.
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.
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) term option, 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.
altprompt Overrides the default auxilliary command prompt generated by
the ALT-2 key.
EXAMPLE: set altprompt "\r\E[1m%drive:\L%pwd >>>\E[m "
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
altprompt string that is distinct from your Unix prompt.
SEE ALSO: hprompt, mprompt, nodename, drive, pwd string
parameters
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.
(C) 1994 Omen Tech Inc Chapter 25 String Parameters
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 227
baudstr When ZCOMM gets a connect in host operation, ZCOMM executes
baudstr.
EXAMPLE: set baudstr "@gosub .%lib/baud.t"
SEE ALSO: host operation, Chapter 28
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 term options, 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.
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.
(C) 1994 Omen Tech Inc Chapter 25 String Parameters
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 228
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"
callers A pathname in which a log of successful host state logins is
kept. If callers is null (the default), no log is kept.
SEE ALSO: Chapter 30, Logging Entries
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. The phone number is that given to
Zcomm for autodialing.
C 2143:22 01-25-84 1200 c:226-0627 63 cis02
SEE ALSO: Chapter 30, Logging Entries
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
cellular This is set by a call cellular command to make the dialer
select modem options suitable for operation over cellular
radio.
(C) 1994 Omen Tech Inc Chapter 25 String Parameters
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 229
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. nodename, altprompt, mprompt, hprompt string
parameters
dircx, dirpx, dirfx, dirrx, dirsx String parameters for
default/override directories. Their uses are described in
Chapter 16.
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.
(C) 1994 Omen Tech Inc Chapter 25 String Parameters
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 230
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 term option 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 term options, 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.
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.
(C) 1994 Omen Tech Inc Chapter 25 String Parameters
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 231
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 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: altprompt, mprompt, nodename, 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.
(C) 1994 Omen Tech Inc Chapter 25 String Parameters
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 232
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) selects 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.
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 selects 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
(C) 1994 Omen Tech Inc Chapter 25 String Parameters
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 233
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
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.
(C) 1994 Omen Tech Inc Chapter 25 String Parameters
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 234
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 "
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.
EXAMPLE: set mprompt "\r\E[1m%nodename:%drive:\L%pwd <<<\E[m
"
SEE ALSO: altprompt, hprompt, nodename, 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.
nodename Contains the node name given to individual Unix and Xenix
systems. On other systems this must be set by a script.
SEE ALSO: Unix uname command
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 13.
onclosetx Optional user exit commands to execute after each file is
sent with a protocol file transfer.* Its use is described in
Chapter 13.
onexit Optional commands to execute as ZCOMM exits to the operating
system.
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.
(C) 1994 Omen Tech Inc Chapter 25 String Parameters
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 235
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
parity Contains a string representation of the number of data bits
and parity, such as 8n.
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.
SEE ALSO: Chapter 30, Logging Entries
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 with the next call command.
pwd This parameter is set to the current working directory by
each cd and pwd command.
(C) 1994 Omen Tech Inc Chapter 25 String Parameters
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 236
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
SEE ALSO: Chapter 30, Logging Entries
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
character escape
(C) 1994 Omen Tech Inc Chapter 25 String Parameters
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 237
rmtcheck Sets the string to be sent to the modem or command to be
executed each time ZCOMM accepts a command line or ZMODEM
protocol Command Download from the remote caller when in Host
Operation, before that command is executed.
SEE ALSO: rmtcmd, pwd string parameters
EXAMPLE: set rmtcheck "@source D:remcheck.t"
rmtcmd Contains the command line entered by the caller or received
by ZMODEM protocol Command Download in Host Operation. This
may be modified by an unrestricted script invoked via the
rmtcheck string parameter.
SEE ALSO: rmtcheck string parameter, checkrmt.t script
rname * Contains the name of the last file received by a protocol,
successful or not.
rub Assigns a string or command to the RUBOUT (Shift Backspace)
key.
rxcnt A three digit number which counts the number of files that
have been created for receiving. An incoming file with an
illegal name is changed to rename.n with n is incremented
from the value stored in rxcnt (or 0).
rxlog * The filename that contains the log of received files. If
empty (the default), this function is disabled.
SEE ALSO: Chapter 30, Logging Entries
s * Contains the current time in seconds since the last minute.
s0...s9 These may be tested with the if %sN and if i%sN,string
commands, or expanded into a string using character escapes
with the "%sN" construction, where N is 1...9. Use set param
"" (empty string enclosed by double quote characters) to set
a string parameter to empty.
speed String representation of the serial port speed.
statliner May be used to place a messgae in the right side of the term
function status line, replacing the information normally
displayed there. If statliner begins with a space, it is
placed at the far right of the status line, after the
information normally displayed. If statliner does not begin
with a space, it is processed for string substitution and
character escapes, and then placed at column 31 of the status
line.
(C) 1994 Omen Tech Inc Chapter 25 String Parameters
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 238
Soft Keys can either send strings or execute commands. If the
assigned string begins with "@" (commercial at), the string
is executed as a command.
A soft key command called from the term function should not
end with a t or f command because this would cause excessive
recursion (calling the term function from within the term
function). (Use the create or open instead.)
The alta to altz, f1 to fa12 strings are executed by the
respective keys from the term function, review function, or
command prompt. In the term function, soft keys definitions
for fins, fdel, fhome, fup, fdown, fpgup, fpgdn, fleft,
fright, fend will override ZCOMM's built-in definitions for
these keys. The built-in definitions take precedence in the
review function, conference command, and at the command
prompt. In the conference command, soft keys are inserted
into the editing window unless they are commands, which are
executed. Soft keys are not executed from review or the
command prompt unless they are commands (beginning with "@").
Computers with the 101 key extended keyboard and ROM BIOS
support allow ZCOMM to distinguish the cursor cluster keys
and the two new function keys labelled F11 and F12. Extended
keyboard cursor cluster keys may be reassigned with the
fcdel, fcdown, fcend, fchome, fcins, fcleft, fcpgdn, fcpgup,
fcright, and fcup string parameters. The fnp5 key may be
assigned to the "5" key on the numeric pad.[2] ZCOMM's
character escapes can be used to encode special characters,
including spaces and/or tabs.
EXAMPLE: set bs "\177"; set rubout "\b" Swap backspace and
rubout for VMS
Bound Soft Keys are displayed by ALT-K and keys commands.
EXAMPLE: set f3 @rb Assigns the rb command to F3.
t expands to the current time and date each time it is used.
SEE ALSO: d, h string parameters
__________
2. Visible on extended 101 key keyboards with extended BIOS support
only
(C) 1994 Omen Tech Inc Chapter 25 String Parameters
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 239
tab Assigns a string or command to the TAB key.
telno The current telephone number string.
SEE ALSO: mcommand string parameter
tmp A string variable which may be used to indicate the directory
used for data to be transmitted or received.
tname * Contains the name of the last file sent with a protocol,
successful or not.
toptions Contains optional term function options to be applied to each
instance of the following term function commands: conference,
create, f, learn, t and F-2
SEE ALSO: term funcion options, Chapter 22.
txlog * The filename that contains the log of transmitted files.
If empty (the default), this function is disabled.
SEE ALSO: Chapter 30, Logging Entries
unrestrict Changes the password callers must match to allow remote
functions that are normally restricted such as erasing files,
listing and changing parameters, and changing to private
directories. If unrestrict is empty (the default), the
unrestrict command will fail.
SEE ALSO: unrestrict command
w Contains the day of the week (local time) as Mon, Tue, Wed,
Thu, Fri, Sat, or Sun.
welcome is executed after the password (if any) has been demanded and
accepted.
EXAMPLE: set welcome "@type welcome.txt; purgek; nulls 0"
xhelpfile The pathname that contains the online help file for host
mode commands. This should be readable when ZCOMM is in
Restricted Host Operation. Iff xhelpfile begins with the
character @, the rest of xhelpfile is treated as a Zcomm
command.
SEE ALSO: helpfile string parameters, help command
xpassword * xpassword is a master password string that may be used to
generate a unique password for each system called. xpassword
is encrypted by the name of the remote system (string
(C) 1994 Omen Tech Inc Chapter 25 String Parameters
Version 18.18 TurboDial 2.41 Universal Line Printer Edition
ZCOMM User Manual 240
parameter remote) to generate a password unique to each
remote system called. The generated password is transmitted
as a result of a Soft Key programmed with the \PXXXX
construction described in Chapter 26. To view the generated
password, set the remote string parameter to the full remote
system name as it appears in the appropriate telephone
directory (up to but not including any "-" character), then
keyboard lput \PXXXX from the main command prompt.
EXAMPLE: set f8 "\PXXXX" Programs F8 to transmit a 5
character password from the term function.
Omen Technology Inc cannot accept responsibility for damages
due to the breaking of any codes used or generated by ZCOMM.
uucplock Contains an optional UUCP lock file prefix for arbitrating
tty ports with the Unix UUCP program. This is normally set
automatically, or from the UUCPLOCK environment variable.
EXAMPLE: set uucplock "/usr/spool/locks/LCK.."
y expands to represent the y string parameter current line.
y0...y127 Read only string parameters y0 to y127 represent lines
displayed by the term function. y0 corresponds to the
current partially finished line as displayed by the term
function. The last line referenced by y0...y127 becomes the
y string parameter current line used by the y, yb, and yf
string parameters. Each time the term function displays a
newline from the remote, the y string parameter current line
points to the new, unfinished line from the remote.
yb Referencing the yb read only string parameter backs up the y
string parameter current line one line, and then represents
that line.
yc Reads one character from the modem without intrepretation and
returns it as a decimal number 0 to 255. A 100 millisecond
timeout returns a string of -2.
SEE ALSO: m test condition, setn command
yf Referencing the yb read only string parameter advances the y
string parameter current line one line, and then represents
that line.
SEE ALSO: H, h test conditions
zmrxesc Requests the sending ZMODEM-90(TM) program to escape the
specified additional control character(s). Printing
characters @ (40 hex) to _ (57 hex) escape the corresponding
(C) 1994 Omen Tech Inc Chapter 25 String Parameters
