Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 121 N.B.: Backslashes in file names used with the obey command must be escaped. N.B.: When the obey command is used to substitute file names, file names containing separator or operator characters such as & may change the syntax of the resulting command. For instance, the pathological but legal DOS filename foo&&999.bar would cause obey if f%thisfile gosub dofile to expand to if ffoo&&999.bar gosub dofile to parse as a test for a match to an illegal pattern 999. off Disable the modem by dropping DTR (Data Terminal Ready), [14] release ownership of the serial port, and exit to the operating system. DOS ZCOMM drops Clear To Send (CTS) as well as DTR if hardware flow control was selected with the handshake command. Exit status is the value of the ? numeric parameter. The next program must select the port and initialize it to reassert DTR before making or answering another data call. SEE ALSO: bye, x, o, port commands on [condition rest-of-line] * Executes rest-of-line if condition is true. Condition is tested after each command line executes, unless a return or fail command is executed, or when pattern is the last command on the line. An on command without predicate (on a line by itself) cancels the on command active at that script level. EXAMPLE: on The term function may be accessed with the wait command and no patterns active to force an exit on loss of carrier detect or pattern search timeout. Otherwise, ZCOMM could remain in term function until a command is keyboarded. Typical commands to use with the on statement are goto, return, off, and abort. Chapter 27 describes the testable conditions. One active on statement is available for each level of script. The on statement does not propagate to succeeding script levels. When rest-of-line is executed, the on statement at that level is canceled. An on command cancels any previous on command at that script level. EXAMPLE: on !c goto fooend Branches to fooend if the carrier drops out. __________ 14. The modem must be configured to use Data Terminal Ready (DTR). (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 122 SEE ALSO: wait, if commands NB: No other commands may be on the line after the on command except for its predicate. open [-modes] file Opens file for transmission with the term function with modes. The open command should be used when you don't want to enter the term function immediately, or are already in it. In other situations, it may be necessary to open the file before dialing to allow transmission immediately after connection, without the delay of opening the file from a floppy disk. SEE ALSO: seek, read, close commands page pathspec Type the file(s) specified in pathspec a screenfull at a time. When the screen is filled up, the More? prompt appears. Typing space displays another screenfull. Typing ^X skips to the next file. Typing ^K or ^C terminates the command. This command closes any open transmit file. ZCOMM automatically detects SQueezed files and prints them in ASCII.* EXAMPLE: page *.doc SEE ALSO: browse, type, list, findmore commands PATtern [n[cilpv$] string [action]] (n = 0...24) The pattern command allows ZCOMM to search for up to 25 different responses from a remote computer, and take action based on which of those responses (or none) was "seen". A pattern match can execute specified script command(s) "on the fly" (c modifier) or return control to the calling script with an indication of which pattern was matched. The pattern command causes the next t, f, or wait command (term function) to search for string in the data received from the remote/modem. String must be entered exactly as it will be received from the modem, in the same case and with the same embedded spaces or tabs. Control characters must be represented with ZCOMM character escapes. The metacharacter \256 matches any single character. ZCOMM %string substitutions may be used to define search patterns. If the % character is to be searched for, it must be represented as \045. Parity, NULL, RUBOUT, XON, and XOFF characters received from the remote do not affect pattern searches. If Kermit AutoDownload (K mode) is set, strings with SOH (Ctrl-A) cannot be matched. If ZMODEM AutoDownload (Z mode) is set, strings with CAN (Ctrl-Z) cannot be matched. If B protocol (c mode) is set, strings with DLE or ENQ cannot be matched. Strings of up to 33 characters each may be specified for simultaneous search by the term function. The search patterns are (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 123 "global" among all script levels; a pattern command in a subroutine affects the patterns set by the calling script(s) and vice versa. The term function returns when one of the patterns is matched or when the term function times out with f seconds with no characters from the remote, as determined by the f numeric parameter, or when carrier detect is lost. The first wait, t or f command given after the pattern command begins the search. When one of the patterns is matched, that pattern is marked as found and its corresponding action is executed (if present). ZCOMM will remain in the term function until there is a pause in data transmission from the remote[15] unless the i or c modifier is used. The following modifiers may be used. The c, i, and l modifiers are mutually exclusive. c The pattern is marked as found and action executed (if present). The term function then continues searching. Matching this pattern does not cause a return from the term function. The condition for this pattern will test true, but the n test condition is not affected. i (Immediate) The pattern is marked as found and action executed (if present). The term function then returns immediately. l (line end delay) The pattern is marked as found and action executed (if present). The term function then returns after the first LF character following the matched string. p (permanent) A pattern with the p modifier is not reset by the pattern command without arguments. Patterns with the p modifier may be used to search for disconnect messages within an entire script. Permanent patterns are reset by the call command, each item in the outcall queue, and an explicit pattern command referencing that particular pattern number. EXAMPLE: pattern 20 "\nCLR" "@off" Disconnects and exits ZCOMM if the phrase CLR is seen immediately following an LF. v (verbose) The v modifier displays a message when the pattern is matched. This is often useful when debugging scripts when the large amount of output generated by large v numeric parameter values is not desired. __________ 15. Pause length is specified by the q numeric parameter. (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 124 EXAMPLE: pat 5v "Finished Already." $ Sometimes the only way to recognize a prompt (as distinct from the same string embedded in other data) is to require the prompt to be the last thing sent by the remote, before a pause. The $ modifier allows string to be matched only if the remote pauses for 1 to 2 seconds after transmitting the last character in string. The optional action is a string to be sent to the remote, or executed as a command if it begins with "@". Action is executed the instant the last character of the pattern is matched, even if the i modifier is not used. Action must not use the goto, f, t, or wait commands. The pattern command without any arguments clears the patterns that don't have the p modifier, and terminates pattern searching. The other events that terminate pattern search are a match to a pattern that does not have the c modifier, a pattern search timeout, the call, abort, or quit commands, a major error, or the NUKE key. EXAMPLE: pat 0c$ "" "\21" Sends one XON character every time there is a pause in output from the remote. This recovers from situations where the remote computer stops because it receiveed a spurious XOFF character, or lost an XON character. In the pattern n string command, if string contains a repeating sequence such as foo in foofoobar, the search may be unsuccessful if part of the phrase is received immediately prior to the desired string (foofoofoobar). port n Change the modem port to COMn. On DOS, the legal values for n are 1...18. Selecting a new port normally selects software handshaking ("handshake sw"). The PCDOS flavor enables both hardware and software handshaking ("handshake both") iff the port speed exceeds 2400 bps and the Clear To Send (CTS) signal is active at the time the port command is given. Standard Ports (PCDOS): COM1 3F8 IRQ4 (Standard IBM) COM2 2F8 IRQ3 (Standard IBM) NON STANDARD PORTS: COM3 3E8 IRQ4 (Alternate) COM4 2E8 IRQ3 (Alternate) COM5 2B8 IRQ3 (Columbia) (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 125 COM6 2B8 IRQ2 (Alternate for IBM) COM7 2E8 IRQ5 (Alternate "COM3") COM8 3E8 IRQ5 (Alternate "COM4") COM9 Uses the port address and interrupt vector previously set by the portx command. COM11-COM18 IBM PS/2 COM1-COM8 ports COM1 and COM2 are the standard serial ports defined by the IBM Technical Reference Manual. COM3 and COM4 are supported by many serial cards and modem boards. COM3 and COM1 share the same dedicated hardware interrupt line, and these ports may not be used at the same time. Likewise, COM4 and COM2 may not be used at the same time. Columbia computers support COM5. COM6 to COM8 are alternate configurations that may be accessed by cross jumpering between printer port decoders and serial port enables on some multifunction boards. COM7 and COM8 support alternative definitions for "COM3" and "COM4" respectively. COM11 to COM18 correspond to "COM1" to "COM8" on IBM PS/2 computers. Only one of COM12-COM18 may be used at a time unless using the special OS/2 comm driver for that board. Since ZCOMM uses the interrupt line on the selected port, no other program or device driver may use the same port address and/or interrupt vector concurrently. Certain disk controllers and mice interfaces use IRQ2 and IRQ5. Do not use IRQ2 on a PC-AT (the extra 8259 is not reset). IRQ5 is sometimes used by network cards and printer ports. Do not select COM3 to COM18 unless you are familiar with the I/O addresses and interrupt vectors used in your machine. Ports sharing the same interrupt vector (IRQ number) cannot be used concurrently. The port command sets the d mode (which suppress the No Carrier Detect message). EXAMPLE: port 2 DOS ZCOMM begins with COM1 unless overridden by the DPORT environment variable. EXAMPLE: C>set DPORT=2 (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 126 On Unix, the argument of the port command is a character special file in the /dev directory. Unix and Xenix flavors have no default port. If the DPORT environment variable is set, that port will be selected when ZCOMM initializes. Otherwise, a port is selected by the startup and/or dialing script. Typical values are tty01 (386/ix) and tty2A (Xenix). EXAMPLE: DPORT=tty1A; export DPORT SEE ALSO: handshake command, dport string parameter portx hbase,irq * To support specialized multiport serial interfaces, the portx command selects a communications port with a specified hexadecimal base address hbase and Interrupt Request Line irq (3 <= irq <= 7). The portx does not check its argument for validity. The consequences of an invalid selection are quite undefined. The specified base address and IRQ number are assigned to COM9, where they may be used by the port command and the x numeric parameter. The status line and s command will indicate COM9. This command not available on X.PC, Unix, Xenix, or OS/2. EXAMPLE: portx 3f8,4 Selects a comm port with a base address of 3f8, using IRQ4. SEE ALSO: intolink string parameter private The private command allows a caller to keyboard a message which will be appended to a file specified by the private string parameter. Typically, private points to a private file inaccessible to callers. ZCOMM prepends a "From" line using the callers name as stored in the remote string parameter. The private command prompts the caller to keyboard a "to:" name and up to 64 lines of text. A blank line terminates the message. This command is intended for short messages; long messages should be uploaded with a file transfer protocol. Keyboarding is controlled by the Z numeric parameter, which sets the hot zone column after which a keyboarded space character begins a new line. SEE ALSO: message command purgek Purge any characters the user may have typed ahead.* purgel Purge any unprocessed characters received from the modem Line (remote).* put string The put command transmits string to the remote. Use the put command for transmitting commands to a modem or a remote computer system. String is processed for character escapes. Control and other special characters may be entered with character (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 127 escapes described in Chapter 26. If a carriage return should be sent, it must be explicitly coded with \r at the end of the string. EXAMPLE: put "myname\r" Sends myname followed by carriage return to the modem. A \336 (octal 336) character causes a pause in transmission (duration controlled by the p numeric parameter). This pause allows one string to contain multiple commands. EXAMPLE: put "\336ATZ\r\336\336ATX1 M0 S0=1\r" Pauses, sends ATZ\r, pauses (twice because some modems take longer to reset!), and then sends ATX1 etc. to the modem. Transmission with put is controlled by the 7, 8, h, p, w, and t modes. SEE ALSO: putw, mput, putv commands putw string The putw command transmits string to the remote, and pauses for a period of time (determined by the q numeric parameter) before returning from the term function to allow characters to echo. Other than that final pause, putw operates the same as the put command. N.B.: Putw should not be used when the next operation will be a pattern or wait command. If the expected response starts before the putw command finishes, the following wait command will never get to "see" what it is waiting for. In general, the putw command should only be used as a short-cut for sending a command when the response is known in advance and can be safely ignored. SEE ALSO: put, mput commands putv svar The putv command transmits svar to the remote without any translation of character escapes. Putv does not append a carriage return or line feed to the transmitted string. EXAMPLE: putv s0; put "\r" SEE ALSO: put, mput commands pwd Print Working Directory displays the current directory pathname, and stores it in the pwd string parameter. EXAMPLE: pwd SEE ALSO: cd command (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 128 pxN Set Numeric parameter x to value N. If x and N are blank, display the numeric parameters which can be set by this command and their current values. This command is not allowed if Restricted. Numeric parameters are described in Chapter 24. EXAMPLE: ps8 Sets the status line attribute to 8 (grey), suitable for composite video displays. EXAMPLE: pv-1 Sets the v numeric parameter ("verbose") to -1, suppressing some routine messages. More negative values suppress more routine messages. EXAMPLE: pd1 Sets the d numeric parameter to 1, causing files received with ZMODEM or full YMODEM protocol to be stored with the modification date transmitted with the file. EXAMPLE: pk3 Sets the k numeric parameter to 3, which kills pending output stored in the circular buffer when ETX (Ctrl-C) (decimal 3) is keyboarded in the term function. queue { add [string] | clear | delete [n] | list | run } Manipulate and execute a queue of commands for dialing numbers or other suitable functions. The queue contains 20 slots numbered 0 to 19. queue clear clears all queue entries. queue add [string] adds string to the queue after processing for string substitutions. The string is added to the first empty queue slot available. If string is absent, it is taken from the next script line. A typical string would be a command to call a system: call telegodzilla Script entries used with the circular dialing queue should end with a t command, which will enter the term function. To stop the queue at that point, use the ALT-N (NUKE) key. NUKE queue delete [n] Delete then nth queue entry, or the currently executing entry if n is not present. queue list lists the non empty queue entries. queue run begins execution of the queue entries. The ALT-N (NUKE) key, a fatal errror or any keyboarded character present after the execution of the command in the entry terminates the queue run command. The queue commands are independent of the Outcall Queue available in Host Operation. (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 129 EXAMPLE: The script fragment: queue clear while q set? s0 Q queue add "echo %s0" queue list Sets each queue entry to echo its own queue number, then lists the queue entries. SEE ALSO: q and Q test conditions, Shift-F5 and Shift-F6 function keys quit * Causes an immediate return to the command prompt from any script level. Quit may be used within a command string assigned to a function key where an unconditional return to the command prompt is desired, even if keyboarded from the term function. r [oldcmd] Search back through the history file of keyboarded lines for the first line that oldcmd is a prefix of, and execute it. If oldcmd is absent, execute the last locall entered keyboarded line. EXAMPLE: history C:/tmp/junk.hst del *.bak *.lst *.tmp *.foo cd bazdir r d del *.bak *.lst *.tmp *.foo (command echoes) SEE ALSO: history command r7 [-options] [dir] [file ...] Receives with options 1 or more files using MODEM7 batch protocol. An optional directory dir may be specified. If pathname(s) have been supplied to the r7 command and the sending program attempts to send more files than the number of names supplied to the r7 command, the transfer is aborted. The command is provided for compatibility with traditional programs that do not support the superior YMODEM or ZMODEM protocols. EXAMPLE: r7 -c Receive file(s) with MODEM7 Batch and CRC-16 (-c). SEE ALSO: MODEM7 batch protocol, Chapter 13. rb [-options] Receives with options 1 or more files using YMODEM batch protocol. The rb command also receives files sent with SEAlink protocol. Chapter 20 describes the available options. The pathname and length of each file are transmitted in batch mode. If a file is received in error (retries exhausted, etc.), the batch transfer will terminate. If Restricted, a file received in error will be unlinked (erased). (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 130 EXAMPLE: rb -y Receive file(s) with YMODEM replacing old files, if any. EXAMPLE: rb -g Receive file(s) with YMODEM-g. Many programs claiming to support YMODEM actually use XMODEM with 1024 byte blocks; use ZCOMM's sx -k, rx and rx -g XMODEM commands with these mutants. SEE ALSO: YMODEM protocol, Chapter 13. rb [-options] [dir] [file ...] Receives with options 1 or more files using YMODEM batch protocol. An optional disk and/or directory dir may be specified. The optional supplied pathnames file ... are used in place of pathnames normally provided by the sending program. If the sending program attempts to send more files than the number of names supplied to the rb command, the transfer is aborted. rc [-options] file Receives with options a single file using the Ward Christensen XMODEM protocol, 128 or 1024 byte blocks, and CRC-16 instead of an 8 bit checksum. ZCOMM signals the sending program that CRC-16 is to be used. After four errors while attempting to receive the first sector, ZCOMM will cancel the CRC-16 option and reverts to checksum operation. The probability of an undetected transmission error is much less if CRC-16 is used in place of the default 8 bit arithmetic checksum. Omen Technology Inc Recommends use of the 16 bit CRC to maintain data integrity at professional levels. Chapter 20 describes the available options to the rc command. If Restricted, a file received in error will be deleted. EXAMPLE: rc foo.com SEE ALSO: XMODEM-CRC protocol, Chapter 13. read [file] Read file into the circular buffer. Once in the buffer, it may be examined with the review command, searched for strings, and cut and pasted to other files. If file does not fit into the buffer, the buffer may be cleared with the kill command (or review k subcommand) and subsequent read commands may be given to read more of it. Review function commands are described in Chapter 23. EXAMPLE: read allsig.tmp SEE ALSO: BROwse, seek commands CAUTION: Iff a read command has left a transmit file open, entering the term function will transmit the unread portion of the file. To (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 131 prevent this, close the file first with ALT-C or closetx. receive Receives file(s) from a Kermit program. The other program must be commanded to send the desired files. SEE ALSO: get Kermit server access command remote Enter Host state with unrestricted privileges to allow the currently connected remote computer/terminal to issue commands. When activated by the remote command, Host state will reset when the modem carrier goes away. This command is useful for transferring files between two machines with directly connected serial ports. Remote may be prefixed with restrict to limit privileges.* SEE ALSO: host command remote cwd dirspec [password] Instructs the remote Kermit server to change to the specified directory. The form of dirspec varies with the remote system; it must be quoted if it contains special characters or spaces. A password may be required by the remote Kermit server. SEE ALSO: Kermit Protocol, Chapter 13. remote delete filespec Instructs the remote Kermit server to delete the specified file(s). The form of filespec varies with the remote system; it must be quoted if it contains special characters or spaces. remote dir dirspec Instructs the remote Kermit server to display the specified directory on your screen. The form of dirspec varies with the remote system; it must be quoted if it contains special characters or spaces. The resulting information may be redirected to a file with the >outfile command. remote help Instructs the remote Kermit server to display help information on your screen. The resulting information may be redirected to a file with the >outfile command. remote host host-command-string Instructs the remote Kermit server to perform the specified command and display its output on your screen. The form of host-command-string varies with the remote system; it must be quoted if it contains special characters or spaces. The resulting information may be redirected to a file with the >outfile command. EXAMPLE: remote host "kill -9 0" Terminates all your processes with extreme prejudice. SEE ALSO: !!command (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 132 remote print filespec Instructs the remote Kermit server to print the specified file(s) on the remote system. The form of filespec varies with the remote system; it must be quoted if it contains special characters or spaces. remote space [dirspec] Instructs the remote Kermit server to display the free space in the specified directory on your screen. The form of dirspec varies with the remote system; it must be quoted if it contains special characters or spaces. The resulting information may be redirected to a file with the >outfile command. remote type filespec Instructs the remote Kermit server to type the specified file(s) on your screen. The form of filespec varies with the remote system; it must be quoted if it contains special characters or spaces. The resulting information may be redirected to a file with the >outfile command. remote who Instructs the remote Kermit server to display the logged in users on your screen. The resulting information may be redirected to a file with the >outfile command. reset Write the contents of the circular buffer if a receive file is open, close all files, and reset the disk system. This allows swapping diskettes. reskeys Resets the Soft Keys to empty. SEE ALSO: set command restime * Resets elapsed time and counts of bytes transmitted and received to zero. The restime command may be given in a script immediately after login is completed to synchronize the elapsed time counter with the beginning of chargeable connect time. SEE ALSO: timestamp command, E test condition restrict * Restricts ZCOMM for the following command on the same line. This command is useful for testing. EXAMPLE: restrict source /menu.t RETurn Returns from a script subroutine accessed by a call, source, or gosub command. SEE ALSO: fail command rewind Reset the buffer pointers for display, printer, and file output used by the term function to the beginning of the circular buffer. This will cause the term function to redisplay the data in the circular buffer. Patterns will be rescanned. A typical use of the (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 133 rewind function is to allow replay of an editing session on a remote machine, or to redisplay the material received if the initial settings of the i, c, n or v modes were incorrect for the material received from the remote. N.B.: The rewind command does not reset the buffer free character count. To write the data to disk, a write command (or ALT-W) must be given before accepting new data from the remote. SEE ALSO: t, b, w review subcommands REView Review the data received from the host or read by the read command. A screenfull is displayed at a time. Review function commands are listed in Chapter 23. ro [-options] file Receives with options a single file using non- standard XMODEM-CRC protocol logic. OverThruster(TM) speeds file downloads at the expense of error recovery. OverThruster operation is controlled by the O numeric parameter. As fans of Buckaroo Bonzai know, the OverThruster is not universally applicable. A transmission error will almost always terminate an OverThruster file download. If Restricted, a file received in error will be unlinked (erased). EXAMPLE: ro foo.com SEE ALSO: O numeric parameter rt [-options] [dir] [file ...] Receives with options 1 or more files using Telink (FIDO) batch protocol. An optional disk and/or directory dir may be specified. The optional supplied pathnames file ... are used in place of pathnames normally provided by the sending program. If pathname(s) have been supplied to the rt command and the sending program attempts to send more files than the number of names supplied to the rt command, the transfer is aborted. The rt command is provided for compatibility with traditional programs that do not support the superior YMODEM or ZMODEM protocols. EXAMPLE: rt -c SEE ALSO: Telink protocol, Chapter 13. rw [-options] file Receives with options a single file using the People-Link WXMODEM protocol. Chapter 20 describes the available options. If Restricted, a file received in error will be unlinked (erased). EXAMPLE: rw foo.com (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 134 rx [-options] file Receives with options a single file using the Ward Christensen XMODEM protocol. CRC-16 is not the default because most commercial comms programs only support the 8 bit checksum. Chapter 20 describes the available options. If Restricted, a file received in error will be unlinked (erased). EXAMPLE: rx foo.com N.B.: The rc command should be used whenever possible instead of rx. EXAMPLE: rx -g foo.txt Receive a single file with an ACKless XMODEM protocol mutant incorrectly called "ymodem-g" by PCBoard and Qmodem programs. SEE ALSO: XMODEM protocol, Chapter 13. rz [-options] Receives with options 1 or more files using ZMODEM batch protocol. Chapter 20 describes the available options. Each file's pathname is obtained from the sending program. The +, a, b, n, N, r, and y options are accepted from the sending program, subject to Restriced privileges. If the +, b, n, N, r, or y option is specified to the receiver, it overrides any contrary options specified to the sender. Only one of the a, b, or r options may be specified. Only one of the +, n, N, or y options may be specified. If a file is received in error (retries exhausted, etc.), the batch transfer will terminate. If Restricted, a file received in error will be unlinked (erased). EXAMPLE: rz -y SEE ALSO: Z mode SEE ALSO: ZMODEM protocol, Chapter 13. rz [-options] [dir] [file ...] Receives with options 1 or more files using ZMODEM batch protocol. An optional disk and/or directory dir may be specified. The optional supplied pathnames file ... are used in place of pathnames normally provided by the sending program. If the sending program attempts to send more files than the number of names supplied to the rz command, the transfer is aborted. To allow use of the rz command, Z mode (ZMODEM autodownload) should be turned off with a dis -Z command. s Displays status information. LSR and MSR refer to the Line Status Register and Modem Status Register of the modem port's 8250 UART device. (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 135 TYP refers to the type of serial chip detected. A National 16550A shows as 1, an Intel 82510 shows as 2. Other chips (without high speed enhancements) show as 0. "Uncorrected errors" displays the e numeric parameter, which counts the number of failed file transfers and "line hits" detected by the term function. If one or more scripts are active, the current line number (counting from the first line in the script file) for each script level is displayed. Any patterns active as a result of a pattern or wait command are displayed. An S indicates not matched (still searching), F indicates that pattern has been matched. SEE ALSO: ALT-S function key s7 [-options] pathspec Send the files specified in pathspec using the MODEM7 batch Protocol. Files which cannot be opened are skipped. An empty pathspec sends all files in the current directory. A directory name expands to all regular files in that directory. If an error aborts a file transmission (retries exhausted, etc.), batch transfers terminate. EXAMPLE: s7 *.com Sends all *.com files N.B.: The receiver must be commanded to receive the files. This command is provided for compatibility with traditional programs that do not support the superior YMODEM and ZMODEM protocols. SEE ALSO: MODEM7 batch protocol, Chapter 13. sb [-options] [PREFIX=p | ONAME=x] pathspec Send the files specified in pathspec using True YMODEMTm Protocol. The pathname, length, and modification time of each file are transmitted. Files which cannot be opened are skipped. An empty pathspec sends all files in the current directory. A directory name expands to all regular files in that directory. If an error aborts a file transmission (retries exhausted, etc.), batch transfers terminate. The sb command will send files with SEAlink protocol if the receiving program requests SEAlink. EXAMPLE: sb -k *.com Sends *.com using 1024 byte packets. N.B.: The receiver must be commanded to receive the files with an rb command. Unix and OS/2 users: sb command cannot be used to send source files that grow after the beginning of transmission. (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 136 SEE ALSO: YMODEM protocol, Chapter 13, SEAlink protocol, Chapter 13. seek offset Iff a transmit file is open as a result of a f, open, or read command, position the file read pointer to offset bytes from the beginning of the file if offset is positive (or 0), or from the end of the file if offest is negative. "Seek 0" rewinds the file to its beginning. EXAMPLE: open baz; seek -20000; readHome Reviews the last 20000 bytes of baz. SEE ALSO: open, read, close send [-options] pathspec Send the files specified in pathspec with the Kermit protocol. The send command sends files to either a Kermit server or a regular Kermit program. EXAMPLE: send -a *.asm set[s|c] [[_]sparam string] Set String parameter sparam to string. As with all ZCOMM strings, the string must be enclosed by double quote characters if it contains spaces, tabs, or semicolons. Character escapes must be used to represent special characters, including return and linefeed if needed. An optional leading underscore (_) prepended to sparam causes the string to be cleared by the next call command. EXAMPLE: set mprefix ATDT sets the modem dialing prefix for tone (T) EXAMPLE: set f8 \PXXXXX Assigns a five character automatically generated password (\PXXXXX character escape described in Chapter ) to function key F8. Once programmed this way, the F8 key will transmit five nonsense characters determined by the xpassword string parameter and the remote system's name as stored in the remote string parameter by the last call command. EXAMPLE: set _f1 "logout\r" Assigns the string "logout" to F1 until the next call command. The parameters that may be set with this command are described in Chapter 25. Case is significant in parameter names. Set without any arguments will display all non empty string parameters and their values. If the v (verbose) numeric parameter is non zero, all string parameters are displayed. The echo and lput commands may be used to display string parameters ("echo %svar"). (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 137 The setc command performs string substitutions and character escape expansions on string before storing. The sets command performs string substitutions on string before storing. N.B.: Chapter 26 discusses string concatenation. EXAMPLE: sets s2 "%z1" Assigns the second token (%z1) generated by the split command to string parameter s2. If other commands are to follow on the same line, a semicolon must be used to separate the commands. EXAMPLE: set s1 "su"; goto sendit Would be illegal if the ";" were left out. A string parameter may be set to empty with set sparam "" (empty string enclosed by double quote characters). EXAMPLE: pv1; set Displays all string parameters, including all Soft Keys. EXAMPLE: sets s8 "s9 EQUALS %s9" Substitutes the value of string parameter s9 in the argument before assigning it to s8. SEE ALSO: echo, if, keys, reskeys, ALT-K, commands N.B.: When defining function keys to be called from within the term function, do not use the t or f commands. Instead use the create or open commands to prevent excessive term function recursion. Assigning a string to a function key with the set command causes that string to be sent to the remote when the key is used within the term function. If the string begins with @, the remainder of the string is executed as a ZCOMM command. EXAMPLE: set f3 "@rb" Assigns the rb command to F3. set[s|c] [_]sparam This form of the set command allows strings containing double quote (") characters to be defined. Given with string parameter sparam, but no string, set reads string from the next line verbatim, with only the trailing CR/LF removed. The line should not begin with a space or tab unless one is required for string. This form may be used for entering strings containing double quotes. If a script is active, the next line is read from the current script file, otherwise the user is prompted for it. N.B.: This form of the set command cannot be used as the predicate of an if command. The argument should not appear as a label or (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 138 telephone directory entry. EXAMPLE: set outahost @o; pk3; sp 2400; set disks "abcd"; putw "\336ATM0H1\r" Programs outahost to drop DTR ("o"), set 2400 baud, allow disks a,b,c, and d, and send an ATM0H1 (go off hook) command to the modem to busy out the telephone line. setn sparam expression The setn command stores as a decimal number the result of an arithmetic expression consisting of decimal numbers, string variables, the length of string variables denoted with %, and the operators +, -, *, and /. The expression is evaluated strictly left to right with 32 bit precision. EXAMPLE: setn vv 1+vv set? sparam condition The set? command stores a decimal number representing the result of a test condition. EXAMPLE: set? s0 S Stores the value of the S test condition (transmission speed) in string variable s0. sleep deci-seconds Sleep causes ZCOMM to pause for the specified tenths of seconds. This command may be used in a script with one or more put commands to login to a timesharing service. The presence of a character in the keyboard buffer will cause the sleep command to finish before the specified time. The maximum sleep time is 32000 tenths of seconds. Applications involving long sleep times may be better handled with the Host Operation callout queue. EXAMPLE: sleep 30 Pauses for 3 seconds. Soft Keys The Soft Keys f5-f12, fs1-fs10, fc1-fc10, fa1-fa10, fins, fdel, fhome, fend, fup, fdown, fleft, fright, fpgup, fpgdn, etc. may be programmed by set commands given in script files, including the "setup" entry in the distribution PHODIR.t file. The strings or commands assigned to these keys may be displayed with the keys or ______________________________________________________________________ 15. Because a failed if command would skip to the next line, the argument of the set command, and attempt to execute it as a script line. (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 139 ALT-K command. To get a current list of the available soft keys (and other string parameters), keyboard the following three commands: pv1 >keylist set close; pv0 source sourcefile Accept script commands from sourcefile. The source and call commands may be nested with up to six[16] scripts open at once. If the script has a READ ONLY attribute, ZCOMM is unrestricted during execution of the script.* Command lines in files accessed by the source command must begin with a tab, space, or label. Goto commands within sourcefile search for labels in the same sourcefile. Gosub commands within sourcefile access subroutines in the telephone directory accessed by the phones string parameter. EXAMPLE: bud source /usr/bin/caf/bin/callbud This telephone directory entry pat calls a separate script file containing commands to call a secret system. Placing this information in a separate file keeps it out of the main telephone directory file, which might be used on a number of computers. SEE ALSO: gosub command SPeed m Set the transmission speed ("baud rate") to m. If the speed specified is odd, or equal to 110, two stop bits are transmitted; otherwise one stop bit is transmitted. EXAMPLE: speed 1200 N.B.: Some older U.S. Robotics modems cannot accept the sustained full speed output ZCOMM is capable of. Using speed 2350 corrects such a problem with the U.S. Robotics Courier 2400. Some 1200 and 2400 bps modems work better (lower error rate) if the speed is set to slightly less than the nominal 1200 or 2400. This also applies to communications networks that cannot accept sustained __________ 16. Deep nesting may require a decrease in circular buffer memory allocation. (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 140 full speed data, and to serial ports whose bit rate clocks are slightly fast. EXAMPLE: speed 1181 Sets the speed to 1181 bits per second with two stop bits. NB: Timesharing minicomputers often transmit from their serial ports data at higher speeds than they can accept. In extreme cases, a timesharing port that supports interactive operation at 19200 bps may not tolerate file uploads above 2400 bps. NB: Operation at high speeds is affected by the operating system version, device drivers, memory resident software, and the computer's hardware design. Chapter 34 describes common problems encountered in high speed operation. The new generation NS16550AN/NS16550FAN serial interface chips with FIFO buffers should be used instead of 8250's or 16450's for best results at high speed. This is imperative if disk caches, special device drivers or TSR programs increase interrupt latency. SEE ALSO: 7e, 7o, 7m, 7s, 8n, 8g modes, handshake command split svar Split (parse) string parameter svar into tokens stored in string parameters z0...z9 using one or more of the characters in string parameter ifs ("Internal Field Separator") to separate the tokens. ** EXAMPLE: If string parameter s1 contains "hello there folks" and ifs contains a space and tab, split s1 Assigns "hello" to z0, "there" to z1, and "folks" to z2. EXAMPLE: Let s0 contain "#1234567-This is big-time Parsing", and ifs contain "#1256- ". The command split s0 Assigns "34" to z0, "7" to z1, "This" to z2, "is" to z3, "big" to z4, "time" to z5, and "Parsing" to z6. SEE ALSO: y0...y127 string parameters, I,i,p test conditions, sets command split svar string ... uses one string for each token generated. An empty string ("") assigns the rest of svar to the next token. Otherwise, if tokens remain after the strings are exhausted, ifs is used for parsing the remaining tokens. EXAMPLE: If s0 contains "#1234567-This is ZCOMM Parsing", The command split s0 "-" "" Assigns "#1234567" to z0 and "This is ZCOMM Parsing" to z1. (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 141 EXAMPLE: If s0 contains "503-621-3746", The command split s0 "-" "-" Assigns "503" to z0, "621" to z1, and "3746" to z2. SEE ALSO: ss command, scripts, Chapter 99 ss svar regular-expression String Split svar according to regular- expression. ** Regular expressions are described in Chapter 26. The entire matched string (if any) is stored in the z0 string parameter. Matched groups are stored in the z1...z9 string parameters. Parameters which do not receive a matched string or substring are set empty. EXAMPLE: If string parameter s0 contains From: Captain Midnight To: HBO Inc. then the command ss s0 "From: (.*) To: (.*)" places "Captain Midnight" in z1 and "HBO Inc." in z2. In this case, z0 will contain the entire contents of s0. SEE ALSO: split command, regular-expressions Chapter 26 st [-options] pathspec Send the files specified in pathspec using the Telink (FIDO) batch Protocol. The pathname, length, and modification time of each file are transmitted. Files which cannot be opened are skipped. An empty pathspec sends all files in the current directory. A directory name expands to all regular files in that directory. If an error aborts a file transmission (retries exhausted, etc.), batch transfers terminate. EXAMPLE: st *.com Sends *.com N.B.: The receiver must be commanded to receive the files. SEE ALSO: Telink protocol, Chapter 13. sum pathspec Checksums the named text files with an alogrithym compatible with sum(1) on Version 7 Unix (sum -r on System III/V). Carriage returns, and all characters starting with the first instance of CPMEOF (^Z) are excluded. This processing allows comparison of plain ASCII source files stored on the different systems, but not binary files. The checksum is printed in octal, followed by a count of 512 byte blocks and bytes read. EXAMPLE: sum *.c Checksums all C source files in the current directory. (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 142 SEE ALSO: crc, wc commands sx [-options] file Send a single file using the Ward Christensen XMODEM or XMODEM-CRC protocol. The receiving program may request use of a 16 bit CRC, which is more accurate than the default checksum. DOS/Unix files sent this way will have Control-Z (CPMEOF) garbage characters appended to make the file length a multiple of 128. EXAMPLE: sx foo.com EXAMPLE: sx -k foo.com Sends foo.com using 1024 byte blocks N.B.: The receiver must be commanded to receive the file with an rx filename or rc filename command. SEE ALSO: XMODEM, XMODEM-1k, XMODEM-CRC protocols, Chapter 13. sz [-options] [PREFIX=p | ONAME=x] pathspec Send the files specified in pathspec using ZMODEM Protocol.[17] N.B.: If the remote supports ZMODEM AutoDownload, or accepts rz followed by carriage return as a command to receive files with ZMODEM protocol, only the sz command need be given. Otherwise, the receiver must be commanded to receive the files with an rz command or menu choice. The +, a, b, n, N, r, y, and Z options are sent to the receiving program. Only one of the a, b, or r options may be specified. Only one of the +, n, N, or y options may be specified. Each skipped file is counted as an error as indicated by the e test condition and e numeric parameter. If the q option is used, files skipped as a result of selective file transfers are not counted as errors. The pathname, length, and modification time of each file are transmitted. Files which cannot be opened are skipped. An empty pathspec sends all files in the current directory. A directory name expands to all regular files in that directory. If ONAME=x is given after the options (if any) and before the file name(s), x will be used exactly as given as the COMPLETE destination pathname instead of each file's actual pathname. It is the sender's __________ 17. The receiver may use the sz command to send files by uploading an sz command with the zcommand command. (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 143 responsibility to use lower case for x unless the filename is really supposed to be all caps. EXAMPLE: sz -y ONAME=B:/spiked/secret /soviet/sdi/newlaser.doc Results in the destination file secret on drive B: in the /spiked directory. (Destination directories must exist and be writable). If instead PREFIX=p is given after the options (if any) and before the file name(s), p will be added to the destination pathname(s) as a prefix. It is the sender's responsibility to use lower case for p unless the prefix is really supposed to be all caps. EXAMPLE: sz -y PREFIX=C:/foobaz/ /biff/bam/aardvark.wak Results in the destination file "C:/foobaz/aardvark.wak" EXAMPLE: sz *.com Sends all files with a .com extension. EXAMPLE: sz -r ??log Crash Recovery sends only the new data if the receiver has incomplete versions of these files. EXAMPLE: sz -fn src/*.c src/*.h maildir Sends only newer .c and .h files in the src subdirectory, and all new files in the maildir subdirectory. EXAMPLE: zcommand "sz -fn /bin /wp" commands a remote ZCOMM system in Host Operation (unrestricted) to send all new files in the /bin and /wp directories. EXAMPLE: sz -Yn *.c Sends only newer versions of files that already exist at the destination. EXAMPLE: sz -Rf usera Sends all files in the usera directory and all subdirectories thereof. Directories are not sorted when the R option is used on 16 bit systems. SEE ALSO: ZMODEM protocol, Chapter 13, Options, Chapter 20. szb [-options] [PREFIX=p | ONAME=x] pathspec As above, but "falls back" to YMODEM if the receiver cannot receive files with ZMODEM protocol. Because of the YMODEM fallback, szb is not as error resistant as the sz command. (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 144 t [-modes] [capturefile] Invokes the term function for conversational access to the remote. Normally, ZCOMM will remain in the termfunction until the user keyboards F1. If capturefile is specified, any currently opten capture file is closed and capturefile is opened. A file previously opened by "t file" is not closed by a t command given without an argument. EXAMPLE: t file1 Creates file1 to capture data sent by the remote in interactive conversation. SEE ALSO: create command If a file upload begun by an f or open command were in progress, the upload will resume with the t command subject to the g mode. In host operation, "t file" begins data capture, and received characters are not echoed. When the remote sends ETX, EOT, or Ctrl-Z, file is closed and the term function exits. EXAMPLE: t comments.txt jabber ... jabber ... Ctrl-Z Optional modes may be enabled to modify the display, storage, or transmission of information. Subcommands available from the term function are explained in Chapter 22. Characters special to the term function are also described in Chapter 22. tcs M N The local display of ASCII characters can be remapped to suit local requirements with the tcs (Terminal Character Set) command, where M is the incoming character (1 to 127) and N is the desired hardware character 1 to 255. EXAMPLE: tcs 91 146 translates the ASCII [ character to the AE character. The command tcs by itself disables these translations but does not reset the translation table. The command tcs 0 resets the entries in the translation table. SEE ALSO: display command timestamp * Iff a capture file is open, write out the circular buffer. Then write a line containing the remote system name, number of characters transmitted from disk, the number of characters received (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 145 to disk, average characters received per second, [18] the date and time, and the term function status line information (time, modes, etc.) to the file and to the display. EXAMPLE: timestamp; echoc "End: %e Errors" Timestamp: vif 0 127857 97/sec 1342:37 07-09-86 01 24 13:42 21:50 28672 2:1200 7e EhjSt >cis0709.tmp Allsig Ends: 0 Errors The character counts are reset when the corresponding files are opened. SEE ALSO: restime, ALT-E commands, E test condition, t string parameter trs svar string1 string2 String1 and string2 are first processed for character escapes. Then translate string variable svar from the character set in string1 into the character set in string2. * Characters in String1 with no corresponding character in String2 are deleted. Characters in svar not appearing in String1 are not modified. The "trs" command may not be used in the body of a "while" command. EXAMPLE: trs s0 "\\{}" "/" Changes backslashes to slashes, and removes "{" and "}" characters. TYPe pathspec Type the specified file(s). This command closes any open transmit file. ZCOMM automatically detects SQueezed files and prints them in ASCII.* Type pauses/resumes printing with ^S. Keyboarding ^C or Ctrl-Break cancels, and ^X skips to the next file. clears the screen without pausing, avoiding scrolling. SEE ALSO: browse, list, page commands, Unix b, bro, typ commands EXAMPLE: type *.txt *.doc unrestrict Prompts for a password and unrestricts ZCOMM if the password exactly matches the contents of the unrestrict string parameter. If unrestrict is empty or the given password does not match in three attempts, the call is immediately terminated. Unrestrict is used in Host Operation by a caller who wishes unrestricted access to ZCOMM's computer to view confidential files or perform maintenance. __________ 18. Since the last call or restime command. (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 146 EXAMPLE: unrestrict Prompts for a password (to match the unrestrict parameter), then allows three tries to enter it correctly. SEE ALSO: Host operation usq pathspec * Unsqueeze the specified files back to their original form. If pathspec is empty, ZCOMM checks all files in the current directory and unsqueezes those that are found to be SQueezed. If pathspec contains the name of a directory, all files in that directory are checked. Iff a file has not been SQueezed, ZCOMM will complain and proceed to the next file. ZCOMM checks the first word of the file(s) to determine whether that file is SQueezed. If the SQueezed file has been encrypted, such as a Demand Upgrade(TM) copy of ZCOMM, ZCOMM will fetch the key file relative to the current directory for use in decrypting. N.B.: The original pathname and the keyfile pathname (if present), stored in the SQueezed file is interpreted relative to the current directory. EXAMPLE: cd /tmp; usq a: Unsqueezes all the SQueezed files on A:, placing the output files relative to /tmp. EXAMPLE: usq ZCOMM.EQE Unsqueezes an encrypted Demand Upgrade(TM) copy of ZCOMM. The key file (such as yampc08.key) must be in the current directory. videobios N Sets the video BIOS mode to N. This command is useful for accessing the high resolution super EGA display text modes, such as 100 columns by 75 lines corresponding to high resolution 800x600 displays. The $ and # numeric parameters must be separately set to agree with the new BIOS video mode. The action of the video ROM BIOS to specific values depends on the particular EGA/VGA ROM BIOS used. To support boards using an extended code in the bl register, calculate N = bl + (256 * al). Some codes produce spectacular unpredictable results. This command is restricted, and is available on medium model DOS flavors only. EXAMPLE: videobios 3 Sets BIOS video mode 3 (80x25). SEE ALSO: V and W numeric parameters w Writes the contents of the circular buffer to the capture file. wait [-mode] Wait activates the term function to search for each pattern that has been defined with the pattern command. If a file (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 147 has been opened with the create or t file commands, buffer capture continues during the wait command. If a file upload (inititated by an f file command) was in progress, the upload will resume with the wait command subject to the g mode. Script execution resumes when the wait command returns because of a pattern match, timeout, no carrier detect, or keyboarded F1. The wait command's pattern search timeout is effective even if no search patterns have been set with the pattern command. SEE ALSO: pattern, put, putw commands, fN mode wc pathspec Counts lines, words, printing characters, and all characters for the specified files. The totals are then presented. Characters beginning with CPMEOF (^Z) are excluded.[19] The count of printing characters is useful for estimating laser toner and printer ribbon usage. EXAMPLE: wc *.c *.h SEE ALSO: crc, sum commands while condition rest-of-line Scripts must often repeat a command or set of commands while some condition remains true. The while command executes the command(s) on the rest of the line while condition is true. Chapter 27 describes testable conditions. An inadvertently generated while loop may be stopped by keyboarding NUKE (ALT-N). N.B.: The rest of the line must not contain an if command or semicolons separating commands. While commands may not be nested. EXAMPLE: pat 1 "ogin:"; while !1 put "\r" wait -f1 Repeatedly sends a carriage return until the remote responds with "Login:".[20] EXAMPLE: while "!1&&L<5" put "\r" wait -f1 Works as above, but only tries 5 times. __________ 19. The line and word counts agree with the Unix word count program, but the character count will differ because of CR characters not stored in most Unix text files. The Unix word count program does not have a count of printing characters. 20. The "L" in "Login" is not searched for on purpose. On Unix systems, the "l" is not always capitalized. (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 148 x (eXit) Writes and closes any open files, releases ownership of the serial port, then exits to the operating system without disconnecting the phone line.[21] Exit status is the value of the ? numeric parameter. This command is not allowed if Restricted. xpc ... * The ZCOMMXPC flavor of ZCOMM supports the Tymnet(TM) X.PC link level protocol with the xpc commands. See a following subchapter of Chapter 19 for a more detailed description of the X.PC packet driver and the xpc commands that control it. zcommandi COMMAND Send COMMAND with ZMODEM protocol, do NOT wait for command completion. EXAMPLE: zcommandi "!make whoopie" zcommandic COMMAND Process COMMAND for string substitutions and character escapes and send with ZMODEM protocol, do NOT wait for command completion. zcommandw COMMAND Send COMMAND to the remote with ZMODEM protocol. ZMODEM assures an error free command upload. Wait for COMMAND to complete on the remote. Store the command's exit value in the ? numeric parameter, available to the ? test condition. N.B.: With the exception of sz, no command that involves the serial port may be the argument of zcommand. EXAMPLE: zcommandw "sz foo.bar" Causes the remote to send a file with ZMODEM protocol. EXAMPLE: zcommandw "!ls -l | sz -a -" Causes a remote Unix system to send a file containing a directory listing to ZCOMM. As a special case, zcommandw with an empty command fetches the remote's disk file system free character count. This quantity is then available to the R test condition. EXAMPLE: zcommandw ""; if "R>10000" sz hugefile Fetches the free disk space from the remote, and sends hugefile if the destination's free space is greater than 10000 kilobytes. __________ 21. On some Unix systems, the operating system may alter the state of the serial port after ZCOMM exits. (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 149 zcommandwc COMMAND Process COMMAND for string substitutions and character escapes and send with ZMODEM protocol, wait for command completion. zmodem Used as a prefix to the p command to select the "zmodem" parameters, or by itself to select the ZMODEM protocol for commands which operate in a choice of protocols depending on past history. EXAMPLE: zmodem !!sz *.* Uses ZMODEM to send a command to the remote machine to send all the files in its current directory. _ Enter a diagnostic routine that prints information about each keystroke entered. Keyboarding LF (Ctrl-Enter) exits the _ (underscore) command. When a key is struck, the scancode, modified scancode, and the shift state are displayed in decimal. The modified scancode is either the raw scancode as returned by the BIOS or 224 added to the ZCOMM internal code iff the raw scancode equals 224. The ZCOMM internal code for the key (usually the ASCII value) is displayed in octal. This command may be used for exploring keyboard encoding and preparing alternate keyboard mappings for use with the mk command. SEE ALSO: mk command ![%][~]command Execute command (either a program or a DOS built-in command) as a subprogram. A leading % (percent sign) processes Command for string parameter substitutions. See Chapter 19.6 for details on DOS Gateways and Unix Shell Escapes. SEE ALSO: obey command !!host-command Sends the rest of the line (after !!) to a remote ZMODEM program or Kermit server for execution on the server machine. host-command is not processed for string parameters. This is a convenient alternative to remote host host-command-string particularly if host-command contains spaces. label: A label begins at the first column and ends with a colon. One or more commands may appear on the same line separated from the label by white space. A label may have the same name as a directory entry provided the directory entry appears first in the script file. N.B.: a label differs from a directory entry, which doesn't end with a colon. When ZCOMM encounters the next directory entry in script processing, an automatic "return" is performed. EXAMPLE: if 1 goto cond1 echo "Pattern 1 not matched" (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 150 cond1: echo "processing continues" foosys speed 2400 666-1234 t :comment A colon as first character in a command causes the rest of the command line to be ignored. This is also useful for "commenting out" commands in script files. EXAMPLE: : this line does nothing at all ; Semicolon is a command delimiter which may be used in place of RETURN to place multiple commands on a line. Since commands such as echo, set, sb, pattern, list, and type take an indefinite number of operands, the semicolon must be used to string such commands together. EXAMPLE: sb *.c; off Batch transmits all *.c files, then puts the modem on hook and exits to DOS. Semicolon is not a command delimiter if it is escaped by a backslash or if it appears within a quoted string. EXAMPLE: pat 0 ";" Sets pattern 0 to search for a semicolon. Commands that take a fixed number of arguments may be strung together without a semicolon unless otherwise noted. EXAMPLE: port 1 speed 1200 [>]outfile Redirects output from succeeding utility commands and debug output (if the v numeric parameter is non zero) to outfile. Capture from the circular buffer is also enabled, but there is no automatic writing of the circular buffer to the file on close. >>outfile appends to outfile. The output redirection is canceled by the close command or by > without a filename. DOS predefined device names such as "prn" may be used. (C) 1990 Omen Tech Inc Chapter 19 Main Commands