home *** CD-ROM | disk | FTP | other *** search
/ Boston 2 / boston-2.iso / DOS / HILFEN / MODEM / TT / TT2.DOC < prev    next >
Text File  |  1993-12-01  |  152KB  |  4,245 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.                                  TurboTerm 2.0
  33.  
  34.                            Program Reference Manual
  35.  
  36.             (c) Copyright 1991 by Brian Dunworth and Scott Riether
  37.  
  38.  
  39.  
  40.  
  41.  
  42.          To register your copy of TurboTerm, please fill out this form, and
  43.          send it to the address listed.
  44.  
  45.  
  46.  
  47.   Submit To: Scott Riether
  48.              TurboTerm Registrations
  49.              19 Summit Road
  50.              Stratford, NJ. 08084
  51.  
  52.  
  53.  
  54.   Qty. Description                                        Amount
  55.  
  56.   ____ TurboTerm Registration                           $25.00 ea __________
  57.  
  58.   ____ TurboTerm Registration & Printed Manual          $40.00 ea __________
  59.  
  60.  
  61.                                                          Shipping __________
  62.  
  63.  
  64.                                                             Total __________
  65.  
  66.   Name:_____________________________________________
  67.  
  68.   Company:__________________________________________
  69.  
  70.   Address:__________________________________________
  71.  
  72.   City:___________________________State:____Zip:__________
  73.  
  74.   Work Phone: (____)  ________________     Home Phone: (____) _______________
  75.  
  76.   Comments: _________________________________________________________________
  77.  
  78.             _________________________________________________________________
  79.  
  80.             _________________________________________________________________
  81.  
  82.             _________________________________________________________________
  83.  
  84.             _________________________________________________________________
  85.  
  86.             _________________________________________________________________
  87.  
  88.             _________________________________________________________________
  89.  
  90.             _________________________________________________________________
  91.  
  92.   Note: Shipping to 48 continental states is $5.00.  Shipping to Alaska,
  93.         Hawaii, and Canada is $10.00.
  94.  
  95.  
  96.  
  97.   Registered TurboTerm users will receive a copy of TurboTerm 2.0 which no
  98.   longer displays the registration notice.
  99.  
  100.                       Please allow 3-5 weeks for delivery.
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.                                Table Of Contents
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.      1. Installation ................................................... 1
  118.  
  119.      2. Command Line Parameters ........................................ 3
  120.  
  121.      3. The TurboTerm Status Line ...................................... 4
  122.  
  123.      4. TTSetup ........................................................ 5
  124.  
  125.      5. -  Video Options ............................................... 6
  126.  
  127.      6. -  Modem Options ............................................... 7
  128.  
  129.      7. -  Directories ................................................ 13
  130.  
  131.      8. -  User Shells ................................................ 14
  132.  
  133.      9. -  Protocols .................................................. 16
  134.  
  135.     10. -  Miscellaneous Options ...................................... 23
  136.  
  137.     11. Program Reference ............................................. 34
  138.  
  139.     12. Appendix A  -  Setting Up a Ram Disk .......................... 46
  140.  
  141.     13. Appendix B  -  Usage Logs ..................................... 48
  142.  
  143.     14. Appendix C  -  Script Commands ................................ 50
  144.  
  145.     15. Appendix D  -  TurboTerm Clipboard ............................ 55
  146.  
  147.  
  148.      
  149.  
  150.  
  151.  TurboTerm 2.0                    Installation
  152.  
  153.  
  154.  
  155.                        Don't forget to make backups.
  156.  
  157.  
  158.     Floppy disk installation:
  159.  
  160.     Be aware that TurboTerm requires one of the following drive setups:
  161.  
  162.       A -  Two 360K floppy drives
  163.  
  164.          Although TurboTerm can be run from two 360K floppy drives, the
  165.          installation process gets somewhat involved.
  166.  
  167.          If you have only two 360K floppy drives then follow these
  168.          instructions:
  169.  
  170.             1 - Place TTSETUP.EXE, and TT.EXE on diskettes by themselves.
  171.  
  172.             2 - Run TTSetup using the instructions found later in this
  173.                 manual.
  174.  
  175.             3 - After entering all the setup defaults that you wish for
  176.                 TurboTerm, copy the TT.CFG file from your setup diskette
  177.                 onto the diskette which contains TT.EXE
  178.  
  179.             4 - TT.EXE and TT.CFG are the only files required for
  180.                 TurboTerm to operate correctly.  Any other files that it
  181.                 needs, it will create.
  182.  
  183.          Remember:  The disk containing TT.EXE must never be removed from
  184.                     the disk drive during the operation of the program.
  185.  
  186.       B - A single 720K floppy
  187.  
  188.          TurboTerm and its associated files take approximately 500K of
  189.          disk space, so a single 720K diskette should be fine for most
  190.          installations.  Place all .EXE files from your original archive
  191.          onto a formatted 720K diskette.  Log onto that drive and type
  192.          TTSETUP<ENTER> at the DOS prompt.  Configure TurboTerm for your
  193.          system using the instructions found later in this manual.
  194.  
  195.          Remember:  The disk containing TT.EXE must never be removed from
  196.                     the  disk drive during the operation of the program.
  197.  
  198.       C - A hard disk with at least 500k free.
  199.  
  200.     Disk swapping (discussed later in this manual) is not available for
  201.     floppy only installations.
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  09-01-91                                 1
  213.  
  214.  
  215.  
  216.  TurboTerm 2.0                    Installation
  217.  
  218.     Hard Disk Installation:
  219.  
  220.     When installing TurboTerm on a hard disk, all files from the original
  221.     archives should be copied into the \TT subdirectory.  After the files
  222.     have been copied into your \TT directory, change to your TurboTerm
  223.     directory by typing CD\TT<Enter>.  At the DOS prompt type TTSETUP
  224.     <Enter>.  Configure TurboTerm for your system using the instructions
  225.     found later in this manual.
  226.  
  227.     To make your TurboTerm directory as uncluttered as possible, it is
  228.     recommended that you separate your upload, download, script, and log
  229.     directories.  TurboTerm defaults to having all files located in your
  230.     TurboTerm directory.  It would be worth your time, however, to change
  231.     your default directories to help organize your TurboTerm setup.  Here
  232.     is a picture of one possible TurboTerm subdirectory setup on a hard
  233.     disk:
  234.  
  235.          TT─┬──TRANS
  236.             ├──SCRIPTS
  237.             └──LOGS
  238.  
  239.     The TT\TRANS directory is used to store all uploaded and downloaded
  240.     files.  A separate directory is optional, but having it will make file
  241.     location easier.
  242.  
  243.     The TT\SCRIPTS directory is a convenient place to store all of your
  244.     TurboTerm script files, to facilitate script maintenance.  You can
  245.     recognize a TurboTerm script file from its extension.  All files
  246.     ending in .SCR are script files.  The sample scripts and the
  247.     documentation found later in this manual should help you in
  248.     customizing a script for your own needs.  Copy the provided TurboTerm
  249.     scripts to the directory you set up as your script directory.
  250.  
  251.     The TT\LOGS directory is where all of TurboTerm's capture and usage
  252.     logs will be stored.  TurboTerm's logs and capture logs will be
  253.     discussed later in this manual.
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.                                           2                          09-01-91
  278.  
  279.  
  280.  
  281.  TurboTerm 2.0              Command Line Parameters
  282.  
  283.  
  284.     Certain TurboTerm features are (out of necessity) implemented via
  285.     command line parameters and have no terminal mode or script command
  286.     equivalents.  Command line parameters are not case sensitive and may
  287.     be specified in any order.
  288.  
  289.     The following DOS command-line parameters are valid when starting
  290.     TurboTerm:
  291.  
  292.             @0     Tells TurboTerm to start up in the dialing directory,
  293.                    waiting for user input.  Under most conditions you
  294.                    would first be entering TurboTerm to dial a number
  295.                    anyway, so this gives you the ability to enter the
  296.                    dialing directory quickly without typing <Alt-D>.
  297.  
  298.             @#     Tells TurboTerm to dial the specified entry in the
  299.                    dialing directory.  This enables TurboTerm to be run
  300.                    from a batch file as part of some maintenance
  301.                    procedure, or as a quick way to start dialing your
  302.                    favorite number upon invoking TurboTerm.
  303.  
  304.       -MR or /MR   Force TurboTerm to send your predefined modem
  305.                    initialization sequence regardless of whether
  306.                    TurboTerm detects a carrier.  This is useful when you
  307.                    have modem setup to maintain DTR high even when not
  308.                    online.
  309.  
  310.       -CD or /CD   Absolutely, positively do not send the modem
  311.                    initialization string when entering TurboTerm.
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  09-01-91                                 3
  343.  
  344.  
  345.  
  346.  TurboTerm 2.0                    Status Line
  347.  
  348.  
  349.     TurboTerm displays many of its operational parameters on the status
  350.     line on the bottom of the screen.  The status line is divided into the
  351.     following areas:
  352.  
  353.     TurboTerm!   This is the program name, and a proud addition to any
  354.                  status line.  This is overwritten (temporarily) when
  355.                  <Alt-T> is pressed to display the current date and time,
  356.                  and during clipboard transfers, when the transfer status
  357.                  is indicated.  At the conclusion of either of these
  358.                  events, the program name is again displayed.
  359.  
  360.     Emulation    This is the current Terminal emulation.  Available
  361.                  emulations are:
  362.  
  363.                    TTY
  364.                    ANSI
  365.                    DEBUG_ASCII
  366.                    DEBUG_HEX
  367.  
  368.                  Terminal emulation is discussed later in this manual.
  369.  
  370.     Alt-Z        This is always displayed for those that can never
  371.                  remember that keystroke.  Pressing <Alt-Z> while inside
  372.                  TurboTerm will pop up a full screen listing of the
  373.                  most-common TurboTerm commands.
  374.  
  375.     Com params   This area displays your current com port, duplex, parity,
  376.                  data bits, stop bits, and baud rate.  These settings are
  377.                  discussed later in this manual.
  378.  
  379.     Off-line     This area displays the on-line status.  It will display
  380.                  Online/Offline/Direct based on the status of the modem
  381.                  DTR signal, or the status of the null modem toggle.
  382.  
  383.     Log          This is the status of your capture log file.  If the word
  384.                  LOG is visible, the current session is being logged to
  385.                  disk.
  386.  
  387.     Time         This area displays the current time when off-line, or the
  388.                  elapsed time since connection was established.  As soon
  389.                  as the connection is terminated, the time display will
  390.                  switch back to the current system time.
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.                                           4                          09-01-91
  408.  
  409.  
  410.  
  411.  TurboTerm 2.0                      TTSetup
  412.  
  413.  
  414.     TTSetup is a stand-alone program, and can be run from the DOS prompt
  415.     by typing: TTSETUP <ENTER>
  416.  
  417.     You must run TTSetup at least once when you first run TurboTerm, as it
  418.     creates a file containing all the user-defined features of TurboTerm.
  419.     When you run TTSetup and save your settings upon exiting, a TT.CFG
  420.     file will be created, containing your preferred TurboTerm settings.
  421.  
  422.       NOTE: If this is an upgrade from a previous release, TurboTerm will
  423.             read the existing TT.CFG,  and will NOT create a new file upon
  424.             startup.
  425.  
  426.     Configuring TurboTerm is simple, whether you are installing TurboTerm
  427.     for the first time or upgrading from a previous release.
  428.  
  429.     When you first enter TTSetup, you are shown a menu that depicts each
  430.     of the user-defined options.  TTSetup uses pull down menus for ease in
  431.     selection and navigation.  With a little practice, you will find
  432.     navigating through TTSetup extremely simple.  Use the cursor control
  433.     keys to move to a particular item, and <ENTER> to select that item.
  434.  
  435.       TIP 1:  The highlighted letter in each menu choice is a hot key to
  436.               that particular item, and can speed up your menu selections.
  437.  
  438.       TIP 2:  The escape key is used to exit you from any given field or
  439.               menu item.
  440.  
  441.     In the paragraphs that follow, as each section of TTSetup is
  442.     discussed, the paragraph heading will indicate TurboTerm's default
  443.     selection in the section heading, surrounded by brackets ([]).
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  09-01-91                                 5
  473.  
  474.  
  475.  
  476.  TurboTerm 2.0                      TTSetup                             Video
  477.  
  478.  
  479.     This section allows you to choose how TurboTerm will look on the
  480.     screen.  You will be given the choice of 6 pre-defined color schemes,
  481.     or you may customize TurboTerm's colors according to your own tastes.
  482.  
  483.     In most cases, TurboTerm will automatically detect the presence of a
  484.     color monitor and chose whether you should use color or monochrome
  485.     color sets.
  486.  
  487.     The custom color selection allows you to change numerous colors inside
  488.     TurboTerm.  The names of the different dialog-, command-, and
  489.     information-screens are displayed on the screen.  Simply choose the
  490.     color you wish to change, and press <Enter>.
  491.  
  492.     After selecting the color to be changed, you will be given a sample
  493.     TurboTerm screen on the right, and a color selection box on the left.
  494.     The sample TurboTerm screen will magically update and give you an
  495.     example of your changes, before you actually save your selections and
  496.     return to TurboTerm.
  497.  
  498.     Standard cursor movement keys will allow you to pick your desired
  499.     color for the selected option.  Upon moving the cursor, you will see a
  500.     sample of the new color selection appear in the sample TurboTerm
  501.     screen on the right.  Once you have selected the color that suits your
  502.     taste, hitting <ENTER> will make that change take effect.  If you
  503.     don't wish to make a change for the current color, then <ESC> will
  504.     exit and automatically undo any change for that color.  At this point
  505.     it might be prudent to state that even after you have selected the
  506.     *perfect* color scheme, you must still save the changes when you exit
  507.     TTSetup for the colors to effect the appearance of your TurboTerm
  508.     screens.
  509.  
  510.     You have the ability to pick one of six predefined color sets inside
  511.     TTSetup.  These color sets were designed to present a color scheme
  512.     that is as pleasant and functional as possible.  Once you have
  513.     selected a given color set you may still elect to change one or more
  514.     of the colors to fully customize your TurboTerm colors.
  515.  
  516.     The blue color set is the default set for all systems that indicate
  517.     a color monitor.  The red color set provides a bold, bright feeling,
  518.     while the cyan color set gives a warmer, more mellow telecommunicating
  519.     atmosphere.
  520.  
  521.     The monochrome color set is best suited for LCD laptops or monochrome
  522.     systems.  This color set is chosen by default on systems that indicate
  523.     a monochrome adapter.
  524.  
  525.     The random color set is provided for those that have a certain
  526.     amount of difficulty in making up their mind.  For a truly
  527.     distinctive color scheme, give the random color set a try.
  528.  
  529.     The direct video option is a toggle which will attempt to thwart the
  530.     screen flicker found on some older CGA adapters, as well as allowing
  531.     smoother screen output while running under multi-tasking environments
  532.     such as DESQview or Windows 3.0.  TurboTerm defaults to using direct
  533.     screen writes, providing much quicker screen output.
  534.  
  535.  
  536.  
  537.                                           6                          09-01-91
  538.  
  539.  
  540.  
  541.  TurboTerm 2.0                      TTSetup                             Modem
  542.  
  543.  
  544.     This section is used to set the modem and hardware information
  545.     particular to your setup, so that TurboTerm can operate correctly.
  546.  
  547.  
  548.     Baud rate   [2400]
  549.  
  550.     This option allows you to pick a default baud rate for TurboTerm to
  551.     initialize your modem at, and to initially configure your dialing
  552.     directory entries.  While inside TurboTerm you can also change your
  553.     baud rate with the <Alt-P> communications parameter settings function.
  554.     The baud rate is the rate at which your computer will talk to your
  555.     modem or serial port.  Typically you will choose the fastest rate that
  556.     your modem is capable of. I.E.: If you have a 1200 baud modem, then
  557.     choose 1200, or choose 2400 if you have a 2400 baud modem, etc. The
  558.     only exception to this rule is for those people that have error
  559.     correcting modems with MNP 1-5 or V.42.  With these modems it is
  560.     typically desired to have a baud rate faster than the actual connect
  561.     rate.
  562.  
  563.     For 2400 Bps MNP or V.42 modems you should set your baud at 4800 and
  564.     for 9600 Bps MNP or V.42 modems you should select your baud rate at
  565.     19200 (38400 for the newer/faster 9600 modems). If you are unsure of
  566.     what rate your modem is capable of handling or which baud rate to
  567.     choose, consult your modem instruction manual.
  568.  
  569.     This option can be defined while in TurboTerm with the <Alt-P>
  570.     selection, and is also definable by dialing directory entry.  If you
  571.     are calling a 1200 Bps system with your 2400 Bps modem, TurboTerm will
  572.     automatically set the baud rate to the correct value when dialing that
  573.     entry.
  574.  
  575.  
  576.     Parity   [None]
  577.  
  578.     Parity is a bit to check the integrity of a received byte.  When used,
  579.     all the bits in a data stream byte are added together.  A final bit,
  580.     called the parity bit, is added such that the sum of all bits will be
  581.     made either odd or even.  The transmitter calculates a parity bit, and
  582.     transmits it with its data stream.  The receiver also calculates a
  583.     party bit and compares it to the parity bit it received.  If the bits
  584.     are equal, then no error has occurred, otherwise some error has
  585.     occurred during transmission.
  586.  
  587.     The allowable parity settings are:
  588.  
  589.           No parity    - no parity bit is added.
  590.           Even parity  - a parity bit is added so the sum bit is always
  591.                          even.
  592.           Odd Parity   - a parity bit is added so the sum bit is always
  593.                          odd.
  594.           Mark parity  - a parity bit of value one is always added.
  595.           Space parity - a parity bit of value zero is always added.
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  09-01-91                                 7
  603.  
  604.  
  605.  
  606.  TurboTerm 2.0                      TTSetup                             Modem
  607.  
  608.     Set your parity to None or Even for most applications. It should be
  609.     mentioned that both GEnie and Compuserve allow parity settings of
  610.     EVEN and NONE.  If your only use for TurboTerm is to call pay services
  611.     such as GEnie or Compuserve, set even parity.  If your primary use for
  612.     TurboTerm is to call bulletin board systems, set your parity to none.
  613.  
  614.  
  615.     Data Bits   [8]
  616.  
  617.     Data bits are the number of bits of information in a data stream that
  618.     is actual data and not parity or stop bit information.  Allowable data
  619.     bit values are 5 through 8.  Under typical applications you should set
  620.     your data bits to 8 when your parity is none, or to 7 when your parity
  621.     is even.
  622.  
  623.  
  624.     Stop bits   [1]
  625.  
  626.     Stop bits are the number of bits that indicate a complete transfer of
  627.     all data bits in a serial data stream.  Typically your stop bit value
  628.     should be selected to 1 for almost all applications.  Allowed values
  629.     for stop bits are 1 and 2.
  630.  
  631.  
  632.     Serial Port   [COM1]
  633.  
  634.     This is the serial port number designator that your modem or null
  635.     modem is connected to.  Allowed values are COM1 through COM8.  The
  636.     industry standard support for COM1 through COM4 is already configured
  637.     inside TurboTerm, however some serial ports may not conform to the
  638.     industry standards for these ports, so the ability to configure
  639.     TurboTerm for non-standard serial ports is provided in TTSetup.
  640.     Configuring TurboTerm for operation on a non-standard serial port is
  641.     discussed under Port Assignments.
  642.  
  643.  
  644.     Enable 16550A FIFO   [No]
  645.  
  646.     If you know you have a 16550A UART in your computer, it is highly
  647.     recommended that you enable it.  This will insure fewer errors when
  648.     connected at high data rates.  Enabling this feature in TurboTerm will
  649.     cause no adverse effects if you do not have a 16550A UART.  Chances
  650.     are, if you haven't personally purchased a 16550A UART for your
  651.     computer, you do not have one.
  652.  
  653.     A FIFO is a First-In, First-Out buffer found only in the 16550A UART.
  654.     The FIFO buffer in a 16550A UART allows a greater delay between each
  655.     successive poll of a serial link without the chance for loss of data.
  656.     A 16 byte buffer in the UART itself accomplishes this.
  657.  
  658.     Under normal circumstances this feature is not needed, however when
  659.     using TurboTerm at high connect rates with a high speed modem or a
  660.     null modem cable, loss of data can occur if the computer is doing
  661.     something else when the next piece of information comes across the
  662.     serial link.
  663.  
  664.  
  665.  
  666.  
  667.                                           8                          09-01-91
  668.  
  669.  
  670.  
  671.  TurboTerm 2.0                      TTSetup                             Modem
  672.  
  673.     QEMM/386Max users should note that the memory/processor management
  674.     schemes of these programs cause a slightly longer delay in serial port
  675.     handling than computers that don't run them.  If you plan on running
  676.     TurboTerm at any rate greater than 9600 baud and you are running one
  677.     of these memory managers, then a 16550A UART is highly recommended.
  678.  
  679.  
  680.     Flow Control    [Hardware CTS/RTS]
  681.  
  682.     Flow control is the means through which your computer requests a
  683.     temporary pause in data transfer.  Typically such requests are
  684.     required when data is being transferred faster than the receiver can
  685.     process it.  Allowable flow control values are:
  686.  
  687.           None     - No flow control will be used for send or receive
  688.                      operations.  This mode is not recommended unless
  689.                      using TurboTerm for specific applications or other
  690.                      specialized tasks.
  691.  
  692.          Software  - Software flow control uses the industry standard
  693.                      [XOFF] and [XON] characters to tell a remote system
  694.                      to pause and then resume data transfer.  Some modems
  695.                      are incapable of the more reliable hardware flow
  696.                      control, and in these cases you should select
  697.                      software flow control.
  698.  
  699.                      NOTE: Some binary file transfers require that
  700.                            hardware flow control be used, and will not
  701.                            work with software flow control.  ZModem and
  702.                            Kermit are capable of using either software or
  703.                            hardware flow control.
  704.  
  705.          Hardware  - Hardware flow control is the most efficient means of
  706.                      controlling the flow of data to and from your serial
  707.                      port.  Hardware flow control follows the state of the
  708.                      UART CTS/RTS lines.  In almost all instances,
  709.                      hardware flow control should be enabled if possible.
  710.  
  711.                      NOTE: Some modems, specifically those found in Tandy
  712.                            laptops, may not communicate with TurboTerm at
  713.                            all when this option is turned on.  If you have
  714.                            a Tandy laptop and cannot seem to get TurboTerm
  715.                            to talk to the modem, then choose another form
  716.                            of flow control.
  717.  
  718.          Both      - If you are unsure of what type of flow control to use
  719.                      for a given application, choose this option to enable
  720.                      both software and hardware flow control.  If your
  721.                      hardware supports both hardware and software flow
  722.                      control, then choosing this option will cause a
  723.                      slight degradation in the throughput of binary file
  724.                      transfers.
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  09-01-91                                 9
  733.  
  734.  
  735.  
  736.  TurboTerm 2.0                      TTSetup                             Modem
  737.  
  738.     Port Assignments
  739.  
  740.     This option will allow you to configure TurboTerm to operate on a
  741.     non-standard serial port.  If your serial port does not conform to the
  742.     industry standard COM1 through COM4 designations, or your serial port
  743.     is on COM5 through COM8, read on.
  744.  
  745.     Configuring a non-standard port for use with TurboTerm was made as
  746.     simple as possible.  For TurboTerm to correctly interface with your
  747.     serial port it must know the UART's base address, IRQ line, and
  748.     interrupt number.
  749.  
  750.  
  751.     Base Address   [Based on comport]
  752.  
  753.     The UART's base address is the hexadecimal number that represents the
  754.     address of the UART in the PC's I/O address space.  In the IBM PC, the
  755.     UART generally used is the 8250 or one of its descendants. The 8250
  756.     UART family consists of the 8250, 16450, 16550, and the 16550A.
  757.     TurboTerm is capable of correctly addressing all of these UARTs.  The
  758.     8250 UART family can be likened to the 8088/8086 family of processors
  759.     from Intel.  The 8250 was the first, and the 16550A is the latest.
  760.     The 16650A's main advantage over its predecessors is it's internal
  761.     FIFO buffer.  (For more information on FIFO buffering, and how to
  762.     enable the 16550A FIFO buffer, see the information on 16550A FIFOs
  763.     above.)
  764.  
  765.     To adjust the comport base address, press <ENTER> on Base Address,
  766.     then select the comport base address that you wish to modify, and
  767.     press <ENTER>.  Type in the hexadecimal number that represents the
  768.     base address of your UART.  Valid numbers are from 0000 to FFFF
  769.  
  770.  
  771.     IRQ line   [Based on comport]
  772.  
  773.     The IRQ number is the interrupt request line that is associated with a
  774.     given UART.  When the UART receives a character it generates an
  775.     interrupt request on the interrupt request line of the PC.
  776.  
  777.     To adjust the comport IRQ line press <ENTER> on IRQ line, then select
  778.     the comport's IRQ that you wish to modify and press <ENTER>.  Type in
  779.     the hexadecimal number of the IRQ line your serial port requires.
  780.     Valid IRQ's are from 0 to F.
  781.  
  782.  
  783.     Interrupt vector   [Based on comport]
  784.  
  785.     The interrupt vector is the associated interrupt service routine that
  786.     handles the interrupt request when called for by the UART.
  787.  
  788.     To adjust the comport interrupt vector IRQ line press <ENTER> on
  789.     Interrupt vector, then select the comport interrupt vector that you
  790.     wish to modify, and press <ENTER>.  Type in the hexadecimal number of
  791.     the interrupt vector your serial port requires.  Valid interrupt
  792.     vectors are from 00 to FF.
  793.  
  794.  
  795.  
  796.  
  797.                                          10                          09-01-91
  798.  
  799.  
  800.  
  801.  TurboTerm 2.0                      TTSetup                             Modem
  802.  
  803.     Under normal circumstance you should never have to adjust any of the
  804.     values discussed above; the default values should work on most
  805.     computers.
  806.  
  807.        PS/2 computer owners:
  808.  
  809.        When you are running on an IBM PS/2 it is imperative that you
  810.        choose the Restore PS/2 Defaults option.  This will initialize
  811.        TurboTerm to correctly locate and address your serial port.
  812.        Failing to do this will prevent TurboTerm from running on any modem
  813.        connected to any port other than COM1 or COM2.
  814.  
  815.  
  816.     Modem commands
  817.  
  818.     The modem commands section allows you to configure TurboTerm to
  819.     properly initialize, dial, and hang-up your modem.  The default
  820.     configuration in TTSetup will work for most modems.  The ability to
  821.     configure TurboTerm to your modem's specific commands is described
  822.     below.  TurboTerm defaults to using the Hayes AT command set.
  823.  
  824.  
  825.     Initialization string   [ATZ]
  826.  
  827.     Your modem initialization string determines the state that your modem
  828.     will be in when first entering TurboTerm.  TurboTerm will send this
  829.     string to your modem on program startup, unless specifically
  830.     prohibited from doing so because of a sensed carrier or command line
  831.     option.  The initialization string can be any valid string, your
  832.     modem should be configured so that it reflects the true state of the
  833.     carrier.  The Hayes command to accomplish this is AT&C1&D2.  Refer to
  834.     your modem's manual for instructions on how to force your modem to
  835.     follow the state of carrier detect.  For TurboTerm to work properly,
  836.     your modem must be capable of following the true state of the carrier.
  837.     One sure-fire way of determining if your modem has forced carrier
  838.     presence is to check the Online/Offline area of the status bar.  If
  839.     the status line indicates that you are 'Online' when you first enter
  840.     TurboTerm, then you must reconfigure your modem.  Most modems allow
  841.     you to accomplish this via switches or command line sequences.  When
  842.     your modem is properly configured, TurboTerm will indicate 'Offline'
  843.     when you initially enter the program.  If your modem does not have
  844.     switches, or does not have non-volatile ram in which to save your
  845.     configuration, then refer to the command line parameter section of
  846.     this manual for further instructions.
  847.  
  848.  
  849.     Dialing prefix   [ATDT]
  850.  
  851.     The dialing prefix is the command that will precede all phone numbers
  852.     that TurboTerm dials.  In the Hayes AT command set, valid dialing
  853.     prefixes are ATDT and ATDP.  The dialing prefix can, optionally, also
  854.     contain commands to turn off call waiting, send your long distance
  855.     calling card number, etc.  Under most circumstances, your dialing
  856.     prefix will be either ATDT or ATDP.
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  09-01-91                                11
  863.  
  864.  
  865.  
  866.  TurboTerm 2.0                      TTSetup                             Modem
  867.  
  868.     CONNECT message   [CONNECT]
  869.  
  870.     This string defines the message returned by your modem when it
  871.     successfully connects to a remote modem.
  872.  
  873.  
  874.     Modem ERROR messages    [Hayes Smartmodem]
  875.  
  876.     These strings define the message(s) that your modem will return upon
  877.     failure to connect to a remote modem.  You should set these error
  878.     messages to the responses that your modem will return, in order to
  879.     help speed the redialing process.
  880.  
  881.  
  882.     Hang-up command    [ATH0]
  883.  
  884.     This string defines the command your modem requires to force a
  885.     disconnect.  The Hayes default is ATH0.
  886.  
  887.  
  888.     Attention character    [43]  (+)
  889.  
  890.     This is the ASCII value of the character that your modem recognizes as
  891.     its attention character.  Typically your attention character is a '+',
  892.     ASCII value 43.
  893.  
  894.  
  895.     DTR toggle
  896.  
  897.     This toggle sets whether TurboTerm will send your defined hang-up
  898.     string to hang-up the modem, or lower the DTR on your modem.  The most
  899.     reliable method of hanging up your modem is to lower DTR.
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.                                          12                          09-01-91
  928.  
  929.  
  930.  
  931.  TurboTerm 2.0                      TTSetup                       Directories
  932.  
  933.  
  934.  
  935.     Upload directory    [TurboTerm directory]
  936.  
  937.     This is the directory where TurboTerm will initially look for all
  938.     files that you wish to send to another system.
  939.  
  940.  
  941.     Download Directory    [TurboTerm directory]
  942.  
  943.     This is the path where TurboTerm will place all files that you receive
  944.     from another system during a file transfer.
  945.  
  946.  
  947.     Script Directory    [TurboTerm directory]
  948.  
  949.     This is the path where TurboTerm will look for all script files.
  950.     Scripts and the TurboTerm script language are discussed in Appendix C.
  951.  
  952.  
  953.     Log Directory    [TurboTerm directory]
  954.  
  955.     This is the path where TurboTerm will write all its session capture
  956.     logs and usage logs.
  957.  
  958.     It is recommended that you establish separate subdirectories when
  959.     running TurboTerm from a hard drive to make file management easier.
  960.     Don't worry about creating the subdirectories yourself;  TurboTerm
  961.     will attempt to create the specified directory if it does not already
  962.     exist.  If TurboTerm is unable to create the directory you specify, it
  963.     will default to the TurboTerm program directory for that option.
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  09-01-91                                13
  993.  
  994.  
  995.  
  996.  TurboTerm 2.0                      TTSetup                       User Shells
  997.  
  998.  
  999.     Have you ever wanted to go take a quick look at a file, without having
  1000.     to exit your terminal session?  With a defined user shell, it is
  1001.     possible to quickly pass control of your computer to a user defined
  1002.     program.  User shells in TurboTerm are specialized programs that can
  1003.     do anything from viewing files to running a spreadsheet.  You may
  1004.     define up to 10 user shells for use from within TurboTerm.  To
  1005.     activate any given shell, type Alt-0 through 9.  A valid shell is any
  1006.     existing DOS .EXE, .COM or .BAT file.
  1007.  
  1008.  
  1009.     The name    [Empty]
  1010.  
  1011.     This is where you will type in the full path and filename for the
  1012.     program.  Example:
  1013.  
  1014.            Alt 1 shell [C:\UTILS\LIST.COM C:\TT\TT.LOG        ]
  1015.  
  1016.     When inside TurboTerm, the Alt-1 shell would then shell to the program
  1017.     LIST.COM, and automatically list the file TT.LOG in your TurboTerm
  1018.     subdirectory.  Notice that a parameter may be passed to the program by
  1019.     typing the parameter in the entry space after the file name.
  1020.  
  1021.     NOTE: If you place a parameter on the command line after the filename,
  1022.           TurboTerm will not prompt you for any parameters when executing
  1023.           that shell.  If no parameters are specified in TTSetup, then
  1024.           TurboTerm will prompt you for the parameter(s) prior to
  1025.           executing the shell.
  1026.  
  1027.  
  1028.  
  1029.     Prompt    [No]
  1030.  
  1031.     After editing the filename and path of a given user shell, TTSetup
  1032.     will prompt you for a 'Y' or 'N'.  Selecting 'Yes' will force
  1033.     TurboTerm to prompt you with a 'Press any key to return to
  1034.     TurboTerm..' prompt prior to clearing the screen and returning to your
  1035.     telecommunications session.  Numerous programs run and execute so
  1036.     quickly that you are unable to see the result on the screen prior to
  1037.     returning to TurboTerm.  This is very common, especially in batch
  1038.     files.  To force a 'Press any key to return to TurboTerm...' prompt
  1039.     for a given user shell, set this field to 'Yes'.
  1040.  
  1041.     NOTE: TurboTerm will not change to the directory specified in the path
  1042.           stated on the command line.  If the called program requires that
  1043.           it be run from its own subdirectory, then we recommended you
  1044.           write a small DOS batch file to handle the directory changes.
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.                                          14                          09-01-91
  1058.  
  1059.  
  1060.  
  1061.  TurboTerm 2.0                      TTSetup                       User Shells
  1062.  
  1063.       Example:
  1064.  
  1065.       Lets say the program you want to run is SpeedWord, and it is located
  1066.       in your C:\SW\ subdirectory, and your TurboTerm directory is C:\TT\
  1067.       Since SpeedWord must be run from its own directory, you should set
  1068.       your shell to be: C:\SW\SW2.BAT COM2 PARITY EVEN
  1069.  
  1070.       You should then write a small batch file that looks something like
  1071.       this, and place it in your SpeedWord subdirectory.
  1072.  
  1073.            @ECHO OFF
  1074.            CD \SW
  1075.            SW %1 %2 %3 %4
  1076.            CD \TT
  1077.            EXIT
  1078.  
  1079.       This batch file will turn local echoing of the following commands
  1080.       off, then change to the SpeedWord subdirectory.  It then starts
  1081.       SpeedWord with the parameters you specified in your user shell.
  1082.       After completing SpeedWord, you will be returned to TurboTerm.
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  09-01-91                                15
  1123.  
  1124.  
  1125.  
  1126.  TurboTerm 2.0                      TTSetup                         Protocols
  1127.  
  1128.  
  1129.     The greatest improvement in TurboTerm 2.0 was the addition of internal
  1130.     file transfer protocols.  File transfer protocols are used for sending
  1131.     and receiving data files, usually in a non-readable or binary format.
  1132.     TurboTerm supports 9 internal protocols including: Xmodem, Xmodem CRC,
  1133.     Xmodem 1K, Xmodem 1KG, Ymodem, Ymodem G, Zmodem, Kermit, and ASCII.
  1134.     TurboTerm also supports 3 external protocols that are completely
  1135.     user-definable, with separate upload and download parameters.
  1136.  
  1137.     All of the protocol options have pre-defined defaults that conform to
  1138.     standard usage, making a change unnecessary in most situations.  Each
  1139.     prompt will be discussed in the following paragraphs.
  1140.  
  1141.  
  1142.     Default Protocol    [Zmodem]
  1143.  
  1144.     Your default protocol is the protocol you are most likely to use for a
  1145.     given file transfer.  Setting this protocol will not force you to use
  1146.     that protocol while in TurboTerm, but will allow quicker file
  1147.     transfers since the protocol will be highlighted in TurboTerm's
  1148.     selection menu when you initiate a transfer.  Simply pressing <ENTER>
  1149.     will initiate the transfer using the selected protocol.  Selecting a
  1150.     default protocol here is not the only place where default protocols
  1151.     may be picked.  Inside TurboTerm, each dialing directory entry may
  1152.     also have its own pre-defined default protocol.
  1153.  
  1154.  
  1155.     Send Directories    [No]
  1156.  
  1157.     This option is used when performing very specific file update requests
  1158.     to a given system.  Under normal circumstances you should leave this
  1159.     option off.  Send Directories instructs TurboTerm to send the complete
  1160.     path and filename in Ymodem, Zmodem, and Kermit file uploads.  This
  1161.     option would be used if you were performing an update of someone
  1162.     else's system remotely, and your subdirectory structure was the same
  1163.     as that on the remote system.  Again, using this feature would only be
  1164.     used when you wished to send the complete filename and path of the
  1165.     file you are sending.  If this option is turned off, TurboTerm will
  1166.     only send the filename.
  1167.  
  1168.  
  1169.     Honor Directories    [No]
  1170.  
  1171.     This option is used in conjunction with Send Directories.  If this
  1172.     option is enabled, it instructs TurboTerm to place the file in the
  1173.     subdirectory that the remote system sends along with the filename.
  1174.     When this option is enabled and the pathname that the remote system
  1175.     sends with the file does not exist, the file transfer will be aborted.
  1176.     This option should never be enabled unless your are downloading files
  1177.     from a specific system with a specific task in mind.
  1178.  
  1179.        WARNING: DO NOT ENABLE THIS OPTION UNLESS YOU ARE SURE OF YOUR FILE
  1180.                 SOURCE, AND FULLY UNDERSTAND ITS CONSEQUENCES.
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.                                          16                          09-01-91
  1188.  
  1189.  
  1190.  
  1191.  TurboTerm 2.0                      TTSetup                         Protocols
  1192.  
  1193.     Download prompt    [Yes]
  1194.  
  1195.     When using batch transfers, it is sometimes desirable to have the
  1196.     files written to a subdirectory other than your default directory.
  1197.     When this feature is enabled, you will be prompted for the download
  1198.     path for all batch transfers (Zmodem, Ymodem, and Kermit).  Disabling
  1199.     this feature will bypass the prompt for batch file transfers, and
  1200.     place all downloaded files in your default download subdirectory.
  1201.  
  1202.  
  1203.     ASCII line pace    [10]
  1204.  
  1205.     The ASCII line pace is the number of milliseconds TurboTerm will pause
  1206.     between lines during ASCII transfers.  The line pace affects uploading
  1207.     using ASCII file transfers and TurboTerm Clipboard transfers.  Adjust
  1208.     this value if the remote system is unable to process a new line at the
  1209.     current rate.  Valid range is from 0 to 9999 msec.
  1210.  
  1211.  
  1212.     ASCII Character pace    [5]
  1213.  
  1214.     The ASCII character pace is the number of milliseconds TurboTerm will
  1215.     pause between characters during ASCII transfers. The character pace
  1216.     affects uploading using ASCII file transfers and TurboTerm Clipboard
  1217.     transfers.  Adjust this value if the remote system is unable to
  1218.     process a new character at the current rate.  Valid range is from 0 to
  1219.     9999 msec.
  1220.  
  1221.  
  1222.     GMT offset    [5]   (Eastern Standard Time)
  1223.  
  1224.     The GMT offset is the number of hours your time zone varies from
  1225.     Greenwich Mean Time.  This value is used when determining the correct
  1226.     file date and time from systems using properly implemented YModem and
  1227.     ZModem protocols.  In many Zmodem & YModem implementations this field
  1228.     is completely ignored, and will not affect the date and time stamp of
  1229.     your files.  Some TurboTerm installations may require that files be
  1230.     updated on a periodic basis from various locations around the world.
  1231.     When both the remote and local system recognize a GMT offset value,
  1232.     and your system is configured to allow only Newer files under ZModem,
  1233.     TurboTerm will only process updates to files that are truly newer than
  1234.     those currently on your system.
  1235.  
  1236.  
  1237.     ZModem options
  1238.  
  1239.     Chuck Forsberg, the designer of the Zmodem protocol, should be
  1240.     recognized here for his superb protocol.  If you don't use Zmodem
  1241.     regularly, then read on and find out why you should!  Zmodem is a
  1242.     streaming protocol that has an average CPS rate 30 to 70 percent
  1243.     faster than all other protocols internal to TurboTerm, with the
  1244.     possible exception of Ymodem G.  Zmodem provides crash recovery
  1245.     ability, allowing you to resume an interrupted file transfer.  ZModem
  1246.     allows either software or hardware flow control for controlling the
  1247.     flow of data, and has its own special file management options that
  1248.     allow you to fully customize the way you receive and send files while
  1249.     connected to remote systems.  Zmodem has one of the best error
  1250.     detection/correction schemes around, and provides the means to
  1251.  
  1252.  09-01-91                                17
  1253.  
  1254.  
  1255.  
  1256.  TurboTerm 2.0                      TTSetup                         Protocols
  1257.  
  1258.     automatically download files without user prompting.  Zmodem has the
  1259.     ability to transfer files in batch mode, facilitating multiple file
  1260.     transfers within a single protocol invocation.
  1261.  
  1262.     The following options control the way the Zmodem implementation
  1263.     operates.
  1264.  
  1265.  
  1266.     Crash recovery    [Yes]
  1267.  
  1268.     Zmodem crash recovery is perhaps the best reason to use Zmodem
  1269.     whenever possible.  This is an extremely handy feature when you are on
  1270.     an unreliable connection.  Imagine you are downloading a 400K file,
  1271.     and have completed 300K so far, when suddenly your modem hangs up the
  1272.     phone line.  With any other protocol, you would have to restart the
  1273.     transfer over from the beginning.  With Zmodem, you can restart from
  1274.     where you left off!  All you have to do is call the host system back,
  1275.     and restart the transfer.  Seriously consider NOT disabling this
  1276.     option.
  1277.  
  1278.  
  1279.     Auto downloading     [Yes]
  1280.  
  1281.     Another handy Zmodem feature is its automatic initiation of a Zmodem
  1282.     file transfer.  When you have this feature enabled and start a Zmodem
  1283.     download from the host system, you will not have to do anything else.
  1284.     Zmodem will automatically start up and perform the transfer.  The
  1285.     file(s) will be placed in your default download directory.
  1286.  
  1287.  
  1288.     Skip if no file    [No]
  1289.  
  1290.     This option allows you to configure Zmodem to allow file updates.
  1291.     If your system does not currently have the file that you are
  1292.     attempting to download, that file will be skipped and NOT downloaded.
  1293.     Be careful when turning this option on.  You may begin to think that
  1294.     Zmodem isn't working correctly if you enable this feature and try to
  1295.     download files that don't already exist on your system.
  1296.  
  1297.  
  1298.     Override sender    [Yes]
  1299.  
  1300.     Zmodem has the ability to let the host system determine where to place
  1301.     the file on your system, and whether or not to overwrite existing
  1302.     files.  (These options are called file management options)  Obviously,
  1303.     under normal circumstances you would not want GEnie or a BBS to decide
  1304.     where on your hard drive to place the file, so you should always
  1305.     override the senders file management options.
  1306.  
  1307.  
  1308.     Management options     [Newer/Longer]
  1309.  
  1310.     Zmodem has a variety of file management options that will allow you to
  1311.     customize how and when files get written to your hard drive during a
  1312.     download, and to request certain file management options from the host
  1313.     system when you are uploading.
  1314.  
  1315.  
  1316.  
  1317.                                          18                          09-01-91
  1318.  
  1319.  
  1320.  
  1321.  TurboTerm 2.0                      TTSetup                         Protocols
  1322.  
  1323.         Newer/Longer
  1324.  
  1325.         Instructs Zmodem to allow only new files, or files that are newer
  1326.         or longer than the file currently on your system.
  1327.  
  1328.         Append
  1329.  
  1330.         Instructs Zmodem to allow only files that are new, and to append
  1331.         to files that already exist.  This is not to be confused with
  1332.         crash recovery.
  1333.  
  1334.         Always
  1335.  
  1336.         Instructs Zmodem to always accept the file regardless of the file
  1337.         size or date, and overwrite any file of the same name currently in
  1338.         the specified download path.
  1339.  
  1340.         Newer
  1341.  
  1342.         Instructs Zmodem to accept only files that are new or newer than
  1343.         files of the same name currently on your system.
  1344.  
  1345.         Different
  1346.  
  1347.         Instructs Zmodem to accept only new files, or files by the same
  1348.         name that exist on your system with different file sizes or dates.
  1349.  
  1350.         Protect
  1351.  
  1352.         Instructs Zmodem to only accept files that are new.
  1353.  
  1354.     The default option [Newer/Longer] should be sufficient for most Zmodem
  1355.     transfers.  The other options would be used in a very specific job,
  1356.     and should only be set if you are familiar with the consequences of
  1357.     each option.
  1358.  
  1359.  
  1360.  
  1361.     Kermit Options
  1362.  
  1363.     The TurboTerm Kermit implementation is the only internal binary file
  1364.     transfer protocol that is capable of transmitting over a line with
  1365.     line settings other than N81.  Kermit will work on N81 or E71
  1366.     connections.  This is not to say that if you are logged onto GEnie at
  1367.     E71, that you must use Kermit (highly difficult since GEnie does not
  1368.     support Kermit), but it does mean that TurboTerm will not
  1369.     automatically switch to N81 when performing Kermit file transfers.
  1370.  
  1371.     Under most circumstances, you should never have to adjust the Kermit
  1372.     options.  Under some specialized circumstances, you may have to adjust
  1373.     these options to allow transfers to occur properly between the wide
  1374.     range of Kermit implementations.
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  09-01-91                                19
  1383.  
  1384.  
  1385.  
  1386.  TurboTerm 2.0                      TTSetup                         Protocols
  1387.  
  1388.     Maximum packet length    [80]
  1389.  
  1390.     The maximum packet length is the number of characters per data
  1391.     subpacket transferred during a Kermit transfer.  The allowable range
  1392.     is from 0 to 91.
  1393.  
  1394.  
  1395.     Pad count    [000]
  1396.  
  1397.     The pad count is the number of pad characters to send between each
  1398.     Kermit datapacket.  The only time you might need padding is when the
  1399.     remote system requires a delay between sending you a packet and being
  1400.     able to accept a packet itself.  TurboTerm will automatically adjust
  1401.     this value to the pad count requested by the remote, so adjusting this
  1402.     value should only be necessary with Kermit implementations that do not
  1403.     realize that they require padding.
  1404.  
  1405.  
  1406.     Pad Character    [0]
  1407.  
  1408.     The pad character is the character that TurboTerm will use to pad each
  1409.     successive Kermit datapacket.  This value is ASCII value of the pad
  1410.     character. Range: 0 through 255.
  1411.  
  1412.  
  1413.     Terminator character    [13]
  1414.  
  1415.     The terminator character is the last character following the check
  1416.     character in a Kermit datapacket.  The terminator character is used by
  1417.     systems that require an end of line character before they can start
  1418.     processing input.  This value is the ASCII value for the terminator
  1419.     character.  Range 0 through 255.
  1420.  
  1421.  
  1422.     High bit prefix     [089]
  1423.  
  1424.     The high bit prefix is the character prefix that Kermit will use when
  1425.     transforming high bit characters (when using 7 data bits) into
  1426.     characters without the high bit set.  Normally you will not need to
  1427.     adjust this prefix.  This value is the ASCII value for the high bit
  1428.     prefix.  Range 0 through 255.
  1429.  
  1430.  
  1431.     Control prefix     [35]
  1432.  
  1433.     The control prefix is the character prefix that Kermit will use when
  1434.     transforming control characters into printable ASCII characters.
  1435.     Normally this value does not need to be changed.  This value is the
  1436.     ASCII value for the control prefix.  Range 0 through 255.
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.                                          20                          09-01-91
  1448.  
  1449.  
  1450.  
  1451.  TurboTerm 2.0                      TTSetup                         Protocols
  1452.  
  1453.     Maximum timeout    [5]
  1454.  
  1455.     The maximum timeout value is the amount of time in seconds that Kermit
  1456.     will wait for a new packet or the next byte of data.  If this time
  1457.     period elapses without a response, then TurboTerm will assume that an
  1458.     error has occurred, and will re-send its last packet.  Range 0-99
  1459.     seconds.
  1460.  
  1461.  
  1462.     Error check     [1 byte checksum]
  1463.  
  1464.     The error check type is the type of data integrity checking used
  1465.     by default during a Kermit transfer.  1 Byte checksum is supported by
  1466.     all Kermit implementations.  2 byte checksum is a slightly more
  1467.     reliable error checking type, and 3 byte CRC is the most reliable form
  1468.     of Kermit error checking available, but is not supported in all Kermit
  1469.     implementations.
  1470.  
  1471.  
  1472.     Restore Kermit defaults
  1473.  
  1474.     This option should be used to return the Kermit options to the
  1475.     installed TurboTerm defaults.
  1476.  
  1477.  
  1478.  
  1479.     User protocol options
  1480.  
  1481.     In the unlikely event that you find a protocol driver superior to
  1482.     those provided internally in TurboTerm, or if you wish to try out that
  1483.     new ABCmodem protocol, TurboTerm provides a convenient way for you to
  1484.     do so.  TurboTerm will allow you to define up to three separate
  1485.     protocols, each with their own distinct upload and download
  1486.     parameters.  User protocols are handled similar to the method employed
  1487.     for user shells, with two minor differences.  Since most external
  1488.     protocols require different command line switches for uploading and
  1489.     downloading, TurboTerm provides a place where both sets of parameters
  1490.     may be specified.  This is different than the user shells where only
  1491.     one set of parameters may be specified.  The other minor difference is
  1492.     that TurboTerm will not prompt you to 'Press any key to return to
  1493.     TurboTerm' when shelling to an external protocol.  We assume that
  1494.     after completing any binary file transfer you will want to return
  1495.     immediately to the comfort and familiarity of TurboTerm.
  1496.  
  1497.     Lets say you wish to use DSZ (Chuck Forsberg's Zmodem driver) for all
  1498.     of your Zmodem file transfers, and you want DSZ to show up as a valid
  1499.     protocol in your download and upload pick lists inside TurboTerm.  The
  1500.     following discussion will assume that you are currently running on
  1501.     COM2 at 2400 baud.  If your setup is different than this, you will
  1502.     need to change some or all of the parameters listed below.
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  09-01-91                                21
  1513.  
  1514.  
  1515.  
  1516.  TurboTerm 2.0                      TTSetup                         Protocols
  1517.  
  1518.       - Select 'User protocol 1'
  1519.  
  1520.           Type in the full path and filename of DSZ.
  1521.  
  1522.           Example: C:\UTILS\DSZ.COM
  1523.  
  1524.       - Select user protocol 1 upload parameters.
  1525.  
  1526.           Type in your upload parameters.
  1527.  
  1528.           Example: port 2 -r sz
  1529.  
  1530.             In this case you would not want to specify your filenames here
  1531.             inside TTSetup.  Just prior to shelling to this protocol
  1532.             driver, TurboTerm will prompt you for any further parameters,
  1533.             and it is at this point that you will type in the filename(s).
  1534.  
  1535.       - Select user protocol 1 download parameters.
  1536.  
  1537.         Type in your download parameters.
  1538.  
  1539.           Example: 1 2400 rz
  1540.  
  1541.             Since DSZ's Zmodem automatically gets the filename from the
  1542.             sending system, no file name should be specified on this
  1543.             command line, either.  Again, TurboTerm will prompt you for
  1544.             any additional parameters just prior to executing this shell.
  1545.  
  1546.       - Select protocol name
  1547.  
  1548.         Type in DSZ, or whatever best describes the protocol you are
  1549.         installing.  You are limited to 10 characters for the name.
  1550.  
  1551.       - That's it.  You have successfully installed DSZ as an external
  1552.         protocol.
  1553.  
  1554.      Some common mistakes:
  1555.  
  1556.           - You didn't properly type in the filename and path of the DSZ
  1557.             program.
  1558.  
  1559.           - You don't have a copy of DSZ on your system.
  1560.  
  1561.           - Your upload/download parameters are incorrect for your system
  1562.             setup.
  1563.  
  1564.           - You have insufficient free memory to run the external
  1565.             protocol. (see the section on memory management below)
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.                                          22                          09-01-91
  1578.  
  1579.  
  1580.  
  1581.  TurboTerm 2.0                      TTSetup                           Options
  1582.  
  1583.  
  1584.     This menu selection will allow you to customize the various operating
  1585.     parameters of TurboTerm to best suit your individual taste, and
  1586.     conform to your system's requirements.
  1587.  
  1588.  
  1589.     Connect Sounds    [Yes]
  1590.  
  1591.     This toggles whether you will be alerted upon connecting to a system
  1592.     listed in your dialing directory.
  1593.  
  1594.  
  1595.     Warning sounds    [Yes]
  1596.  
  1597.     This controls whether you are audibly warned when attempting an
  1598.     operation that cannot currently be performed in TurboTerm.  TurboTerm
  1599.     uses this check to determine if any sounds will be generated on any of
  1600.     these attempts.  Some sample circumstances where TurboTerm would
  1601.     produce this sound are listed below:
  1602.  
  1603.            - You attempt to scroll past the beginning or end of the
  1604.              scrollback buffer.
  1605.  
  1606.            - You attempt to recall a command in the chat recall buffer
  1607.              beyond the recall buffer limit.
  1608.  
  1609.            - You attempt to change to ANSI emulation <Alt-Y> when in split
  1610.              screen (buffered) mode.
  1611.  
  1612.            - You attempt to use the dialing directory <Alt-D> when you
  1613.              have TurboTerm's null modem feature active.
  1614.  
  1615.            - You attempt to search scrollback <Alt-F> when scrollback is
  1616.              not currently being displayed on screen.
  1617.  
  1618.            - You attempt to change your chat mode options <Alt-G> when
  1619.              chat mode is not active.
  1620.  
  1621.            - You attempt to edit a chat buffer command <Alt-V> when not in
  1622.              chat mode.
  1623.  
  1624.  
  1625.  
  1626.     Auto log usage    [No]
  1627.  
  1628.     Turning this option on will force all connections to remote systems
  1629.     to be logged to the default usage log.  When this option is off, no
  1630.     usage logs will be created, except for those that are specifically
  1631.     designated in the dialing directory entries.  For a detailed
  1632.     description of TurboTerm's usage logs, refer to Appendix B.
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  09-01-91                                23
  1643.  
  1644.  
  1645.  
  1646.  TurboTerm 2.0                      TTSetup                           Options
  1647.  
  1648.     Verbose usage    [Yes]
  1649.  
  1650.     When this option is on, all usage files will be written in the verbose
  1651.     format.  Refer to the descriptions in Appendix B for verbose and brief
  1652.     usage logs.
  1653.  
  1654.  
  1655.     Scroll size    [9]
  1656.  
  1657.     This option controls the number of lines in scrollback that will be
  1658.     displayed on the screen when entering scrollback.  This number does
  1659.     NOT affect the size of the scrollback window when ANSI emulation is
  1660.     turned on.  In ANSI emulation, the scrollback window is always full
  1661.     screen, since the ANSI specification requires (at least) a 24 line
  1662.     terminal window.  When inside TurboTerm this number can be adjusted
  1663.     using the <Ctrl-PgUp> and <Ctrl-PgDn> keys.  The new value set while
  1664.     inside TurboTerm is only in effect for the current TurboTerm session,
  1665.     and is reset to the configuration value during all subsequent
  1666.     sessions.
  1667.  
  1668.  
  1669.     Dialer timeout    [30]
  1670.  
  1671.     This is the number of seconds TurboTerm will wait for a connection or
  1672.     error response during a dialing attempt, before initiating a redial.
  1673.  
  1674.  
  1675.     Recycle delay    [5]
  1676.  
  1677.     This is the number of seconds TurboTerm will wait between dial
  1678.     attempts.
  1679.  
  1680.  
  1681.     Emulation     [TTY]
  1682.  
  1683.     The emulation is the way TurboTerm will interpret incoming characters
  1684.     and place them on the screen.  TurboTerm has four built-in terminal
  1685.     emulations: TTY, ANSI, DEBUG_ASCII, and DEBUG_HEX.  Only TTY or ANSI
  1686.     may be selected as the default terminal emulation.  The two debug
  1687.     emulations are used for trying to determine the exact character
  1688.     sequence that a remote system is sending, and can be useful when
  1689.     attempting to debug a particular script or program.
  1690.  
  1691.  
  1692.         TTY:
  1693.  
  1694.         TTY terminal emulation emulates the old-style teletypewriters, and
  1695.         offers no special color options.  It is a character-only based
  1696.         terminal emulation.  TTY emulation is sometimes referred to as a
  1697.         dumb terminal since it does no interpretation of the incoming
  1698.         characters, and does not allow cursor positioning or color
  1699.         changes.
  1700.  
  1701.         ANSI:
  1702.  
  1703.         The ANSI (American National Standards Institute) driver in
  1704.         TurboTerm is a subset of the full ANSI terminal standard, and
  1705.         conforms to the IBM ANSI.SYS driver specification.  The ANSI
  1706.  
  1707.                                          24                          09-01-91
  1708.  
  1709.  
  1710.  
  1711.  TurboTerm 2.0                      TTSetup                           Options
  1712.  
  1713.         specification requires that the terminal screen be 24 rows by 80
  1714.         columns.  ANSI emulation interprets incoming characters and
  1715.         processes any escape sequences to determine cursor positioning
  1716.         and color attributes.  You will commonly find ANSI emulation in
  1717.         use on private BBS systems around the country.  GEnie and
  1718.         Compuserve make very little use of the ANSI specification.  Unless
  1719.         you have a specific need for ANSI when on these systems, it is
  1720.         recommended to use TTY terminal emulation.
  1721.  
  1722.         DEBUG_ASCII:
  1723.  
  1724.         The DEBUG_ASCII emulation is used when trying to determine the
  1725.         exact sequence or character string that a remote system is
  1726.         sending.  Debug_Ascii will display all printable characters (ASCII
  1727.         32 through 255) normally and place all control or non-printable
  1728.         characters in brackets ([]) to help you determine the actual
  1729.         string being sent by the remote system.
  1730.  
  1731.         DEBUG_HEX:
  1732.  
  1733.         The DEBUG_HEX emulation is similar to the DEBUG_ASCII emulation
  1734.         except that ALL received characters are displayed with their
  1735.         corresponding hexadecimal values in brackets ([]).
  1736.  
  1737.  
  1738.     Macros
  1739.  
  1740.     A macro is a pre-defined string.  Under many circumstances, you will
  1741.     find it useful to have certain strings saved so that you can quickly
  1742.     recall them without having to manually retype the line.  TurboTerm
  1743.     allows up to ten macros to be active at any given time, but you can
  1744.     have as many macro files (each with 10 pre-defined strings) as disk
  1745.     space allows on your system.  Each of the macros in TurboTerm is
  1746.     played back by pressing the corresponding function key (F1 - F10) on
  1747.     your keyboard.  Each macro may contain up to 255 characters, including
  1748.     any imbedded control characters.  Multiple line macros can be formed
  1749.     by imbedding carriage returns inside a given macro.  TurboTerm's macro
  1750.     editor has many special commands to allow quick and efficient editing.
  1751.     Refer to the <Alt-V> section in this manual for further instructions
  1752.     on editing.  Two other specialized macros can also be defined.  These
  1753.     macros are GEnie specific and only work in GEnie Chat Lines & GEnie
  1754.     RTC split-screen (buffered) modes.  The AFK and Auto-Greet macros
  1755.     follow the same limits as the F1-F10 macros on length and imbedded
  1756.     control characters.  Each macro file must reside in your TurboTerm
  1757.     directory, and must have a file extension of .KEY.
  1758.  
  1759.  
  1760.  
  1761.     Macro File    [TT.KEY]
  1762.  
  1763.     The macro filename you specify here is the default macro file you
  1764.     wish be active upon program initialization.  As an added convenience,
  1765.     macro files may be edited inside TTSetup or from within TurboTerm.  To
  1766.     change the default macro file, select File and type in the filename of
  1767.     the macro file you wish to load by default.
  1768.  
  1769.  
  1770.  
  1771.  
  1772.  09-01-91                                25
  1773.  
  1774.  
  1775.  
  1776.  TurboTerm 2.0                      TTSetup                           Options
  1777.  
  1778.     F1-F10 Macros    [Empty]
  1779.  
  1780.     The F1-F10 macros are configured by selecting the macro you wish to
  1781.     edit, then using the editor commands to fill in the appropriate text.
  1782.  
  1783.  
  1784.     AFK Macro    [I'm sorry, I am currently AFK, please try again later]
  1785.  
  1786.     The AFK macro is used in GEnie Chat Lines or GEnie RTC's to alert
  1787.     people that send you private messages that you are away from your
  1788.     keyboard.  When TurboTerm senses that you have received an incoming
  1789.     private message, it will automatically send this string in response to
  1790.     the sender in a private message while the AFK feature is active.  The
  1791.     AFK message may contain any phrase, and we encourage you to customize
  1792.     yours to fit your personality.  One of the more humorous AFK macros
  1793.     spotted during the beta cycle was:  "Holy cow!!!!  Just as your /SEN
  1794.     arrived my monitor burst into flames!  I'll be right back...".  We do
  1795.     not recommend, of course, continuing a telecommunications session if
  1796.     your equipment is malfunctioning in this manner.
  1797.  
  1798.  
  1799.     Auto-Greet Macro    [Hi {Handle}!]
  1800.  
  1801.     The auto greet macro is used when you wish to seem cordial or friendly
  1802.     to anyone who happens to drop by your current channel or conference
  1803.     room.  Again, this is a specialized macro that only works in GEnie
  1804.     Chat Lines and GEnie RTC's.  Since it seems more cordial to greet a
  1805.     person by his/her handle, the Auto-Greet may contain a special
  1806.     indicator, showing where TurboTerm should insert the handle.  You can
  1807.     specify where in the Auto-Greet string you wish to place the handle of
  1808.     the person that just entered the channel by placing the special
  1809.     keyword {Handle} somewhere in the Auto-Greet string.  If {Handle} is
  1810.     not specified then the Auto-Greeter will simply display the message
  1811.     without a handle.  The Auto-Greeter can be very useful when you are
  1812.     hosting a discussion, or chairing a conference.
  1813.  
  1814.       Example:
  1815.  
  1816.         "{Handle}, welcome to the support conference.  If you have any
  1817.         questions, feel free to ask."
  1818.  
  1819.  
  1820.     File Names
  1821.  
  1822.     Almost all file names that TurboTerm uses can be configured to suit
  1823.     your needs.  The only exceptions to this rule are:
  1824.  
  1825.          -  All phone files must have a .FON extension.
  1826.  
  1827.          -  All macro files must have a .KEY extension.
  1828.  
  1829.          -  The TurboTerm configuration file must be called TT.CFG
  1830.  
  1831.     The names that you specify in TTSetup will be the default filenames
  1832.     for your capture logs, phone file, scrollback save files, and usage
  1833.     logs.
  1834.  
  1835.  
  1836.  
  1837.                                          26                          09-01-91
  1838.  
  1839.  
  1840.  
  1841.  TurboTerm 2.0                      TTSetup                           Options
  1842.  
  1843.     Log File    [TT.LOG]
  1844.  
  1845.     This is the default name to use for all capture logs.  Capture logs
  1846.     are not to be confused with usage logs.  Capture logs are a capture of
  1847.     the telecommunications session.  When a log file is turned on, all
  1848.     information received through the port will be written to the
  1849.     specified file.  This is especially useful if you are browsing through
  1850.     some material and wish to save it for later viewing.  When in
  1851.     TurboTerm, logging to disk is activated by typing <Alt-L>.  If the
  1852.     file that you specify here already exists, you will be prompted to
  1853.     Append, Overwrite, or start a New log file.  All LOG files will be
  1854.     written to your LOG directory.
  1855.  
  1856.  
  1857.     Phone file    [TT.FON]
  1858.  
  1859.     This is the file that contains phone numbers and other information for
  1860.     all your frequently called numbers.  The phone file contains various
  1861.     information that will allow you to customize each session without
  1862.     changing your defaults inside TTSetup.  The extension of all phone
  1863.     files must be .FON.  All phone files will be written to your TurboTerm
  1864.     directory.
  1865.  
  1866.  
  1867.     Scroll back    [TT.SBK]
  1868.  
  1869.     This is the default file name that TurboTerm will use when you choose
  1870.     to save the contents of your scrollback buffer to disk.  If the file
  1871.     already exists, TurboTerm will prompt you to Append, Overwrite, or
  1872.     start a New scroll back file.  All scroll back files will be written
  1873.     to your TurboTerm directory.
  1874.  
  1875.  
  1876.     Usage file    [TT.USE]
  1877.  
  1878.     This is the default name for TurboTerm to use when a request for a
  1879.     usage log is made via the dialing directory or when the Auto-Log
  1880.     parameter is active.  This filename has no effect on usage log names
  1881.     that are specified in the dialing directory.  All usage logs are
  1882.     written to your LOG directory.
  1883.  
  1884.  
  1885.  
  1886.     Chat options
  1887.  
  1888.     This option will allow you to change the behavior of split screen
  1889.     operations inside TurboTerm.  TurboTerm's split screen mode has three
  1890.     possible configurations:  GEnie Chat, GEnie RTC, and Normal.  With
  1891.     this option you can customize your split screen operations to suit
  1892.     your personal taste.  Each mode has a specific way of handling/parsing
  1893.     incoming text, and you must select the correct mode based on your
  1894.     current situation.  All of these options can also be set inside
  1895.     TurboTerm.
  1896.  
  1897.  
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  09-01-91                                27
  1903.  
  1904.  
  1905.  
  1906.  TurboTerm 2.0                      TTSetup                           Options
  1907.  
  1908.     Chat mode    [GEnie Chat]
  1909.  
  1910.        Normal:
  1911.  
  1912.           This mode of split screen operation does no parsing of the
  1913.           incoming text, and disables the specialized GEnie functions
  1914.           like Auto-Show, Auto-Greet, Alert, Die Roller, and AFK Mode.
  1915.  
  1916.  
  1917.        GEnie Chat:
  1918.  
  1919.           This mode of split screen operation parses incoming text and
  1920.           waits for private sends, new logons or monitorings, and die roll
  1921.           requests.  The state of the toggles explained below determine
  1922.           which options will be active by default, when in GEnie Chat
  1923.           mode.
  1924.  
  1925.  
  1926.        GEnie RTC:
  1927.  
  1928.           This mode of split screen operation parses incoming text and
  1929.           waits for private sends, new logons or monitorings, and die roll
  1930.           requests.  The state of the toggles explained below determine
  1931.           which options will be active by default, when in GEnie RTC
  1932.           mode.
  1933.  
  1934.  
  1935.     Auto-Show    [No]
  1936.  
  1937.     Auto show is a GEnie-specific function, that will automatically
  1938.     perform a /SHO command whenever someone enters or monitors your
  1939.     channel.  The return information from GEnie will be highlighted in
  1940.     your terminal highlight color.  Toggling this option enables/disables
  1941.     the default setting of the Auto-Show feature.
  1942.  
  1943.  
  1944.     Auto-Greet    [No]
  1945.  
  1946.     Auto-Greet is a GEnie-specific function that automatically greets
  1947.     visitors to your channel or conference room, and waves at those that
  1948.     monitor your channel.  The Auto-Greet feature can be further
  1949.     configured by altering your Auto-Greet macro, discussed in the macro
  1950.     section of this manual.  Toggling this option enables/disables the
  1951.     default setting of the Auto-Greet feature.
  1952.  
  1953.  
  1954.     Alert    [Yes]
  1955.  
  1956.     The alert feature is a GEnie-specific function that controls whether
  1957.     TurboTerm will sound a tone every time a private message is sent to
  1958.     you.  This is quite useful on busy channels, where you might miss the
  1959.     private message.  The tone will alert you that a private message was
  1960.     sent to you, so that you may respond accordingly.  While all other
  1961.     GEnie-specific options work only in split screen mode, this option
  1962.     also controls one other feature of TurboTerm.  With this toggle set to
  1963.     Yes, you will also be alerted of any  notifies that you receive while
  1964.     on GEnie.
  1965.  
  1966.  
  1967.                                          28                          09-01-91
  1968.  
  1969.  
  1970.  
  1971.  TurboTerm 2.0                      TTSetup                           Options
  1972.  
  1973.     Die roller    [No]
  1974.  
  1975.     The die roller is a GEnie-specific function that allows anyone
  1976.     currently on your channel to roll a specific number of dice by simply
  1977.     typing an appropriate command. (.r##d###[+/-##])  This will instruct
  1978.     TurboTerm to respond with a random die roll meeting the request.  The
  1979.     modifier is the only optional parameter.
  1980.  
  1981.         Example:
  1982.  
  1983.         Suppose your handle was <Dungeon Master> and <CrystalStar> wanted to
  1984.         roll five ten-sided dice.
  1985.  
  1986.         <CrystalStar> .r5d10+5
  1987.         <Dungeon Master> CrystalStar: 5 + 3 + 6 + 7 + 2 = 23 Modified: 28
  1988.  
  1989.         This example shows the requestor's name, followed by the die roll
  1990.         results.  The modifier, if present, is added to (or subtracted
  1991.         from) the combined total of the rolled dice and reported as well.
  1992.  
  1993.     Any roll that does not meet the limits of TurboTerm's die roller will
  1994.     display an invalid roll message and an example of the correct syntax.
  1995.  
  1996.  
  1997.     AFK Mode    [NO]
  1998.  
  1999.     The AFK mode is a GEnie-specific function that determines whether the
  2000.     AFK macro will automatically be sent in reply to all private /SEN's.
  2001.     It is not recommended that this mode be active by default, but the
  2002.     ability exists for specific implementations.
  2003.  
  2004.  
  2005.     Window Options
  2006.  
  2007.     This allows you to customize the look and feel of the pop-up windows
  2008.     inside TurboTerm.  TurboTerm windows are capable of shadowing effect,
  2009.     exploding window effects, and sound effects.  These options may be
  2010.     configured to suit your tastes.
  2011.  
  2012.  
  2013.     Exploding windows    [Yes]
  2014.  
  2015.     Having this option on will cause all new pop-up windows in TurboTerm
  2016.     to appear to "grow" from the center of the screen, and to shrink in
  2017.     an opposite manner when the window is removed.  In many of today's
  2018.     applications, exploding windows are commonplace.  If you wish to
  2019.     disable exploding windows, then set this option to NO.
  2020.  
  2021.  
  2022.     Sound Effects    [No]
  2023.  
  2024.     Sound effects are the accompanying sounds to the exploding windows.
  2025.     If exploding windows are turned on, then enabling sound effects will
  2026.     cause a tone to accompany all exploding windows.  The longer the
  2027.     window takes to explode, the longer the sound/tone will be.
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  09-01-91                                29
  2033.  
  2034.  
  2035.  
  2036.  TurboTerm 2.0                      TTSetup                           Options
  2037.  
  2038.     Window Shadows    [Yes]
  2039.  
  2040.     All of TurboTerm's windows are capable of having a shadow.  This
  2041.     shadow makes that window appear to be raised from the surface of the
  2042.     screen behind it.  The shadow itself will not obscure any of the text
  2043.     below it.
  2044.  
  2045.  
  2046.     Window Delay    [2]
  2047.  
  2048.     On slower machines, the exploding windows can be agonizingly slow.
  2049.     The window delay is a user-defined factor which controls the length of
  2050.     the window delay.  The lower the number, the faster the window will
  2051.     explode onto the screen.  Range: 0 - 20.
  2052.  
  2053.  
  2054.  
  2055.     Memory Usage
  2056.  
  2057.     The memory usage option allows you to configure the way that
  2058.     TurboTerm will execute other programs.  TurboTerm has the ability to
  2059.     perform two styles of program execution; shelling and swapping.
  2060.     Shelling is a method in which TurboTerm will free up as much memory as
  2061.     possible, and execute a secondary program.  While this method is the
  2062.     fastest way to execute other programs from inside TurboTerm, the
  2063.     available memory for the child program could be as low as 100k.  If
  2064.     you plan on running only very small programs from inside TurboTerm
  2065.     (such as LIST.COM) then shelling may be right for you.  On the other
  2066.     hand, when you have programs that require large amounts of memory to
  2067.     run, and you would still like to be able to have access to them from
  2068.     inside TurboTerm, then you should enable swapping.  TurboTerm has the
  2069.     ability to write an image of itself to EMS 4.0 or to disk.  This frees
  2070.     up all but approximately 55K of your regular memory for other programs
  2071.     to run.  Swapping to a floppy disk is not allowed, as the speed of
  2072.     floppy drives is not sufficiently fast enough to make swapping a
  2073.     viable choice.  If you have a hard drive, a ram drive, or EMS 4.0
  2074.     compliant memory with approximately 400k available, then swapping is
  2075.     the preferred solution.  Swapping takes slightly longer than shelling
  2076.     (especially on a slow hard drive), but the advantage is that you
  2077.     shouldn't encounter insufficient memory messages when attempting to
  2078.     run any of your applications.  You should also note that TurboTerm
  2079.     MUST turn off the communications port prior to swapping to disk.  Upon
  2080.     returning from a swap, TurboTerm will re-initialize your communication
  2081.     port to the settings that were in effect prior to initiating the swap.
  2082.  
  2083.  
  2084.     Allow Swapping    [No]
  2085.  
  2086.     When this option is enabled TurboTerm will write an image of itself
  2087.     to EMS 4.0 or disk, based on the next two options.  This image file
  2088.     can be as large as 400K, so you must have at least that much free disk
  2089.     space or EMS, to successfully swap.  When swapping is turned off, a
  2090.     normal shell is performed, which will significantly reduce the amount
  2091.     of available memory available to your application.  If, for any
  2092.     reason, TurboTerm is unable to shell or swap, a message explaining the
  2093.     reason will be displayed.
  2094.  
  2095.  
  2096.  
  2097.                                          30                          09-01-91
  2098.  
  2099.  
  2100.  
  2101.  TurboTerm 2.0                      TTSetup                           Options
  2102.  
  2103.     Use EMS for swap    [No]
  2104.  
  2105.     If your system has at least 400K of EMS 4.0 memory, then you should
  2106.     use this option to optimize swapping.  Your EMS driver must be EMS 4.0
  2107.     compliant.  Known EMS drivers that work with TurboTerm are 386Max,
  2108.     QEMM386, and EMM386.  All of these drivers have been successfully
  2109.     tested with TurboTerm.  Some EMS cards for XT & AT class machines will
  2110.     work as well.  We recommend that you first try using EMS for swapping,
  2111.     but if TurboTerm does not successfully swap to your EMS memory, this
  2112.     option should be disabled.  Enabling this option when you do not have
  2113.     any EMS memory should not cause a problem with TurboTerm, since it
  2114.     checks for sufficient EMS memory prior to swapping.
  2115.  
  2116.  
  2117.     Swap path    [TurboTerm directory]
  2118.  
  2119.     As mentioned before TurboTerm has the ability to swap to disk.  If you
  2120.     are running TurboTerm from a slow hard drive or floppy system, and you
  2121.     wish to have TurboTerm write its image file out to a faster hard drive
  2122.     or to a ram drive (recommended), then set this option to the desired
  2123.     destination.  TurboTerm has been successfully tested with DOS 3.3's
  2124.     VDisk and DOS 4.x/DOS 5.0's Ramdrive.  Both of these programs allow
  2125.     you to create a ramdrive from either Extended or Expanded memory.  If
  2126.     your system is equipped with extended memory, a ram drive is
  2127.     recommended.  For those that have EMS memory that TurboTerm cannot
  2128.     access, this is option suggests another solution.  Set up a ram drive
  2129.     in your EMS memory, and point your swap path to that ram drive.  For
  2130.     information on setting up a ram disk, refer to Appendix A.
  2131.  
  2132.  
  2133.  
  2134.     Clipboard options
  2135.  
  2136.     The TurboTerm Clipboard is one of the more powerful features of
  2137.     TurboTerm.  It allows you to edit standard text files, as well as cut
  2138.     and paste from your current telecommunications session.  To allow you
  2139.     to utilize the clipboard to meet your specific needs, TTSetup provides
  2140.     the means to configure many of the clipboard's functions.
  2141.  
  2142.  
  2143.     Insert mode    [Yes]
  2144.  
  2145.     This option determines whether the clipboard will be in insert or
  2146.     overwrite mode when you first enter the clipboard.
  2147.  
  2148.  
  2149.     Word wrap mode    [Yes]
  2150.  
  2151.     This option determines whether text that you type in the clipboard
  2152.     will automatically wrap to the next line when you reach the right
  2153.     margin.
  2154.  
  2155.  
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161.  
  2162.  09-01-91                                31
  2163.  
  2164.  
  2165.  
  2166.  TurboTerm 2.0                      TTSetup                           Options
  2167.  
  2168.     Indent mode     [No]
  2169.  
  2170.     This option determines whether the clipboard will automatically follow
  2171.     the previous line's indent.
  2172.  
  2173.  
  2174.     Warning Time    [2]
  2175.  
  2176.     This option specifies the amount of time (in minutes) that will pass
  2177.     while you are in the Clipboard, before TurboTerm issues a warning
  2178.     tone.  This option is useful when you find yourself in TurboTerm's
  2179.     clipboard longer than the timeout value on the remote system.  This
  2180.     warning tone will alert you that it is time to exit the clipboard and
  2181.     resume your remote session.  Setting this value to 0 will disable the
  2182.     warning tone.
  2183.  
  2184.  
  2185.  
  2186.  
  2187.  
  2188.  
  2189.  
  2190.  
  2191.  
  2192.  
  2193.  
  2194.  
  2195.  
  2196.  
  2197.  
  2198.  
  2199.  
  2200.  
  2201.  
  2202.  
  2203.  
  2204.  
  2205.  
  2206.  
  2207.  
  2208.  
  2209.  
  2210.  
  2211.  
  2212.  
  2213.  
  2214.  
  2215.  
  2216.  
  2217.  
  2218.  
  2219.  
  2220.  
  2221.  
  2222.  
  2223.  
  2224.  
  2225.  
  2226.  
  2227.                                          32                          09-01-91
  2228.  
  2229.  
  2230.  
  2231.  TurboTerm 2.0                      TTSetup                              Exit
  2232.  
  2233.  
  2234.     Once you have made the necessary changes to your TurboTerm
  2235.     configuration file, you should exit and save your changes.  If you
  2236.     wish to abandon any changes that you made while in the program, select
  2237.     Abandon on the exit menu.  If you select Abandon, none of the changes
  2238.     will be saved, and your old setup will remain in effect.
  2239.  
  2240.  
  2241.  
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.  
  2249.  
  2250.  
  2251.  
  2252.  
  2253.  
  2254.  
  2255.  
  2256.  
  2257.  
  2258.  
  2259.  
  2260.  
  2261.  
  2262.  
  2263.  
  2264.  
  2265.  
  2266.  
  2267.  
  2268.  
  2269.  
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  09-01-91                                33
  2293.  
  2294.  
  2295.  
  2296.  TurboTerm 2.0                 Program Reference
  2297.  
  2298.  
  2299.     TurboTerm has many advanced features available from within the
  2300.     terminal itself.  Each of these features is described in the
  2301.     paragraphs that follow.
  2302.  
  2303.  
  2304.     Prefix      <Alt-A>
  2305.  
  2306.     TurboTerm's built-in prefix function has a dual purpose in TurboTerm.
  2307.     Each line transmitted from the TurboTerm Clipboard via <Alt-F6>
  2308.     (transmit) or <Alt-F7> (*UPLOAD) will first be appended to the defined
  2309.     prefix (when active), then sent to the remote system.  This allows
  2310.     TurboTerm users a handy "quote feature", if one is not implemented on
  2311.     the remote system.  In a similar fashion, each line typed in buffered
  2312.     mode (Alt-B) will be appended to the defined prefix string (when
  2313.     active), prior to being sent to the remote system.  This gives
  2314.     TurboTerm users the ability to easily carry on a private conversation
  2315.     in GEnie's RTC or Chat Lines, and can also make game playing in those
  2316.     environments quite a bit easier.
  2317.  
  2318.     To edit your current prefix, type <Alt-A>.  A small menu will appear
  2319.     showing your current prefix and three choices:
  2320.  
  2321.           <A>ctivate,  <D>eactivate, and <E>dit.
  2322.  
  2323.     From this menu, you can toggle the state of your prefix, or edit the
  2324.     prefix string.  Editing the prefix will automatically activate it, so
  2325.     there is no need to call up this menu again to activate a prefix
  2326.     string you just finished defining.  To deactivate the prefix string
  2327.     without redefining or erasing it, simply use the deactivate option on
  2328.     this menu.  The prefix string will remain intact, but inactive.  To
  2329.     activate the prefix again, use the activate option on this menu.
  2330.  
  2331.     If you do not wish to continuously deactivate and reactivate your
  2332.     prefix, you may override its operation on a line-by-line basis by
  2333.     beginning the line with a '/' character.  Since all commands in
  2334.     GEnie's RTC and Chat Lines software begin with this character, this
  2335.     allows you to access those commands without the need of first
  2336.     deactivating the prefix.  Beginning the line with a '/' followed by a
  2337.     space will allow you to send a normal line without the prefix.  Since
  2338.     GEnie interprets any line beginning with a '/' as a command, both the
  2339.     '/' and the space are trimmed from the beginning of the line, and the
  2340.     line is then sent (without the prefix).  Typing the line this way will
  2341.     allow messages to be sent "on open" in the GEnie Chat Lines and
  2342.     RTC's, without the need of first deactivating your defined prefix.
  2343.  
  2344.  
  2345.     Buffered Mode    <Alt-B>
  2346.  
  2347.     TurboTerm's buffered mode (also called chat mode, or split-screen
  2348.     mode) is most often used while 'chatting' with other people on GEnie
  2349.     Chat Lines or in a Real Time Conference (RTC).  Buffered mode prevents
  2350.     your typed text from being overwritten by another person's text while
  2351.     you are still typing.  This is accomplished by displaying incoming
  2352.     text in the upper (terminal) window, while the text you're typing is
  2353.     displayed in the lower (buffer) window.  While it is not necessary to
  2354.     use buffered mode in these situations, it does make the session easier
  2355.     to read.
  2356.  
  2357.                                          34                          09-01-91
  2358.  
  2359.  
  2360.  
  2361.  TurboTerm 2.0                 Program Reference
  2362.  
  2363.  
  2364.     TurboTerm's buffered mode also allows you to edit your text prior to
  2365.     sending it, using the <Alt-V> buffer editor.  Any of the preceding 25
  2366.     lines sent can also be "recalled" and re-sent, if desired, using the
  2367.     Command Recall function.  While in buffered mode, the left- and
  2368.     right-arrow keys can be used to "scroll" through the previous lines.
  2369.     While the line is displayed in the buffer, it can be re-transmitted by
  2370.     simply pressing the <Enter> key.  Each time a line is transmitted, it
  2371.     is added to the recall buffer.  You may also add lines to the recall
  2372.     buffer without transmitting them, by pressing <Ins> instead of
  2373.     <Enter>.
  2374.  
  2375.     Finally, TurboTerm's buffered mode has three interfaces available:
  2376.     Normal, GEnie Chat Lines, and GEnie RTC.  The <Alt-G> menu allows you
  2377.     to change the current interface, as well as toggling various buffered
  2378.     mode options.  The current state of these options, as well as the
  2379.     number of characters currently in the buffer, are displayed on the
  2380.     "chat bar" that separates the terminal and buffer windows.
  2381.  
  2382.  
  2383.     Clear screen    <Alt-C>
  2384.  
  2385.     To clear the terminal screen at any time, press <Alt-C>.  The screen
  2386.     will be cleared to the color in the terminal window.
  2387.  
  2388.  
  2389.     Dialing directory   <Alt-D>
  2390.  
  2391.     The TurboTerm dialing directory is used to establish a connection to
  2392.     one of sixty directory entries, or to a manually entered number. A
  2393.     number of entries may be "tagged" and dialed, in which case TurboTerm
  2394.     will dial each tagged entry in a round-robin fashion until a
  2395.     connection is made.  Each entry in the dialing directory has an
  2396.     associated group of terminal settings, as discussed in the chart
  2397.     below:
  2398.  
  2399.         Field        Description
  2400.         -----        -----------
  2401.  
  2402.         Name:        The name associated with this entry.
  2403.  
  2404.         Number:      The number of the remote system.  This field would
  2405.                      also include any digits required to access an outside
  2406.                      line, disable call-waiting, etc.
  2407.  
  2408.         Baud:        The baud rate of the system associated with this
  2409.                      entry.  This should reflect the maximum baud rate at
  2410.                      which you expect to connect to the remote system. The
  2411.                      only exception to this would be for those using error
  2412.                      correcting modems, where the baud rate is "locked" at
  2413.                      a rate higher than the actual connect rate.
  2414.  
  2415.         Parity:      This field should reflect the parity setting needed
  2416.                      to connect to the remote system associated with this
  2417.                      entry.
  2418.  
  2419.  
  2420.  
  2421.  
  2422.  09-01-91                                35
  2423.  
  2424.  
  2425.  
  2426.  TurboTerm 2.0                 Program Reference
  2427.  
  2428.         Data Bits:   This field should reflect the number of data bits
  2429.                      expected by the remote system associated with this
  2430.                      entry.
  2431.  
  2432.         Stop bits:   This field should reflect the number of stop bits
  2433.                      expected by the remote system associated with this
  2434.                      entry.
  2435.  
  2436.         Local echo:  Also called duplex setting.  Local echo on is
  2437.                      equivalent to half duplex.  In most cases, this
  2438.                      should be set to 'Yes' for 7 bit connections, and
  2439.                      'No' for 8 bit connections.
  2440.  
  2441.         Chat mode:   This field is a toggle that determines whether
  2442.                      TurboTerm will automatically switch into buffered
  2443.                      mode upon connecting to the remote system associated
  2444.                      with this entry.
  2445.  
  2446.         Emulation:   This field should reflect the terminal emulation
  2447.                      expected to be in use by the remote system associated
  2448.                      with this entry.
  2449.  
  2450.         Script:      This field contains the name of the linked script
  2451.                      that TurboTerm should execute upon successfully
  2452.                      connecting to the remote system associated with this
  2453.                      entry.  The script itself should reside in the
  2454.                      defined TurboTerm script directory.  The most common
  2455.                      usage for this function is to automatically perform
  2456.                      the actions necessary to log on to the remote system.
  2457.  
  2458.         Password:    This field contains the password or logon sequence
  2459.                      needed for the remote system associated with this
  2460.                      entry.  The string defined here can be transmitted to
  2461.                      the remote system via the {Password} script variable
  2462.                      in the attached script file, or by typing <Alt-F1>
  2463.                      within the first two minutes of connection.
  2464.  
  2465.         Usage log    If a usage log for this entry is desired, select
  2466.                      'Yes'.  Selecting 'No' at this prompt will skip the
  2467.                      next field.  Note that if usage logs are turned on
  2468.                      globally in the configuration file, selecting 'Yes'
  2469.                      here will allow you to specify a log file different
  2470.                      from the default.  Selecting 'No' while the global
  2471.                      usage log is active will cause usage statistics to be
  2472.                      written to the default usage log file.
  2473.  
  2474.         Usage name:  If 'Yes' was chosen above, a usage log name may be
  2475.                      specified at this prompt.
  2476.  
  2477.         Protocol:    This field should reflect the desired default binary
  2478.                      transfer protocol for the remote system associated
  2479.                      with this entry.
  2480.  
  2481.  
  2482.  
  2483.  
  2484.  
  2485.  
  2486.  
  2487.                                          36                          09-01-91
  2488.  
  2489.  
  2490.  
  2491.  TurboTerm 2.0                 Program Reference
  2492.  
  2493.         Clear usage
  2494.         stats:       This prompt allows you to clear out all statistics
  2495.                      associated with this entry.  Selecting 'No' will
  2496.                      cause the previously accumulated statistics to remain
  2497.                      in place.
  2498.  
  2499.     While inside the dialing directory, the available commands are listed
  2500.     at the bottom of the directory screen.  Aside from actually dialing
  2501.     the entries listed, functions are available here to tag, untag, edit
  2502.     and delete entries, save the current directory to disk, load an
  2503.     alternate phone directory, and view extended information for each
  2504.     entry.  These functions, as well as sorting, global changing, and
  2505.     importing other directory formats are available in the TTFON
  2506.     stand-alone utility.
  2507.  
  2508.  
  2509.     Toggle duplex (Local Echo)   <Alt-E>
  2510.  
  2511.     To toggle between full and half duplex while inside the terminal, use
  2512.     the <Alt-E> command.
  2513.  
  2514.  
  2515.     Find Text    <Alt-F>
  2516.  
  2517.     When scrollback is active the <Alt-F> key will allow you to perform a
  2518.     case insensitive text search from the current position to the end of
  2519.     the scrollback buffer.  If the text is found, the line containing the
  2520.     search string will be located at the bottom of the scrollback window.
  2521.     The search string is not reset after each successful search, so that
  2522.     multiple searches may be performed using successive <Alt-F> searches.
  2523.  
  2524.  
  2525.     Chat options    <Alt-G>
  2526.  
  2527.  
  2528.         Normal Chat:  Normal chat disables all the GEnie specific
  2529.                       functions, and makes buffered mode function as it
  2530.                       would in most other terminal programs.
  2531.  
  2532.         GEnie Chat:   GEnie Chat enables the special features associated
  2533.                       with TurboTerm's Chat Lines interface.  These
  2534.                       features include: Auto-Show, Auto-Greet, Alert, Die
  2535.                       roller, And AFK modes.  Use this chat mode if you
  2536.                       are GEnie's Chat Lines.
  2537.  
  2538.         GEnie RTC:    GEnie RTC enables all of the special features as the
  2539.                       GEnie Chat interface, but is structured to work
  2540.                       within GEnie's Real Time Conferences.  Since
  2541.                       the RTC software on GEnie has a slightly different
  2542.                       set of commands, a separate interface is required to
  2543.                       activate these features there.
  2544.  
  2545.  
  2546.  
  2547.  
  2548.  
  2549.  
  2550.  
  2551.  
  2552.  09-01-91                                37
  2553.  
  2554.  
  2555.  
  2556.  TurboTerm 2.0                 Program Reference
  2557.  
  2558.         The <Alt-G> menu lists the GEnie specific functions as well.
  2559.         These are Auto-Show, Auto-Greet, Alert, Die roller, and AFK modes.
  2560.         To toggle any of these options ON or OFF type <Alt-G> and cursor
  2561.         down to the option to toggle, and press <Enter> or use the
  2562.         highlighted hot-key.  When all preferences are set as desired
  2563.         press <Esc> to exit.  These defaults will remain in effect for the
  2564.         remainder of your TurboTerm session.  To make your preferences
  2565.         permanent, use TTSetup.  Below is a brief description, outlining
  2566.         what each of each of these functions does.
  2567.  
  2568.         Auto-Show     With this option active, TurboTerm automatically
  2569.                       requests extended information on people that enter
  2570.                       or monitor your channel.  This is analogous to
  2571.                       typing "/SHO <handle>" whenever anyone enters or
  2572.                       monitors your channel -- except you don't have to
  2573.                       type it.
  2574.  
  2575.         Auto-Greet    With this option active, TurboTerm automatically
  2576.                       "greets" people that enter the channel you are on,
  2577.                       using the currently defined greet string.
  2578.  
  2579.         Alert         With this option active, all private messages
  2580.                       received by TurboTerm will be highlighted and
  2581.                       accompanied by an alert tone.
  2582.  
  2583.         Die roller    With this option active, TurboTerm will parse each
  2584.                       incoming line for valid die roll sequences.  A valid
  2585.                       sequence matches the pattern ".r##d###[+/-##]".  An
  2586.                       example would be ".r5d12" or ".r10d20+15"
  2587.  
  2588.         AFK           With this option active, TurboTerm automatically
  2589.                       sends the defined AFK string in response to all
  2590.                       incoming private messages.
  2591.  
  2592.  
  2593.     Hanging up    <Alt-H>
  2594.  
  2595.     To terminate your current session without exiting TurboTerm, use the
  2596.     <Alt-H> hang-up command.
  2597.  
  2598.  
  2599.     Information    <Alt-I>
  2600.  
  2601.     This keystroke invokes an information screen outlining the current
  2602.     state of various TurboTerm parameters.  Pressing <Esc> will exit this
  2603.     screen and return you to your terminal session.  Any other keystroke
  2604.     will exit the screen, with the keystroke passed to the current
  2605.     session.
  2606.  
  2607.  
  2608.     Keyboard macros    <Alt-K>
  2609.  
  2610.     Macros in TurboTerm are predefined lines of text.  Each macro can
  2611.     be 255 characters in length, and you can have up to ten macros active
  2612.     at any one time.  The macro keys are F1 through F10.  Any number of
  2613.     macro sets can be loaded or saved from within the <Alt-K> definition
  2614.     screen.  Refer to the TTSetup section for information on how to define
  2615.     your default macro key file.
  2616.  
  2617.                                          38                          09-01-91
  2618.  
  2619.  
  2620.  
  2621.  TurboTerm 2.0                 Program Reference
  2622.  
  2623.  
  2624.         Editing macros:
  2625.  
  2626.         To edit a macro inside TurboTerm type: <Alt-K>  A popup window
  2627.         will show you the current macros that you have defined, and a list
  2628.         of available commands will be displayed at the bottom of the
  2629.         window. To select a given macro, either press the macro key (F1
  2630.         through F10) you wish to edit or the <G> and <A> keys for auto
  2631.         greet string, and AFK macros.
  2632.  
  2633.         Command   Function
  2634.         -------   ----------
  2635.  
  2636.          <L>       Load a new macro file.  The current macro filename will
  2637.                    be displayed in the window, and you can chose this file
  2638.                    by pressing <Enter>.  If you wish to load a new macro
  2639.                    file, erase the filename and type in the new name you
  2640.                    wish to load -- or press <Enter> at the empty prompt,
  2641.                    and a list of all macro files will be shown.
  2642.  
  2643.          <S>       Save the current macro definitions to disk.  The
  2644.                    current filename will be shown, and you can type
  2645.                    <Enter> to use this filename, or you may retype it to
  2646.                    save the file under a different name.
  2647.  
  2648.          <F1>-
  2649.          <F10>     You may edit any of these macro strings by typing the
  2650.                    associated function key for that macro.  To edit the
  2651.                    macro, use the line editor commands discussed
  2652.                    elsewhere in this documentation.
  2653.  
  2654.          <A>or<G>  Define your current AFK, and Auto-Greet macros.  Again,
  2655.                    use line editor commands discussed elsewhere in the
  2656.                    documentation.  The Auto-Greet string has the
  2657.                    additional feature of incorporating the "handle" of the
  2658.                    person that you are greeting by placing the {handle}
  2659.                    keyword at the appropriate spot in the macro string.
  2660.  
  2661.          <Esc>     Exits you from the macro editor.
  2662.  
  2663.          How macros work:
  2664.  
  2665.          When in normal terminal mode, your macro is automatically sent
  2666.          whenever that macro key is pressed.  When you are in buffered
  2667.          mode,  the macro string is appended to the current line in the
  2668.          chat buffer.  You must still press <Enter> to send your macro
  2669.          (and any other characters in the buffer).  Under certain
  2670.          circumstances, you may wish to have your F1 - F10 macros sent
  2671.          immediately, without necessarily exiting buffered mode.  If this
  2672.          is the case, then simply place a carriage return on the end of
  2673.          your macro with the macro editor.  To do this follow the macro
  2674.          line editor instructions found elsewhere in this manual.
  2675.  
  2676.  
  2677.  
  2678.  
  2679.  
  2680.  
  2681.  
  2682.  09-01-91                                39
  2683.  
  2684.  
  2685.  
  2686.  TurboTerm 2.0                 Program Reference
  2687.  
  2688.     Capture logs     <Alt-L>
  2689.  
  2690.     TurboTerm has the ability to log all communications port activity to
  2691.     disk.  This is sometimes called a capture log.  To start logging to
  2692.     disk, type <Alt-L>.  If the log file already exists, you will be
  2693.     prompted to overwrite, append or create a new log file.  If the
  2694.     default log file does not exist, TurboTerm will begin logging to that
  2695.     file immediately.  All log files are written to the defined TurboTerm
  2696.     log directory.  To stop the capture log, type <Alt-L> again.  While
  2697.     logging to disk, the word 'Log' will be shown on the status line.
  2698.  
  2699.  
  2700.     Marking text     <Alt-M>
  2701.  
  2702.     To mark text in scrollback, place the first line you wish to mark on
  2703.     the bottom of the scrollback window and press <Alt-M>.  To mark a
  2704.     series of lines, scroll through the scrollback text until the last
  2705.     line that you wish marked is shown on the bottom line of the
  2706.     scrollback window, and press <Alt-M>.  All lines between the first
  2707.     mark and the second mark will be highlighted.  Once a section of
  2708.     scrollback is marked, it can either be saved to disk or copied to the
  2709.     TurboTerm Clipboard.  Unmarking of scrollback will automatically be
  2710.     performed after copying the marked text to disk or to the clipboard.
  2711.     You can also manually unmark scrollback by typing <Alt-U>.
  2712.  
  2713.  
  2714.     Null modem      <Alt-N>
  2715.  
  2716.     Transferring files from one computer to another without a modem can be
  2717.     performed by connecting the two computers together using a null modem
  2718.     cable.  TurboTerm can perform binary file transfers using any of its
  2719.     built in protocols, at speeds up to 115200 Bps.  This is a handy
  2720.     feature for transferring files from your laptop to your desktop
  2721.     computer.  Enabling Null modem direct connects will disable all
  2722.     carrier checking, and display 'Direct' on the status line.
  2723.  
  2724.  
  2725.     Shelling to DOS    <Alt-O>
  2726.  
  2727.     To shell to DOS, type <Alt-O>.  The amount of memory available in DOS
  2728.     through this function is directly related to the disk-swapping
  2729.     parameter in the configuration file.  The possibility exists that you
  2730.     will be unable to shell to DOS under certain circumstances.  A
  2731.     temporary solution would be to delete the scrollback buffer (via
  2732.     <Alt-F4>) to free up more memory.  A more permanent solution would be
  2733.     to activate disk-swapping in TurboTerm's configuration file.  With
  2734.     disk-swapping active, all but approximately 55K of memory will be
  2735.     available through the <Alt-O> function.
  2736.  
  2737.  
  2738.  
  2739.  
  2740.  
  2741.  
  2742.  
  2743.  
  2744.  
  2745.  
  2746.  
  2747.                                          40                          09-01-91
  2748.  
  2749.  
  2750.  
  2751.  TurboTerm 2.0                 Program Reference
  2752.  
  2753.     Port configuration     <Alt-P>
  2754.  
  2755.     If you wish to alter the current communication parameters during a
  2756.     TurboTerm session, you may quickly do so by using the <Alt-P> option.
  2757.     The current line settings are displayed on the top line of the window.
  2758.     To change any of the current line settings, type the corresponding
  2759.     menu choice.  As you make changes, the top line will reflect your
  2760.     chosen settings.  Once all of the necessary changes have been made,
  2761.     press <Enter> to accept the settings.  Pressing <Esc> at any time
  2762.     while changing these parameters will abort the process and leave your
  2763.     communications settings unchanged.
  2764.  
  2765.  
  2766.     Running a script    <Alt-S>
  2767.  
  2768.     To run a script inside TurboTerm, type <Alt-S>.  At the prompt,
  2769.     type in the name of the script you wish to run.  Pressing <Enter> at
  2770.     the empty prompt will display a list of all scripts in your TurboTerm
  2771.     script directory.  After specifying a script at the prompt or
  2772.     selecting one from the list, TurboTerm will begin execution of the
  2773.     script.  A brief discussion of the TurboTerm script language
  2774.     commands can be found in Appendix C.
  2775.  
  2776.  
  2777.     Time and Date     <Alt-T>
  2778.  
  2779.     At any point, the current time and date can be displayed by pressing
  2780.     <Alt-T>.  TurboTerm will display the current date and time in the
  2781.     bottom left hand corner of the screen for approximately 10 to 15
  2782.     seconds.
  2783.  
  2784.  
  2785.     Unmarking     <Alt-U>
  2786.  
  2787.     You can manually unmark the scrollback buffer with the <Alt-U>
  2788.     command. All lines that are currently marked in scrollback will be
  2789.     unmarked.
  2790.  
  2791.  
  2792.     Buffer editor   <Alt-V>
  2793.  
  2794.     Editing a line in buffered mode is very much like editing in the
  2795.     various line prompts within TurboTerm.  Pressing <Alt-V> while in
  2796.     buffered mode will bring up the TurboTerm line editor, with the
  2797.     current line in the buffer automatically inserted.
  2798.  
  2799.     TurboTerm's line editor uses many of the WordStar commands you are
  2800.     probably already familiar with.  These commands will allow you insert,
  2801.     delete, and modify text quickly and painlessly.  The following list of
  2802.     commands will help you to familiarize yourself with the editing
  2803.     capabilities of the line editor.
  2804.  
  2805.  
  2806.  
  2807.  
  2808.  
  2809.  
  2810.  
  2811.  
  2812.  09-01-91                                41
  2813.  
  2814.  
  2815.  
  2816.  TurboTerm 2.0                 Program Reference
  2817.  
  2818.     Keystroke(s)     Function
  2819.     ------------     --------
  2820.  
  2821.     <Enter>          Accepts the current line, including any changes that
  2822.                      you have made to that line.
  2823.  
  2824.     <Esc>
  2825.     <Ctrl-Break>     Quit without making any changes to the line, and
  2826.                      return you to the terminal session.
  2827.  
  2828.     <Right Arrow>
  2829.     <Ctrl-S>         Moves the cursor right one space.
  2830.  
  2831.     <Left Arrow>
  2832.     <Crtl-I>         Moves the cursor left one space.
  2833.  
  2834.     <Ctrl-Left>
  2835.     <Ctrl-A>         Move the cursor left one word.
  2836.  
  2837.     <Ctrl-Right>
  2838.     <Ctrl-F>         Move the cursor right one word.
  2839.  
  2840.     <Home>
  2841.     <Ctrl-Q><S>      Move the cursor to the beginning of the line.
  2842.  
  2843.     <End>
  2844.     <Ctrl-Q><D>      Move the cursor to the end of the line.
  2845.  
  2846.     <Del>
  2847.     <Ctrl-G>         Delete the character at the current cursor position.
  2848.  
  2849.     <Backspace>
  2850.     <Ctrl-H>
  2851.     <Ctrl-Backspace> Delete character to left of the current cursor
  2852.                      position.
  2853.  
  2854.     <Ctrl-End>
  2855.     <Ctrl-Q><Y>      Delete from the current cursor position to the end of
  2856.                      the line.
  2857.  
  2858.     <Ctrl-Y>
  2859.     <Ctrl-X>         Unconditionally delete the entire line.
  2860.  
  2861.     <Ctrl-Home>      Delete from beginning of line to the current cursor
  2862.                      position.
  2863.  
  2864.     <Ctrl-T>         Delete the word to the right of the current cursor
  2865.                      position.
  2866.  
  2867.     <Ins>            Toggle insert/overwrite mode.  When you have a large
  2868.                      cursor showing you are in insert mode.
  2869.  
  2870.     <Ctrl-R>
  2871.     <Ctrl-Q><L>      Restore the line to original contents before any
  2872.                      editing was done.
  2873.  
  2874.  
  2875.  
  2876.  
  2877.                                          42                          09-01-91
  2878.  
  2879.  
  2880.  
  2881.  TurboTerm 2.0                 Program Reference
  2882.  
  2883.     <Ctrl-P>         Place the line editor in Ctrl-character mode.  When
  2884.                      <Ctrl-P> is pressed, the line editor displays a large
  2885.                      cursor which signifies that the next character typed
  2886.                      will be unconditionally added to the line.  Even
  2887.                      control characters such as a carriage returns may be
  2888.                      inserted in the edited line.  When a valid control
  2889.                      character is entered, the character will be displayed
  2890.                      as an uppercase representation of the control
  2891.                      character typed.  (for example, a Ctrl-M would show
  2892.                      as a capital 'M'.)
  2893.  
  2894.  
  2895.  
  2896.     Write text    <Alt-W>
  2897.  
  2898.     This command gives the ability to "write" some or all of the
  2899.     scrollback contents to a disk file, or copy it into the TurboTerm
  2900.     Clipboard.  If lines are currently marked in the scrollback buffer,
  2901.     then this command will only effect those marked lines.  If no marked
  2902.     lines are present, the entire contents of the scrollback buffer will
  2903.     be copied.  Upon completion of writing, all marked text will be
  2904.     unmarked.  If you are writing the text to a disk file and the default
  2905.     scrollback filename already exists, you will be prompted to overwrite,
  2906.     append or create a new file.  Attempting  to copy more text into the
  2907.     clipboard than the clipboard can hold will cause an error message to
  2908.     be displayed, and the clipboard will only contain the text that it was
  2909.     able to hold.
  2910.  
  2911.  
  2912.     Exiting TurboTerm     <Alt-X>
  2913.  
  2914.     To exit TurboTerm and end your telecommunications session, type
  2915.     <Alt-X>.  TurboTerm will close all open log files and exit to DOS.  If
  2916.     TurboTerm senses that you are still online, it will prompt you
  2917.     whether it should also hang up the modem prior to exiting.
  2918.  
  2919.  
  2920.     Terminal emulation    <Alt-Y>
  2921.  
  2922.     Setting your terminal emulation in TurboTerm is done by typing
  2923.     <Alt-Y>.  You will then be allowed to choose the emulation you wish
  2924.     TurboTerm to use.  A complete discussion of the available terminal
  2925.     emulations is found in the section of this manual dealing with the
  2926.     TTSetup configuration utility.   When changing terminal emulation, the
  2927.     screen is automatically cleared and the cursor placed in the lower
  2928.     left corner of the terminal window.  Note that you will be unable to
  2929.     choose ANSI emulation while in buffered mode.
  2930.  
  2931.  
  2932.     Online help    <Alt-Z>
  2933.  
  2934.     A brief chart of TurboTerm's function keys can be called up from
  2935.     within the terminal session by typing <Alt-Z>.
  2936.  
  2937.  
  2938.  
  2939.  
  2940.  
  2941.  
  2942.  09-01-91                                43
  2943.  
  2944.  
  2945.  
  2946.  TurboTerm 2.0                 Program Reference
  2947.  
  2948.     Send password     <Alt-F1>
  2949.  
  2950.     TurboTerm attempts to make logging on without a script as simple as
  2951.     possible.  Within the first two minutes of connection to a remote
  2952.     system, you may use the <Alt-F1> key to send the password defined in
  2953.     the dialing directory.  After two minutes have elapsed, TurboTerm
  2954.     zeroes out the password field to prevent accidentally sending your
  2955.     password at an inopportune time.
  2956.  
  2957.  
  2958.     Configure TurboTerm     <Alt-F2>
  2959.  
  2960.     While inside TurboTerm, it is possible to switch directly into the
  2961.     TTSetup configuration utility, using the <Alt-F2> keystroke.  All of
  2962.     the configuration options may be changed while executing TTSetup in
  2963.     this manner, but some options (mostly those that deal with your
  2964.     current connection parameters) will not take effect until after you've
  2965.     exited and re-entered TurboTerm.
  2966.  
  2967.  
  2968.     Delete scrollback    <Alt-F4>
  2969.  
  2970.     When you no longer need the contents of the scrollback buffer, or you
  2971.     need more free memory to shell to a program, you can delete the
  2972.     contents of scrollback by typing <Alt-F4>.  When you choose to delete
  2973.     scrollback, you will be asked to confirm your action.  If you choose
  2974.     yes, the scrollback window will be removed from the screen and the
  2975.     scrollback buffer will be cleared.
  2976.  
  2977.  
  2978.     TurboTerm Clipboard     <Alt-F5>
  2979.  
  2980.     To enter the TurboTerm Clipboard, press <Alt-F5>.  The TurboTerm
  2981.     clipboard is a WordStar based editor that allows cut and paste
  2982.     operations to and from the terminal session.  For a complete
  2983.     description on utilization of the TurboTerm Clipboard, refer to
  2984.     Appendix D.
  2985.  
  2986.  
  2987.     Send clipboard contents   <Alt-F6>
  2988.  
  2989.     To send (or "paste") the contents of the clipboard to the terminal
  2990.     session, press <Alt-F6>.   A few examples of clipboard usage are given
  2991.     in Appendix D.
  2992.  
  2993.  
  2994.     *UPLOAD clipboard    <Alt-F7>
  2995.  
  2996.     To *UPLOAD the contents of the clipboard to the GEMail editor, press
  2997.     <Alt-F7>.  An example of this function is given in Appendix D.
  2998.  
  2999.  
  3000.  
  3001.  
  3002.  
  3003.  
  3004.  
  3005.  
  3006.  
  3007.                                          44                          09-01-91
  3008.  
  3009.  
  3010.  
  3011.  TurboTerm 2.0                 Program Reference
  3012.  
  3013.     Resize scrollback window   <Ctrl-PgUp> or <Ctrl-PgDn>
  3014.  
  3015.     Resizing the scrollback window is NOT allowed in ANSI emulation.  In
  3016.     any other terminal emulation, you may resize the scrollback window to
  3017.     suit your needs.  The scrollback window can be from 3 lines to 18
  3018.     lines in size.  <Ctrl-PgUp> shrinks the size of the scrollback
  3019.     window by one line, and <Ctrl-PgDn> enlarges the scrollback window by
  3020.     one line.  The window size will remain in effect for the remainder of
  3021.     the terminal session, or until changed again.
  3022.  
  3023.  
  3024.     Clear scrollback window    <ESC>
  3025.  
  3026.     To remove the scrollback window and restore the normal terminal
  3027.     screen, press <ESC>.   The contents of the screen under the scrollback
  3028.     window will be automatically restored.
  3029.  
  3030.  
  3031.     Enter scrollback    <Up Arrow>
  3032.  
  3033.     To display the scrollback window while in the terminal, press the
  3034.     <Up Arrow> key.  In ANSI emulation, the scrollback window will be
  3035.     a full screen window, and cannot be resized.  In the other emulations,
  3036.     the window size is determined by the corresponding parameter in the
  3037.     configuration file, and the terminal screen will remain active while
  3038.     the window is displayed.
  3039.  
  3040.  
  3041.  
  3042.  
  3043.  
  3044.  
  3045.  
  3046.  
  3047.  
  3048.  
  3049.  
  3050.  
  3051.  
  3052.  
  3053.  
  3054.  
  3055.  
  3056.  
  3057.  
  3058.  
  3059.  
  3060.  
  3061.  
  3062.  
  3063.  
  3064.  
  3065.  
  3066.  
  3067.  
  3068.  
  3069.  
  3070.  
  3071.  
  3072.  09-01-91                                45
  3073.  
  3074.  
  3075.  
  3076.  TurboTerm 2.0                    Appendix A            Setting Up a Ram Disk
  3077.  
  3078.  
  3079.        VDISK.SYS: [DOS 3.3]
  3080.  
  3081.        The VDISK.SYS file is a device driver that simulates a disk drive
  3082.        by using a portion of your computer's memory as the storage medium.
  3083.        These simulated disks are called virtual disks.  If you have an AT
  3084.        class computer, you can use the extended memory as one (or more)
  3085.        virtual disks.  If you have EMS memory on any class machine the
  3086.        same also applies.  Otherwise, virtual disks are located in low
  3087.        memory. As such, owners of PC or XT classes of computers with no
  3088.        EMS memory would see very little benefit to operating a virtual
  3089.        disk on their machine for use with TurboTerm -- the space it would
  3090.        occupy in standard DOS memory would, more than likely, leave so
  3091.        little available memory that you would not be able to run
  3092.        TurboTerm.  PC and XT users without EMS memory should therefore
  3093.        specify an actual disk device for their swap path -- it's slower
  3094.        than a virtual disk, but nonetheless effective for our use.  For
  3095.        those of you unfamiliar with installing virtual disks, refer to
  3096.        your DOS manual for a complete overview.  For our purposes, I'll
  3097.        show you how I have my system configured, and briefly outline what
  3098.        we consider to be the minimum suggested VDISK configuration.
  3099.  
  3100.        In my CONFIG.SYS file, I have the following line:
  3101.  
  3102.             DEVICE=C:\DOS\VDISK.SYS 1408 128 512 /E
  3103.  
  3104.        This installs a 1.4Meg ramdisk in extended memory, with 128 byte
  3105.        sectors, and a maximum of 512 directory entries.  Another possible
  3106.        configuration, which should work on AT machines without a memory
  3107.        expansion board, is:
  3108.  
  3109.             DEVICE=C:\DOS\VDISK.SYS 400 512 64 /E
  3110.  
  3111.        This will install a 400K ramdisk in extended memory, with 512 byte
  3112.        sectors, and a maximum of 64 directory entries.  We recommend a
  3113.        virtual disk of at least 400K for use with TurboTerm. It will allow
  3114.        enough room to write out the temporary "swap file" to the virtual
  3115.        disk.  Once you've installed VDISK.SYS in your CONFIG.SYS file, as
  3116.        outlined above, you simply need to "tell" TurboTerm to use the
  3117.        virtual disk as storage for it's swap file.  Start TTSetup, and
  3118.        pick the "Other" menu item.  On the sub-menu, choose "Memory
  3119.        Options". Change the setting for Allow Swapping to "Yes", then edit
  3120.        the Swap Path to indicate the virtual drive. (DOS assigns the next
  3121.        available drive letter to the virtual disk when it's installed, and
  3122.        tells you what drive letter has been assigned when you boot your
  3123.        computer.) That's it!  You now have TurboTerm set up to "swap out"
  3124.        rather than "shell out" when performing user shells, external
  3125.        protocols, and the <Alt-O> Shell/Swap-to-DOS option.
  3126.  
  3127.  
  3128.  
  3129.  
  3130.  
  3131.  
  3132.  
  3133.  
  3134.  
  3135.  
  3136.  
  3137.                                          46                          09-01-91
  3138.  
  3139.  
  3140.  
  3141.  TurboTerm 2.0                    Appendix A            Setting Up a Ram Disk
  3142.  
  3143.  
  3144.        RAMDRIVE.SYS:  [DOS 4.0/5.0]
  3145.  
  3146.        The setup of RAMDRIVE.SYS is virtually identical to the setup of
  3147.        VDISK.SYS with the exception of the name.  Read the section above
  3148.        on the use of VDISK, and substitute RAMDRIVE.SYS where VDISK.SYS is
  3149.        mentioned.  RAMDRIVE does not need the sector size nor the number
  3150.        of entries parameter, and they can be left out if desired.  On
  3151.        Scott's computer he has his RAMDRIVE setup as follows:
  3152.  
  3153.        In his CONFIG.SYS file is the following line:
  3154.  
  3155.            DEVICE=C:\DOS\RAMDRIVE.SYS 400 /E
  3156.  
  3157.        This instructs RAMDRIVE to create a 400k disk drive in extended
  3158.        memory.
  3159.  
  3160.  
  3161.  
  3162.        NON EMS 4.0 compliant EMS cards/drivers
  3163.  
  3164.        If TurboTerm is having problems accessing your EMS memory correctly
  3165.        then using one of the above solutions might be helpful.  Both
  3166.        RAMDRIVE.SYS, and VDISK.SYS have the ability to use EMS memory. If
  3167.        you wish to try RAMDRIVE, or VDISK with your EMS card then
  3168.        substitute the /E in the above examples with a /A
  3169.  
  3170.  
  3171.  
  3172.  
  3173.  
  3174.  
  3175.  
  3176.  
  3177.  
  3178.  
  3179.  
  3180.  
  3181.  
  3182.  
  3183.  
  3184.  
  3185.  
  3186.  
  3187.  
  3188.  
  3189.  
  3190.  
  3191.  
  3192.  
  3193.  
  3194.  
  3195.  
  3196.  
  3197.  
  3198.  
  3199.  
  3200.  
  3201.  
  3202.  09-01-91                                47
  3203.  
  3204.  
  3205.  
  3206.  TurboTerm 2.0                    Appendix B                       Usage Logs
  3207.  
  3208.  
  3209.     The usage log is a feature which allows you to track your usage of a
  3210.     given system, and what you did while on that system.  The usage log
  3211.     keeps tracks of major events that occur while using TurboTerm, and
  3212.     logs the date and time of each event.  Usage logs are useful when you
  3213.     wish to keep track of your system usage for a given pay system.  This
  3214.     will allow you to closely verify your bill from the host system.  We
  3215.     at Keypunch Labs use it to verify our GEnie bill.  The usage log has
  3216.     two modes of operation.  (Verbose and Brief)  In brief mode only
  3217.     connects and disconnects will be logged in your usage log file. In
  3218.     verbose mode your usage logs will become slightly larger, but much
  3219.     more information can be learned from it.  A system directly dialed
  3220.     from your dialing directory can have its associated usage tracked. The
  3221.     are two way to track a give systems usage. You can turn auto log usage
  3222.     on, and all remote calling will be tracked by TurboTerm.  With this
  3223.     method all the information will be stored in the same file defined as
  3224.     the default usage filename.  This method is highly useful if you need
  3225.     to track all remote dialing.  The second method is to specify in each
  3226.     dialing directory entry, only those entries to have a usage file.
  3227.     This method allows tracking of system usage for only the systems which
  3228.     are most important to you.
  3229.  
  3230.     Verbose usage logs log the following:
  3231.  
  3232.          - All connections made to remote system via use of the dialing
  3233.            directory. This includes manual dials, and dials from a
  3234.            particular entry.
  3235.  
  3236.          - All disconnections from a remote system, including manual
  3237.          hang-ups.
  3238.  
  3239.          - The number of dialing attempts prior to connecting.
  3240.  
  3241.          - The start of all scripts.
  3242.  
  3243.          - The completion of all scripts.
  3244.  
  3245.          - Any scripts that were aborted.
  3246.  
  3247.          - Renaming of any capture logs done inside a script.
  3248.  
  3249.          - Any COMMENT command found in a script.
  3250.  
  3251.          - The completion of all file uploads and downloads with the CPS
  3252.            transfer rate attached.
  3253.  
  3254.          - Any failed file transfers.
  3255.  
  3256.          - Completion of clipboard Sends, and *UPLOAD's.
  3257.  
  3258.          - Aborted or failed clipboard Sends, and *UPLOAD's.
  3259.  
  3260.          - The name of all programs you shelled to.
  3261.  
  3262.          - The starting/stopping of all capture logs.
  3263.  
  3264.  
  3265.  
  3266.  
  3267.                                          48                          09-01-91
  3268.  
  3269.  
  3270.  
  3271.  TurboTerm 2.0                    Appendix B                       Usage Logs
  3272.  
  3273.     A typical verbose usage log would look something like this:
  3274.  
  3275.      08/01 20:26 ** Connected to: GEnie.  @385-3268
  3276.      08/01 20:26    Connected after 1 dial attempt(s).
  3277.      08/01 20:26    Started script: GENIE.SCR
  3278.      08/07 20:26  * You escaped from script
  3279.      08/01 20:26    Completed script: GENIE.SCR
  3280.      08/01 20:28    Shelled to: TTSETUP.EXE
  3281.      08/01 20:29    Zmodem receive aborted C:\TT\TRANS\TT106.EXE
  3282.      08/01 20:33    Zmodem receive C:\TT\TRANS\TT106.EXE Cps: 226
  3283.      08/01 20:45    XmodemCRC transmit C:\TT\BLANK-IT.COM Cps: 156
  3284.      08:01 20:45    Start log: TT.LOG
  3285.      08/01 20:46    Sent clipboard.
  3286.      08/01 20:49    *UPLOAD of clipboard.
  3287.      08/01 21:55    Close log: TT.LOG
  3288.      08/01 21:00    Shelled to: C:\SW2\SW2.BAT
  3289.      08/01 22:30  * You hung up on GEnie
  3290.      08/01 22:30 ** Disconnected from: Genie.  Time Connected: 01:58:21
  3291.  
  3292.  
  3293.     Brief usage logs log the following:
  3294.  
  3295.     (All entries will be preceded with a date and time stamp.)
  3296.  
  3297.          - All connections made to remote system via use of the dialing
  3298.            directory. This includes manual dials, and dials from a
  3299.            particular entry.
  3300.  
  3301.          - All disconnections from a remote system, including manual
  3302.          hang-ups.
  3303.  
  3304.     A typical brief usage log would look something like this:
  3305.  
  3306.      07/17 15:34 ** Connected to: GEnie.  @555-1212
  3307.      07/17 15:39 ** Disconnected from: GEnie. Time connected: 00:04:48
  3308.      07/19 16:03 ** Connected to: GEnie.  @555-1212
  3309.      07/19 16:07 ** Disconnected from: GEnie. Time connected: 00:03:38
  3310.      07/20 19:06 ** Connected to: GEnie.  @555-1212
  3311.      07/20 19:08 ** Disconnected from: GEnie. Time connected: 00:01:46
  3312.      08/01 19:09 ** Connected to: GEnie.  @555-1212
  3313.      08/01 19:11 ** Disconnected from: GEnie. Time connected: 00:02:31
  3314.      08/15 19:13 ** Connected to: GEnie.  @555-1212
  3315.      08/15 19:14 ** Disconnected from: GEnie. Time connected: 00:01:06
  3316.  
  3317.  
  3318.  
  3319.  
  3320.  
  3321.  
  3322.  
  3323.  
  3324.  
  3325.  
  3326.  
  3327.  
  3328.  
  3329.  
  3330.  
  3331.  
  3332.  09-01-91                                49
  3333.  
  3334.  
  3335.  
  3336.  TurboTerm 2.0                    Appendix C                  Script Commands
  3337.  
  3338.  
  3339.     TurboTerm has the ability to automate many online tasks through the
  3340.     use of its interpreted script language.  While the summary that
  3341.     follows is hardly a compendium on the subject, combined with the
  3342.     sample scripts provided, you should be able to create a script to suit
  3343.     your specific needs.
  3344.  
  3345.  
  3346.     SEND <string>           - sends the specified string, with an appended
  3347.                               carriage return and linefeed.  The string
  3348.                               should be surrounded by quote marks (").
  3349.  
  3350.     TRANSMIT <string>       - sends the specified string, without
  3351.                               appending a carriage return and linefeed.
  3352.                               The string should be surrounded by quote
  3353.                               marks (").
  3354.  
  3355.     LOG <ON/OFF>            - activates or deactivates the currently named
  3356.                               capture log.
  3357.  
  3358.     GOTO <label>            - branches program control to the specified
  3359.                               label.  The named label must exist in the
  3360.                               current script.  A label is defined by
  3361.                               placing the associated keyword, preceded by
  3362.                               a colon, in the left column.
  3363.  
  3364.     GOSUB <label>           - branches to subroutine at the specified
  3365.                               label.
  3366.  
  3367.     RETURN                  - returns program control to the line
  3368.                               following that from which the current
  3369.                               subroutine was called.
  3370.  
  3371.     TIMEOUT <value>         - sets a default TIMEOUT value for the script.
  3372.                               If defined, it is not necessary to
  3373.                               explicitly specify a TIMEOUT value in
  3374.                               subsequent WAITFOR commands.
  3375.  
  3376.     WAIT <value>            - suspends script processing for <value>
  3377.                               seconds.
  3378.  
  3379.     BEEP <ONE/TWO>          - beeps the local speaker.
  3380.  
  3381.     TONE <freq> <duration>  - emits a tone of the specified frequency for
  3382.                               the specified duration.  The frequency is
  3383.                               supplied in Hertz, and the duration in
  3384.                               1/100's of a second.
  3385.  
  3386.     END                     - halts TurboTerm script processing.
  3387.  
  3388.     STOP                    - same as END.
  3389.  
  3390.     EXIT_TT                 - halts TurboTerm script processing and exits
  3391.                               the TurboTerm session.  If online, DTR will
  3392.                               be lowered to terminate the connection.  Any
  3393.                               open log files are automatically closed.
  3394.  
  3395.  
  3396.  
  3397.                                          50                          09-01-91
  3398.  
  3399.  
  3400.  
  3401.  TurboTerm 2.0                    Appendix C                  Script Commands
  3402.  
  3403.     UPLOAD<type> <fname>    - initiates a file transfer from TurboTerm to
  3404.                               the remote system.
  3405.  
  3406.     DOWNLOAD<type> <fname>  - initiates a file transfer to TurboTerm from
  3407.                               the remote system.
  3408.  
  3409.           where  <type> =        X : Xmodem-CRC
  3410.                                  1 : Xmodem-1K
  3411.                                  Y : Ymodem (Batch)
  3412.                                  G : Ymodem-G (Batch)
  3413.                                  Z : Zmodem (Batch)
  3414.                                  K : Kermit (Batch)
  3415.                                  A : ASCII  (upload only)
  3416.  
  3417.                               Note that there is no space between the
  3418.                               UPLOAD or DOWNLOAD keyword and the
  3419.                               associated transfer type.  <fname> should
  3420.                               refer to an existing filename or valid DOS
  3421.                               wildcard in the defined upload or download
  3422.                               directory.
  3423.  
  3424.     WRITE <string>          - writes the specified string to the local
  3425.                               screen (NOT transmitted).  The string should
  3426.                               be surrounded by quote marks (").
  3427.  
  3428.     WAITFOR <string> <command> [timeout]
  3429.  
  3430.                             - waits for the specified string to be
  3431.                               received, then performs the command
  3432.                               specified.  The timeout parameter does not
  3433.                               need to be specified if a previous TIMEOUT
  3434.                               command exists in the script.
  3435.  
  3436.     WHEN <number> <string> GOTO/GOSUB/SEND/TRANSMIT
  3437.  
  3438.                             - processes incoming text, waiting for a
  3439.                               particular string to be received.  This
  3440.                               procedure works in conjunction with an
  3441.                               existing (and pending) WAITFOR statement.
  3442.                               Up to ten WHEN statements may be active at
  3443.                               any given time.
  3444.  
  3445.     WHEND <number>          - cancels processing of the specified WHEN
  3446.                               statement.
  3447.  
  3448.     DUPLEX <HALF/FULL>      - sets TurboTerm's duplex setting to half or
  3449.                               full.
  3450.  
  3451.     LOGNAME <fspec>         - sets the name of the current TurboTerm
  3452.                               capture file.  No drive/directory is
  3453.                               supported - the log of the specified name
  3454.                               will be written to the default LOG
  3455.                               directory, as defined in the configuration
  3456.                               file.
  3457.  
  3458.  
  3459.  
  3460.  
  3461.  
  3462.  09-01-91                                51
  3463.  
  3464.  
  3465.  
  3466.  TurboTerm 2.0                    Appendix C                  Script Commands
  3467.  
  3468.     STAMPLOG [string]       - writes the specified string to the current
  3469.                               capture log (if active).  If no string is
  3470.                               specified, TurboTerm will write it's
  3471.                               default time/datestamp to the file.  The
  3472.                               string (if specified) must be surrounded by
  3473.                               quote marks (").
  3474.  
  3475.     COMMENT <string>        - writes the specified string to the current
  3476.                               usage log (if active).  The string must be
  3477.                               surrounded by quote marks (").
  3478.  
  3479.  
  3480.     Any line in a script file beginning with a semi-colon (;) is
  3481.     considered a comment line, and will not be processed or interpreted.
  3482.     Note that all TurboTerm script keywords must be flush to the left
  3483.     margin for proper interpretation.
  3484.  
  3485.     Examples:
  3486.  
  3487.     ; TurboTerm! v2.0 Script file
  3488.     ;
  3489.     WAIT 2
  3490.     SEND "HHH"
  3491.     DUPLEX FULL
  3492.     WAITFOR "U#=" SEND "{PASSWORD}" TIMEOUT 10
  3493.     DUPLEX HALF
  3494.     BEEP ONE
  3495.     WRITE "Connected to GEnie"
  3496.     END
  3497.     ;
  3498.  
  3499.     The above script will logon to GEnie.  Note that, for proper
  3500.     operation, your user id and password should be defined in the
  3501.     associated dialing entry. (ie: xyz12345,password )
  3502.  
  3503.     The following script shows the ability to write complex applications
  3504.     with TurboTerm's scripting language.  This script will capture any
  3505.     waiting GEMail to a file called EMAIL.TXT, capture a list of new files
  3506.     in the IBM RoundTable to a file called IBMFILES.NEW, and then capture
  3507.     all new messages in the LiveWire Bulletin Board to a file called
  3508.     LIVEWIRE.TXT.  After completion of this script, TurboTerm will exit
  3509.     back to the DOS prompt.  On my system, I regularly run a similar
  3510.     script on a daily basis, by specifying it as the attached script for a
  3511.     special GEnie entry in my phone directory.  I then invoke TurboTerm
  3512.     from a batch file, using "TT @5" to automatically dial entry number
  3513.     five upon startup.
  3514.  
  3515.  
  3516.  
  3517.  
  3518.  
  3519.  
  3520.  
  3521.  
  3522.  
  3523.  
  3524.  
  3525.  
  3526.  
  3527.                                          52                          09-01-91
  3528.  
  3529.  
  3530.  
  3531.  TurboTerm 2.0                    Appendix C                  Script Commands
  3532.  
  3533.     ;  TurboTerm! v2.0 Script File
  3534.     ;
  3535.     ;  Script : GEMAIL.SCR  - captures waiting GEMail.
  3536.     ;  Created: 08/17/91 20:40
  3537.     ;  Author : Brian S. Dunworth
  3538.     ;
  3539.     ;  This script makes use of several of TurboTerm's script commands.
  3540.     ;
  3541.     ;  *Note:  The COMMENT lines will write comments into the current
  3542.     ;          USAGE log if it is active during the connect.  If the
  3543.     ;          USAGE log is inactive, the line will be ignored.
  3544.     ;
  3545.     ;
  3546.     ;------------------------------------------------------------------
  3547.     ;
  3548.     ; first, set up a conditional statement to check for our EMail...
  3549.     ;
  3550.     WHEN 1 "You have" GOTO MAIL
  3551.     ;
  3552.     ;  ..if we have letters waiting, we'll execute the MAIL procedure.
  3553.     ;
  3554.     ;
  3555.     ; -------------------------------
  3556.     ;  Logon
  3557.     ; -------------------------------
  3558.     WAIT 2
  3559.     SEND "HHH"
  3560.     ;
  3561.     ; Here, we switch the duplex, so that anyone looking over
  3562.     ; our shoulder won't see our password being entered.
  3563.     ;
  3564.     DUPLEX FULL
  3565.     WAITFOR "U#=" SEND "{PASSWORD}" TIMEOUT 10
  3566.     DUPLEX HALF
  3567.     ;
  3568.     ; -------------------------------
  3569.     ;  GEMail Main Procedure
  3570.     ; -------------------------------
  3571.     ;
  3572.     WAITFOR "tinue?" SEND "{Enter}" TIMEOUT 60
  3573.     ;
  3574.     ; if we get here, there was no mail waiting, so deactivate the
  3575.     ; conditional...
  3576.     ;
  3577.     WHEND 1
  3578.     ;
  3579.     ;
  3580.     ; Capture list of new files
  3581.     ;
  3582.     :BOARDS
  3583.     WAITFOR "P 1?" SEND "m615;3" TIMEOUT 60
  3584.     WRITE "Capturing IBM RT new files list"
  3585.     LOGNAME IBMFILES.NEW
  3586.     COMMENT "Capturing IBM RT file listing"
  3587.     WAITFOR "Library?" SEND "11" TIMEOUT 60
  3588.     LOG ON
  3589.     WAITFOR "Library?" GOSUB DONELOG TIMEOUT 32000
  3590.     SEND "exit"
  3591.  
  3592.  09-01-91                                53
  3593.  
  3594.  
  3595.  
  3596.  TurboTerm 2.0                    Appendix C                  Script Commands
  3597.  
  3598.     ;
  3599.     ; Capture messages
  3600.     ;
  3601.     WAITFOR "P 615?" SEND "m400;7" TIMEOUT 60
  3602.     WRITE "Scanning LiveWire Board"
  3603.     WAITFOR "1 ?" SEND "scr 0" TIMEOUT 100
  3604.     WAITFOR "1 ?" SEND "bro nor" TIMEOUT 30
  3605.     LOGNAME LIVEWIRE.TXT
  3606.     COMMENT "Capturing LiveWire BB Messages"
  3607.     LOG ON
  3608.     WAITFOR "1 ?" GOSUB DONELOG TIMEOUT 32000
  3609.     ;
  3610.     ; Log off GEnie and exit TurboTerm
  3611.     ;
  3612.     SEND "exit"
  3613.     WAITFOR "P 400?" SEND "bye" TIMEOUT 90
  3614.     ;
  3615.     WAITFOR "NO CARRIER" GOTO BYEBYE TIMEOUT 100
  3616.     ;
  3617.     END
  3618.     ;
  3619.     ;
  3620.     ; -------------------------------
  3621.     ;  GEMail Script   Subroutines
  3622.     ; -------------------------------
  3623.     ;
  3624.     ; Letters waiting
  3625.     :MAIL
  3626.     ;
  3627.     ;  If we got here, there was EMail waiting for us...
  3628.     ;
  3629.     WHEND 1
  3630.     ;
  3631.     WRITE "Capturing waiting EMail"
  3632.     WAITFOR "tinue?" SEND "m200;9" TIMEOUT 60
  3633.     WAITFOR "Command?" SEND "list" TIMEOUT 60
  3634.     LOGNAME EMAIL.TXT
  3635.     COMMENT "Capturing EMail"
  3636.     LOG ON
  3637.     WAITFOR "Command?" GOSUB DONELOG TIMEOUT 32000
  3638.     SEND "exi"
  3639.     WAITFOR "P 200?" SEND "top" TIMEOUT 15
  3640.     GOTO BOARDS
  3641.     ;
  3642.     :DONELOG
  3643.     ;  this small subroutine does nothing more than turn OFF the current
  3644.     ;  log file.  It is called a few times during this script...
  3645.     ;
  3646.     LOG OFF
  3647.     RETURN
  3648.     ;
  3649.     :BYEBYE
  3650.     ; This procedure will exit TurboTerm, and return to the DOS prompt.
  3651.     ;
  3652.     EXIT_TT
  3653.     ;
  3654.  
  3655.  
  3656.  
  3657.                                          54                          09-01-91
  3658.  
  3659.  
  3660.  
  3661.  TurboTerm 2.0                    Appendix D              TurboTerm Clipboard
  3662.  
  3663.  
  3664.     The TurboTerm clipboard functions as a scratch pad, a text editor, and
  3665.     a cut-and-paste tool for the telecommunications session.  The
  3666.     TurboTerm editor functions as a basic text editor of limited size, and
  3667.     is not meant to replace your favorite word processor.  The commands in
  3668.     the editor follow the WordStar conventions, and are described below.
  3669.     You will find that TurboTerm's clipboard has many useful functions on
  3670.     GEnie, CompuServe, and any other BBS that you happen to frequent.  The
  3671.     ability to cut-and-paste from your telecommunications session makes
  3672.     quoting messages a snap!  The discussion on the TurboTerm clipboard
  3673.     will be broken down into four sections.  The first will be a general
  3674.     discussion of the features in the clipboard, and what the terminology
  3675.     means.  The second will cover the basic command set governing editing
  3676.     of text in the clipboard.  The third will discuss how to cut and paste
  3677.     information to and from the clipboard and telecom session.  The fourth
  3678.     section is a walk through of how to use the TurboTerm clipboard to
  3679.     quote a message while online to GEnie.
  3680.  
  3681.     The maximum document size that the clipboard can handle is 10,000
  3682.     characters.  This means that typical files, less than 300 lines, will
  3683.     fit; anything larger will not.  TurboTerm's clipboard is not designed
  3684.     to take the place of your favorite text editor, it is designed to
  3685.     allow quick and effecient text editing without leaving your terminal
  3686.     session.  The percentage number shown on the clipboard status line
  3687.     indicates the percentage of clipboard workspace that is full.
  3688.  
  3689.     Word Wrap:
  3690.  
  3691.     Word wrap is a function which controls whether the editor will
  3692.     automatically wrap any typed text to the next line when the right
  3693.     margin is reached.  When word wrap is turned off, text will not
  3694.     automatically be wrapped to the next line.
  3695.  
  3696.     Indent mode:
  3697.  
  3698.     Indent mode controls whether the editor will automatically place you
  3699.     at the same column position as the previous line, when the line wraps
  3700.     or an <Enter> is pressed.  If word wrap is off, all new lines will
  3701.     begin at the left margin.
  3702.  
  3703.     Insert mode:
  3704.  
  3705.     Insert mode controls whether characters you type will be inserted into
  3706.     the text and the charters to the left be pushed to the right, or new
  3707.     characters will overwrite existing text.
  3708.  
  3709.     Right Margin:
  3710.  
  3711.     The clipboard right margin is configurable from 5 to 125 characters in
  3712.     length.  The default value is 60 characters.  This value is used to
  3713.     determine how the clipboard will wrap words when you are entering
  3714.     text, or during a reformat.
  3715.  
  3716.     Block handling:
  3717.  
  3718.     Blocks of text in the clipboard are handled on a line-by-line basis.
  3719.     This means that marking blocks for moving, copying, inserting, or
  3720.     deleting can only be done using entire lines of text.
  3721.  
  3722.  09-01-91                                55
  3723.  
  3724.  
  3725.  
  3726.  TurboTerm 2.0                    Appendix D              TurboTerm Clipboard
  3727.  
  3728.  
  3729.     Timer:
  3730.  
  3731.     While editing in the clipboard, keystrokes are NOT echoed to the
  3732.     modem.  Since many host systems will "time out" when you are not
  3733.     actively doing something on the system, TurboTerm has a built-in
  3734.     timer/warning mechanism.  The timer will always display in the bottom
  3735.     right hand corner of the screen, indicating the number of minutes and
  3736.     seconds you have been editing in the clipboard. If you have the
  3737.     warning time set in the configuration file to any value other than 0
  3738.     minutes, TurboTerm will sound a warning whistle when the specified
  3739.     time is reached.  This is a handy feature to prevent you from
  3740.     accidently getting disconnected from a host system when you have been
  3741.     idle too long.
  3742.  
  3743.     Line and Column postion:
  3744.  
  3745.     The clipboard status line will continually update the current column
  3746.     and line number of the cursor positon.
  3747.  
  3748.     Clipboard commands:
  3749.  
  3750.     The clipboard command set is a subset of the WordStar commands.  While
  3751.     in the clipboard, a brief help menu is available by typing <F1>.  The
  3752.     following chart outlines the various commands available:
  3753.  
  3754.  
  3755.     Command          Function
  3756.     -------          ---------
  3757.  
  3758.     <Right Arrow>
  3759.     <Ctrl-D>         Moves the cursor right one space.
  3760.  
  3761.     <Left Arrow>
  3762.     <Crtl-I>         Moves the cursor left one space.
  3763.  
  3764.     <Ctrl-Left>
  3765.     <Ctrl-A>         Move the cursor left one word. If the cursor is at
  3766.                      the beginning of a line, it is moved to the end of
  3767.                      the previous line.
  3768.  
  3769.     <Ctrl-Right>
  3770.     <Ctrl-F>         Move the cursor right one word. If the cursor is at
  3771.                      the end of a line, it is moved to the beginning of
  3772.                      the following line.
  3773.  
  3774.     <Home>
  3775.     <Ctrl-Q><S>      Move the cursor to the beginning of the line.
  3776.  
  3777.     <End>
  3778.     <Ctrl-Q><D>      Move the cursor to end of the line.
  3779.  
  3780.     <Up Arrow>
  3781.     <Ctrl-E>         Move the cursor up one line.
  3782.  
  3783.     <Down Arrow>
  3784.     <Ctrl-X>         Move the cursor down one line.
  3785.  
  3786.  
  3787.                                          56                          09-01-91
  3788.  
  3789.  
  3790.  
  3791.  TurboTerm 2.0                    Appendix D              TurboTerm Clipboard
  3792.  
  3793.     <Ctrl-W>         Set your right margin and reformat the clipboard.
  3794.  
  3795.     <Ctrl-Z>         Scroll display down one line.
  3796.  
  3797.     <PgUp>
  3798.     <Ctrl-R>         Scroll display up one page.
  3799.  
  3800.     <PgDn>
  3801.     <Ctrl-C>         Scroll display down one page.
  3802.  
  3803.     <Ctrl-Home>
  3804.     <Ctrl-Q><E>      Move cursor to top of edit window.
  3805.  
  3806.     <Ctrl-End>
  3807.     <Ctrl-Q><X>      Move cursor to bottom of edit window.
  3808.  
  3809.     <Ctrl-PgUp>
  3810.     <Ctrl-Q><R>      Move cursor to beginning of file.
  3811.  
  3812.     <Ctrl-PgDn>
  3813.     <Ctrl-Q><C>      Move cursor to end of file.
  3814.  
  3815.     <Del>
  3816.     <Ctrl-G>         Delete character at cursor.
  3817.  
  3818.     <Bksp>
  3819.     <Ctrl-H>
  3820.     <Ctrl-Bksp>      Delete character to left of cursor. If the cursor is
  3821.                      at the beginning of a line, the line will be joined
  3822.                      with the previous line.
  3823.  
  3824.     <Ctrl-Y>         Delete the current line.
  3825.  
  3826.     <Ctrl-Q><Y>      Delete from cursor to end of line.
  3827.  
  3828.     <Ctrl-T>         Delete word to right of cursor. If the cursor is at
  3829.                      end of a line, the following line is joined with the
  3830.                      current line.
  3831.  
  3832.     <Enter>
  3833.     <Ctrl-M>         Start a new line.
  3834.  
  3835.     <Tab>
  3836.     <Ctrl-I>         Move the cursor to the next tab stop. If insert mode
  3837.                      is on, any text to the right of the cursor is moved
  3838.                      to the right of the tab stop.
  3839.  
  3840.     <Ctrl-P>         Insert control character.  For example, to insert a
  3841.                      <Ctrl-G>, you would enter <Ctrl-P><Ctrl-G>.  Control
  3842.                      characters are displayed as uppercase characters.
  3843.  
  3844.     <Ins>
  3845.     <Ctrl-V>         Toggle insert mode on and off. A fat cursor indicates
  3846.                      insert mode, a thin cursor indicates overtype mode.
  3847.  
  3848.  
  3849.  
  3850.  
  3851.  
  3852.  09-01-91                                57
  3853.  
  3854.  
  3855.  
  3856.  TurboTerm 2.0                    Appendix D              TurboTerm Clipboard
  3857.  
  3858.     <Ctrl-O><I>      Toggle auto-indent mode on or off. In auto-indent
  3859.                      mode, pressing <Enter> while in insert mode will
  3860.                      cause the newly typed line to have the same
  3861.                      indentation level as the previous line.  Auto-indent
  3862.                      mode also affects the way text is formatted when word
  3863.                      wrap occurs.  The new line will have the same
  3864.                      indentation level as the previous line, and hence the
  3865.                      behavior of the reformatting commands (<CtrlB> and
  3866.                      <AltR>).
  3867.  
  3868.     <Ctrl-O><W>      Toggle word wrap on and off. When word wrap is on,
  3869.                      any attempt to insert or append text beyond the right
  3870.                      margin will cause a new line to be inserted following
  3871.                      the current line and all words that are at least
  3872.                      partially beyond the right margin will be moved to
  3873.                      the new line.
  3874.  
  3875.     <Ctrl-B>         Reformat the current paragraph.
  3876.  
  3877.     <Alt-R>          Reformat the entire clipboard. Use this command with
  3878.                      caution.
  3879.  
  3880.     <Ctrl-Q><L>      Restore original contents of the current line.
  3881.  
  3882.     Block commands:
  3883.  
  3884.     <Ctrl-K><R>      Read a block of text into the clipboard at the
  3885.                      current line position.
  3886.  
  3887.     <Ctrl-K><W>      Write a marked block af text to a disk file.
  3888.  
  3889.     <Ctrl-K><B>      Mark the begining line of a block of text.
  3890.  
  3891.     <Ctrl-K><K>      Mark the ending line of a block of text.
  3892.  
  3893.     <Ctrl-K><V>      Move a block of text.
  3894.  
  3895.     <Ctrl-K><C>      Copy a block of text.
  3896.  
  3897.     <Ctrl-K><Y>      Delete a block of text.
  3898.  
  3899.     <Ctrl-K><H>      Unmark a block of text.
  3900.  
  3901.  
  3902.     Other commands:
  3903.  
  3904.     <F1>             Display a help screen, listing the most often used
  3905.                      keystrokes.
  3906.  
  3907.     <F2>             Load a new file into the clipboard at the current
  3908.                      cursor position.
  3909.  
  3910.     <F3>
  3911.     <Ctrl-K><S>      Save the clipboard contents to a file.
  3912.  
  3913.  
  3914.     <Alt-C>          Clear the contents of the current clipboard.
  3915.  
  3916.  
  3917.                                          58                          09-01-91
  3918.  
  3919.  
  3920.  
  3921.  TurboTerm 2.0                    Appendix D              TurboTerm Clipboard
  3922.  
  3923.  
  3924.     Entering and exiting the clipboard:
  3925.  
  3926.     <Alt-F5>         Enter the clipboard.
  3927.  
  3928.     <Esc>
  3929.     <Ctrl-Break>     Exit the clipboard.
  3930.  
  3931.  
  3932.     Clipboard cutting and pasting:
  3933.  
  3934.     Cutting and pasting from the clipboard is a simple task, and will
  3935.     become second nature with just a little practice.
  3936.  
  3937.     To paste, we mean to take the contents of the clipboard and copy them
  3938.     to the terminal session as though you had typed them in manually.
  3939.     There are two ways to "paste" clipboard text; copying and *UPLOADing.
  3940.     Copying is used in applications where you want it to simulate manually
  3941.     typed text and *UPLOADing is a special GEnie fuction used for
  3942.     composing EMail or bulletin board messages.  Accessing both of these
  3943.     functions is done from within the terminal session, and not while in
  3944.     the clipboard.
  3945.  
  3946.     <Alt-F6>         Copy the contents of the clipboard to the terminal
  3947.                      seesion, using the delays stated for ASCII line and
  3948.                      character pacing set in the configuration file.  If a
  3949.                      prefix is active then any line copied in this manner
  3950.                      will have the prefix string added.
  3951.  
  3952.     <Alt-F7>         *UPLOAD the contents of the clipboard to the GEnie
  3953.                      mail editor.  This command isssues a *UPLOAD command
  3954.                      to the GEnie editor, waits for the "READY FOR INPUT"
  3955.                      command, and then begins sending the text using the
  3956.                      delays specified for ASCII line and character pacing
  3957.                      in the configuration file.  At the completion of the
  3958.                      *UPLOAD, a Ctrl-C is sent to tell GEnie that the
  3959.                      *UPLOAD is complete.  If a prefix is active then any
  3960.                      line *UPLOADed will have the prefix added.  Note that
  3961.                      for this function to work properly, you must have
  3962.                      Ctrl-C (ASCII 03) set as your "break" character on
  3963.                      GEnie.
  3964.  
  3965.  
  3966.     Getting text into then clipboard:
  3967.  
  3968.     There are two ways to get text into the clipboard; reading from a
  3969.     disk file and cutting it from the scrollback buffer.  Use the commands
  3970.     mentioned above to read from a disk file.  The following discussion
  3971.     will describe how, using scrollback, you can get text into the
  3972.     clipboard.
  3973.  
  3974.  
  3975.  
  3976.  
  3977.  
  3978.  
  3979.  
  3980.  
  3981.  
  3982.  09-01-91                                59
  3983.  
  3984.  
  3985.  
  3986.  TurboTerm 2.0                    Appendix D              TurboTerm Clipboard
  3987.  
  3988.     When scrollback is displayed on the screen, you will notice that one
  3989.     of the choices on the scroll bar is <Alt-W>.  <Alt-W> allows you to
  3990.     copy the text that is currently in scrollback to a file or to the
  3991.     clipboard.  If text is marked in the scrollback then only the marked
  3992.     text will be copied; if no marks are present then the entire contents
  3993.     of the clipboard will be copied.  If you attempt to copy more text
  3994.     into the clipboard than the clipboard can hold, the clipboard will
  3995.     truncate it at its limit.  The series of commands to move text from
  3996.     scrollback to the clipboard is <Alt-W><C>.
  3997.  
  3998.  
  3999.     Marking text:
  4000.  
  4001.     To mark text in scrollback, simply place the first line that you wish
  4002.     to mark on the bottom line of the scrollback window and press <Alt-M>.
  4003.     Then, place the bottom of the text you wish to mark on the bottom line
  4004.     of the scrollback window, and again press <Alt-M>.  TurboTerm will
  4005.     mark all text in the scrollback buffer between those two lines.  If
  4006.     you wish to copy that information to the clipboard, use the <Alt-W><C>
  4007.     command, or write it to a file using the <Alt-W><S> command.
  4008.  
  4009.  
  4010.     Sample quoting in the clipboard:
  4011.  
  4012.     Suppose you just received a letter from a GEnie subscriber, and in his
  4013.     message he asked two or three questions of you.  You could just do a
  4014.     typical GEnie mail reply, and answer the questions.   By the time the
  4015.     person who sent the original message receives the reply, he may have
  4016.     forgotten his message, and your reply may be meaningless.  This
  4017.     problem would be alleviated by quoting relevant portions of the
  4018.     original message in your reply, so that both the question and the
  4019.     answer were in the response.  To illustrate how quoting in TurboTerm
  4020.     might be handled, let's walk through a sample session, and see how the
  4021.     process works:
  4022.  
  4023.         Brian,
  4024.         Here is a copy of my CONFIG.SYS file that you asked for.  I hope
  4025.         that this will help you determine the reason TurboTerm does not
  4026.         work with my modem connected to COM2 at 2400 baud.  Thanks again
  4027.         for all your help!!
  4028.  
  4029.         SHELL=C:\DOS\COMMAND.COM /P
  4030.         DEVICE=C:\DOS\ANSI.SYS
  4031.         DEVICE=C:\DOS\RAMDRIVE.SYS 400 /E
  4032.         DEVICE=C:\DOS\SMARTDRV.SYS 1024 512
  4033.         DEVICE=C:\UTILS\MOUSE.SYS COM2
  4034.         FILES=20
  4035.         BUFFERS=20
  4036.  
  4037.  
  4038.         That's it Brian, my CONFIG.SYS file.  I truly hope you can get
  4039.         TurboTerm working for me since I run it on my machine at work, and
  4040.         I LOVE it.  Thanks...
  4041.  
  4042.                                              Tom
  4043.  
  4044.         =END=
  4045.  
  4046.  
  4047.                                          60                          09-01-91
  4048.  
  4049.  
  4050.  
  4051.  TurboTerm 2.0                    Appendix D              TurboTerm Clipboard
  4052.  
  4053.  
  4054.     Above is the letter from Tom, who is having a bit of difficulty using
  4055.     TurboTerm, and would like some assistance from Brian.  Brian, being
  4056.     the superb truobleshooter that he is, notices that Tom's mouse driver
  4057.     is on COM2, as is his modem.  Let's reply to the message.
  4058.  
  4059.     This is message one in Brian's mail queue, so he types "REPLY 1" at
  4060.     the GEMail command prompt. This tells GEnie that Brian is going to
  4061.     reply to message 1 in his mail queue.  GEnie responds with a short
  4062.     message and another prompt:
  4063.  
  4064.         1>
  4065.  
  4066.     First, we type in a short opening, like:
  4067.  
  4068.         1> Hi Tom,
  4069.         2> I received your mail today, and think I have found the problem.
  4070.         3>
  4071.         4>
  4072.  
  4073.  
  4074.     The first thing we want to do is thank Tom for his enthusiasm, and for
  4075.     sending us a copy of his CONFIG.SYS file.  We pull up scollback using
  4076.     <UpArrow>, and mark the first three lines of Tom's letter using the
  4077.     <Alt-M> command.  We then want those lines copied to our clipboard so
  4078.     we use the <Alt-W><C> command.
  4079.  
  4080.     A typical quoted message uses some form of identifier to show the
  4081.     quoted portions.  A typical identifier would be " > " (without the
  4082.     quote marks).  Knowing that, let's set our prefix to that string.
  4083.     Type <Alt-A><E>, and type <space><greater-than><space> in the prefix
  4084.     string.
  4085.  
  4086.     Tom's letter to Brian is in 80 colum format, and if we were to add the
  4087.     " > " prefix to each line, the text would wrap around to the next line
  4088.     and generally make a mess of things.  So, we should reformat Tom's
  4089.     letter (in our clipboard) to aproximately 60 characters in length.
  4090.     So, we enter the clipboard by typing <Alt-F5>, and see the text copied
  4091.     there from the scrollback buffer just seconds ago.  Now, we type
  4092.     <Ctrl-W>, and set the new right margin at 60.  TurboTerm will reformat
  4093.     the text in the clipboard, so that no line exceeds 60 characters in
  4094.     length.
  4095.  
  4096.     Now we are ready to quote his text.  We exit the clipboard and type
  4097.     <Alt-F7>.  At this point, we're prompted whether we wish to *UPLOAD
  4098.     the clipboard the clipboard contents.  We do, so we select <Y>es.
  4099.     TurboTerm issues a *UPLOAD command to GEnie, and waits for GEnie to
  4100.     respond with "READY FOR INPUT".  TurboTerm will then transmit the
  4101.     contents of the clipboard with the attached prefix and send a Ctrl-C
  4102.     at the completion of the *UPLOAD to tell GEnie that our upload is
  4103.     complete.  When GEnie has responded to the Ctrl-C, it will return us
  4104.     to the line editor.  Here is where we will thank him for his note.
  4105.  
  4106.  
  4107.  
  4108.  
  4109.  
  4110.  
  4111.  
  4112.  09-01-91                                61
  4113.  
  4114.  
  4115.  
  4116.  TurboTerm 2.0                    Appendix D              TurboTerm Clipboard
  4117.  
  4118.         9>
  4119.        10> Thanks for sending me a copy of your CONFIG.SYS file.  It
  4120.        11> enabled me to find the problem, and I'm sure that this will
  4121.        12> fix it.  In your CONFIG.SYS file, you had:
  4122.        13> CONFIG.SYS file you said you had:
  4123.        14>
  4124.  
  4125.     Now, we'll quote the CONFIG.SYS file he sent us.  To do this, we need
  4126.     to first clear the contents of the clipboard by typing <Alt-F5> to
  4127.     enter the clipboard, and <Alt-C> to clear it.  Now we'll mark the
  4128.     entire CONFIG.SYS file in our scrollback buffer, and copy it to the
  4129.     clipboard.  Again, we type <Alt-F7> and wait for the completion of the
  4130.     *UPLOAD.
  4131.  
  4132.        20>
  4133.        21> ...the problem appears to be that your mouse is connected to
  4134.        22> COM2, according to your CONFIG.SYS file.  Obviously, this will
  4135.        23> prevent TurboTerm from running on COM2.  My suggestion is to
  4136.        24> connect your modem to COM1, and leave the mouse on COM2.  You
  4137.        25> might also put the mouse on COM1, and the modem on COM2.  The
  4138.        26> point is, you can't have both devices on the same port at the
  4139.        27> same time.
  4140.        28>
  4141.        29> If you need any further help, feel free to drop me a note.
  4142.        30> Again, thanks for your support and registration.
  4143.        31>
  4144.        32> See ya online!
  4145.        33> Brian
  4146.        34>
  4147.  
  4148.     Now that our reply is complete, let's review how it looks:
  4149.  
  4150.        34>*L
  4151.  
  4152.     GEnie will respond with:
  4153.  
  4154.  
  4155.  
  4156.  
  4157.  
  4158.  
  4159.  
  4160.  
  4161.  
  4162.  
  4163.  
  4164.  
  4165.  
  4166.  
  4167.  
  4168.  
  4169.  
  4170.  
  4171.  
  4172.  
  4173.  
  4174.  
  4175.  
  4176.  
  4177.                                          62                          09-01-91
  4178.  
  4179.  
  4180.  
  4181.  TurboTerm 2.0                    Appendix D              TurboTerm Clipboard
  4182.  
  4183.         1  Hi Tom,
  4184.         2  I received your mail today, and think I have found the problem.
  4185.         3
  4186.         4   > Here is a copy of my CONFIG.SYS file that you asked for.  I
  4187.         5   > hope that this will help you determine the reason TurboTerm
  4188.         6   > does not work with my modem connected to COM2 at 2400 baud.
  4189.         7   > work with my modem connected to COM2 at 2400 baud.  Thanks
  4190.         8   > for all your help!!
  4191.         9
  4192.        10  Thanks for sending me a copy of your CONFIG.SYS file.  It
  4193.        11  enabled me to find the problem, and I'm sure that this will
  4194.        12  fix it.  In your CONFIG.SYS file, you had:
  4195.        13  CONFIG.SYS file you said you had:
  4196.        14
  4197.        13   > SHELL=C:\DOS\COMMAND.COM /P
  4198.        14   > DEVICE=C:\DOS\ANSI.SYS
  4199.        15   > DEVICE=C:\DOS\RAMDRIVE.SYS 400 /E
  4200.        16   > DEVICE=C:\DOS\SMARTDRV.SYS 1024 512
  4201.        17   > DEVICE=C:\UTILS\MOUSE.SYS COM2
  4202.        18   > FILES=20
  4203.        19   > BUFFERS=20
  4204.        20
  4205.        21  ...the problem appears to be that your mouse is connected to
  4206.        22  COM2, according to your CONFIG.SYS file.  Obviously, this will
  4207.        23  prevent TurboTerm from running on COM2.  My suggestion is to
  4208.        24  connect your modem to COM1, and leave the mouse on COM2.  You
  4209.        25  might also put the mouse on COM1, and the modem on COM2.  The
  4210.        26  point is, you can't have both devices on the same port at the
  4211.        27  same time.
  4212.        28
  4213.        29  If you need any further help, feel free to drop me a note.
  4214.        30  Again, thanks for your support and registration.
  4215.        31
  4216.        32  See ya online!
  4217.        33  Brian
  4218.        34
  4219.  
  4220.     Everything looks ok, so we send the message:
  4221.  
  4222.        34>*S
  4223.  
  4224.     Message 105687 sent to:  Tom.S
  4225.  
  4226.     Thats it!  We've completed a professional-style message quote!
  4227.  
  4228.  
  4229.  
  4230.  
  4231.  
  4232.  
  4233.  
  4234.  
  4235.  
  4236.  
  4237.  
  4238.  
  4239.  
  4240.  
  4241.  
  4242.  09-01-91                                63
  4243.  
  4244.  
  4245.