💾 Archived View for mirrors.apple2.org.za › active › ftp.apple.asimov.net › images › communications … captured on 2023-11-14 at 12:30:43.
⬅️ Previous capture (2023-01-29)
-=-=-=-=-=-=-
Subject: SuperTERM (SHK)
Author: Neal Howland
File: SUPERTERM.SHK
Equipment: Super Serial Card, Hayes AT compatible modem
-----------------
This is another excellent terminal program written totally in Applesoft Basic.
This program contains some excellent examples of how to deal with Prodos from
inside a Basic program. This program was the second place winner in the
Communications & Networking Forum's Basic Terminal Program contest!
-------------
DOCUMENTATION
Super Term
----- ----
To use Super Term you must place the file "ST" in a directory named
"/SuperTerm." Other files used by Super Term that must also be in the directory
are "ST.LOGON", "ST.CONFIG", and other files with the prefix ST. However, these
files may be created by Super Term. The ST.LOGON file contains the names of the
BBS's logon files have been created for. These files are necessary for the
dialing process as they contain the number and the modem setup for each
particular BBS. I have provided sample BBS logon files with my program. The
ST.CONFIG file contains the hardware configuration for your system. It contains
the slot of your modem, the maximum baud rating of your modem, and the slot of
your printer if you have one.
Starting Super Term-
First you must run the Super Term program. To do this you must enter the
directory containing Super Term and you must run the file named "ST". This is
the Super Term program. Before the title screen has appeared, you may receive
error messages from the program telling you that either you are missing your
configuration file or that you are missing your logon file. If you are missing
either one you must create them before attempting to go online. After the title
screen has appeared, press any key to continue. This then puts you in the main
menu giving you the options of dialing a number, setting the prefix, cataloging
a disk, deleting a file, printing a text file, logon file options, configure
hardware, and quiting. The menus in Super Term are all controlled by pressing
the arrow keys to select what option you want and then pressing return to select
that option. Also, a few menus use the escape key to return you to the previous
menu. The option you should choose when first using Super Term is the configure
hardware option. This sets up Super Term so that it works with your system.
The different options will be explained in detail in the following sections.
Configure Hardware-
When you select configure hardware from the main menu, the program jumps into a
sub-menu giving you the options of changing modem slot, maximum baud, and
printer slot. This menu also shows the current settings for these options. To
select what slot your modem is in, move the inverse bar over modem slot using
the arrow keys, then press return. You will be given a blinking cursor over the
current modem slot. You must then press the number of the slot your modem is
in. The program will only accept numbers between 1 and 7 as long as the number
pushed is not the same as the printer slot selected. The program then returns
you to the same menu. To select the maximum baud rating your modem is capable
of, move the bar over the maximum baud option then press return. A flashing
cursor the appears over the left most character of the current baud. To select
what baud your modem is capable of press 3 for 300 baud, 1 for 1200 baud, and 2
for 2400 baud. The program then returns you to the configure menu. To select
the slot your printer is in, move the inverse bar to the printer slot option and
press return. You will get a flashing cursor like the one for choosing modem
slot. Press a number from 0 to 7. 0 means you do not have a printer hooked up.
1 through 7 is the slot of your printer if you have one. You will get an error
message if you choose the same slot as your modem is set up for. To exit from
this menu press escape. The program then asks if you want to save the options
you selected. If you press Y then the program will save the options you
selected so that the next time you run Super Term you will get the same set up.
If you press any key besides Y, the program will continue on using the options
you selected as temporary configuration. Whether you pressed Y or not, you will
be sent back to the main menu.
Logon File Options-
Selecting this from the main menu gives you another menu with the options of
adding a file, editing a file, or deleting a file. Use the arrow keys to choose
which option you want and return to select it. Press escape to return to the
main menu. Adding a file will give you a menu that lists out the default
settings for a new BBS file. To change the name or telephone number highlight
the one you want and then press return. You should have a blinking cursor next
to the option you highlighted. If you chose name the when entering the name of
the BBS you should make sure it is a legal ProDOS file name and I would suggest
that it not exceed 10 characters in length. If you chose number and you cannot
support tone dialing the put a capital P in front of the number so that the
modem knows to dia;l in pulse. Also, do not enter any character that cannot be
recognized by Applesoft input or by your modem. To exit from this menu press
escape. The program will then ask you if you want to save the file you just
created. Press Y if you want to save it in your logon file so that you may dial
it from Super Term. Pressing any other key will return you to the logon file
options menu. Selecting edit a file will display a menu of all the BBS's you
have put in your logon file. Select the one you want to edit and press return.
You will then be given a menu like the one for adding a file but it will have
the settings specified from the logon file you chose. When you are done editing
press escape and it will ask you if you want to save it. If you press Y then it
will be saved over your old file and if you press any other key you will be sent
back to the logon file options menu without any changes being made to the logon
file. Choosing delete a file will give you a menu of logon files like in the
edit option. You choose the one you want to delete and press return. The
program then asks you to verify your choice. If you press Y then the program
will continue on and delete the file you choose. If you press any other key the
program will abort the deleteing process. To leave the deleting menu without
making a choice, press escape.
Set Prefix-
This option allows you to change the current ProDOS prefix where Super Term
looks to catalog a disk, print a text file, and delete a file.
Catalog Disk-
This option catalogs the current prefix.
Print a Text File-
This option allows you to print a text file from disk to the screen, in 40 or 80
'column mode, or to the printer. To pause a while printing the file, press
Ctrl-S and press any key to start again.
Delete a File-
This option allows you to delete any type of file from a ProDOS disk.
Quit-
This option allows you to quit the Super Term program into Basic.
Dial a Number-
This option gives you a menu of all the logon files you have created. You
choose the one you want to call and press return. Super Term then dials the
number and configures the modem to the specifications set in the logon file. It
then puts you in terminal mode so that you may communicate with the other
computer. To hang up and return to the main menu, press ctrl-A Q Return.