TOPS Terminal and TOPS TCP/IP Copyright 1988 Sun Microsystems, Inc. All rights reserved. TOPS Terminal & TOPS TCP/IP are a gift from the people of the TOPS Division of Sun Microsystems, Inc. Oregon State University is the designated distribution site. If you like them, please send $25 to the United Way. TOPS Terminal & TOPS TCP/IP and their documentation may be duplicated for personal use or distributed free of charge. They may not be duplicated for resale or to serve as the origin of, or as a portion of, a commercial product. All duplicates must carry this entire notice. This product is provided RAS ISS without warranties of any kind. SUN AND O.S.U. SPECIFICALLY DISCLAIM ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL SUN OR O.S.U. BE LIABLE FOR DIRECT, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE FURNISHING, USE, OR PERFORMANCE OF THIS PRODUCT. This product is provided solely for the convenience of the user and is offered without support of any kind. Tops Terminal & Tops TCP/IP is available by annymous FTP from: CS.ORST.EDU or on disk from: Department of Computer Science Oregon State University Corvallis, Oregon 97331-3902 (see disk order form in file "order_form" ) Please address any problems or questions to Oregon State University, Computer Science Dept We would also like to have your recommendations and suggested enhancements. Email can be sent to: topsterm@CS.ORST.EDU tektronix!orstcs!topsterm hplabs!hp-pcd!orstcs!topsterm What is TOPS Terminal? TOPS Terminal is a communications program that works equally well over the phone lines or over a network. It does terminal emulation and supports the well known File Transfer and XModem Protocols. The file to download for the application is called RTOPS Terminal.sit.S It is about 200 kB long and has been compressed by the program Stuffit (Version ?.??). It should contain the following files: TOPS Terminal, TOPS TCP/IP, and TOPS Terminal Help. The manual can also be downloaded. It was created with Microsoft Word (Version ?.?? Fonts ?) and is called RTOPS Terminal Manual.sit Sand has also been compressed by the program Stuffit. This file is about 750 kB long and will take about 50 minutes to download at 2400 baud. The Quick Refence Guide, included below, tellss you how to use the basics of the program. To use TOPS Terminal on a network, the TOPS TCP/IP startup file must be placed in your system folder and your machine must be restarted. If a dialogue appears requesting information about the RkipperS, you probably do not have a compatible gateway on your net. You must hand configure the IP addresses of your machine and the gateway; talk to your system administrator for details. TOPS Terminal will remember these addresses for you the next time you restart your machine. See the next section for details on how to get started. How to get Started Fast All of the information below is also available, in greater detail, in the TOPS Terminal manual. The TOPS Terminal files and their descriptions: %TOPS TCP/IP -- Put in your System Folder and reboot your Mac. Mandatory for Network Connections. %TOPS Terminal -- Place in a folder. This is the application file. %TOPS Terminal Help -- Place in a folder with TOPS Terminal. This file provides on-line help and is optional. %TOPS Terminal Memory -- This file is created by TOPS Terminal and should be left in the System Folder. It contains the descriptions of computers and accounts and other variables that you have set within TOPS Terminal. Only one copy of this file should exist on a Mac. More than one copy can cause problems with computer and account information. %TOPS TCP/IP Memory -- This file contains information about your Mac's IP address and is created by TOPS Terminal. Installation 1. Copy the files TOPS Terminal and TOPS Terminal Help to a folder on your hard or floppy drive. 2. Copy the the TOPS TCP/IP file to your System Folder on your Macintosh. If you are using only modem or serial connections you do not need to use this file. 3. Reboot your Macintosh. 4. During the reboot, you will see a screen with three options that you may select. Below, the options are listed and the explanations of each choice are given. a. Don't install TOPS TCP/IP. By selecting this option, you will not be able to use TOPS Terminal unless you are connected serially or via modem to your host machine. b. Find a KIP Server. If you select this option, TOPS Terminal will look on the network for a device running KIP software, such as a Kinetics FastPath or GatorBox. The KIP software will give your Mac an IP address. If you select this option, and the screen reappears a few seconds later, then TOPS Terminal cannot find a KIP server on your network. c. Configure TOPS Terminal by Hand. If you select this option you will see a screen where you can give your Mac an IP address, tell TOPS Terminal the the address of the Appletalk to Ethernet gateway, subnet shift, and subnet mask, if any. TOPS Terminal will not work properly if you do not configure this screen correctly. 5. To check or change the configuration of the IP addresses for TOPS Terminal, go to the the Control Panel desk accessory, and select the TOPS TCP/IP icon. From, there you can select the My Internet Address radio button, and see the TOPS Terminal IP configuration screen. Starting TOPS Terminal 1. Double click on the application file called TOPS Terminal. 2. If this is the first time you are using TOPS Terminal, you will see a screen asking if you want help or not. Choose the appropriate option. 3. You will now see the TOPS Terminal logo, and the File, Edit, Network, and Settings menu headings. Starting a Manual TCP/IP Session 1. Under the Network menu, select Terminal Session. 2. When you see the screen that allows you to choose the account you wish to use, select Manual TCP/IP. 3. Select the type of terminal you want to emulate. 4. Type the IP address of the host computer and click OK. 5. You should now see the login prompt of the remote computer. Other Types of Connections % If you are using a Manual Phone connection, TOPS Terminal will prompt you in a similar way that using Manual TCP/IP does. % There are ways to set up computer and account descriptions so that you do not have to configure TOPS Terminal each time you want to start a terminal session or file transfer. You can do this by setting up computer and account descriptions for both Network and Phone connections, from within the Settings menu. You will then be able to select the newly created account instead of Manual TCP/IP or Manual Phone from within TOPS Terminal. See the quick reference guide later in this document for more information on setting up Account and Computer descriptions. Quick Reference Guide Computer Descriptions % Creating a Computer Description for a Network Connection 1. Select Computers from the Settings menu. 2. Click on the New button. 3. Type the computerUs name and TCP/IP address. 4. Select the operating system. 5. Click on OK. 6. Click on Done. % Creating a Computer Description for a Telephone Connection 1. Select Modem from the Settings menu. 2. Select modem type. 3. Change the modem settings as desired and then click on OK. 4. Select Computers from the Settings menu. 5. Click on the New button. 6. Type the computerUs name and phone number. 7. Select operating system. 8. Select the baud rate for the modem. 9. Change the other communications settings, if necessary. 10. Click on OK. 11. Click on Done. % Modifying a computer description 1. Select Computers from the Settings menu. 2. Select computer and click on Open. 3. Modify the computer description. 4. Click on OK. 5. Click on Done. % Removing a computer description 1. Select Computers from the Settings menu. 2. Select computer and click on Remove. Account Descriptions % Use account description from TOPS Terminal Memory 1. Select Accounts from the Settings menu. 2. Click on New. 3. Click on Memory. 4. Select a computer and click on OK. 5. Type your user name and password (optional) and click on OK. 6. Select a terminal type and click on OK. 7. Modify options as desired in Description of Account then click on OK. 8. Click on Done. % Use account description from a signPup file 1. Select Accounts from the Settings menu. 2. Click on New. 3. Click on Sign Up. 4. Select a Sign-up file and click on Open. 5. Select a computer and click on OK. 6. Type your user name and password (optional) and click on OK. 7. Select a terminal type and click OK. 8. Modify options as desired in Description of Account then click on OK. 9. Click on Done. % Make a new acount description 1. Select Accounts from the Settings menu. 2. Click on New. 3. Click on New. 4. Type in a name for the new computer and click on OK. 5. Type your user name and password (optional) and click OK. 6. Select a terminal type and click on OK. 7 Complete the computer description and click on OK. 8. Click on the check boxes in Description of an Account, and click on OK. 9. Click on Done. % Modifying an account description 1. Select Accounts from the Settings menu. 2. Select account and click on Open. 3. Modify options as desired in Description of Account then click on OK. 4. Click on OK. 5. Click on Done. % Removing an account description 1. Select Accounts from the Settings menu. 2. Select account you want to remove and click on Remove. 3. Click on Done. Manual Connections % Network 1. Select Terminal Session in the Network menu. 2. Select Manual TCP/IP and click on Connect. 3. Select terminal type and click on OK. 4. Type computer address or select computer name from list and click on OK. 5. Log on to computer in normal way. 6. Work on the remote computer. 7. Log off in normal way. 8. Click in the close box. % Telephone 1. Select Modem in the Settings menu 2. Select the type of modem connected to your Macintosh and click on OK. 3. Select Terminal Session in the Network menu. 4. Select Manual Phone and click on Connect. 5. Click on Save or change name and then click on Save. 6. Select terminal type and click on OK . 7. Select baud rate and click on OK. 8. Type ATDT plus computer phone number and press Return. 9. Press Return when you see the response CONNECT. 10. Log on to computer in normal way. 11. Work on the remote computer. 12. Log off in the normal way. 13. Click in the close box. 14. Click on Yes to kill the connection. Automatic Connections % Save transcript 1. Don't check RDon't Save Session TranscriptS when you define your account. 2. Select Terminal Session in the Network menu. 3. Select an account and click on Connect. 4. Click on Save or change name and then click on Save. 5. Type password (if necessary) and press return. % DonUt save transcript 1. Check RDon't Save Session TranscriptS when you define your account. 2. Select Terminal Session in the Network menu. 3. Select an account and click on Connect. 4. Type password (if necessary) and press Return. To Receive a File % Network 1. Select File Session in the Network menu. 2. Select an account and click Connect. 3. Select Receive File in the the Network menu. 4. Select file to receive. 5. Select transfer format. 6. Click on Receive or change name and folder then click on Receive. 7. After the file transfer is done, select Goodbye in the Commands sub-menu in the Network menu. 8. Click in the close box. % Telephone 1. Select Terminal Session in the Network menu. 2. Select an account and click on Connect. 3. Start upload process on remote computer. 4. Select Receive File in the Network menu. 5. Type the name of the file you want to receive. 6. Select transfer format. 7. Click on Receive or change the file name on your Macintosh then click on Receive. 8. After the file transfer is done, select Goodbye in the Commands sub-menu in the Network menu. 9. Click in the close box. To Send a File % Network 1. Select File Session in the Network menu. 2. Select an account and click on Connect. 3. Select Send File in the Network menu. 4. Select file to send. 5. Select transfer format. 6. Type name for file on remote computer (to change the name). 7. Click Send. 8. After the file transfer is done, select Goodbye in the Commands sub-menu in the Network menu. 9. Click in the close box. % Telephone 1. Select Terminal Session in the Network menu. 2. Select an account and click on Connect. 3. Start the file capture process on the remote computer. 4. Select Send File in the Network menu. 5. Select file to send. 6. Select transfer format. 7. Type name for file on remote computer (to change the name). 8. Click on Send. 9. After the file transfer is done, select Goodbye in the Commands sub-menu in the Network menu. 10. Click in the close box. To Edit a File % Remote editing (only for network connections) 1. Select File Session in the Network menu. 2. Select an account and click on Connect. 3. Select Edit File in the Network menu. 4. Select a text file. 5. Click Receive. 6. Edit the document. 7. Select Save in the File menu. 8. Click in the close box. 9. Select Goodbye in the Commands sub-menu in the Network menu.. 10. Click in the close box. % Using an editor on a remote computer 1. Select Terminal Session in the Network menu. 2. Select an account and click Connect. 3. Start up an editor (e.g., vi, emacs, ed) on the remote computer. 4. Save the document with the remote editor when you finish editing. 5. Select Goodbye in the Commands sub-menu in the Network menu. 6. Click in the close box. To Print a File % Printing the current document 1. Select Print Document in the File menu. 2. Click on OK. % Printing selected text 1. Select the text you wish to print. 2. Select Print Selection in the File menu. 3. Click on OK. % Printing a number of documents 1. Select Print Many in the File menu. 2. Select the file(s) to print and click on Add. 3. Click Print Files. Release Notes The TOPS Terminal Release Notes consist of three sections: "Known Limitations," "Troubleshooting" and "Additions to the Manual." The Known Limitations section includes information about problems not resolved in this version of TOPS Terminal. The "Troubleshooting" section contains the entire Troubleshooting section found in the manual, as well as additional information not found in the manual. "The Additions to the Manual" section contains information not included in the TOPS Terminal Manual, and is organized in the same basic order as the manual. Known Limitations Terminal Sessions Phone Connections Red Ryder Host The automatic password script is not implemented for Red Ryder Host. You will be able to set up a password script with TOPS Terminal, but it will not function. You will need to login manually with a password. CompuServe CompuServe recommends a 7-BIT EVEN PARITY computer setting and 8-BIT NO PARITY as an alternative. Terminal Sessions will work correctly at either setting. However, transferring files within Terminal Sessions will function successfully only with the 8-BIT setting. Baud Rates Not all baud rates can be selected at one time within the Manual Phone Connection screen. 57600 Baud If 57600 Baud is selected for a Manual Phone connection, the session window fails to open. Network Connections Window Sizes Information about the current window size of TOPS Terminal on the Macintosh is not sent to the host during a Terminal Session. So, when you change the window size within TOPS Terminal, the host does not adapt to this change by wrapping the text on the terminal screen. Flush Output The command Flush Output may fail intermittently within Terminal Sessions. Passwords on Remote Accounts Tops Terminal only handles account descriptions which have passwords. If you create an account description with a user name and no password on an account that does not require a password, TOPS Terminal will login, and then freeze. Use a manual connection to access a remote account with no password assigned to it. TOPS TCP/IP File The TOPS TCP/IP file must be removed from the System Folder and the Mac rebooted to allow other IP software, such as NCSA Telnet, to work. File Transfers Opening Directories on a VAX During File Sessions to a VAX running Process Software FTP, child directories are not accessible within the Receive File screen. You will need to select Go To... from the Commands menu and change directories before using Receive File. Wildcards Some UNIX and VMS wildcards that work during Terminal Sessions may fail during File Sessions. Manual TCP/IP There is a problem typing certain letters in the Receive or Edit File dialog box during a Manual TCP/IP File Session when the following two conditions are true: % The TCP/IP number is typed in manually, rather than selected for the list of known computers. % The Receive/Edit File is in "simultaneous entry mode," meaning that characters are displayed in both the local and remote file name boxes at the same time while you type. Under these circumstances, the letters h,c,v, and x will only appear in the local (Mac) file name box. The missing letters will appear in the remote file name box only after additional characters are typed. The problem can be avoided by clicking on one of the file name boxes, which stops the "simultaneous entry mode, and allows you to enter the file name separately. Editing Undo In the Edit menu, Undo is not enabled. Scripts and Macros Default File Names There is a problem with default file names when using Scripts and Macros. If you give TOPS Terminal a file name when using Commands, Scripts or Macros, the file name will be kept as the active default file name until you change it. Commands will allow you to change the default, if you wish, before the selected command is executed. Scripts and Macros which use default file names, will use the active default automatically, without offering you the chance to change the default name before executing. Cancelling a Script with Pick Macro If you select Pick Macro, then select Script , and then click on the Cancel button, cancel does not function properly. TOPS Terminal will run the script that was highlighted after you have selected Cancel. If you have made a mistake and do not wish to run the script you have highlighted, select Noscript before clicking Cancel. Troubleshooting This section is a reproduction of the Troubleshooting section in the TOPS Terminal manual. If your problem is not described in this section, see the next section, which contains additional troubleshooting information not found in the TOPS Terminal manual. Network (TCP/IP) Connections Listed below are error messages that you might see or problems that you might encounter in making a network connection. There's a Problem Starting TOPS TCP/IP You may see the following message while booting-up your Macintosh: Solution: Try one of the following: % Click on RTry to find a KIP Server,S (only if you've got a KIP Server on your network, of course) and KIP will give you a default address. This generally works only if there is a bad connection somewhere in the network. % Select Configure TOPS TCP/IP By Hand, and make sure that the addresses of your local gateway and the subnet shift and subnet size are set properly. % Select DonUt Install TOPS TCP/IP. You then can only make a phone connection with a non-TCP/IP bulletin-board or remote service. You will still be able to configure TCP/IP by hand in the Control Panel later, if you wish. Cannot Connect to Computer By TCP/IP The symptoms of this problem are that you give a "Terminal Session" command to call another computer, and the session transcript window is created normally, but the other computer never answers. The session window status box (in the lower left hand corner) says "Connecting to [computer name]" until you close the window. Solution: The other computer may indeed not be answering: it may be down or overloaded. The problem may, however, be in your TCP/IP configuration or the intervening network. Possible solutions in this case are: % Check whether the host computer is down. % Verify that the cabling is secure and terminated (resistors at each end of the AppleTalk network) if you are using a TOPS TeleConnector, Farallon PhoneNET, or similar type of cabling. One way to make sure your cabling is secure is to go to the Chooser to verify that you can see AppleTalk devices (such as an Apple LaserWriter) on the network. % Check to make sure you have the correct IP address set up for your Macintosh in the Control Panel TCP/IP file (see page xiv in the Preface). Also check that the IP address of the remote computer is accurate in its computer description. % Check your FastPath or other AppleTalk/Ethernet gateway to ensure that it is installed and configured correctly (and that the FastPath has version 3.0 ROMs). Then make sure that the Ethernet subnet number and the AppleTalk subnet number are different from each other; in addition, both of these numbers must be different from zero (0) and unique in your internetwork. % If you have a Hayes (or compatible) InterBridge on your internetwork, confirm that it has 1.08 ROMs, and that it can be seen on the network with the InterBridge Manager. Try powering-off the InterBridge and restarting. % Try a manual connection, typing in the IP address, to see if the connection works that way. AppleTalk Network # Does Not Match Subnet # If you see this message, itUs an indication that the subnet number of your Macintosh's IP address is wrong. The subnet number has to match the AppleTalk network number. The Macintosh discovers its AppleTalk network number when it starts up; the AppleTalk network number is controlled by the bridges and gateways attached to the network. Solution: Pull down the Control Panel from the Apple menu, select TOPS TCP/IP, click on the button next to My Internet Address, and enter the correct IP address, Subnet Shift, and Subnet Size. If an error still occurs, you need to check that each AppleTalk-Ethernet gateway is set up with matching subnet numbers and AppleTalk network numbers. Be sure that all bridges and gateways agree on all network numbers. Socket Listener for IP Could Not Be Installed This message might be displayed if there is a conflicting init file in the System folder of your Macintosh. Solution: Try moving other inits out of the System folder. If you experience this trouble on a Macintosh Plus, you may need to copy the AppleTalk file into your System folder. A disk error when reading in the AppleTalk software could also bring up the message; copy a new System File and AppleTalk file (if any) from the TOPS Terminal disk to your Macintosh System folder. You might also consider running Apple's Disk First Aid utility on the disk in question. Gateway Address Not On Same Wire as the Mac The network model of TCP/IP requires that each TCP/IP computer be on the same physical network as a TCP/IP gateway. Two TCP/IP addresses are on the same physical network if they match in both network and subnet numbers. Therefore, the Macintosh TCP/IP address and the gateway TCP/IP address must match in both network and subnet numbers. You will see this message if these numbers do not match. Solution: If you get this message after configuring TCP/IP in the Control Panel, go back to the configuration dialog and make sure the network and subnet numbers of the two TCP/IP addresses match. The AppleTalk (.MPP) Driver Cannot Be Opened A corrupted System file can cause this error message to be displayed. Solution: Run the Installer on AppleUs System Tools disk (Utilities folder). If the problem still occurs, you need to copy over a new System file to your Macintosh System folder. Again, Apple's Disk First Aid utility might help. TOPS TCP/IP CanUt Get Enough Resources to Connect You might see this message if there are too many sessions going at once on a Macintosh with limited memory. You may also see this message if the maximum number of network connections under preferences is set too high. Solution: In addition to reducing the TCP buffer size (in the Control Panel) and rebooting, as the message suggests, try reducing the number of concurrent sessions. Trying to connect, network accounts not enabled If network accounts are Rgrayed out,S indicating that they cannot be used, TOPS Terminal cannot find a valid TCP/IP address for your Macintosh. Solution: You may have to enter a TCP/IP address (as explained in the Preface, starting on page xii), or you may need to reboot your Macintosh. Phone Connections Listed below are error messages that you might see or problems that you might encounter in making a phone connection. Trying to connect, phone accounts not enabled If modem accounts are not enabled, there are three likely problems: % You have not designated a modem type % The modem is in use for another connection % You are trying a phone connection during a file session Solutions: Select a modem type (see Appendix B for details), close the other connection, or select Terminal Session for phone connections. Phone account - don't get CONNECT response If nothing happens after you click Connect when making a phone connection, the modem speed may be wrong. Solution: Select Send Break in the Controls submenu of the Network menu to drop the baud rate of the remote computer's modem down one step (from 2400 to 1200 baud, for instance) and press Return. If that doesn't work, you may have to change the baud rate in the Description of an Account. You will have to close the connection first and try the connection again after you have changed the baud rate. Phone account - no response after CONNECT If you reach the remote computer successfully and see the response RCONNECTS (or a similar response), but you can't do anything, your modem settings may be wrong. Some connections require two carriage returns, some require a Control-C, for example. These settings are set in the attention line in the description of a computer. Solution: Check with the system administrator on the remote computer to find out what you need to do, and what settings are necessary. General Troubleshooting Listed below are general problems you might encounter or error messages that might be displayed for either network or phone connections. Using TOPS Terminal with MultiFinder TOPS Terminal works fine under MultiFinder; however, there are some limitations you should be aware of. If you limit TOPS Terminal to 350K or less in the Get Info window, the following problems may occur: % Large text files may fail to open. % An out of memory error message may come up on screen. % You may need to save smaller amounts of data in a session transcript. % TOPS Terminal might disconnect your current session. % TOPS Terminal may crash. Solution: Set TOPS Terminal to 350K or larger under MultiFinder. If TOPS Terminal crashes, select the resume button, which will be highlighted in most circumstances. If you use Macsbug 5.4 or later, you can type ResS in order to exit to the Finder. Unable to create TOPS Terminal Memory file If this message appears, your TOPS Terminal Memory may be corrupted, there may be a disk error, or you may be running two separate copies of TOPS Terminal under MultiFinder. Solution: Discard the TOPS Terminal Memory file in your System Folder, replace it with a backup copy, and reboot your Macintosh. If you don't have a usable backup copy, create a new one after discarding the old one; a new TOPS Terminal Memory is created when you quit TOPS Terminal after starting up TOPS Terminal and creating a new description. Trying to connect, automatic account; no response There are a number of reasons that this might happen, including an incorrect IP address for the remote computer, an incorrect user name, or an incorrect password. Solution: Be sure the remote computer is up and that it is enabled for logins. Also check the computer description to be sure you have specified the appropriate operating system (UNIX is the default for new computer descriptions). Try a manual connection to the computer, typing in the IP address when it is requested. See Chapter 2 for a description of manual connections. Check the FastPath Manager setup (or ask your system administrator to check it). Invalid login message when trying to connect Check your user name for misspellings, extra spaces, incorrect capitalization, or extraneous characters. Solution: Re-enter your password by checking the Password saved in TT Memory box in the account description and following the instructions provided. You will have to check the box twice Q once to 'uncheck' it and the second time to tell TOPS Terminal that you want to enter a password for the account. Click OK when you have entered the new password. If the connection doesn't work after you have checked and modified your user name and password, try a manual connection, as described in Chapter 2. If it still doesn't work, check with the system administrator on the remote computer to be sure your user name and password are set up as you think they are. Established connection - stops responding If you were working on a remote computer in a terminal session and the computer stops responding, the connection to the remote computer has probably been broken. This may happen because the remote computer was disconnected from the network, was rebooted, or went down. This could also happen because of a network or modem problem. The status box at the lower left will change from RConnected to [computer nameS to REditor Document,S but no error or kill connection message will be displayed. Solution: Try to make another connection by selecting the same account after selecting Terminal Session in the Network menu. (This won't work if the remote computer or the network is down, of course.) Save the transcript if you wish. Screen displays meaningless characters This can happen if you try to display the contents of a non-ASCII file during a terminal session. Solution: To clean up the screen, select Reset Terminal from the Network menu. If Reset Terminal is not available in the Network menu, display the full menu by following the instructions on page 11 of this document. It may be necessary to press Return if you are in a shell to get the prompt again. If you are in an editor, you will have to select the editor's redraw screen command to get the prompt again. Script stuck in a loop If no question in a script is matched, it may get stuck in a loop. Solution: Terminate the script with the interrupt command, using the clover key and period. Running out of memory A session transcript is kept in memory during a TOPS Terminal session, unless you select Don't Capture Lines Off Top in the account description or you toggle Capture Lines Off Top to the off position (no check mark) during a session. If your Macintosh runs out of memory, a dialog window with several options will be displayed. Solution: Follow the instructions in the dialog window. Click on Capture Lines Off Top to free up the memory used to store the transcript; save the transcript before you do this (if you wish). UNIX users - User name or password invalid If your user name is all lower-case letters in the UNIX password file, it will not be recognized if you type it with initial caps. UNIX operating systems are case-sensitive, meaning that upper-case letters are not the same as lower-case letters in file or directory names Q nor in the password file, where your user name and password are stored. Solution: Type your user name and password in a TOPS Terminal account description exactly as it entered in the password file on the UNIX system. UNIX users - RNo such file or directoryS message If you try to send a file with slashes (/) in its name to a UNIX computer, the file will not be saved and you will see the message RNo such file or directory.S (This happens because slashes are used to designate directories in the UNIX hierarchical file system.) Solution: Change the name of the file before trying to send it to the UNIX computer; substitute hyphens for slashes in dates, for example. UNIX users - flashing screen when invoke vi editor This indicates that the UNIX stty is set to 34 rows, 80 columns (9400 baud). Type Rstty allS to check the row and column settings. Solution: Reset the rows to 24. VAX users - screen problems with VT100 setup If you have told TOPS Terminal to emulate a VT100, but the characters on the screen do not look right, you may be missing a line in a file. Solution: Be sure you have the following line in your login.com file on the VAX: set term/inquire Additional Troubleshooting Information Listed below is additional troubleshooting information that may help you uncover the solution to a problem you are having with TOPS Terminal. This information is not in the manual. The settings named <> are built in for TOPS Terminal, so they can't be changed directly. However, you can make a modified copy of <> by typing in another name for the copy. Solution: If you see this message, then you are trying to remove a description that you have not created or a description that is built into TOPS Terminal, such as the description of Manual TCP/IP. However, you can remove account or computer descriptions that you have made if you need more disk space. I am sorry, but I was unable to create the file "TOPS Terminal Memory." Perhaps your startup disk is full or locked. TOPS Terminal cannot run without this file. Solution: This message can mean several things: Your TOPS Terminal Memory file is corrupted, you are running two copies of TOPS Terminal under Multifinder; or you have booted from a locked or read-only disk and the TOPS Terminal Memory file cannot be created. To fix this problem, replace your TOPS Terminal Memory file; make sure you are running only one copy of TOPS Terminal under Multifinder; check the amount of disk space you have; and unlock the disk, if necessary. No gateway address was provided. Solution: It is likely that you would see this message if you were using the Stanford KIP (which does not need gateway information), and TOPS Terminal on the same network. Check the KIP software that you are running on the network. If you are running the Stanford KIP, make sure that you have supplied a gateway address when you configure TOPS TCP/IP. Someone else is using that IP address. Solution: When you see this message, two (or more) people are trying to use the same IP address. This would happen if you assign your computer an IP address, and then turn it off. Someone else could assign their own computer the same IP address. Then, you will see this message when you boot your computer. You will also see this message when you try to assign an IP address that someone else is actively using. After clicking OK when seeing this message, you will see a dialog box that will allow you to configure TOPS TCP/IP by hand. By selecting this option, you will be able to assign your Macintosh a new, unique IP address. If you are having trouble assigning your Macintosh an IP address, see your System Administrator for help. Additions to the Manual Before you Begin Memory Requirements (page ix) The default memory allocation for Tops Terminal under Multifinder is 732K. You may select Get Info under the File menu and reduce this number under Multifinder. It is not recommended to set the memory allocation any lower than approximately 400k. Note: If you find the TOPS Terminal menus deactivated after starting a Terminal Session or File Transfer, there may be too little memory available to run the program. Automatic Connections Creating Computer Descriptions (page 35) Tops Terminal has a limit of 16 characters for the computer name in the Description of a Computer screen and during creation of a new account using a New computer description. If the name you give your computer is longer than 16 characters, you will not see a warning message. However, when you finish describing the computer, the computer name in the List of Known Computers will be shortened to 16 characters. Creating Account Descriptions (page 44) When creating an account description, if you select New for the computer description (rather than Memory) you can enter a new computer name. Then, during Description of a Computer, you will have the option to enter a different computer name. However, if you give the computer a different name than the one you originally gave it, you won't see a warning message indicating that that you have changed the computer name. After finishing Description of a Computer, the name in the List of Known Accounts will be the first one you gave the new computer.. Terminal Sessions Ending Terminal Connections (page 89) When a terminal connection is broken, the window will become an Editor Document. During a Terminal Session using Manual TCP/IP, the message Connected to Manual TCP/IP appears in the lower left-hand corner of the screen. When you end a Terminal Session by logging out, or if a terminal connection is broken, the message will change to Editor Document. File Transfers File Naming (page 95) Macintosh file naming conventions do not support file names that begin with a period. If a file is transferred to a Macintosh during a file or editing session, TOPS Terminal will change the period to a comma. When transferring the file back to the host computer, you will need to change the comma back to a period. Changing Directories on a VAX (page 103) On a VAX running VMS it is possible to move to a directory where you do not have permission to read or write. It can the be difficult to return to the last directory you were in if you do not know your VMS pathname. This might happen in a File Session if you select Edit and Receive File and then select Go To Parent. When you have permission to read a directory, a listing of files will appear on the Receive File screen after selecting Go To Parent. However, if you do not have permission to read a directory you will not see a list, and will not be able to return to the directory where you were originally. There are two workarounds for this problem. One is to Cancel the Receive File dialog box select Go To from the Command menu under Network, and enter the VMS pathname of the directory you want to move to, then go back to Receive File. The second, if you don't know how to specify the VMS directory you want, is to terminate the File Session you were using and start a new one. It is easier to work around the problem if you are in a Terminal Session. You can use Go To as described above if you know the VMS pathname for the directory you want to move to. Or, when Go To asks for the directory name you can type "sys$login", which will put you back into you home directory. The "sys$login" option will not work in File Sessions due to FTP limitations. Goodbye Command (page 105) To quit a File Transfer, end the session by using Goodbye under the Commands listing in the Network menu. If you quit a File Session with the CLOSE box or without using the step described above, a FTP daemon may not be killed and the remote computer may still believe a connection exists. Your Preferences Short Menus (page 141) The default in Tops Terminal is for short menus. If you want to use the full menus, select, Your Preferences and then choose Network - Full Menus. Appendix B includes more information about the full menus. Fonts (page 143) You will see the same fonts twice under Your Preferences when you choose Edit - Printer Font within Settings in the following environments: %Your Macintosh is running 4.2/6.0 System and Finder. %A Suitcase and Fonts file are in the System Folder. %The fonts have been installed using the Font/DA Mover. Manual Backspace (page 151) If you are using Manual phone sessions, go to the Settings menu and select Your Preferences. Click on Terminal - Manual Backspace to select whether TOPS Terminal will send a backspace or a delete character to the host computer. Scripts and Macros Testing Macros (page 171) You can test a macro that you have created by going to the Network menu and selecting Pick Macro from the Macros listing. However, you can only use this command if one of more macros already exist. You won't see an error message if you select Pick Macro when there are no macros. Modifying Scripts (page 184) Under the Settings menu, select Services, and then New, to change scripts used to implement a service. This screen shows the list of scripts you can modify. The scripts called "Unused 0" through "Unused 5" cannot be modified. Describing new Operating Systems (page 186) To create a new operating system script, select Operating Systems under the Settings menu and click on New. In this screen you can choose services to define the operating system, such as VMS Command Interpreter. The default services for all new operating systems are FTP Commands and Manual Services. System Administration FastPath 4 (page 207) All references in the manual are to the FastPath model KFPS-2 and KFPS-3 and the FastPath Manager Release 3.0. Gateway Name The Gateway Name program was not released with TOPS Terminal. Any references to it in the manual should be disregarded. TOPS KIPPER The KIPPER was not released with TOPS Terminal. Any references to it in the manual should be disregarded.