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

[00.10] *****  Special Topics


[00.20] ****  Internal Editor


[00.30] ***  Keys in the Internal Editor Window

  >   Navigation Keys:

   Down/Up       Cursor down/up.
   Right/Left    Cursor right/left.

   PgDn    Scroll screen down one page.
   PgUp    Scroll screen up one page.
   End     Cursor to end of line.
   Home    Cursor to beginning of line.

   Ctrl+PgDn     Go to end of file.
   Ctrl+PgUp     Go to beginning of file.
   Ctrl+End      Cursor to bottom of screen.
   Ctrl+Home     Cursor to top of screen.
   Ctrl+Right    Cursor to next curly brace field.
   Ctrl+Left     Cursor to previous curly brace field.
   Tab           Cursor to next tab stop.
   Shift+tab     Cursor to previous tab stop.
   F3, F4        Scroll screen vertically.
   F5, F6        Scroll screen horizontally.

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

   Esc      End edit, changes will be saved automatically.
   Alt+Q    Quit edit, changes will not be saved automatically.  See "Saving
            the Support Files" for details.

  >   Editing keys:

   Alt+F    Save file to disk.
   F2       An easy way to type "{" and "}".  Automatically selects
            the correct brace.

   Alt+C    Copy cursor line to paste buffer.
   Alt+I    Insert a blank line ahead of cursor line (or Ctrl+N).
            NOTE: Use the Enter key to insert lines at the end of the file.
   Alt+P    Insert paste buffer ahead of cursor line.
   Alt+T    Truncate from cursor to end-of-line.
   Alt+U    Undo (restore) current line.
   Alt+Y    Delete cursor line (into paste buffer) (or Ctrl+Y).

   Ins          Toggle insert mode.
   Del          Delete character under cursor.
                At end of line: join the next line.
   Backspace    Rubout character to left of cursor.
                At start of line: join to previous line.
   Enter        Split the line (Insert Mode ON).
                Go to start of next line (Insert Mode OFF).
                Insert new lines at the end of the file.

   F7       Display the Color Chart.
   Alt+K    Display a key code for KEYStuff, etc.


[00.40] ***  Description of the Internal Editor

 The Internal Editor is used to modify the Setup File, the Dialing Directory
 and the Macro Files.  In addition, it can be used to edit any external file up
 to 64k in size.

 See also "Input Line Editor," used to enter data at various prompts.

 TIPS on using the Internal Editor:

  >   The paste buffer is a single line and contains the last line you:
        -   changed in any way.
        -   deleted with Alt+Y.
        -   copied with Alt+C.

  >   Pressing Alt+P will insert the paste buffer into the file, above the
      cursor line.

  >   Lines may be up to 255 characters in length.

  >   The "undo" key, Alt+U, will restore the current line to its original
      contents if no scrolling or vertical cursor movement has occurred.

  >   "Tab" characters (ASCII 9) will NOT be expanded.

  >   A file will be re-written to the same path\filename from which it was
      loaded.


[00.50] ****  Input Line Editor

 The Input Line Editor is used to enter data at various prompts, usually
 indicated with an ASCII 16 (triangle) character.


[00.60] ***  Keys used with Input Line Editor

   Right/Left    Cursor right/left.
   End/Home      Cursor to end/beginning of data.
   Ins           Toggle insert mode.
   Del           Delete character under cursor.
   Backspace     Rubout character to left of cursor.
   Alt+Y         Clear input field (or Ctrl+Y).
   Enter         Accept input field.
   PgUp          Look behind the window.


[00.70] ****  Searching for Text in Files

 The text search feature is used to find a string of characters.  It is
 available in all File Windows (including Scrollback).  In the Online Help
 window it may be used to find a string in the current Help file.  Note that if
 the string appears more than once on a line, only the first find will be
 shown.  Case is ignored.


[00.80] ***  Keys Used for Searching

   S    Enter a string.  Search from the start of the file.  Use Alt+S in the
        Internal Editor.

   D    Enter a string.  Search from the current top of page.  Use Alt+D in the
        Internal Editor.

   A    Search again for the same string.  Searching starts at the start of the
        next line.  Use Alt+A in the Internal Editor.


[00.90] ****  ASCII Character Representation

 Sometimes it is necessary to enter control characters and other special
 characters in the {COMMO} support files or as input to {COMMO} key commands.
 For example, a carriage return (typed with the Enter key) is used to terminate
 your typed input.  Therefore a carriage return must be represented by some
 other character (or characters) in order to be used as data.

 {COMMO} converts represented characters to actual characters in various
 situations.  For example:

  >   Strings sent to the modem.  These include the Modem Initialization
      String, dialing prefixes and suffixes, telephone numbers, the Password
      String and the Pacing Character in ASCII Upload.  Also converted are
      strings sent by the macro functions SEND, SETGet (terminator response),
      SETLook ("no data" response), VTCUr and VTPAd.

  >   Strings used in other macro functions.  These include LOOKfor, GOLOok,
      CALOok, SSLOok, EXECute (see below) and DISPlay.

 All control characters may be represented using the (^) caret symbol (it is
 the shift character above the top row "6").  If you need to send a caret, use
 two carets (^^).

 For convenience, two "normal" characters have special meanings in certain
 contexts:

  >   The vertical bar (|) may be used to represent a carriage return.  If you
      need a vertical bar, use (^|).  In the EXECute function the vertical bar
      is NOT converted (it is used by DOS as the "pipe" symbol).

  >   The tilde (~) forces a one-half second delay when it is encountered in a
      string that is being sent to the modem.  If you need to send a tilde, use
      (^~).  Note that the tilde is used as a delay ONLY in strings that are
      sent to the modem.  In other strings the tilde is used as a tilde.

 Remember also that the percent sign (%) is used to introduce string variable
 names in macro function arguments, telephone numbers, etc.  In these
 situations, you must use two percent signs (%%) where an actual percent sign
 is required.

 Finally, curly braces { } are very special characters and may not be used as
 data in the support files.  They are represented as follows, using
 parentheses:

      Left curly brace       ^(
      Right curly brace      ^)

 Here is a list of some of the most common control characters and how to
 represent them.  Upper or lower case may be used.

      Carriage return        ^M or |
      Linefeed               ^J
      Tab                    ^I
      Formfeed               ^L
      Escape                 ^[
      Bell                   ^G
      XOFF                   ^S
      XON                    ^Q
      End of file            ^Z

 Here is a table of all ASCII control characters.  Values are decimal:

      0  ... ^@      8  ... ^H      16 ... ^P      24 ... ^X
      1  ... ^A      9  ... ^I      17 ... ^Q      25 ... ^Y
      2  ... ^B      10 ... ^J      18 ... ^R      26 ... ^Z
      3  ... ^C      11 ... ^K      19 ... ^S      27 ... ^[
      4  ... ^D      12 ... ^L      20 ... ^T      28 ... ^\
      5  ... ^E      13 ... ^M      21 ... ^U      29 ... ^]
      6  ... ^F      14 ... ^N      22 ... ^V
      7  ... ^G      15 ... ^O      23 ... ^W

 Most ASCII characters (including control characters below 32 and those in the
 extended graphic character set, 128 to 255), may also be typed using the ALT-
 NUMERIC-KEYPAD method as follows:

      1.   Hold down the Alt key (and keep it down).
      2.   Enter the ASCII code in decimal using the numeric keypad keys (1, 2
           or 3 digits are ok).
      3.   Release the Alt key.

 IMPORTANT!  ASCII 0, 10 and 13 may only be represented with the caret.


[01.00] ****  Terminal Emulation

 Terminal Emulation Type is indicated on the Status Line (in the Terminal
 Parameters string).  Available types are:

      A    ANSI-BBS
                Used on bulletin boards and other systems.

      V    VT102 (VT100 compatible)
                Used on Internet providers and mainframes.

      T    TTY
                Supports only the basic control characters.

 The Terminal Emulation Type (as defined by the default Terminal Parameters)
 will be set whenever a system is dialed.  It may be overridden for the current
 call by using the Parms field in the Dialing Directory entry.

 IMPORTANT!  The Terminal Emulation Type affects only received data (as
 displayed to the screen).  The proper macros must be installed to obtain the
 correct keyboard simulation.  The following sections describe how to do this.


[01.10] ***  ANSI-BBS Keyboard Support

 The sample Macro File, COMMO.MAC, includes macros to use the PC keypad keys
 (arrow keys, PgUp, PgDn, etc.) with most BBS full-screen editors.  These keys
 will also work with many other host applications.


[01.20] ***  VT102 Keyboard Simulation

 The VT102 keyboard simulation macro file, VT102.MAC, works best with the
 enhanced 101-key keyboard (turn on Numlock to use digits 0-9 and the period).

 IMPORTANT!  The PgUp and PgDn keys are part of VT102 emulation.  To bring up
 the upload or download protocol menus while VT102.MAC is loaded, press Alt+Z.

 VT102.MAC will load automatically if "vt102" is specified as the Linked Macro
 in a Dialing Directory entry.  For example:

   University UNIX  {555-1234} {password} {vt102} {}

 NOTE: VT102 is a superset of VT100.

 The following special VT102 keyboard functions are supported.  The first
 column is the PC key; the second column is the corresponding VT102 function:

           F1 ... F4              PF1 ... PF4
           Arrows                 Four cursor keys
           Home                   Home cursor
           Ctrl+Home              Insert line
           PgUp                   Page up
           Ctrl+PgUp              Delete line
           PgDn                   Page down
           Ctrl+PgDn              Clear screen
           End                    End of line
           Ins                    Insert mode
           Del                    DEL
           Ctrl+Backspace         Ctrl backspace (DEL)
           Keypad *               Keypad ,
           Keypad -               Keypad -
           Keypad +               Keypad Enter

 VT102 numeric keypad keys are auto-switched by the host system between numeric
 mode and application mode.  The four cursor keys are auto-switched between
 cursor mode and application mode.

 This file may be modified to create any keyboard support you desire (see
 description of VTCUr and VTPAd functions in the section "{COMMO} Macro
 Functions").


[01.30] ***  VT220 Keyboard Simulation

 VT220 keyboard simulation uses the file VT220.MAC.  All of the statements in
 the previous section apply (substitute the term VT220 for VT102).

 Note that {COMMO} does NOT support the enhanced display functions of the VT220
 terminal (it supports VT102).  Therefore the results may not be satisfactory
 in some cases.

 The following special VT220 keyboard functions are supported:

           F1 ... F4              PF1 ... PF4
           F5                     Break
           F6 ... F12             F6 ... F12
           Alt+F1 ... Alt+F4      F11 ... F14
           Alt+F5                 Help
           Alt+F6                 Do
           Alt+F7 ... Alt+F10     F17 ... F20

           Arrows                 Four cursor keys
           Home                   Find
           Ins                    Insert here
           Del                    Remove
           End                    Select
           PgUp                   Prev screen
           PgDn                   Next screen

           Keypad *               Keypad ,
           Keypad -               Keypad -
           Keypad +               Keypad Enter
           Backspace              DEL


[01.40] ***  Printer Support

 {COMMO} supports the ANSI/VT102 printer functions, controlled by the remote
 system:

  >   The "Printer ON/OFF" function will turn {COMMO}'s Print Log ON/OFF.

  >   The "Dedicated Printing" function will send all input from the serial
      port directly to the printer.  This allows for "transparent" transmission
      of printer data, including control codes.

  >   The "Print Screen" function will print the entire current screen.

 The printer should be on and ready to print when these functions are used or
 the system may hang.  When "Dedicated Printing" is active no characters will
 be displayed on the screen.

 TIPS on using terminal emulation:

  >   Whenever the emulation type is changed, {COMMO} will reset all mode
      parameters.  It is therefore important that the change be made BEFORE (or
      at the time of) connecting with a new host, since the host may transmit
      mode settings.

  >   If some screens do not look right when VT102 emulation is used, you may
      need to turn LINEWRAP off (it defaults to on).

      Linewrap may be turned on/off locally using the DISPlay macro function.
      Place one of the following in your login macro (or assign one of them to
      a key and execute it manually):

           {display ,,,^[[?7h}      linewrap ON
           {display ,,,^[[?7l}      linewrap OFF

  >   {COMMO} will support auto-switching to 132 column mode, but you must
      define the hardware video mode that causes your video adapter to switch
      to 25x132 (rows, columns).  See the item "avm" under "Alt+G  Edit Setup
      File" for details.  Note that your video adapter should be in 25x80 when
      you start {COMMO}.

  >   If colors do not always look right, it may be necessary to set the
      Terminal Screen colors in the Setup File to "07".  See the note under
      "Colors" in the section "Alt+G  Edit Setup File."


[01.50] ****  {COMMO} Auto Receive

 This feature will automatically start a macro when a specified string is
 received from the serial port and may be used for starting downloads.

 Up to 16 strings and respective macro labels may be defined in the "Terminal
 and Modem" section of the Setup File.  These are preconfigured for the Zmodem
 and HS/Link protocol "signature" strings, but you may change them or add new
 ones as desired.

 As an example, one of the Auto Receive strings in the Setup File is:

   {aut=pzbr,^XB00}    Auto Receive, Zmodem DL

 This means that when the string "^XB00" is received, the macro at label "pzbr"
 will be started.  This string is the Zmodem "signature" string and is sent
 repeatedly by the sender until the receiver is ready to receive files.

 In the Macro File you will find the corresponding macro:

   Zmodem   {:pzbr} ... {call z_recv} {}

 {COMMO} will execute the macro as soon as the signature string is received (be
 patient, a BBS may take several seconds to load and execute its own protocol
 program).

 IMPORTANT!  If you have not properly installed an external protocol program,
 the message "Bad command or file name" will be periodically displayed by DOS.
 If this happens type Ctrl+X repeatedly until the sender cancels the transfer.

 TIPS on using Auto Receive:

  >   If the macro called by Auto Receive EXECutes a DOS command, you may want
      to use EXECute Preview Mode for preliminary testing.  This will allow you
      to view the command before execution and to see the results afterwards.
      Preview Mode may be toggled on/off using the Alt+T key command.

  >   Auto Receive will not trigger on characters that are displayed to the
      screen while a macro is running.  If you need to download within a macro,
      you should do a LOOKfor to wait for the signature string, then CALL the
      download macro.

  >   Using short strings, such as "^E" for CIS B protocol may result in
      unexpected triggering of the macro.  This is because other systems may
      send the same string for a different purpose (to display a "club" symbol,
      for example).  Thus it may be necessary to disable a string at times or
      to discontinue its use.

  >   A string may be disabled by removing the corresponding macro label in the
      Macro File.  This may degrade performance since the Macro File must be
      scanned each time a "hit" occurs.  The best way is to remove the Setup
      File item.

  >   Auto Receive can be set up for protocols that do not send signature
      strings, such as Xmodem, Ymodem, Ymodem-G, etc.  Use the prompt that the
      BBS sends just prior to the file transfer.  For example, "Start your
      Ymodem-G now."  Note that different systems may use different prompts.

  >   The AUTO macro function may be used to define new strings after program
      startup.

 See also "TIPS on creating LOOKfor strings" under the LOOKfor macro function.


[01.60] ****  How to Read the Status Line

 The Status Line in the Terminal Screen is used to report events and to show
 important settings.

 The LEFT HALF of the Status Line might look like this:

     {38400,8n1,1,A,10}  scpNl  15m  

 The Terminal Parameters shown are the CURRENT settings.  They will be changed
 to the DEFAULT settings when a number is dialed from the Dialing Directory.
 Either set may be changed with the Alt+P command.

   38400   Speed
   8n1     Data Format
   1       Active Serial Port (1 = COM1)
   A       Terminal Emulation Type
   10      Inter-Character Delay (usually 0)

 In "scpNl" each letter represents a program toggle.  If the letter is
 uppercase (except Capture Mode), then the toggle is open or on.

   s    Capture Mode (screen, filter or raw)
   c    Capture File (open or closed)
   p    Print Log    (on or off)
   N    Master Sound (on or off)
   l    Local Echo   (on or off)

 The elapsed timer is reset whenever dialing is started and whenever a
 connection is established.  Time is reported in minutes.  The happy face
 character shows that a macro is executing.

   15m    Elapsed timer
         Macro is executing

 The RIGHT HALF of the Status Line may be toggled (use Alt+T) between the
 System Name (the host) and the Signal Lights Display.  The time of day is
 optional when the System Name is shown.

 If all Signal Lights were on, the display would look like this:

     BFPO RC D tr TS Ÿ ÷       8:45 pm

 Each symbol represents the state of a hardware or software condition:

   B    Break interrupt
   F    Framing error
   P    Parity error
   O    Overrun error
   R    Request to send        RTS
   C    Clear to send          CTS
   D    carrier Detect         CD
   t    character transmitted
   r    character received
   T    data Terminal ready    DTR
   S    data Set ready         DSR
   Ÿ    FIFO buffers enabled
   ÷    Hardware flow enabled


[01.70] ****  Usage Log Format

 Example of a connect entry:

   {On}   06/10/96  18:11     9600 bps    Channel 1

      {On}
           A connection was made.
      06/10/96
           Date of connect.
      18:11
           Time of connect.
      9600 bps
           Speed of connect as reported by the "success response string."
      Channel 1
           Name of system called.


 Example of a disconnect entry:

   {Off}  06/10/96  18:12     2:17        1 617 354 3230

      {Off}
           A call was terminated.
      06/10/96
           Date of termination.
      18:13
           Time of termination.
      2:17
           Duration of call in minutes:seconds.
      1 617 354 3230
           Telephone number of called system.  Includes override prefix and/or
           suffix, if present.


 Example of a file transfer entry:

   {RZ} 0  c:\ul\nlbbs.qwk  18988  1608 cps  0 errors

      {RZ}
           File was received with Zmodem.
      0
           0 means the file was transferred (or resumed) successfully.  1 means
           the file was not completed.
      c:\ul\nlbbs.qwk
           Path\filename of file.
      18988
           Bytes transferred (may not be equal to the size of the file if the
           transfer was incomplete or if the Zmodem resume feature was used).
      1608 cps
           Rate at which data was transferred in characters per second.  The
           clock is not started until initial protocol handshaking has been
           completed.  "** cps" indicates transfer time was too short or there
           was an error in the computation.
      0 errors
           Total number of errors (corrected if transfer was successful).

 NOTE: You may configure an external protocol program to make log entries to
 your {COMMO} Usage Log file.  The format of these entries is explained in the
 documentation for the protocol program.


[01.80] ****  {COMMO} and Multi-Tasking

 Special care has been taken to ensure that {COMMO} will operate efficiently
 when running under Windows, OS/2 and DESQview.  Note that if you use a more
 powerful computer, you will be less likely to have problems.

 TIPS on using {COMMO} in multi-tasking systems:

  >   Use of buffered UART chips (or the functional equivalent) is usually
      necessary to ensure smooth, error-free operation.  These are often
      designated as 16550A, 16C550, 16C650, etc.  8250 and 16450 chips are not
      buffered.

  >   Check all settings for the window in which {COMMO} will be running.  Be
      sure this window is configured to allow running in background (do NOT
      suspend background processing).  If {COMMO} drops characters, gets CRC
      errors or stalls when in background, try reducing the "Idle Sensitivity"
      setting, if applicable.

  >   Generally, foreground and background "time slices" should be equal.  Try
      reducing the value if characters are dropped when data is being received
      at high speeds.

  >   If you switch to another task, do not attempt to access any files which
      may be in use in the {COMMO} window.  Examples are the Capture File, the
      Screen Image File and files that may be currently involved in file
      transfers (upload or download).  You may freely access these files in the
      Shell to DOS or using a macro (within the same window).

  >   Users have reported improved performance under OS/2 with Ray Gwinn's
      SIO/VSIO replacement serial port drivers.  These are available on
      CompuServe (go os2user, lib 3), Exec-PC (OS/2 collection) and many other
      BBS systems.  Look for SIOnnn.ZIP (shareware).


[01.90] ****  Flow Control

 Flow Control is a signalling system used by communications devices to prevent
 data from being transmitted faster than it can be processed by the receiving
 system.  This is especially important when data is transferred at high speeds.

 Flow Control is initialized in the Setup File and is used by {COMMO} for both
 sending and receiving.  You may specify Hardware Flow Control, Software Flow
 Control or both.

 Hardware Flow Control uses the RTS/CTS lines in your RS-232C (serial port)
 cable to signal pause/resume without interfering with the data.  It is used
 when you are connected to a device which also recognizes RTS/CTS Flow Control
 (such as a high-speed modem or another computer connected with an appropriate
 null modem cable).  A CTS-off (send) pause will not be released automatically.

 Software Flow Control uses a control character called XOFF (or ^S) to signal
 the remote to pause.  XON (^Q) is the signal to "resume transmission."  This
 is normally used only for ASCII data, since these characters may appear
 randomly within binary data.  An XOFF pause will automatically be released in
 20 seconds if no XON is received.  It will also be released if you type a
 character in the Terminal Screen.

 TIPS on using Flow Control:

  >   Hardware Flow Control problems can generally be avoided by using the
      {hfc=auto} option in your Setup File.

  >   If your modem does not default to the proper setting, it may need to be
      initialized to utilize flow control (consult the modem manual for
      details).

  >   Since Software Flow Control uses the XOFF (ASCII 19) and XON (ASCII 17)
      characters, these will not display on the screen.  If it is necessary to
      display them, Software Flow Control must be turned off.

  >   It is especially important to use Flow Control when the Print Log is on,
      since data is usually received faster than it can be printed.  If you
      type a character to the remote during a flow control pause, the remote
      may begin sending again (some systems resume on any character, not just
      XON).  You may have to turn off the Print Log if this happens.


[02.00] ****  External Comm Drivers (INT 14)

 {COMMO} supports external communications drivers that use the standard INT 14
 (BIOS) interface.  These include various FOSSIL drivers, network
 communications drivers, Internet protocol drivers and the BIOS in your
 computer (the original INT 14 interface).

 You tell {COMMO} to use the driver by specifying the port speed as "*s", where
 "s" is a number from 0 to 7.  For example:

      {bps=*7}                 Setup File
      {parm *7,8n1,3,A,0}      Macro File
      {*5,7e1,1,V,0}           Dialing Directory

 The driver will map the number 0 to 7 into a port speed.  The standard (BIOS)
 mapping is 0=110 bps, 1=150 bps, 2=300 bps, 3=600 bps, 4=1200 bps, 5=2400 bps,
 6=4800 bps, 7=9600 bps.  Some drivers map other speeds.  For example, the X00
 FOSSIL driver maps 0=19200 bps and 1=38400 bps to allow speeds higher than
 9600 bps.

 Consult your driver documentation for details on installation and speed
 mapping.  Drivers may allow the speed to be "locked" (when installing the
 driver) and ignore the speed code provided by {COMMO}.

 Note also that drivers may map port numbers as 0=COM1, 1=COM2, etc.  In
 {COMMO} you still use 1=COM1, 2=COM2, etc.  The corresponding "com" item in
 the Setup File is ignored in driver mode.

 TIPS on using the X00 FOSSIL driver:

  >   Use the XU utility to activate the FOSSIL (prior to starting {COMMO}) or
      X00 will be operating in BIOS emulation mode only.

  >   In Win95 X00 may work better if you load it in the DOS window where it
      will be used.

  >   In Win95 you may get better results if you increase the size of the
      transmit and receive buffers to 2048 bytes.


[02.10] ****  {COMMO} Host Mode (regular version)


[02.20] ***  General Information

 MOSTHOST is a complete Host Mode written in the {COMMO} macro language.  The
 Host Mode can be used to remotely access your computer, or you can set it up
 so friends or associates can call to send or receive files to/from your
 system.

 All callers can upload to or download from one specified directory ("filedir"
 in the MOSTHOST configuration).  From the password protected DOS menu you can
 change to any desired directory.

 Features:
  >   Multiple users.
  >   File transfers.
  >   Sysop chat with word wrap.
  >   A complete DOS access menu (password protected).
  >   Using DOORWAY by Marshall Dudley you can access DOS directly from the
      remote.  Download DRWY222.ZIP (or later).  The author's BBS number is
      615-675-3282 (Byte Runner).


[02.30] ***  Installing the Host Mode

  >   Create two sub-directories beneath your {COMMO} directory called MHDATA
      and MHFILE (configurable in MOSTHOST.MAC).

  >   Make sure that MOSTHOST.MAC is in your {COMMO} home directory.

      The MHDATA directory will contain the User Data File, so keep it separate
      from the MHFILE directory, which will be accessible to all callers for
      uploading and downloading.  As sysop, you can use your DOS password to
      access any directory on your computer.

      Start up {COMMO} as you normally do for calling out.  Press ALT+U to
      bring up the utility menu.  Select "Install/View" and check the items in
      the configuration section of the host macro.

  >   Be sure to set "protodir" in the Paths and Files section of COMMO.SET.
      This item tells {COMMO} where to find any external protocol programs you
      may use.

  >   If you use the Doorway feature on the DOS menu, you will need to download
      Marshall Dudley's DOORWAY shareware program.  Place DOORWAY.EXE in a
      directory that is in your DOS path.


[02.40] ***  Maintaining the User File

 The User Data File USER.MHS is normally created and maintained by MOSTHOST.
 Three lines will be added for each user when they log on to the system for the
 first time: name, password and protocol.  Users may be deleted by deleting all
 three lines.


[02.50] ***  Enhanced Version of Mosthost

 An enhanced version of the MOSTHOST is available to registered {COMMO} users.
 Added features include: messaging with word-wrap, bulletins, expert mode, hot
 menus, separate files for menus (for easy customizing, adding color, etc.),
 file descriptions for uploads, and more.  See "Purchasing {COMMO}" or the file
 REGISTER.FRM for ordering details.


[02.60] ****  Error Message Explanations

 If you get an error message that you don't understand, check below for
 additional information.


 >>> A macro is running.  Terminate it?

 This message comes from a macro that is using the SETEsc function.  It is used
 as a warning to prevent accidental termination of macros.  Answer "No" to
 continue processing, "Yes" to stop.


 >>> Cannot locate command processor

 This is an unusual condition.  Type "SET" at the DOS prompt and be sure there
 is a "COMSPEC=" in the list.  If there is, make sure that COMMAND.COM is in
 the path specified.


 >>> Capture File Closed, DISK IS FULL!
 >>> Information not saved, DISK IS FULL!

 The Capture File and Screen Image File should be edited regularly to ensure
 that they are not occupying too much disk space.


 >>> Dial command too long

 The dial command is limited to 128 characters.


 >>> Edit space full!

 When any file that can be edited with {COMMO}'s Internal Editor is loaded,
 expansion space is allocated.  The amount of expansion space is determined by
 the "esf" item in the Setup File (default is 8k).  If this space fills up
 while editing, the warning will appear.

 Exiting {COMMO} and restarting, or using the Swap to Disk, will restore the
 full expansion space.  The total size of a file plus expansion cannot exceed
 64k bytes.


 >>> File is not text

 {COMMO} support files and other files edited with the Internal Editor must be
 proper ASCII text files.  They should have a CR/LF at the end of each line and
 should not contain the null character (ASCII 0).


 >>> Hardware flow control pause

 Hardware Flow Control (RTS/CTS handshaking) is in effect and the remote system
 (or your modem) has requested a pause.  Try waiting a few seconds for the
 pause to clear.  If that fails, try setting {hfc=auto} in your Setup File.  Be
 sure to restart {COMMO} after making this change.


 >>> Help topic not found

 One or more of your Online Help files has been corrupted.  Recopy the files
 DOC_nn.HLP (nn=00, 01, etc.) from your {COMMO} distribution diskette or
 archive to your {COMMO} directory.


 >>> Macro location not in file

 An attempt has been made to RETUrn to a Macro File that has been modified.
 Avoid editing Macro Files that are in use.


 >>> Not enough memory
 >>> Not enough memory for Scrollback

 These messages may occur at program startup.  Check the following:

  >   {COMMO} cannot allocate its internal buffers.  You must make more memory
      available.

  >   {COMMO} cannot load the Dialing Directory and/or Macro File.  Try
      reducing the size of either of these files.  Removing comments may help.
      Or make more memory available.

  >   {COMMO} cannot allocate the Scrollback Buffer.  Reduce its size or make
      more memory available.


 >>> Not enough memory
 >>> Program file not found
 >>> Unable to execute shell

 A problem was encountered during Shell to DOS or EXECute:

  >   There may not be enough memory to execute the command processor or
      external program you have specified.

  >   The program file you specified in an EXECute function using the "D"
      switch cannot be located.  Make sure you specify the full path and
      filename.

  >   Some other system error condition may exist.  Make sure that COMMAND.COM
      is still available in the "COMSPEC=" path.


 >>> Not enough variable space

 {COMMO} has run out of Variable Space.  Macros should delete (set to null)
 variables that are no longer in use.  You can allocate more Variable Space
 with the "vsp" item in the Setup File or with the "/v" command line switch.


 >>> Swap Failure, exiting to DOS

 This message will appear if {COMMO} cannot be fully restored when
 returning from a Swap to Disk.  This can result from one of these
 conditions:

  >   Unable to read the Swap File (file not found or file is unreadable).

  >   Unable to allocate the necessary memory (a TSR may have been loaded above
      {COMMO}'s kernel).


 >>> Unable to open file
 >>> File not found
 >>> Path not found
 >>> Too many files

 Check the following:

  >   Your "SET COMMO=" command in your AUTOEXEC.BAT file.  It may be
      specifying the wrong directory.
  >   That the path exists where the file should be.
  >   That the file itself exists (this won't be the problem if the file is
      being created).
  >   Too many files may be open.  You may need to increase your FILES=
      parameter in CONFIG.SYS.
  >   The Online Help Files must be located in your {COMMO} directory.
  >   You cannot use an open Capture File for any other purpose.


 >>> WARNING: another copy of {COMMO} is running!

 You probably Shelled to DOS and started another copy of {COMMO}.  This warning
 is provided to prevent overwriting of support files that have changed.

 If it is necessary to Shell to DOS and run {COMMO} again, use the Swap to Disk
 feature which will preserve any changes to your Dialing Directory, etc.  This
 detection does not work between windows in a multitasking environment
 (Windows, DESQview, etc.).

