home *** CD-ROM | disk | FTP | other *** search
/ ftp.pasteur.org/FAQ/ / ftp-pasteur-org-FAQ.zip / FAQ / macintosh / ZTerm / part2 < prev   
Encoding:
Text File  |  1995-07-23  |  30.5 KB  |  753 lines

  1. Path: senator-bedfellow.mit.edu!bloom-beacon.mit.edu!gatech!stallion.jsums.edu!news.uoregon.edu!usenet.eel.ufl.edu!newsfeed.internetmci.com!news.sprintlink.net!usit.net!lesjones.ppp.usit.net!user
  2. From: lesjones@usit.net (Les Jones)
  3. Newsgroups: comp.sys.mac.comm,comp.sys.mac.apps,comp.answers,news.answers
  4. Subject: ZTerm Frequently Asked Questions Part 2/2
  5. Followup-To: comp.sys.mac.comm
  6. Date: Sat, 22 Jul 1995 14:03:09 -0400
  7. Organization: Softwords
  8. Lines: 734
  9. Approved: news-answers-request@MIT.EDU
  10.  Summary: Answers to frequently asked questions about ZTerm. 
  11.  Please read the FAQ before posting or emailing any questions
  12.  about ZTerm.
  13. Message-ID: <lesjones-2207951403090001@lesjones.ppp.usit.net>
  14. Reply-To: macfaq@aol.com
  15. NNTP-Posting-Host: lesjones.ppp.usit.net
  16. Keywords: FAQ
  17. Xref: senator-bedfellow.mit.edu comp.sys.mac.comm:114545 comp.sys.mac.apps:124382 comp.answers:13253 news.answers:49046
  18.  
  19. Archive-name: macintosh/ZTerm/part2
  20. Posting-Frequency: Monthly
  21.   
  22.  
  23.   [5.00]  File Transfers
  24.   
  25.   [5.01]  Why can't I download a damn thing? (-120 WriteData Error)
  26.   
  27.   If you can't download anything, and if you get a -120 WriteData
  28.   error when you try, you haven't selected a default receive folder.
  29.   Go to the Settings menu and choose Receive Folder. ZTerm 1.0b
  30.   handles the situation more elegantly.
  31.   
  32.   [5.02]  This text, binary, MacBinary, and Smart MacBinary stuff
  33.           makes my head spin. Which should I use?
  34.   
  35.   Unless you know better, use Smart MacBinary, which will
  36.   automatically select the correct transfer mode. The major exception
  37.   is if you are uploading non-text files, such as GIFs or .zip files,
  38.   which PC users will use. In that case, use binary to prevent Finder
  39.   information from being sent.
  40.   
  41.   This reason this setting is so important is because of the Mac's
  42.   unique file format. Macintosh files have two forks, or parts -- the
  43.   data fork and the resource fork. The data fork holds data, which is
  44.   usually text. The resource fork holds resources such as compiled
  45.   code, pictures, sounds, etc. Text files are usually all data.
  46.   Applications are mostly resources. This two part structure is
  47.   unique to the Mac. If you send Mac files to other types of
  48.   computers, the files will be damaged. Using MacBinary transfers
  49.   prevents this damage.
  50.   
  51.   [5.03]  Which transfer protocol should I use?
  52.   
  53.   If the service you're calling supports ZModem, use it, because:
  54.   
  55.   - ZModem is very fast.
  56.   - ZModem is a batch protocol, meaning you can place more than one
  57.   file into a batch for uploading or downloading. Most protocols make
  58.   you request files one at a time.
  59.   - ZModem has crash recovery. If a 3 hour download is interrupted 1
  60.   minute before it finishes, you can redial the service, start the
  61.   download again, and finish where you left off.
  62.   - ZModem receives begin automatically. To start a ZModem download,
  63.   simply tell the other computer to begin the transfer. Your computer
  64.   will detect a ZModem transfer and automatically enter receive mode.
  65.   This autoreceive feature necessitates the default download folder,
  66.   which ZTerm also uses with other transfer protocols.
  67.   - ZModem handles XON/XOFF software flow control better than other
  68.   protocols.
  69.   - ZModem detects the presence of hardware error correction, such as
  70.   MNP 4 and v.42, and turns off its own error detection. The result
  71.   is faster throughput when using error-correcting modems.
  72.   
  73.   [5.04]  Does ZTerm support batch ZModem downloads?
  74.   
  75.   Yes. ZModem is by definition a batch protocol. To download multiple
  76.   files from UNIX using ZModem, use the command
  77.   
  78.     sz -w 2048 filename1.txt filename2.hqx etc.
  79.   
  80.   [5.05]  Interrupting ZModem downloads is messy. What's a modem
  81.           freak to do?
  82.   
  83.   Send an ASCII abort or interrupt character. The abort character
  84.   varies from host to host, but should be either control-x control-k,
  85.   or control-c. Whichever character you send, type it repeatedly.
  86.   
  87.   [5.06]  Can I use ZModem from my VAX or UNIX account?
  88.   
  89.   Yes. The necessary source code for VAX is available via anonymous
  90.   FTP from ee.utah.edu in the directory /Comm/Rzsz. You will need
  91.   everything but the .tar file.
  92.   
  93.   The source code for UNIX is available via anonymous FTP from
  94.   sumex-aim.stanford.edu in the directory info-mac/comm. The four
  95.   files are in UNIX shar format. I am told that the code is not ANSI
  96.   C. My informant says that UNIX users can use the K & R compiler. 
  97.   
  98.   [5.07]  How do I prevent massive CRC errors during ZModem
  99.           text downloads from UNIX?
  100.   
  101.   In the ZTerm manual, Dave Alverson suggests using "sz -w 2048
  102.   filename". Here's an explanation from Fernmail author Dave Platt:
  103.   
  104.   "The commonest reason for this sort of failure-to-resynchronize is,
  105.   in my experience, excessive data buffering between the sending "sz"
  106.   process and the receiving program. The ZModem protocol can become
  107.   badly confused if you're connected to your host via a TCP-based
  108.   terminal server or some similar serial data switch. If the terminal
  109.   server and the network software provides a substantial amount of
  110.   data buffering (as it probably does), then the two ZModem processes
  111.   will each see a _long_ delay between the time that they send a
  112.   message to their peer, and the time that the response to this
  113.   message makes it through the network to them. This delay will
  114.   interfere with the protocol's error-recovery timeouts, and can lead
  115.   to an endless stream of recovery attempts.
  116.   
  117.   "I strongly suggest using the poorly-documented "-w" option when
  118.   downloading files from a mainframe or workstation, unless you're
  119.   _sure_ that all of the data communication links between you and the
  120.   host are running at the same speed and don't do data buffering. The
  121.   "-w" option enables a four-packet sliding-window mode, which will
  122.   guarantee that sz will never "get ahead" of your Mac by more than
  123.   the window-size that you specify. As long as the window size is no
  124.   more than (e.g.) 10 seconds worth of data, there won't be a problem
  125.   with the retry timers expiring before the window is emptied.
  126.   
  127.   "I usually use "sz -w 2048 filename" when downloading. In fact, I
  128.   have "sz" aliased to "sz -w 2048" to ensure that I don't forget to
  129.   use windowed mode."
  130.   
  131.   [5.08]  How can I make ZModem binary downloads from UNIX more
  132.   reliable?
  133.   
  134.   Joel Schulman wrote to say that he couldn't download binaries until
  135.   he began using the -e modifier, as in
  136.   
  137.     sz -e filename
  138.   
  139.   Several readers pointed out that the -e modifier escapes control
  140.   characters such as control-s and control-q. These are the XON/XOFF
  141.   characters used in software flow control. If UNIX sees the XOFF
  142.   character, it stops the file transfer. The -e option tells the UNIX
  143.   host to ignore these characters.
  144.   
  145.   [5.09]  I have other problems with UNIX. What's Dave
  146.           been smokin'?
  147.   
  148.   If you have trouble with UNIX when you use the telnet command, try
  149.   the rlogin command, and vice versa. This tip has solved many
  150.   problems for UNIX users.
  151.   
  152.   [5.10]  How can I do ZModem uploads to Delphi?
  153.   
  154.   One person reports that changing the ZModem options under Settings
  155.   from rz to uz fixed his uploading problems.
  156.   
  157.   [5.11] Where's YModem-G Send?
  158.   
  159.   According to ZTerm's excellent Balloon Help, YModem1K send is the
  160.   same as YModem-G send.
  161.   
  162.   [5.12] Why does YModem work on some systems and not others?
  163.   
  164.   What some BBSes call YModem is actually XModem-1K. If the BBS
  165.   offers YModem and YModem Batch, use YModem Batch, which is the true
  166.   YModem ZTerm expects. Otherwise, if YModem transfers aren't
  167.   working, tell the BBS to send YModem, and tell ZTerm to receive
  168.   XModem-1K. Frankly, this is just one more reason to use ZModem.
  169.   
  170.   [5.13] If I have the Kermit/VT102/etc. Tool, will ZTerm support
  171.          Kermit/VT102/etc.?
  172.   
  173.   ZTerm doesn't use the Communications Toolbox for terminal
  174.   emulation, connection, or file transfer, so it can't use
  175.   Communications Toolbox tools. ZTerm 1.0 supports Kermit file
  176.   transfers.
  177.   
  178.   [5.14]  Hellfire tarnation and a monkey! Why's my transfer
  179.           efficiency so low?
  180.   
  181.   It may not be low at all. Ignore the percent efficiency figure. The
  182.   characters per second (cps) rate is a better indicator of
  183.   efficiency.
  184.   
  185.   The reason you should ignore the percent efficiency is that ZTerm
  186.   normally calculates percent transfer efficiency by dividing the
  187.   actual throughput by the DTE speed (what ZTerm calls the data
  188.   rate). Assuming your modem is transferring data at exactly 14400,
  189.   ZTerm will report the efficiency to be 14400/19200 = 75% at 19200,
  190.   14400/38400 = 38% at 38400, and 14400/57600 = 25% at 57600. Yet in
  191.   each case the actual transfer rate is the same.
  192.   
  193.   Having said all of that, you can use the percent efficiency figure
  194.   if you initialize your modem with ATW2. When the modem is set to
  195.   W2, ZTerm reports the connect speed as the DCE speed rather than
  196.   the DTE speed, and calculates percent efficiency based on the DCE
  197.   speed. So if your modem is transferring data at exactly 14400,
  198.   ZTerm will report the efficiency to be 14400/14400 = 100%.
  199.   
  200.   ![5.15]  How can I exchange files with my friend's computer?
  201.   
  202.   You can call a friend's computer and exchange files directly
  203.   without going through a BBS. Here's how:
  204.   
  205.   1. Set the software on both machines to local echo.
  206.   2. Set the software on both machines to 8 data bits, no stop bits,
  207.   and no parity. Also set both modems to the same data rate. Start
  208.   slow and work your way up.
  209.   3. Speak to each other on the phone just before calling with the
  210.   modem.
  211.   4. Hangup and have one person make the call. When the phone rings
  212.   on the receiving end, type ATA in ZTerm and press the return key.
  213.   5. Type a greeting to make sure you're properly connected.
  214.   6. The person sending files should have Transfer Convert under the
  215.   File menu set properly. Use MacBinary to transfer files between two
  216.   Macs. Use Binary for Mac-to-PC transfers.
  217.   7. The person sending the file should use ZModem. The other
  218.   computer will automatically receive the file.
  219.   8. The receiving party must have selected a default receive folder
  220.   by choosing Set Receive folder under the Settings menu.
  221.   
  222.   ![5.16  How can I make Kermit transfers faster?
  223.   
  224.   Choose Transfer Options from the Settings menu. Choose Kermit from
  225.   the Send and Receive popup menus. Set Error Checking to CRC and set
  226.   Packet Size to 1000.
  227.   
  228.   
  229.   
  230.   [6.00]  Sound, ANSI Graphics, and Color
  231.   
  232.   [6.01]  Why oh why won't the ZTerm sounds play?
  233.   
  234.   The sounds must be stored in the System file (AKA System suitcase).
  235.   See below.
  236.   
  237.   [6.02]  Can I use sounds other than the ones that come with ZTerm?
  238.   
  239.   Absolutely. You can rename any sound to "Connect", "Filedone" or
  240.   "Termbell" and install the sound in the System file. Under System
  241.   7, quit all applications and desk accessories and drag the sounds
  242.   to the icon of the closed System Folder. When asked if you want the
  243.   sounds installed in the system file, click OK.
  244.   
  245.   System 6 users can install sounds into the System file using the
  246.   Riccardo Ettore's shareware SoundMover (part of the SoundManager
  247.   Package) or Apple's ResEdit. You can also use a resource manager,
  248.   such as Fifth Generation System's SuitCase or Alsoft's
  249.   MasterJuggler, to open the sounds with ZTerm.
  250.   
  251.   [6.03]  Is there any limit on the length of the sounds?
  252.   
  253.   ZTerm doesn't limit the length of the sounds, but ZTerm can't send
  254.   or receive data while the sounds are playing. A long connect sound
  255.   may cause connection problems, so keep it short.
  256.   
  257.   [6.04]  How do I turn my modem speaker down or off?
  258.   
  259.   This one is near and dear to my heart, as I used to have the 2400
  260.   bps Modem for the Deaf(TM). ZTerm offers three ways to turn the
  261.   modem speaker off (AT M0), or to turn the speaker down (AT L0) if
  262.   it's on. (All 0's are zeroes, as they always are in the Hayes
  263.   language. The only exception is The ATOn command, which is used to
  264.   return the modem to online mode. In that case, "O" is an "oh". The
  265.   n is a placeholder for an integer number.)  M1 turns the speaker
  266.   back on. L1 turns the volume back up.
  267.   
  268.   1. You can manually do the deed by typing AT M0 or AT L0 before you
  269.   make a connection. This method is best if you only want to silence
  270.   the modem for some sessions.
  271.   
  272.   2. To automatically change the volume when dialing a particular
  273.   service, enter AT M0 or AT L0 in the "Pre-dial init" field in that
  274.   service's Connection dialog. This method is best if you want the
  275.   speaker on for some services and off for others.
  276.   
  277.   3. To automatically control the volume for all services, select
  278.   Modem Preferences. Click in the "Initialize" field and use the
  279.   cursor keys to move to the far right. Move the cursor just to the
  280.   left of ^M  and type M0 or L0. This method is best if you want the
  281.   speaker off for every service, every time.
  282.   
  283.   Incidentally, these three techniques work for any initialization
  284.   string.
  285.   
  286.   [6.05]  How do I get ANSI graphics when connecting to a PC BBS?
  287.   
  288.   1. Select Terminal Settings for that service and choose the PC ANSI
  289.   BBS radio button.
  290.   
  291.   2. Also in the Terminal Settings dialog, uncheck the "No Extended
  292.   Characters (Strip hi bit)" box if it's checked.
  293.   
  294.   3. In the Color Preferences dialog, check the Use Color box.
  295.   
  296.   4. In the Terminal Preferences dialog, set the font size to 9 or 12
  297.   point. Other sizes will not display ANSI graphics.
  298.   
  299.   5. In the Monitors control panel, set the monitor depth to 256
  300.   colors or higher. 16 colors will do in a pinch. If you normally use
  301.   16 color video, I recommend using Jon Snell's ZTerm High Speed
  302.   Patch, which installs a 16 color palette into ZTerm.
  303.   
  304.   6.  ZTerm 1.0b only: in Terminal settings, select Terminal Font.
  305.   
  306.   [6.06]  I did all of that and the ANSI graphics still look a
  307.          little funny. What gives?
  308.   
  309.   ZTerm 0.9 uses 8 colors for ANSI emulation, while some ANSI
  310.   graphics use 16 colors. ZTerm 1.0 supports 16 color ANSI emulation,
  311.   so you're better off using 1.0.
  312.   
  313.   [6.07]  How can I edit the colors ZTerm uses for ANSI graphics?
  314.   
  315.   The ANSI colors in ZTerm 1.0 are editable. Choose Color Preferences
  316.   from the Settings menu and doubleclick any color to change it.
  317.   
  318.   Ordinarily you can't edit the colors in ZTerm 0.9, but you can if
  319.   you use Jon Snell's ZTerm Speed Patch. Once you install the patch,
  320.   open a copy of ZTerm with ResEdit, doubleclick the pltt resource,
  321.   doubleclick the ID 128 resource, and edit the colors by
  322.   doubleclicking them. 
  323.   
  324.   ![6.07]  What ANSI color settings should I use?
  325.   
  326.   Keith Corwin (kcorwin@delphi.com) posted a table of RGB color
  327.   values that closely match the ANSI colors on many PC systems. 
  328.   
  329.   Apple RGB Color Picker (System 7.5)
  330.   +----------------------------+ +-----------------------------+
  331.   |Color        | %R | %G | %B | |Color         | %R | %G | %B |
  332.   +-------------+----+----+----+ +--------------+----+----+----+
  333.   |Dark Black   |  0 |  0 |  0 | |Light Black   | 33 | 33 | 33 |
  334.   |Dark Red     | 67 |  0 |  0 | |Light Red     |100 | 40 | 40 |
  335.   |Dark Green   |  0 | 67 |  0 | |Light Green   | 40 |100 | 40 |
  336.   |Dark Yellow  | 60 | 40 |  0 | |Light Yellow  |100 |100 | 40 |
  337.   |Dark Blue    |  0 |  0 | 67 | |Light Blue    | 40 | 40 |100 |
  338.   |Dark Magenta | 60 |  0 | 60 | |Light Magenta |100 | 40 |100 |
  339.   |Dark Cyan    |  0 | 60 | 60 | |Light Cyan    | 40 |100 |100 |
  340.   |Dark White   | 67 | 67 | 67 | |Light White   |100 |100 |100 |
  341.   +----------------------------+ +-----------------------------+
  342.   
  343.   
  344.   Old Color Picker (System 7.1 and below), RGB codes
  345.   +-------------------------------+
  346.   +--------------------------------+
  347.   |Color        |  R  |  G  |  B  | |Color         |  R  |  G  |  B 
  348.   |
  349.   +-------------+-----+-----+-----+
  350.   +--------------+-----+-----+-----+
  351.   |Dark Black   |  0  |  0  |  0  | |Light Black  
  352.   |21626|21626|21626|
  353.   |Dark Red     |43908|  0  |  0  | |Light Red    
  354.   |65535|26214|26214|
  355.   |Dark Green   |  0  |43908|  0  | |Light Green  
  356.   |26214|65535|26214|
  357.   |Dark Yellow  |39321|26214|  0  | |Light Yellow 
  358.   |65535|65535|26214|
  359.   |Dark Blue    |  0  |  0  |43908| |Light Blue   
  360.   |26214|26214|65535|
  361.   |Dark Magenta |39321|  0  |39321| |Light Magenta
  362.   |65535|26214|65535|
  363.   |Dark Cyan    |  0  |39321|39321| |Light Cyan   
  364.   |26214|65535|65535|
  365.   |Dark White   |43908|43908|43908| |Light White  
  366.   |65535|65535|65535|
  367.   +-------------------------------+
  368.   +--------------------------------+
  369.   
  370.   
  371.   [6.08]  How can I add excitement to my dull and monotonous life?
  372.   
  373.   Select Color Preferences and choose colored text on a darker
  374.   background. I use yellow text on a black background. Use whatever
  375.   colors you want. It's your life.
  376.   
  377.   
  378.   
  379.   [7.00]   VT100 Emulation
  380.   
  381.   [7.01]  I'm wiggin' out, Les! Why don't the home, end, page
  382.           up, and page down keys on my extended keyboard work?
  383.   
  384.   During VT100 emulation, those keys are assigned to VT100
  385.   operations. To make them work like normal Macintosh application
  386.   keys, hold down the shift key and then press them.
  387.   
  388.   [7.02]  Why don't the f1-f4 editing keys on my extended keyboard
  389.           work?
  390.   
  391.   During VT100 emulation, all of the function keys are assigned to
  392.   VT100 operations. Use the command key shortcuts or the Edit menu.
  393.   
  394.   [7.03]  How can I emulate a control key on a Mac Plus?
  395.   
  396.   If you are using System 7 on a U.S. system, install the ZTerm
  397.   Keyboard layout. To do this, drag the keyboard layout to the icon
  398.   of the closed system folder. When asked if you want to install the
  399.   keyboard layout, click OK. The option key will now emulate the
  400.   control key.
  401.   
  402.   If you are using a non-U.S. system, or a system earlier than 7.0,
  403.   select Terminal Settings from the Settings menu. Assign the control
  404.   key function to the command key.
  405.   
  406.   [7.04]  How can I emulate an escape key on a Mac Plus?
  407.   
  408.   When Option for Control is checked in Terminal Preferences, the
  409.   accent/grave key in the upper left hand corner of the keyboard
  410.   emulates the escape key.
  411.   
  412.   [7.05]  How can I emulate function keys on a PowerBook?
  413.   
  414.   Connectix PowerBook Utilities (CPU) provides function key emulation
  415.   for PowerBooks. CPU is commercial software. If anyone knows of
  416.   freeware or shareware for emulating function keys, please let me
  417.   know.
  418.   
  419.   Date: Fri, 12 May 1995 20:55:39 +0059 (EDT)
  420.   From: Rich Scarlet <rscarlet@world.std.com>
  421.   Subject: Function keys-powerbooks-for Zterm
  422.   To: lesjones@usit.net
  423.   
  424.   In your Zterm FAQ you wrote:
  425.   
  426.       Connectix PowerBook Utilities (CPU) provides function key
  427.   emulation
  428.     for PowerBooks. CPU is commercial software. If anyone knows of
  429.     freeware or shareware for emulating function keys, please let me
  430.     know.
  431.   
  432.   
  433.   I think there are two shareware solutions, available from the usual
  434.   sources.
  435.   
  436.   One is Keyboard Plus. From the documentation:
  437.     Keyboard PLUS was written by me, Berrie Kremers. I can be reached
  438.   at:
  439.        Prof. Cobbenhagenlaan 464
  440.        5037 DJ  Tilburg
  441.        The Netherlands
  442.     or via e-mail:
  443.        berrie@kub.nl
  444.   This is a special-purpose control panel designed just to provide
  445.   extended
  446.   keys on a PowerBook or other more limited keyboard.
  447.   
  448.   Another is KeyQuencer, by Alex Levi Montalcini  lmontalcini@pmn.it
  449.   This is a general-purpose programmable macro control panel. It's a
  450.   bit of
  451.   work to program all the extended keys you'd like to use, but
  452.   straightforward.
  453.   And it's a very useful control panel for many other things.
  454.   
  455.   I've used both on my Powerbook (with Zterm 0.9) (all registered!).
  456.   I've
  457.   finally settled on KeyQuencer, because after it's programmed it can
  458.   do all
  459.   that Keyboard Plus can do, plus lots more.
  460.   
  461.   ===
  462.   Many thanks for the FAQ!
  463.   
  464.   Rich Scarlet     rscarlet@world.std.com
  465.   
  466.   
  467.   [7.06]  How can I emulate a numeric keypad on a PowerBook?
  468.   
  469.   Use NumericKeypad (AKA U.S. Keypad), a ResEdit resource and keypad
  470.   written by Mel Park, of the University of Tennessee, Memphis.
  471.   NumericKeypad maps the numeric keypad to the regular keyboard when
  472.   the caps lock key is engaged.
  473.   
  474.   [7.07]  How can I use the numeric keypad to enter numbers or PF
  475.   keys?
  476.   
  477.   The numeric keypad is sometimes used for special editing functions
  478.   on the host machine. If you want to use the numeric keypad for PF
  479.   keys, make sure VT100 Keypad is turned on. Conversely, if you
  480.   always want to use it for entering numbers, turn off the "VT100
  481.   Keypad" option in the Terminal dialog for that service.
  482.   
  483.   [7.08]  How can I get ZTerm to work with Lynx?
  484.   
  485.   Lynx is a popular text-based World Wide Web browser. To configure
  486.   ZTerm for Lynx, open the Terminal settings window, click the VT100
  487.   option, and make sure that Auto Line Feed is turned OFF.
  488.   
  489.   [7.09]  Tip: positioning the cursor with the mouse.
  490.   
  491.   You can not only use the mouse to select text, you can also use it
  492.   to position the cursor. Hold down the option key. The pointer will
  493.   become diamond shaped and will move the cursor, somewhat slowly, to
  494.   wherever you click.
  495.   
  496.   
  497.   
  498.   [8.00] Text and Text Files
  499.   
  500.   [8.01]  Can I make the terminal font bigger?
  501.   
  502.   Yes. Select Terminal Preferences from the Settings menu and enter a
  503.   larger size.
  504.   
  505.   [8.02]  Can I change the font ZTerm uses?
  506.   
  507.   Beginning with ZTerm 1.0b, you can change the font in the Terminal
  508.   settings for each service. Be aware, however, that most fonts do no
  509.   work well for terminal emulation. ZTermā•£s built-in font is unique
  510.   in that it's monospaced (every character is the same width) and
  511.   that the bold characters are the same width as plain characters. 
  512.   
  513.   Few fonts have both of these characteristics. Some that do include
  514.   VT100, and the Adobe PostScript version of Monaco and Courier. The
  515.   TrueType versions of Monaco and Courier which came with your Mac
  516.   don't work especially well, because the bold characters are wider
  517.   than the plain characters. Thanks to Walter Ian Kaye
  518.   (boodlums@genie.geis.com) for his input on fonts.
  519.   
  520.   [8.03]  How can I increase the size of the scroll buffer?
  521.   
  522.   ZTerm stores the contents of the scroll buffer in memory. To
  523.   increase the memory partition, quit ZTerm, select ZTerm's icon, and
  524.   choose Get Info from the File menu. Now enter a larger size for
  525.   ZTerm's memory partition.
  526.   
  527.   [8.04]  Why do some characters get corrupted when I copy text from
  528.           my word processor and paste it into ZTerm?
  529.   
  530.   The characters you've pasted are illegal on the system you're
  531.   logged in to. A lengthy explanation follows.
  532.   
  533.   On the Macintosh, all eight bits of a byte are used for characters,
  534.   producing 256 possible characters (two to the eighth power is 256).
  535.   Internet mail and Usenet newsgroups use only seven bits for text,
  536.   producing only 128 possible characters (two to the seventh power is
  537.   128). If you use any characters which use the eighth bit, the host
  538.   computer ignores the last bit and uses the first seven bits to
  539.   determine which character to display.
  540.   
  541.   To avoid illegal characters when composing text for a mainframe,
  542.   never use any characters which require pressing the option key.
  543.   Also, in your word processor, turn off smart (curly) quotes, which
  544.   use the eighth bit. When smart quotes are turned on, the word
  545.   "don't" usually becomes "donUt" when pasted to a mainframe. And
  546.   I'll bet dollars to donUts you donUt want that to happen.
  547.   
  548.   If you need to upload or paste text files containing illegal eighth
  549.   bit characters, process the file with the Zap Gremlins command in
  550.   BBEdit Lite (freeware by Richard Siegel).
  551.   
  552.   [9.00] Macros and Scripting
  553.   
  554.   ![9.01]  What are macros and how do I use them?
  555.   
  556.   Macros are mainly used to send strings of text. Choose Edit Macros
  557.   from the Macros menu and type in the text you'd like to send. You
  558.   can activate the macro by choosing it from the Macro menu or typing
  559.   the command-key shortcut. I store "anonymous" in one macro and my
  560.   email address in another. When an ftp host asks for my user name
  561.   and password, I can send them with two keystrokes.
  562.   
  563.   In ZTerm, macros can also be used to run scripts. Simply type the
  564.   name of the script into the macro editor, and place the (option-r)
  565.   character in front of it. The script must be stored in the ZTerm
  566.   folder, and it must have the name you typed into the script editor.
  567.   If ZTerm can't find the script in the ZTerm folder, it will return
  568.   a "[" (left bracket) when you try to run the script with a macro.
  569.   
  570.   [9.02]  How do I know my script is running?
  571.   
  572.   You will see a letter or two in the lower right hand corner of the
  573.   terminal window. These letters are abbreviations for the command
  574.   the script is preparing to execute. By noting which commands have
  575.   executed, you can more easily debug scripts.
  576.   
  577.   These are the abbreviations and their meanings, as provided by Dave
  578.   Alverson:
  579.   
  580.   b : beep
  581.   s : send
  582.   w : wait (time)
  583.   wp: wait prompt
  584.   wq: wait for quiet
  585.   
  586.   [9.03]  How do I cancel a script?
  587.   
  588.   Hold down the command key and type a period. Command-period, AKA
  589.   the International Mac Distress Code, also cancels printing and
  590.   pastes, in ZTerm or most other applications, and is the keyboard
  591.   shortcut for the cancel button in most dialog boxes.
  592.   
  593.   [9.04]  How do I send an escape/linefeed/break/etc. in a script?
  594.   
  595.   To send an escape, use the line:
  596.   
  597.     send "^["
  598.   
  599.   where "[" is the lowercase left hand bracket, and "^" is the
  600.   shift-6 control character. Substitute "^j" for linefeeds.
  601.   Basically, you can send any ASCII character using a script. All you
  602.   need is a table of ASCII characters and their meaning.
  603.   
  604.   Note that a break is not an ASCII character, so ZTerm 0.9 couldn't
  605.   send a break in a script. ZTerm 1.0 now has a send break command.
  606.   
  607.   [9.05]  Do I have to use the Wait for "da da da" prompt syntax?
  608.   
  609.   Nope.
  610.   
  611.     Wait prompt "da da da"
  612.   
  613.   works just fine.
  614.   
  615.   [9.06]  Why is ZTerm sending only part of a line?
  616.   
  617.   When a line begins with the "send" command, ZTerm sends everything
  618.   between the first set of quotes and the second set of quotes. If
  619.   the string looks like this:
  620.   
  621.     send " "It is not I who am crazy ... It is I who am MAD!!!" ^M"
  622.   
  623.   ZTerm will send a space, because that's what's between the first
  624.   and second set of quotes.
  625.   
  626.   [9.07]  How can I send quotation marks within a send statement?
  627.   
  628.   I used to say it couldn't be done, but I found a way.
  629.   
  630.   ZTerm recognizes four varieties of quotation marks: single quote,
  631.   double quote, smart single quote, and smart double quote. If you
  632.   begin a send statement with one type, ZTerm won't stop sending
  633.   until it reaches another quote of the same type. (It doesn't,
  634.   however, care which way the smart quotes face.)  For instance, if
  635.   the send line looks like this:
  636.   
  637.     send ' "It is not I who am crazy ... It is I who am MAD!!!" ^M'
  638.   
  639.   ZTerm will send everything within the single quote marks
  640.   (apostrophes).
  641.   
  642.   If your send string contains double and single quotes, enclose the
  643.   string within smart quotes. KeyCaps DA will show you the correct
  644.   keys for producing smart quotes in your word processor or text
  645.   editor. As a rule of thumb, don't enclose smart quotes within the
  646.   send string, because smart quotes use the eighth bit.
  647.   
  648.   [9.08]  What does error -49 mean?
  649.   
  650.   It means that the script ZTerm tried to use is open in another
  651.   application, such as your word processor. Close the script file and
  652.   try again.
  653.   
  654.   [9.09]  I'm goin' nuts! Why won't my login script run?
  655.   
  656.   Here's a shotgun blast of possibilities:
  657.   
  658.   1. The file may not be in the right place. Login scripts must be
  659.   stored in the root level of the ZTerm folder. That is, scripts
  660.   should be inside the ZTerm folder, but not inside any other
  661.   folders.
  662.   
  663.   2. The file may not have the correct name. Login scripts should
  664.   have the same name as the service, with the ".zts" extension on the
  665.   end. If the service is called " MacClique" (note the space), the
  666.   script should be called " MacClique.zts", with a space.
  667.   
  668.   3. The script may not be in text only format. ZTerm can only read
  669.   text only files (files of type code text), such as TeachText files.
  670.   If you write the script with your word processor, be sure to use
  671.   the Save As command and select a text only format. If TeachText
  672.   can't open the file, it is not in text only format. 
  673.   
  674.   (One exception: TeachText can't open text files larger than 32K. Or
  675.   had I mentioned that already? If you have a working, useful script
  676.   larger than 32K, I'd like to shake your hand.)
  677.   
  678.   4. The script may be an alias. ZTerm 0.9 doesn't recognize aliased
  679.   scripts. ZTerm 1.0 does.
  680.   
  681.   5. There may be something wrong with your login script. To test
  682.   your script, connect to the service, select the Run Script command,
  683.   and tell ZTerm to use the login script. If the script doesn't work
  684.   when run manually, the script is faulty. Check spelling and syntax.
  685.   
  686.   
  687.   [9.10]  Login script example
  688.   
  689.   This is the login script I used to use for my university's
  690.   timesharing network:
  691.   
  692.   wait prompt "Local>"
  693.   send "c vax^M"
  694.   wait prompt "Username:"
  695.   send $account "^M"
  696.   wait prompt "Password:"
  697.   send $password "^M"
  698.   
  699.   Note that $account and $password are NOT inside quotation marks.
  700.   For this script to work, the values for $account and $password must
  701.   be entered into the Connection dialog.
  702.   
  703.   [9.11]  Tip: sending a sig with a script and macro.
  704.   
  705.   UNIX users often include a signature at the end of their messages.
  706.   The signature, or sig, often includes the person's name, email
  707.   address, company, etc. Sigs are automated in UNIX. ZTerm users can
  708.   easily include a sig with their email by creating a sig script.
  709.   
  710.   Launch your favorite text editor or word processor, set the font to
  711.   Monaco, and write the sig as you want it to appear. Then enclose
  712.   each line of text in quotation marks, type "send" without the
  713.   quotes in front of each line, and include a ^M before the second
  714.   set of quotation marks. To send a blank line, send a ^M by itself.
  715.   Save the script in the ZTerm folder and name it sig. If you use a
  716.   word processor, be sure to use Save As and save in a text only
  717.   format.
  718.   
  719.   Example:
  720.   
  721.   send "-- ^M"
  722.   send "Les Jones"
  723.   send "The America Online and ZTerm FAQs^M"
  724.   send "ftp://usit.net/pub/lesjones/^M"
  725.   
  726.   Now launch ZTerm and choose Edit Macros from the Macro menu. Name
  727.   the new macro sig, and type "(option-r)sig" in the Macro String
  728.   field. Now your sig is only a macro away. You could also use the
  729.   Run Script command under the Macro menu, but it wouldn't be as
  730.   convenient. Enjoy!
  731.   
  732.   [9.12]  Other uses of scripts and macros
  733.   
  734.   Scripts and macros can eliminate a lot of needless typing. I used
  735.   to use the following script to log on to the sumex-aim FTP site.
  736.   
  737.   send "FTP sumex-aim.stanford.edu^M"
  738.   wait prompt "Username:"
  739.   send "anonymous^M"
  740.   wait prompt "Password:"
  741.   send "ljones@utkvx.utk.edu^M"
  742.   wait prompt "FTP>"
  743.   send "cd info-mac^M"
  744.   
  745.   
  746.   Send in those corrections and tips! And send Dave your shareware
  747.   fee!
  748.  
  749. --         |  macfaq@aol.com   | AOL, Good Times and ZTerm FAQs |
  750. Les Jones  | lesjones@usit.net |  ftp://usit.net/pub/lesjones/  |
  751.  
  752. \\\ Okra-Kola: East Tennessee's favorite okra-flavored soda ///
  753.