home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PASCAL / MADTRB18.ZIP / ITERM.DOC < prev    next >
Encoding:
Text File  |  1980-08-20  |  7.4 KB  |  159 lines
  1. ITERM.COM by Scott Murphy
  2. 77 So. Adams St. #301
  3. Denver, CO 80209
  4. Compuserve 70156,263
  5.  
  6.    ITERM.COM is a terminal emulator for the IBMPC and close
  7. compatibles.  It supports a telephone directory and auto-dial
  8. for a Hayes external modem.  ASCII files can be transmitted and
  9. received with X/ON-X/OFF flow control, or files of any kind may
  10. be sent and received using the XMODEM-CRC protocol. Because it
  11. is written in Turbo Pascal, and because it does not include
  12. every concievable feature, it is relatively small (25K), and
  13. loads and executes quickly.  Its only known bug that I have been
  14. unable to root out is a frequent failure to initialize the modem
  15. correctly when first executed. Exiting and re-running the
  16. program invariably solves the problem.
  17.  
  18.    ITERM is essentially "modeless."  Everything you type at the
  19. keyboard, with the exception of the alt-shifted command keys
  20. described below, is sent to the modem and on to the machine you
  21. are communicating with.  I find this simplicity attractive
  22. compared to older CP/M programs, or the implementation of
  23. KERMIT that I have used.
  24.  
  25. Status Line
  26.    ITERM maintains a dispaly of its current status on the top
  27. line of the screen. If you wonder what's going on, look there-
  28. it probably says.
  29.  
  30. Auto-Dialing
  31.    ITERM maintains a directory of 20 telephone numbers.  Each
  32. directory entry has room for the name of the system, your
  33. usercode and password, the communication parameters needed by
  34. the remote system, and a list of characters to be filtered from
  35. the incoming stream.  ITERM will look for its directory file on
  36. the currently logged disk.  If none is present, a new, blank
  37. directory is created.  It is up to you to fill in the directory
  38. as you use the program.
  39.  
  40. Command Keys
  41.  
  42. F1 ------ Send the current usercode string.
  43. F2 ------ Send the current password string.
  44. F3 ------ Recall the last line typed at the keyboard.
  45. F7 ------ Send an ASCII file with X/ON - X/OFF flow control.
  46. F9 ------ Toggle ASCII text capture on/off. The first time you
  47.           use F9, you will be prompted for a filename to open and
  48.           use for text capture. If the file exists, text will be
  49.           added to the end of the file. X/ON - X/OFF flow control
  50.           is used.
  51. F10 ----- Close the current text capture file, and turn text capture off.
  52. Alt-B --- Break. Sends a break signal to the remote system.
  53. Alt-C --- Clear the screen.
  54. Alt-D --- Dial the modem. A numbered list of system names will
  55.       appear in a window on the screen. To dial a system,
  56.       enter its line number (1-20), and a carriage return.
  57.       To add, or change an entry, enter the letter 'C' and
  58.       a carriage return. You will be prompted for a line
  59.       number to add or change.  You will be prompted for
  60.       the contents of the directory entry interactively. If 
  61.       you don't wish to change an item of the directory entry,
  62.       just type a carriage return.  Some mainframes _will_ 
  63.       persist in adding junk characters to their output stream. 
  64.       You may filter these out by providing their decimal ASCII
  65.       codes at the appropriate prompt. (127, the little house-
  66.       shaped pictograph on IBM is a common one.) Some machines cannot
  67.       accept the strings sent by the F1, F2, and F3 keys at the
  68.       full speed of your modem. By default, ITERM waits for an
  69.       echo from the remote system before sending each new character.
  70.       You may defeat this by answering no at the 'Use pacing' prompt.
  71.       If you decide not to dial a number or change an entry,
  72.       answer the first prompt with a single carriage
  73.       return.  If you wish to abort a call in progress,
  74.       (perhaps because of a busy signal) type a control-X.
  75. Alt-H --- Hang-up the modem. This command tells the modem that
  76.       the terminal (your computer) is no longer ready to
  77.       talk to a remote system. The modem responds by
  78.       hanging up. In its default configuration, the Hayes
  79.       modem maintains the Terminal-Ready state regardless
  80.       of what ITERM tells it. To enable the Alt-H command,
  81.       you must disable this feature of the modem. (Switch 1
  82.       inside the front panel of the Smartmodem 300 must be
  83.       UP to enable Alt-H. Settings for other models and
  84.       compatible brands will vary. Consult your manual.)
  85. Alt-P --- Parameters. Alter or examine the current
  86.       communication parameters.  Allows you to see or set
  87.       the baud-rate, number of stop-bits and data bits, and
  88.       the parity setting.  The program will gladly accept
  89.       any baud rate up to 9600. It's up to you to enter the
  90.       desired rate without typos.
  91. Alt-R --- Recieve a file in XMODEM-CRC protocol. You will be
  92.       prompted for a filename. If the file exists, you have
  93.       the option of overwriting it or entering a new file
  94.       name.
  95. Alt-S --- Send a file in XMODEM-CRC protocol. You will be
  96.       prompted for a file name to send. If it cannot be
  97.       found, you may retype the name, or abort the send.
  98.       Once the transmission process has begun, you may
  99.       abort it at any time by typing a control-X.
  100. Alt-X --- eXit ITERM.  You can back out of the exit if you
  101.       issue this command by mistake.  (Note: ITERM will not
  102.       automatically hang up the modem on exit. This can be
  103.       useful if you wish to run other software and then
  104.       return to your session.)
  105. Home ---- Help. Displays a menu of commands.
  106.  
  107. Up
  108. Arrow --- Saves the contents of the current screen for later
  109.       review.
  110. Down
  111. Arrow --- Restores the contents of the screen saved with Up
  112.       Arrow.
  113. Right
  114. Arrow --- Recalls characters from the last line typed at the
  115.       keyboard, one at a time.
  116.       
  117.  
  118. Notes on the source code.
  119.    ITERM is composed of code I have written in Turbo-Pascal,
  120.    and of code others have written and released to the public
  121.    domain.  I hereby release the portions I wrote into the
  122.    public domain as well.  You may do anything with it except
  123.    put your name on it and attempt to sell it for profit.
  124.    Remember, there is no creature more despicable than a
  125.    plagiarer!
  126.    
  127.    ITERM is composed of a "root" file, ITERM.PAS, and a set of
  128.    ".INC" files that implement various sections of the program.
  129.    Turbo Pascal permits the type definitions, and constant and
  130.    variable declarations of a program to be scattered through-
  131.    out a source file, so long as they appear outside the block
  132.    where they are used. I have taken advantage of this feature
  133.    to keep the Type, Const, and Var sections of the various
  134.    include files near the code that uses them.
  135.    
  136.    The include files are as follows:
  137.        ITRMDIAL.INC -- implements auto-dialing and the phone
  138.          directory.
  139.        ITRMSAVE.INC -- the code to capture the ASCII text of
  140.          your terminal section.
  141.        ITRMXFER.INC -- implements XMODEM protocol and ASCII
  142.          text-file transmission.
  143.        ITRMMISC.INC -- miscellaneous service routines used by
  144.          other program segments.
  145.        ITRMPORT.INC -- the routines that drive the serial
  146.          port, including the interrupt service routine that
  147.          permits interrupt driven input from your modem. Most
  148.          of these routines were written by Alan Bishop.
  149.     ITRMWIND.INC -- the routines that handle the windows
  150.       that come and go as the program runs, and allow you
  151.       to save a screen for later reference. Thes were
  152.       written mostly by Bela Lubkin of Borland Int'l.
  153.       
  154. Your comments or complaints, and especially your improvements,
  155. are of course, invited.
  156.  
  157. Unsolicited Advertisement: Turbo Pascal, and Borland International,
  158. its publishers, are a joy to work with.  Seek them out.
  159.