Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 91 set[c|s] ........................Set string parameters / soft keys setn ............................Set string param to Arithmetic expression set? ............................Set string param to test value sleep ...........................Let the world pass by source scriptfile ...............Call scriptfile as a subroutine split ...........................Split (parse) a string to tokens ss ..............................Regular Expression pattern match string parse trs .............................Translate characters in a string wait ............................Wait for pattern(s) in modem data while ...........................Looping control (C) 1990 Omen Tech Inc Chapter 17 Special Keys Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 92 18. SPECIAL KEYS Ctrl-Break clears any typeahead, unlocks the keyboard, and stops whatever function[1] ZCOMM is doing in a reasonably orderly manner.[2] Ctrl-Break cancels kbdlock. It is not so abrupt as the NUKE key. The B test condition tests whether Ctrl-Break has been struck since the last purgek command. Keyboarding ALT-N will NUKE (abort) the current command and return to ZCOMM's command prompt.[3] If one or more scripts are active, the current line number (counting from the first line in the script file) for each level of script is displayed.* NUKE will terminate any script. NUKE closes any transmit file, but not a receive capture file. (A receive capture file may be closed with the "close" command.) NUKE does not disconnect the modem by dropping DTR.[4] Keyboarding ALT-Z appends the contents of the display screen to a DOS file. The pathname is contained in the string parameter picture which may be changed with the set command. The exact contents of the screen memory are written to the file, with each screen character followed by its attribute. A separate program, unpic is used to convert the screen dump to a normal file that may be printed or displayed. 18.1 Special Keys during Protocol Transfers Certain keys perform special functions when keyboarded during protocol file transfers (XMODEM, Kermit, etc.). F1 Keyboarding F1 causes a protocol timeout and forces a retry. ALT-A Displays Kermit file transfer status. ALT-B Cancels the current Kermit or ZMODEM batch transfer. __________ 1. Not necessarily the calling function or script 2. In the term function, Ctrl-Break sends a break to the remote unless it has been redefined with a set command. 3. Use of this term, popularized in the J.F.K. administration, does not imply endorsement of preemptive nuclear attacks on innocent populations. 4. When in host operation waiting for a call, NUKE drops DTR. (C) 1990 Omen Tech Inc Chapter 18 Special Keys Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 93 ALT-C Cancels the ZMODEM or Kermit session. ALT-F Skips the current ZMODEM or Kermit file transfer. ALT-Q Keyboarding Alt-Q during a protocol file transfer toggles a flag that causes ZCOMM to disconnect when the transfer is completed. This is most useful when downloading a long file. As soon as the file is transferred, ZCOMM will execute the string parameter quitcmd (if set) and then disconnect the modem. If keyboarded during a Host Operation file transfer, ZCOMM will exit Host Operation at the conclusion of the transfer. The state of the quit flag is displayed each time ALT-Q is keyboarded. ALT-S Keyboarding Alt-S displays status information on the console screen only (even if in Host Operation). The pattern number of the last successful search (-1 if no match), the active search patterns (if any), and the line numbers of the active scripts (if any) are displayed to aid script debugging. ALT-V Keyboarding ALT-V will toggle the view option affecting the rb, rc, rz, sb, sc, sx, and sz commands, and data transfers using the Compuserve B protocol. ASCII Keyboarding a normal ASCII character (in the range of 00 to 7F) will send that character to the modem. This may be used for protocol testing, or to terminate a modem's autodial handshake without terminating ZCOMM's call retry count. Ctrl-X All ZMODEM and many YMODEM and XMODEM protocol programs recognize a dozen successive Ctrl-X characters as a session abort command. If the remote computer appears to be "stuck" in a YMODEM or ZMODEM transfer, keyboard ten Ctrl-X characters to abort the protocol transfer. During a protocol transfer, normal keys are sent to the modem when Zcomm is waiting for or receiving a packet. This may be used to reissue a file transfer command to the other computer if it becomes apparent the original command was not accepted. Other uses for this pass thru capability include protocol testing. 18.2 Local Editing Keys Emacs style character editing reduces the number of keystrokes needed to enter and edit commands and strings. Normally the cursor is at the end of the line of text being keyboarded. Printing characters insert themselves at the cursor location. The key enters/transmits the entire line of text. (C) 1990 Omen Tech Inc Chapter 18 Local Editing Keys Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 94 Left, Ctrl-B moves the cursor to the left Right, Ctrl-F moves the cursor to the right Ctrl-Left cursor WORD left Ctrl-Right cursor WORD right Ctrl-A cursor to beginning of line Ctrl-E cursor to end of line Del, Ctrl-D delete character at cursor Backspace delete character to left of cursor Ctrl-W delete word to left of cursor Ctrl-End, Ctrl-K delete to end of line Ctrl-R refresh (redisplay) the line Ctrl-X delete entire line Down, Ctrl-N next history line Up, Ctrl-P previous history line Ctrl-U Argument Count (not available in term function) An initial Ctrl-U sets an argument count of 4. Successive Ctrl-U characters multiply the argument count by 4. A decimal number may be entered after Ctrl-U, and this number becomes the argument count. EXAMPLE: ^U^U Left moves the cursor 16 left EXAMPLE: ^U5X inserts 5 "X" characters EXAMPLE: ^U5^U? inserts 20 "?" characters. Unix/Xenix flavors do not support Emacs style editing in the term function. (C) 1990 Omen Tech Inc Chapter 18 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 95 19. MAIN COMMANDS All commands and arguments must be entered in lower case except where stated. You may shorten some commands by typing just the first portion that is shown in caps. For example, the "break" command may be entered as "br". Whether or not you abbreviate the command, it must be entered in lower case. User defined Soft Keys are executed from the command prompt iff they do not conflict with the permanent definitions described below. Except where stated, multiple commands can be written on one line separated by ; (semicolon). Commands that take a constant number of arguments do not need a semicolon to delimit the end of the command. If in doubt, use a semicolon to separate multiple commands.[1] @ The at sign may be used to indicate a telephone number starting with the Touch-Tone(TM) A B C D * or # codes or a character escape. If the phone number contains spaces, it must be enclosed in double quotes. The leading @ is not sent to the modem. EXAMPLE: @#*-123-4567 Dials #*-123-4567. %l-234-567-8901 (%l:letter l) For normal long distance dialing, the string parameter l (letter l) defaults to "1" (digit 1). To use an alternative long distance service, set the l string parameter with a modem command to dial the local access number, wait for the second dial tone, and transmit the account number. SEE ALSO: "setsavenet" telephone directory entry A string of alternate phone numbers may be specified with the "+" construction shown below. 234-5678 A number given as a command invokes the dial script to attempt a connection with the specified number. Iff the modem is currently connected to a remote modem, and the B numeric parameter is non zero, ZCOMM pulses Data Terminal Ready, terminating the connection. ZCOMM character escapes may be used within the number string to represent special characters. __________ 1. A space or two after each semicolon makes scripts easier for humans to read. (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 96 EXAMPLE: 234-5678 When carrier is detected, ZCOMM executes the mconnect string (if set) and proceeds to the next command One or several alternate phone numbers may be specified by appending the previous number with +234-5678 for as many alternate numbers as are desired.[2] When a connection is made, undialed alternates are forgotten. Alternate phone numbers need not support the same speeds. A redial count given to the call command repeats the sequence of alternate numbers. EXAMPLE: cis speed 2400 239-6124/mnp_s+239-6126/mnp_s+232-1032/300 This script line attempts a MNP (with software slow control) call to the first two numbers, then a 300 bps call to the third number if neither of the first two connected. Iff no connection is made, script processing at the current level is terminated. A number of modifiers are available depending on the type of modem and the choice of dialing script used. These are described in Chapter 9. SEE ALSO: nolog command, calllog string parameter, mcommand string parameter a: Change the default disk to a:. ZCOMM then prints the free storage remaining on the selected disk. The specified disk must be included in the string parameter disks. abort Aborts any command or script in progress. Closes all script files that may be open. Abort returns to the command prompt. SEE ALSO: quit command accept[[l]1] stringvar prompt (letter l, digit 1) Scripts often need to prompt the user for file names and menu choices. Accept displays Prompt[3] to the user. ZCOMM then reads keyboard __________ 2. When using the mm224 dialing script. 3. Prompt must be enclosed in quotes if it contains spaces. (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 97 input into the specified string variable. Backspace and Ctrl-U perform editing functions. Characters are accepted from the user until is typed. If the H numeric parameter is non zero, an empty string is returned if is not typed within the time limit set by that parameter. Acceptl translates the user's response to lower case. Acceptl1 returns a 1 character string in lower case after the single character is keyboarded. Prompt is processed for string substitution and character escapes. If the result begins with an ESC character, ZCOMM does not reposition the cursor before accepting the string. In writing scripts, it may be useful to save the current screen location with an escape sequence, then restore it with an escape sequence encoded in the prompt string. EXAMPLE: accept s1 File: Displays the prompt File: and reads the keyboarded response to string parameter s1. EXAMPLE: acceptl1 s0 "Enter Menu Choice" Reads a single character from the user, translates it to lower case, and assigns it to s0. EXAMPLE: accept s0 "\E[20;60H\E[KFile Name: " Places the cursor at line 20 column 60, clears the rest of the CRT line, displays the prompt, and accepts input. EXAMPLE: accept s6 " Your \E[1mFirst\E[0m name please " Uses boldface video to highlight First as it appears in the prompt. EXAMPLE: accept s2 "File "; rc %s2 Prompts the user for a file name, then receives that file with XMODEM/CRC protocol. EXAMPLE: accept xpassword "\E[mMaster Password: \E[8m"; lput "\E[m" Uses invisible video (ESC [ 8 m) to allow a password to be entered without visible echo. The ESC [ m sequences reset the display to normal (visible). SEE ALSO: obey command, scripts ap file1 file2* (Append) Appends the contents of file1 to file2. If file2 does not exist, it is created. Wildcards are not allowed. The ap command closes any files that have been opened by the create, f, open, t or > commands. File1 and file2 are processed for string parameter substitution. (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 98 apd file1 file2* (Append-Delete) Appends the contents of file1 to file2, then deletes file1. If file2 does not exist, it is created. If an error is detected writing file2, file1 is not deleted. Wildcards are not allowed. The apd command closes any files that have been opened by the create, f, open, t or > commands. File1 and file2 are processed for string parameter substitution. EXAMPLE: apd %item Z%item.tmp bdump outfile Dumps the contents of the modem interrupt input buffer to outfile. This command is useful for debugging as outfile will contain the last characters received from the remote regardless of what ZCOMM commands have been executed. The most recently received data appears at the end of outfile. This command "tells it as it is", writing all 8 bits of each character to outfile. If few characters have been received from the remote, some of outfile will consist of nulls or garbage. The bdump command is often used as a post mortem diagnostic dump after a failed script or file transfer. This command is not available on OS/2, and X.PC flavors of ZCOMM. bg Indicates ZCOMM is running in the background with no user at the keyboard. SEE ALSO: fg command, df test condition BReak Sends a 200 millisecond break signal. N.B.: Some modems do not correctly pass the break signal to the remote. SEE ALSO: Ctrl-Break key, break string parameter, zmodem B numeric parameter BROwse pathspec Browse through the files specified in pathspec. If pathspec is empty, all files are presented. For each matched pathname, the filename, date, and length of the file are displayed. The status line displays some of the commands which may be applied to each file. Chapter 19.4 describes the browse subcommands, which provide extensive capabilities for individually selected files. bye Terminate the connection in progress by sending a long space and then dropping DTR (Data Terminal Ready).[4] After a pause, DTR is reasserted to allow the modem to originate or answer another call.[5] __________ 4. The modem must be configured to use Data Terminal Ready (DTR). 5. Most dialing scripts include an initial bye command to make sure (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 99 SEE ALSO: o, off commands call [-N] [name][.path][,modifier] Prepare ZCOMM for a new task and invoke an entry in the Phone Directory. The 7, A, a, b, C, c, E, e, g, H, h, i, j, n, o, P, p, q, r, S, s, t, u, v, w, X, x, Z, and z modes are reset. The d mode is set. The e, f, g, k, m, p, q, t, w, Kermit 8, zmodem C, e, l, L, p, t, T, w, and W parameters are reset to their default values. The search patterns are erased. Permanent string parameters set with the set _svar command are set to empty. If path has been specified, it is searched for a line beginning with name. Otherwise, ZCOMM searches the telephone directory. An optional modifier (string with a leading comma), if specified, is not used in the directory search. If the search is successful, the entire directory entry name is copied to the remote string parameter. The complete argument entered on the command line is stored in the args string parameter visible to the called script. If the script has a READ ONLY attribute, ZCOMM is unrestricted during execution of the script. ZCOMM then executes the commands on the rest of the line (if any), and on succeeding lines beginning with a space or tab. If the v numeric parameter is greater than zero, each command from the file is displayed on the screen before it is executed. It is not necessary to type the entire name as it appears in the telephone directory, as ZCOMM will find the first entry that name is a prefix of. Iff name is empty, execution begins with the first line of path. EXAMPLE: call cis1200 call cis1 call cis.C:/newscript EXAMPLE: call genie,upl Invokes the genie telephone directory entry with the modifier ,upl available to the called script. The call command is not limited to making connections. For example, "call host" in the distribution PHODIR.t file conditions a Hayes compatible modem to answer incoming calls silently, set parameters, and activates ZCOMM's host operation. ______________________________________________________________________ any previous call is disconnected. (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 100 Most directory entries include a telephone number to dial. If ZCOMM is used with an autodial modem, the number of retries N (default none) may be specified. EXAMPLE: call -40 cbbs-r Attempts 40 retries before giving up. The interval between retries is set by the i numeric parameter. EXAMPLE: pi4 Sets the interval between retries to 4 seconds. Words To the Wise: Abuse of the retry feature by continually calling busy numbers may incur the wrath of the Telephone Company. Especially with Message Unit Accounting, Big Brother may be watching your telecommunications habits. Some long distance services (MCI, Sprint, AT&T, etc.) charge for unsuccessful calls, especially if the phone is allowed to ring (or ring busy) for more than a few seconds. Consult your telephone company about legal limits to the number and frequency of retries. Since some computer services will disconnect within a short time if no login is attempted, you should start communicating as soon as the modems are connected. ZCOMM sounds the bell after making the connection if retries have been specified. The source, gosub and call commands may be nested with up to six command/phones file descriptors open at once.[6] A label may be the target of a call command provided the trailing colon is included in name. cat pathspec For Unix users, a synonym to the type command (q.v.). cd [dir] Change to directory dir. If Restricted, dir is checked for a parent directory ("cd .."), and absolute paths ("cd /src") not prefixed by the home string parameter. Giving cd without an argument changes to the directory stored in the home string parameter.[7] ZCOMM then stores the current directory in the pwd string parameter and displays it unless the v numeric parameter is less than 0. EXAMPLE: cd /tmp __________ 6. Deep nesting may require a decrease in the circular buffer memory allocation, see Chapter 16. 7. The home parameter is set to the current directory when ZCOMM is invoked, but may be changed with the set command. (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 101 N.B.: When operating restricted, the home string parameter must point to a valid directory in order to enforce the intended directory path restriction. SEE ALSO: cdd and pwd commands, home and pwd string parameters cd D:dir When a disk drive is specified with the cd command, the current directory on that drive is changed but ZCOMM remains logged in on the current drive and directory. If Restricted, dir is checked for a disk drive ("cd b:/foo") not contained in the disks string parameter. EXAMPLE: cd D:/tmp cdd D:dir Change to (log in to) disk D and then to directory dir on the specified disk. If dir is not specified, the root directory is assumed. ** This is a shorthand equivalent to a D: command followed by a chdir dir command. SEE ALSO: cd command chat Enter the term function to chat keyboard to keyboard. Characters typed by either keyboard are echoed to both ends, and RETURNS echo as RETURN/LINEFEED. In Host Operation, chat exits if the caller types Ctrl-Z. Chat will become hostile if the other end also echoes characters. (Try it sometime on a timesharing system; it's fun.) close Writes the contents of the circular buffer iff a receive file is open, then closes the receive and transmit files. ZCOMM complains if no files were open. SEE ALSO: nolog command closerx Iff a receive file is open, writes the circular buffer then closes the receive file. SEE ALSO: nolog command closetx Closes the transmit file, if it is open. SEE ALSO: nolog command cl Clears the screen. cls Resets display modes and clears the screen. CONFerence Enters the term function with a 1 line window for composing commands and text. Chapter 22.5 gives details. (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 102 crc pathspec Print the CRC-32 and character count for the specified files. The crc command verifies the identity of two (or more) copies of a file. Iff the lengths and CRC-32's of two files are the same, the files are almost certainly identical. Comparing files with the crc command is faster than transmitting a second copy for character by character comparisons. EXAMPLE: "crc", "crc *.c" HINT: To generate a file containing the CRC's of the files in the current directory: >crc.lst crc *.* close After the files are copied, run the commands above (with a different file name), then compare the two files with DIF.EXE to detect any that have changed. SEE ALSO: sum, wc commands Source for a public domain Unix/DOS version of CRC is available. create [-modes] outfile If a receive capture file is open as the result of a create or t filename command, write the circular buffer and close it. Then create outfile for use with the term function with modes. The create command is especially useful when you don't want to enter the term function immediately. EXAMPLE: create -ys /tmp/cbbs.tmp[8] SEE ALSO: > command createx outfile Similar to the create command, but does not open outfile if a file with the same pathname already exists. The resulting error message may be suppressed by setting the v numeric parameter negative. Scripts may test for success with the r test condition. The createx command may be used to manage semaphores to lock resources or work entries used by multiple instances of a program. The createx command is available on Unix and OS/2 flavors. SEE ALSO: kill command __________ 8. The y mode overwrites any existing file with the same name. The s mode strips most control characters from the resulting disk file. (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 103 del pathspec Delete the specified files. No message is printed if one or more of the specified files could not be deleted. No confirmation is requested for mass deletes. WARNING: As with all ZCOMM pathspec specifications, a directory name expands to all files in that directory. N.B.: Do not attempt to delete an open file on DOS, especially the history file. SEE ALSO: browse command demand password Scripts must often verify a caller's identity by asking for a password. The ZCOMM password command allows a caller three chances to enter a given password. Failure results in disconnection. Password is processed for character escapes and string substitutions. All security restrictions on string parameters are enforced. If the result is empty, no password is demanded. Otherwise the user is prompted to enter a string matching password in the correct case. Keyboard input is not echoed. Three attempts to enter password are allowed. If the password is not correctly entered, DTR is pulsed to force the modem to disconnect the caller, and the ? numeric parameter is set negative. EXAMPLE: demand %password Requires the caller to enter a string matching the contents of the password string parameter. dir pathspec Display pathnames matching pathspec alphabetized across the page. Wildcard filename expansions are alphabetical. EXAMPLE: dir EXAMPLE: dir y*.c *.h dirr pathspec Displays the directory with length and creation date of each file. dirr displays the number of files matched, number of blocks, number of kb in those files, and estimated transmission time at the current transmission speed assuming the fastest protocol available (ZMODEM or YMODEM-g). XMODEM and Kermit transfers take longer than the displayed estimates. Wildcard filename expansions are alphabetical. dird pathspec Long Form directory, sorted by date. (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 104 dirt pathspec Long Form directory, reverse sorted by date. dirl pathspec Long Form directory, sorted by file length. dirs pathspec Long Form directory, reverse sorted by file length. dirx pathspec Long Form directory, sorted by file extension. DISable{-modes} Disable mode(s) affecting the term function. Chapter 21 describes modes affecting the term function. EXAMPLE: dis -t Disables throttle (t mode). display [[no]dismode] ... Without an argument, prints the display modes. Display modes preceded by NO are turned off. With one or more arguments, turn on the specified display mode(s). If an argument is preceded by no, the specified display mode is turned off. If an emulation is specified, it must be the first argument. display command argument changing the terminal emulation (vt100, lsi-adm3a, 3101, dumb) disables nlmode and overstrike. The display modes are: vt100 Emulate DEC VT-100 and VT-102 display codes and most Teletype 5425 codes. VT-52 and Zenith H-19 codes are the default. SEE ALSO: 101.MK,STD.MK, script files lsi-adm3a Emulate Lear Siegler ADM3a and Televideo 9xx control codes. dasher Emulate Data General Dasher terminals. 3101 Executes IBM 3101 and TI 940 escape codes. wyse Emulate Wyse terminals in native mode, allow switching the keyboard to keyscan mode. SEE ALSO: WYS.MK script file dumb Only null, bs, tab, cr and lf are executed, all others display. As in real life, dumb takes precedence over vt100, vt52, and lsi-adm3a emulation. inhibit Inhibits the display (nothing prints). SEE ALSO: Q mode (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 105 nlmode Received newlines (linefeed) display as return/linefeed. The Enter key is sent as CR/LF. bell=visual Instead of sounding on the speaker, bell characters cause flashing notes to appear on the screen. overstrike Overstruck characters are displayed in bold face or underline (reverse video on CGA) as appropriate. autowrap The 81st character prints on a new line with possible scrollup. rautowrap Allow a backspace from the lest margin to reverse wrap to the last character position on the previous line. 8bit Decode 8bit control characters and G1 character set. stat=off Disables ZCOMM's status line. warpdrive Provides higher display speed without scrolling flicker, but causes noise (snow/chromablizzard) with CGA display adapters. mapkb Allow escape codes from the remote or a file to active alternate keyboard mapping. The keyboard mapping is defined with a series of mk commands, such as those contained in the std.mk (standard keyboard) or 101.mk (101 key extended keyboard) files. Other XXX.mk files may be provided; the first few lines of these files indicate the keyboard configuration they set up. ZCOMM comes initialized with the std.mk mapping, which requires NumLock to be on. EXAMPLE: source std.mk Defines a VT100 keyboard mapping for standard PC and PC-AT keyboards. The term function keyboard mapping enabled by the mapkb command may override some ZCOMM functions. A display nlmode nobell=visual Turns on nlmode display mode and turns off the visual bell. EXAMPLE: display vt100 Enables VT100/VT102 emulation used by many computer systems. SEE ALSO: tcs command dump pathspec Dump the named files in a side by side hex/ASCII format, similar to the CP/M users' group DUMP program. The ending character number is also displayed. Zero length files are not displayed. (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 106 echo[c|f] [-n] string Echo a line containing a single argument string in reverse video. The optional -n suppresses reverse video and linefeeds. Tabs should not be used with the echo command. The echoc command also echoes its argument to the capture file (if open), without reverse video. The echof command echoes its argument to the capture file only. EXAMPLE: echoc "File not Accepted" Outputs a line to the screen and to the capture file. EXAMPLE: echo "Dave, This conversation can serve no further purpose." Displays a line on the screen only. SEE ALSO: lput command, r numeric parameter, character escapes egrep[m] regular-expression pathspec ** Display lines in the specified files matching regular-expression. Regular Expressions are discussed in Chapter 26. The egrepm command finds a line matching regular-expression in each of the specified files, and then pages through the file beginning with the matched line. At the end of each screen, ZCOMM accepts the same subcommands used with the findm command. EXAMPLE: egrep "^Subject:" *.* Displays all lines that begin with "Subject:". SEE ALSO: findmore command The egrep implementation does not strip the trailing CR/LF from lines read from the disk. This affects use of the $ regular expression magic character. When using the $ magic character, the CR/LF at the end of normal lines must be represented as "..$". egrepq regular-expression pathspec ** Silently searches the specified files for the first line matching regular-expression. Upon a successful search, the contents of this line are stored in the z0 string variable and the ? numeric parameter is incremented. The egrepq command is useful for fetching password information from a disk file. SEE ALSO: obey command, findq command else Execute the command(s) on the rest of the line if the last if test performed on the current script level was false. N.B.: While else statements in programming languages are connected to a particular if statement according to syntax, the connection in ZCOMM is to the last if statement executed on the level, regardless (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 107 of goto's. ENAble {-modes} Enable mode(s) affecting the term function. Chapter 21 describes modes affecting the term function. EXAMPLE: ena -h Enables half-duplex (local echo) Half-duplex mode causes the term function to display keyboarded characters. estimate length [speed] Use the specified length and optional specified effective speed when displaying information for the next receive file. A length of 0 bypasses the length substitution. Once a speed (in effective bits per second) is given, it is used for all locally displayed transmission time calculations until the next speed or port command. EXAMPLE: estimate z2 Uses the file length stored in string variable z2 in calculating the transmission time estimate for the next received file. EXAMPLE: speed 19200; estimate 0 2400 Use an effective transmission speed of 2400 for transmission time estimates instead of the 19200 bps interface speed. exit [code] Exit to the operating system with optional code. SEE ALSO: x, o, off commands EXPand sourcefile pathspec ** For each pathname in pathspec, execute the commands in sourcefile with the string parameter item set to the current pathname. The commands in sourcefile must not themselves contain wildcards (* or ?) or directory pathnames. If no files match pathspec, sourcefile is not executed. If the script executed has a READ ONLY attribute, ZCOMM is unrestricted during execution of the script. EXAMPLE: expand plxupl 001* Executes the script plxupl once for each file matching the wild card specification 001*. EXAMPLE: expand a *.arc where the file a contains: obey "!pkxarc -v %item >> arclist" lists the contents of all .arc files to arclist. Chapter 99 explains the use of this command in more detail. f [-modes] file The f (think of "file") command initiates transmission of file with the term function. One or more term function modes (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 108 (described in Chapter 21) may be enabled with the optional modes flag. If q (TWX) mode is enabled, transmission pauses until the called system's answerback restarts it with an XON, or until g mode is set. Otherwise, any XOFF induced transmission pause is reset. Once the file has been opened with the f command, a pattern match or keyboarding F1 or ALT-X will exit the term function with file incompletely transmitted. The rest of the file may be transmitted by the t, F2, or wait commands. EXAMPLE: f -px message Uploads message paced by the p mode, which sends a carriage return and pauses at the end of each transmitted line until the remote responds with the prompt character (default line feed). The x mode makes the term function return to the script after the file has been transmitted. EXAMPLE: set eolstr "\r."; pp1000; pg58; f -p file Is useful for uploading a prepared message to a CompuServe bulletin boards using the "SIG" editor (not FILGE). The eolstr setting sends a carriage return and period after each line to prevent the CompuServe software from reformatting the message. Pp10000 Sets the pause timeout to a long time. Pg58 Sets the prompt character to ":". f -p file Transmits the file. SEE ALSO: b, g, p, r, n, t, w, x, X modes, eolstr string parameter, t and wait commands fail Terminate the current expand command, otherwise return from the current script level with failure status. If called directly by another level of script, that level is terminated. The fail command also causes the term function to exit, to allow a function key to be programmed with a macro that exits the term function. If called implicitly by a number presented for dialing, fail terminates the current dialing attempt. If no retries are left, the call is abandoned. fg Indicates ZCOMM is running in the foreground with a user at the keyboard. SEE ALSO: bg command, df test condition (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 109 fget outfile * Gets 8 bit raw data from the modem to outfile without any protocol. No data is displayed on the screen. Keyboarding F1 terminates recording; any other keyboarded character is sent to the remote. Iff the g numeric parameter is set to to some value other than its default of 10 (line feed), the fget command terminates upon reading and storing a character matching the g numeric parameter. The fget command also terminates recording on loss of carrier detect signal. This command can be used when the flow of data from the remote cannot be regulated. The maximum rate attainable without loss of data is limited by the maximum interrupt latency of the operating system and active device drivers. The time required to write a 512 character buffer to disk may also limit the maximum average data rate. Each 512 character block must be written before the modem interrupt input buffer overflows with new data. If the startup time for a floppy disk is excessive, better results will be obtained writing to a hard disk or ramdisk[9] if a suitable device is available. Tests with an IBM Personal Computer, DOS 2.1, and a Maynard Electronics hard disk suggest that no characters are lost at 9600 baud. (Your results will vary depending on your configuration and programming habits. California estimates lower.) EXAMPLE: fget rawdata find string pathspec Find and display lines containing matches to string in the specified files. Lower case characters in string match either case; upper case characters in string match upper case characters only. If string contains spaces, tabs, or semicolon, it must be enclosed by double quote characters. ZCOMM C style escapes may be used to represent control characters and string parameters to be searched for. Assuming normal DOS files (with CR/LF at the end of each line), a \n at the beginning of string forces a match to the beginning of a line. A \r at the end of string (\n if the file(s) have no returns in them) forces a match at the end of the line. The file name being searched and its length are displayed in the status line. For each line that contains a match to string, the file name (if more than one file), line number, and the text of the line are displayed. EXAMPLE: find count *.c Finds all occurrences of count or COUNT in the named files. __________ 9. See comments on Extended Memory ramdisks in Chapter 34. (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 110 SEE ALSO: egrep command FINDMore string pathspec Findmore finds a line matching string in each of the specified files, and then pages through the file beginning with the matched line. Otherwise, it is similar to the find command. When the screen is filled up, the prompt More? appears. Typing space displays another screenfull. Typing n skips to the next instance of string that has not yet been displayed. Typing ^Q or ^S displays one more character from the file. Typing ^X skips to the next file. SEE ALSO: egrepm, page commands findq string pathspec Silently searches the specified files for the first line matching string. The processing of string is identical to the find command described above. Upon a successful search, the contents of this line are stored in the z0 string variable and the ? numeric parameter is incremented. The findq command is useful for fetching password information from a disk file. SEE ALSO: egrepq command finish Terminates Kermit server operation on the remote system. fput file * Puts data from file to the remote at maximum speed without any protocol. After each 512 characters, the number of characters transmitted is displayed in the status line, and the keyboard is polled. Any key will abort the transfer. This is the fastest way ZCOMM can transmit characters to the modem, with possible peak speeds greater than 19kb. This command is useful for testing RS232 peripherals at high peak rates such as 56 kilobaud. EXAMPLE: fput datafile fpute file * Echoplex transmit a file to the remote, waiting for the correct echo to each character transmitted (for Throttle/10 seconds). The echoed character is sent to the CRT screen. If fpute receives a space as an echo to a tab, fpute waits for the spaces to stop echoing for at least 100 milliseconds before resuming transmission. Transfer speed thus suffers when tabs are present in the transmitted file unless the remote can be set to echo tabs as tab characters instead of expanding them to spaces. Throughput is less than 1/3 of normal because of the echo delay. Fpute counts each time the correct character is not echoed as an error. With n mode, fpute transmits only a linefeed at the end of each line. With r mode, fpute transmits only a carriage return at the end of each line. Most applications would use one of these modes. (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 111 CPMEOF (Ctrl-Z) terminates the file transmission unless b mode is set. Because fpute waits for the correct echo to each character sent, fpute should be used for transmitting characters to programs that echo exactly. Often it is easy to write a simple receive routine to synchronize with the sender by echoing each character received. On some microcomputer systems, the device "TTY:" does just that. Fpute is especially useful for "spoon feeding" files to the serial inputs of microcomputers and minicomputers. SEE ALSO: f command get filespec Instructs a remote Kermit server to the transmit the specified file(s), then receives them. The form of filespec varies with the remote system; it must be quoted if it contains any special characters or spaces. The get command only operates with a Kermit server; use kermit rb to receive files from a regular Kermit program. goback label Search the current script file for label: and execute commands starting at that line. The goback command begins the search at the beginning of the file. It is faster than the goto command which begins the search at the current line. SEE ALSO: goto command gosub name[.scriptfile] Call a script as a subroutine. The phone directory is searched for name unless another file is specified with .scriptfile. Gosub has the same action as the call command (q.v.), but does not reset modes, disconnect the modem, or modify the remote parameter. EXAMPLE: gosub dosig Executes the dosig entry in the telephone directory. EXAMPLE: gosub .%lib/baud.t Executes the commands in c:/yam/baud.t assuming the lib string parameter contains c:/yam. SEE ALSO: call command goto label Search the current script file for label: and execute commands starting at that line. A label begins at the first column and ends with a colon (:). Iff label precedes the current script line, the goback command will locate the target label more quickly. The goto command is valid only within a script or telephone directory entry. Please refer to Chapter 99 for examples using the (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 112 pattern, if, goto, and source commands. grab svar Grab reads a line from the currently open transmit file into the specified string parameter svar. Unless b mode is on, all characters starting with the first CR and/or LF are discarded. Grab inhibits transmission of the open file until g mode is explicitly set by a command. On end of file the transmit file is closed and the string parameter is set empty. End of file can be tested with the t test condition. SEE ALSO: putv command HAndshake {off|sw|on|cts|dsr|dcd|both|slow} Some modems and printers cannot accept continuous full speed data. These devices send control characters (XOFF and XON) for flow control, or generate a hardware flow control signal on the CTS, DSR, or DCD pin. The Handshake command controls the modem port hardware handshake (default sw).[10] If hardware handshaking is selected, an ON to OFF transition on the specified line pauses transmission, and an XON character will not override the hardware restraint. After a timeout set by the S numeric parameter (default 60 seconds), or if characters are in the keyboard input buffer, a warning message is displayed, the restraint is released, and characters are sent. As a special case, handshake on obeys output flow control with the CTS input signal, asserts input flow control with the RTS output signal, and disables the transmission of XOFF characters when the modem input buffer becomes nearly full. Some computers do not support concurrent disk and serial I/O at high speeds. The handshake slow command drops the RTS signal to the modem during disk writes when receiving files with YMODEM-g or ZMODEM. The handshake slow command does not correct overrun problems caused by TSRs and multitasking executives. The handshake both command allows either CTS or XOFF to pause output, in addition to asserting input flow control with the RTS output. This is useful when the local modem uses CTS/RTS hardware __________ 10. ZCOMM automatically disables its software (XON/XOFF) flow control when using XMODEM, YMODEM and similar protocols that require all 256 byte codes. These protocols may not work if the modem is set for software flow control. (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 113 flow control, but calls a network such as CompuServe, Telenet, or Tymnet that uses software (XON/XOFF) flow control. The handshake dcd command enables d mode (q.v.). Subsequently, selecting a different type of handshaking will disable d mode. Use of handshake dcd is not recommended. The "handshake off" command disables all flow control except for XOFF characters sent by the term function. The handshake command (without argument) releases flow control (allows data to flow if it had been stopped by handshaking). Changing the communications port with the port or portx command disables hardware handshaking. Operation of the handshake command varies with the operating system and hardware used. SEE ALSO: S numeric parameter EXAMPLE: handshake cts Turns on CTS handshaking. help The help command uses the helpfile or xhelpfile string parameter depending on whether ZCOMM is in host operation. Normally, the help command displays a command summary, pausing every 24 lines. If the string parameter begins with the character @, ZCOMM uses the rest of the parameter as the initial command to access a pop-up help program. The contents of the f string parameter are added to this command, separated by a space. Thus, if helpfile contains "@yhp /umanh.hlp", giving the help command from the main prompt executes the DOS command "yhp /umanh.hlp main". If the called program leaves a file yamhelp.tmp containing script commands in the current directory, ZCOMM executes this file with a source command and then deletes it. SEE ALSO: f, helpfile, xhelpfile string parameters, source command history [histfile] Opens histfile for use as a dual 64 entry history file for commands entered both at the ZCOMM command prompt and online with the term function. Histfile is a random access file used as a pair of circular buffers to save commands for recall. Only a file created by a previous history command may be used with the history command. If the specified histfile does not exist, it is created. Histfile stores commands with T or more characters where T is the value of the T numeric parameter. (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 114 If histfile is not specified with the history command, the current history file is updated and closed. The history command may be given with a different file name whenever desired to access useful commands saved from previous sessions with a particular host or application. When history is enabled, the Up and Down function keys scroll through previously entered commands. Ctrl-P and Ctrl-N may be used in place of Up and Down respectively. An old command so selected may be edited with editing keys described in Chapter 18 and executed with the key. In the term function, the history accessed with the Up and Down keys is displayed and edited in the status line. [11] A Ctrl-X clears the recalled text and restores normal status line and keyboard operation. EXAMPLE: history /tmp/favbbs.hist SEE ALSO: r command, T numeric parameter N.B.: Do not give the history command before you have entered any secret passwords from the keyboard as these will be saved in the history file. The history command without an argument closes the history file and disables command recall. Alternatively, the T numeric parameter may be set to a large value to inhibit storing of passwords in histfile. Normally, histfile should be an absolute pathname to insure that the same file will be used regardless of the directory from which ZCOMM is called from. The history command is not available when Restricted. N.B.: Do not attempt to delete an open file on DOS, especially the history file. host The host command conditions ZCOMM to accept incoming calls unattended. Host operation is described in Chapter 28. The EXIT key F1 terminates Host Operation. N.B.: The host command is normally given only by a script that sets parameters to their appropriate values. Use the "host" entry in the distributed PHODIR.t file as a prototype for your application. SEE ALSO: remote command __________ 11. Unix/Xenix flavors only support Backspace editing in this mode. (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 115 if condition command ... The if command provides powerful condition testing for scripts. If executes the command(s) on the rest of the line if condition is true. Otherwise, execution continues immediately with the next script line. Chapter 27 describes the testable conditions. SEE ALSO: else, on commands ife condition cmd1 ...; cmd2 ... Execute cmd1 ... if condition is true; otherwise skip to the first semicolon in the rest of the line and resume execution (unconditionally) with cmd2. Iff a semicolon is not present, execution resumes at the end of the line, useful within the body of a while command. EXAMPLE: set f5 @ife %s1 echo "s1 =%s1"; else echo "s1 not set" (Without the "else", the right half will always execute.) kbdlock N * Controls acceptance of keyboarded characters by the term function and during protocol file transfers. If N is non zero, the term function does not act upon key strokes. If N is greater than 1, key strokes have no effect on protocol transfers. The Ctrl-Break key and the command prompt reset kbdlock to 0. If N is 257, the Ctrl-Break key does not reset Kbdlock. Kbdlock does not affect the k test condition or the accept command. Characters typed while kbdlock is on will become available at the next command prompt, accept command, or when kbdlock is reset unless typeahead is purged with the purgek command. SEE ALSO: purgek command, Ctrl-Break key kbdmon [file] captures keystrokes to file. If file exists, it is appended to. Function keys are denoted by an 0xFF character followed by the code returned by the BIOS. The kbdmon command without an argument closes the file. This command is not available when Restricted. kermit By itself, selects Kermit or Kermit related parameters for use by the !!, p, rb, and sb commands. Kermit rb [-options] Kermit rb receives files using the Kermit file transfer protocol. Chapter 20 describes the available options. File names are given by the sending program. The Kermit programs must have compatible parity settings as described in Chapter 13, Kermit Protocol. Kermit rb receives files from a regular Kermit program; use the get command to receive files from a Kermit server. (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 116 EXAMPLE: kermit pi1; kermit rb Downloads files from an IBM mainframe. ZCOMM's term function will sense the remote Kermit's parity setting and download files without user intervention When the remote Kermit starts sending, if K (Kermit autodownload) mode is enabled (the default). Kermit sb [-options] pathspec Kermit sb sends the specified files to either a regular Kermit program or a Kermit server. Chapter 20 describes the available options. The Kermit programs must have compatible parity settings as described in Chapter 13, Kermit Protocol. EXAMPLE: kermit pi1; kermit sb file ... Sends the specified files to an IBM mainframe. keys, ALT-K Keys displays the definitions the user has assigned to the function keys. ki Clears the y0...y127 string parameters and causes circular buffer writing operations to ignore data from the remote which has already been displayed. This data is still available to the review function. EXAMPLE: The script fragment pat 1c "///BEGIN///" "@ki create -+ print.fil" pat 2c "///END///" "@close" wait -f30000 will capture the data that arrives between "///BEGIN///" and the end of the string "///END///". Other data from the remote will not be captured to disk. The long pattern match fail time (30000 seconds) makes the the cycle repeat almost indefinitely. SEE ALSO: W mode kill Erases (flushes) all data stored in the circular buffer and restores the buffer pointers to their initial positions. kill [-signum] procnum Available on Unix and OS/2 flavors, this form of the kill command supports interprocess communications. If signum is absent, the kill command checks for the existence of the specified process, but does not send it a signal. Success sets the ? numeric parameter to 0, otherwise -1. (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 117 SEE ALSO: createx command, Unix kill(1) l, ll, ls, lx For Unix users, synonyms for the dir commands. learn lfile TurboLearn(TM) Script Writer records timing information and term function keystrokes to lfile. The TurboLearn program tlearn.exe then generates a script using this data. Normally, learning is initiated after the connection has been established, but before the first prompt is received from the remote. This is best accomplished with the F4 key, which activates the tlearn telephone directory entry. Function keys, cursor keys, reassigned keys, and scripts[12] should not be used while learning. When accepting passwords and other sensitive information, systems sometimes acknowledge each keyboard character with #, *, x, or X, instead of the keyboarded character itself. When this happens, do not type characters faster than the remote responds to them. The resulting script should be examined for evidence of keyboarding mistakes, line noise, and dependence on prompts that change each time you access the system. The comments below apply when the tlearn script is not used. EXAMPLE: kill 123-4567; learn lfile From the ZCOMM main command prompt, enter the desired phone number. When ZCOMM connects, the learn command enters the term function with learning (recording) turned on. Login to the bulletin board as usual. If you make keyboarding mistakes, you can edit the script file later. ALT-C F1 Terminate learning with ALT-C, and return to the main command prompt with the F1 key. !tlearn lfile >newscript __________ 12. Other than the dialing script (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 118 From the main command prompt, execute the TurboLearn program tlearn with a DOS Gateway. After recording, the tlearn program reads lfile and generates a series of pattern and put script commands to let ZCOMM search for the prompts and respond with the proper keystrokes. The resulting script file newscript may be accessed with the source command. Alternatively, the last command above may be replaced with !tlearn -d newdirname lfile >>phones.t to add the new script to the end of your telephone directory. The -d dirname causes tlearn to prepend the given new directory entry name newdirname and the telephone number to the resulting script commands. The redirection characters >> add the script commands to the end of your telephone directory. You can also use the -d newdirname option to tlearn to prepare a new directory entry in a separate file. Then you can edit this file and add it somewhere within your telephone directory. The tlearn program also accepts a -r option to suppress a "return" command normally emitted at the end of the generated script. This tlearn option allows one to append an "off" command to the generated script. link * Link two serial ports. The link command allows remote access to a computer or other device connected to another port. For example, if port 1 is connected to an autoanswer modem and port 2 is connected to a local timesharing machine, the link command would allow dial-up callers access to the timesharing machine. Chapter 19.5 describes the link command. list pathspec The list command uses standard DOS character output routines and any installed CRT device driver instead of ZCOMM's own CRT driver. The printer can be enabled with ^P given to DOS (not ZCOMM). List the specified file(s). This command closes any open transmit file. ZCOMM detects SQueezed files and prints them in ASCII.* List pauses/resumes printing with ^S. Keyboarding ^C cancels, and ^X skips to the next file (it might take a few whacks of the keyboard to get ZCOMM to hear it.) The list command defaults to a type command when ZCOMM is in host operation. EXAMPLE: list *.cq SEE ALSO: browse, type, page commands (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 119 lput string Displays string on the console display. String is processed for character escapes. Lput is useful for scripts sending cursor control codes to the screen. Control characters and escape sequences used with the lput command are always decoded with ZCOMM's default extended VT52/Z19 emulation, which also recognizes ANSI "ESC [" sequences, regardless of which display emulation is selected. Unlike the echo command, lput does not display in reverse video and does not add a carriage return/linefeed to its argument. SEE ALSO: echo command lputp string Outputs string to the line printer. String is processed for character escapes. Strings with embedded nulls (represented with the \000 character escape) may be used. The lput command should not be used if the printer is jammed, out of paper, or off line. These conditions may be tested with the l test condition. This command is not allowed when ZCOMM is Restricted. EXAMPLE: if l lputp "\E\017" If the printer is ready, ZCOMM sends ESC SI to select compressed printing on an IBM 80 CPS printer. SEE ALSO: l numeric parameter, l test condition, \dNNN (decimal) character escapes menu Execute script commands from the file name stored in the string parameter menu. message The message command allows a caller to keyboard a message which will be appended to a file specified by the string parameter messages. Typically, messages would point to a publicly visible file to allow other callers to read messages. The message command is otherwise identical to the private command. SEE ALSO: private command mk [scancode shiftstate class string] Assign term function keyboard mapping. Without an argument, mk resets and disables keyboard mapping. The mk command is described in Chapter 29. SEE ALSO: N numeric parameter, _ command more pathspec See page command. mput string The mput command transmits string to the remote at full speed. String is processed for character escapes. Unlike the put and putw commands, mput does not display characters coming from the remote (they are held in the interrupt buffer). Control and other special characters may be entered with character escapes. If a carriage return should be sent, it must be explicitly coded with \r at the end of the string. (C) 1990 Omen Tech Inc Chapter 19 Main Commands Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 120 SEE ALSO: put, putw commands nolog * Suppress generation of the next log entry (of any kind). EXAMPLE: mysys nolog speed 1200 123-4567 t Suppresses the log entry that would otherwise be made if the calllog string parameter is set. nulls n When accessing ZCOMM in host operation, nulls sets the number of nulls (default 0) sent after each linefeed to allow slow terminals time to scroll. EXAMPLE: nulls 4 o Terminates a data call by dropping DTR (Data Terminal Ready). DOS ZCOMM drops Clear To Send (CTS) as well as DTR if hardware flow control was selected with the handshake command. A bye or speed n command must be given to reassert DTR before making or answering another data call.[13] The o command does not release ownership of the serial port. SEE ALSO: speed, bye, off, port commands obey string Sometimes one wishes to execute the contents of a string parameter as a ZCOMM command. Other times one needs to reference a pathname stored in a string parameter in the context of a command that does not itself perform string substitution on its argument(s). Obey executes string as a ZCOMM command. Character escapes in string are substituted before execution. EXAMPLE: obey ">>%s0" Redirects the output of utility commands to the pathname stored in string parameter s0. EXAMPLE: pat 19c "OBEY-LAST" "@obey %y2" Sets pattern 19 to execute the previous line received from the remote when the string "OBEY- LAST" is received. N.B.: The remainder of the line after the obey command will be executed unless execution of string is terminated by a return or fail command. The construction obey "if xxx goto foo" May be used only if no commands follow the obey command's string argument. __________ 13. Most telephone directory entries include a speed command. (C) 1990 Omen Tech Inc Chapter 19 Main Commands