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

[00.10] ****  Alt+G  Edit Setup File

 Pressing Alt+G allows you to edit the Setup File, COMMO.SET (see "Internal
 Editor" for details on editing).  The Setup File contains initial settings for
 many parameters used by {COMMO}.

 Items changed with the editor are not effective until the next time you start
 the program.  However, most items may be temporarily changed with key commands
 and/or macro functions while the program is running.

 Each item in the Setup File is enclosed in curly braces.  Items are designated
 with three letter "keywords" and may be present in any order.  There are no
 "required" items.  Most missing items will take on the default values shown in
 the examples below (AUT items and SET items have no default values).

 All text outside the curly braces is commentary and is ignored by {COMMO}.
 Avoid using curly braces other than to bracket setup items.


[00.20] ***  Predefining Variables with SET

 SET items predefine variables in {COMMO}'s String Variable Space.  The general
 form of a SET item is:

      {set name,string}

           name
                Any valid variable name.

           string
                A text string to assign to the name.  The string may not
                contain any variables.

 Any number of SET items may appear in the Setup File.  They may be used later
 in macros, in telephone numbers, etc.

 See "Macro Variables" for more information on variables.


[00.30] ***  Explanation of Setup File Items

 Items are listed in the same order as they appear in the Setup File.  Values
 shown are the default values.


[00.40] **  Terminal and Modem


[00.50] *  Default Terminal Parameters

    {bps=38400}     Serial port data rate (2400, 38400, etc.)
    {fmt=8n1}       Data format (8n1, 7e1, etc.)
    {por=1}         Serial port number (1=COM1, 2=COM2, etc.)
    {emu=A}         Emulation type (Ansi-bbs/Vt102/Tty)
    {icd=0}         Inter-character delay (0-999)

 These five items are the default Terminal Parameters.  They are the startup
 settings and will be restored each time a number is dialed.  If necessary you
 can override any or all of these values by using the "Terminal Parameters"
 item in each Dialing Directory entry.

 See "Alt+P  Set Terminal Parameters" for a detailed description of each item.

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


[00.60] *  Port Address/IRQ

    {com=1,3f8,4}     Com1 port address/IRQ
    {com=2,2f8,3}     Com2 port address/IRQ
    {com=3,3e8,4}     Com3 port address/IRQ
    {com=4,2e8,3}     Com4 port address/IRQ

 These are the hardware serial port base address and IRQ assignments (the
 settings shown are the defaults).  COM3 and COM4 usually require a different
 IRQ setting.

 NOTE: If you need to define more than four ports, you can add extra "com"
 items (up to "com=16,...").

 Port addresses are in hexadecimal and may range from 0 to ffff (use addresses
 below 200 with caution).  If the documentation shows a range of addresses,
 such as "3f8-3ff," use the first value as the base address.

 IRQ numbers are decimal and may range from 2 to 15 (avoid use of IRQ numbers
 that are used by system hardware, such as 6, 8, 13 or 14).  If your serial
 port hardware is configured for IRQ 2, you may get better results on AT class
 machines if you specify IRQ 9 in {COMMO}.

 The serial port base address and IRQ number for the current port are available
 to macros in the built-in variables "_pad" and "_irq" respectively.

 You can also specify the maximum speed or "frequency" for each serial port by
 adding a fourth parameter (default is 115200).  For example, if you have a
 port that has a frequency of 256000 you might have:

      {com=4,2e8,5,256000}

 The frequency value is the speed that results when the Baud Rate Divisor is
 equal to one (which is usually the crystal frequency divided by 16).  {COMMO}
 will accept frequencies as high as 40,000,000 bps.


[00.70] *  Modem Init String (2400 bps and higher)

    {set _modini,~~AT S0=0 S7=180 E1 Q0 V1 X4 &C1 &D2 |~~}

 This item defines the reserved variable "_modini" (notice that the string
 itself begins following the comma).

 The Modem Initialization String is normally sent to your modem when {COMMO} is
 started or when you press Alt+O.

 If you are using a 1200 bps modem you should remove the "&C1 &D2" commands.

 See "Setting Up Your Modem" for more information.


[00.80] *  {min=auto}   Send Modem Init String (auto/yes/no)

 If this is set to "auto" {COMMO} will send the Modem Initialization String at
 program startup only if carrier detect is off.  This allows you to exit the
 program and restart while still online.

 If "yes" {COMMO} will send the string regardless of the state of carrier
 detect.  If "no" {COMMO} will not send the string.

 You can override this item with the "/iy" or "/in" command line switches.


[00.90] *  Hardware/Software Flow Control

    {hfc=auto}    Hardware (RTS/CTS) Flow Control (auto/yes/no)
    {sfc=no}      Software (XON/XOFF) Flow Control (yes/no)

 These are used to control the flow of data between your computer and the
 remote system.  They prevent loss of data when one end can send faster than
 the other end can process the information.

 The "auto" setting for Hardware Flow Control should be used in most cases.
 {COMMO} will enable/disable Hardware Flow Control based on the state of the
 CTS (Clear To Send) signal.  The other settings should not be used unless you
 have an unusual hardware configuration.

 Software Flow Control may be set to "yes" when {COMMO} is used with slower,
 non-buffered modems (e.g., 1200 or 2400 bps) or when required on some packet
 switching networks.  Note that this setting also affects Zmodem file
 transfers.

 IMPORTANT!  Do not confuse this setting with the XON/XOFF modem setting, which
 should be turned off for use with {COMMO}.

 See the section on "Flow Control" for more information.


[01.00] *  {sld=no}   Stop serial input during disk I/O (yes/no)

 This should be set to "yes" if your system drops characters when a disk (hard
 or floppy) is accessed.  The symptoms are:  missing characters in the Terminal
 Screen when capture is on, or excessive CRC/csum errors during internal
 protocol file transfers.

 This is equivalent to what some programs call "handshake slow."  In {COMMO} it
 works in conjunction with Hardware Flow Control (RTS/CTS), so both {COMMO} and
 your modem must have Hardware Flow Control engaged.

 If you use an external protocol program be sure to set the "handshake slow"
 parameter in that program as well.

 See also the "esp" item below.


[01.10] *  {esp=no}   Enhance serial priority (yes/no)

 Try setting this item to "yes" if your system drops characters when TSR
 programs are installed (some of the symptoms are listed under the "sld" item).
 "esp" and "sld" may be tried in any combination.

 NOTE: This feature is automatically disabled when {COMMO} detects DESQview,
 OS/2 or Windows (In DESQview set "Optimize Communications" to "yes" for the
 same result).

 See also the "sld" item above.


[01.20] *  {uff=yes}   Use FIFO if 16550A (yes/no)

 This item should normally be set to "yes."  Set it to "no" if the FIFO buffers
 are defective and {COMMO} will force the 16550A UARTs to operate in 16450
 mode.


[01.30] *  {dex=no}   Drop DTR and RTS on exit (yes/no)

 Leave this "no" if you want to exit {COMMO} and return while still connected
 to a host.  "Yes" will normally cause the modem to hang up when exiting the
 program.


[01.40] *  {enq=no}   Answer ENQ with ACK (yes/no)

 Some hosts send an ENQ control character (^E) periodically and require that
 the terminal "answer back" with an ACK (^F).  Set this item to "yes" only if
 your host requires this.


[01.50] *  {ncr=nocar}   Macro to execute on NO CARRIER

 {COMMO} will execute the macro specified here when the Carrier Detect modem
 signal is lost.  This signal normally comes on when your modem connects with a
 host system, and goes off when the call is terminated.

 If a command window is on screen, the macro will activate when the window is
 exited.  If a macro is running when carrier is lost, the macro will be STOPped
 and the macro at the label will be started.

 {COMMO} will search for the label first in the auxiliary Macro File, then in
 the resident file.  If the label is not found, {COMMO} will continue as usual.

 TIPS on using the carrier lost macro:

  >   IMPORTANT!  This feature is not enabled until a connection is made using
      {COMMO}'s Auto Dialer (or by using the "E" switch on the NOCArrier macro
      function).

  >   The macro label can be changed or cancelled using the NOCArrier macro
      function.

  >   Be sure that you have your modem configured to provide the Carrier Detect
      signal.  See "Setting Up Your Modem" for modem information.


[01.60] *  {set zr_mode,r}   Zmodem like-named file mode (s/r/n/o)
                      s=skip, r=resume, n=rename, o=overwrite

 This variable tells {COMMO} what to do when a file being received with Zmodem
 already exists in your download directory.  See "PgUp/PgDn
 Uploading/Downloading" for details.

 NOTE: This variable can be changed at any time by pressing "M" in the Download
 Protocol Menu.


[01.70] *  {aut=pzbr,^xB00}    Auto Receive, Zmodem DL
    {aut=phbr,HS*^bR}   Auto Receive, HS/Link DL

 The general form for this item is:  {aut=label,string}.  When the specified
 string (up to 32 characters, case ignored) is received, the macro will be
 started.

 These are normally used for automatically starting downloads, but may be used
 to trigger any macro upon receiving any string.

 Up to 16 Auto Receive Strings may be specified.  Operates in Terminal Mode
 only (use SSLOok/CALOok/GOLOok/LOOKfor in macros).

 See also "{COMMO} Auto Receive" and the AUTO macro function.


[01.80] *  Translate Table Initialization

    {rtr=}    Receive Translate Table initialization
    {str=}    Send Translate Table initialization

 These items are used to place values into the character translation tables at
 program startup and, if desired, to turn translation ON.  Multiple receive or
 send items may be present.

 Character translation is used when you wish certain characters to be changed
 into other characters as they are received from, or as they are sent to, the
 remote system.  You may also cause received characters to be ignored.

 Examples:

      {rtr=y,7,0,36,156}

           Turn ON receive translation ("y").

           Change the bell character (ASCII 7) to null (ASCII 0, which will not
           display).

           Change the "$" (ASCII 36) to ASCII 156.

      {str=#26,97,65,42,43,#10,48,128}

           Change 26 consecutive values starting at 97 to consecutive values
           starting at 65.  This will change all lowercase letters (ASCII 97 to
           122) to uppercase letters (ASCII 65 to 90).

           Change the "*" (ASCII 42) to a "+" (ASCII 43).

           Change 10 consecutive values starting at 48 to consecutive values
           starting at 128.  This will change the digits 0 through 9 (ASCII 48
           to 57) to ASCII 128 to 137.

           The ON/OFF state of send translation will not be changed (no "y" or
           "n" is present).

 A "y", to turn translation ON, must be the first argument, if present.  It may
 be used on any "rtr" or "str" item and will apply to all 256 values in either
 the receive table or the send table.  Note that translation defaults to OFF
 when {COMMO} is started.

 Use a PAIR of arguments to change a single value.

 Use THREE arguments to change a range of consecutive values to another range
 of consecutive values.  The "#" operator on the first argument specifies the
 number of values to change, followed by the starting values for each range.

 Changing any character to ASCII 0 (null) will cause the character to be
 ignored in most situations.  For example, it will not display, will not appear
 in a Capture File (unless RAW mode is used) and will be ignored by macro
 functions such as LOOKfor and GETString.

 The macro functions RTRAn and STRAn have similar argument lists.  In addition
 they allow you to restore each Translate Table to default values and to turn
 translation ON and OFF without disturbing the values in the tables.


[01.90] **  Paths and Files

 NOTE: Do not use a "\" at the end of an item that has no filename.


[02.00] *  {set uldir,c:\commo}   Path to find uploads
    {set dldir,c:\commo}   Path to place downloads

 These variables are used in some of the macros in COMMO.MAC and SAMPLES.MAC,
 primarily in the Uploading and Downloading macros.


[02.10] *  {set protodir,c:\commo}   Path to find external protocols

 This is the path where you keep your external protocol programs.  Copy the
 executable programs (e.g., HSLINK.EXE or KERMIT.EXE) into this directory and
 {COMMO} will know where to find them.


[02.20] *  {set _uselog,c:\commo\commo.log}   Path\filename for Usage Log File

 This is a reserved variable that tells {COMMO} where to find your Usage Log
 File.  The Usage Log keeps a record of the calls you make.  If a valid
 path\filename is specified, entries will be made when:

  >   You connect to a system.
  >   You transfer a file using an internal protocol (except BPlus).
  >   You disconnect (or exit {COMMO}).
  >   The macro function OFFLog executes.

 IMPORTANT!  In order for the log to function properly your modem must be set
 to provide "true Carrier Detect" (see "Setting Up Your Modem").  The macro
 function OFFLog is provided for situations where this is not possible.

 If you specify the same log file as used by an external protocol program, you
 will have a complete record of your calls, including upload/download
 statistics.

 If a filename only (no path) is specified, the current directory will be used.
 The path\filename of an open Capture File is not allowed.

 If you don't want a Usage Log, specify a null path\filename (or remove this
 item).  A null path\filename would look like this:

      {set _uselog}

 See also "Usage Log Format."


[02.30] *  {cap=c:\commo\commo.cap}   Path\filename for Capture File

 This is the initial setting for the Capture File path\filename.  It may be
 changed later with the Alt+1 or Alt+L key commands or with the CAPTure macro
 function (do not try to change the "_cap" built-in variable with SETV).

 If a filename only (no path) is specified, the current directory will be used.

 See also "Alt+1  Capture File Options."


[02.40] *  {scr=c:\commo\commo.scr}   Path\filename for Screen Image File

 This is the initial setting for the Screen Image File path\filename.  It may
 be changed later with the Alt+I key command, with the SCREen macro function,
 or from within the Scrollback Buffer window (do not try to change the "_scr"
 built-in variable with SETV).

 If a filename only (no path) is specified, the current directory will be used.
 The path\filename of an open Capture File is not allowed.

 See also "Alt+I  Screen Image Save" and "Alt+K  Scrollback."


[02.50] *  {swp=c:\commo\swap$$$.1}   Path\filename for Swap to Disk File

 You can free up most of the memory occupied by {COMMO} when you use the Shell
 to DOS key command or the EXECute macro function.  The file specified in this
 item will be used to save the program and data during a Swap to Disk.

 IMPORTANT!  You must also specify the "S" switch on any EXECute or SHELl macro
 functions where swapping is desired.

 A unique filename not likely to be used by other applications should be
 specified.  If the file already exists, {COMMO} will attempt to modify the
 name by changing the last character to an "A", then to a "B", etc.

 Before using this feature, read "Alt+S  Shell to DOS" and see also the EXECute
 and SHELl macro function descriptions.


[02.60] *  {set _exted}   Command line for external editor

 An external editor may be defined to edit the Dialing Directory and Macro
 Files directly from their respective windows.  See "{COMMO} Support Files" for
 details.


[02.70] **  Dialing


[02.80] *  Dialing Prefix/Suffix

    {set _dialpf,ATDT }    Default Dialing Prefix
    {set _dialsf, |}       Default Dialing Suffix

 These reserved variables define strings that will be used to create the modem
 dialing command.  The prefix, telephone number and suffix will be strung
 together in that order and sent to your modem when you dial.

 Any number of additional prefixes and suffixes may be used by including
 variables in the telephone number string (see "Alt+D  Dialing Directory" for
 details).

 Use "ATDP" if you don't have a tone line.  Use "ATDT9," to get an outside line
 on a switchboard.  The suffix is usually just a carriage return (|).  Your
 modem manual has additional tips on dialing prefixes and suffixes.


[02.90] *  {dct=45}   Dialing cycle time limit (seconds)

 The maximum time to wait before hanging up and redialing.  Adjust if your
 modem needs more time to complete a call.


[03.00] *  {idt=4}   Delay between dialing attempts (seconds)

 Amount of time to wait between dialing attempts.  Adjust to give incoming
 calls a greater chance of getting through.


[03.10] *  {dcn=c}   Method to cancel dialing (c/d/s,...)

 This item defines the method that {COMMO} will use to cancel a dialing attempt
 in progress.  Dialing is cancelled when you press Esc or when {COMMO} times
 out.  Options are:

      c    Send a carriage return
      d    Drop DTR
      s    Send a user-defined string

 The "s" option lets you define your own string.  The string can be up to 8
 characters in length, including any carets or tildes (see "ASCII Character
 Representation").  Here's an example that sends a Ctrl+X, followed by a
 half-second delay and a carriage return:

      {dcn=s,^x~|}       Fictitious example


[03.20] *  Dialing Responses

    {set _dialsr,CARRIER ,CONNECT}  (space after CARRIER is necessary)
                           Dialing success response(s)
    {set _dialfr,BUSY,NO CARRIER,NO DIAL,OK}
                           Dialing failure response(s)
    {set _dialir,RING}     Inter-dial response(s)

 These reserved variables each define a list of response strings that are
 returned by your modem during dialing operations.  Most "Hayes compatible"
 modems use similar responses, but there may be subtle differences.  Consult
 your modem manual for details.

 "Success" responses are received when the modem has connected with a remote
 modem.  "Failure" responses occur when the number being called is busy,
 doesn't answer or when something is wrong with the telephone line.  {COMMO}
 will automatically redial the number after a failed attempt.

 Inter-dial Delay responses may occur during the delay between dialing
 attempts, usually when someone is trying to call you.  These may be handled by
 using the Inter-dial Delay macro label in the DIAL macro function.

 Some modems use a CARRIER response to indicate the modem speed, e.g. CARRIER
 14400.  In this case using CARRIER instead of CONNECT will improve the
 accuracy of the Usage Log.  In order to avoid confusion with a NO CARRIER
 response, you should use:

      {set _dialsr,CARRIER }   [Notice the space after "CARRIER"]

 Responses are case sensitive and there should be no null strings or extra
 spaces.


[03.30] *  {cdm=yes}   Clear dialing marks when loading (yes/no)

 If this is "yes", {COMMO} will clear all dialing marks when loading a Dialing
 Directory file.  This applies at program startup and whenever a directory file
 is loaded during a session.  Note that the marks are always saved with a file
 when it is written to disk.

 Set this item to "no" if you want to retain the dialing marks.


[03.40] *  {dcm=yes}   Display connect messages (yes/no)

 If this is "yes", {COMMO} will display any messages received from the modem
 during a successful dialing cycle.  The messages will be displayed to the
 screen after the connection has been established.  These messages are useful
 for diagnostic purposes and for verifying the actual modem connect speed and
 protocol.

 Set this item to "no" if you don't want the messages displayed.


[03.50] **  Video and Chat Mode


[03.60] *  {sfi=no}   Speech Friendly Interface (yes/no/expert)

 If this is "yes" {COMMO} will be much friendlier to users with speech
 synthesizer systems (these enable blind users to read the computer display).
 Set it to "expert" to reduce the amount of talking in pop-up windows.

 Major differences with speech turned on:

  >   Terminal Screen data, input fields and many information and error
      messages will be displayed using the BIOS.

  >   The up and down arrow keys move the hardware cursor in windows such as
      Online Help, Scrollback and pop-up menus.  This is similar to being in a
      text editor, where the data is read by moving the cursor.

  >   In the Dialing Directory and File Selector windows, the T and R keys will
      mark and unmark entries without moving the Selector Bar.  If the entry is
      already in the desired state, a short buzz will sound.

  >   {COMMO} will make distinctive (up or down) sounds when:
        a. Entries are marked or unmarked for dialing or uploading.
        b. Opening or closing a Capture File with Alt+L (or Alt+1).
        c. The Insert key is pressed, turning insert mode on or off.

 The "S" selection on the Alt+U Utility Menu may be used to toggle this feature
 on/off.  See also the SFICtrl macro function and the "_sfi" built-in variable
 in "List of Reserved Variables."


[03.70] *  {sbs=10}   Scrollback buffer size in kilobytes (0-64)

 The actual minimum size of the buffer (which {COMMO} will compute) depends on
 the number of screen lines and columns.  For a 25x80 screen it will be about
 4k bytes -- it will be larger for screens with more lines and/or columns.

 Setting the size to 0 disables the Scrollback feature.  See also "Alt+K
 Scrollback."


[03.75] *  {cur=u,h}   Standard and insert cursor shapes (u/h/b)

 Cursor shapes may be defined as "underline," "half" or "block."  The standard
 cursor is used in the Terminal Screen and in overtype mode in the editors.
 The insert cursor is used in insert mode in the editors.


[03.80] *  {sts=yes}   Status Line on (yes/no)

 If this is set to "yes" the Status Line will be on when {COMMO} is started.


[03.90] *  {slt=yes}   Status Line at top of screen (yes/no)

 If this is "yes" the Status Line will appear at the top of the Terminal
 Screen.  Otherwise it will be at the bottom.


[04.00] *  {adn=yes}   Auto-detect number of rows and columns (yes/no)

 Set this item to "yes" if you want {COMMO} to automatically obtain the current
 number of rows and columns from the system at program startup (most systems
 provide this information).  If the display is unsatisfactory, you may have to
 set this to "no."

 {COMMO} will support 25 to 127 rows and 80 to 255 columns.  Note that the
 display must be in the proper mode before starting the program (EGA/VGA
 adapters usually come with utilities to set modes such as 50x80, 44x132,
 etc.).  You may also define an alternate video mode and switch to it after
 starting the program (see next item).

 NOTE: The cursor may not display properly in 43 line mode.  This is a problem
 with some EGA adapters.


[04.10] *  {avm=}   Alternate video mode (mode,rows,cols)

 This item allows you to define an "alternate" video mode (only text modes are
 allowed).  The "normal" video mode is the mode that is in effect when {COMMO}
 is started and will be restored automatically when you exit the program.  If
 you Shell to DOS or use the EXECute macro function, the current mode will
 remain in effect.

 One important application for "avm" is the 132 column feature in VT102
 emulation.  Your host will send codes that cause {COMMO} to switch video modes
 automatically.  You can also switch to the alternate video mode (and back to
 the normal mode) using the VIDEo macro function.

 The mode field must be expressed as a hexadecimal number, while the rows and
 columns are decimal numbers (minimum dimensions are 25x80).  As an example,
 suppose that your video adapter uses mode 23h (hexadecimal) to support a
 25x132 screen.  Then you would write this item as:

      {avm=23,25,132}     Alternate video mode

 Set mode "3" to use the standard 50 line mode supported by VGA adapters or the
 standard 43 line mode supported by EGA adapters.  For example:

      {avm=3,50,80}     Alternate video mode

 The following macro will restore the normal mode when Shelling to DOS and
 bring back the alternate mode upon return (press Alt+S to activate):

      {:als} {video-m0} {shell} {video-m1} {}

 Note that some screen "modes" are not hardware modes and cannot be toggled
 using this feature.  Consult your video adapter manual for a list of hardware
 modes supported (or contact the manufacturer).


[04.20] *  {edi=yes}   Startup editor in insert mode (yes/no)

 Set this to "yes" if you want insert mode turned on the first time you start
 the Internal Editor.  This also applies to the input field editor.


[04.30] *  {ucw=18}   Number of lines in upper Chat Mode window

 This allows you to adjust the line "split" in Chat Mode.  The minimum number
 of lines in the upper or lower window is three.


[04.40] *  {swe=no}   Send when Enter is pressed in Chat Mode (yes/no)

 If "no" {COMMO} will send each character as you type it.  If "yes" {COMMO}
 will wait until you press Enter, then send all that you have typed.


[04.50] *  {bsc=no}   Use BIOS for Terminal Screen scrolling (yes/no)

 BIOS scrolling enables external scrollback programs to work, but is slower and
 may cause "flicker" in certain displays.


[04.60] *  {gdc=}   Graphic display characters

 This item allows you to specify the graphic characters used by {COMMO} to form
 the various display windows and is provided for compatibility with display
 adapters used in certain countries.

 When using this item, eleven ASCII character codes may be listed (omitted
 fields will revert to the defaults).  Codes are specified as decimal numbers
 from 1 to 255 (0, 10 and 13 are not allowed).

 As an example, here is how the default characters would be listed:

      {gdc=218,191,192,217,196,179,205,205,176,250,178}

 where:

           218 = upper left box corner
           191 = upper right box corner
           192 = lower left box corner
           217 = lower right box corner
           196 = horizontal line
           179 = vertical line
           205 = left side of box title
           205 = right side of box title
           176 = file window title fill
           250 = various fills (dots)
           178 = file transfer progress bar


[04.70] **  Sounds


[04.80] *  {snd=yes}   Master Sound on (yes/no)

 If this is set to "yes" sound will be on when {COMMO} is started.  If "no" all
 sounds will be silenced.


[04.90] *  {dca=yes}   Dialing connection alarm (yes/no)

 Controls the alarm that signals a connection when Auto Dialing is used.  Note
 that the alarm will not be sounded when a valid Linked Macro is specified in
 the Dialing Directory.


[05.00] *  {afa=yes}   ASCII Upload finished alarm (yes/no)

 Controls the alarm that signals completion of an ASCII Upload.


[05.10] *  {ers=yes}   Make sounds on errors/warnings (yes/no)

 This controls the special sounds made for certain errors and warning messages.


[05.20] *  {rng=3}   Maximum number of alarm rings (0-999)

 Sets the number of times the alarm will ring.  You may press a key at any time
 to stop the alarm.


[05.30] **  ASCII Upload


[05.40] *  ASCII Upload Parameters

    {ebl=yes}    Expand blank lines (yes/no)
    {slf=yes}    Strip outgoing linefeeds (yes/no)
    {pac=}       ASCII Upload Pacing Character

 These items are used with the ASCII Upload feature.

 Blank line expansion sends a space and a carriage return, instead of just a
 carriage return for lines with no data.  This prevents BBS line editors from
 terminating prematurely.

 Stripping linefeeds gives the data the appearance of being entered manually.
 Linefeeds should not be stripped when the remote is not in "edit" mode.

 The Pacing Character shown is null (no pacing).  To use a ":" for pacing,
 change the item to

      {pac=:}

 See "Alt+A  ASCII Upload" for more details.


[05.50] **  Miscellaneous


[05.60] *  {mac=}   Startup macro label

 This item indicates a macro (in the resident Macro File) to run when {COMMO}
 starts up.  The command line switch "/:" can be used to override it.  See
 "Command Line Options."

 Example:  {mac=begin}


[05.70] *  {vsp=3}   Variable Space size in kilobytes (1-64)

 This may need to be increased if you run macros that use a lot of variables.
 Usually the author of the macro will indicate how much space is required.


[05.80] *  {esf=8}   Edit space for files in kilobytes (0-64)

 This is the amount of expansion memory {COMMO} will allocate for each file
 that can be edited with the Internal Editor.  When the expansion space is used
 up, the file may be reloaded to obtain more.  See "{COMMO} Support Files" for
 details.


[05.90] *  {edd=no}   Enter Dialing Directory (yes/no)

 If this is set to "yes" the Dialing Directory will be entered when {COMMO} is
 started (if no Dialing Strings or Startup Macro are present on the command
 line).


[06.00] *  {loc=no}   Local Echo on (yes/no)

 If this is set to "yes" Local Echo will be on when {COMMO} is started.  See
 also "Alt+T  Set Toggles."


[06.10] *  {sig=no}   Signal Lights on (yes/no)

 If this is set to "yes" the Signal Lights will be on when {COMMO} is started.
 See "How to Read the Status Line" for details.


[06.20] *  {cpf=no}   Capture File open (yes/no)

 If this is set to "yes" Capture will be open when {COMMO} is started.  See
 "Alt+1  Capture File Options."


[06.30] *  {cpm=screen}   Capture Mode (screen/filter/raw)

 See "Alt+1  Capture File Options" for a description of each mode.


[06.40] *  {tsn=yes}   Display time of day with System Name (yes/no)

 If this is "yes" the time of day will be displayed on the right side of the
 Status Line.  Set this to "no" if you want the System Name to have more space.
 Note that the time is always shown when the Signal Lights are displayed.


[06.50] *  {dat=mdy}   Order of date parameters (m=month,d=day,y=year)

 This item allows you to specify any order for the three date parameters.  The
 default shown would display May 20, 1996 as 05/20/96.  "ymd" would display it
 as 96/05/20.

 This format will appear in the Date Last Called field of the Dialing
 Directory, the Usage Log and the built-in variable "_dat".


[06.60] *  {tim=12}   Time format (12/24 hour)

 You can specify 12 or 24 hour time format.  12 hour will add "am" or "pm" as
 in "2:30 pm".  24 hour would show the same time as "14:30".

 The time format appears on the Status Line, in the Usage Log and in the built-
 in variable "_tim".


[06.70] *  {tek=yes}   Test for enhanced keyboard (yes/no)

 Set this to "no" only if your system (BIOS) does not support the enhanced (101
 key) keyboard.  Normally this applies only to older, XT class machines.


[06.80] *  {dmk=8300}   Scan code for Doorway Mode key

 This item defines the key used to enter and exit Doorway Mode.  The default
 key is Alt+=.  The scan code (such as "8300") is obtained by pressing Alt+K in
 {COMMO}'s Internal Editor, then pressing the key you wish to use.

 Note that a corresponding macro must exist in the Macro File.  The macro
 (provided in COMMO.MAC) to use with Alt+= is:

      {:al=} {doorway} {}

 If you change the key definition in COMMO.SET, be sure to change the key-label
 in COMMO.MAC.


[06.90] *  {mky=}   User-defined macro key-label

 This item allows you to assign a macro key-label to almost any key or key
 combination on your keyboard.  Up to 32 "mky" items may be used (any more will
 be ignored).  Here are some examples:

      {mky=cta,1e01}     Ctrl+A
      {mky=bsh,2b5c}     Backslash

 Any valid, three character label may be used as a user-defined key-label (such
 as "cta" in the example).  The scan code (such as "1e01") is obtained by
 pressing Alt+K in {COMMO}'s Internal Editor, then pressing the key you wish to
 use.

 For additional information and certain restrictions, see "{COMMO} Macro
 Key-labels."


[07.00] *  {set sel_up,no}   Go directly to selector for uploads (yes/no)

 Set this item to "yes" and {COMMO} will skip the input prompt for a filename.
 Instead you will see the File Selector immediately.


[07.10] **  Colors


[07.20] *  {clm=auto}   Color Mode (auto/color/mono)

 If this item is set to "auto," {COMMO} will auto detect the display type and
 use the proper mode.  The default modes are "color" for color displays and
 "mono" for monochrome displays.

 If you have a laptop with a black and white LCD display (VGA, EGA or CGA
 compatible), you can use the "mono" mode to improve the contrast (color items
 below will be ignored).

 Setting the mode to "color" will force the use of the colors/attributes in the
 items below.  This is useful if you have a monochrome display and you prefer
 to set your own attributes.

 Press F7 while editing the Setup File (or other files) to pop up the color
 chart.  You may use it with color or monochrome displays.  Color settings have
 no effect when the Color Mode is "mono" (or "auto" with a monochrome display).

 Colors may range from 0-9,A-F.  Background colors from 8-F will cause blinking
 unless bright background colors are enabled in the video hardware.

 NOTE: Terminal Screen data colors/attributes may still be changed if ANSI
 controls are received from the host.  It may be necessary to adjust your
 settings at the host.


[07.30] *  {kts=07,20,0}   Terminal Screen colors (data,status,underline)

 This item has three fields:

  >   The first field sets the default colors for Terminal Screen data.  For
      the most accurate ANSI-BBS or VT102 terminal emulation, it should be set
      to "07".  {COMMO} uses these colors when clearing portions of the screen
      or when a "reset attributes" sequence is received from the host.

  >   The second field sets the colors for the Status Line.

  >   The third field tells {COMMO} what to do when an "underline" attribute is
      received from the host.  If you give specific colors, {COMMO} will use
      those.  "0" means ignore the underline attribute (default).

      NOTE: Monochrome monitors will always display an actual underline.


[07.40] *  "File" window colors

    {kdd=70,1b,20}     Dialing Directory window colors
    {kmf=70,0d,30}     Macro File window colors
    {kaf=70,0c,30}     Auxiliary Macro File window colors
    {kvs=70,0a,20}     Variable Space window colors
    {ksb=70,2f,30}     Scrollback window colors
    {khf=70,1f,2f}     Online Help file window colors
    {khc=70,0b,47}     Help Contents window colors
    {kfs=70,1b,30}     File Selector window colors
    {kes=70,30,20}     Edit Setup File window colors
    {kee=70,20,1b}     Edit external file window colors

 The three parameters are the text, titles and highlight colors, respectively.
 The highlight colors are used for the Selector Bar (when applicable) and for
 inputs and messages on the bottom line.


[07.50] *  "Pop-up" window colors

    {kcf=70,1e}           Capture File Options window colors
    {ksi=70,5f}           Screen Image file window colors
    {kdw=70,30}           Dialer window colors
    {kau=70,4e}           ASCII Upload window colors
    {kpw=70,6b}           Protocol window colors
    {kid=70,30}           Input data window colors
    {kst=70,5f}           Set Toggles window colors
    {ktp=70,1a}           Terminal Parameters window colors
    {kep=70,4b}           Execute Preview window colors
    {kmw=4e,4e}           Message window colors
    {set menu_clr,70,1b}  Menu colors

 The two parameters are the text and border, respectively.  The "Macro Menu"
 colors are used by some of the standard menus in COMMO.MAC.  To set colors for
 individual menus, set the "_mcolor" variable just prior to executing the MENU
 function.


 Colors should be set so that the different parts of the screen contrast with
 each other.  For example the Status Line should be easily discernable from the
 rest of the Terminal Screen.  And the borders and highlights should stand out
 against the text portion of the file windows.

