ÈERROR T A zmain •  main1 ˜ Úquit r dmain  ñspecial p" Lpspecial ¼(   zzzzzzz \2  commands b2 O@ ±5 6%l-234-567-8901 ç6 ã234-5678 Ê8 a: Ñ> µ abort †? ¦ accept ,@ ÷ap #H Fapd iI Ðbdump 9K ¼bg õM ‚ break cmd wN kbye âP ¦call ˆR cat ˆ` J cd Ò` ecdd 7e chat Kf aclose ¬g Ç closerx sh closetx ôh S cl Gi  cls bi ° crc j ;create Mm "createx oo del tq —demand s hdir sv —disable z ´ display ¾z ô dump ²† × echo ‰‡ ’egrep Š 5egrepq P ™else éŽ [enable D estimate L‘ ¼exit ” j expand r” f cmd Š— fail ¦ ófg ™Ÿ fget   »find Õ¥ findmore ó© "findq ¬ ¼finish Ñ­ E fput ® ôfpute ° §gcolors ±µ ­get ^· fgoback ĸ %gosub é¹ *goto ¼ ×grab ê½ Ýhandshake Ç¿  help âÉ ^history @Í ‰host ÉÕ ›if d× kbdlock }Ú Îkbdmon KÝ #kermit nÞ v kermit rb äÞ Ìkermit sb °á ~keys .ã _ ki ã ƒkill æ kill2 ‘æ sl è  ls è  lx è D learn Nè & link tó }list ñô ¤lput •÷ Ilputp Þù zmenu cmd Xü ^ message ¶ü nmk $þ ð more ÿ ' mput ;ÿ ænolog ! Þ nulls ÿ ½ o ¼ Þobey š šoff 4  *on ^  êopen H ºpage  Êpattern Ì port Ð) v portx F5 âprivate cmd (8 ÷purgek ; ” put ³; Ûputw Ž? Üpwd jC ¢ p D ƒqueue G quit šM r §N šr7 AP [rb œR °rc LW >read ŠZ Æreceive P] § remote cmd ÷] ºremote cwd ±_ Mremote delete þ` Ú remote dir Øa =remote help c ¸ remote host Íc çremote print ´e ï remote space £f Uremote type øg ;remote who 3i º reset íi   reskeys j E restime Òj @restrict l › return ­l } rewind *m  ro Êp hrt 2s ¯rw áu û rx Üv nrz Jy ^status ¨~ Ss7 û —sb ’„ seek ˆ ´send Ó‰ Ø set «Š ásleep Œœ Soft Keys ›ž 5source Р Úspeed ª¤ =split çª %ss ° ½st ɲ Rsum µ 1sx L· esz ±¹ ¡ t cmd RÆ štcs ìÊ timestamp þÌ trs Ð type *Ò Óunrestrict cmd ýÓ Ousq LÖ =videobios ‰Ú þw ‡Ý G wait ÎÝ Ëwc ™à Rwhile ëâ ?exit *æ {zcommand ¥è †zmodem +î b_ ï ˜dos-gateway %ò #bangbang Hó Ilabel: ‘ô `:comment ñö á ; Ò÷ ßoutfile Ãü Azzzzzz  lF2 p \ Up Ì F Down  D Home V . zzzzzz „ ê F3 n ‡ F4 õ †F5 { ü F6 w Ç F7 > ë F8 )  » F9 ä  zF10 ^  7 Shift-F1 •  ( Shift-F2 ½  V Shift-F3   7 Shift-F4 J  E Shift-F5   Shift-F6   8 zzzzzzz F  ‚ Ctrl-Home È  ; ALT-C  ¢ ALT-D ¥ X ALT-M ý a ALT-R ^ D ALT-S ¢ t ALT-U  -ALT-W C ºzzzzzzzz ý  browse  vzzzzzzz y%  term % ˜ALT-J D ·zzzzzzz ÎZ  conference ÔZ zzzzzzz ëa  review ña jzzzzzzz [}  invoking a} p(zzzzzzz Ñ¥  editkeys ×¥ Rzzzzzzz )«  modes /« ùzzzzzzz (³  options .³ Üzzzzzzz º  autof º ×zzzzzzz ç¼  n-parms í¼ Ójkermit-n-parms À' 1zmodem-n-parms ñ7 7zzzzzzz (U  access1 ,U ¥zzzzzz ÑX zzzzzzz ÛX string-parms åX Ãzzzzzzz ¨j zzzzzzz ²j zzzzzzz ¼j D setup k 1 setup1 1k ˆzzzzzzz ¹l dialing Ãl S dialing1 m …zzzzzzz ›o online ¥o C online1 èo mzzzzzzz Ur  pfile-trans cr  file1 jr û zzzzzzz es pfile-r os  file-r vs úzzzzzzz px  pfile-s ~x  file-s …x ¬zzzzzzz 1|  pfile-c ?| Õ zzzzzzz }  pfile-a "}  file-a )} zzzzzzz F  nfile-trans T  filen [ |zzzzzzz × macros á  macro1 è ”zzzzzzz |„ crt-cmds †„  display1 „ "zzzzzzz ¯† disk-cmds ¹† ™ disk1 R‡ ñzzzzzzz CŒ remote-cmds MŒ  remote1 TŒ ,zzzzzzz €  support-cmds Ž  support1 • zzzzzzz ª  zzzzzzz ² script-cmds ¼  script1 à Xzzzzzzz “ L script_s g“  script2 n“ úzzzzzzz h– L server-access ´–  zzzzzzz »– G subjects — ãzzzzzzzz åž  È ÆÆÆ Chuck ForsbergÆÆ Omen Technology IncÆÆÆ… ‡ZCOMM Communications Software…ÆÆ Shareware Communications ToolsÆÆÆ Copyright 1991 Omen Technology IncÆ All Rights ReservedÆÆ Omen Technology IncÆ 17505-V Northwest Sauvie Island RoadÆ Portland Oregon 97231Æ VOICE: 503-621-3406 :VOICEÆ Modem: 503-621-3746 Speed 1200,2400,19200Æ Compuserve: 70007,2304Æ UUCP: ...!tektronix!reed!omen!cafÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆ(C) 1990 Omen Technology Incorporated Chapter 0ÆÆÆÆÆÆÆÆÆƇ2… Version 17.84 TurboDial 2.36ÆƼ– Error in Helpfile Compilation - Subject not in help file! —™ ¼– › š@  šA × šB Ù šC  šD ì ÆšE ï šF ò šG õ šH  šI ÆšJ  šK  šL  šM ÆšN ÆšO á šP è šQ  šR  ÆƼ– Online Help for ZCOMM Version 17.84 TurboDial 2.36ÆÆ‚ A … About the DemonstrationÆ‚ B … Calling ZCOMMÆ‚ C … Editing keysÆ‚ D … Special KeysÆ‚ E … Modem Setup CommandsÆ‚ F … Dialing a callÆ‚ G … Online interactive conversationÆ‚ H … Protocol File Transfer CommandsÆ‚ I … Non Protocol File Transfer CommandsÆ‚ J … Macro CommandsÆ‚ K … Display / Emulation Control CommandsÆ‚ L … Disk File CommandsÆ‚ M … Remote Takeover / Control CommandsÆ‚ N … Support CommandsÆ‚ O … Script CommandsÆ‚ P … Numeric ParametersÆ‚ Q … String Parameters (magic words, etc.)Æ‚ R … Subject listingÆ–W ‚ S … Exit HELP¼– BIBI...¾¼– Æ Online Help for ZCOMM Version 17.84 TurboDial 2.36ÆÆThis demonstration is configured to use a Hayes compatible modem connected toÆeither COM1 or COM2. Some of the demo menu choices are usable without a modem,Æbut ZCOMM is a communications program, so some of the demonstrations will needÆa modem.. ZCOMM can be customized to operate with almost any intelligent,Ædumb, or manual modem, but this demo requires a modem that recognizes the basicÆHayes "AT" modem commands.ÆÆWhen you no longer wish ZCOMM to come up with the Novice/Demo menu, change theÆ‚XSETUP… entry in ‚PHODIR….‚T… to ‚SETUP… and vice versa.ÆÆPlease browse through these help screens, and read the ZCOMM manual (includedÆin ZCOMMDOC.ARC) for more information. —• —¼– Æ ‡SPECIAL KEYS…ÆCtrl-Break clears any typeahead, unlocks the keyboard, and stops whateverÆfunction ( Not necessarily the calling function or script ) ZCOMM is doing in aÆreasonably orderly manner. ( In the term function, Ctrl-Break sends a break toÆthe remote unless it has been redefined with a ‚set… command. ) 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. ( Use of this term, popularized in the J.F.K. administration,Ædoes not imply endorsement of preemptive nuclear attacks on innocentÆpopulations. ) 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. ( WhenÆin host operation waiting for a call, NUKE drops DTR. )ÆÆ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.ÆÆ— ‡<<-- Special Keys during Protocol Transfers -->>…ÆCertain keys perform special functions when keyboarded during protocol fileÆtransfers (XMODEM, Kermit, etc.). Some of these keys are inhibited when a nonÆerror correcting protocol (YMODEM-g) is active.ÆƇ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.Ƈ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. —¼– —¼– Æ ‡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. ( A space or two after each semicolon makesÆscripts easier for humans to read. )Æ —Ƈ@… 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.Æ ‚EXAMPLE…: ‡234-5678…ÆÆ When carrier is detected, ZCOMM executes the ‡mconnect… string (if set). IfÆ there is no next command, ZCOMM returns to the command prompt.ÆÆ 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.Æ ( When using the ‚mm224… dialing script. ) 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 7.ÆÆ ‡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… to the user. ( ‚Prompt… must be enclosed in quotes ifÆ it contains spaces. ) ZCOMM then reads keyboard 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. —Ƈ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. 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 17.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). ( The modem must be configured to useÆ Data Terminal Ready (DTR). ) After a pause, DTR is reasserted to allow theÆ modem to originate or answer another call. ( Most dialing scripts include anÆ initial ‚bye… command to make sure any previous call is disconnected. )Æ ‡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.ÆÆ 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. ( Deep nesting may require aÆ decrease in the circular buffer memory allocation, see Chapter 14. ) 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. ( The ‡home… parameter is setÆ to the current directory when ZCOMM is invoked, but may be changed with theÆ ‚set… command. ) 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…Æ 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 20.5 gives details. —Ƈcrc pathspec… Print the CRC-32 and character count for the specified files. TheÆ ‚crc… command verifies the identity of two (or more) copies of a file. Iff theÆ lengths and CRC-32's of two files are the same, the files are almostÆ certainly identical. Comparing files with the ‚crc… command is faster thanÆ transmitting a second copy for character by character comparisons.Æ ‚EXAMPLE…: ‡"crc", "crc *.c"…Æ HINT: To generate a file containing the CRC's of the files in the currentÆ directory:Æ ‡>crc.lst…Æ crc *.*Æ closeÆ After the files are copied, run the commands above (with a different fileÆ name), then compare the two files with ‚DIF….‚EXE… to detect any that haveÆ changed.Æ ‡SEE ALSO:… ‚sum…, ‚wc… commandsÆ Source for a public domain Unix/DOS version of CRC is available. —Ƈcreate [-modes] outfile… If a receive capture file is open as the result of aÆ ‚create… or ‚t filename… command, write the circular buffer and close it. ThenÆ create ‚outfile… for use with the ‚term… function with ‡modes…. The ‚create… commandÆ is especially useful when you don't want to enter the term functionÆ immediately.Æ ‚EXAMPLE…: ‡create -ys /tmp/cbbs.tmp…Æ ( The ‡y… mode overwrites any existing file with the same name. The ‡s… modeÆ strips most control characters from the resulting disk file. )Æ ‡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 —Ƈ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. 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.Ƈ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 19Æ 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,‚STV….‚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ÆÆÆ ‡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. —Ƈ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Æ 24.ÆÆ 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. While else statements inÆ programming languages are connected to a particular if statement according toÆ syntax, the connection in ZCOMM is to the last ‚if… statement executed on theÆ level, regardless of goto's. —ƇENAble {-modes}… Enable mode(s) affecting the ‚term… function. Chapter 19Æ 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 "—kxarc -v %item >> arclist"…Æ lists the contents of all .arc files to ‚arclist….ÆÆ Chapter 26 explains the use of this command in more detail. —Ƈf [-modes] file… The ‚f… (think of "‡f…ile") command initiates transmission of ‚file…Æ with the ‚term… function. One or more term function modes (described inÆ Chapter 19) 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 —Ƈ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 ( See comments on Extended MemoryÆ ramdisks in Chapter 34. ) 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.Æ ‡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.ÆÆ 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 —Ƈgcolors bgcolor, color1,...… Select colors for the graphic file transfer displayÆ provided with ZCOMM and gYam flavors. On PCDOS (and SCO Unix) flavors,Æ operand values correspond to the video numeric parameters. This command isÆ normally generated by the ‚gcolors… program described in Chapter 11.Æ ‚EXAMPLE…: ‡gcolors 15,2,12,120,10,6,14,6,31,7,12,2,14,15,15,0,0…Æ selects a color scheme suitable for ‚Aliens III….Æ —Ƈ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 26 forÆ examples using the ‚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). ( 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. )ÆÆ 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 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.ÆÆ 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 16 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. ( Unix/Xenix flavors only supportÆ Backspace editing in this mode. ) 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 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. Do not attempt toÆ delete an open file on DOS, especially the history file. —Ƈhost… The ‚host… command conditions ZCOMM to accept incoming calls unattended.Æ Host operation is described in Chapter 27. The EXIT key ‡F1… terminates HostÆ Operation. The ‚host… command is normally given only by a script that setsÆ parameters to their appropriate values. Use the "host" entry in theÆ distributed ‚PHODIR….‚t… file as a prototype for your application.Æ ‡SEE ALSO:… ‚remote… command —Ƈif condition command ...… The ‚if… command provides powerful condition testing forÆ scripts. ‚If… executes the ‚command…(‚s…) on the rest of the line if ‚condition… isÆ true. Otherwise, execution continues immediately with the next script line.Æ Chapter 25 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 18 describes the available options. File names are givenÆ by the sending program. The Kermit programs must have compatible parityÆ settings as described in Chapter 11, Kermit Protocol.ÆÆ ‚Kermit rb… receives files from a regular Kermit program; use the ‚get… commandÆ to receive files from a Kermit server.Æ ‚EXAMPLE…: ‡kermit pi1; kermit rb… Downloads files from an ‡IBM… mainframe.ÆÆ ZCOMM's term function will sense the remote Kermit's parity setting andÆ download files without user intervention When the remote Kermit startsÆ sending, if ‡K… (Kermit autodownload) mode is enabled (the default). —ƇKermit sb [-options] pathspec… ‚Kermit sb… sends the specified files to either aÆ regular Kermit program or a Kermit server. Chapter 18 describes theÆ available options. The Kermit programs must have compatible parity settingsÆ as described in Chapter 11, Kermit Protocol.Æ ‚EXAMPLE…: ‡kermit pi1; kermit sb file ...… Sends the specified files to an ‡IBM…Æ mainframe.Æ —Ƈkeys, ALT-K… ‚Keys… displays the definitions the user has assigned to the functionÆ keys. —Ƈki… Clears the ‡y0...y127… string parameters and causes circular buffer writingÆ operations to ignore data from the remote which has already been displayed.Æ This data is still available to the ‚review function….Æ ‚EXAMPLE…: The script fragmentÆ ‡pat 1c "///BEGIN///" "@ki create -+ print.fil"…Æ pat 2c "///END///" "@close"Æ wait -f30000Æ will capture the data that arrives between "///BEGIN///" and the end of theÆ string "///END///". Other data from the remote will not be captured to disk.Æ The long pattern match fail time (30000 seconds) makes the the cycle repeatÆ almost indefinitely.Æ ‡SEE ALSO: W… mode —Ƈkill… Erases (flushes) all data stored in the circular buffer and restores theÆ buffer pointers to their initial positions. —Ƈkill [-signum] procnum… Available on Unix and OS/2 flavors, this form of theÆ ‚kill… command supports interprocess communications. If ‚signum… is absent, theÆ ‚kill… command checks for the existence of the specified process, but does notÆ send it a signal. Success sets the ‡?… numeric parameter to 0, otherwise -1.Æ ‡SEE ALSO:… ‚createx… command, Unix kill(1) — — —Ƈl, ll, ls, lx… For Unix users, synonyms for the ‚dir… commands. —Ƈlearn lfile TurboLearn(Tm) Script Writer… records timing information and termÆ function keystrokes to ‚lfile…. The TurboLearn program ‚tlearn….‚exe… thenÆ generates a script using this data. Normally, learning is initiated afterÆ the connection has been established, but before the first prompt is receivedÆ from the remote. This is best accomplished with the ‡F4… key, which activatesÆ the ‚tlearn… telephone directory entry.ÆÆ Function keys, cursor keys, reassigned keys, and scripts ( Other than theÆ dialing script ) 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…Æ 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 17.5 describes the link command. —Ƈlist pathspec… The ‚list… command uses standard DOS character output routines andÆ any installed CRT device driver instead of ZCOMM's own CRT driver. TheÆ printer can be enabled with ^P given to DOS (not ZCOMM). List the specifiedÆ file(s).ÆÆ This command closes any open transmit file. ZCOMM detects SQueezed files andÆ prints them in ASCII.* List pauses/resumes printing with ^S. Keyboarding ^CÆ cancels, and ^X skips to the next file (it might take a few whacks of theÆ keyboard to get ZCOMM to hear it.) The ‚list… command defaults to a ‚typeÆ… command when ZCOMM is in host operation.Æ ‚EXAMPLE…: ‡list *.cq…Æ SEE ALSO: ‚browse…, ‚type…, ‚page… commands —Ƈlput string… Displays ‚string… on the console display. ‚String… is processed forÆ character escapes. ‚Lput… is useful for scripts sending cursor control codesÆ to the screen. Control characters and escape sequences used with the ‚lputÆ… command are always decoded with ZCOMM's default extended VT52/Z19 emulation,Æ which also recognizes ANSI "ESC [" sequences, regardless of which displayÆ emulation is selected. Unlike the ‚echo… command, ‚lput… does not display inÆ reverse video and does not add a carriage return/linefeed to its argument.Æ ‡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.Æ ‡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. ( MostÆ telephone directory entries include a ‚speed… command. ) 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.Æ 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. Backslashes in file names used with theÆ ‚obey… command must be escaped. 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), ( The modem mustÆ be configured to use Data Terminal Ready (DTR). ) 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 25 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.Æ ‡SEE ALSO:… wait, if commandsÆ 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 "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 ( PauseÆ length is specified by the ‡q… numeric parameter. ) unless the ‡i… or ‡c… modifierÆ is used.ÆÆ The following modifiers may be used. The ‡c…, ‡i…, and ‡l… modifiers are mutuallyÆ exclusive.ÆÆ ‡c… The pattern is marked as found and ‚action… executed (if present). TheÆ term function then ‡continues searching…. Matching this pattern does notÆ cause a return from the term function. The condition for this patternÆ will test true, but the ‚n… test condition is not affected.Æ ‡i (Immediate)… The pattern is marked as found and ‚action… executed (ifÆ present). The term function then returns immediately.Æ ‡l (line end delay)… The pattern is marked as found and ‚action… executed (ifÆ present). The term function then returns after the first LF characterÆ following the matched string.Æ ‡p (permanent)… A pattern with the ‡p… modifier is ‚not… reset by the ‚pattern…Æ command without arguments. Patterns with the ‡p… modifier may be used toÆ search for disconnect messages within an entire script. PermanentÆ patterns are reset by the ‚call… command, each item in the outcall queue,Æ and an explicit ‚pattern… command referencing that particular patternÆ number.Æ ‚EXAMPLE…: ‡pattern 20 "\nCLR" "@off"… Disconnects and exits ZCOMM if theÆ phrase ‚CLR… is seen immediately following an LF.ÆÆ ‡v (verbose)… The ‡v… modifier displays a message when the pattern is matched.Æ This is often useful when debugging scripts when the large amount ofÆ output generated by large ‡v… numeric parameter values is not desired.Æ ‚EXAMPLE…: ‡pat 5v "Finished Already."…ÆÆ $ Sometimes the only way to recognize a prompt (as distinct from the sameÆ string embedded in other data) is to require the prompt to be the lastÆ thing sent by the remote, before a pause. The ‡$… modifier allows ‚string…Æ to be matched only if the remote pauses for 1 to 2 seconds afterÆ transmitting the last 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 COM‡n…. On DOS, the legal values for ‡n… areÆ 1...18.ÆÆ Selecting a new port normally selects software handshaking ("handshake sw").Æ The PCDOS flavor enables both hardware and software handshaking ("handshakeÆ both") iff the port speed exceeds 2400 bps and the Clear To Send (CTS) signalÆ is active at the time the ‚port… command is given.ÆÆ Standard Ports (PCDOS):Æ COM1 3F8 IRQ4 (Standard IBM)Æ COM2 2F8 IRQ3 (Standard IBM)ÆÆ NON STANDARD PORTS:Æ COM3 3E8 IRQ4 (Alternate)Æ COM4 2E8 IRQ3 (Alternate)Æ COM5 2B8 IRQ3 (Columbia)Æ COM6 2B8 IRQ2 (Alternate for IBM)ÆÆ COM7 2E8 IRQ5 (Alternate "COM3")Æ COM8 3E8 IRQ5 (Alternate "COM4")ÆÆ COM9 Uses the port address and interrupt vector previously set by theÆ ‚portx… command.Æ COM11-COM18 IBM ‡PS/2… COM1-COM8 portsÆÆ 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…ÆÆ 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 escapes described in Chapter 24. 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. ‚Putw… should not be used when theÆ next operation will be a ‚pattern… or ‚wait… command. If the expected responseÆ starts before the ‚putw… command finishes, the following ‚wait… command willÆ never get to "see" what it is waiting for. In general, the ‚putw… commandÆ should only be used as a short-cut for sending a command when the response isÆ known in advance and can be safely ignored.Æ ‡SEE ALSO:… put, mput commandsƇputv svar… The ‚putv… command transmits ‚svar… to the remote without any translationÆ of character escapes. ‚Putv… does not append a carriage return or line feed toÆ the transmitted string.Æ ‚EXAMPLE…: ‡putv s0; put "\r"…Æ SEE ALSO: put, mput commands —Ƈpwd… Print Working Directory displays the current directory pathname, and storesÆ it in the ‡pwd… string parameter.Æ ‚EXAMPLE…: ‡pwd…Æ SEE ALSO: cd command —ƇpxN… Set Numeric parameter ‡x… to value ‡N…. If ‡x… and ‡N… are blank, display theÆ numeric parameters which can be set by this command and their current values.Æ This command is not allowed if Restricted. Numeric parameters are describedÆ in Chapter 22.Æ ‚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.Æ ‚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 11. —Ƈrb [-options]… Receives with ‡options… 1 or more files using YMODEM batchÆ protocol. The ‚rb… command also receives files sent with SEAlink protocol.Æ Chapter 18 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).Æ ‚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 11.Ƈ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 18 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 11. —Ƈ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 21.Æ ‚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 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 11. —Ƈ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 —Ƈ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 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. 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 21. —Ƈ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 (in the "Numeric Parameters" top level menuÆ selection) —Ƈ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 11. —Ƈrw [-options] file… Receives with ‡options… a single ‚file… using the People-LinkÆ ‡WXMODEM… protocol. Chapter 18 describes the available options. IfÆ Restricted, a file received in error will be unlinked (erased).Æ ‚EXAMPLE…: ‡rw foo.com…Æ —Ƈ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 18Æ describes the available options. If Restricted, a file received in errorÆ will be unlinked (erased).Æ ‚EXAMPLE…: ‡rx foo.com…Æ 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 11. —Ƈrz [-options]… Receives with ‡options… 1 or more files using ZMODEM batchÆ protocol. Chapter 18 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 11.Ƈ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.ÆÆ ‚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Æ 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 11. —Ƈ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.Æ 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.Æ ‡SEE ALSO:… YMODEM protocol, Chapter 11, SEAlink protocol, Chapter 11. —Ƈ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 23.Æ 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").ÆÆ The ‚setc… command performs string substitutions and character escapeÆ expansions on ‚string… before storing. The ‚sets… command performs stringÆ substitutions on ‚string… before storing. Chapter 24 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 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. This form of the ‚set… command cannot be used as theÆ predicate of an ‚if… command. ( 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. ) The argument should not appear as a label or 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 ‚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 ( Deep nesting may require a decreaseÆ in circular buffer memory allocation. ) 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…Æ 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 full speed data, and toÆ serial ports whose raw bit rate clocks are slightly fast.Æ ‚EXAMPLE…: ‡speed 1181… Sets the speed to 1181 bits per second with two stopÆ bits.ÆÆ Most timesharing minicomputers can send data from their serial ports fasterÆ than they can receive. A timesharing port that supports interactiveÆ operation at 19200 bps may not tolerate file uploads above 2400 bps.ÆÆ 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, ‡D… numericÆ parameter —Ƈ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….Æ ‚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 26 —Ƈss svar regular-expression… String Split ‚svar… according to ‚regular…-‚expression….Æ ** Regular expressions are described in Chapter 24. 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 24 —Ƈ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Æ The receiver must be commanded to receive the files.Æ ‡SEE ALSO:… Telink protocol, Chapter 11. —Ƈ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.Æ ‡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Æ 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 11. —Ƈsz [-options] [PREFIX=p | ONAME=x] pathspec… Send the files specified inÆ ‚pathspec… using ZMODEM Protocol. ( The receiver may use the ‚sz… command toÆ send files by uploading an ‚sz… command with the ‚zcommand… command. ) 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 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 11, Options, Chapter 18.ÆÆÆƇ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. —Ƈt [-modes] [capturefile]… Invokes the ‚term function… for conversational access toÆ the remote. Normally, ZCOMM will remain in the ‚term…function 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 20.Æ Characters special to the term function are also described in Chapter 20. —Ƈ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 to disk, averageÆ characters received per second, ( Since the last ‚call… or ‚restime… command. )Æ 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.Æ ‚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. 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 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. ( 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. ) 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 25Æ describes testable ‚conditions…. An inadvertently generated while loop may beÆ stopped by keyboarding ‡NUKE… (ALT-N). 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:". ( The "L" inÆ "Login" is not searched for on purpose. On Unix systems, the "l" is notÆ always capitalized. )Æ ‚EXAMPLE…: ‡while "1&&L<5" put "\r" wait -f1… Works as above, but only tries 5Æ times.Æ —Ƈ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. ( On some Unix systems, the operating system may alter the state ofÆ the serial port after ZCOMM exits. ) 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 17 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. 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.ÆƇ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 17.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. 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"Æ 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.ÆÆ The syntax of ZCOMM's redirection differs from that used by DOS and UNIX.Æ ZCOMM's output must be redirected before the command(s) are given, and theÆ redirection stays in effect until explicitly canceled. ZCOMM's commandÆ prompt is not redirected.Æ ‚EXAMPLE…: ‡bdump file0…Æ killÆ >file1Æ dump file0Æ closeÆ Dumps the contents of the modem input buffer to ‚file0…. Output is thenÆ redirected to ‚file1… and contents of ‚file0… are displayed in side by sideÆ hex/ascii format.Æ Note that the ‚create… and ‚t filename… commands do not redirect utility commandÆ output to the file. — ¼– ÆÆ ‡<<-- Function Key Commands -->>…ÆSome function keys are recognized at the command prompt. Function key commandsÆmay not be mixed with any other character. For example, keyboarding "t PgUp"Æelicits an error bell. Some scrips redefine the function keys. The standardÆassignments may be restored with a ‡gosub setup… command.Æ —ƇF2… From the command prompt, ‡F2… enters ‚term function….Æ ‡SEE ALSO:… t [file] command —ƇUp… Select the previous command in the command stack for reentry. —ƇDown… Select the next command in the command stack for reentry. —ƇHome,PgUp,End… Enter the review function. — ¼– ƇF3...F10… Function keys ‡F3… to ‡F10… are programmed by ‚set… commands in the "setup"Æ directory in the distributed telephone directory. The key definitions inÆ ‚PHODIR….‚t… may be modified or removed at your discretion. —ƇF3… Receives files with YMODEM protocol, or XMODEM. ( ZCOMM generates a fileÆ name if the sending program does not provide one. ) —ƇF4… Invokes TurboLearn Script Writer(TM) to record keystrokes and computerÆ dialog, then generates a script using this information.ÆÆ If ZCOMM is not currently connected to a system, the script called by ‡F4…Æ prompts the user for telephone number, baud rate, and parity. When recordingÆ is finished, the script prompts for a pathname to store the completedÆ TruboDial script in. —ƇF5… On Unix systems, begin background operation and issue a sub shell for theÆ user. ZCOMM operation proceeds with screen output suppressed. If ZCOMMÆ should require keyboard input before the user returns, ZCOMM waits for theÆ user to return. —ƇF6… Prompts for a file name, then receives that file with the XMODEM-CRCÆ protocol. ZCOMM will revert to the basic XMODEM protocol after a fewÆ timeouts if the sender does not support CRC-16. —ƇF7… Prompts for a file name, then transmits that file with XMODEM protocol. IfÆ the file name includes wildcard characters, or if more than one file name isÆ given, or if a directory name is given, YMODEM protocol will be used. —ƇF8… Generates and transmits a password based on the called system's name and theÆ string parameter ‡xpassword…. * This command is valid only when called fromÆ the ‚term function…. —ƇF9… Calls a script to add a new system entry to the Telephone Directory. TheÆ script prompts for a system name, and checks for duplications with entriesÆ currently in the Phone Directory. The script prompts for comments which willÆ display when that system is called. Speed and parity are then prompted for,Æ and the entry is added to the end of the Phone Directory. —ƇF10… Invokes the "help" command or help processor. —ƇShift-F1… List the Phone directory. —ƇShift-F2… Search Phone Directory for system names matching user supplied string.Æ —ƇShift-F3… List voice calls in the Phone Directory. —ƇShift-F4… Disconnect the modem from telephone line (hang it up). —ƇShift-F5… Prompt for a system name and add a command to call it to the circularÆ dialing queue. List the queue contents. —ƇShift-F6… Run (execute) the circular dialing queue.Æ —¼– ‡The following function keys are valid at the main command prompt, from the…Æterm function, and from the review function.Æ —ƇCtrl-Home… Resets display modes and clears the screen. —ƇALT-C… Writes the circular buffer to disk and ‡closes… any open send or receiveÆ file(s). ZCOMM complains if no files were open.Æ ‡SEE ALSO:… close command —ƇALT-D… Lists the current ‡directory… of the default disk.Æ ‡SEE ALSO:… dirr command —ƇALT-M… Toggles keyboard mapping.Æ ‡SEE ALSO:… ‚display mapkb… command, ‡N… numeric parameter —ƇALT-R… Enter the ‡review… function.Æ ‡SEE ALSO:… review command —ƇALT-S… Displays ‡status… on the local screen only, even if ZCOMM is in hostÆ operation.Æ ‡SEE ALSO:… s command —ƇALT-U… Toggles ‡Upper… case conversion of keyboard and file characters sent withÆ the term function ( ‚t…, ‚f…, ‡F2… commands). The answerback and programmedÆ strings are not affected. Protocol file transfers are not affected. The ‡u…Æ mode is reset by the call command.Æ ‡SEE ALSO: u… mode —ƇALT-W Writes… the circular buffer to the receive file. Equivalent to the main ‡w…Æ command.Æ ‡SEE ALSO:… w commandƇF1...FA10 etc.… The Soft Keys can be programmed (with "set" commands) either toÆ send a string of characters to the remote or to invoke a ZCOMM commandÆ sequence. Iff the string begins with "@", the remainder of the string isÆ treated as a ZCOMM command. No strings are sent to the remote from theÆ command prompt or from the review function.Æ The ‚soft keys… can be changed for each remote system or different applicationÆ programs, with ‚set… commands embedded in the appropriate telephone directoryÆ entry. The ‡ALT-K… key displays the strings assigned to these keys.Æ There are 48 soft keys, ‡f1… to ‡f12…,‡fs1… to ‡fs12…,‡fc1… to ‡fc12…,‡fa1… to ‡fa12…, plusÆ some of the cursor keys. ( ‡fs1… is obtained by ‡Shift-F1…. ‡fc1… is obtained byÆ ‡Ctrl-F1…. ‡fa1… is obtained by ‡Alt-F1….) In addition, the cursor keys may beÆ reassigned to send strings to the remote when in the term function. To listÆ them, set the ‡v… (verbose) parameter non zero ("pv1"), then give a "set"Æ command. Most soft keys have names beginning with f, and are described inÆ Chapter 23.Æ—¼– — ‡<<-- Browse Command -->>…ÆBROwse pathspec browses through the specified files. If ‡pathspec… is empty, allÆfiles are presented. For each matched pathname, the filename, date, and lengthÆare displayed. The status line displays some of the possible (one letter)Æcommands.Æ‚EXAMPLE…: ‡>>>c:bro *.c…ÆCFLOW.C 13:18:10 02-25-86 6072 ?Æapp, back, copy, Del, mv, next, page, sz, S, quit, {rR}ead, usq, view, , @ÆÆÆa, A Prompts for a pathname and then appends the current file to it. Both DOSÆ and CP/M format files are handled correctly. The ‡A… choice then deletes theÆ file.Ƈb… Backs up to the previous file. Browse will not back up past a deleted orÆ renamed file.Ƈc… prompts for a ‚target… pathname. The resulting DOS command ‡copy file target… isÆ executed by a copy of ‚COMMAND….‚COM…. ‚Target… may include the switches availableÆ with the DOS ‚copy… command. The pathnames given must be legal for DOS, with \Æ separating directories from filenames. ( Unless the DOS SWITCHAR has beenÆ changed to "/". )Æ ‚EXAMPLE…: ‡c…Æ Copy to: a:Æ SEE ALSO: "HINT" belowƇD Deletes… the file.ƇSP, CR… skip to the next file.Ƈr, R… The ‡R… subcommand first kills the circular buffer. Then read the file (orÆ as much as will fit) into the circular buffer, then call the ‡review… function.Æ The review function subcommands can be used to page back and forth throughÆ the file, write portions of the buffer to files, and so on. If review isÆ exited with the file still open, browse closes it. This subcommand is notÆ available if Restricted.Æ ‡SEE ALSO:… review functionƇn… Sends the file with the ZMODEM ‡n… option (send file only if the source isÆ newer than the destination).ƇS… sends the selected file with XMODEM protocol. The user must start an XMODEMÆ receive on the other machine.Ƈs sends… the selected file with ZMODEM or YMODEM Protocol and 1kb packets. IfÆ the other program has ZMODEM AutoDownload enabled (‡Z… mode) the fileÆ transmission will be automatic. Otherwise, the user must start a YMODEM orÆ ZMODEM receive on the other machine. The ‡s… and ‡S… subcommands are useful whenÆ issued by a remote caller browsing through files in a directory.Ƈt Tail… reads the tail of the file into the circular buffer and displays theÆ last 24 lines.ƇQ, X Quit… ends the file list. ‡X… is provided for the convenience of usersÆ accustomed to the ‚wash… and ‚sweep… programs.ƇV, Ctrl-V View… the file, whether it is a regular or SQueezed file.Ƈ!AO prompts for a DOS command and then attempts to execute it. Some DOS commands…Æ that might be useful are ‚rename…, ‚del…, ‚print…, ‚move…, ‚emacs…, ‚mince…, ‚edlin…,Æ ‚chkdsk…, and ‚chmod…. When entering the DOS command, a keyboarded ‡%… is replacedÆ by the pathname of the currently selected file.ÆÆ Please refer to the ‚!AO command for details and caveats.Æ… ‚EXAMPLE…: ‡emacs %… calls EMACS to edit the selected file.ÆƇ@… Prompts for a ZCOMM command, and then executes that command as if it had beenÆ entered at the main command prompt. The @ subcommand should not be used forÆ any command that involves file names.Æ ‚EXAMPLE…: ‡@display vt100…ÆÆ* Any other letter redisplays the file information and repeats the prompt.ÆÆAfter the file list is exhausted, ZCOMM prints the free storage remaining onÆthe default disk.ƇHINT…: Use a directory command to change the order in which the files areÆpresented for the browse command. For example, assume we have a directory ‚srcÆ…on drive c: (hard disk) and a floppy drive ‚F:… with a scratch disk inserted.ÆThe command sequenceÆ dirtÆ f:Æ browse c:/srcÆdisplays each file in the ‚src… directory beginning with the newest. Typing ‡c…Ætells ZCOMM you want to copy the file. When ZCOMM asks for the filename, justÆhit ‡… and the file is copied. (The resulting command to command.com isÆ"COPY c:/src/file"). This sequence may be used to "clean up" a directory. —¼– —¼– Æ ‡TERM FUNCTION…ÆInteractive conversation with the remote is controlled by the ‚term function….ÆThe term function provides the conversational link between the keyboard,Ædisplay, printer, and the remote computer. ZCOMM's term function also controlsÆthe capture of data from the remote, "non-protocol" sending of files andÆcommands, and recognition of the remote's responses (pattern searches).ÆÆThe term function is entered by the ‡F2…, ‚f…, ‚put…, ‚putw…, ‚t… and ‚wait… commands, andÆby the ‚rx… and ‚sx… commands when the ‡t… option is used.ÆÆNormally, the term function acts upon keyboarded characters immediately. IfÆthe term function is sending a string with the ‚put… or ‚putw… commands, or if theÆkeyboard has been locked with the ‚kbdlock… command, keystrokes are not drainedÆfrom the keyboard buffer. If ANSI KAM (Keyboard Action Mode) escape sequenceÆhas been received, keystrokes are discarded with a bleep of the bell.ÆÆNormal ASCII printing and control characters are sent to the remote. Some keysÆmay be redefined with the ‚set… command. ‡NUKE… (‡ALT-N…) returns control to theÆmain command prompt. The term function returns to its caller when an ‡F1… orƇALT-X… key is struck.ÆÆA carrier detect loss during a pattern search or a satisfied search ( UnlessÆthe ‡c… modifier was used ) cause the term function to return. Counting theÆerror count (‡e… numeric parameter) UP TO 0 makes the term function return. AnÆETX or EOT received from the remote when ‡q… mode is on also does the trick.ÆFinally, an EOF on a file uploaded with ‡x… mode, or a match on a file uploadedÆwith ‡X… mode makes the term function return.Æ ‡<<-- Major Modes of Operation -->>…ÆThe term function can operate in several ‚Major Modes… affecting keyboardedÆcharacters. ( Not all Major Modes are supported on all operating systems. )ÆƇTerminal Emulation… Normal mode operates according to the terminal emulationÆ selected. Keyboard mapping with ‚set… and ‚mk… commands is effective.ƇConference… The ‚conference command… (described at the end of this chapter)Æ provides local editing of keyboarded characters before transmission.ƇChat… The ‚chat command… links two keyboards interactively.ƇDoorway… Doorway is activated with the ‡ALT-=… key to allow function and alt keysÆ to be passed to certain BBS systems.ƇScancode… Scancode passes raw scancodes to VP/ix and similar applications.ÆÆ ‡<<-- Term Function Command Characters -->>…ÆIn the term function, soft key definitions override the keys' normal functions.ÆƇALT-=… Toggles the term function keyboard handling between ‡normal, doorway,… andÆ ‡scancode… operation.ÆÆ In ‡doorway… operation, ALT, cursor, and function keys are transmitted as NULLÆ followed by the raw scan code. This is especially useful when operating theÆ ‚PC Board ProDoor… full screen editor.ÆÆ In ‡scancode… mode, raw scan codes are transmitted for use by VP/ix and otherÆ programs that require raw IBM keyboard scan codes.ÆÆ Both ‡doorway… or ‡scancode… operation override all term function key bindingsÆ escept for ‡ALT-=… which toggles between these forms of operation.ƇBackspace… Normally the term function sends backspace to the remote without anyÆ special processing. This is ideal for most systems where backspace impliesÆ deletion of the character immediately to the left of the cursor. OtherÆ systems, including VMS, use RUBOUT for this function. The GCOS system usesÆ the # character for this function. The special requirements of these systemsÆ can be optimally accomodated by assigning a string or series of commands toÆ the BS key. Chapter 26 provides some examples.ƇF1, ALT-X… Return from the term function. ‡ALT-X… is an alternate to ‡F1… in caseÆ the user has assigned his own string or command to ‡F1….ƇF2, PgUp, PgDn, ALT-R… Enter the review function displaying data starting withÆ either the first character received after the last character keyboardedÆ (except space, Ctrl-Q, or Ctrl-S), or about 48 lines back if less than 400Æ characters have been received since the last character keyboarded. ThisÆ allows the output from the last command to be conveniently reviewed. ReviewÆ then awaits the next command.ÆÆ ‡F2… followed by "k" is a handy way to clear both the screen and the circularÆ buffer.ƇUp… Enter remote command recall and select the previous remote command forÆ editing in the status line. Backspace, and ‡Ctrl-W… may be used for editingÆ the line. ‡Ctrl-U… and ‡Ctrl-X… clear the line's contents and restore normalÆ term function operation.ƇDown… Enter remote command recall and select the next remote command for editingÆ in the status line.ƇHome… Enter review function, displaying text starting at the beginning of theÆ buffer. ‡ALT-R… is an alternate to ‡F2… in case the user has assigned his ownÆ string or command to ‡F2….ƇF3...F10, FS1...FS4… Chapter 17 describes the functions that the "setup" entryÆ in the sample ‚PHODIR….‚t… file assigns to these keys.ƇCtrl-Break… Sends a 200 millisecond (default) ‡break… signal to the remote. TheÆ function of this key may be reassigned with a ‚set… command.Æ ‡NOTE:… Some modems do not correctly pass a break signal to the remote.ƇCtrl-Shift-2… Some remote computer systems may require sending the NULL (000)Æ character. NULL may be keyboarded by Ctrl-Shift-2.Ƈ^F… Iff ‡q… (TWX) mode is in effect, transmit the string parameter ‡answerback… toÆ the remote. This is equivalent to HEREIS on a Teletype(Tm) machine.ƇEnter… Iff ‡n… mode is set, send a newline (LF). Otherwise, send the contents ofÆ ‡entstr… (default CR) to the remote.Ƈ^Q… Iff a transmit file is open and its transmission has been stopped by a XOFF,Æ transmission is resumed. Resumes counting of the inactivity timeoutÆ associated with the ‚wait… and ‚pattern… commands. Otherwise no specialÆ treatment.ƇRubout… The ASCII delete (rubout) character (hex 7F, octal 177) is generated byÆ ‡Ctrl-Backspace… (the left arrow above the ENTER key on the PC keyboard). TheÆ "Del" key near the lower right of the keyboard does not generate delete, butÆ may be programmed to do so with a "set fdel \177" command.Ƈ^S… Iff a transmit file is open, transmission is stopped. Otherwise ^S isÆ transmitted. ^S also suspends counting of the inactivity timeout associatedÆ with the ‚wait… and ‚pattern… commands.ƇALT-B… Sends a 100 millisecond ‡break… signal to the remote.Æ ‡NOTE:… Some modems do not correctly pass the break signal to the remote.ƇALT-N… The ‡NUKE… key exits from the term function with a message and cancels anyÆ scripts or functions that may have been executing.ƇALT-1… Prompts for a DOS command, then executes that command as a subroutine.Æ ‚EXAMPLE…: ‡ALT-1 whereis *.lst…ÆÆALT-2 Prompts for a ZCOMM command, then executes that command. A particularlyÆ useful command is "create file" which creates a capture file without havingÆ to return to the main command prompt. Care should be exercised not to forceÆ excessive recursion by issuing a command (such as ‚t… or ‚f…) which would invokeÆ the term function recursively.Æ ‚EXAMPLE…: ‡ALT-2 create capture.fil…Æ ‚EXAMPLE…: ‡ALT-2 display vt100…ÆÆALT-E Resets the elapsed time indication to zero.ƇALT-F Full… Duplex resets local echo of keyboarded characters.ƇALT-H… Toggles ‡Half… duplex in the sequence 0 (full duplex), 1 (local echo), andÆ 2 (local echo CR as CR LF). ‡SEE ALSO: h… numeric parameterƇALT-I… Three way toggle of ‡i… and ‡I… (Image) mode. When toggling to ‡I… (superÆ image) mode, ZCOMM's display emulation is set to ‚dumb… to disable all escapeÆ sequences, most importantly those that do strange things when used in theÆ wrong context. When toggling out of ‡I… mode, dumb terminal emulation isÆ turned off. —ƇALT-J… Toggles ‡j… (Jabberwrite) mode (q.v.).*ƇALT-K… Displays the contents of the soft ‡keys….ƇALT-L Ctrl-PrtSc… Toggles the ‡line… printer on flag. If the printer is beingÆ turned on, printing commences with the next character received from theÆ remote.ƇALT-M… Toggles keyboard mapping.Æ ‡SEE ALSO:… ‚display mapkb… commandƇALT-O… Toggles the ‡Overstrike… display mode, and restores the normal CRTÆ attribute.ƇALT-P… Toggles the ‡parity… the term function uses between 8 bits no parity, 8Æ bits graphics, 7 bits plus even parity, 7 bits plus odd parity, 7 bitsÆ marking parity (8th bit set), and 7 bits spacing parity (8 bit reset).ƇALT-V… Four way toggles ‡v… mode between normal, show control characters as ^C,Æ denote characters with parity bit (in addition to the above) set byÆ prepending a tilde (~), and display all characters in hex.*Æ ‡<<-- Term Function Control Characters -->>…ÆThe following characters are recognized by the term function when they areÆreceived from the remote.ÆƇENQ, DLE… If ‡c… or ‡C… (Compuserve) mode and ‡v… mode is not in effect, engage theÆ ‡Compuserve B+ Protocol…. This protocol is used with the FILTRN program andÆ the SIG/ACCESS DOW and UPL commands. See Compuserve's CP-MIG user groupÆ documentation for more information. Iff enabled, these codes are acted uponÆ when drained from the interrupt input buffer and are not passed to theÆ circular buffer.ÆÆThe following received characters are recognized by the term function,Æregardless of parity, when they are fetched from the circular buffer for theÆdisplay.ÆƇModem Error… Detected modem errors (parity error, framing error, break, overrun)Æ are counted in the ‡e… numeric parameter. The ‡E… numeric parameter may be usedÆ to represent modem errors as specific, searchable characters.ÆÆ A detected overrun is displayed as a large fuzzy rectangle (hex B2).ƇETX EOT Ctrl-Z… When receiving a message with the TWX protocol (in HostÆ Operation) these control characters will terminate the message.ƇENQ… Iff ‡q… (TWX) mode or VT100 emulation ("display vt") is in effect, transmitÆ the ‡answerback… string parameter to the remote. This is equivalent to HEREISÆ on a Teletype(Tm) machine.ƇBELL… Generates a tone in the speaker unless visual bell display is enabledÆ ("display bell=visual"). If the display has fallen behind the incoming data,Æ ZCOMM suppresses the bell due to the relatively long time required to performÆ a bell ring. If a file is being transmitted with the term function, a bellÆ character will pause transmission for a short time. (Some computers sendÆ bell characters to indicate their input buffers are becoming overloaded.)ƇFF… If ‡c… mode is enabled, erase the screen.ƇXOFF… Suspends file transmission from ZCOMM. XOFF is excluded from patternÆ searches and does not display unless ‡v… mode is set. After a timeoutÆ determined by the Kermit ‡s… numeric parameter (default 60 seconds),Æ transmission will resume even if no XON character is received. ( There is noÆ timeout if the parameter is 0. )ƇXON… Resumes file transmission from ZCOMM. XON is excluded from patternÆ searches and does not display unless ‡v… mode is set.ƇNULL,… Rubout (Hex 7F) and NULL (0) are not displayed unless ZCOMM is in ‡i…Æ (image) or ‡v… mode. They are excluded from pattern searches.Æ ‡<<-- Term Function - Buffer Writing -->>…ÆIf ‡e… (Emacs) mode is set, a buffer dump is performed before each keyboardedÆcharacter is sent to the remote, since normal XOFF based flow control isÆassumed to be disabled.ÆÆWhen the free space in the circular buffer is nearly exhausted, ZCOMM sends anÆXOFF character to the remote ( Assuming ‡e… mode is not in effect. ) and writesÆthe buffer contents to the receive file (if any). ( An XON is sent to theÆremote after this automatic buffer write operation. ) The circular buffer isÆalso written to the receive file as a result of a "w" command, ‡ALT-W… key, orÆonce per second if ‡j… mode is in effect.ÆÆWhen the circular buffer is written to a receive file, several controlÆcharacters are treated specially if ‡i… (image) mode is not set. Iff ‡s… mode isÆset, all control characters, except for those listed below, are excluded fromÆthe received file.ÆƇNULL ACK BELL XON XOFF RUBOUT ESC… These characters are excluded from the file.Æ Most "escape sequences" are also filtered form the cpature file. NULL,Æ DELETE, XON, and XOFF are excluded from pattern searches.ƇETX, EOT… These characters close the file if ‡q… mode is in effect, as when ZCOMMÆ is receiving a message in ‚host… state using TWX protocol.ƇCtrl-Z (CPMEOF)… Iff ‡z… mode is enabled, close the file. Otherwise thisÆ character is discarded.ƇLF… Iff ‡n… (nlmode) mode is on, a CR is written to the file before the LF.Æ Linefeed is always passed to the file.ƇCR… Iff ‡a… mode is in effect, a CR LF sequence is written to the file.Æ Otherwise, if ‡s… mode is on, CR is only written to the file as a response toÆ an LF in the circular buffer.ƇBS… Backspace is written to the file unless ‡s… mode is in effect, in which caseÆ it, and the last character written in the disk file, are deleted byÆ backspacing the file write pointer. This simulates the function of backspaceÆ on common CRT terminals.Æ ‡NOTE:… This backspacing of the file write pointer operates the same as TecoÆ and Emacs editors; it does not stop at the beginning of the line.Æ Backspacing over tab characters is tricky because it may take severalÆ backspaces to eliminate the spaces corresponding to one tab character, butÆ only one is needed to eliminate the tab character in the output file.ƇHT, FF… These characters are always passed to the file, even if ‡s… mode is inÆ effect. If ‡ss… mode is in effect, FF is not passed to the file.Æ—¼– — ‡<<-- Conference Command/Local Editing -->>…ÆWhen the ‚conference… command is given, two cursors appear. The usual cursorÆwill follow text as it arrives from the remote computer. A block cursor in theÆconference window follows the text you enter.ÆÆWhile entering text to the conference window, the standard ZCOMM editing keysÆdescribed in Chapter 16 may be used to correct keyboarding mistakes.ÆÆWhen you keyboard ENTER, LF, or ESC, or when you fill up the conference window,ÆZCOMM queues the line for transmission. The conference window cursorÆdisappears while the line is queued for transmission.ÆÆThe line is transmitted as soon as the previous line (if any) has been sent.ÆWhen transmission begins, the conference window is cleared and the conferenceÆcursor reappears, allowing the next line to be keyboarded. Attempts toÆkeyboard characters into the conference window before transmission begins willÆring the bell and be discarded.ÆÆWhen in the ‚conference… command, the function keys operate the same way as theyÆnormally do in the term function. The review subcommands (F2, PgUp, etc.) mayÆbe used to review portions of the conversation that have scrolled off the mainÆscreen. The exit command ‡F1… causes any characters entered in the conferenceÆwindow to be discarded.ÆÆThe following characters are passed directly to the remote and are not enteredÆinto the conference window: ‡ETX SI DLE XON XOFF DC2 DC4… (^C ^O ^P ^Q ^S ^R ^T).ÆÆTransmission from the conference window is controlled by the ‡t, p,… and ‡w… modesÆand their associated parameters. If none of these modes are set, the line isÆtransmitted at full speed. If Half Duplex mode ‡h… is set, ZCOMM echoes the lineÆas it is transmitted. If ‡H… is set, a linefeed is transmitted and displayedÆafter the carriage return. —¼– —¼– Æ ‡REVIEW FUNCTION…Æ‚Review function… commands page, search, cut, paste, and otherwise manipulateÆcaptured data stored in the circular buffer.ÆÆThe review function displays the approximate location of the displayed textÆwithin the circular buffer as a percentage of the buffer contents on the statusÆline. Unless ‡i… mode is in effect, escape characters are printed as ‡$… (dollarÆsign) so they will not interfere with scrolling.ÆÆReview subcommands consist of a single character preceded by an optionalÆnumeric argument. (The default value is 1.) The numeric digits and the commandÆare not echoed as they are entered. For example, keyboarding ‚69…+ moves down 69Ælines.ÆÆYou don't have to wait for the screen to fill before entering the next reviewÆsubcommand. This comes in handy with the ‡n… subcommand. Since the ‡N… subcommandÆsearches in the reverse direction, you can thumb through messages (by searchingÆfor the subject header) very quickly, knowing that you can back up if you wentÆpast something interesting.ÆÆ ‡<<-- Review Subcommands -->>…ÆDefined soft keys are executed from review iff they do not conflict with theÆpermanent definitions.ÆƇCtrl-L, Ctrl-Home… Ctrl-L (form feed) clears the screen and refreshes theÆ display without moving it. Ctrl-L is useful after an error printoutÆ within review, or after a subcommand that writes to the screen such asÆ ALT-D or ALT-S.Ƈa… Toggles the ‡autowarp… display mode, then refreshes the display. If theÆ ‡autowrap… display mode is enabled, long lines can be viewed, but will causeÆ lines at the top of the screen to scroll off.ƇG… Go to the Nth line and display from there. If N is omitted, go to the endÆ instead.ƇHome… Display starting at the beginning of the capture buffer.Ƈr, R… If a file is open as a result of a ‚read… command, read some more of theÆ file into the buffer, replacing about 3/4 of the previous buffer contentsÆ (all if ‡R… subcommand). A successful ‡r… subcommand erases the pointers setÆ by the ‚t… and ‚b… subcommands. The data read in from the file may overwriteÆ the data currently displayed on the screen. In this case, ZCOMM displaysÆ data starting with the oldest.ƇF2, PgUp, ^B, *… Display the Nth previous page (one line overlap is provided).ƇSP, PgDn, ^F… Clear screen and display the next Nth page.Ƈs, /… Accept a search ‡string…, terminated by RETURN. This string may haveÆ character escapes. Search through the buffer for the Nth instance ofÆ ‡string…. Lower case characters in ‡string… match either case; upper caseÆ characters in ‡string… match upper case characters only. The display startsÆ with that line. If the search is unsuccessful, ring bell. The searchÆ begins at the top of the display.Æ ‡SEE ALSO:… ?, n, N subcommandsƇ?… Prompts for search string as above, then searches backwards for the NthÆ occurrence of string starting with the line above the top of the buffer.Ƈn Next… searches for Nth occurrence of the previously entered string in theÆ direction of the last "/" or "?" subcommand. Typical usage would be toÆ search for the first occurrence with the "/" subcommand, then use "n" toÆ find more matches.ƇN Next… searches for next Nth occurrence of the previously entered searchÆ string in the opposite direction to the original "/" or "?" subcommand.ƇUpCursor, -… Backup N lines and redisplay.ƇDownCursor, +, Ctrl-J(LF)… Move the display down N lines and redisplay.ƇEnd… Go to the buffer end (where the most recent data is) and display.Ƈx eXit… returns to the previous function, and makes the term functionÆ redisplay the last page of buffer contents. ( When the term functionÆ takes control, which is immediately if review was called from the termÆ function. ) This restores the screen and keyboard to the same state theyÆ were in before review was entered. The x subcommand allows you to seeÆ where you were if you were in the midst of keyboarding a command to theÆ remote when you entered review.ÆÆ ‡EXAMPLE:… Suppose you are typing in a line of commands and you need toÆ "thumb back" through the remote's output for some vital nugget ofÆ information. (After you enter a 20 line email reply message, NOWÆ Compuserve asks you for a certain random 8 digit account number to mail itÆ to) No sweat, just hit some PgUp's until you see the account number onÆ the screen. Now you can't remember whether or not you typed a space afterÆ the last part of you command to the remote. No problem, just exit reviewÆ with x and you'll see just where you were.Æ ‡NOTE:… This subcommand should not be used when scripts are active.Ƈk Kill… the capture buffer contents and return to the previous function.ƇCtrl-Z, Ctrl-PgDn… Kill the rest of the buffer by setting the characterÆ insertion pointer to just after the end of the current display. ZCOMMÆ then redisplays the last lines of the buffer and returns to the previousÆ function.Ƈt… Set the cut pointers to the ‡top… of displayed text, and sets the bottom cutÆ pointer to the end of the buffer. The ‡t… subcommand is used with the bÆ subcommand to specify which portion of the circular buffer should beÆ written to a file with the ‡w… subcommand. (Text between the ‡top… and ‡bottom…Æ pointers is highlighted.)Ƈb… Set the bottom pointer to the beginning of the first line of displayedÆ text. If the top pointer had not been previously set, or if the ‡bottom…Æ pointer is before the ‡top… pointer, ZCOMM will ring the bell and ignore theÆ subcommand. Otherwise, the text on the screen that was highlighted willÆ now be displayed in normal intensity as what is showing on the screen hasÆ just been deselected. (Text between the ‡top… and ‡bottom… pointers isÆ highlighted.)Ƈw, W Write… (paste) the text between the top and bottom pointers to a disk fileÆ or DOS device. ( Useful DOS devices are PRN, LPT1, LPT2, and LPT3. ) IfÆ the top pointer is not set, a reminder is printed. ZCOMM prompts for aÆ pathname. A blank file name implies the modem. ( Data is sent to theÆ modem at full speed with the current parity. Normally, line feeds are notÆ sent. With ‡n… mode, line feeds are sent and carriage returns areÆ suppressed. With ‡b… mode, data is sent the way it was received. ) If theÆ bottom pointer is not set, the rest of the buffer will be written. No logÆ entry is made by this subcommand. The ‡W… subcommand automatically appendsÆ the paste data to an existing file. A directory for past files may beÆ specified with the ‡DIRPX… environment variable and/or the ‡dirpx… stringÆ parameter.Ƈq, F1, ALT-X… Quit, return to previous function.Ƈ!AO Prompts for a DOS command, then attempts to execute it (DOS Gateway).…Ƈ@… Prompts for a ZCOMM command, then executes it.Æ—¼– —¼– Æ ‡RUNNING ZCOMM…ÆBefore running ZCOMM, the keyboard ‡Caps Lock… should be turned off. ZCOMMÆcommands and most arguments must be entered in lower case.ÆÆ ‡<<-- Running ZCOMM from DOS -->>…ÆZCOMM is called from DOS as ‡ZCOMM [DPORT=n] [command ...]…ÆÆThe following special commands may be given from the command line only.ÆƇDPORT=n… is an optional override to the default comm port. If another programÆ is using the default comm port, ZCOMM may be told to use another portÆ to prevent interference.Æ ‡SEE ALSO: DPORT… environment variableÆÆ‚Command… may be any desired combination of ZCOMM commands. Command lineÆarguments to ZCOMM must be in lower case except as noted.Æ‚EXAMPLE…: ‡C>ZCOMM call cissig… invokes ZCOMM and executes the commands in theÆ"cissig" telephone directory entry.Æ‚EXAMPLE…: ‡C>ZCOMM DPORT=2 call othersys…ÆSelects COM2 before initializing the serial portÆÆ ‡<<-- DOS Environment Variables -->>…ÆDOS environment variables are set with the DOS ‚set… command in the form ‡SET…ÆVARIABLE=VALUE given in a batch file or at the DOS prompt.ÆƇNOTE:… There must not be any spaces before or after the "=" sign. If you setÆmany environment variables, DOS will quietly forget some of them unless youÆtell DOS to make more room for them. You can issue the DOS "set" command byÆitself to check the accuracy of DOS environment variables.ÆÆZCOMM searches the DOS Environment for the following variables:ÆƇCBSIZE… overrides the default allocation for the circular buffer.** If memory isÆ limited, the DOS command ‡SET CBSIZE=3000… will leave more memory for DOSÆ Gateway or other programs. ‡CBSIZE… may be set as high as 65500.Æ ‚EXAMPLE…: ‡C>SET CBSIZE=65000…ÆÆCOMSPEC ZCOMM uses the DOS ‡COMSPEC… environment variable to load ‚COMMAND….‚COM… orÆ similar program to parse and execute DOS gateways (shell escapes).ƇDIRRX, DIRSX, DIRCX, DIRPX, DIRFX… Contain optional receive (DIRRX), sendÆ (DIRSX), capture (DIRCX), paste (DIRPX), and file (DIRFX) directoryÆ presets. When ZCOMM starts, these environment variables preset theÆ ‡dirrx, dirsx, dircx, dirpx… and ‡dirfx… string variables respectively.ƇDIRSIZE… controls the number of directory items that may be sorted with eachÆ wildcard. It should be set to 23 * times the desired number of entriesÆ (default = 200). If more directory entries are encountered, they areÆ processed without sorting.Æ ‚EXAMPLE…: ‡C>set DIRSIZE=8000…ÆÆDPORT overrides the default modem port (COM1) initially accessed by ZCOMM.Æ ‚EXAMPLE…: ‡C>set DPORT=2…Æ The DPORT environment variable can also be specified as a hex portÆ address,vector number pair.Æ ‚EXAMPLE…: ‡C>set DPORT=2f8,5…Æ SEE ALSO: ‚portx… commandƇEGA… Stting this to ‡MONO… causes ZCOMM to use video mode 7 for 80x25 columnÆ text instead of the default video mode 3. This is needed when using someÆ EGA cards with an Monochrome MDA compatible monitor.Æ ‚EXAMPLE…: ‡C>set EGA=MONO…ÆÆHOTPORT Suppresses the "Warning: Old dport=" message (q.v.) seen when Zcomm isÆ called from certain operating systems or programs.Æ ‚EXAMPLE…: ‡C>set HOTPORT=1…Æ SEE ALSO: ‚port…, ‚portx… commandsƇMODEM… Describes the type of modem used by the ‚mm224e….‚t… script. See Chapter 7Æ for details.Æ ‚EXAMPLE…: ‡C>set MODEM=mm224e.t…ÆÆPATH must include the directories containing ‚ZCOMM… and the help processor ‚YHP….ƇPHONES… overrides the default pathname used to fetch ZCOMM's telephoneÆ directory. Forward slashes should be used to indicate directories.Æ ‚EXAMPLE…: ‡C>set PHONES=c:/yam/phones.t…ÆÆYAMQUIET Inhibits the display and locks the keyboard, preventing ZCOMM fromÆ writing on the screen. * This is useful when calling ZCOMM from anotherÆ program.Æ ‚EXAMPLE…: ‡C>set YAMQUIET=257… Performs the equivalent of an initial ‡kbdlock…Æ 257 command.Æ ‡SEE ALSO:… ‚kbdlock… commandƇZONE… sets the ‡z… numeric parameter to the number of minutes the current localÆ time lags GMT time.Æ ‚EXAMPLE…: ‡C>set ZONE=420…Æ SEE ALSO: z numeric parameterÆÆBefore running the X.PC* version of Pro-YAM, you must run the Tymnet X.PCÆdriver to make it resident by calling the driver from DOS. The driverÆannounces itself and returns control to DOS. The Tymnet X.PC driver usesÆapproximately 40kb memory.Æ‚EXAMPLE…: ‡xpcmain…ÆÆ <<-- Help Program Environment Variables -->>ÆThe flash-up help processor program ‚YHP… examines the environment for theƇNORMATTR…, ‡REVATTR…, and ‡UNDLATTR… variables. These set help screen parametersÆfor normal, reverse video, and underline attributes corresponding to the ‡n…,‡r…,Æand ‡u… numeric parameters.Æ‚EXAMPLE…: ‡C>set NORMATTR=3…ÆÆ <<-- Dialing out from Unix -->>ÆZCOMM is called from Unix as ‡[DPORT=S] yam [command ...]…Æ‚DPORT…=‚S… is an optional override to the initial default serial line.ÆIf another program is using the line, ZCOMM complains that the port is busy andÆwill refuse to open it.Æ‚Command… may be any desired combination of ZCOMM commands.Æ‚EXAMPLE…: ‡yam call cissig… invokes ZCOMM and executes the commands in theÆ"cissig" telephone directory entry.Æ‚EXAMPLE…: ‡DPORT=tty77 yam call othersys…ÆSelects /‚dev…/‚tty77… before executing the ‚othersys… telephone directory entry.ÆIf ZCOMM is run in the background, it will exit if it reaches the main commandÆprompt.Æ‚EXAMPLE…: ‡yam call cissig&…ÆAs a form of shorthand, ZCOMM may be invoked as ‚call… if that is the command toÆbe executed.Æ‚EXAMPLE…: ‡call cissig…ÆÆ <<-- X Windows -->>ÆWhen run under the X Windows ‚xterm…(‚1…) interface program (indicated by the UnixƇTERM… environment variable), ZCOMM understands xterm's keyboard mappings forÆfunction and ALT keys.ÆÆ ‡<<-- UNIX/XENIX Environment Variables -->>…ÆÆÆUnix/Xenix ZCOMM flavors search the Environment for the following variables:ÆƇCBSIZE… overrides the default allocation for the circular buffer. On 32 bitÆ systems, the maximum ‡CBSIZE… is limited only by the operating system'sÆ process size limit.Æ ‚EXAMPLE…: ‡CBSIZE=300000; export CBSIZE…ÆÆDIRRX, DIRSX, DIRCX, DIRPX, DIRFX Perform the same function as described forÆ the DOS flavor above. (Since Unix does not use colon (:) as a deviceÆ specifier, Unix flavors do not treat colon(s) in pathnames in any specialÆ way.)ƇDPORT… overrides the default modem port initially accessed by ZCOMM.Æ ‚EXAMPLE…: ‡DPORT=tty12; export DPORT…ÆÆHZ Indicates the number of kernel "clock ticks" per second. This calibratesÆ terminal function timeouts, protocol timeouts, and the ‚sleep… command.Æ The ‡HZ… environment variable must be set if the value used by your systemÆ is not 100 clock ticks per second.ƇLOGFILE… Specifies the pathname for the log file (default: /‚tmp…/‚yamlog….‚tmp…)Æ created by the ‡-v… option when invoking ZCOMM as ‚xyam…, ‚rz…, ‚sz…, ‚rb…, ‚sb…, ‚rx…,Æ or ‚sx….Æ ‡SEE ALSO: v… optionƇMODEM… Describes the type of modem used by the ‚mm224… script. See Chapter 7 forÆ details.Æ ‚EXAMPLE…: ‡MODEM=MM224E; export MODEM…ÆÆPATH must include the directories containing ‚yam… and the help processor ‚yhp….ƇPHONES… overrides the default pathname used to fetch ZCOMM's telephoneÆ directory.Æ ‚EXAMPLE…: ‡PHONES=/usr/lib/local/localphone.t; export PHONES…ÆÆSHELL ZCOMM uses this environment variable to select the appropriate programÆ for its shell escapes.ƇTERM… If the ‡TERM… environment variable contains ‚xterm…, ‚xterms… or anything elseÆ beginning with ‚xterm…, ZCOMM assumes it is operating as a subprocess toÆ the Xwindows ‚xterm…(‚1…) program, enabling a term function status line ifÆ the ‡X… numeric parameter allows.Æ ‡SEE ALSO: X… numeric parameter The ‡LINES… and ‡COLUMNS… environment variablesÆ preset the ‡#… and ‡$… numeric parameters respectively. This assumption mayÆ be overridden by setting the ‡X… numeric parameter.Æ If the ‡TERM… environment parameter contains the string ‡401… indicatingÆ emulation of a Tektronix 4010 series storage tube terminal, status lineÆ updates are inhibited when Tek graphics is active.Æ If the ‡TERM… environment parameter begins with "wy" (as in "wy60") ZCOMMÆ will use and recognize Wyse escape sequences. The ‡TERM… environmentÆ variable is also checked for ‡AT386… which enables a different decoding ofÆ keyboard escape sequences.ƇUUCPLOCK… If ‡UUCPLOCK… contains "/usr/spool/locks/LCK.." ZCOMM uses "HoneyÆ Danber" uucp port arbitration conventions.ÆÆ ‡<<-- Dialing in to Unix -->>…ÆUnix flavors may be used for dial-in applications to transfer files andÆcommands with programs logged in to terminal ports. The commands ‚rz…, ‚sz…,Æ‚zcommand…, and ‚zcommandi… perform the same functions as the corresponding ZCOMMÆcommands. They may be given directly to the shell or executed from a shellÆscript or Makefile.Æ‚EXAMPLE…: ‡sz -Yn *.c *.h…ÆÆThe Makefile fragment below commands a DOS ZCOMM logged into a serial port toÆclear its ‡dirrx… string parameter, change to its root directory, and then sendsÆa new version of the executable to the DOS machine.Æ‚EXAMPLE…: ‡cpsz:/tmp/yam.exe…Æ @zcommand 'set dirrx ""'Æ @zcommand "c:;cd /"Æ @sz -y /tmp/yam.exeÆMore general command sequences or other protocols such as Kermit may beÆaccessed with the ‚xyam… command.Æ‚EXAMPLE…: ‡xyam kermit sb *.c *.h…Æ‚EXAMPLE…: ‡xyam z pl256 sz -Yn *.c *.h…Æ <<-- Initialized Logins -->>ÆWhen a user logs in, the Unix shell executes commands in .‚profile… in the user'sÆhome directory. This can be used to accept file(s) from callers, send file(s),Æperform suitable processing, and log out the user automatically.ÆÆThe following .‚profile… disables hangup and interrupt signals, then invokes ‚xyamÆ…to execute commands in a script.ÆƇset -e…Ætrap "" 1 2 3Æxyam source inbound.tÆexitÆÆThe following ‚inbound….‚t… receives a file from a hand held aviation recorder.ÆÆ ‡echo "Send XMODEM file"…Æ ena -dÆ rx -y airlink.tmpÆ if ? echo "File Received"Æ if ? echo "Sorry."Æ—¼– — ‡<<-- 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.ÆÆƇ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.ÆÆ—¼– — ‡Modes modifying the Term Function…ÆÆ ‚The modes grouped below are mutually exclusiveÆÆ…‡b… Binary file transmit (no editing)Ƈn… Send LF at end of line or ENTER. Received LF > CR/LFƇp,P… Send eolstr (default CR) at end of line, wait for prompt character ( ‡g…Æ numeric parameter)Ƈr… Send ‡eolstr… (default CR) at end of lineƇw… Send ‡eolstr… (default CR) at end of line and wait for echoes to stopÆÆƇ+… Append to existing file if presentƇy… Replace existing file if presentÆÆƇ7e, 7o, 8, 8n… 7 bits even/odd parity, 8 bits no parityƇ8g… 8 bits no parity, display graphics charactersÆÆ ‚The following modes may be specified in combinationÆÆ…‡!… negates the ‡remainder… of the argumentƇa… Add LF to received CR in capture fileƇb… Send files ‚binary…, no editingƇc,C… Enable Compuserve B Protocol, (C) no screen clearƇd… Suppress carrier detect monitoringƇD Delay… carrier lost detection (Cellular Radio / Call Waiting)Ƈe… Suppress automatic XOFF when circular buffer fullƇE… Enable ‡Error Containment(Tm)… to reduce line hit data lossƇf… Set full duplex (no local echo)Ƈf | F | T… Temporary pattern match seconds timeout, (F,T) not reset byÆ characters from modem, (T) detects automatic file xferƇg… Resume transmitting file (!g stops)Ƈh, hh… "Half Duplex" local echo, ‡hh… echo CR as CR/LFƇi… Image (transparent display and capture)ƇI… Super Image (binary display and capture)Ƈj… (Jabberwrite) write circular buffer 1/secondƇJ… (Jiffy) speeds YAM response time (Unix/Xenix)Ƈl… Enable printerƇq… Enable answerback transmission, TWXƇs, S… Strip control characters, more with ‡S…Æsss Also don't display blank linesƇt… (Throttle) Slow file and string transmissionƇu… Uppercase transmit conversionƇv… Display control characters as ^C, ‡vv… denote 8th bit with ~Ƈvvv… Display characters in HEXƇx… Exit term function at EOF of transmit fileƇz… Close receive file on CPMEOF (^Z), append ^Z to capture filesÆ—¼– — ‡Protocol File Transfer Options…Æ (‚rb…, ‚rc…, ‚ro…, ‚rw…, ‚rx…, ‚rz…, ‚r7…, ‚rt…, ‚sb…, ‚sx…, ‚sz…, ‚s7…,and ‚st… commands)Æ #Does not apply to Kermit ##ZMODEM onlyÆƇ+… Append to exisiting file if presentƇ7… Mask Kermit send data to 7 bitsƇa… Change NL in received file to CR/LF #Ƈb… Transfer file in binary (no translation) ##Ƈe… Escape control characters ##ƇE… Escape parity bits on 7-bit paths##Ƈf… Send full pathname (Kermit/YMODEM/ZMODEM only)ƇF… Pause briefly after sending each ZMODEM data subpacketƇg… YMODEM-g no wait for ACKs (Given to receiving program)Ƈi… Image format (VMS Stream_LF record format) #ƇI… Image format (VMS Variable length binary record format) #Ƈk… Send 1024 byte blocks #Ƈm… Request MobyTurbo(Tm) accelerator##ƇM… Deny MobyTurbo(Tm) accelerator requests##Ƈn… Transfer file iff source newer##ƇN… Transfer file iff source newer or longer ##Ƈo… Use ‡OverThruster(Tm)… on X/YMODEM receiveÆ Force 16 bit CRC (default 32 bit CRC) ##Ƈp… (Protect) bypass file if destination file present ##ƇP… Pack data when used on 7-bit paths##Ƈr,rr… Resume/Recover (rr: more careful check) transfer ##ƇS… Request receiver's serial number ##Ƈt… Enter term function afterwardsƇu… Unlink (delete) file after it is sent ##Ƈv… View data as it is transferred #Ƈw[]… Restrict transmit window to (4096) bytes ##ƇW[]… Make remote sending program use (4096) byte window ##Ƈy… Replace existing destination file (if present)ƇY… Transfer file only if destination file present ##ƇzT… Use timezone T for this transfer #ƇZ… Send file(s) with compression ##ƇPREFIX=p… Prefix destination pathname(s) with ‡p… ##ƇONAME=x… Destination pathname is ‡x… ##Æ—¼– — ‡<<-- Automatic File Transfers -->>…ÆÆKermit, ZMODEM, and Compuserve-B file transfers can be automatically initiatedÆby the remote computer when ZCOMM is in the ‚term function….ÆÆAutomatic Kermit file downloads are enabled with ‡K… mode (set by default).ÆKermit dialect resolution is automatic, but may be overridden with ‡7… mode andÆthe kermit ‡7… and ‡8… numeric parameters.ÆÆZMODEM file and command AutoDownload is enabled by ‡Z… mode (set by default).ÆÆCompuserve-B is controlled by ‡c… mode (not enabled by default).Æ‚EXAMPLE…: ‡t -c… enables B protocol and enters the term function.ÆÆFile transfer options for ZMODEM and Kermit AutoDownloads may be specified withÆthe ‡adlopts… string parameter.ÆÆ—¼– —¼– Æ ‡NUMERIC PARAMETERS…ÆNumeric parameters are set with the ‚p… command in the form ‚px…# where ‡x… is theÆone letter name of the parameter and "#" is the numeric value.ÆÆNumbers may have an optional leading "-" (minus) sign. Numbers are normallyÆdecimal, but hex numbers may be input as 0xHH, printing ASCII character valuesÆmay be entered as 0cC, and control characters may be represented as 0^C.ÆÆValue Possible entriesÆ65 65 0x41 0cAÆ3 3 0x3 0^CÆÆTyping "p" without a parameter name displays the current values of the numericÆparameters in decimal.Æ‚EXAMPLE…: ‡pS5… sets the timeout interval in seconds waiting for XON characters orÆpositive flow control. to decimal 5 seconds.Æ‚EXAMPLE…: ‡pv-1… sets the ‡v… numeric parameter to -1, suppressing some routineÆmessagesÆƇ#… The ‡#… numeric parameter sets the number of lines used by the built inÆ display driver. The default value is 24. A value of 25 may be used forÆ applications which require access to all 25 display lines. A small valueÆ may be used when running ZCOMM under TopView to fit the information into aÆ small window. The ‡cls… or ‚reset… command should be given after setting theÆ parameters to initialize the screen driver to the new values. If runningÆ with a virtual screen with TopView or DESQview, the ‡#… and ‡$… numericÆ parameters are limited to 24 by 80 maximum. Full screen applications mayÆ give abnormal displays if these parameters are set too small. NonsensicalÆ values tend to produce nonsensical displays.Æ ‚EXAMPLE…: ‡cls; p#9; reset… clears the screen, sets a 9 line window, andÆ initializes the screen driver to the new value.Ƈ$… Sets the number of CRT columns. A ‚cls… or ‡reset… command should be givenÆ after changing the ‡$… numeric parameter. The default value (80) is thatÆ returned by the BIOS video interrupt 15h call. This parameter may be set toÆ support 132 column displays if the 132 column display mode is set beforeÆ ZCOMM is called. ( With most display BIOS ROMs, ZCOMM reads the columns andÆ lines values from the BIOS when starting up or regaining control after a DOSÆ Gateway. ) ZCOMM does not support displays less than 80 columns wide. TheÆ display hardware must use the same number of columns as the ‡$… parameter ifÆ the resultant presentation is to make any sense.Æ ‡SEE ALSO: #… and ‡V… numeric parametersƇ-… If non zero, the DOS Gateway (used with the ! command, etc.) uses theÆ undocumented DOS 37h function to fetch the current value of SWITCHAR.Æ If negative, ZCOMM uses DOS line input (function 0xA) for commands givenÆ from the main prompt. This enables DOS command line editors such as ‡CED….Æ When these editors are active, they (and not ZCOMM) interpret control,Æ function and ALT- keys.Ƈ*… Sets the CRT attribute for highlighted messages.Æ ‚EXAMPLE…: ‡p*12… gives bright red.Æ Adding 1024 to this parameter forces ANSI SGR 1 to use this color.Ƈ?… Count of the number of files sent or received with a protocol, and theÆ number of lines matched by the ‚find… command. A failed password validationÆ sets this negative. The exit status of subprograms is stored in thisÆ parameter. Because of a bug in DOS COMMAND.COM, the return value is validÆ only with Unix/Xenix flavors.Æ ‡SEE ALSO: ?… test conditionƇ@… Sets the CRT attribute for the (normally) blinking messages such as FILESÆ OPEN. The numeric values are explained below, with the ‡n… numeric parameter.Æ ‚EXAMPLE…: ‡p@12… makes ZCOMM's normally blinking messages appear bright red.Æ Adding 1024 to this parameter forces ANSI SGR 5 and 6 to use this color.ƇA… If non 0, selects a prefix character which allows ALT characters to beÆ generated by keyboards without ALT keys. This parameter is supported onÆ VAX/XMS and Unix platforms; please refer to the platform specific addendumÆ file for specifics.ƇB… If set non zero (the default), causes a ‚bye… command to be issued each time aÆ telephone number is executed as a command.Æ ‡SEE ALSO: mcommand… string parameter, number dialing commandsƇC… If non zero, only display ‡C… ESC sequences per screen in the Review Function,Æ and count escape sequences when advancing or backing up in the reviewÆ buffer. Otherwise, ESC sequences are not counted.ƇD… A nonstandard raw bit rate source is required to support transmission speedsÆ above 115200, as well as intermediate bit rates (64000, 156000). NonÆ standard raw bit rate sources can be accomodated with the ‡D… numericÆ parameter (PCDOS flavor only). Newer UART chips can use raw bit rateÆ sources up to 8 MHz, more than 4 times as fast as the IBM standard 1.84320Æ MHz. Some 386 and 486 machines support MobyBaud(Tm) operation above 115200Æ bps.Æ To support a nonstandard bit rate source, multiply 5760 by the new raw bitÆ rate source frequency divided by 1.84320.Æ ‚EXAMPLE…: ‡pD22372… supports a 7.158 MHz raw bit rate source (5760 * 7.158 /Æ 1.8432).ÆƇE… If non 0, substitute this for characters with bad parity detected by theÆ term function with ‡e… mode (Error Containment(Tm)).Æ ‚EXAMPLE…: ‡ena -7e; pE63… Substitute ‡?… for characters received with oddÆ parity.ÆƇF… Sets the CRT attribute for dim (faint) messages such as ANSI SGR2.Æ ‚EXAMPLE…: ‡pF8… gives gray.ÆƇG… This parameter controls the number of bytes loaded into the 16550A transmitÆ FIFO (First In First Out) storage register on each interrupt. ThisÆ parameter is effective only with PCDOS machines using FIFO buffered UARTÆ devices.Æ For maximum efficiency, ZCOMM fills the 16 byte transmit FIFO when the UARTÆ generates a FIFO Empty interrupt. Once loaded, data transmission from theÆ transmit FIFO cannot be stopped. Many bytes may be sent after the modemÆ sends XOFF or asserts hard flow control restraint. Well engineered modemsÆ accept a large number of bytes after exerting flow control restraint, butÆ some don't.Æ To improve Zcomm's responsiveness to flow control restraint, set thisÆ parameter to 0.Æ ‚EXAMPLE…: ‡pG0…ÆÆH In Host Operation, sets the timeout in seconds for entering a command orÆ string in response to a command or other prompt, including the ‚acceptÆ… command. A value of 0 (the default) disables this timeout.ƇI… Set the size of disk I/O buffer used for protocol file transfers. SuitableÆ values are 2048, 4096, 8192, and 16384. It may be necessary to specify aÆ ‡CBSIZE… environment variable larger than 10240 to prevent the circular bufferÆ from competing with disk I/O buffers for near heap space. Too large a valueÆ may exhaust memory, induce receiver timeouts, cause disconnects(), orÆ generate spurious errors on file transfers.Æ If your copy of ZCOMM is running on a floppy disk system or a slow hardÆ disk, a larger value may give better results. A large value may also beÆ used in extra high speed direct connect file transfers where the ‡I… and theÆ ‡zmodem l… numeric parameters are both set to 8192 or 16384 on the receivingÆ system.Æ ‚EXAMPLE…: ‡pI4096…Æ Please understand that the ‡B… parameter has nothing to do with anythingÆ you've heard about 128, 1024 or 8192 byte XMODEM style blocks. Normally,Æ ZMODEM's block size is the entire file.ƇK… If non 0, executes keyboard BIOS calls to recover extended codes from 101Æ key keyboards.ƇN… When enabled with ‚display mapkb…, this parameter controls the relationshipÆ between ANSI/VT52 Alternate Keypad mode (DECKPAM, ESC=), ANSI Numeric KeypadÆ mode (DECKPNM, ESC>), and the PC's keyboard Num-Lock state.ÆÆ ‡0… causes ZCOMM to set the PC's keyboard Num_Lock state to match NumericÆ Keypad mode when DECKPNM or DECKPAM is received.Æ ‡32… causes ZCOMM to set the PC's keyboard Num_Lock state to the opposite ofÆ Numeric Keypad mode when DECKPNM or DECKPAM is received.Æ ‡1… causes ZCOMM to set the PC's keyboard Num_Lock on in response to eitherÆ DECKPNM or DECKPAM.Æ ‡2… causes ZCOMM to set the PC's keyboard Num_Lock off in response to eitherÆ DECKPNM or DECKPAM.Æ ‡SEE ALSO:… ‚display…, ‚mk… and ‡ALT-M… commandsƇO… Controls ‡OverThruster(Tm)… operation with XMODEM, XMODEM-1k, YMODEM, andÆ YMODEM-1k downloads. This parameter should be set as follows:ÆÆ ‡CompuServe XMODEM… This OverThruster mode is known to be effective onÆ CompuServe. Negative numbers control the number of bytes added to theÆ window on XMODEM downloads from the network. Larger numbers increaseÆ throughput, but cause improperly interfaced MNP modems and networkÆ nodes to drop characters under stress, disrupting the file transfer.Æ ‚EXAMPLE…: ‡pO-512; ro file1.ext…ÆÆ Other XMODEM Positive numbers up to a system dependent value less than theÆ protocol block size increase throughput. Larger values induce timeoutsÆ and/or retransmitted blocks. The optimum value must be determined byÆ experiment. If you see the message: Retry 0: Received dup Sector ‡very…Æ often, the value should be reduced. 60 usually give best results withÆ MNP modems at 2400 bps. The optimum value varies depending on theÆ remote computer, modem(s), system traffic, and the network node.Æ ‚EXAMPLE…: ‡pO60; ro file1.ext…ÆÆP After a "speed" command, if you give a ‚p… command (display parameters), the ‡P…Æ parameter value will indicate the type of serial I/O UART chip detected.Æ ZCOMM automatically detects and enables the FIFO on the NS16550A,Æ NS16550AFN, and Intel 82510 chips.Æ ‚EXAMPLE…: ‡Zcomm port 1 speed 19200 p…ÆÆ 0 Indicates a standard 8250 or 16450 UART with no special features.ÆÆ 1 Indicates an NS16550AN or NS16550AFN with 16 deep receive FIFO. TheseÆ are the preferred chips.ÆÆ 2 Indicates an Intel 82510 with 3 deep receive FIFO.Æ The sequence "port 1 pP1 speed 19200" bypasses ZCOMM's verification checksÆ normally performed on the FIFO configuration and may allow defective FIFOÆ logic on certain chips to be used. This incantation is not required for theÆ NS16550AN or NS16550AFN.Æ The sequence "pP-1 speed 2400" should be used with the Western DigitalÆ WD16550 chip to disable the brain damaged FIFO on that chip. The WD16550Æ FIFO has been observed to lose data when transmitting at 2400 bps and slowerÆ speeds. The minimum speed for normal transmit FIFO operation with theÆ WD16C550 may vary with different computers.ÆƇR… If non zero, remove incomplete files received with a protocol except thoseÆ received with the ‡+… option (default 0).ÆƇS… Timeout interval in seconds waiting for XON characters or positive flowÆ control (default 30). If an XON is not received within this time,Æ transmission resumes anyway. A value of 0 disables this timeout.ÆƇT… If Command Reentry has been enabled with the ‚history… command, the ‡T…Æ parameter prevents commands with fewer than ‡T… characters from being storedÆ in the history file. Excluding short and easy to type commands from theÆ history file makes it easier to find the commands that are difficult toÆ keyboard.ÆÆ Setting ‡T… to a large number disables the storage of commands and strings.Æ This may be used to exclude passwords and other sensitive information fromÆ the history file.Æ ‡SEE ALSO:… ‚history… commandÆƇV… VIDEO BIOS display mode to switch the display to 132 columns in response toÆ a VT-100 DECCOLM mode set command. To support boards using an extended codeÆ in the bl register, calculate N = bl + (256 * al).ÆÆ A popular value is 35 for the Tseng, ATI, and other extended EGA boards.Æ The Genoa Super EGA Hi-Res likes 96. The Everex EVGA uses 28684. TheÆ default value of 0 inhibits this function.ÆƇW… This numeric parameter supports Video7 and similar boards which require aÆ non 0 value in the AH register on INT 10h bios calls for setting video modesÆ (e.g., 132 columns). The value of the W numeric parameter (default 0) isÆ placed in the AH register when attempting to switch video modes.ÆƇX… On Unix flavors, preset to +1 if the ‡XTERM… environment variable containsÆ ‡xterm,… preset to -1 if the variable contains the string ‡401… indicating aÆ Tektronix storage tube graphics terminal, otherwise remains at 0. PositiveÆ values allow the term function to use the X Windows ‚xterm… status line.Æ Negative values inhibit status line updates while Tek graphics are active.ÆƇY… Control byte for the NS16550AN/NS16550FAN FCR register. If you don't knowÆ what the FCR does, don't change this parameter. It has been suggested thatÆ a different value (129) may improve multitasking under DESQview whenÆ multiple copies of ZCOMM are active.ÆƇZ… Hot zone column used for keyboard entry with the ‚message… andÆ ‚private…commands. A space character keyboarded within the hot zone finishesÆ the line.ÆƇa… The ‡a… parameter calibrates certain XMODEM and YMODEM protocol timeouts. TheÆ default value is set during initialization to an appropriate value for anÆ IBM Personal Computer, PC-jr, DG/One, or 8mHz PC-AT (2000 for 4.77 mHz PC,Æ 4000 for a PS2/30, 6000 for an 8 mHz AT, 12000 for a PS2/80). If ZCOMM isÆ run on a non standard machine, accelerator, or under a time slicingÆ operating environment such as TopView, these timeouts may be recalibratedÆ with the ‡a… numeric parameter. Larger numbers give longer timeouts. ThisÆ parameter should then be set with a ‡pa#… command in the telephone directoryÆ ‚setup… entry. The value for this parameter will change if ZCOMM is used withÆ a different computer type or multitasking operating system.ÆƇb… Sets the video color for the screen border. The mapping of ‡b… parameterÆ values to color is hardware dependent. New values of the ‡b… parameter takeÆ effect with the next screen clear.ÆƇc… The ‡c… parameter sets the callout interval in seconds between scans forÆ outgoing messages. The default is 300 seconds (five minutes).Æ ‚EXAMPLE…: ‡pc600… sets the interval between callout queue scans to 10 minutes.Æ ‡SEE ALSO:… Callout queueÆƇd… A non zero value (the default) causes incoming files received with ZMODEMÆ and full YMODEM Batch protocol to have their ‡Date… set to that sent in theÆ file header. ZMODEM's file management features depend on the transmissionÆ of each file's modification date. Files between two copies of ZCOMM willÆ have the same creation date, even if the two machines are in different timeÆ zones. When transferring files to/from a Unix system, creation dates areÆ interpreted according to GMT or Universal Coordinated Time. File datingÆ should be enabled with a ‡pd1… command in the telephone directory ‚setup… entry.Æ ‡SEE ALSO: z… numeric parameter, ‡ZONE… environment variableÆ ‡NOTE…: Backdating file creation times may confuse some backup programs.ÆƇe… Indicates the number of ‡errors…, failed file transfers and the number ofÆ characters received by the term function with parity error, framing error orÆ overrun.Æ ‚EXAMPLE…: ‡if e>30 goto badline…ÆÆ If the term function increments the error count to 0 ( Refer to ‡E… modeÆ description for caveats. ) (from a negative number), and ‡E… mode is set, theÆ term function exits. This allows the script to regain control in the eventÆ of a noisy line. This condition is indicated by the ‡e… test condition beingÆ false (0).Æ ‚EXAMPLE…: ‡pe-20; ... wait; if !e goto badline…Æ This parameter is reset to 0 by the ‚call… command.Æ ‡SEE ALSO: E… modeÆ ‡SEE ALSO: e… test condition (‚if…, ‚while… commands)Æ Unless the ‡q… file transfer option is used, each file skipped as a result ofÆ ZMODEM selective transfer increments this parameter.ÆƇf Fail… time. Sets the default timeout in seconds for matching a pattern. AÆ value of 0 suppresses this timeout. This timeout is reset whenever aÆ character is received from the remote. Timeout is suspended whenever a XOFFÆ (DC3 or Control-S) is keyboarded, and resumed when XON (DC1 or Control-Q) isÆ keyboarded. The ‡f… parameter value may be overridden for one command by theÆ ‡f…‚time… mode.Æ ‚EXAMPLE…: ‡pf15… sets a default 15 second inactivity timeout for patternÆ searches.ÆƇg… Set the "gochar" (decimal). (See the ASCII/Decimal conversion table inÆ Chapter 38). The ‡g… parameter is reset to its default (linefeed, 10) by theÆ ‚call… command. (See documentation on the ‡p… mode.)Æ Some remote systems accept uploads with a ? (decimal 63) prompt for eachÆ line. Optimum operation with such a system might call forÆ ‡pg63 pp1000 pt4 f -tp file1…Æ The ‡pg63… sets the goahead character to question mark. The ‡pp1000… sets theÆ timeout to a long delay (10 seconds). The ‡pt4… sets the upload throttle toÆ 40 milliseconds per characters, a speed which allows the remote to echoÆ somewhat slowly (assuming no tabs). Finally, the command ‡f -tp file… sendsÆ ‚file1… with Throttle and wait for Prompt at end of line.Æ As a special case, if the "gochar" is set to 17 (called XON, DC1, or ^Q)Æ before the ‡p… mode is set, file transmission is stopped until an XON isÆ keyboarded or received from the remote.Æ ‚EXAMPLE…: ‡pg17; ena -p…ÆÆh Iff the ‡h… numeric parameter is set non zero, the ‡h… (Half Duplex) ‚mode… causesÆ characters transmitted by the term function to be stored in the circularÆ buffer as if they had been received from the remote. This allows the reviewÆ function to display them. Since the echoed characters appear to have comeÆ from the remote, scripts may be affected, especially pattern searches.Æ ‚EXAMPLE…: ‡ph1; ena -h…ÆÆi Set the ‡interval… between retries to ‡n… seconds.Æ ‚EXAMPLE…: ‡pi4; call -200 busysys… attack dials up to 201 times at 4 secondÆ intervals.Æ ‡SEE ALSO:… ‚call… -‚n… commandƇj… Sets the maximum connect time in seconds allowed restricted callers in hostÆ operation. The default value of 0 does not restrict connect time.Æ ‚EXAMPLE…: ‡pj300… disconnects restricted callers at the first command promptÆ after 5 minutes' connect time.ÆƇk… When receiving data from the remote at high speeds (9600 or faster), theÆ display may fall behind data from the remote. Under these conditions,Æ keyboarding an interrupt character (often Ctrl-C, or Break) will immediatelyÆ stop the output from the remote, but the display will continue to scroll forÆ some time while the data in the circular buffer is displayed. If this isÆ objectionable, the ‡k… parameter may be set to the remote's particularÆ interrupt character (in decimal). This parameter also affects the ‚linkÆ… command. When this character is keyboarded, undisplayed data pending in theÆ circular buffer is skipped over. (This data is still available to theÆ ‚review… command. The ‚call… command resets this parameter to -1, disabling itsÆ function.Æ ‚EXAMPLE…: Many DEC systems use ETX (Ctrl-C) to interrupt programs. Many UnixÆ users also use ETX for interrupting programs. The command ‡pk3… causes ZCOMMÆ to skip buffered output from the remote. Unix users using the defaultÆ interrupt character of RUBOUT may give the command ‡pk127…ÆÆl Selects LPTn for term function output when the ‡l… mode is set. In addition,Æ adding 8 to the number allows terminal emulation escape codes to selectÆ "printer controller mode" iff the printer is ready at the time. Adding 16Æ to the number allows "printer controller mode" to be selected even if theÆ printer is not ready at the time.Æ As a special case, setting this parameter to 0 forces ZCOMM to use DOSÆ handle 4 (STDPRN, device PRN:) for printer output. Doing so may generateÆ spurious "Abort, Retry, Ignore, Fail" messages from some versions of DOS.Æ DOS 5.0 generates spurious "Write Fault" messages with some parallel portÆ adapters; changing from the parallel port on an AST Advantage board to aÆ recent Chinese "AT Multi I/O" board eliminated the DOS error messages.Æ When using DOS handle 4 for printing, a legitimate printer problem willÆ generate the "Abort, Retry, Ignore, Fail" message. Normally you would wishÆ to correct the printer problem and keyboard "r" for Retry. If the printerÆ problem cannot be corrected, keyboard "f" (Fail) a few times and ZCOMM willÆ disable printing by setting the ‡l… numeric parameter to -1. Printing can beÆ enabled later by setting the ‡l… numeric parameter.Æ The default value is 1 (BIOS LPT1, ignore terminal emulation printerÆ commands).Æ ‚EXAMPLE…: ‡pl2… selects LPT2.Æ ‚EXAMPLE…: ‡pl9… selects LPT1 and allows the remote application to enableÆ "auxiliary print" and/or "printer controller mode".Ƈm… Causes file transmission with the ‚f file… command to pause when a characterÆ matching the decimal value is read from the file. That character is NOTÆ transmitted. When the file uploading is paused, a keyboarded Ctrl-Q willÆ resume transmission. The ‚call… command resets the ‡m… parameter to -1 (whichÆ matches nothing).Æ ‚EXAMPLE…: ‡pm12… Causes file uploading to pause on FormFeed (FF).Ƈn… Set the ‡normal… display attribute. The default of 7 gives a normal white onÆ black display. The numbers associated with the ‡s…, ‡r…, and ‡n… are stored inÆ the attribute byte of each character position written in the correspondingÆ mode.Æ The bit configuration (color display) is: ‡Blink R G B Intensity R G B… withÆ the leftmost the most significant.Æ Users with color monitors often use 2 (green) to avoid color fringes causedÆ by misconverged color monitors.Æ ‡NOTE:… the actual writing color attribute is not changed until the next timeÆ the display is reset. Some attributes generate unreadable displays. OtherÆ attributes generate text that can only be seen on some monitors.Æ ‚EXAMPLE…: ‡pn3… sets cyan; ‡pn2… sets green.ÆƇo… Iff non zero, allows ‡overlap… of file writing and incoming data from theÆ remote. This increases throughput when receiving files with B, ExtendedÆ Quick B, XMODEM, and YMODEM Batch protocols. ZCOMM sets this to 1 onÆ startup unless a PC-jr is detected.Ƈp Pause… sets the echo wait period (in hundredths of seconds) used with theÆ ‚pattern… command and the ‡w… and ‡p… modes. Larger numbers give longer pauses.Æ The default works well with most micro based bulletin board systems. The ‡p…Æ parameter is reset to its default of 70 (700 milliseconds approximately) byÆ the ‚call… command.Æ ‡SEE ALSO: p… modeƇq… Sets the "gopause". When sending a file with a wait for "gochar" ( ‡p… mode),Æ ZCOMM waits Gopause hundredths of seconds AFTER it receives the "gochar".Æ The ‡q… parameter also controls the time delay after a normal pattern match orÆ ‚putw… command.Æ The ‡q… parameter is reset to its default of 70 (700 millisecondsÆ approximately) by the ‚call… command. The default value allows time forÆ immediate echoes to be displayed and for the Hayes SmartModem(Tm) to respondÆ to most commands.Æ ‡SEE ALSO: p… modeƇr… Set the attribute for "reverse video".Æ ‚EXAMPLE…: ‡pr97… sets "reverse video" to blue on yellow.Æ Adding 1024 to this parameter forces ANSI SGR 7 to use this color.Æ ‡SEE ALSO: n… numeric parameterƇs… Set the attribute of the ‡status… line display (default 7, for white). AÆ value of 8 (grey) may be chosen to prevent the status line display fromÆ distracting from the information being printed. The low intensity grey alsoÆ minimizes phosphor burn. Some other possibilities are 2 for green, and 1Æ for blue (or underlined on the monochrome board).Æ ‡SEE ALSO: n… numeric parameterƇt… Sets the ‡throttle… speed (delay between characters in hundredths of seconds)Æ used by the term function when uploading files with an ‚f… -‚t file… command.Æ Throttle controls the term function sending speed only when ‡t… mode isÆ enabled.Æ The default value of 4 corresponds to about 20 characters per second.Æ Larger numbers give slower transmission. The effective resolution of the ‡t…Æ parameter is limited by the timekeeping resolution of the operating system;Æ on PC-DOS the resolution is about 18 per second.Æ A negative value (-1 to -32767) may be used to specify a software timingÆ loop, with more negative values giving slower transmission. The speedÆ effect of a negative ‡t… value depends on the processor speed and operatingÆ environment.Æ The ‡t… parameter is reset to its default by the ‚call… command.Æ ‡SEE ALSO: t… modeƇu… Sets the video attribute used to represent ‡underline….Æ ‚EXAMPLE…: ‡pu14… sets "underline" to yellow.Æ Adding 1024 to this parameter forces ANSI SGR 3 or 4 to use this color.Æ ‡SEE ALSO: n… numeric parameterƇv… Sets the ‡verbose… level (default 0). A value less than zero inhibits someÆ routine messages. A value og 1 or greater enables logging of files skippedÆ by selective ZMODEM file transfers. A value greater then zero causes theÆ ‚set… command to list all string parameters, including empty stringÆ parameters. The screen erase after data calls in host operation isÆ disabled. Values greater than 1 display script commands as they are fetchedÆ from the script file.* Larger values give more detailed tracing information.Æ A value of 50+ causes data read by the ‚read… command to be displayed andÆ acted upon by the term function (when called) as if it had arrived from theÆ remote.Æ ‡NOTE:… A ‡v… parameter value greater than zero affects scripts that generateÆ files with the > command.Ƈw… Controls the block length used by the CompuServe B Protocol. A longerÆ length increases throughput, but may overload some networks, resulting inÆ excessive retransmissions or failed transfers. The maximum B+ block lengthÆ is 1024 data bytes. A value of 0 (the default) allows the CompuserveÆ computer to control the block length.ÆÆ A negative value controls the upload block length but still allowsÆ Compuserve to control the download block length.ÆÆ Uploads to Compuserve using longer block lengths are sensitive to poor flowÆ control, especially when error correcting modems (MNP, etc.) are used. IfÆ B+ uploads fail or require excessive retransmissions, correct the flowÆ control arrangements, disable the modem's error correction, or try a smallerÆ upload block size.ÆÆ The data contents of successfully transferred files are not affected by thisÆ parameter.Ƈx… Sets the port number linked with the ‚link… command.Æ ‡SEE ALSO:… ‚link… command, ‡y… numeric parameterƇy… Sets the transmission speed used by the linked port.Æ ‡SEE ALSO:… ‚link… command, ‡x… numeric parameterƇz… Set the ‡timeZone… in minutes behind GMT (Greenwich Mean Time).Æ ‚EXAMPLE…: ‡pz300… sets timezone 300 minutes behind GMT for EST.Æ ‚EXAMPLE…: ‡pz480… sets timezone 480 minutes behind GMT for PST.Æ ‡SEE ALSO: d… numeric parameter, ‡ZONE… environment variableƇ_… The ‡_… numeric parameter controls the action taken by ZCOMM when a fatalÆ error (one that generates the "ZCOMM: Error..." message). Any non zeroÆ value causes DTR to be dropped (disconnect the modem). A value greater thanÆ 100 causes ZCOMM to exit to the operating system. The ‡NUKE… key does notÆ invoke this processing.Æ ‚EXAMPLE…: ‡p_101…Æ— ‡<<-- Kermit Numeric Parameters -->>…ÆThe Super-Kermit parameters control Kermit protocol transfers. They are setÆwith the ‚kermit px…# command. Their current values may be displayed with aÆ‚kermit p… command. These parameters rarely need changing for most systems.ÆThey can be changed in case of difficulty with Kermit transfers, especiallyÆwith mainframe programs or obscure microcomputer Kermit impelementations.ÆCertain of these parameters require character values expressed in decimal. TheÆASCII code chart in Chapter 38 gives the decimal value of all ASCII characters.ÆWhen transferring files with Kermit programs operating on IBM mainframes withÆhalf duplex front ends, the ‡kermit i… parameter should be set to 1, and theƇkermit s… parameter set to the longest response time expected, perhaps 45Æseconds.Æ‚EXAMPLE…: ‡kermit pi1; kermit ps45…ÆSEE ALSO: Kermit protocol in Chapter 11ÆƇ7… If non zero, force seven bit line transmission with eighth bit quoting KermitÆ transmission even if ZCOMM is otherwise using eight bits no parity. ThisÆ parameter is reset by the ‚call… command.Ƈ8… If non zero, force 8 bit transparent Kermit transmission even if ZCOMM isÆ otherwise using seven bit line transmission. Normally, the Kermit fileÆ transfer commands use 7 bit line transmission and attempt to negotiate 8thÆ bit quoting if one of the 7 bit modes (7e, 7o, 7m, 7s) is used. ThisÆ parameter is reset by the ‚call… command.Ƈa… Incoming packet-start character, default 1 (SOH).ƇA… Outgoing packet-start character, default 1 (SOH).Ƈb… Block check type requested: 1=1 byte checksum, 2=2 byte checksum, 3=3 byteÆ CRC-16 (default). Selecting a type 1 checksum instead of type 3 willÆ increase throughput by 2-4 percent ( for 96 byte packets ) at the expense ofÆ weaker error checking. The probability of undetected errors when usingÆ Kermit in checksum mode instead of CRC-16 increases dramatically with noisyÆ lines and longer packets.Ƈc… Control prefix in incoming data, default 35 (pound sign).ƇC… Control prefix in outgoing data, default 35 (pound sign).Ƈd… Delay in seconds before initial sending, default 0.Ƈe… Incoming end of line character, default 13 (CR).ƇE… Outgoing end of line character, default 13 (CR).Ƈi… Use IBM line turnaround, default 0 (don't use IBM line turnaround). TheÆ Kermit ‡x… numeric parameter sets the turnaround character. This may beÆ necessary when communicating with IBM mainframes with half duplex front ends.Ƈl… Maximum outgoing packet length, default 1000, 1000 maximum. A value greaterÆ than 94 implies Kermit long packets. The receiving program may force shorterÆ packets.ƇL… Maximum incoming packet length, default 1000, 1000 maximum. A value greaterÆ than 94 implies Kermit long packets. This sets a limit; the sending programÆ may use shorter packets.Ƈp… Sets the number of padding characters (default 0) to send before and afterÆ each transmitted packet.Æ ‡SEE ALSO:… kermit ‡y… numeric parameterƇr… If non zero, remove incomplete files received with a protocol except thoseÆ received with the ‡+… option (default 0).Ƈs… Timeout interval in seconds waiting for XON characters or positive flowÆ control (default 15). If an XON is not received within this time,Æ transmission resumes anyway. A value of 0 disables this timeout.Ƈt… Override timeout interval in seconds for incoming packets. The default of 0Æ allows the other program to specifiy the timeout.ƇT… Timeout interval for outgoing packets, default 4 seconds.Ƈv… Eighth bit quoting character, default 38 (ampersand). Sliding Window size inÆ Kermit packets, 1 minimum, 31 maximum, 15 default. Setting ‡w… to zeroÆ disables the sliding window.Ƈx… IBM turnaround character, default 17 (XON).Ƈy… Pad character to send, default 0 (NUL).Æ ‡SEE ALSO:… kermit ‡p… numeric parameterÆƇkermreset string parameter… A string (up to 32 characters) may be sent by Pro-ÆYAM's Kermit when it attempts to recover from a transmission error. TheÆdefault value for this string is empty. Two metacharacters are special: \336Æinserts a one second pause, \335 sends a break. — ‡<<-- X/Y/ZMODEM Numeric Parameters -->>…ÆThese parameters control XMODEM, YMODEM, and ZMODEM protocol transfers. TheyÆare set with the ‚z px…# command available with ZMODEM flavors of ZCOMM.Æ‚EXAMPLE…: ‡z pl16384…ÆForces ZMODEM packet length of 16384 (default packet length is infinite).ÆÆTheir current values can be displayed with a ‚z p… command. These parametersÆrarely need changing in normal environments.ÆƇb… If non zero, ZMODEM sends a break when it is sending a file and receives aÆ retransmission request. This mode of operation may be used with high speedÆ modems to clear unwanted characters from the modem's buffer during errorÆ recovery. Usually, the modem must be given a configuration command to setÆ the proper action to take when receiving a break signal.ƇB… Sets the duration of the break signal in tenths of a second, default 2 (200Æ milliseconds). =2 .li c ‡Enables Cybernetic Data Recovery(Tm)… on XMODEM andÆ YMODEM transfers. Setting this parameter to 0 accommodates programs with nonÆ standard XMODEM/YMODEM protocols and slightly quickens file transfers. TheÆ default value of 1 provides optimum reliability for XMODEM and YMODEMÆ transfers with programs that meet the XMODEM/YMODEM spec.Æ Setting this parameter to -1 disables the quick file compare provided by theÆ ‡r… option.ƇC… Sets the number of times ZMODEM will attempt to send a command (as a resultÆ of a ‚zcommand… command) (default 11).Ƈd… Sets a ‡d…elay time in tenths of seconds that the ‚sz… command will wait for aÆ ZMODEM packet in response to the rz string it sends to the remoteÆ before sending a ZMODEM packet. This facilitates automatic ZMODEM uploads toÆ VMS, which interrupts programs with the Ctrl-X character. The ‚call… commandÆ resets this parameter to its default of 1. Higher values increase theÆ startup time when the receiving ZMODEM program is started before the sender.Æ .li e If non zero, ‡escape… all control characters. This allows ZMODEMÆ transfers to operate over data PBX and other systems that freak out when theyÆ receive control characters.Ƈd… Some operating systems, most notably VAX/VMS, use ^X to stop programs.Æ ZMODEM uploads consist of a "rz" command to start the rz program followed byÆ a ZMODEM packet. If the ^X in the ZMODEM packet causes problems, the ‡zmodem…Æ d parameter can be used to delay the initial ZMODEM packet until the ‚rzÆ… program initializes itself. The ‡zmodem d… parameter sets a delay in tenths ofÆ a second on ZMODEM sends (uploads) between the "rz" command and the firstÆ packet.Ƈf… Flow control mask, only used with Unix/Xenix systems. Setting this to 0 (theÆ default) disables hardware (RTS/CTS) flow control for Xenix/Unix systems withÆ broken hardware flow control. On Xenix/Unix systems where only CTS flowÆ control works properly, set this to 8192 to allow CTS flow control only. IfÆ both RTS and CTS flow control work properly (rare) you can use a value of -1Æ to enable both bits. .li F Sets the pause after each data subpacket sentÆ with the ‚sz… command when the ‡F… option is used, or when failing flow controlÆ is detected. The default value of 1 causes a one tenth second delay.Æ ‡SEE ALSO: F… option On some Unix operating systems the pause will be roundedÆ up to the next second or two.Ƈl… Normally, the ZMODEM "packet length" ("block length") is the file length.Æ Setting this parameter non zero forces ZMODEM to close a frame and wait forÆ an ACK after each # bytes (default 0). This makes ZMODEM behave like XMODEM,Æ YMODEM, or JMODEM, which wait after each block/packet for an acknowledgementÆ before going on to the next block. The ‡packet length… may be adjusted toÆ prevent buffer overflow in data PBX systems. The ‚call… command resets thisÆ parameter to 0.ƇL… (Default 0) If non zero, overrides the nominal length of data subpacketsÆ within each ZMODEM frame. A smaller value speeds error recovery on noisyÆ lines, a large value (maximum 1024) reduces the overhead of CRC characters.Æ The ‚call… command resets this parameter to 0.Æ Please note that streaming ZMODEM has no direct equivalent toÆ XMODEM/YMODEM/JMODEM block length unless the ‡zmodem l… parameter is set nonÆ zero. In the absence of errors, ZMODEM normally sends the entire fileÆ without pause. If somebody claims ZMODEM's 1024 byte subpacket length isÆ slowing things down by more than one half per cent, he doesn't understandÆ ZMODEM and should be ignored.Ƈn… Sets the number of NULLS (default 0) sent before each ZDATA frame. SomeÆ buffered modems (Fastcomm) have a firmware bug which loses characters whenÆ changing the direction of transmission. This causes data frames to fail withÆ a CRC or other error. ‡ZMODEM n… parameter values in the range of 100 to 150Æ have obviated this syndrome.ƇP… When set to 2 (the default), purge the transmit buffer and force a receiverÆ response when a CR/LF sequence (indicating a PC-Pursuit ‡DATA LOSS… message) isÆ detected. A value of 1 does not purge the transmit buffer. A value of 0Æ disables special processing of CR/LF sequences received by the sendingÆ ZMODEM.Ƈw… If non 0, restrict the ZMODEM transmit window to the specified number ofÆ bytes. Setting this parameter to N requests acknowledgements from theÆ receiver every N/4 characters. ZCOMM then waits for acknowledgements fromÆ the receiver whenever it has sent N more characters than it has receivedÆ acknowledgements for. This parameter is useful with networks with defectiveÆ flow control, and with networks that store an excessive number of charactersÆ in transit. The ‚call… command resets this parameter to 0.ƇW… Adjusts the number of characters the ZMODEM receiver will silently ignoreÆ when searching for the beginning of a new frame. This may be set larger toÆ accomodate networks with excessive in transit storage, smaller to speed errorÆ recovery from long error bursts on direct connections. The ‚call… commandÆ resets this parameter to the default (1400).ƇZ… Number of minutes (default 0) to adjust the file modification date when usingÆ the Telink or Clink/SEAlink file transfer protocol to transfer a file betweenÆ different time zones.ÆÆThe timeout parameters below may be set lower for faster X/YMODEM errorÆrecovery when transferring files between two micros, higher to accomodateÆextremely sluggish systems. Only in pathological cases is it ‚necessary… toÆmodify these parameters. The ‚call… command resets these parameter to theirÆdefaults.ÆƇp… Timeout in tenths of seconds for gaps within a packet (default 100).Ƈr… If non zero, remove incomplete files received with a protocol except thoseÆ received with the ‡+… option (default 0).ƇR… When non 0, limits the number of bytes of file comparision used with the ‚sz…Æ and ‚rz… ‡-rr… option. This parameter may be set to a value between 2048 andÆ 32000 (1 billion on 32 bit systems). This parameter is given to theÆ receiving program.Æ ‚EXAMPLE…: ‡z pR30000…Æ SEE ALSO: -rr optionƇs… Timeout interval in seconds waiting for XON characters or positive flowÆ control (default 15). If an XON is not received within this time,Æ transmission resumes anyway. A value of 0 disables this timeout.Ƈt… XMODEM, YMODEM, and ZMODEM Receiver timeout in tenths of seconds waiting forÆ a packet or command acknowledgement (default 100).ƇT… Transmitter timeout in tenths of seconds waiting for a packet (default 600).Æ—¼– ¼– › š@ 7 šA ; šB u šC v ÆšD w šE x šF y ÆšG z šH { šI | šJ } šK Æ ‡<<-- Kermit Server Access Commands -->>…Æ ‚ A … ‡finish… Terminate the remote Kermit ServerÆ ‚ B … ‡get filespec… Get file(s) from the remote Kermit serverÆ ‚ C … ‡remote cwd dir [password]… Change server working directoryÆ ‚ D … ‡remote delete filespec… Delete the specified file(s) on the remoteÆ systemÆ ‚ E … ‡remote dir dirspec… Display remote system's directoryÆ ‚ F … ‡remote help… Display server's help fileÆ ‚ G … ‡remote host command… Execute command on remote, display outputÆ ‚ H … ‡remote print filespec… Print filespec on the remote system'sÆ printerÆ ‚ I … ‡remote space… Display free disk space on remote systemÆ ‚ J … ‡remote type filespec… Display the specfied filesÆ ‚ K … ‡remote who… Display who is on the remote systemÆ ‚ L … ‡send file ...… Send the specified file(s) ¼– — ¼– — ¼– Æ ‡STRING PARAMETERS…Æ Case is significant in parameter names.ÆÆ ZCOMM provides two types of string parameters, ‚permament… and ‚temporary….Æ Permanent string parameters are always defined, and most perform specificÆ defined functions. The permanent string parameters are described below.Æ The names of the permament string parameters may be displayed with theÆ command sequence ‡pv1; set… given at the command prompt. Without the ‡pv1…Æ only non empty string parameters are displayed.ÆÆ Temporary string parameters* are created by the ‚set…, ‚sets…, ‚accept…, and ‚grabÆ… commands when they do not reference a permament string parameter.Æ Temporary string parameter names begin with any letter except ‡y… and mayÆ have up to 16 letters or digits.ÆÆ The contents of temporary string parameters may be accessed and modifiedÆ when ZCOMM is Restricted. New temporary string parameter names may not beÆ created when ZCOMM is Restricted.ÆÆ The ‚set… command without arguments displays the current values and maximumÆ string length for each of the non-empty string parameters. To set aÆ parameter empty, enter "" as the parameter string (e.g., set txlog "").Æ Certain string parameters may be entered with ZCOMM's character escapes.ÆÆ When a string parameter is ‚executed…, it may be either sent to the remote asÆ a string or executed as a command if its first character is @.Æ ‚EXAMPLE…: ‡set f7 "logout\r"… programs F7 to send a string to the remote.Æ ‚EXAMPLE…: ‡set f7 "@echo logout"… programs F7 to display logout on the screen.ÆÆ In strings sent to the remote, a \336 (octal 336) character causes a pauseÆ in transmission ( Not including the ‚mput… command ) (controlled by the ‡p…Æ numeric parameter), which may be used to send multiple commands with oneÆ string.ÆÆ An optional underscore prepended to the name of a permament stringÆ parameter causes that string parameter to be cleared by the next ‚callÆ… command.ÆÆ The following string parameters may not be accessed or modified by the ‚setÆ… command or in string expansions when ZCOMM is Restricted:Æ backtab bbs break bs esc etx exrc f1...f12 fs1...fs12 fc1...fc12Æ fa1...fa12 fcdel* fcdown* fcend* fchome* fcins* fcleft* fcpgdn* fcpgup*Æ fcright* fcup* fdel fdown fhome fins fleft fnp5* fpgdn fpgup fright fupÆ id0...id3 intolink* l linkpass* m oncloserx onclosetx onexit outahostÆ outalink* password pw0...pw3 quitcmd rub tab unrestrict xpassword*ÆÆ The following may not be modified by the ‚set… command when ZCOMM isÆ restricted:Æ MODEM answerback altprompt baudstr blankfill call1** call2 call3*Æ callers* calllog* callpath** challenge dircx dirpx dirfx dirrx dirsxÆ disks dport e emdir entstr eolstr helpfile home hprompt lib lpnonoÆ mcommand mconnect menu messages mprefix mprompt msuffix n1 n2 n3 phonesÆ picture plog private rcmdlog* rdisks remote rname* rxlog* telno tmpÆ tname* twxfile txlog* welcome xhelpfileÆÆ The following parameters can never be modified by the ‚set… command: ano argsÆ c d drive e h nodename oname1...oname5 parity pwd s speed t w yÆ y0...y127 yb yfÆÆ ‡String Parameters for Remote Operation:…Æ answerback baudstr bbs call1** call2 call3* callers callpath**Æ challenge dircx dirfx dirrx dirsx disks emdir exrc helpfile homeÆ hprompt intolink* linkpass* menu messages oncloserx onclosetx outahostÆ outalink* password private pwd rcmdlog* rdisks rmtcmd* rname* rmtcheck*Æ tname* twxfile unrestrict welcome xhelpfileÆ ‡String Parameters for Protocol File Transfer:…Æ adlopts aulopts dirrx dirsx oncloserx onclosetxÆ ‡String Parameters for Non Protocol File Transfer:…Æ blankfill dircx dirfx eolstr tmodesÆ ‡String Parameters for Interactive Operation:…Æ Soft Keys altprompt backtab break bs dirpx entstr esc etx lpnonoÆ mprompt parity rub tab tmodes xpassword*Æ ‡String Parameters for Scripts:…Æ ano args c d e h ifs item lib oncloserx onclosetx onexit nodenameÆ oname1...oname5 remote rxcnt s s0...s9 t tmodes tmp y y0...y127 yb yfÆ ‡String Parameters for Making Calls:…Æ MODEM l m mcommand mconnect mprefix msuffix telnoÆ ‡String Parameters for Log Keeping:…Æ callers* calllog* plog rcmdlog* rxlog* txlog*Æ ‡Other String Parameters:…Æ helpfile home kermreset menu onexit picture phones quitcmdÆ — ¼– — ¼– — ¼– Æ ‡OUTLINE OF COMMANDS…Æ — › š@ d šA e šB ’ šC @ šD - šE ¼ Æ ™í ¼– Æ ‡<<-- Modem Setup -->>…ÆÆ ‚ A … ‡port 1… Select the modem portÆ ‚ B … ‡portx hbase,vec… Select non standard modemÆ ‚ C … ‡speed 1200… Set the "baud rate"Æ ‚ D … ‡handshake {on|off|cts|dsr|dcd|both|slow}… Flow ControlÆ ‚ E … ‡estimate l s… Specify file length, effective speedÆÆ ‚ F … ‡F9… Add a new system entry to the Phone Directory ¼– — › š@ ¼ šA  šB Æ šC šD l šE  šF à šG Q Æ šH  šI ] šJ _ ™ð ¼– Æ ‡<<-- Dialing a Call -->>…ÆÆ ‚ A … ‡F9… Add a new system entry to the Phone DirectoryÆ ‚ B … ‡call [-N] system… [N retries]ÆÆ ‚ C … ‡234-5678… Dial a local numberÆ ‚ D … ‡%l-503-621-3746… Dial a long distance numberÆÆ ‚ E … ‡queue… Manipulate the circular dialing queueÆ ‚ F … ‡Shift-F5… Add system name to dialing queueÆ ‚ G … ‡Shift-F6… Run dialing queueÆÆ ‚ H … ‡learn lfile… TurboLearn information to lfileÆÆ ‚ I … ‡bye… Disconnect current callÆ ‚ J … ‡o… DisconnectÆ ‚ K … ‡off… Disconnect and exitÆÆ ‚string parameters…: phones, mcommand, mprefix, msuffix, mconnect ¼– — › š@ B šA ™ šB ¸ šC Q šD Ó šE , Æ šF Ž šG Ð šH Û ™ó ¼– Æ ‡<<-- Interactive Operation -->>…ÆÆ ‚ A … ‡history histfile… Enable command recallÆ ‚ B … ‡F2…, ‡t [-modes]… Begin terminal conversationÆ ‚ C … ‡F5… Begin background operationÆ ‚ D … ‡learn lfile… TurboLearn information to lfileÆ ‚ E … ‡conf… Online conference with edit windowÆ ‚ F … ‡enable -modes… Modifies characteristicsÆ ‚ G … ‡set… Assigns a string or command to a function keyÆ ‚ H … Term Function Operation and Function KeysÆ ‚ I … ‡Term Function Modes… (capture/send modifiers)ÆÆ ‚String Parameters… break, bs, esc, etx, xpassword, entstr, lpnono ¼– Æ — ™ö ¼– Æ ›Æ š@ ø Æ šA û Æ šB þ Æ šC Æ ¼– Æ ‡<<-- Protocol File Transfer Commands -->>…ÆÆ ‚ A … Receive file(s)Æ ‚ B … Send file(s)ÆÆ ‚ C … CompuServe File TransfersÆÆ ‚ D … Advanced Protocol Topics ¼– — ™ù ¼– › š@ ˆ šA H šB ß šC p šD p šE … šF p Æ ¼– šG o šH ‡ šI q šJ „ šK ‡ šL † ¼– šM Ý Æ ¼– Æ ‡<<-- BATCH Protocol File Receive -->>…Æ (File name(s) provided by sending program)Æ ‚ A … ‡ZMODEM ##… rz [-options] [dir] [file ...]Æ ‚ B … ‡Kermit ##… kermit rb [-options]Æ ‡##… Automatic from term function ‚ C …Æ ‚ D … ‡YMODEM… F3, rb [-options] [dir] [file ...]Æ ‚ E … ‡YMODEM-g… rb -g [-options] [dir] [file ...]Æ ‚ F … ‡Telink… rt [-options] [dir] [file ...]Æ ‚ G … ‡SEAlink… F3, rb [-options] [dir] [file ...]Æ ‚ H … ‡MODEM7… r7 [-options] [dir] [file ...]ÆÆ ‡<<-- Single File Protocol File Receive -->>…Æ (File name must be specified to receiver)Æ ‚ I … ‡XMODEM Checksum… rx [-options] rxfileÆ ‚ J … ‡XMODEM/CRC… rc [-options] rxfileÆ ‚ K … ‡OverThruster XMODEM… ro [-options] rxfileÆ ‚ L … ‡XMODEM-g (PCboard/Qmodem)… rx -g [-options] rxfileÆ ‚ M … ‡WXMODEM… rw [-options] rxfileÆÆ ‚ N … ‡OPTIONS for Protocol File Transfers… ¼– Æ — ™ü ¼– Æ ›Æ š@ ˜ Æ šA I Æ šB ‹ Æ šC • Æ šD ‹ Æ šE Š Æ šF — Æ šG — Æ šH — Æ šI Ý Æ ¼– Æ ‡<<-- BATCH Protocol File Send -->>…Æ (File name(s) provided by sending program)ÆÆ ‚ A … ‡ZMODEM… sz [-options] txfile ...Æ ‚ B … ‡Kermit… kermit sb [-options] txfile ...Æ ‚ C … ‡YMODEM… sb [-options] txfile ...Æ ‚ D … ‡Telink/FIDO… st [-options] txfile ...Æ ‚ E … ‡SEAlink… sb [-options] txfile ...Æ ‚ F … ‡MODEM7… s7 [-options] txfile ...ÆÆ ‡<<-- Single File Protocol File Send -->>…ÆÆ ‚ G … ‡XMODEM, XMODEM-CRC… sx [-options] txfileÆ ‚ H … ‡XMODEM-1k… sx -k [-options] txfileÆ ‚ I … ‡XMODEM-g (PCboard/Qmodem)… sx -k [-options] txfileÆÆ ‚ J … ‡OPTIONS for Protocol File Transfers… ¼– Æ — ¼– ÆÆ B-Protocol file transfers are initiated by the CompuServe computer.ÆÆ The term function accepts B-Protocol file transfer requests when enabledÆ with the ‡c… option.ÆÆ ‚EXAMPLE…: ‡t -c…Æ — ¼– Æ — ™ ¼– Æ ›Æ š@ ¦ Æ šA ª Æ šB Æ šC ã Æ šD â Æ šE ß Æ šF  Æ ¼– Æ ‡<<-- Advanced File Transfer Topics -->>…ÆÆ ‚ A … ‡ZMODEM Remote Command… zcommand COMMANDÆ ‚ B … ‡Remote command… !! COMMANDÆ ‚ C … ‡Kermit Server Access… get, finish, etcÆÆ ‚ D … ‡Parameters for XMODEM/YMODEM/ZMODEM Transfers…Æ ‚ E … ‡Parameters for Kermit Transfers…ÆÆ ‚ F … ‡AUTOMATIC File Transfers… (Compuserve-B, Kermit, ZMODEM)ÆÆ ‚ G … ‡Special Keys for Protocol Transfers… ¼– Æ — ™ ¼– Æ ›Æ š@ 0 Æ šA ™ Æ šB L Æ šC ¡ Æ šD  Æ šE Û Æ šF Ð Æ ¼– Æ ‡<<-- Non-Protocol File Transfer Commands -->>…ÆÆ Normal Interactive TransfersÆÆ ‚ A … ‡f [-modes] file… Send file with the term functionÆ ‚ B … ‡t [-modes] file… Terminal conversation with capture to fileÆ ‚ C … ‡kill… Erase the contents of the circular bufferÆ ‚ D … ‡w, ALT-W… Write the circular bufferÆ ‚ E … ‡close, ALT-C… Close the capture fileÆÆ ‚string parameters…: eolstr, blankfillÆÆ ‚ F … Modes (Term Function modifiers)Æ ‚ G … Term Function Detailed Information ¼– — ™ ¼– › š@ © šA  šB n šC ‘ šD Ž šE J Æ šF  Æ ‡<<-- Macro Commands -->>…ÆÆ ‚ A … ‡!DOS-command… DOS Gateway/Shell escape to another programÆ ‚ B … ‡call system… Executes telephone directory entry ‚system….Æ ‚ C … ‡r oldcmd… Search for and reenter previous commandÆ ‚ D … ‡source scriptfile… Call ‚scriptfile… as a subroutineÆ ‚ E … ‡set… Program a soft key with a string or commandÆ ‚ F … ‡keys… Display soft key definitionsÆ ‚ G … ‡reskeys… Clear soft key definitionsÆÆ ‡mprompt string parameter… Change the main promptÆÆ ‡SOFT KEYS… may be programmed to transmit strings or execute commands. ¼– — ™  ¼– › š@ & šA š šB X šC  šD  šE ( Æ šF   Æ ‡<<-- Display / Emulation Commands -->>…ÆÆ ‚ A … ‡display displaymodes… Set CRT parameters, screen emulationÆ ‚ B … ‡tcs M N… Translate Character Set for displayÆ ‚ C … ‡mk params… Remap keyboard for terminal emulationÆ ‚ D … ‡cl… Clear the ScreenÆ ‚ E … ‡cls… Clear the Screen, reset videoÆ ‚ F … ‡echo string… Echo string to display and/or capture fileÆ ‚ G … ‡videobios N… Set video BIOS mode NÆÆ ‡SEE ALSO: 8g, A, Q, i, n, S, sss, u… modes ¼– — › š@ © šA šB  šC  šD $ šE Î šF  Æ šG " šH ' šI ) šJ * šK 4 šL 6 šM S Æ šN b šO r šP Œ šQ ´ šR – šS £ šT ® Æ šU ¯ ™  ¼– Æ ‡<<-- Disk/File Access Commands -->>…ÆÆ ‚ A … ‡!DOS-command… DOS Gateway/Shell escape to another programÆ ‚ B … ‡a:… Change default diskÆ ‚ C … ‡cd directory… Change directoryÆ ‚ D … ‡cdd D:dir… Change disk and directoryÆ ‚ E … ‡dir[rlstx]… Sorted directory listingsÆ ‚ F … ‡browse file ...…Æ ‚ G … ‡crc file ...… Display 32 bit file CRC'sÆ ‚ H … ‡del file ...…Æ ‚ I … ‡dump file ...… Side by Side HEX/ASCII file dumpÆ ‚ J … ‡egrep regular-expression file ...… File searchingÆ ‚ K … ‡egrepq regular-expression file ...… String extractionÆ ‚ L … ‡find string file ...… Case insensitive file searchingÆ ‚ M … ‡findq string file ...… Case insensitive string extractionÆ ‚ N … ‡list file ...… File list on DOS standard outputÆ ‚ O … ‡page file ...… Pauses after each screenfulÆ ‚ P … ‡read file… Fill circular buffer from open fileÆ ‚ Q … ‡seek [-]offset… Seek to ‚offset… from beginning/-end of fileÆ ‚ R … ‡Home, End, PgUp… Enter review functionÆÆÆÆÆÆ ‚ S … ‡sum file ...… Display Unix style file checksumÆ ‚ T … ‡wc file ...… File character, word, line countÆ ‚ U … ‡outfile… Redirect utility command output ¼– — ™ ¼– › š@ C šA W šB f Æ šC t šD ž Æ ‡<<-- Remote Takeover / Host Operation -->>…ÆÆ ‚ A … ‡host… Enter Host OperationÆ ‚ B … ‡message… Leave a public messageÆ ‚ C … ‡private… Leave a private messageÆ ‚ D … ‡remote… Accept remote commandsÆ ‚ E … ‡unrestrict… ¼– Æ — ™ ¼– › š@ © šA  šB & šC , šD . Æ šE A šF k šG ~ šH Ž Æ ‡<<-- Support Commands -->>…ÆÆ ‚ A … ‡!DOS-command… DOS Gateway/Shell escape to another programÆ ‚ B … ‡bdump file… Dump interrupt input buffer to fileÆ ‚ C … ‡display displaymodes… List or change CRT operationÆ ‚ D … ‡enable -mode[s]… Enable mode[s]Æ ‚ E … ‡exit… Exit to DOSÆ ‚ F … ‡help… Type help fileÆ ‚ G … ‡p… Set/display numeric parametersÆ ‚ H … ‡reset…Æ ‚ I … ‡set… Set string parameters / soft keys ¼– ¼– — ™ ¼– › š@  šA šB ! šC ( šD / Æ šE 1 šF = šG > šH D šI ‚ šJ šK ‘ Æ šL ¢ šM ¤ ¼– Æ ‡<<-- Script Commands -->>…ÆÆ ‚ A … ‡String Manipulation commands…Æ ‚ B … ‡abort… Returns to command promptÆ ‚ C … ‡createx file… Semaphore creationÆ ‚ D … ‡echo[c|f] [-n] string… Echo string to display and/or capture fileÆ ‚ E … ‡expand script pathspec… Execute ‚script… for each file in pathspecÆ ‚ F … ‡fail… Failure return from scriptÆ ‚ G … ‡gosub name[.file]… Script subroutine callÆ ‚ H … ‡goto… Branch to ‚label… in same script.Æ ‚ I … ‡if…, ‡ife…, ‡else… Execute rest of line conditionallyÆ ‚ J … ‡return…Æ ‚ K … ‡sleep… Let the world pass byÆ ‚ L … ‡source scriptfile… Call ‚scriptfile… as a subroutineÆ ‚ M … ‡wait… Wait for pattern(s)Æ ‚ N … ‡while… Looping control ¼– ÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆ — ™ ¼– › š@  šA ( šB ? šC K šD T šE U Æ šF c šG h šH Ž šI “ šJ ” Æ ¼– Æ ‡<<-- String Manipulation Commands -->>…ÆÆ ‚ A … ‡accept… Reads keyboard response to string variableÆ ‚ B … ‡echo… Display messageÆ ‚ C … ‡grab svar… Read variable from fileÆ ‚ D … ‡ki… Reset capture buffer search areaÆ ‚ E … ‡lput string… Local screen writeÆ ‚ F … ‡lputp string… Output string to printerÆ ‚ G … ‡pattern… Specify string searches in modem dataÆ ‚ H … ‡put[v]… Send string [variable] to modemÆ ‚ I … ‡set[c|s|n]… Set string parameters / soft keysÆ ‚ J … ‡split… Split (parse) a string to tokensÆ ‚ K … ‡ss… Regular Expression pattern match string parseÆ ‚ L … ‡trs… Translate characters in a string ¼– ÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆ — ™å ¼– ÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆÆƼ– Select one of the following subjects by name, in the proper case:ƈ%l-234-567-8901… ˆ1> /tmp/umanh.txt… ˆ234-5678… ˆ:comment… ˆ;… ˆoutfile… ˆ@… ˆALT-C…ƈALT-D… ˆALT-J… ˆALT-M… ˆALT-R… ˆALT-S… ˆALT-U… ˆALT-W… ˆCtrl-Home… ˆDown… ˆF10… ˆF2… ˆF3… ˆF4… ˆF5… ˆF6… ˆF7…ƈF8… ˆF9… ˆHome… ˆShift-F1… ˆShift-F2… ˆShift-F3… ˆShift-F4… ˆShift-F5… ˆShift-F6… ˆSoft Keys… ˆUp… ˆ …ƈa:… ˆabort… ˆaccept… ˆap… ˆapd… ˆautof… ˆbangbang… ˆbdump… ˆbg… ˆbreak cmd… ˆbrowse… ˆbye… ˆcall… ˆcat… ˆcd…ƈcdd… ˆchat… ˆcl… ˆclose… ˆcloserx… ˆclosetx… ˆcls… ˆcommands… ˆconference… ˆcrc… ˆcreate… ˆcreatex…ƈcrt-cmds… ˆdel… ˆdemand… ˆdialing… ˆdir… ˆdisable… ˆdisk-cmds… ˆdisplay… ˆdos-gateway… ˆdump… ˆecho…ƈeditkeys… ˆegrep… ˆegrepq… ˆelse… ˆenable… ˆestimate… ˆexit… ˆexpand… ˆf cmd… ˆfail… ˆfg… ˆfget… ˆfind…ƈfindmore… ˆfindq… ˆfinish… ˆfput… ˆfpute… ˆgcolors… ˆget… ˆgoback… ˆgosub… ˆgoto… ˆgrab… ˆhandshake…ƈhelp… ˆhistory… ˆhost… ˆif… ˆinvoking… ˆkbdlock… ˆkbdmon… ˆkermit… ˆkermit rb… ˆkermit sb…ƈkermit-n-parms… ˆkeys… ˆki… ˆkill… ˆkill2… ˆl… ˆlabel:… ˆlearn… ˆlink… ˆlist… ˆlput… ˆlputp… ˆls… ˆlx…ƈmacros… ˆmenu cmd… ˆmessage… ˆmk… ˆmodes… ˆmore… ˆmput… ˆn-parms… ˆnfile-trans… ˆnolog… ˆnulls… ˆo…ƈobey… ˆoff… ˆon… ˆonline… ˆopen… ˆoptions… ˆp… ˆpage… ˆpattern… ˆpfile-a… ˆpfile-c… ˆpfile-r… ˆpfile-s…ƈpfile-trans… ˆport… ˆportx… ˆprivate cmd… ˆpspecial… ˆpurgek… ˆput… ˆputw… ˆpwd… ˆqueue… ˆquit… ˆr… ˆr7…ƈrb… ˆrc… ˆread… ˆreceive… ˆremote cmd… ˆremote cwd… ˆremote delete… ˆremote dir… ˆremote help…ƈremote host… ˆremote print… ˆremote space… ˆremote type… ˆremote who… ˆremote-cmds… ˆreset…ƈreskeys… ˆrestime… ˆrestrict… ˆreturn… ˆreview… ˆrewind… ˆro… ˆrt… ˆrw… ˆrx… ˆrz… ˆs7… ˆsb… ˆscript-cmds…ƈscript s… ˆseek… ˆsend… ˆserver-access… ˆset… ˆsetup… ˆsleep… ˆsource… ˆspecial… ˆspeed… ˆsplit… ˆss…ƈst… ˆstatus… ˆstring-parms… ˆsum… ˆsupport-cmds… ˆsx… ˆsz… ˆt cmd… ˆtcs… ˆterm… ˆtimestamp… ˆtrs… ˆtype…ƈunrestrict cmd… ˆusq… ˆvideobios… ˆw… ˆwait… ˆwc… ˆwhile… ˆzcommand… ˆzmain… ˆzmodem…ƈzmodem-n-parms…Æ¿ÿ