Index of /itools/TERMS/TOPSTERM

 Name                    Last modified       Size  Description

 Parent Directory        19-Apr-2005 00:40      -  
 ORDER_FO                28-Apr-1989 02:48     1k  
 STUFFIT                 28-Apr-1989 02:48   115k  
 TOPSTER0.HQX            28-Apr-1989 02:57   623k  
 TOPSTER1.HQX            28-Apr-1989 03:01   626k  
 TOPSTER2.HQX            28-Apr-1989 03:03   368k

TOPS Terminal and TOPS TCP/IP

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 <<DESCRIPTION>> are built in for TOPS Terminal, so
they can't be changed directly. However, you can make a modified copy of
<<DESCRIPTION>> 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.