THERE ARE TWO versions of RUN Term on this disk. RUN Term 64 is essentially identical in operation to RUN Term 128, the main differences being the use of the Commodore key to issue commands (instead of the C-128's alt key), the lack of programmable function keys and, of course, the lack of an 80-column screen.
You'll find it convenient to power up RUN Term with default baud rate, echo and buffer settings customized to your system. To set this up, copy RUN Term to a work disk, then load and run the Change Defaults program, following the prompt to change each item or pressing the return key to keep the original setting. The Change Defaults program creates a file called Configure on a work disk in drive 8. Be sure to copy this file to your RUN Term work disk.
Activate the C-64 or 128 version. If you intend to use the autodialer option, it's important to turn your modem on (if it has an on/off switch) and to have it off-line when activating RUN Term. There will be a pause as the program loads itself into memory. Then the screen flickers momentarily and time prompts appear. Pressing the return key at the first prompt (AM/PM) zeros the clock and exits to Terminal mode.
Next, the status line, to indicate you're in Terminal mode, appears at the top of the screen, accompanied by a brief menu that lists the main program commands. After you enter one of these commands, the status line and menu disappear, and the other commands are no longer available until you get back to Terminal mode.
The status line displays information on the program's internal settings. At the right end of the line is the clock. If your modem can detect a carrier, you'll see a lowercase c to the left of the time. At the left end of the line the baud rate--either 300 or 1200--is displayed (see ^ below). To the right of the baud rate a set of single letters indicates what RUN Term functions are activated. The letters are as follows:
b--The text buffer is open to receive characters from the modem for later retrieval. (See B below.)
e--The Echo function is on. (See E below.)
w--The Buffer Wrap function is on. (See W below.)
j--Linefeeds from the modem will be printed to the screen. (See J below.)
t--ASCII translation during Xmodem file transfers is activated. (See * below.)
d--DLE screening during Xmodem file transfers is on. (See * below.)
s--Padding will be stripped from the end of files downloaded using any Xmodem option. (See * below.)
r--The RAM expander (1700, 1750 or 1764) buffer is open to receive characters from the modem. Note that this buffer is completely separate from the regular buffer. (See R below.)
The default state for all keys in RUN Term is the same as in the VT100 program found on the 1670 modem demo disk, and RUN Term uses the same translation tables as VT100. However, RUN Term is not specifically designed to produce VT100 emulation. The extra keys needed in VT100 emulation are as follows:
Left curly bracket = shifted plus
Right curly bracket = shifted minus
Vertical bar = Commodore key/minus
Tilde = shifted up-arrow (^)
Caret = up-arrow (^)
Backslash = British pound sign (\)
Accent mark = shifted commercial at sign (@)
Note that escape sequences are not supported by RUN Term, so the program may not operate properly on remote full-screen editors.
To view RUN Term's main menu, press the F1 key on the C-64 or the Help key on the C-128. To send any of the commands in the menu to the terminal, hold down the Commodore key on the C-64 or the alt key on the C-128 as you press the desired command key. The following are the commands available:
A--Accesses Auto-Dial mode. First you must specify your modem type, then the number of seconds you want to elapse between dial attempts. Finally, you can enter a number directly or use the phonebook commands to Load, Save and Edit. If you choose to edit with nothing in memory, a new, blank book is created. There's room for nine entries in a phonebook, with each including the name of the online service, its phone number and three strings that can be used to send a log-on sequence. If you're using the 1670/Hayes option, the first character of every phone number must be a p or a t to indicate pulse or tone dialing. With the 1650 or 1660 dialing option, an asterisk in the phone number will delay dialing for one second.
B--Toggles the text buffer open and closed. To find out where you are in the buffer, access the main menu. Below the list of commands you'll see the present address of the buffer write pointer, with the maximum possible pointer value in parentheses. The buffer size in the 64 version is about 28K, in the 128 version about 60K.
C--Selects Conference (also called CB) mode, which facilitates multiuser connections on services such as GEnie. At the top of the screen, you'll see a row of 80 reverse-video spaces, where your characters will appear as you type. There's no cursor in this mode. Press control/X to erase the whole line if you want to start over, or use the delete key to erase individual characters as usual. Your line of text won't be sent until you hit the return key.
Characters received from the modem are printed at the bottom of the screen. I recommend that you instruct the online service not to echo your characters back while you're using this option.
The only way to exit Conference mode is with the stop key, because none of the command keys are available. However, settings such as buffer open/close, echo and baud rate that are selected in regular Terminal mode are active in Conference mode. Be sure to open the buffer before entering Conference mode!
D--Downloads, or receives, a file from another computer. This option works with the currently active disk drive. You have a choice of Punter protocol or one of three Xmodem protocols: Checksum, CRC and WXmodem.
Don't worry if you don't know which Xmodem to use--Checksum is the standard, and RUN Term automatically switches from WXmodem to CRC and from CRC to Checksum if it doesn't connect properly using the protocol you've selected. WXmodem, which stands for Windowed Xmodem, transfers four Xmodem blocks at a time, so it's faster than Checksum or CRC.
Punter indicates that a block has transferred correctly by printing a hyphen to the screen, incorrectly by printing a colon. Xmodem clearly lists the number of blocks and the number of errors it has caught and corrected in the transfer as ASCII digits. In addition, upon completion of an Xmodem transfer, a status report is printed in reverse-video on the Terminal-mode screen.
Since Xmodem files must be transmitted in blocks of 128 bytes, you may have to add bytes--either control/Zs or CHR$(0)s (zero bytes)--to the last block to fill it out.
To abort Punter transfers, hold down the Commodore key. To abort Xmodem transfers, hold down the stop key.
E--Toggles the Echo mode, sometimes referred to as half-duplex, on and off. When Echo mode is off, you're in full-duplex. If you can't see what you're typing because the service you're connected to doesn't echo characters back to your computer (as with GEnie, for example), turn on Echo mode.
F--Reads a sequential file. Use this command to send a file to the screen, printer or modem. The file is translated to ASCII when sent to the modem.
H--Places a modem, like a phone, "off the hook" or "on the hook." When you're using a 1670 or Hayes modem, the H command can only hang the modem up. For the Hayes, follow the H with the characters ATH (in uppercase ASCII) and a return to hang up.
To pick up on a 1670 or Hayes modem, enter ATD to access Originate mode (like dialing without a phone number) or ATA to force the modem into Answer mode (not to be confused with Auto-Answer mode). If your Hayes-compatible won't accept the ATD command, use ATO to force the modem online in Originate mode.
J--Toggles linefeed printing. This option actually changes the input translation table. Some services always send CHR$(10)--a linefeed--with each return, and if you have linefeed on, you'll end up with double-spaced text. I'd suggest that you turn linefeeds off unless you specifically need it.
