Date: Tue, 11 Jan 1994 20:29:20 -0500 (EST) From: Les Jones Subject: ZTerm 0.9 FAQ 1.6 This file answers many Frequently Asked Questions (FAQs) about ZTerm 0.9. All ZTerm users should read the FAQ before sending questions to Dave Alverson. Besides answering questions, the FAQ contains tips, bug reports, and ResEdit hacks. Changes since the last version: bug: Phone number field bug: VT100 emulation Q?: Why can't I download a damn thing? Q?: How can I make ZModem binary downloads from UNIX more reliable? Q?: How can I edit the colors ZTerm uses for ANSI graphics? Q?: How can I emulate function keys on a PowerBook? Q?: How can I use the numeric keypad for entering numbers? Tip: Creating a folder for scripts. Many sections have been updated. In particular, the directions for changing ZTerm's terminal font are more clear. The directions also note that changing the font seems to limit the display to 40 or so columns. If anyone knows a workaround for this problem, please let me know. P.S. Dave Alverson says that ZTerm 1.0 will be released during the first quarter of 1994. ZTerm 0.9 FAQ by Les Jones Version 1.6 updated January 6, 1994 For best results, display in 9 point Monaco with rulers set to 7 inches. Contents: ! = New section! + = Section updated since the last version of the FAQ Distribution and Posting Information Credits Copyright Notice and Trademarks Disclaimer of Warranty Contacting the Author Other ZTerm Information and Software [1.00] ZTerm's Version History [1.01] What's the current version? [1.02] What features will be in the next version? +[1.03] When will the next version be released? [2.00] Registration and Support [2.01] Why should I register (pay the shareware fee)? [2.02] Will I get technical support if I register? [2.03] If I registered an earlier version of ZTerm, do I have to send in an upgrade fee? [2.04] What is Dave's new Internet address? [3.00] Quick Fixes for Common Problems [3.01] Relax. Don't worry. Have a homebrew. [3.02] Select a download folder to prevent -120 downloading error. [3.03] Make sure ZTerm is sending data to the correct port. [3.04] Make sure call waiting is disabled. [3.05] Make sure you have a hardware handshaking cable. [3.06] Install Apple's Hardware System Update 2.0. [3.07] Quit other programs which use the modem. [3.08] Quit ZTerm. Turn the modem off and on. Launch ZTerm. [3.09] Restart the computer. [3.10] Restart the computer with extensions off. [3.11] Disable fax software and fax auto-answer. +[3.12] Move the ZPhoneList out of the ZTerm folder. (But don't throw it away!) [4.00] Known Bugs, ResEdit Fixes, and Cool ResEdit Hacks [4.01] Queue dialing [4.02] File appends [4.03] Missing download folder [4.04] UNIX and Opus settings [4.05] Sending returns in scripts [4.06] Text pacing [4.07] Unmarking all services [4.08] Dialing with the scroll buffer scrolled back ![4.09] Phone number field ![4.10] VT100 emulation [4.11] Non-bugs +[4.12] Increasing the port buffer size with ResEdit +[4.13] Changing the terminal font with ResEdit. [5.00] Dialing [5.01] Why is one service in the Dial menu and in the Dial directory in outline? [5.02] I started ZTerm and the only service listed is called Local. Wa' hoppen? [5.03] My ZPhoneList with a kajillion phone numbers and settings got trashed. Am I screwed? +[5.04] Why won't ZTerm send my modem initialization string? [5.05] Using multiple ZPhoneLists. [5.06] Tip: changing the data rate. [5.07] Tip: changing parity, data bits, and stop bits. [5.08] Tip: dialing the current service. [5.09] Tip: adding a separator line to the Dial menu. [6.00] Connecting [6.01] When ZTerm dials, the dialing line has the A cut off the dial string, like this: TDT 691-7094. What's the deal? [6.02] Why is ZTerm so slow at sending passwords on some services? [6.03] Why isn't there a setting for 14400 bps? [6.04] What data rate should I use with a 14400 bps modem? +[6.05] How can I prevent my modem from constantly dropping carrier, especially when I'm receiving lots of information on the screen? +[6.06] Why won't my Global Village modem connect at 14400 bps? [6.07] Why won't my Global Village modem hangup? [6.08] How can I make my Global Village modem detect a busy signal? [7.00] File Transfers ![7.01] Why can't I download a damn thing? [7.02] This text, binary, MacBinary, and Smart MacBinary stuff makes my head spin. Which should I use? [7.03] When I download Mac files from a PC BBS, the files have generic icons and are unusable. What went wrong? [7.04] Which protocol should I use? [7.05] Does ZTerm support batch ZModem downloads? [7.06] Interrupting ZModem downloads is messy. What's a modem freak to do? [7.07] Can I use ZModem from my VAX or UNIX account? [7.08] How do I prevent massive CRC errors during ZModem text downloads from UNIX? ![7.09] How can I make ZModem binary downloads from UNIX more reliable? [7.10] I have other transfer problems with UNIX. What's Dave been smokin'? [7.11] How can I do ZModem uploads to Delphi? [7.12] Where's YModem-G Send? [7.13] Why does YModem work on some systems and not others? [7.14] Using hardware compression makes my uploads and downloads slower. Was ist los? +[7.15] If I have the Kermit/VT102/etc. Tool, will ZTerm support Kermit/VT102/etc.? Are any ZModem tools available? [7.16] How can I resume downloads interrupted by a meddling cat? [7.17] Hellfire tarnation and a monkey! Why's my transfer efficiency so low? [8.00] Sound, ANSI Graphics, and Color [8.01] Why oh why won't the ZTerm sounds play? [8.02] Can I use sounds other than the ones that come with ZTerm? [8.03] Is there any limit on the length of the sounds? [8.04] How do I turn my modem speaker down or off? [8.05] How do I get ANSI graphics when connecting to a PC BBS? [8.06] I did all of that and the ANSI graphics still look a little funny. What gives? ![8.07] How can I edit the colors ZTerm uses for ANSI graphics? [8.08] How can I add excitement to my dull and monotonous existence? [9.00] VT100 Emulation [9.01] I'm wiggin' out, Les. Why don't the home, end, page up, and page down keys on my extended keyboard work? [9.02] Why don't the f1-f4 editing keys on my extended keyboard work? [9.03] How can I emulate a control key on a Mac Plus? [9.04] How can I emulate an escape key on a Mac Plus? ![9.05] How can I emulate function keys on a PowerBook? [9.06] How can I emulate a numeric keypad on a PowerBook? ![9.07] How can I use the numeric keypad for entering numbers? [9.08] Tip: positioning the cursor with the mouse. [10.00] Text and Text Files [10.01] Can I make the terminal font bigger? [10.02] Why does onscreen text look so crummy in anything but 9 or 12 point? [10.03] Will ZTerm save text files in something other than TeachText? [10.04] How can I increase the size of the scroll buffer? [10.05] Why do some characters get corrupted when I copy text from my word processor and paste it into ZTerm? [11.00] Macros and Scripting [11.01] How do I know the script is running? [11.02] How do I cancel a script? [11.03] How do I send an escape/linefeed/etc. in a script? [11.04] Do I have to use the Wait for "da da da" prompt syntax? [11.05] Why is ZTerm sending only part of a line? [11.06] How can I send quotation marks within a send statement? [11.07] What does error -49 mean? [11.08] I'm goin' nuts! Why won't my login script run? [11.09] Login script example. [11.10] Tip: sending a sig with a script and macro. [11.11] Other uses of scripts and macros ![11.12] Tip: Creating a folder for scripts. An Easter Egg Distribution and Posting Information America Online I always send the current version to America Online. Use File Search keyword "zterm". Delphi The current version of the FAQ is available in the Communication forum in the Macintosh ICONtact forum. FTP I will also send the current version to macgifts@mac.archive.umich.edu, a mail exploder which delivers the file to the sumex-aim and umich FTP sites, as well as other, lesser-known FTP sites. The following list shows the location of the FAQ at various FTP sites, along with the appropriate directories. Sumex and umich are two primary FTP sites. The other sites mirror the contents of either sumex or umich. The mirrors are often easier to access, especially during business hours. Note that the archie.au site is in Australia and that src.doc.ic.ac.uk is in the United Kingdom. To conserve limited Internet resources, use the site closest to home. FTP site Directory sumex-aim.stanford.edu info-mac/comm/info wuarchive.wustl.edu mirrors/info-mac/comm/info archie.au micros/mac/info-mac/comm/info mac.archive.umich.edu mac/misc/documentation wuarchive.wustl.edu mirrors/archive.umich.edu/mac/misc/documentati archie.au micros/mac/umich/mac/misc/documentation src.doc.ic.ac.uk packages/mac/umich/mac/misc/documentation Usenet I post the most current version of the FAQ to the comp.sys.mac.comm and comp.sys.mac.apps Usenet newsgroups. Email Harris Upham has generously volunteered to provide the FAQ via email. He requests that you put "ZTerm" somewhere in the subject line so he can easily identify FAQ requests. Harris is being very generous with his time. Please mail him only if you can't get the FAQ by other means. The address is hupham@fscvax.fsc.mass.edu. Credits and Thanks Many thanks to the folks who have contributed, knowingly or unknowingly. While compiling this FAQ, I was often helped by the net community, particularly readers of the Usenet newsgroup comp.sys.mac.comm and the Info-Mac Digest. Thanks to all the helpful people out there in netland! In rough chronological order: Neil Schulman Joe Dellwo Adam Toner Rick McCormack Scott Macrae David Platt Daniel Friedan Drew Wade Gregory Youngs Roy Wood Gary Snow Peter Middleton Eric Hoffmann Jay Bourland Pete Halverson Henri Schueler Miles Abernathy Jeff Kwan Kent Ritchie Davey Silon David Ray Walter Ian Kaye Harris Upham Shigeru Yamamoto Julian Vrieslander James Trammell Rick Zeman Joel Schulman Keith Corwin Stefano Toria. Others have contributed material which I may use in upcoming versions of the FAQ. Special thanks to ZTerm author Dave Alverson for providing information about the next release, and for releasing a great piece of software as shareware. Copyright Notice and Trademarks This document is copyright 1993 by Leslie Jones. All rights reserved. I ask for no money, but please give credit when quoting information in this document. Crediting the FAQ will make others aware of its existence. Unmodified copies of this document may be freely copied and distributed electronically, and may be uploaded to FTP sites which allow anonymous login, nonprofit BBSs, and commercial online services which charge no more than a normal connect fee for downloading files. For-profit distribution on physical media, including but not limited to paper, floppy disk, and CD-ROM, is prohibited without written permission. Explicit permission is granted to the moderators and archivists of the sumex-aim archives to include this document on the info-mac CD-ROM. Explicit permission is also granted to nonprofit user groups to distribute this document on their disk of the month. This document contains the names of trademarked products. The trademarks are the property of their respective owners, and are used here only in an editorial capacity. Disclaimer of Warranty This document is a volunteer effort. Every attempt has been made to provide accurate information, but the author and contributors accept no responsibility for actions resulting from the use of this free information. The user of this information assumes all responsibility for damages, loss of information, loss of time, and cost of repairs. THIS INFORMATION IS PROVIDED AS IS WITH NO WARRANTY OF ANY KIND. Contacting the Author In preparation for a change of Internet accounts, I'm changing my preferred mail address. To make corrections and suggestions, send Internet mail to lesliejonz@aol.com, or send America Online mail to LeslieJonz. If mail to that address bounces, send Internet mail to ljones@utkvx.utk.edu. UTK is the University of Tennessee, Knoxville, the land of the free and the home of the Vols. Other ZTerm Information and Software Information This FAQ answers questions relating specifically to ZTerm 0.9. There are other sources for information of interest to ZTerm users. General communications For answers to more general questions about Macintosh telecommunications and networking, please read Eric Rosen's excellent comp-sys-mac-comm FAQ, available for anonymous FTP from sumex-aim.stanford.edu and mac.archive.umich.edu. Everyone who uses a modem should keep Eric's FAQ on their hard drive. File conversion For answers to questions about file conversion ("I downloaded a file that ends in cpt/sit/dd/arc/lzh/pit/etc. How do I open it?"), get David Lemson's exhaustive report compression-util-table. The ZTerm manual briefly describes the most common Macintosh compression formats. Modem configuration For information about configuring your modem, consult your modem's manual. I address specific problems in the FAQ, but there really is no substitute for a working knowledge of the Hayes command language. When your AT command reference is torn at the edges and soiled with the dirt of your hands, it is then you will have mastered the art of telecommunications, little grasshopper. Usenet If you have Usenet access, questions about Macintosh-specific telecommunication hardware and software should be directed to comp.sys.mac.comm. Questions about modems and telecommunications in general should be directed to comp.dcom.modems. I often read c.s.m.comm and answer questions about ZTerm by searching for the string "zt". Software ZTerm Phone Directory Listing Denise McElroy (dmcelroy@bonnie.ics.uci.edu) released this application, which reads your ZPhoneList file and produces a text file containing the names and phone numbers of all services. If your ZPhoneList ever gets erased or corrupted, you'll be glad you used it. This application may be also able to extract the phone numbers from a corrupted ZPhoneList. ZTerm Speed Patch Jon Snell (jonsnell@aol.com) wrote a 16 color palette resource and ResEdit instructions for installing the palette. By using the hack and setting the monitor depth to 16 colors, ZTerm users will experience faster screen redraws while still seeing the correct colors. Users with 2400 bps modems will experience little or no speed increase. In my experience, the patch makes ZTerm faster in 16 colors, but a little slower in 256 colors. Highly recommended if you normally use 16 color video. With the patch installed, you can edit the colors ZTerm uses for ANSI graphics. See section eight for directions. Star Trek sounds Star Trek fans now have their own sounds for ZTerm! The sounds are available on America Online as M's ZSounds, and at sumex-aim as star-trek-comm-sounds in the info-mac/snd directory. These are the coolest ZTerm sounds I've used. The sounds are as follows: Connect: Worf saying "Link established. Receiving." Filedone: Worf saying "Transfer of information complete." Termbell: Enterprise computer beep. [1.00] ZTerm's Version History [1.01] What's the current version? ZTerm 0.9 is the current version. It is dated February 8, 1992. Before 0.9 was released, someone hacked 0.85 with ResEdit and released it as 1.0. There is a more recent hack called 0.93 XK (eXtra Keys), which was released by a user group. Anyone may modify ZTerm with ResEdit for their personal use, but distributing modified versions of copyrighted software is illegal. If you discover an interesting ResEdit hack, send it to me and I'll publish it in the FAQ. Dave Alverson sends official releases to America Online, CompuServe, and GEnie. You can also expect the newest version to quickly appear on BBSs and FTP sites. [1.02] What features will be in the next version? -Support for Kermit file transfers. -Implementation of 16 color ANSI graphics, instead of the current 8 colors. -Some additions to the scripting language. -A scripts folder, possibly. -Bug fixes. There may be other features, but these are the ones Dave Alverson has announced. [1.03] When will the next version be released? Dave Alverson says that ZTerm 1.0 should appear in the first quarter of 1994. [2.00] Registration and Support [2.01] Why should I register (pay the shareware fee)? This is a tough question. There is no legal precedent to show that people can be forced to pay for shareware, so no one will come knocking on your door in the middle of the night. On the other hand, many of us in the computer community feel that you should pay for shareware which you use often, just because it seems to us to be the right thing to do. Shareware authors put a lot of work into their software, and they deserve compensation. Shareware authors also put a lot of faith in the computer community by releasing their products as shareware. They trust that people will voluntarily pay for a product they need and use. I for one don't think we should take advantage of people's trust. There are also practical reasons for registering. Registering encourages the author to update his software. More importantly, the author is more likely to continue to release his work as shareware if people pay the registration fee. The copy of ZTerm which ships with some Global Village modems has been paid for by the nice people at Global Village, who know a good piece of software when they see it. [2.02] Will I get technical support if I register? Yes. Dave supports ZTerm through paper mail, email, and in conferences on America Online, CompuServe, and GEnie. The locations of the conferences are listed in the Support dialog under the Misc menu. Registered users receive his home phone number and can call him for direct phone support. When was the last time you called a Microsoft programmer at home? If you send Dave a question, include the registration number you received when you registered ZTerm, as Dave almost certainly gives priority to registered users. Global Village handles technical support for the Global Village version of ZTerm. [2.03] If I registered an earlier version of ZTerm, do I have to send in an upgrade fee? No. Dave Alverson, like most shareware authors, doesn't charge upgrade fees. This is another advantage of shareware. [2.04] What is Dave's new Internet address? The address given in ZTerm 0.9 is out of date. Dave's new Internet address is davea@xetron.com, and is his preferred mail address. [3.00] Quick Fixes for Common Problems [3.01] Relax. Don't worry. Have a homebrew. Keep your head tool cool. Read the manual, read this FAQ, and remember that tens of thousands of people have used ZTerm successfully. Before you use ZTerm for the first time: [3.02] Select a download folder to prevent -120 downloading error. Before downloading files for the first time, you must select a default download folder by selecting Receive Folder from the Settings menu. If you can upload files but can't download them, you probably haven't selected a receive folder. Remember to select a new folder when moving to a new computer. [3.03] Make sure ZTerm is sending data to the correct port. An external modem can be connected to the modem or printer ports. Find out which yours is attached to, select Modem Preferences from the Settings menu, and select the port. Alternatively, you can hold down the shift key while ZTerm loads to select the port. If you have a PowerBook with an internal modem, open the PowerBook control panel and select the option for an internal modem. All things being equal, you should connect an external modem to the modem port. The computer gives priority to the modem port so that other printer port activities don't interfere with modem activities. Also, all AppleTalk devices must be connected to the printer port, which is the only AppleTalk-capable port. [3.04] Make sure call waiting is disabled. To disable call waiting on a touch tone phone, insert the string "*70," before the phone number, like this: ATDT *70,555-5555 The comma is a Hayes command which makes the modem wait for two seconds. Someone has suggested using w instead of a comma. The w tells the modem to wait for a dial tone. On a pulse dial phone, use "1170," instead of "*70,". One reader reports that *67 enables privacy (disables caller ID at the remote phone) for some telephone companies. [3.05] Make sure you have a hardware handshaking cable. If you have hardware handshaking turned on in the Connection dialog, consult your modem manual to make sure you have a hardware handshaking cable. You can get away without one for awhile, but they are ultimately necessary for high speed modems. A diagram of a correctly-wired hardware handshaking cable is hidden in the Apple Modem Tool 1.1. Open a copy in ResEdit and examine PICT resource #20000. In the Apple Modem Tool 1.5, the PICT resources are #20808 for DIN-8 to DIN-8 wiring, and #20825 fro DIN-8 to DB-25 wiring. The new Apple Modem Tool 1.5 has a button labeled Cabling, but it was grayed out on my machine. I suspect the button would work with an Apple Express Modem. Any information on the cabling button would be appreciated. To find out more about hardware handshaking, read issues #179 and #180 of TidBITS, Adam Engst's free electronic magazine, available from FTP sites and online services. [3.06] Install Apple's Hardware System Update 2.0.1. The hardware update (AKA Hardware Enabler) corrects some problems with high speed communications under System 7.1 on the following machines: LC, LC II, IIsi, IIvx, IIvi, Classic II, Quadra 900, and Quadra 950. The updater solves other problems on these and other machines, so users of System 7.1 should probably have it anyway. The updater should NOT be used on Performas. I mention the hardware update out of a sense of duty to inform you that it exists. No one has actually reported that it solved any of their telecommunications problems. On the contrary, reports are filtering in that the update causes some problems of its own. Use your own judgment. Day-to-day fixes: [3.07] Quit other programs which use the modem. Communications programs that access the modem are sometimes reluctant to give up control of the port the modem is attached to. Quit all other telecommunications software, as well as any phone book programs that can dial phone numbers through the modem. [3.08] Quit ZTerm. Turn the modem off and on. Launch ZTerm. This technique solves numerous connection and downloading problems. Among other things, it closes the communications port, which may have been left open by another application. It also forces ZTerm to resend the modem initialization string. [3.09] Restart the computer. Restarting is a standard way of solving transient problems of any kind. [3.10] Restart the computer with extensions off. Extensions (inits and cdevs under System 6) cause more than their share of problems, and should always be suspect if the machine is crashing or freezing. Under System 7, restart with the shift key held down to prevent extensions from loading. Under System 6, manually remove all inits and cdevs from the System Folder and restart. See also 3.11. A few final possibilities: [3.11] Disable fax software and fax auto-answer. Fax software may prevent ZTerm from accessing the serial port to which the modem is attached. Remove fax extensions, control panels and Chooser devices from the System folder. Fax Chooser devices are especially insidious. Chooser devices aren't disabled when you restart with extensions off under System 7. If they were, print drivers would be disabled, and you wouldn't be able to print. Consult your fax modem manual to learn how to disable fax auto-answer. [3.12] Move the ZPhoneList out of the ZTerm folder. (But don't throw it away!) Besides storing phone numbers, the ZPhoneList contains all of ZTerm's settings and preferences, which may have been misset or corrupted. If ZTerm starts doing really, really bizarre things, you should suspect a corrupted ZPhoneList. If you remove the file from the ZTerm folder, ZTerm will create a new one using its default settings. You can also restore the file from a backup disk. If that doesn't solve the problem, put your old ZPhoneList back in the ZTerm folder so you won't lose your phone numbers. [4.00] Known Bugs, ResEdit Fixes, and ResEdit Hacks [4.01] Queue dialing When queue dialing, the dial window remains open after a connection is made. [4.02] File appends Appended text is inserted at the beginning of the file, rather than at the end. [4.03] Missing download folder If you attempt to download without selecting a default download folder, ZTerm reports a -120 error instead of prompting you to select a download folder. [4.04] UNIX and Opus settings The radio buttons may change when you open the ZModem Options dialog, but the settings remain unchanged, so the bug is not serious. [4.05] Sending returns in scripts When ZTerm sends a return by itself in a script, it usually sends a space, then the return. To fix the problem, open a copy of ZTerm in ResEdit. Open the CODE resource, then open CODE ID=2. At offset 52B4 find the string 671E 4A6E FFEE. Change 671E to 601E. [4.06] Text pacing If text pacing is set to wait for a line prompt, ZTerm will usually wait for about 5 seconds even if it receives the prompt character. To fix this bug, open a copy of ZTerm in ResEdit, open the CODE resource, then open CODE ID=2. At offset 5082, find the string 3B40 CAC0. Change CAC0 to CABE. [4.07] Unmarking all services Holding down shift-option and selecting Dial Marked is supposed to unmark all services, but doesn't. [4.08] Dialing with the scroll buffer scrolled back When dialing with the scroll buffer scrolled back, ZTerm crashes when a connection is made. This bug does not occur on all systems, but occurs reproducibly on some. [4.09] Phone number field When a large number of characters are in the phone number field, ZTerm adds strange spacing between some characters. This often happens if you include a calling card number in the phone number field. The workaround is to delete all spaces between the numbers. [4.10] VT100 emulation During VT100 emulation, ZTerm sometimes becomes confused about what line the cursor is on. You probably won't notice this unless you're in editing mode. Setting the window size to 24 X 80 helps alleviate the problem to some degree, but there's no getting around the problem completely. [4.11] Non-bugs When the Dial directory is open, command-q invokes queue dialing, rather than quitting ZTerm. According to the ZTerm docs, this is exactly what's supposed to happen. Several other command key shortcuts have different meanings when the Dial directory is open. When ANSI graphics leave the main window and enter the scroll buffer, they lose their special formatting and color and become text. This is described in the ZTerm docs. [4.12] Increasing the port buffer size with ResEdit Open a copy of the ZPhoneList in ResEdit. Doubleclick the zSet resource. The first two bytes are the port buffer size. X'1000 = 4K. X'2000 = 8K. X'3000 = 12K, etc. Settings higher than X'7 (28K) are reported to be unreliable. When you finish, save changes, quit ResEdit, and launch ZTerm. Now choose Port Stats from the Misc menu. You should see the new serial buffer size. Increasing the port buffer size can eliminate some downloading problems, as well as problems which occur when large amounts of data are coming to the screen. Stefano Toria said it best: "I set it at 28K and I am perfectly happy now, I never lose a single bit any more, I can multitask ZTerm, receive huuuge files whilst playing Cumulonimbus, and my wife is expecting our third child :-)." [4.13] Changing the terminal font with ResEdit. Shigeru Yamamoto asked Dave how to use ZTerm with a Japanese font. Dave's instructions follow: "If you want to try a Japanese font, here's what to do: open the ZPhoneList file with ResEdit and open the zSet resource. (Leave the one in the program file alone, it's only used as defaults when the ZPhoneList is created.) At offset 80 hex in this resource is the font name used when emulation is set to VT100. At 90 hex is the font for PC-ANSI. They are Pascal strings, so the first byte is the number of characters in the name. They are fixed fields of 16 bytes, so the longest name that will work is 15 bytes. Make sure you don't change the size of the field, because everything after it is position dependent." So to change the font ZTerm uses for VT100 emulation, open the ZPhoneList in ResEdit, doubleclick the zSet resource, then doubleclick the ID 1 resource. Scroll down to the line that begins with "000080". This is offset 80. It should look like this: 000080 067A 742D 4D61 6320 zt-Mac The "06" is the number of characters in the font name ("zt-mac" is 6 characters). First, change the 06 to the number of characters in the font name. If you're using Courier, change the 06 to 07. Then change the font name from zt-Mac to whatever font you're want. Here's what it would look like if you changed the font to Courier: 000080 0743 6F75 7269 6572 Courier I've tried the hack and found that it works only moderately well. The hack reduces line lengths to about 40 lines, which isn't very useful. (Incidentally, ZTerm sure gets around. Harris Upham sent me a ZTerm hack that allows ZTerm to display two-byte Korean HanTalk characters. Someone else told me that there is a Swiss version of ZTerm.) [5.00] Dialing [5.01] Why is one service in the Dial menu and in the Dial directory in outline? That's the default service. When you launch ZTerm, that service will be the current service. To set the default service, open the Dial directory, hold down the command key, and click on the service you want to be the default. You can also hold down the command key and select the service from the Dial menu. [5.02] I started ZTerm and the only service listed is called Local. Wa' hoppen? ZTerm didn't find your ZPhoneList in the ZTerm folder, so it created a new one with the default entry Local. Find your ZPhoneList and place it in the root level of the ZTerm folder. [5.03] My ZPhoneList with a kajillion phone numbers and settings got trashed. Am I screwed? You're screwed. Always back up your ZPhoneList when you perform your routine backup. Or, to put it another way, whenever you think "Man, I really oughta back up my files one of these days," instead think "Man, I really oughta back up my files, including my ZPhoneList, one of these days." Several reports on comp.sys.mac.comm indicate that the ZPhoneList can be corrupted when restarting a crashed Mac. Apparently this only occurs if you crash after making changes to the ZPhoneList settings without saving the changes. You can prevent this problem by choosing Save Setup from the Dial menu whenever you change ZTerm's settings. If your ZPhoneList becomes corrupted, you might be able to extract the service names and numbers using Denise McElroy's ZTerm Phone Directory Listing, available from FTP sites and America Online. [5.04] Why won't ZTerm send my modem initialization string? ZTerm won't send the modem init string if it can't find the modem. Make sure the modem is turned on and connected to the correct port. ZTerm also won't initialize the modem if the default service doesn't have any characters in the Phone Number field. To fix the problem, type some characters in the field. The characters don't have to be a phone number. "I am the Lizard King" works just fine. So does a couple of spaces. [5.05] Using multiple ZPhoneLists. When you launch ZTerm, it looks for a file called ZPhoneList in the ZTerm folder. To force ZTerm to use a different ZPhoneList, quit ZTerm and doubleclick on the other ZPhoneList, which does not have to be in the ZTerm folder. If multiple ZPhoneLists are present in the ZTerm folder, they must have different names. To force ZTerm to create a new ZPhoneList, rename the old one, or move it out of the ZTerm folder, and launch ZTerm. [5.06] Tip: changing the data rate. You can change the data rate without going to the connection dialog. Click on the data rate string at the bottom of the window to get a popup menu for changing the data rate. [5.07] Tip: changing parity, data bits, and stop bits. Likewise, clicking on the string to the right of the data rate string produces a popup menu for selecting N-8-1, E-7-1, or O-7-1 settings. [5.08] Tip: dialing the current service. Command-shift-d normally dials marked services. If no services are marked, command-shift-d dials the current service. (The current service is the one whose name appears at the top of the window.) [5.09] Tip: adding a separator line to the Dial menu. Create a new service. In the Service Name field, type one or more "-" (hyphens). The Dial menu will now have a standard gray separator line. To take advantage of the separator, some of your service names must come alphabetically before the hyphen. The easiest way to do this is to prefix some of the service names with spaces, which forces them to the top of the Dial menu. P.S. I have lost the name of the person who posted this tip to comp.sys.mac.comm. If that person would be so kind as to send me their name, I'll add it to the credits. [6.00] Connecting [6.01] When ZTerm dials, the dialing line has the A cut off the dial string, like this: TDT 691-7094. What's the deal? First, make sure your modem is turned on, that the modem cable is properly connected to the computer and to the phone jack, and that ZTerm is sending data to the correct port. Assuming all is well with the modem connection, the consensus seems to be that this behavior occurs because a previous comm program left the communications port open. If you experience this problem, quit ZTerm, turn the modem off and then back on, and relaunch ZTerm. One person reported that changing the data rate from 57600 to 38400 solved his problem. Another fixed the problem on his PowerBook by adding a comma to the beginning of the predial initialization string. Thanks to everyone on comp.sys.mac.comm and comp.dcom.modems for their valuable feedback on this problem! [6.02] Why is ZTerm so slow at sending passwords on some services? You have "Wait for character echo" turned on in the Text Pacing options, but the remote system isn't echoing the password characters, so ZTerm waits 5 seconds, times out, and sends the next character. Turn off the "Wait for character echo" option for that service. [6.03] Why isn't there a setting for 14400 bps? The setting in the connection dialog controls the DTE speed (AKA terminal speed, Mac-to-modem speed, serial port speed, or what ZTerm calls the data rate), not the DCE speed (AKA connection speed, modem-to-modem speed, or carrier speed). 14400 is a DCE speed, not a DTE speed. [6.04] What data rate should I use with a 14400 bps modem? With a high speed modem, you want to set the serial port speed higher than the carrier speed so that the modem won't get ahead of the computer. Also, most v.32bis (14400 bps) modems feature hardware compression methods such as v.42bis and MNP 5. To take advantage of hardware compression, the serial port speed must be higher than the carrier speed. When using a 14400 bps modem to connect to another 14400 bps modem, set the DTE speed in the Connection dialog to 19200. You can experiment with higher values, but 19200 should work reliably. Some users report that high DTE speeds are unreliable when AppleTalk is enabled in the Chooser DA. Many people experience problems with 57600 DTE speeds. [6.05] How can I prevent my modem from constantly dropping carrier, especially when I'm receiving lots of information on the screen? Tell the modem to ignore DTR. The appropriate string for most modems is &D0. Turning hardware handshaking off will also work. See also 3.04 if you have call waiting. See also 3.11 if you have a fax modem. [6.06] Why won't my Global Village modem connect at 14400 bps? Send the modem an AT&V command, which will display all settings. If you see \J1, you've found the problem. \J1 enables port rate adjust. This means that the DTE speed will adjust to the DCE speed. But if you connect at 14400 bps, you're in trouble, since ZTerm can't send data to the serial port at 14400 bps. To fix the problem, send AT\J0 (zero) to the modem. Better yet, add \J0 to the modem initialization string in the Modem Preferences dialog. [6.07] Why won't my Global Village modem hang up? The modem's &D setting and ZTerm's setting for hardware (DTR) hangup are conflicting. The setting is in ZTerm's Modem Preferences dialog. Send the command AT&V to your modem to find your &D setting, and set the hardware hangup according to the following table: If your modem is Use this setting in ZTerm's set to this: Modem Preferences: &D0 Set Hardware Hangup (DTR) to off &D1 Set Hardware Hangup (DTR) to off. &D2 Set Hardware Hangup (DTR) to on. &D3 Set Hardware Hangup (DTR) to on. Note that I'm assuming you've set &D to the correct setting. If not, all bets are off. Check the "Hardware Hangup (DTR)" box to turn hardware hangup on. Uncheck the box to turn it off. If all else fails, turn DTR hangup off. DTR hangup is faster, but software hangup works almost every time. [6.08] How can I make my Global Village modem detect a busy signal? Some Global Village modems can't properly detect a busy signal when dialing certain types of terminal servers. James Trammell (trammell@quip.eecs.umich.edu) discovered that placing one or two commas after the phone number solved his problem. When dialing with ZTerm's built-in phone book, type the commas after the phone number in the Connection dialog. When dialing manually, type "ATDT nnn-nnnn,,". The comma is a standard Hayes command which causes the modem to pause during dialing. On most modems, the length of the pause is 2 seconds, but you can set the length of the delay with the S-8 S-register. I should note that the problem is with the modem, not with ZTerm, and that the same solution works with other communications software. [7.00] File Transfers [7.01] Why can't I download a damn thing? If you can't download anything, and if you get a -120 WriteData error when you try, you haven't selected a default receive folder. Go to the Settings menu and choose Receive Folder. If you consistently lose data or get ZRPos errors at the same point in the download, try increasing the port buffer size using the directions in section 4.12. If you get massive CRC errors during ZModem text downloads from UNIX, see section 7.08. If you're having problems with ZModem binary downloads from UNIX, see section 7.09. [7.02] This text, binary, MacBinary, and Smart MacBinary stuff makes my head spin. Which should I use? Unless you know better, use Smart MacBinary, which will automatically select the correct transfer mode. The major exception is if you are uploading non-text files, such as GIFs or .zip files, which PC users will use. In that case, use binary to prevent Finder information from being sent. This reason this setting is so important is because of the Mac's unique file format. Macintosh files have two forks, or parts -- the data fork and the resource fork. The data fork holds data, which is usually text. The resource fork holds resources such as compiled code, pictures, sounds, etc. Text files are usually all data. Applications are mostly resources. This two part structure is unique to the Mac. If you send Mac files to other types of computers, the files will be damaged. Using MacBinary transfers prevents this damage. [7.03] When I download Mac files from a PC BBS, the files have generic icons and are unusable. What went wrong? You didn't use MacBinary or Smart MacBinary. See 7.02. [7.04] Which transfer protocol should I use? If the service you're calling supports ZModem, use it, because: - ZModem is very fast. - ZModem is a batch protocol, meaning you can place more than one file into a batch for uploading or downloading. Most protocols make you request files one at a time. - ZModem has crash recovery. If a 3 hour download is interrupted 1 minute before it finishes, you can redial the service, start the download again, and finish where you left off. - ZModem receives begin automatically. To start a ZModem download, simply tell the other computer to begin the transfer. Your computer will detect a ZModem transfer and automatically enter receive mode. This autoreceive feature necessitates the default download folder, which ZTerm also uses with other transfer protocols. - ZModem handles XON/XOFF software flow control better than other protocols. - ZModem detects the presence of hardware error correction, such as MNP 4 and v.42, and turns off its own error detection. The result is faster throughput when using error-correcting modems. [7.05] Does ZTerm support batch ZModem downloads? Yes. ZModem is by definition a batch protocol. To download multiple files from UNIX using ZModem, use the command sz -w 2048 filename1.txt filename2.hqx etc. [7.06] Interrupting ZModem downloads is messy. What's a modem freak to do? Send an ASCII abort or interrupt character. The abort character varies from host to host, but should be either control-x or control-k. Control-c is the ASCII interrupt character. Whichever character you send, type it repeatedly. [7.07] Can I use ZModem from my VAX or UNIX account? Yes. The necessary source code for VAX is available via anonymous FTP from ee.utah.edu in the directory /Comm/Rzsz. You will need everything but the .tar file. The source code for UNIX is available via anonymous FTP from sumex-aim.stanford.edu in the directory info-mac/comm. The four files are in UNIX shar format. I am told that the code is not ANSI C. My informant says that UNIX users can use the K & R compiler and use the command -cckr. (I've forgotten my informant's name. I hope he'll email me.) [7.08] How do I prevent massive CRC errors during ZModem text downloads from UNIX? In the ZTerm manual, Dave Alverson suggests using "sz -w 2048 filename". Here's an explanation from Fernmail author Dave Platt: "The commonest reason for this sort of failure-to-resynchronize is, in my experience, excessive data buffering between the sending "sz" process and the receiving program. The ZModem protocol can become badly confused if you're connected to your host via a TCP-based terminal server or some similar serial data switch. If the terminal server and the network software provides a substantial amount of data buffering (as it probably does), then the two ZModem processes will each see a _long_ delay between the time that they send a message to their peer, and the time that the response to this message makes it through the network to them. This delay will interfere with the protocol's error-recovery timeouts, and can lead to an endless stream of recovery attempts. "I strongly suggest using the poorly-documented "-w" option when downloading files from a mainframe or workstation, unless you're _sure_ that all of the data communication links between you and the host are running at the same speed and don't do data buffering. The "-w" option enables a four-packet sliding-window mode, which will guarantee that sz will never "get ahead" of your Mac by more than the window-size that you specify. As long as the window size is no more than (e.g.) 10 seconds worth of data, there won't be a problem with the retry timers expiring before the window is emptied. "I usually use "sz -w 2048 filename" when downloading. In fact, I have "sz" aliased to "sz -w 2048" to ensure that I don't forget to use windowed mode." [7.09] How can I make ZModem binary downloads from UNIX more reliable? Joel Schulman wrote to say that he couldn't download binaries until he began using the -e modifier, as in sz -e filename Any feedback on this fix or why it works would be appreciated. [7.10] I have other transfer problems with UNIX. What's Dave been smokin'? If you have trouble with UNIX when you use the telnet command, try the rlogin command, and vice versa. This tip has solved many problems for UNIX users. [7.11] How can I do ZModem uploads to Delphi? One person reports that changing the ZModem options under Settings from rz to uz fixed his uploading problems. [7.12] Where's YModem-G Send? According to ZTerm's excellent Balloon Help, YModem1K send is the same as YModem-G send. [7.13] Why does YModem work on some systems and not others? What some BBSs call YModem is actually XModem-1K. If the BBS offers YModem and YModem Batch, use YModem Batch, which is the true YModem ZTerm expects. Otherwise, if YModem transfers aren't working, tell the BBS to send YModem, and tell ZTerm to receive XModem-1K. Frankly, this is just one more reason to use ZModem. [7.14] Using hardware compression makes my uploads and downloads slower. Was ist los? Most online files are compressed with software utilities such as Stuffit and Compact Pro and can't be compressed much more, if at all. Therefore, the time the modem spends trying to compress and decompress the files can actually slow down the transfers. V.42bis is supposed to detect compressed files and turn off its own compression, but it doesn't always work If hardware compression causes problems, consult your modem manual to learn how to turn it off. [7.15] If I have the Kermit/VT102/etc. Tool, will ZTerm support Kermit/VT102/etc.? Are any ZModem tools available? ZTerm doesn't use the Communications Toolbox for terminal emulation, connection, or file transfer, so it can't use Communications Toolbox tools. The freeware Termy, by Tim Endres of Ice Engineering, can. I've used Termy and Glen Howes' freeware Kermit Tool GH with great success. Kermit Tool GH also works very well with Communicate Lite. There are no freeware or shareware ZModem tools available at this time, but you can download a demo of the Mark/Space ZModem tool. The demo allows downloading, but not uploading. Otherwise, it is fully functional. The demo is available via anonymous ftp from netcom.com in the directory pub/mspace. It should appear very soon at major ftp sites and online services. Payware ZModem tools ship with Pacer Software's PacerTerm (see MacWEEK (08.09.93), Seaquest's tools pack, Aladdin System's SITcomm, and DCI's CrossTalk 2.0. The next version of Communications Lite from Mark/Space Softworks will also include a ZModem tool, and will be a free upgrade for registered users. A demo version of Communicate Lite is available from America Online and via anonymous FTP from netcom.com in the directory mspace/pub. [7.16] How can I resume downloads interrupted by a meddling cat? If an animal, two legged or four legged, presses the 9 key during a download, ZTerm will display zrdata: cnt = 1024 zrdat32: cnt = 1024 et cetera ad nauseam. To fix the problem, press the 0 (zero) key. My friend Neil Schulman discovered this. Dave Alverson tells him this behavior is actually a debugger built into ZTerm. More details as they become available, modem fans. [7.17] Hellfire tarnation and a monkey! Why's my transfer efficiency so low? It may not be low at all. Ignore the percent efficiency figure. The characters per second (cps) rate is a better indicator of efficiency. On the Mac, one character is eight bits. Sending that character over a phone line requires the addition of a start bit and a stop bit. To convert cps to bits per second (bps), multiply cps by ten. The maximum theoretical efficiency without hardware compression or error correction would be 240 cps for 2400 bps modems, 960 for 9600, and 1440 for 14400. The efficiency won't actually be that high, because of line noise and the overhead inherent in any file transfer protocol. Hardware error correction such as MNP 4 and V.42 can increase throughput by as much as eight percent. Hardware compression such as MNP 5 and V.42bis can increase throughput dramatically, assuming the files aren't already compressed with Stuffit, Compact Pro, etc. The reason you should ignore the percent efficiency is that ZTerm normally calculates percent transfer efficiency by dividing the actual throughput by the DTE speed (what ZTerm calls the data rate). Assuming your modem is transferring data at exactly 14400, ZTerm will report the efficiency to be 14400/19200 = 75% at 19200, 14400/38400 = 38% at 38400, and 14400/57600 = 25% at 57600. Yet in each case the actual transfer rate is the same. Having said all of that, you can use the percent efficiency figure if your modem supports the ATW2 command. When the modem is set to W2, ZTerm reports the connect speed as the DCE speed rather than the DTE speed, and calculates percent efficiency based on the DCE speed. So if your modem is transferring data at exactly 14400, ZTerm will report the efficiency to be 14400/14400 = 100%. [8.00] Sound, ANSI Graphics, and Color [8.01] Why oh why won't the ZTerm sounds play? The sounds must be stored in the System file (AKA System suitcase). See 8.02. [8.02] Can I use sounds other than the ones that come with ZTerm? Absolutely. You can rename any sound to "Connect", "Filedone" or "Termbell" and install the sound in the System file. Under System 7, quit all applications and desk accessories and drag the sounds to the icon of the closed System Folder. When asked if you want the sounds installed in the system file, click OK. System 6 users can install sounds into the System file using the shareware SoundMover (shareware by Riccardo Etore) or Apple's ResEdit. You can also use a resource manager, such as Fifth Generation System's SuitCase or Alsoft's MasterJuggler, to open the sounds with ZTerm. [8.03] Is there any limit on the length of the sounds? ZTerm doesn't limit the length of the sounds, but ZTerm can't send or receive data while the sounds are playing. Therefore, a long connect sound may cause connection problems. [8.04] How do I turn my modem speaker down or off? This one is near and dear to my heart, as I used to have the 2400 bps Modem for the Deaf(TM). ZTerm offers three ways to turn the modem speaker off (AT M0), or to turn the speaker down (AT L0) if it's on. (All 0's are zeroes, as they always are in the Hayes language. The only exception is The ATOn command, which is used to return the modem to online mode. In that case, "O" is an "oh". The n is a placeholder for an integer number.) M1 turns the speaker back on. L1 turns the volume back up. 1. You can manually do the deed by typing AT M0 or AT L0 before you make a connection. This method is best if you only want to silence the modem for some sessions. 2. To automatically change the volume when dialing a particular service, enter AT M0 or AT L0 in the "Pre-dial init" field in that service's Connection dialog. This method is best if you want the speaker on for some services and off for others. 3. To automatically control the volume for all services, select Modem Preferences. Click in the "Initialize" field and use the cursor keys to move to the far right. Move the cursor just to the left of ^M and type M0 or L0. This method is best if you want the speaker off for every service, every time. Incidentally, these three techniques work for any initialization string. [8.05] How do I get ANSI graphics when connecting to a PC BBS? 1. Select Terminal Settings for that service and choose the PC ANSI BBS radio button. 2. Also in the Terminal Settings dialog, uncheck the "No Extended Characters (Strip hi bit)" box if it's checked. 3. In the Color Preferences dialog, check the Use Color box. 4. In the Terminal Preferences dialog, set the font size to 9 or 12 point. Other sizes will not work with ANSI graphics. See 10.02. 5. In the Monitors control panel, set the monitor depth to 256 colors or higher. 16 colors will do in a pinch. If you normally use 16 color video, I recommend using Jon Snell's ZTerm Speed Patch, which installs a 16 color palette into ZTerm. [8.06] I did all of that and the ANSI graphics still look a little funny. What gives? ZTerm 0.9 uses 8 colors for ANSI emulation, while some ANSI graphics use 16 colors. The next version will support 16 color ANSI emulation. [8.07] How can I edit the colors ZTerm uses for ANSI graphics? Ordinarily you can't edit the colors, but you can if you use Jon Snell's ZTerm Speed Patch. Once you install the patch, open ZTerm with ResEdit, doubleclick the pltt resource, doubleclick the ID 128 resource, and edit the colors. For more information about ZTerm Speed Patch and where to find it, see "Other ZTerm Information and Software" earlier in the FAQ. [8.08] How can I add excitement to my dull and monotonous life? Select Color Preferences and choose colored text on a darker background. I use yellow text on a black background. Use whatever colors you want. It's your life. [9.00] VT100 Emulation [9.01] I'm wiggin' out, Les. Why don't the home, end, page up, and page down keys on my extended keyboard work? During VT100 emulation, those keys are assigned to VT100 operations. To make them work like normal Macintosh application keys, hold down the shift key and then press them. [9.02] Why don't the f1-f4 editing keys on my extended keyboard work? During VT100 emulation, all of the function keys are assigned to VT100 operations. Use the command key shortcuts or the Edit menu. [9.03] How can I emulate a control key on a Mac Plus? If you are using System 7 on a U.S. system, install the ZTerm Keyboard layout. To do this, drag the keyboard layout to the icon of the closed system folder. When asked if you want to install the keyboard layout, click OK. The option key will now emulate the control key. If you are using a non-U.S. system, or a system earlier than 7.0, select Terminal Settings from the Settings menu. Assign the control key function to the command key. [9.04] How can I emulate an escape key on a Mac Plus? When Option for Control is checked in Terminal Preferences, the accent/grave key in the upper left hand corner of the keyboard emulates the escape key. [9.05] How can I emulate function keys on a PowerBook? Connectix PowerBook Utilities (CPU) provides function key emulation for PowerBooks. CPU is commercial software. If anyone knows of freeware or shareware for emulating function keys, please let me know. [9.06] How can I emulate a numeric keypad on a PowerBook? Use NumericKeypad (AKA U.S. Keypad), a ResEdit resource and keypad written by Mel Park, of the University of Tennessee, Memphis. NumericKeypad maps the numeric keypad to the regular keyboard when the caps lock key is engaged. [9.07] How can I use the numeric keypad to enter numbers? The numeric keypad is sometimes used for special editing functions. If you always want to use it for entering numbers, turn off the "VT100 Keypad" option in the Terminal dialog for that service. [9.08] Tip: positioning the cursor with the mouse. You can not only use the mouse to select text, you can also use it to position the cursor. Hold down the option key. The pointer will become diamond shaped and will move the cursor, somewhat slowly, to wherever you click. [10.00] Text and Text Files See also section 4.13 if you want to change ZTerm's terminal font. [10.01] Can I make the terminal font bigger? Yes. Select Terminal Preferences from the Settings menu and enter a larger size. [10.02] Why does onscreen text look so crummy in anything but 9 or 12 point? ZTerm uses its own terminal font for 9 and 12 point, but uses Monaco for other sizes. If you want to see ANSI graphics, it is essential that you select 9 or 12 point. Monaco doesn't contain the special characters needed for ANSI emulation. A font-morphing wiz could help Dave Alverson and ZTerm users by creating, say, 10 and 11 point sizes of the ZTerm font. Contact Dave Alverson if you're interested. [10.03] Will ZTerm save text files in something other than TeachText? Yes. To change the application ZTerm saves text files in, choose General Preferences from the Settings menu and choose a new file creator. TeachText can't open files larger than 32K, so this feature is especially useful if you save large text files. [10.04] How can I increase the size of the scroll buffer? ZTerm stores the contents of the scroll buffer in memory. To increase the memory partition, quit ZTerm, select ZTerm's icon, and choose Get Info from the File menu. Now enter a larger size for ZTerm's memory partition. [10.05] Why do some characters get corrupted when I copy text from my word processor and paste it into ZTerm? The characters you've pasted are illegal on the system you're logged in to. A lengthy explanation follows. On the Macintosh, all eight bits of a byte are used for characters, producing 256 possible characters (two to the eighth power is 256), though some of these are dead keys, command keys, etc. Mainframes use only seven bits for text, producing only 128 possible characters (two to the seventh power is 128). This seven bit text is the ASCII standard (American Standard for Information Interchange, pronounced "asskey"). If you use any characters which use the eighth bit, the mainframe ignores the last bit and uses the first seven bits to determine which character to display. To avoid illegal characters when composing text for a mainframe, never use any characters which require pressing the option key. Also, in your word processor, turn off smart (curly) quotes, which use the eighth bit. When smart quotes are turned on, the word "don't" usually becomes "donUt" when pasted to a mainframe. And I'll bet dollars to donUts you donUt want that to happen. If you need to upload or paste text files containing illegal eighth bit characters, process the file with the Zap Gremlins command in BBEdit Lite 2.3 (freeware by Richard Siegel). [11.00] Macros and Scripting See also 4.05 for an explanation of a scripting bug and an easy fix. [11.01] How do I know the script is running? You will see a letter or two in the lower right hand corner of the terminal window. These letters are abbreviations for the command the script is preparing to execute. By noting which commands have executed, you can debug scripts more easily. These are the abbreviations and their meanings, as provided by Dave Alverson: b : beep s : send w : wait wp: wait prompt wq: wait for quiet [11.02] How do I cancel a script? Hold down the command key and type a period. Command-period, AKA the International Mac Distress Code, also cancels printing and pastes, in ZTerm or most other applications, and is the keyboard shortcut for the cancel button in most dialog boxes. [11.03] How do I send an escape/linefeed/etc. in a script? To send an escape, use the line: send "^[" where "[" is the lowercase left hand bracket, and "^" is the shift-6 control character. Substitute "^j" for linefeeds. Basically, you can send any ASCII character using a script. All you need is a table of ASCII characters and their meaning. [11.04] Do I have to use the Wait for "da da da" prompt syntax? No. Wait prompt "da da da" works just fine. [11.05] Why is ZTerm sending only part of a line? When a line begins with the "send" command, ZTerm sends everything between the first set of quotes and the second set of quotes. If the string looks like this: send " "It is not I who am crazy ... It is I who am MAD!!!" ^M" ZTerm will send a space, since that's what's between the first and second set of quotes. [11.06] How can I send quotation marks within a send statement? I used to say it couldn't be done, but I found a way. ZTerm recognizes four varieties of quotation marks: single quote, double quote, smart single quote, and smart double quote. If you begin a send statement with one type, ZTerm won't stop sending until it reaches another quote of the same type. (It doesn't, however, care which way the smart quotes face.) For instance, if the send line looks like this: send ' "It is not I who am crazy ... It is I who am MAD!!!" ^M' ZTerm will send everything within the single quote marks (apostrophes). If your send string contains double and single quotes, enclose the string within smart quotes. KeyCaps DA will show you the correct keys for producing smart quotes in your word processor or text editor. As a rule of thumb, don't enclose smart quotes within the send string. See 10.05. [11.07] What does error -49 mean? It means that the script ZTerm tried to use is open in another application, such as your word processor. Close the file and try again. [11.08] I'm goin' nuts! Why won't my login script run? Here's a shotgun blast of possibilities: 1. The file may not be in the right place. Login scripts must be stored in the root level of the ZTerm folder. That is, you should be able to see the ZTerm application and the script in the same Finder window using an icon view. 2. The file may not have the correct name. Login scripts should have the same name as the service, with the ".zts" extension on the end. If the service is called " MacClique" (note the space), the script should be called " MacClique.zts", with a space. 3. The script may not be in text only format. ZTerm can only read text only files (files of type code text), such as TeachText files. If you write the script with your word processor, be sure to use the Save As command and select a text only format. If TeachText can't open the file, it is not in text only format. (One exception: TeachText can't open any file larger than 32K. Or had I mentioned that already? If you have a working, useful script larger than 32K, I'd like to shake your hand.) 4. The script may be an alias. ZTerm doesn't recognize aliased scripts. 5. There may be something wrong with your login script. To test your script, connect to the service, select the Run Script command, and tell ZTerm to use the login script. If the script doesn't work when run manually, the script is faulty. Check spelling and syntax. [11.09] Login script example The login script for my university's timesharing network follows: wait prompt "Local>" send "c vax^M" wait prompt "Username:" send $account "^M" wait prompt "Password:" send $password "^M" Note that $account and $password are NOT inside quotation marks. For this script to work, the values for $account and $password must be entered into the Connection dialog. [11.10] Tip: sending a sig with a script and macro. UNIX users often include a signature at the end of their messages. The signature, or sig, often includes the person's name, email address, company, etc. Sigs are automated in UNIX. ZTerm users can easily include a sig with their email by creating a sig script. Launch your favorite text editor or word processor, set the font to Monaco, and write the sig as you want it to appear. Then enclose each line of text in quotation marks, type "send" without the quotes in front of each line, and include a ^M before the second set of quotation marks. To send a blank line, send a ^M by itself. Save the script in the ZTerm folder and name it sig. If you use a word processor, be sure to use Save As and save in a text only format. Example: send "************************************************************^M" send "Les Jones ljones@utkvx.utk.edu AOL:LeslieJonz^M" send "^M" send "Made from only the freshest electrons and 100% pure ASCII to^M" send " insure that you have the best possible email experience.^M" send "************************************************************^M" Now launch ZTerm and choose Edit Macros from the Macro menu. Name the new macro sig, and type "(option-r)sig" in the Macro String field. Now your sig is only a macro away. You could also use the Run Script command under the Macro menu, but it wouldn't be as convenient. Enjoy! [11.11] Other uses of scripts and macros Scripts and macros can eliminate a lot of needless typing. The following is a script I concocted to speed up Kermit transfers on the VAX. (I'm really looking forward to Kermit support in the next version of ZTerm!) Example: wait "kermit>" prompt send "SET BLOCK_CHECK_TYPE THREE_CHARACTER_CRC_CCITT^M" wait "kermit>" prompt send "SET SEND PACKET_LENGTH 1000^M" wait "kermit>" prompt send "SET RECEIVE PACKET_LENGTH 1000^M" I use the following script to log on to the sumex-aim FTP site. send "FTP sumex-aim.stanford.edu^M" wait prompt "Username:" send "anonymous^M" wait prompt "Password:" send "ljones@utkvx.utk.edu^M" wait prompt "FTP>" send "cd info-mac^M" As in the example in 11.10, I could trigger these scripts with a macro or with the "run script" command. [11.12] Tip: Creating a folder for scripts. ZTerm 1.0 may have a folder for storing scripts. Keith Corwin came up with a way to create a scripts folder using System 7 aliases. 1. Make a new folder called "Scripts" inside the ZTerm folder. 2. Make an alias of ZTerm. 3. Put the original ZTerm (not the alias), scripts, the ZPhoneList, and the ZTerm Xfer Log into the Scripts folder. And finally, an Easter Egg. Open a copy of ZTerm in ResEdit. Doubleclick on the STR resource, then doubleclick on the ID=0 resource. Inside you'll see a line from Monty Python. Enjoy! Send in those corrections and tips! And send Dave your shareware fee! .