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.