Doc file for CTERM1 (as distributed by Donald W. Smith) Current version 1.11, dated 4/26/89 Nothin' fancy terminal emulator. BASIC FEATURES: Emulates conversational (only) mode Tandem 6520/30 terminal. Allows for capture to PC disk file of Terminal sessions (Removes junk control characters) Implements a speed independent (11 character times) break signal. Does not require any external drivers or libraries. Xmodem file transfer (send and receive) supported. CRC and checksum are available, CRC is preferred. Single file, 128 bytes blocks are used. DOS Services are available without leaving the program. All control characters (except selected ESCAPE char) can be sent. High speed interrupt driven receiving. Configurable for either COM1 or COM2. Small model object file (25K of code) NON-FEATURES: Single screen only - It's gone if it scrolls off the screen. NO fancy status lines, or exploding windows. NO Storage of phone numbers NO BLOCK MODE. Some Tandem Pathway environments will not accept NO BLOCK MODE for an answer. M6530 is one example. It will try to force the terminal into block mode forever, no matter what control key combination, break key, or whatever you send back. NO Odd parity. Sorry DEC. NO ANSI graphic screen support. NO Y or Z modem, or Kermit or CIS B. (yet) COMMAND LINE OPTIONS: cterm1 [ -b -c -s -e ] -b BBS mode (8,1,N). Defaults is T16 mode (7,1,E). -c Com port 1 or 2. Defaults to 1. -s Initial baud rate. Defaults to 1200. -e Escape character Defaults to Esc key. Example: CTERM1 -b -c2 -e0x1a -s2400 -b Turns bbs mode on (8, 1, NO Parity) -c2 Com2 will be used -e0x1a Escape character is now 1A hex (26 decimal), ^Z Note: 0xnn for hex, 0nn for octal, nn for decimal -s2400 Initial baud rate to 2400 bps. MODES OF OPERATION: Command Mode: Top of the "mode" tree. Only first character is required. C(onfig) = Enter Config mode D(os) = Spawn a DOS shell and send selected command H(elp) = Shows a short list of commands (these) Q(uit) = Exit to DOS R(cvx) = Receive a file using Xmodem S(endx) = Send a file using Xmodem T(erm) = Enter Terminal mode. Config Mode: Displays current configuration (read directly from UART) Prompts for changes: 0 = T16 mode (7 bits, 1 stop bit, Even parity) 1 = BBS mode (8 bits, 1 stop bit, None parity) may be any of the available baud rates including: 50, 75, 110, 135, 150, 300, 600, 1200, 1800, 2000, 2400, 3600, 4800, 7200, 9600, 19200, 28800, 38000, 57600. Returns back to Command mode after each entry. Term Mode: Term Mode Keys: BREAK: Ctrl-Scroll Lock (usually marked Break as well) PgUp: Upload a file using xmodem (from PC) PgDn: Download a file using xmodem (to PC) Ins: Toggle ON/OFF capturing to disc Esc: (default) Return to command mode This may be changed by a command line param. Capture Operation: From terminal mode, logging to disk is toggled with one key (Ins) When initially started, it asks for a file name (defaults to capture.fil) The next time the Ins key is used, capturing is stopped and the file is closed. Capturing works best to hard disc. No large memory buffer is allocated. Capture mode always remembers the last file name used. If you choose the same file, the new data will be appended to it. Capturing can survive leaving term mode and returning. (You might use DOS LIST to "scroll back" a long ways!) The capture file is closed upon normal exit of the program. Xmodem Send Mode: Prompts for filename to send. Shows an estimate of transfer time. Waits for initial sync character and sends file. Block number being sent is displayed on screen to show progess. Esc will abort transfer and return to Term mode. Displays a message noting success, or reason for abort. Xmodem Receive Mode: Prompts for filename to receive. Sends initial sync character (favors CRC, does either). Progess signal (dots) displayed on screen to show progess. R stands for retry Esc will abort transfer and return to Term mode. Displays a message noting success, or reason for abort. Xmodem File transfer supports: Files of up to 10,000 records (1.280 Mb) Speeds from 50 - 57600 are supported. Works from either configuration (8,1,N) and (7,1,E). Only 128 size records supported at present. Both CRC and Checksum transfers are supported. CRC is preferred. It will take longer to start checksum transfers since I am hoping for a "hunting" (alternating) NAK/CRC. Single file only transfer is supported. Operation: Initially, the program installs the receiver interrupt handler and posts a status message. Command mode is entered no matter what params are passed to the program. A prompt of the program name is shown, awaiting the following commands: Config : Set up comm parameters. Dos, : Calls DOS with commands. Help, : See this help info. Quit : Exit program. Rcvx, : Receive file using Xmodem. Sendx, : Send file using Xmodem. Term, : Dumb terminal mode. The default configuration of 1200, 8, 1, None. A menu is always available by entering either a blank line or Help. All commands can be abbreviated as the first letter of the command, or the entire word may be keyed in. Upper and Lower case are equal. To return to command mode, use the ESC key. Caveat Usor: This program dabbles with comm (and ^C) interrupt vectors, and should NEVER exit back to DOS abnormally. If it does, please forward me the sequence of events that led up to it, as specifically as you can remember. IF THIS OCCURS, YOUR MACHINE SHOULD BE RE-BOOTED. Incoming charcters may force the system off into the weeds. Also, I have tried the xmodem protocol against what I believe to be a wide variety of BBS's and systems from Osbornes to Tandems to Macs. If you have a failure, please note the type of system, if it is repeatable, and if/how I can get onto it to use the trusty old datascope.