 {COMMO} (tm) Help  (C)Copyright 1989-1997 Fred P. Brucker  All Rights Reserved

[00.10] ****  Alt+H  Hang Up

 Disconnects the call by dropping DTR.  This will put the modem "on-hook" if
 response to DTR is enabled (see "Setting Up Your Modem").  If your modem does
 not respond properly, you may define a macro to send a "hang-up" command.  For
 modems using the "AT" command set the macro would look like this:

      {:alh} {send ~~~+++~~~ATH|} {}    Press Alt+H to hangup

 This macro will run when Alt+H is pressed, but you may assign any key you
 like.

 NOTE: In INT 14 mode, {COMMO} will send the hang-up command (shown above)
 instead of dropping DTR.


[00.20] ****  Alt+I  Screen Image Save


[00.30] ***  Keys in Screen Image Save Window

   Enter    Append the screen image to the indicated file.
   Alt+N    Change the filename without saving the screen.
   PgUp     Look behind the window.


[00.40] ***  Description of Screen Image Save

 The Screen Image Save is used to append all of the text currently on the
 screen to a disk file.  The current path\filename is displayed when the window
 is opened.

 TIPS on using Screen Image Save:

  >   Set the filename to "PRN", "LPT1" or "LPT2" to print the screen.

  >   If the file cannot be opened, the old path\filename is retained.

  >   The path\filename may not be the same as the path\filename of an open
      Capture File.

 NOTE: The current Screen Image Save file is also used to save blocks of text
 in the Scrollback feature.

 See also "Alt+1  Capture File Options" and "Alt+K  Scrollback."


[00.50] ****  Alt+K  Scrollback


[00.60] ***  Keys in Scrollback Window

   Down     Scroll screen down one line.
   Up       Scroll screen up one line.

   PgDn (or Space)   Scroll screen down one page.
   PgUp              Scroll screen up one page.

   Ctrl+PgDn   Go to end of buffer.
   Ctrl+PgUp   Go to beginning of buffer.

   S    Search for text from top of file.
   D    Search from current top of page.
   A    Search again, same text.

   C    Change the Screen Image Save path\filename.

   W    Write a block of text to current Screen Image Save file.  You will be
        prompted to position the Selector Bar to the start and then to the end
        of the block.  Use the arrow keys, PgUp, PgDn, etc.

   F10    Mark the current position in the buffer and exit.  The next time you
          call Scrollback you will return to this position (unless it has
          scrolled off the top of the buffer).

   Alt+D    Jump to Dialing Directory.  Mark current position.
   Alt+M    Jump to Macro Processor.  Mark current position.
   Alt+X    Terminate {COMMO}.  If a macro exists at the label "alx", {COMMO}
            will execute the macro instead.  The built-in variable "_pfw" will
            be set to "1".


[00.70] ***  Description of Scrollback

 Scrollback allows you to see what was previously on your screen.  Screen data
 is saved to a memory buffer (the size is defined in the Setup File).  Set the
 size to 0 to disable the feature entirely.


[00.80] ****  Alt+L  Capture File Options

 This is a special version the Alt+1 command that is friendlier to speech
 users.  See "Alt+1  Capture File Options" for additional information about
 Capture Files.

 NOTE: The Alt+L window is a menu and the keys are self-explanatory.


[00.90] ****  Alt+M  Macro File

[01.00] ***  Keys in Macro File Window

   Down     Selector Bar down one line.
   Up       Selector Bar up one line.
   Right    Scroll screen right.
   Left     Scroll screen left.

   PgDn     Scroll screen down one page.
   PgUp     Scroll screen up one page.
   End      Selector Bar to bottom of screen.
   Home     Selector Bar to top of screen.

   Ctrl+PgDn    Go to end of file.
   Ctrl+PgUp    Go to beginning of file.

   E        Edit the Macro File.
   Alt+E    Edit with external editor.
   L        Load a new auxiliary Macro File.
   T        Toggle display between resident and auxiliary (or Alt+M).

   Enter    Start macro at Selector Bar.
   V        View String Variable Space.
   Alt+C    Compile the displayed Macro File.

   S    Search for text from top of file.
   D    Search from current top of page.
   A    Search again, same text.

   Alt+D    Jump to Dialing Directory.
   Alt+K    Jump to Scrollback window.
   Alt+X    Terminate {COMMO}.  If a macro exists at the label "alx", {COMMO}
            will execute the macro instead.  The built-in variable "_pfw" will
            be set to "1".


[01.10] ***  Description of Macro File

 Macros may be used to reassign {COMMO} key commands to different keys.  They
 may be used to alter the behavior of key commands.  And they may be used to
 perform complex tasks when you write macro "scripts."

 The Macro File window displays {COMMO} Macro Files which are currently in
 memory -- resident and auxiliary.  Resident macros are loaded at program
 startup (the default resident file is COMMO.MAC).

 An auxiliary Macro File can be loaded, replaced or unloaded at any time using
 the CALL, GOTO and UNLOad macro functions.  An auxiliary can also be loaded
 manually within the window.  See "{COMMO} Support Files" for more details on
 Macro Files.

 Within the Macro File window, macros from either the resident or auxiliary
 Macro File may be selected for execution or edited.

 IMPORTANT!  Only macros currently in memory can execute.


[01.20] ***  Keyboard Macros: Customizing Key Commands

 This section shows you how easy it is to assign a key to perform almost any
 program function or combination of functions.  See "Programming {COMMO}
 Macros" for more details on the {COMMO} Macro Language.

 For example, suppose you want to press Ctrl+F5 to send your name followed by a
 carriage return.  You can enter a simple macro in your Macro File to do this.

 Press Alt+M, then "E" to edit.  Position the cursor where you want your new
 macro to be, then press Alt+I a few times to open some space.  Now type in
 this macro using your name in place of "First Last":

      {:cf5} {send First Last|} {}

 This simple macro has the basic components of any macro.

      {:cf5}        label (the entry point).
      {send ...}    function (the action part).
      {}            STOP (to terminate the macro).

 When Ctrl+F5 is pressed, {COMMO} will search the Macro File for {:cf5} and
 execute the macro function(s) that follow.  In this case the string "First
 Last|" will be sent to the serial port.  Notice that the "|" converts to a
 carriage return.

 A keyboard macro may also be used to change a default key assignment.  For
 example, Alt+K will normally bring up the Scrollback Buffer window.  If you'd
 rather use the Up Arrow key for this purpose, enter this macro:

      {:upa} {scroll} {}

 TIPS on creating keyboard macros:

  >   The "key-labels" used to start keyboard macros may be predefined or user-
      defined.  See "{COMMO} Macro Key-labels" for complete details.

  >   "ASCII Character Representation" explains how to represent special
      characters (such as carriage returns) in macros.

  >   Press Alt+E while using the Internal Editor to see the complete list of
      editing keys and editing rules.


[01.30] ***  Compiling Macro Files

 Macro Files may be compiled to increase speed, to reduce size and to improve
 security of source code.  Compiling is done from within the Macro File window.
 The default extension for {COMMO} compiled macros is .CCM, but you may edit
 the filename as desired.

 A compiled Macro File is used in exactly the same way as a source Macro File.
 The only difference is that operations in the Macro File window, such as
 searching for text or starting a macro with the Selector Bar, are not
 available.  This means that the {macro string} style of menus is also not
 available.  Use the MENU function instead.

 TIPS on using compiled macros:

  >   The Macro Compiler version number in {COMMO} must match the version
      number in the compiled Macro File.  {COMMO} will issue a warning message
      if they are different.  To see the version number in the file, use the
      DOS "type" command or your favorite file viewer or editor.

  >   Macro function names (LOOKfor, SEND, etc.) are checked for validity at
      compile time, but all other errors are reported at run time.  Be aware
      that the location of the error cannot be shown without having the source
      macros present.


[01.40] ****  Alt+N  Multi Number Dialing

 Any number of entries may be "marked" in the Dialing Directory, then
 automatically dialed in sequence until a connection is established.  Multi
 Number Dialing may be initiated in one of the following ways:

  >   Bring up the Dialing Directory window with Alt+D, then move the Selector
      Bar to each desired entry and press Space (repeat the procedure to unmark
      an entry).  Press Alt+N to begin dialing at the location of the Selector
      Bar.  NOTE: You can also press "T" to tag an entry or "R" to untag an
      entry without moving the Selector Bar.

  >   Specify entries with Dialing Strings on the command line used to run
      {COMMO} (see "Command Line Options").  Specified entries will be marked
      and dialed in sequence when {COMMO} is started.

  >   Specify entries with Dialing Strings in a macro, using the MARK macro
      function.

  >   Press Alt+N from the Terminal Screen.  Dialing of marked entries will
      resume with the next system in the sequence.

 See also "Alt+D  Dialing Directory" and the DIAL macro function.


[01.50] ****  Alt+O  Send Modem Initialization String

 Pressing Alt+O at any time from the Terminal Screen will cause the Modem
 Initialization String to be sent to the modem (if one is defined).  This is
 useful if your modem was powered off or if the modem setup was changed.


[01.60] ****  Alt+P  Set Terminal Parameters


[01.70] ***  Keys in Terminal Parameters Window

   D      Edit DEFAULT settings.
   C      Edit the CURRENT settings.

          The settings are presented as a string of five parameters (as they
          appear on the Status Line).  Make the desired changes and press
          Enter.  Be sure to keep the commas and don't add any extra spaces.

   F10    Save changes to all settings and exit.  Changes to default settings
          will be used the next time you dial.  Changes to current settings
          become effective immediately.


[01.80] ***  Description of Terminal Parameters

 The Terminal Parameters determine the method of transmission of data to and
 from your computer.  In {COMMO}, they are usually displayed or defined with a
 string.  For example:

      {38400,8n1,1,A,0}     Speed,format,port,terminal,delay.

 These values are defined initially in the Setup File with the following
 keyword items: bps, fmt, por, emu, icd.

 {COMMO} keeps two complete sets of Terminal Parameters, both of which are
 initially set to the values specified in the Setup File:

  >   The CURRENT settings.  These are always shown on the left side of the
      Status Line.  They reflect the current state of the serial port and may
      be changed with the Alt+P key command or with the PARMs macro function.

  >   The DEFAULT parameters.  Whenever a number is dialed, the current
      settings are changed to the default Terminal Parameters.  Adjustments are
      then made for any overrides specified in the Dialing Directory.  These
      may be changed for the current session with the Alt+P key command or with
      the DPARms macro function.


[01.90] **  Speed

 The rate at which data travels between your computer and your modem (or remote
 system if no modem is used).  It is specified as "bits per second" or "bps."
 You can set any (integer) port speed that is valid for your serial port (or
 internal modem).  If you try to set an invalid speed, {COMMO} will set the
 nearest valid speed.

 IMPORTANT!  This parameter is not usually the same as your modem's maximum
 connect speed (e.g., 28800).  Modems faster than 2400 bps are almost always
 buffered and require a speed up to four times the modem's maximum connect
 speed.  The maximum port speed (e.g., 115200) can be changed if your hardware
 requires it.  See the "com" item under "Alt+G  Edit Setup File" for details.

 The speed field may also be used to indicate INT 14 driver mode.  See
 "External Comm Drivers (INT 14)" for details.


[02.00] **  Data Format

 This consists of three parts.  Allowable values are:

      character length:  7, 8
      parity:  none (n), even (e), odd (o), mark (m), space (s)
      stop-bits:  1, 2

 Examples:

      7o2     7 bit characters, odd parity, 2 stop bits
      8m1     8 bit characters, mark parity, 1 stop bit

 The most common formats, "8n1" and "7e1", may be abbreviated to "8" and "7" in
 Terminal Parameter strings, such as:

      {38400,8,1,A,0}


[02.10] **  Serial Port

 1=COM1, 2=COM2, ... , 16=COM16.  Non-standard ports may be defined with the
 "com" item in the Setup File.


[02.20] **  Terminal Emulation Type

 {COMMO} supports the following terminal types:

      ANSI-BBS  (A)
           For calling most bulletin board systems.

      VT102     (V)
           For calling certain mainframes and online services.

      TTY       (T)
           For turning off almost all control functions (lets you see ANSI
           control sequences).


[02.30] **  Inter-Character Delay

 This factor defines the amount of delay to insert between characters
 transmitted by the SEND macro function and by ASCII Upload.  Use only when the
 remote is too slow to process the data (drops characters).

 Each unit is about 5 thousandths of a second (5 ms) on a 4.77 MHz XT class
 machine.  Faster machines require higher values -- on a 12 MHz AT each unit
 will only be about 1 ms.

 For example, to delay 20 ms between characters (50 cps) use a factor of:

             4 on 4.77 MHz XT
            16 on 12 MHz AT
            27 on 20 MHz 386
            55 on 25 MHz 486
           300 on 90 MHz Pentium

 The factor will also vary when you use multi-tasking software, so adjust as
 necessary.  The maximum delay allowed is one second.


[02.40] ***  How to Set Terminal Parameters


[02.50] **  With the Alt+P Key Command

 Alt+P may be used at any time to change the default Terminal Parameters or the
 current settings.  Remember that current settings will be reset to the default
 parameters whenever dialing begins.


[02.60] **  In the Dialing Directory

 Terminal Parameters may be specified in a Dialing Directory entry to OVERRIDE
 the default Terminal Parameters.  Specify only values that are different.  For
 example:

      {,,3,V}
           A different serial port and terminal emulation is required for this
           call.

      {,7e1}
           Different format required.


[02.70] **  Using the Macro functions PARMs and DPARms

 Use these to set Terminal Parameters during macro execution.


[02.80] ****  Alt+S  Shell to DOS

 When you Shell to DOS {COMMO} remains resident in memory and you may perform
 any DOS functions as you normally do.  Since {COMMO} is small in size, most of
 your memory is available when you use this key command.

 If you need additional memory, you can use {COMMO}'s Swap to Disk feature.  To
 use this feature you will need to do two things:

  1)  Be sure that a Swap File is specified in your Setup File (look for the
      "swp" item under "Paths and Files").

  2)  Enter the following simple macro in your Macro File:

           {:als} {shell-s} {}

      This macro will Shell to DOS using Swap to Disk when you press Alt+S (by
      using a different key assignment, Alt+S can still be used for Shell to
      DOS with no swap).


[02.90] ****  Alt+T  Set Toggles

 This key command is used to set a number of miscellaneous toggle (yes/no)
 parameters.  Some take effect while you are still in the Set Toggles window,
 others when you exit the window.

 Press the letter at the left of each item to toggle the setting.  Press Esc or
 Enter to exit.

 Some of the toggles will be described here.  The others are detailed in their
 respective sections of this document.


[03.00] ***  Sound Control Toggle

 This is the Master Sound Control toggle.  When sound is OFF all alarms, sounds
 and beeps will be silenced.  Alarms are individually controlled with items in
 the Setup File and with the "A" switch on EXECute and file transfer macro
 functions.


[03.10] ***  Local Echo Toggle

 Local Echo (sometimes called half-duplex) is normally used when you connect to
 a host that does not echo (i.e., send back) what you type.  Also, {COMMO} will
 assume that the host is sending a linefeed along with each carriage return.

 Typed characters will be displayed directly to the screen.


[03.20] ***  Signal Lights Toggle

 Turns ON/OFF the "modem lights" display on the Status Line.  Shows the state
 of the RS-232C signals, including send and receive.

 This toggles the right half of the Status Line from the System Name to the
 Signal Lights Display.  See "What is on the Status Line" for a complete
 description of the Status Line indicators.


[03.30] ****  Alt+U  Utility Menu

 The Utility Menu contains a selection of features supported by macros in
 COMMO.MAC.  Press the letter or number at the left of each item to activate
 the feature.

 Current features include:

      Add an entry to the Dialing Directory.
      Set current terminal emulation.
      Run the host mode macro, MOSTHOST.MAC.
      Edit the host mode macro.
      Edit any external text file less than 64k in size.
      Run any macro by name (label).
      Load any auxiliary Macro File.
      Unload the current auxiliary Macro File.
      Modify certain setup items for the current session.
      Toggle the Speech Friendly Interface ON/OFF.

 NOTE: The Utility Menu may not be available (or may have different features on
 its menu) if an auxiliary Macro File has been loaded.


[03.40] ****  Alt+W  Send Current Password

 Each entry in the Dialing Directory can have its own Password String.  After
 dialing a number, the Alt+W key command will send the current Password String
 to the remote system.

 Usually, a carriage return must be sent following the Password String.  This
 can be done manually by pressing Enter after pressing Alt+W.  Or you can send
 the carriage return automatically in one of the following ways:

  >   Place a "|" after the password in each of your Dialing Directory entries.
      For example:

                {pword|}

  >   Use the following macro to replace the default Alt+W command:

                {:alw} {send %_pas|} {}

 For additional details on passwords see "Alt+D  Dialing Directory."


[03.50] ****  Alt+X  Exit from {COMMO}

 This key command will cause {COMMO} to terminate, saving any support files
 with outstanding changes.

 You can configure {COMMO} to leave DTR high when exiting so that you can exit
 and remain connected to a system (this is the default, see "Alt+G  Edit Setup
 File").

 If {min=auto} in the Setup File, {COMMO} will not send the Modem
 Initialization String if you re-enter the program while still online.  You can
 also use the "/in" command line switch for this purpose.

 Alt+X may also be pressed from the Dialing Directory, Macro File or Scrollback
 windows for a quick exit.


[03.60] ****  Alt+1  Capture File Options


[03.70] ***  Keys in Capture File Options Window

   Enter    OPEN the indicated Capture File.
   Alt+1    CLOSE the current Capture File.

   Alt+S    Set Capture Mode to Screen.
   Alt+F    Set Capture Mode to Filter.
   Alt+R    Set Capture Mode to Raw.

   PgUp     Look behind the window.


[03.80] ***  Description of Capture File Options

 When Capture is OPEN all information displayed to your screen will be saved to
 the designated disk file.  This command allows you to:

  >   OPEN/CLOSE the Capture File.
  >   Change to a different file.
  >   Change the Capture Mode.

 Data may be captured in one of three different modes.  The startup Capture
 Mode is selected in the Setup File.

      If the mode is set to SCREEN, data will be captured exactly as it appears
      on the Terminal Screen (note that lines that wrap on the screen will
      appear as separate lines in the output file).  This mode greatly improves
      the appearance of the data captured from screens drawn with ANSI
      positioning sequences (e.g., animation).

      FILTER mode is used primarily when you need to capture lines longer than
      the width of the screen (e.g., to be printed on a wide carriage printer).
      Characters will be translated if the receive Translate Table is on.  ANSI
      control sequences will be stripped out if ANSI-BBS or VT102 emulation is
      on.

      Use RAW mode when you want all data captured exactly as it comes from the
      serial port.  ANSI control sequences will not be stripped and length of
      lines will be preserved.  This mode can be used to capture ANSI animation
      and color to be "played back" later.

 TIPS on using the Capture File:

  >   IMPORTANT!  When capturing to a floppy drive, the diskette should not be
      removed until the Capture File is closed (this also applies if the "disk
      full" message appears).  DOS may be unaware of the disk change and could
      overwrite the directory on the replacement disk.

  >   Some screens created with ANSI-BBS or VT102 emulation may appear
      distorted in the Capture File.  This is because the data was not received
      in sequence.

  >   When using SCREEN mode, data currently on the screen will not be written
      to the Capture File until the screen is cleared, the file is closed, etc.
      This is a result of the nature of SCREEN mode and is quite normal.

  >   If the disk fills up while capture is open, a "disk full" message will
      appear for several seconds.  The file will be closed and processing will
      continue.  The built-in variable "_dfc" will be set to 1.

  >   The old file will be closed if a new file is opened.

 Speech users can press Alt+L for a friendlier version of this command
 (supported by a macro in COMMO.MAC).

 See also "Alt+I  Screen Image Save."


[03.90] ****  Alt+2  Print Log Toggle

 Turns the Print Log ON/OFF.  When ON all information written to your screen
 will be printed to LPT1.  Handy for getting hard-copy of file lists, messages,
 etc.

 TIPS on using the Print Log:

  >   Some screens created with ANSI-BBS or VT102 emulation may appear
      distorted in the Print Log.  This is because the data was not received in
      sequence.

  >   Data currently on the screen will not be printed until the screen is
      cleared, the Print Log is turned OFF, etc.

  >   Flow Control should be used if your printer cannot keep up with the
      incoming data.


[04.00] ****  Alt+-  Chat Mode Toggle  (Alt minus)

 Chat Mode is normally used when you wish to converse via keyboard. The screen
 will be split with the upper portion showing what the remote is sending, while
 the lower portion shows what you type.

 The method used to send typed characters is selected in the Setup File under
 the section "Video and Chat Mode."  The two possible methods are:

  1)  Each character is sent as you type it.  This method is normally used when
      you are chatting with another person who is also in Chat Mode.

  2)  All characters are sent at once when you press Enter (up to 240
      characters will be buffered).  Use this method when you are using a
      teleconferencing system or "CB Simulator."

 The number of lines in the upper and lower portions of the screen (the "line
 split") may also be set in the "Video and Chat Mode" section.

 TIPS on using Chat Mode:

  >   Alt+- (Alt minus) is used to enter AND exit Chat Mode.

  >   All {COMMO} functions are available in Chat Mode except Doorway Mode.


[04.10] ****  Alt+=  Doorway Mode Toggle

 Definition: "Extended" keys are function keys, Alt keys, cursor keys, etc.  In
 other words, keys that do not generate ASCII characters.

 In Doorway Mode all extended keys will send their key codes to the remote
 (instead of activating {COMMO} functions).  Thus Doorway Mode can be used to
 operate most application software on the remote system when used with a host
 program such as Marshall Dudley's DOORWAY.  In addition, some BBS full-screen
 editors use Doorway Mode.

 TIPS on using Doorway Mode:

  >   IMPORTANT!  {COMMO} supports host printer redirection.  This means that
      Doorway may send data through the modem to be printed on LPT1, LPT2 or
      LPT3.  Be sure the printers are ready before starting or your system may
      hang.

  >   Alt+= is the default key to toggle Doorway Mode ON/OFF, but the "dmk"
      item in the Setup File may be used to define any key.   The defined key
      is necessarily reserved for exiting Doorway Mode and thus cannot be sent
      to the remote.  Be sure to configure remote applications accordingly.

  >   A macro must be present in the Macro File to toggle Doorway Mode.  The
      supplied macro is:

           {:al=} {doorway} {}         Toggle Doorway Mode

      If you redefine the key with "dmk", don't forget to change the key-label
      on the macro.

  >   Terminal-type should be set to ANSI-BBS.  It's a good idea to enter
      Doorway Mode before starting DOORWAY on the host computer (the host may
      send commands to initialize the terminal).

  >   When used with DOORWAY 2.22 or later, the Doorway Mode macro will execute
      automatically when the DOORWAY program (on the host system) starts up and
      when it exits back to DOS -- no keypress is necessary.

  >   The display should be set to the number of lines expected by the host
      program.  Usually this is 25 lines of text.  If your display is not in
      the proper mode, the results will be unpredictable.

  >   The Status Line is normally suppressed in Doorway Mode, but may be turned
      on by using the "S" switch in the Doorway macro:

           {:al=} {doorway-s} {}

      The "s" switch is ignored when exiting Doorway Mode and the Status Line
      will be restored to its previous state.  Remember that when the Status
      Line is on, there is one less usable line on the Terminal Screen.

  >   If it is necessary to clear the screen or to reset the terminal emulation
      mode parameters when starting Doorway Mode, modify the Doorway macro.
      For example:

           {:al=} {clear} {parms ,,,a} {doorway} {}

      This macro will execute when entering or exiting Doorway Mode.

  >   If Software Flow Control is enabled, the ASCII character values 17 and 19
      (XON and XOFF) will not display.  If these characters are needed,
      Software Flow Control should be turned off.


[04.20] ****  PgUp/PgDn  Uploading/Downloading


[04.30] ***  Description of Uploading/Downloading


 When you press PgUp or PgDn you will be presented with a menu of file transfer
 protocols.  Protocols provide the ability to transfer (send and receive) any
 type of data using error detection and correction techniques.

 Be sure you first tell the host system (BBS) that you want to Upload or
 Download.  When the host tells you to start your protocol, press PgUp or PgDn
 and select the desired protocol (Zmodem downloads will start automatically).
 Allow several seconds for the "handshaking."

 IMPORTANT!  When using emulations such as VT102, VT220 and Pine, press Alt+Z
 to get the File Transfer menu.  Then press U for upload or D for download.

 The PgUp and PgDn menus are implemented using {COMMO}'s powerful Macro
 Language which enables you to execute internal and external protocols easily
 and seamlessly.  You may alter these macros to suit your individual needs.

 The file transfer menus allow you to type in filenames for uploading
 (sending), or you may choose them from the File Selector window (see following
 section).


[04.40] ***  Description of File Selector

 The File Selector is used to tag files to be uploaded.  Multiple files may be
 tagged for batch protocols such as Zmodem or Ymodem.  Only one file should be
 selected when using the Xmodem, Kermit, BPlus or ASCII Upload protocols
 (Kermit will accept wildcards when typing the filename).

 Press Enter on lines that begin with "\" to navigate between directories.
 Press Space to mark or unmark files, then F10 to start the upload.


[04.50] ***  Keys in File Selector Window

   Down    Selector Bar down one line.
   Up      Selector Bar up one line.
   PgDn    Scroll screen down one page.
   PgUp    Scroll screen up one page.
   End     Selector Bar to bottom of screen.
   Home    Selector Bar to top of screen.

   Ctrl+PgDn    Go to end of file.
   Ctrl+PgUp    Go to beginning of file.

   Ctrl+A .... Ctrl+Z    Go to first file that begins with letter.

   Space    Mark/unmark a file for uploading.
   Alt+T    Mark all files.
   Y        Unmark all files.
   T        Mark a file, don't move selector.
   R        Unmark a file, don't move selector.

   F10      Done selecting, begin upload.
   Enter    Change to the highlighted directory.
   V        Change disk drives.
   F        Change the wildcard file specification.
   E        View/edit the list of files.
   Esc      Cancel the upload.

   S    Search for text from top of file.
   D    Search from current top of page.
   A    Search again, same text.


[04.60] ***  Internal Protocols


[04.70] **  Zmodem, Ymodem, Xmodem

 {COMMO} provides an extremely fast and efficient version of the Zmodem
 protocol, plus a number of variations on the Xmodem and Ymodem protocols.
 These afford you varying degrees of convenience, speed and security.

 ZMODEM is the preferred protocol on most host systems.  It features automatic
 startup of downloads, multi-file transfers and automatic naming and dating of
 received files.  Zmodem also affords greater data security through its 32 bit
 cyclic redundancy check and its ability to resume transfers that were
 interrupted (e.g., by loss of carrier).

 The "zr_mode" variable item in COMMO.SET controls the disposition of like-
 named files when downloading.  Four options are available when the incoming
 filename matches a filename in the download directory (choose only one):

      Skip (S) -- The file will be skipped (not downloaded).

      Resume (R) -- The file will be resumed (appended to) if the file in the
      download directory is smaller than the incoming file.  Otherwise, the
      transfer will be considered complete.

      reName (N) -- The incoming file will be renamed by changing the last
      character of "filename.ext" to a letter from A through Z.

      Overwrite (O) -- The existing file will be deleted and the incoming file
      will replace it.

 YMODEM is also capable of multi-file transfers and automatic naming/dating of
 incoming files.  Note that the standard macros are set to cancel a download
 when a like-named file is received.  {COMMO}'s Ymodem supports renaming and
 overwriting (as in Zmodem), but you must modify the macros in COMMO.MAC to do
 this (there is no menu support).

 XMODEM is the most basic protocol.  A filename must be supplied at both ends
 of the transfer (they need not be the same).

 There are a number of variations which apply to both Xmodem and Ymodem.  Their
 use depends upon what is offered by the remote system and whether or not you
 have an error-correcting modem.

      CRC
           This is a reliable block-check method and should be used whenever
           possible.

      Csum
           This block-check method is not as reliable and should not be used
           unless there is no other option.

      1k byte block size
           The larger block size is much more efficient and is preferred
           (unless noisy lines are causing a lot of block retransmissions).

      128 byte block size
           The small block size should be used only when there is no other
           option or on noisy lines.

      G
           The "G" method eliminates waiting for the receiver's response to
           each block and is therefore much faster.  It still performs error
           checking, but not error recovery.  Therefore it should only be used
           with an error-correcting modem or on a direct connection between
           computers.

           When an error is encountered, the transfer will be cancelled.
           Partial files will be kept.  The "G" method always uses CRC and 1k
           blocks.

 IMPORTANT!  The macros that support the internal protocols are set up for the
 most common situations.  Many variations are possible by modifying these
 macros.  Please refer to descriptions of the macro functions RZMOdem, RYMOdem,
 RXMOdem, SZMOdem, SYMOdem and SXMOdem for details.


[04.75] ***  Keys in Protocol Window

   Esc      Cancel batch transfer.
   Alt+S    Skip current file (Zmodem Receive only).  Partial files will be
            retained.
   Alt+H    Hang up (disconnect) at end of batch transfer.  If a macro exists
            at the label "alh", {COMMO} will execute the macro instead.  The
            built-in variable "_pfw" will be set to "1".  NOTE: Pressing Alt+H
            again cancels the automatic hangup.


[04.80] **  CompuServe BPlus

 BPlus is a file transfer protocol for CompuServe users which offers better
 network throughput than Xmodem or Ymodem.  BPlus uses the supplied program
 module BPLUS1.POV, which should be located in your {COMMO} home directory.

 When you see the protocol selection menu on CompuServe, select "B", "B+" or
 "QB".  Macros are provided in COMMO.MAC to upload and download with BPlus.

 To download a file:

  1)  When you get the "File name:" prompt, enter the filename as it appears on
      CompuServe.  Skip this step when downloading E-mail.

  2)  When you get the "File name for your computer:" prompt, enter the name
      the file should have on your computer (does not have to be the same as
      the filename on CompuServe).

  3)  Press PgDn and "B".

 To upload a file:

  1)  When you get the "File name:" prompt, enter the name as you want it to
      appear in the forum library.  This name must be CompuServe compatible:
      six characters maximum plus a three character extension.  Skip this step
      when uploading E-mail.

  2)  When you get the "Filename for your computer:" prompt, don't type
      anything.  Press PgUp and "B" and enter the filename or use the File
      Selector.  {COMMO} will send the filename for you and then send the file.


[04.90] **  ASCII Upload/Download

 Text files may be sent and received using the ASCII protocol.  This method
 performs no error checking or error correction and should only be used when
 other protocols are not available.

 It might be used, for example, to upload a prepared message to a host that was
 waiting for you to type the message.  Or it could be used to receive a
 bulletin or other information that you would normally read while on line.

 To upload a text file, use the Alt+A key command (see "Alt+A  ASCII Upload"
 for information about settings).  You can also use the Select window by
 pressing PgUp and selecting "A" for ASCII Upload.

 To download text information to a file, use {COMMO}'s Capture File feature.
 Use the Alt+1 (or Alt+L) key command to set the filename and Capture Mode.
 Open the Capture File just prior to receiving the information.  Then close it
 after all data has been received.  Note that the file may require some
 editing.  See "Alt+1  Capture File Options."


[05.00] ***  External Protocols

 The Macro File is pre-configured with macros that execute various external
 protocol programs.  You may add macros for any other protocol programs that
 you need.  See "Programming {COMMO} Macros" for details on writing macros.

 External protocol programs can be obtained from BBS's and other sources.  To
 install them, just place the executable files (e.g., HSLINK.EXE, DSZ.COM) in
 the directory which is specified in the "set protodir" Setup File item.  This
 item is in the "Paths and Files" section of COMMO.SET.  You may use your
 {COMMO} home directory, if desired.

 IMPORTANT!  All external protocol programs must be in the "protodir"
 directory.

 Each of the protocol programs has additional features that may be useful to
 you.  Refer to the program's documentation for more information.


[05.10] **  Using HS/Link

 HS/Link is a Shareware program that offers very fast file transfers.  The
 HS/Link protocol has all of the features of Zmodem.  In addition, it has bi-
 directional capability for uploading and downloading simultaneously with a
 full-duplex modem (make sure the remote system allows this feature before
 attempting it).

 When you select a download with HS/Link (or if it is started automatically
 with Auto Receive), you will be asked if you have "Any files to upload" as
 well.  Answer "no" (or just press Enter) for download only.

 The executable file to install is HSLINK.EXE.


[05.20] **  Using Kermit

 Kermit is a protocol that is often the only choice on institutional host
 systems.  To use Kermit, you must obtain Columbia University's MSKERMIT 3.0 or
 later.  This program is free for personal use and is available on BBSs,
 commercial services or from ftp.columbia.edu.

 The Kermit macros are set up to transfer only one file at a time (no batch
 mode), but wildcards may be used when typing in the filename.

 The executable file to install is KERMIT.EXE.  In version 3.14 and later there
 is a smaller executable called KERLITE.EXE that is designed to be used as an
 external protocol driver (rename it to KERMIT.EXE).


[05.30] **  External Zmodem

 Some users may prefer to use an external Zmodem driver.  This can be done
 easily by entering replacement macros for "z_recv" and "z_send".  If you add
 these at the top of COMMO.MAC, you won't have to change the existing macro
 structure (the new macros will override the old).

 Example macros for Omen Technology programs and Texas Zmodem are shown in
 SAMPLES.MAC.


[05.40] ****  F1  Online Help


[05.50] **  Keys in Online Help Topic Window

   Down    Scroll screen down one line.
   Up      Scroll screen up one line.

   PgDn (or Space)   Scroll screen down one page.
   PgUp              Scroll screen up one page.
   End               Selector Bar to bottom of screen.
   Home              Selector Bar to top of screen.

   Ctrl+PgDn    Go to end of current Help File.
   Ctrl+PgUp    Go to beginning of current Help File.

   S      Search for text from top of file.
   D      Search from current position.
   A      Search again, same text.

   C (or Left)    Go to Help Contents.
   F1             How to use Online Help.


[05.60] **  Keys in Online Help Contents Window

   Enter (or Right)    Go to Help Topic.

   Down    Selector bar down one line.
   Up      Selector bar up one line.

   PgDn    Scroll screen down one page.
   PgUp    Scroll screen up one page.

   Ctrl+PgDn    Go to end of Contents File.
   Ctrl+PgUp    Go to beginning of Contents File.

   S      Search for text from top of file.
   D      Search from current position.
   A      Search again, same text.

   F1     How to use Online Help.


[05.70] ****  How to Use Online Help

 The complete {COMMO} documentation is available when you press F1.  The Online
 Help support files (which have the file extension .HLP) must be in the {COMMO}
 home directory.

 Online Help is context-related, which means you will go directly to a topic
 from the various feature windows.  If the topic is already active (or if you
 press F1 from the Terminal Screen), you will return to your previous place in
 Help.

 From the Topic Window you can navigate to any other topic by pressing "C" (or
 Left Arrow) to bring up the Contents Window (list of topics).  From there you
 can select any topic by positioning the Selector Bar and pressing Enter (or
 Right Arrow).  Press "S" to search for text strings in either window.

 TIPS on using Online Help:

  >   Many Help topics are longer than one page (depending on the size of your
      screen).  You may need to scroll lines or pages to view the entire topic.

  >   Section headings begin with one or more asterisks.  The highest level
      headings have five asterisks; lowest level headings have one asterisk.

  >   From the Terminal Screen you can press Alt+F1 for Help if F1 is assigned
      in a macro (such as in VT102.MAC, etc.).

  >   You can only search for text within the current Help file (Online Help
      files must be less than 64k in size and therefore Help is divided into
      many files).

  >   See the HELP macro function for information on customizing your Online
      Help files.

