home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / COMM / MISC / COMMO52.ZIP / COMMO.DOC < prev    next >
Encoding:
Text File  |  1992-03-07  |  137.3 KB  |  3,727 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                 ____________
  10.  
  11.                                 {COMMO} (tm)
  12.                                 ____________
  13.  
  14.  
  15.                    "A New Standard in Telecommunications"
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.                                      by
  26.  
  27.                               Fred P. Brucker
  28.  
  29.                             Post Office Box 9103
  30.                             Santa Rosa, CA 95405
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.                           User Guide and Reference
  38.  
  39.  
  40.  
  41.  
  42.                                 Release 5.2
  43.  
  44.                                March 7, 1992
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.         (C)Copyright 1989,1992  Fred P. Brucker  All Rights Reserved
  59.  
  60.  
  61.  
  62.  
  63.  
  64.      The {COMMO} program and associated on-disk documentation are the
  65.      property of the author and may not be sold without permission. 
  66.      They may be freely distributed, unaltered and as a unit, via
  67.      electronic bulletin board systems.  Permission to distribute on
  68.      diskette or in any other manner must be obtained in writing.  See
  69.      the file LICENSES for additional licensing and distribution
  70.      details.
  71.  
  72.  
  73.      The author does not guarantee this program to be free from
  74.      defects and may not be held responsible for loss caused by such. 
  75.      Your use of this program constitutes your acceptance of these
  76.      terms.
  77.  
  78.  
  79.  
  80.  
  81.      DESQview is a trademark of Quarterdeck Office Systems
  82.      OmniView is a trademark of Sunny Hill Software
  83.      DoubleDOS is a trademark of SoftLogic Solutions, Inc.
  84.      HS/Link is a product of Samuel H. Smith
  85.      DSZ and GSZ are products of Omen Technology Inc.
  86.      MPt is a product of Matthew Thomas
  87.      LIST is a product of Vernon D. Buerg
  88.      The IBM PC is a product of IBM Corp.
  89.      MS-DOS is a trademark of MicroSoft Corp.
  90.  
  91.  
  92.  
  93.  
  94.         (C)Copyright 1989,1992  Fred P. Brucker  All Rights Reserved
  95.  
  96.  
  97.  
  98.                      ================================
  99.                      {COMMO} Registration Information
  100.                      ================================
  101.  
  102.   {COMMO} is a "SHAREWARE" product.  You are entitled to evaluate it for
  103.   30 days.  If it suits your needs and you would like to continue using
  104.   it, then you must pay the licensing fee.  Please use the REGISTRATION
  105.   FORM on the next page.
  106.  
  107.   When you REGISTER you will be licensed to use all future releases of
  108.   {COMMO}.  You will never have to pay an "update" charge.  You will also
  109.   receive instructions for removing the Shareware Notice at program
  110.   startup.
  111.  
  112.   My (voice) TELEPHONE NUMBER for inquiries and support for registered
  113.   users is (707) 573-1065.  Please restrict calls to business hours
  114.   (Mon-Fri, 9am-5pm, Pacific time).
  115.  
  116.   Registered users will also receive priority support on Bulletin Boards,
  117.   CompuServe and GEnie (see READ.ME).
  118.  
  119.   Call or write for pricing information on MULTI-USER (site) and
  120.   DISTRIBUTION licenses.  Discounts are given on quantities greater than
  121.   10.  See the file LICENSES for licensing and distribution details.
  122.  
  123.   All prices shown are US DOLLARS.  Please remit US FUNDS on US BANK only.
  124.   NET 30 TERMS will be accepted on purchase orders totalling $100.00 or
  125.   more.
  126.  
  127.   PAYMENT OPTIONS:
  128.  
  129.   1) Payment by CHECK or MONEY ORDER:  make payable to FRED P. BRUCKER.
  130.      Mail the Registration Form and payment to the address below.
  131.  
  132.   2) Payment by CREDIT CARD:  fill in the credit card information at the
  133.      bottom of the Registration Form.  The following cards are accepted:
  134.  
  135.        VISA, MASTERCARD, CARTE BLANCHE, DINERS CLUB, DISCOVER, JCB.
  136.  
  137.      You can mail the Registration Form to the address below or:
  138.  
  139.        Order by phone: (707) 573-1065, Mon-Fri, 9am-5pm, Pacific time.
  140.          Have your credit card ready when you call.
  141.  
  142.        Order by E-mail on CompuServe (71021,356) or GEnie (F.BRUCKER1).
  143.          Upload the completed Registration Form as a message.
  144.  
  145.      The company name on the charge will be "New Standard Software."
  146.  
  147.  
  148.                 SEND TO:   Fred P. Brucker
  149.                            Post Office Box 9103
  150.                            Santa Rosa, CA 95405
  151.  
  152.  
  153.  
  154.                {COMMO} 5.2 SINGLE USER REGISTRATION FORM
  155.  
  156.   Name     _______________________________________________________________
  157.  
  158.   Company name (if company address)   ____________________________________
  159.  
  160.   Address  _______________________________________________________________
  161.  
  162.            _______________________________________________________________
  163.  
  164.            _______________________________________________________________
  165.  
  166.  
  167.   {COMMO} single user license, SPECIAL PACKAGE .... $50.00    $ __________
  168.     Includes: (1) Printed, bound, indexed manual.
  169.               (2) Latest release on diskette plus utilities
  170.                   (COMMOPNS, MOSTHOST, CMC, etc., see READ.ME).
  171.  
  172.   {COMMO} single user license, with DISKETTE ...... $40.00    $ __________
  173.  
  174.   {COMMO} single user LICENSE alone ............... $35.00    $ __________
  175.  
  176.   Registered users may order PRINTED MANUAL only .. $20.00    $ __________
  177.     Limit of one per license.  Your serial no. _________
  178.  
  179.   Registered users may order DISKETTE only ......... $5.00    $ __________
  180.     Limit of one per license.  Your serial no. _________
  181.  
  182.   ALL DISK ORDERS -  Choose format: 5.25" ____ 3.5" ____
  183.                      Current (latest) release       ____
  184.                      Next release (when available)  ____
  185.  
  186.                                                   Subtotal    $ __________
  187.  
  188.                   California residents add sales tax, 7.5%    $ __________
  189.                     (No tax when ordering license alone)
  190.  
  191.   Special Package or Manual order, add SHIPPING:
  192.                          USA/Canada/Mexico ......... $3.00
  193.                          All other countries ...... $10.00    $ __________
  194.  
  195.                                                      Total    $ __________
  196.  
  197.   Payment method:  Check__  Money order__  Visa__  MasterCard__  PO__
  198.                    Carte Blanche__  Diners Club__  Discover__  JCB__
  199.  
  200.      CREDIT CARD INFORMATION:
  201.  
  202.      Card No. ________  ________  ________  ________  Expires ____/____
  203.  
  204.      Cardholder signature _____________________________________________
  205.  
  206.      Cardholder name __________________________________________________
  207.  
  208.      Daytime telephone  (_____) _____ _______
  209.  
  210.  
  211.  
  212.                    {COMMO} (tm)  User Guide and Reference            5
  213.  
  214.  
  215.      ========
  216.      Contents
  217.      ========
  218.  
  219.  
  220.      Preface . . . . . . . . . . . . . . . . . . . . . . . . . . .   7
  221.  
  222.      Principal Features  . . . . . . . . . . . . . . . . . . . . .   8
  223.           The Best Way to Learn {COMMO} Quickly  . . . . . . . . .  11
  224.  
  225.      Getting Started . . . . . . . . . . . . . . . . . . . . . . .  12
  226.           Quick Start Instructions . . . . . . . . . . . . . . . .  12
  227.           Preparing Your System  . . . . . . . . . . . . . . . . .  14
  228.           Command Line Options . . . . . . . . . . . . . . . . . .  15
  229.           {COMMO} Support Files  . . . . . . . . . . . . . . . . .  17
  230.           Saving the Support Files . . . . . . . . . . . . . . . .  18
  231.           Initialization Procedure . . . . . . . . . . . . . . . .  18
  232.           Terminal Screen  . . . . . . . . . . . . . . . . . . . .  19
  233.  
  234.      {COMMO} Key Commands  . . . . . . . . . . . . . . . . . . . .  20
  235.           [Alt-A]   ASCII Upload . . . . . . . . . . . . . . . . .  20
  236.           [Alt-B]   Send Break Signal  . . . . . . . . . . . . . .  22
  237.           [Alt-C]   Clear Screen . . . . . . . . . . . . . . . . .  22
  238.           [Alt-D]   Dialing Directory  . . . . . . . . . . . . . .  22
  239.                Dialing Directory Entry Example . . . . . . . . . .  23
  240.           [Alt-G]   Edit Setup File  . . . . . . . . . . . . . . .  26
  241.                Predefining Variables with SET  . . . . . . . . . .  26
  242.                Explanation of Setup File Items . . . . . . . . . .  27
  243.           [Alt-H]   Hang Up  . . . . . . . . . . . . . . . . . . .  40
  244.           [Alt-I]   Screen Image Save  . . . . . . . . . . . . . .  40
  245.           [Alt-K]   Scrollback . . . . . . . . . . . . . . . . . .  41
  246.           [Alt-M]   Macro Processor  . . . . . . . . . . . . . . .  41
  247.           [Alt-N]   Multi Number Dialing . . . . . . . . . . . . .  42
  248.           [Alt-O]   Send Modem Initialization String . . . . . . .  42
  249.           [Alt-P]   Set Terminal Parameters  . . . . . . . . . . .  42
  250.                Parameter Descriptions  . . . . . . . . . . . . . .  43
  251.                Setting Terminal Parameters . . . . . . . . . . . .  45
  252.           [Alt-S]   Shell to DOS . . . . . . . . . . . . . . . . .  45
  253.           [Alt-T]   Set Toggles  . . . . . . . . . . . . . . . . .  46
  254.                Sound Control Toggle  . . . . . . . . . . . . . . .  46
  255.                AutoBaud Toggle . . . . . . . . . . . . . . . . . .  46
  256.                Local Echo Toggle . . . . . . . . . . . . . . . . .  47
  257.                Signal Lights Toggle  . . . . . . . . . . . . . . .  47
  258.           [Alt-U]   Utility Menu . . . . . . . . . . . . . . . . .  47
  259.           [Alt-W]   Send Current Password  . . . . . . . . . . . .  48
  260.           [Alt-X]   Exit from {COMMO}  . . . . . . . . . . . . . .  48
  261.           [Alt-1]   Capture File Options . . . . . . . . . . . . .  48
  262.           [Alt-2]   Print Log Toggle . . . . . . . . . . . . . . .  49
  263.           [Alt--]   Chat Mode Toggle  (Alt minus)  . . . . . . . .  50
  264.           [Alt-=]   Doorway Mode Toggle  . . . . . . . . . . . . .  51
  265.           [F1]   How to Use Online Help  . . . . . . . . . . . . .  52
  266.                Modifying the Help File . . . . . . . . . . . . . .  52
  267.  
  268.  
  269.  
  270.                    {COMMO} (tm)  User Guide and Reference            6
  271.  
  272.  
  273.  
  274.      [PgUp]/[PgDn]  Uploading/Downloading  . . . . . . . . . . . .  53
  275.           How to Install External Protocol Drivers . . . . . . . .  53
  276.           Using DSZ or GSZ . . . . . . . . . . . . . . . . . . . .  54
  277.           Using OZBEXT . . . . . . . . . . . . . . . . . . . . . .  55
  278.           {COMMO} Auto Receive . . . . . . . . . . . . . . . . . .  55
  279.  
  280.      Appendix A   Setting Up Your Modem  . . . . . . . . . . . . .  57
  281.           Answering a call from another computer . . . . . . . . .  59
  282.           Connecting two computers (null modem cable)  . . . . . .  60
  283.  
  284.      Appendix B   {COMMO} and Multi-Tasking  . . . . . . . . . . .  61
  285.           DESQview . . . . . . . . . . . . . . . . . . . . . . . .  61
  286.           OmniView . . . . . . . . . . . . . . . . . . . . . . . .  62
  287.           DoubleDOS  . . . . . . . . . . . . . . . . . . . . . . .  62
  288.  
  289.      Appendix C   Flow Control . . . . . . . . . . . . . . . . . .  64
  290.  
  291.      Appendix D   ASCII Character Representation . . . . . . . . .  65
  292.  
  293.      Appendix E   Terminal Emulation . . . . . . . . . . . . . . .  67
  294.           Printer Support  . . . . . . . . . . . . . . . . . . . .  68
  295.           ANSI-BBS Keyboard Support  . . . . . . . . . . . . . . .  68
  296.           VT102 Keyboard Simulation  . . . . . . . . . . . . . . .  68
  297.  
  298.      Appendix F   Usage Log Format . . . . . . . . . . . . . . . .  71
  299.  
  300.      Appendix G   Error Message Explanations . . . . . . . . . . .  72
  301.  
  302.  
  303.  
  304.                    {COMMO} (tm)  User Guide and Reference            7
  305.  
  306.  
  307.      =======
  308.      Preface
  309.      =======
  310.  
  311.      {COMMO} is a general purpose telecommunications program, also
  312.      called a "terminal" program.  Use it to dial remote systems and
  313.      to communicate using a choice of terminal emulations.  Many
  314.      features are available to enhance your communications needs.
  315.  
  316.      Minimum system configuration:
  317.  
  318.           IBM PC compatible computer.
  319.           MS-DOS 2.1 or higher.
  320.           128k of memory.
  321.           One diskette drive.
  322.           A serial port or internal modem with an 8250, 16450 or 16550
  323.           series UART chip.
  324.  
  325.      {COMMO} can be configured to work with virtually any type of
  326.      modem.
  327.  
  328.  
  329.  
  330.                    {COMMO} (tm)  User Guide and Reference            8
  331.  
  332.  
  333.      ==================
  334.      Principal Features
  335.      ==================
  336.  
  337.      {COMMO} is small in size, loads rapidly and performs all
  338.      functions with great speed.
  339.  
  340.      The powerful Macro Processor allows you to:
  341.  
  342.           1)   Write macro "scripts" to automate many common
  343.                operations such as logging in, reading messages,
  344.                uploading/downloading.  {COMMO} will perform these
  345.                tasks in the middle of the night while you sleep.
  346.  
  347.           2)   Assign Function Keys, Alt Keys, Keypad Keys, etc., to:
  348.  
  349.                     (a) send a string to the modem
  350.                     (b) execute any DOS command
  351.                     (c) start any macro
  352.                     (d) initiate any {COMMO} function.
  353.  
  354.           3)   Edit all macros without exiting {COMMO}, using the
  355.                Internal Editor.  Macros become effective immediately.
  356.  
  357.           4)   Call your computer from a remote location using
  358.                {COMMO}'s convenient Host Mode, written in {COMMO}'s
  359.                macro language.
  360.  
  361.      The free-form Dialing Directory has space for hundreds of
  362.      entries.  Multi Number Dialing is supported from the command
  363.      line.  AutoBaud detect adjusts to the speed of the connection.  A
  364.      macro may be linked to each directory entry.
  365.  
  366.      Multi-tasking support.  {COMMO} is fully DESQview aware, operates
  367.      in far less memory than comparable programs.  Also supports
  368.      OmniView, DoubleDOS and others.
  369.  
  370.      Built-in ANSI-BBS and VT102 emulation.  Supports ANSI editing
  371.      functions, scrolling region, graphics character set, tab
  372.      set/clear, printing, modes, reports, etc.  Complete auto-
  373.      switching VT102 keyboard support via Macro Processor.
  374.  
  375.      ENQ/ACK terminal protocol support.
  376.  
  377.      Built-in Xmodem and Xmodem-1k (old Ymodem) protocols.
  378.  
  379.      ASCII Upload to send messages and text files.  Features line
  380.      pacing and blank line expansion.
  381.  
  382.      The Setup File, Dialing Directory and Macro File may be edited
  383.      with the full-function Internal Editor.  String search is
  384.  
  385.  
  386.  
  387.                    {COMMO} (tm)  User Guide and Reference            9
  388.  
  389.  
  390.      available in all file windows.  Most features are fully
  391.      configurable.
  392.  
  393.      Any file up to 64k in size may be edited within {COMMO} using the
  394.      Internal Editor.
  395.  
  396.      {COMMO} supports all text display modes, including 132 column
  397.      screens.
  398.  
  399.      Character Translate Tables for both sending and receiving. 
  400.      Tables can be modified dynamically via macros.
  401.  
  402.      Split-screen Chat Mode for communicating with another computer
  403.      which is also running a terminal program.  All program features
  404.      are available while in Chat Mode.
  405.  
  406.      Doorway Mode lets you operate remote applications with full use
  407.      of your screen and keyboard.
  408.  
  409.      {COMMO}'s Auto Receive feature lets you configure any eight
  410.      strings to automatically trigger any eight macros.  Thus any
  411.      protocol with a "signature" can be set to start automatically. 
  412.      Zmodem, HS/Link and MPt are pre-configured.
  413.  
  414.      Support for any four serial ports.  Port addresses and IRQ's are
  415.      configurable.  Port speeds up to 115,200 bps (hardware
  416.      dependent).  Automatic support for NS16550A (or AF) buffered UART
  417.      chip.
  418.  
  419.      Serial port signal lights may be displayed on the Status Line,
  420.      including send and receive.  Very useful with internal modems.
  421.  
  422.      Scrollback buffer up to 64k bytes gives instant replay of the
  423.      text that has scrolled off the screen.
  424.  
  425.      Capture Log saves all text from the screen to a disk file.  Three
  426.      different capture modes are available.
  427.  
  428.      Screen Image Save writes the current screen to a disk file.
  429.  
  430.      Print Log writes all text from the screen to the printer.
  431.  
  432.      Usage Log records date, time, length of call and other
  433.      information about each call.  Date of last call can be saved in
  434.      the Dialing Directory.
  435.  
  436.      Support for visually impaired users with {COMMO}'s configurable
  437.      Speech Friendly Interface.
  438.  
  439.      Special version available to support the HP 95LX palmtop
  440.      computer.
  441.  
  442.  
  443.  
  444.                    {COMMO} (tm)  User Guide and Reference           10
  445.  
  446.  
  447.      Enhanced keyboard support.
  448.  
  449.      Extensive context-related Online Help.
  450.  
  451.  
  452.      And {COMMO} is elegant, easy to learn and fun to use!
  453.  
  454.  
  455.  
  456.                    {COMMO} (tm)  User Guide and Reference           11
  457.  
  458.  
  459.                     !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  460.                     -------------------------------------
  461.                     The Best Way to Learn {COMMO} Quickly
  462.                     -------------------------------------
  463.                     !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  464.  
  465.  
  466.      1)   Read the section "Getting Started" which will get you up and
  467.           running.
  468.  
  469.      2)   Read Appendix A "Setting Up Your Modem" for some very
  470.           important instructions regarding your specific hardware.
  471.  
  472.      3)   Read through the section "{COMMO} Key Commands" to
  473.           familiarize yourself with {COMMO}'s commands and features.
  474.  
  475.      4)   Use Online Help as a reference while you use {COMMO}.
  476.  
  477.  
  478.      How is it pronounced???  Just like "comma" (,) except for the
  479.      last letter.  It's technical jargon for "communications."
  480.  
  481.  
  482.  
  483.                    {COMMO} (tm)  User Guide and Reference           12
  484.  
  485.  
  486.      ===============
  487.      Getting Started
  488.      ===============
  489.  
  490.      NOTE:  Refer to Appendix G for explanations of any error messages
  491.      you receive during your initial use of {COMMO}.
  492.  
  493.      For greater detail, see the next section "Preparing Your System."
  494.  
  495.  
  496.      Quick Start Instructions
  497.      ========================
  498.  
  499.      1)   If you have a hard drive, create a subdirectory named
  500.           "COMMO."  Copy all of the files from the {COMMO} archive or
  501.           distribution diskette into this subdirectory.
  502.  
  503.           If your system has only floppy drives, copy the {COMMO}
  504.           files to a formatted diskette.
  505.  
  506.           Now change to the {COMMO} subdirectory or log in to the
  507.           diskette where you have copied the {COMMO} files.
  508.  
  509.      2)   Run the "New User's Guide"  by typing "guide" at the DOS
  510.           prompt. Follow the instructions carefully.  A macro will
  511.           automatically take you on a tour of some of {COMMO}'s main
  512.           features.
  513.  
  514.           When you are in the Setup File you will be in {COMMO}'s
  515.           Internal Editor and you may change any portion of the file
  516.           using the arrow keys, PgUp, PgDn and other editing keys. 
  517.           Press Alt-E for Edit Help to see a list of editing keys.
  518.  
  519.           You may need to change some of the items to conform to your
  520.           system setup.  Notice that {COMMO} only looks at the items
  521.           that are contained in curly braces: { }.  All other text is
  522.           treated as commentary and is not used by the program.
  523.  
  524.           Most items will not need to be changed until you are more
  525.           familiar with {COMMO}.  For now, check the following:
  526.  
  527.                The Default Dialing Parameters in the first item.  Make
  528.                sure you have the correct port number (the third
  529.                field).  If your modem is on COM2, change it to "2",
  530.                COM3 to "3", etc.  Using COM2 it would look like this: 
  531.                {2400,8n1,2,A,0}.
  532.  
  533.                The Modem Initialization String.  If you know the
  534.                commands for your own modem, make the necessary
  535.                adjustments.  If you don't, then leave it like it is. 
  536.                Refer to Appendix A for more information.
  537.  
  538.  
  539.  
  540.                    {COMMO} (tm)  User Guide and Reference           13
  541.  
  542.  
  543.                The items under "Paths and Files" (page down to see
  544.                these). 
  545.  
  546.           Press [Esc] to save the file and continue the tour.
  547.  
  548.      3)   The next stop is the Dialing Directory.  To alter an entry
  549.           or to add new ones, just press "E" to enter edit mode.  This
  550.           is the same Internal Editor you used to modify the Setup
  551.           File.  When you are finished making changes, press Esc to
  552.           bring back the Selector Bar.  Then press Esc again to
  553.           continue.
  554.  
  555.      4)   Next you will see a sample menu created by the Macro
  556.           Processor.  Press Enter to continue and return to the
  557.           Terminal Screen.  Then exit {COMMO} with the Alt-X command.
  558.  
  559.      5)   From the DOS prompt type "commo<cr>" to restart the program. 
  560.           The new Setup File items will now be in effect.
  561.  
  562.      6)   IMPORTANT!  {COMMO}'s Auto Receive feature is set up to
  563.           automatically start the program DSZ.COM (from Omen
  564.           Technology) when the remote system sends a file using the
  565.           Zmodem protocol.
  566.  
  567.           Do not request a file for downloading with Zmodem until you
  568.           have this program installed in a directory that is in your
  569.           DOS path (or in the current directory).  If "Bad command or
  570.           filename" is displayed by DOS, just keep pressing Ctrl-X
  571.           until it stops.  This message means you haven't installed
  572.           DSZ properly.
  573.  
  574.           If things happen too quickly to see what is happening, you
  575.           can use EXECute Preview Mode, which will allow you see the
  576.           results of the command execution.  Use Alt-T to toggle
  577.           Preview Mode on/off.
  578.  
  579.           The same principle applies to any other protocol drivers
  580.           that you use, such as HS/Link, MPt, etc.  If you don't have
  581.           any external protocol drivers installed, use the internal
  582.           Xmodem protocol (use Xmodem-1k whenever possible since it is
  583.           much faster).
  584.  
  585.      7)   When you see the Status Line at the bottom of the screen,
  586.           you are in the Terminal Screen.  Now you may press Alt-D to
  587.           enter the Dialing Directory.  Use the up and down arrow keys
  588.           to select a system to call and press Enter.  {COMMO} will
  589.           begin dialing.
  590.  
  591.      8)   When a connection is made with a remote system, {COMMO} will
  592.           return to the Terminal Screen where you may interact with
  593.           the remote.
  594.  
  595.  
  596.  
  597.                    {COMMO} (tm)  User Guide and Reference           14
  598.  
  599.  
  600.           NOTE:  If your modem does not seem to operate properly (no
  601.           connection is made or the data is garbled), read Appendix A
  602.           "Setting Up Your Modem."  You may need to change the Modem
  603.           Initialization String in the Setup File.  If you change it,
  604.           exit and restart {COMMO} to send the new string.  Then try
  605.           dialing again.
  606.  
  607.  
  608.      Preparing Your System
  609.      =====================
  610.  
  611.      The following sections give startup instructions in greater
  612.      detail.
  613.  
  614.      Make sure that all of the files from the {COMMO} package are in
  615.      one directory or on one diskette.  Four of these files are
  616.      required to run the {COMMO} program:
  617.  
  618.           COMMO.COM      the Program File
  619.           COMMO.SET      the Setup File
  620.           COMMO.FON      the Dialing Directory File
  621.           COMMO.MAC      the Macro File
  622.  
  623.      In addition, if Online Help is used (recommended):
  624.  
  625.           COMMO.HLP      the Online Help File
  626.  
  627.      There are two ways to make sure that {COMMO} will be able to find
  628.      all of its files.  The first method is the simplest and should be
  629.      used if you are not too familiar with DOS commands:
  630.  
  631.      1)   Make sure you are logged into the directory or disk drive
  632.           where the files are located.  Then simply type "commo" at
  633.           the DOS prompt.  If your files are in the directory
  634.           "C:\COMMO" you would type:
  635.  
  636.                c:<cr>
  637.                cd \commo<cr>
  638.                commo<cr>
  639.  
  640.           (<cr> is the [Enter] or Return key)
  641.  
  642.           Or if the files are on a diskette in drive A you would type:
  643.  
  644.                a:<cr>
  645.                commo<cr>
  646.  
  647.           {COMMO} will remember where the files are, so you will be
  648.           able to change directory or drive later without concern.
  649.  
  650.  
  651.  
  652.                    {COMMO} (tm)  User Guide and Reference           15
  653.  
  654.  
  655.      2)   The second method is a little more advanced, but allows you
  656.           to run {COMMO} no matter what directory or drive you are
  657.           currently logged into:
  658.  
  659.           Use the SET command in DOS to store the {COMMO} path into
  660.           the "environment."  If you place this command in your
  661.           AUTOEXEC.BAT file you won't have to change directories or
  662.           diskettes to run {COMMO}.  If your files are in the
  663.           directory "C:\COMMO" the command would be:
  664.  
  665.                set commo=c:\commo
  666.  
  667.           If the files are on the diskette in drive B the command
  668.           would be:
  669.  
  670.                set commo=b:
  671.  
  672.           Do not use any extra spaces in the SET command.  And
  673.           remember to place the {COMMO} directory or drive in your
  674.           PATH command.
  675.  
  676.           IMPORTANT!  Be sure to check your "set commo=" command if
  677.           you install {COMMO} into a different directory or onto
  678.           another drive (or if you install a later release of the
  679.           program).  If it points to the wrong directory, {COMMO} will
  680.           not operate properly.  This is a common error and can cause
  681.           a lot of head scratching.
  682.  
  683.  
  684.      Command Line Options
  685.      ====================
  686.  
  687.           _______________
  688.  
  689.           Dialing Strings
  690.           _______________
  691.  
  692.      Dialing Strings are used to indicate numbers to dial at program
  693.      startup.  If present, they must be placed before any command line
  694.      switches.  {COMMO} will search the Dialing Directory for each
  695.      string and mark the first entry where a match is found (case is
  696.      ignored).
  697.  
  698.      The strings may consist of any part of a Dialing Directory entry
  699.      line (usually part of the system name) and may be separated by
  700.      commas or spaces.  The following characters may not appear in a
  701.      command line Dialing String: space, comma, slash (/), curly
  702.      braces.
  703.  
  704.      After entries in the Dialing Directory are marked, {COMMO} will
  705.      check for a startup macro (specified on the command line or in
  706.      the Setup File).  If a startup macro is present, it will be
  707.  
  708.  
  709.  
  710.                    {COMMO} (tm)  User Guide and Reference           16
  711.  
  712.  
  713.      started.  Otherwise Multi Number Dialing of the marked systems
  714.      will begin.
  715.  
  716.      Examples:
  717.  
  718.               commo telegodzilla joes-bbs 4567 
  719.  
  720.               commo zilla,joes,4567
  721.  
  722.      IMPORTANT!  The Modem Initialization String will normally be sent
  723.      before dialing begins.  Your modem should be turned on and ready
  724.      to receive the command string before you start {COMMO}.
  725.  
  726.           ________
  727.  
  728.           Switches
  729.           ________
  730.  
  731.      Case is ignored and the switches may be in any order (Dialing
  732.      Strings must precede them, however).
  733.  
  734.      NOTE:  Environment variables may also be used to communicate data
  735.      to {COMMO} at program startup.  See the description of the
  736.      SETVariable function in the Macro Programming Guide.
  737.  
  738.      /:label        Startup Macro.
  739.  
  740.           This switch can be used to override the "mac=" item in the
  741.           Setup File.  The "label" is a one to eight character macro
  742.           label.  If the label is found in the Macro File, macro
  743.           processing will be started.  If the label is not found the
  744.           switch will be ignored.
  745.  
  746.      /sfilename          Alternate Setup File.
  747.      /dfilename          Alternate Dialing Directory File.
  748.      /mfilename          Alternate Macro File
  749.  
  750.           Only the filename should be specified.  The {COMMO} home
  751.           directory will be assumed for the path.
  752.  
  753.           If an alternate Macro File is specified, it will become the
  754.           default Macro File.  This means it will be reloaded when the
  755.           "R" switch is used with the MACLoad macro function.
  756.  
  757.      /knn           Scrollback Buffer size.
  758.  
  759.           This switch will override the "sbs=" item in the Setup File. 
  760.           "nn" is kilobytes and may be 0 to 64.
  761.  
  762.      /i[y/n]        Modem Initialization override.
  763.  
  764.  
  765.  
  766.                    {COMMO} (tm)  User Guide and Reference           17
  767.  
  768.  
  769.           Forces the Modem Initialization String to be sent ("/iy") or
  770.           not sent ("/in").  This will override the "min=" item in the
  771.           Setup File.
  772.  
  773.      Example:
  774.  
  775.      C:\COMMO> commo joes zilla /:mailrun /dother.dir /k25 /in
  776.  
  777.           Two systems will be marked in the Dialing Directory.
  778.  
  779.           The macro "mailrun" will be started if it exists in the
  780.           Macro File.
  781.  
  782.           The alternate Dialing Directory "other.dir" will be loaded.
  783.  
  784.           The Scrollback Buffer will be set to 25k in size.
  785.  
  786.           The Modem Initialization String will not be sent.
  787.  
  788.  
  789.      {COMMO} Support Files
  790.      =====================
  791.  
  792.      The {COMMO} files are standard ASCII text files and may be
  793.      modified with any editor (or word processor in "non-document"
  794.      mode).  From within {COMMO} they may be edited with {COMMO}'s
  795.      Internal Editor.
  796.  
  797.      The only control characters (below ASCII 28) allowed in the
  798.      support files are CR/LF pairs and an EOF at the end.  {COMMO}'s
  799.      Internal Editor adheres to this rule.  Control characters may be
  800.      represented as shown in Appendix D.  For example, an ASCII 16
  801.      would be written as ^P.
  802.  
  803.      Key definitions for the Internal Editor are given in Online Help. 
  804.      A Color Chart will be displayed in the editor when F7 is pressed
  805.      (useful in the Setup File and for the DISPlay function in the
  806.      Macro File).
  807.  
  808.      NOTE:  {COMMO} generally retains the Dialing Directory and Macro
  809.      File in memory during program operation.  If you use an external
  810.      editor to modify them while in the Shell to DOS (or using the
  811.      EXEC macro function), your changes could be lost.  See "Saving
  812.      the Support Files" below.
  813.  
  814.      Following is a brief description of each file. 
  815.  
  816.      1)   COMMO.SET.  The Setup File contains settings for many
  817.           important parameters.  The first time you run {COMMO} you
  818.           should use the Alt-G key command to edit this file to your
  819.           own needs.  See "Alt-G  Edit Setup File" for details on each
  820.           item.
  821.  
  822.  
  823.  
  824.                    {COMMO} (tm)  User Guide and Reference           18
  825.  
  826.  
  827.  
  828.      2)   COMMO.FON.  The Dialing Directory File.  This file contains
  829.           information about each system that you will be calling,
  830.           including the telephone number, password, Linked Macro and
  831.           serial port parameter overrides.  Use the Alt-D key command
  832.           to dial numbers and to edit this file.  Details are given in
  833.           the section "Alt-D  Dialing Directory."
  834.  
  835.      3)   COMMO.MAC.  The Macro File.  Use the Alt-M key command to
  836.           select a macro for execution and to edit this file.  A
  837.           complete description of {COMMO} macros is given in the Macro
  838.           Programming Guide.  A summary of macro functions and key
  839.           designators is also given in Online Help.
  840.  
  841.      4)   COMMO.HLP.  The Online Help File.  This file contains the
  842.           information for {COMMO}'s context-related Online Help.  See
  843.           "How to Use Online Help" later in this document.
  844.  
  845.  
  846.      Saving the Support Files
  847.      ========================
  848.  
  849.      Whenever a change is made to any file, the internal change flag
  850.      is set for that file (indicated by an "*" next to the column
  851.      number in the Internal Editor).
  852.  
  853.      The Dialing Directory and Macro File will be saved automatically
  854.      when you exit {COMMO} (if the change flag is set).  The Setup
  855.      File and other files that you may edit will be saved when you
  856.      press Esc to exit the editor.
  857.  
  858.      You may press Alt-F in the Internal Editor to immediately save
  859.      any file.
  860.  
  861.      If you do not wish to save your changes to the Dialing Directory
  862.      or Macro File, you may press Alt-Q while in the Internal Editor. 
  863.      This will reset {COMMO}'s change flag and the file will not be
  864.      saved when exiting the program.  Any subsequent changes to the
  865.      file will set the change flag again.  Pressing Alt-Q while
  866.      editing any other file will simply cancel the edit.
  867.  
  868.  
  869.      Initialization Procedure
  870.      ========================
  871.  
  872.      When {COMMO} begins running it will read and process the Setup
  873.      File, COMMO.SET.  Then it will attempt to load into memory:
  874.  
  875.           (1) the Dialing Directory     COMMO.FON
  876.           (2) the Macro File            COMMO.MAC
  877.  
  878.  
  879.  
  880.                    {COMMO} (tm)  User Guide and Reference           19
  881.  
  882.  
  883.      Any problems encountered will be reported.  These problems must
  884.      be corrected before restarting the program.
  885.  
  886.      Automatic modem initialization will occur if requested in the
  887.      Setup File with {min=yes}, or by the "/iy" command line switch. 
  888.      Use the "/in" switch to suppress modem initialization if you are
  889.      already on line.
  890.  
  891.      Please note that {COMMO} does NOT change the video display mode. 
  892.      Instead {COMMO} can adapt to any text mode that is set when the
  893.      program is started.  Check the items under "Video and Chat Mode"
  894.      in the Setup File for details.  See also the section "[Alt-G] 
  895.      Edit Setup File" later in this document.
  896.  
  897.      If the display does not look right try executing the DOS command 
  898.      "mode co80" or "mode bw80" prior to calling {COMMO}.
  899.  
  900.  
  901.      Terminal Screen
  902.      ===============
  903.  
  904.      The Terminal Screen allows you to see the characters coming in
  905.      from the serial port.  Any characters that you type will be sent
  906.      out to the serial port.  If you are connected to another system
  907.      you will be interacting with that system.
  908.  
  909.      Keep in mind that you will also be interacting with {COMMO} and
  910.      with your own computer via key commands (Alt keys, for example). 
  911.      These key commands have no effect on the remote system unless
  912.      they cause characters to be sent to the serial port (pressing
  913.      Alt-W to send your password, for example).
  914.  
  915.  
  916.  
  917.                    {COMMO} (tm)  User Guide and Reference           20
  918.  
  919.  
  920.      ====================
  921.      {COMMO} Key Commands
  922.      ====================
  923.  
  924.      The Alt Keys shown in this section are the built-in default key
  925.      assignments for the various {COMMO} commands.  Once you are
  926.      familiar with these commands you may use the Macro Processor to
  927.      reassign any of the keys.
  928.  
  929.      Keys used within the various command windows are properly
  930.      detailed in Online Help.  Please press F1 from any command window
  931.      to invoke {COMMO}'s context-related help system.
  932.  
  933.      Note that certain features are only available as macro functions. 
  934.      Refer to the Macro Programming Guide for details.
  935.  
  936.  
  937.      ======================
  938.      [Alt-A]   ASCII Upload
  939.      ======================
  940.  
  941.      This command is used to send prepared messages or any text files
  942.      to the remote system.  Enter the pathname of the file you wish to
  943.      send.  Note that the input field will be blank unless a macro is
  944.      used to prompt with a path.  The macro supplied in COMMO.MAC is:
  945.  
  946.           {:ala} {ascii %uldir\} {}          ASCII Upload with path
  947.  
  948.      Notice the "\" following the path variable.  It tells {COMMO} to
  949.      prompt for the filename.  If you needed to specify a colon for
  950.      pacing (see below) you could change this to:
  951.  
  952.           {:ala} {ascii %uldir\,:} {}        ASCII Upload with path
  953.  
  954.      There is no special error checking associated with ASCII Upload. 
  955.      It is intended primarily for sending message responses and other
  956.      short text files.  For longer files, binary files or compressed
  957.      files (.ARC, .ZIP) you will want to use error checking protocols
  958.      such as Xmodem, Zmodem, MPt, etc.  See "Uploading / Downloading."
  959.  
  960.      A number of parameters are used to control an ASCII Upload:
  961.  
  962.           ___________
  963.  
  964.           Line Pacing
  965.           ___________
  966.  
  967.      IMPORTANT!  Line Pacing is used to keep transmitted data
  968.      synchronized with received (echoed) data and is normally used
  969.      ONLY when the remote is sending a prompt for each line, usually
  970.      "nn:" or "nn?".  "nn" is a line number and ":" or "?" is the
  971.      prompt or "pacing character."
  972.  
  973.  
  974.  
  975.                    {COMMO} (tm)  User Guide and Reference           21
  976.  
  977.  
  978.  
  979.      {COMMO} will wait up to 5 seconds for the pacing character, then
  980.      send the next line.  If there is a 5 second delay between the
  981.      sending of each line, then either you have the wrong pacing
  982.      character or you don't need line pacing (you don't need it when
  983.      using a full-screen editor, for example).
  984.  
  985.      At any time, the Spacebar may be pressed to force transmission of
  986.      the next line.  This is very useful when you have set the wrong
  987.      pacing character or if you wish to send each line manually.  In
  988.      the latter case, use any pacing character that is different from
  989.      the one in the line prompt.
  990.  
  991.      To use line pacing, enter the pacing character when {COMMO} asks
  992.      for it in the ASCII Upload window.  NOTE:  The receive Translate
  993.      Table can affect the pacing character if receive translation is
  994.      ON.
  995.  
  996.      The initial pacing character is configurable.  See "[Alt-G]  Edit
  997.      Setup File."
  998.  
  999.      The pacing character may be any character including control
  1000.      characters, e.g. "^m" or "|" for carriage return.  See Appendix D
  1001.      for details on how to represent special characters.
  1002.  
  1003.      See also Appendix C "Flow Control."
  1004.  
  1005.           ________________
  1006.  
  1007.           Character Pacing
  1008.           ________________
  1009.  
  1010.      You may insert a delay between each character using the Inter-
  1011.      Character Delay feature.  This should only be used when the
  1012.      remote is so slow that it drops characters.  See "Set Terminal
  1013.      Parameters" for details.
  1014.  
  1015.           ___________________
  1016.  
  1017.           Stripping Linefeeds
  1018.           ___________________
  1019.  
  1020.      Normally you will want to strip linefeeds from your outgoing
  1021.      text.  This will appear to the remote as if you are typing the
  1022.      data.  But if all your data displays on the same line at the
  1023.      remote, then you must configure {COMMO} to send the linefeeds.
  1024.  
  1025.      NOTE:  This item is initialized in the Setup File.
  1026.  
  1027.  
  1028.  
  1029.                    {COMMO} (tm)  User Guide and Reference           22
  1030.  
  1031.  
  1032.           _____________________
  1033.  
  1034.           Expanding Blank Lines
  1035.           _____________________
  1036.  
  1037.      You may configure {COMMO} to send a space character whenever a
  1038.      blank line is encountered in the text file you are sending.  This
  1039.      will prevent your message from terminating prematurely if you are
  1040.      sending to a BBS message editor.  Blank line expansion is not
  1041.      normally required when sending to a "full screen" BBS editor.
  1042.  
  1043.      NOTE:  This item is initialized in the Setup File.
  1044.  
  1045.  
  1046.      ===========================
  1047.      [Alt-B]   Send Break Signal
  1048.      ===========================
  1049.  
  1050.      A one second Break Signal will be sent.  This signal is used by
  1051.      some systems to interrupt certain operations.  Use it only when
  1052.      the remote system directs you to do so.
  1053.  
  1054.  
  1055.      ======================
  1056.      [Alt-C]   Clear Screen
  1057.      ======================
  1058.  
  1059.      The Terminal Screen will be cleared and the current colors will
  1060.      be set to the Setup File defaults.
  1061.  
  1062.  
  1063.      ===========================
  1064.      [Alt-D]   Dialing Directory
  1065.      ===========================
  1066.  
  1067.      The Dialing Directory is your data base of telephone numbers. 
  1068.      From the directory window you can select numbers to dial and also
  1069.      update the directory using the Internal Editor.
  1070.  
  1071.      Refer to Online Help for a complete description of the commands
  1072.      available in the Dialing Directory window.
  1073.  
  1074.  
  1075.  
  1076.                    {COMMO} (tm)  User Guide and Reference           23
  1077.  
  1078.  
  1079.      _______________________________
  1080.  
  1081.      Dialing Directory Entry Example
  1082.      _______________________________
  1083.  
  1084.  
  1085.      System         Last      Telephone  System    Linked  Terminal
  1086.      Name           Called    Number     Password  Macro   Parameters
  1087.      _____________  ________  __________ _________ ______  __________
  1088.  
  1089.      File City BBS  02/14/92  {555-1234}  {pword}  {city}     {}
  1090.  
  1091.      NOTE:  Any number of Variable Items may be added following the
  1092.      Terminal Parameters item (see below).
  1093.  
  1094.  
  1095.      IMPORTANT!  Items in curly braces must be present (they are
  1096.      positional).  Items which are not used must have a null string {}
  1097.      as a placeholder.  You may omit null strings at the end of the
  1098.      line.
  1099.  
  1100.      Directory entries are limited to one per line.  Lines may be up
  1101.      to 255 characters in length.  {COMMO}'s Internal Editor will
  1102.      scroll horizontally to follow the cursor.
  1103.  
  1104.      Comments may be placed anywhere outside the curly braces or on
  1105.      separate lines.
  1106.  
  1107.      ______________________________
  1108.  
  1109.      System Name      File City BBS
  1110.      ______________________________
  1111.  
  1112.           Up to 40 characters in length,  it must NOT be enclosed in
  1113.           curly braces.  The System Name will be displayed on the
  1114.           Status Line after connection, unless the Signal Lights
  1115.           option is selected.  It will also be part of a Usage Log
  1116.           entry if the log is enabled.
  1117.  
  1118.      ______________________________________
  1119.  
  1120.      Telephone Number      {1-707-555-1234}
  1121.      ______________________________________
  1122.  
  1123.           Spaces and hyphens are ignored by most modems.  The Dialing
  1124.           Prefix, Telephone Number and Dialing Suffix are strung
  1125.           together to form a dialing command (may be up to 128
  1126.           characters total).  Refer to your modem manual for details
  1127.           on dialing commands.
  1128.  
  1129.           Normally the default Dialing Prefix (usually "ATDT") and the
  1130.           default Dialing Suffix (usually "|") will be used.  These
  1131.  
  1132.  
  1133.  
  1134.                    {COMMO} (tm)  User Guide and Reference           24
  1135.  
  1136.  
  1137.           are specified in the Setup File.  You may also have any
  1138.           number of alternate prefixes and suffixes by defining them
  1139.           with SET items in the Setup File.
  1140.  
  1141.           For example, if you wanted your prefix for a certain entry
  1142.           to be "ATM1L3DT" (to turn on the modem speaker LOUD), you
  1143.           could put this item in your Setup File:
  1144.  
  1145.                {set spkrpref,ATM1L3DT}       Loud speaker prefix
  1146.  
  1147.           Then your entry might look like this:
  1148.  
  1149.                File City  {%spkrpref%555-1234} {pword} {city} {}
  1150.  
  1151.           The prefix "spkrpref" will override the default prefix if it
  1152.           is at the very beginning of the telephone number field. 
  1153.           Similarly, an override suffix may be specified if it is at
  1154.           the very end of the field.
  1155.  
  1156.           Notice that these are variable names and must be bracketed
  1157.           between "%" characters.  Variables may be placed anywhere
  1158.           else within the number field as well, but they will not
  1159.           override the default prefix or suffix unless they are at the
  1160.           very beginning or very end, respectively.
  1161.  
  1162.           You may use variables defined with SET items in the Setup
  1163.           File or variables set within macros.
  1164.  
  1165.      _________________________________
  1166.  
  1167.      System Password      {mypassword}
  1168.      _________________________________
  1169.  
  1170.           A different Password String may be defined for each system
  1171.           that you call.  Passwords may be up to 64 characters in
  1172.           length.
  1173.  
  1174.           The Password String may be sent by pressing Alt-W or by
  1175.           using the variable "_pas" in a SEND macro function.
  1176.  
  1177.           Passwords are invisible in the Dialing Directory window, but
  1178.           appear when you enter [E]dit mode.
  1179.  
  1180.           Rules for writing passwords are in Appendix D.
  1181.  
  1182.  
  1183.  
  1184.                    {COMMO} (tm)  User Guide and Reference           25
  1185.  
  1186.  
  1187.      ________________________
  1188.  
  1189.      Linked Macro      {city}  
  1190.      ________________________
  1191.  
  1192.           If a valid Linked Macro is specified, it will be started
  1193.           when a connection is established with the remote system.  If
  1194.           no macro is specified (or the macro label is not found),
  1195.           {COMMO} will enter the Terminal Screen.
  1196.  
  1197.      ___________________________
  1198.  
  1199.      Terminal Parameters      {}
  1200.      ___________________________
  1201.  
  1202.           This item allows you to override any or all of the Default
  1203.           Dialing Parameters for the current call.  Prior to dialing
  1204.           each number, {COMMO} will set all Terminal Parameters to the
  1205.           Dialing Defaults (which are initialized from the Setup File
  1206.           at program startup, but may be changed with the DPARms macro
  1207.           function or with the Alt-P key command).
  1208.  
  1209.           If a system requires parameters that are different from the
  1210.           Dialing Defaults, specify them in this item.
  1211.  
  1212.           The general form of this item is:
  1213.  
  1214.                {speed,format,comport,terminal-type,delay}
  1215.  
  1216.           For example, you might have "{,7,,V}", which would set the
  1217.           Data Format to "7e1" and the Terminal-type to VT102, but
  1218.           would use the Dialing Defaults for the other parameters.
  1219.  
  1220.           See "Set Terminal Parameters" for a complete description of
  1221.           each field.  See also "AutoBaud Detect."
  1222.  
  1223.      _________________________
  1224.  
  1225.      Last Called      05/20/90
  1226.      _________________________
  1227.  
  1228.           If this item is present, {COMMO} will replace it with the
  1229.           current date whenever a connection is made with the system. 
  1230.           It may appear anywhere on the entry line (outside the curly
  1231.           braces).  Place "00/00/00" to start it.  The Dialing
  1232.           Directory file will be saved to disk when you exit {COMMO}.
  1233.  
  1234.  
  1235.  
  1236.                    {COMMO} (tm)  User Guide and Reference           26
  1237.  
  1238.  
  1239.      _________________________________
  1240.  
  1241.      Variable Items      {name,string}
  1242.      _________________________________
  1243.  
  1244.           Any number of Variable Items may be included in a directory
  1245.           entry and will be set just prior to dialing.  The "string"
  1246.           may not contain any variables.  The first Variable Item must
  1247.           follow the Terminal Parameters item (all other items must be
  1248.           present as placeholders even if some are null).  Example:
  1249.  
  1250.             Joes-BBS  {555-1234} {pword} {mac} {} {bbsid,joesbbs} ...
  1251.  
  1252.  
  1253.      See also "[Alt-N]  Multi Number Dialing."
  1254.  
  1255.  
  1256.      =========================
  1257.      [Alt-G]   Edit Setup File
  1258.      =========================
  1259.  
  1260.      Pressing Alt-G allows you to edit the Setup File, COMMO.SET (see
  1261.      "Internal Editor" in Online Help for details on editing).  The
  1262.      Setup File contains initial settings for many parameters used by
  1263.      {COMMO}.
  1264.  
  1265.      Items changed with the editor are not effective until the next
  1266.      time you start the program.  However, most items may be changed
  1267.      with key commands and/or macro functions while the program is
  1268.      running.
  1269.  
  1270.      Each item in the Setup File is enclosed in curly braces.  Items
  1271.      are designated with three letter "keywords" and may be present in
  1272.      any order.  There are no "required" items.  Most missing items
  1273.      will take on the default values shown in the examples below (AUT
  1274.      items and SET items have no default values).
  1275.  
  1276.      All text outside the curly braces is commentary and is ignored by
  1277.      {COMMO}.  Avoid using curly braces other than to bracket setup
  1278.      items.
  1279.  
  1280.  
  1281.      Predefining Variables with SET
  1282.      ==============================
  1283.  
  1284.      SET items predefine variables in {COMMO}'s String Variable Space. 
  1285.      The general form of a SET item is
  1286.  
  1287.           {set name,string}.
  1288.  
  1289.                name      Any valid variable name.
  1290.  
  1291.  
  1292.  
  1293.                    {COMMO} (tm)  User Guide and Reference           27
  1294.  
  1295.  
  1296.                string    A text string to assign to the name.  The
  1297.                          string may not contain any variables.
  1298.  
  1299.      Any number of SET items may appear in the Setup File.  They may
  1300.      be used later in macros, in telephone numbers, etc.
  1301.  
  1302.      See the Macro Programming Guide for more information on
  1303.      variables.
  1304.  
  1305.  
  1306.      Explanation of Setup File Items
  1307.      ===============================
  1308.  
  1309.      _________________________________________________________________
  1310.  
  1311.      {ddp=2400,8n1,1,A,0}          Default Dialing Parameters, set
  1312.                                    when you dial:
  1313.                                    (speed,format,port,terminal,delay).
  1314.  
  1315.                                    These are also the current settings
  1316.                                    when you start the program.
  1317.      _________________________________________________________________
  1318.  
  1319.           These values will be used as the current settings when
  1320.           {COMMO} is started and each time dialing begins.  Use the
  1321.           "Terminal Parameters" item in the Dialing Directory to set
  1322.           overrides when required.  Use Alt-P or the macro function
  1323.           DPARms to change dialing parameters at other times.
  1324.  
  1325.           See "Set Terminal Parameters" for a complete description of
  1326.           each field and how to change current parameters as well.
  1327.  
  1328.           NOTE:  PCjr users without the internal modem should specify
  1329.           Com2.
  1330.  
  1331.      ______________________________________________
  1332.  
  1333.      {min=yes}      Send Modem Init String (yes/no)
  1334.      ______________________________________________
  1335.  
  1336.           If "yes" this will instruct {COMMO} to send the Modem
  1337.           Initialization String at program startup.  You can override
  1338.           this item with the "/iy" or "/in" command line switch.
  1339.  
  1340.  
  1341.  
  1342.                    {COMMO} (tm)  User Guide and Reference           28
  1343.  
  1344.  
  1345.      ___________________________________________________
  1346.  
  1347.      {set _modini,~AT S0=0 S7=180 E0 Q0 V1 X4 &C1 &D2 |}
  1348.  
  1349.                Modem Init String (2400 bps and higher)
  1350.      ___________________________________________________
  1351.  
  1352.           This item defines the reserved variable "_modini" (notice
  1353.           that the string itself begins following the comma).
  1354.  
  1355.           The Modem Initialization String is normally sent to your
  1356.           modem when {COMMO} is started or when you press Alt-O.  
  1357.  
  1358.           If you are using a 1200 bps modem you should remove the "&C1
  1359.           &D2" commands.  In either case the "X" command may have to
  1360.           be adjusted.  See Appendix A "Setting Up Your Modem."
  1361.  
  1362.      ________________________________________________________
  1363.  
  1364.      {sfc=yes}      Software (XON/XOFF) Flow Control (yes/no)
  1365.      {hfc=no}       Hardware (RTS/CTS) Flow Control (yes/no)
  1366.      ________________________________________________________
  1367.  
  1368.           These are used to control the flow of data between your
  1369.           computer and the remote system.  They prevent loss of data
  1370.           when one end can send faster than the other end can process
  1371.           the information.  See Appendix C for details.
  1372.  
  1373.      ________________________________________________
  1374.  
  1375.      {dex=no}       Drop DTR and RTS on exit (yes/no)
  1376.      ________________________________________________
  1377.  
  1378.           Leave this "no" if you want to exit {COMMO} and return while
  1379.           still connected to a host.  "Yes" will normally cause the
  1380.           modem to hang up when exiting.
  1381.  
  1382.      ___________________________________________
  1383.  
  1384.      {enq=no}       Answer ENQ with ACK (yes/no)
  1385.      ___________________________________________
  1386.  
  1387.           Some hosts send an ENQ control character (^E) periodically
  1388.           and require that the terminal "answer back" with an ACK
  1389.           (^F).  Set this item to "yes" only if your host requires
  1390.           this.
  1391.  
  1392.  
  1393.  
  1394.                    {COMMO} (tm)  User Guide and Reference           29
  1395.  
  1396.  
  1397.      ____________________________________________________
  1398.  
  1399.      {ncr=}         Macro to execute when carrier is lost
  1400.      ____________________________________________________
  1401.  
  1402.           Specify a macro label here and {COMMO} will execute the
  1403.           macro when carrier detect is lost.  Example:
  1404.  
  1405.                {ncr=carrlost}
  1406.  
  1407.           IMPORTANT:  This feature is enabled only when a connection
  1408.           is made using {COMMO}'s Auto Dialer.  Also, if carrier drops
  1409.           while a macro is running or a command window is open (such
  1410.           as the Dialing Directory or Capture File Options), the
  1411.           carrier lost macro will not activate.
  1412.  
  1413.           Be sure that you have your modem configured to provide the
  1414.           carrier detect signal.  See Appendix A for modem
  1415.           information.
  1416.  
  1417.      ______________________________________________
  1418.  
  1419.      {aut=pzbr,^xB00}         Auto Receive, Zmodem
  1420.      {aut=phbr,^bR}           Auto Receive, HS/Link
  1421.      {aut=pmpr,^v^h^vMPt}     Auto Receive, MPt
  1422.      ______________________________________________
  1423.  
  1424.           The general form of this item is:  {aut=label,string}.  When
  1425.           the specified string (up to 32 characters, case ignored) is
  1426.           received, the macro will be started.
  1427.  
  1428.           These are normally used for automatically starting
  1429.           downloads, but may be used to trigger any macro upon
  1430.           receiving any string.
  1431.  
  1432.           Up to eight Auto Receive Strings may be specified.  Operates
  1433.           in Terminal Mode only (use GOLOok/LOOKfor in macros).
  1434.  
  1435.           See the section "{COMMO} Auto Receive" for more details.
  1436.  
  1437.      ________________________________________________
  1438.  
  1439.      {rtr=}    Receive Translate Table initialization
  1440.      {str=}    Send Translate Table initialization
  1441.      ________________________________________________
  1442.  
  1443.           These items are used to place values into the character
  1444.           translation tables at program startup and, if desired, to
  1445.           turn translation ON.  Multiple receive or send items may be
  1446.           present.
  1447.  
  1448.  
  1449.  
  1450.                    {COMMO} (tm)  User Guide and Reference           30
  1451.  
  1452.  
  1453.           Character translation is used when you wish certain
  1454.           characters to be changed into other characters as they are
  1455.           received from, or as they are sent to, the remote system. 
  1456.           You may also cause received characters to be ignored.
  1457.  
  1458.           Examples:
  1459.  
  1460.                {rtr=y,7,0,36,156}
  1461.  
  1462.                     Turn ON receive translation ("y").
  1463.  
  1464.                     Change the bell character (ASCII 7) to null (ASCII
  1465.                     0, which will not display).
  1466.  
  1467.                     Change the "$" (ASCII 36) to ASCII 156.
  1468.  
  1469.                {str=#26,97,65,42,43,#10,48,128}
  1470.  
  1471.                     Change 26 consecutive values starting at 97 to
  1472.                     consecutive values starting at 65.  This will
  1473.                     change all lowercase letters (ASCII 97 to 122) to
  1474.                     uppercase letters (ASCII 65 to 90).
  1475.  
  1476.                     Change the "*" (ASCII 42) to a "+" (ASCII 43).
  1477.  
  1478.                     Change 10 consecutive values starting at 48 to
  1479.                     consecutive values starting at 128.  This will
  1480.                     change the digits 0 through 9 (ASCII 48 to 57) to
  1481.                     ASCII 128 to 137.
  1482.  
  1483.                     The ON/OFF state of send translation will not be
  1484.                     changed (no "y" or "n" is present).
  1485.  
  1486.           A "y", to turn translation ON, must be the first argument,
  1487.           if present.  It may be used on any "rtr" or "str" item and
  1488.           will apply to all 256 values in either the receive table or
  1489.           the send table.  Note that translation defaults to OFF when
  1490.           {COMMO} is started.
  1491.  
  1492.           Use a PAIR of arguments to change a single value.
  1493.  
  1494.           Use THREE arguments to change a range of consecutive values
  1495.           to another range of consecutive values.  The "#" operator on
  1496.           the first argument specifies the number of values to change,
  1497.           followed by the starting values for each range.
  1498.  
  1499.           The macro functions RTRAn and STRAn have similar argument
  1500.           lists.  In addition they allow you to restore each Translate
  1501.           Table to default values and to turn translation ON and OFF
  1502.           without disturbing the values in the tables.  See the Macro
  1503.           Programming Guide for more details.
  1504.  
  1505.  
  1506.  
  1507.                    {COMMO} (tm)  User Guide and Reference           31
  1508.  
  1509.  
  1510.      _________________________________________
  1511.  
  1512.      {com=1,3f8,4}       Com1 port address/IRQ
  1513.      {com=2,2f8,3}       Com2 port address/IRQ
  1514.      {com=3,3e8,4}       Com3 port address/IRQ
  1515.      {com=4,2e8,3}       Com4 port address/IRQ
  1516.      _________________________________________
  1517.  
  1518.           These are the hardware serial port base address and IRQ
  1519.           assignments.  The settings shown are the most common, but
  1520.           some serial adapters are different.  The serial adapter
  1521.           manual may give a range of addresses, for example "3f8-3ff." 
  1522.           Use the first value as the base address.
  1523.  
  1524.      __________________________________________
  1525.  
  1526.      {abd=no}       AutoBaud Detect on (yes/no)
  1527.      __________________________________________
  1528.  
  1529.           Determines the initial state of the AutoBaud toggle.  See
  1530.           "AutoBaud Detect" under "[Alt-T]  Set Toggles."
  1531.  
  1532.      _________________________________________________________________
  1533.  
  1534.      {cdm=yes}      Clear dialing marks when saving directory (yes/no)
  1535.      _________________________________________________________________
  1536.  
  1537.           If this is "yes", dialing marks will not be written to disk
  1538.           when saving the Dialing Directory file.  Set it to "no" if
  1539.           you wish the marks to be saved with the file (to be used in
  1540.           the next session).
  1541.  
  1542.           Note that changes to dialing marks (mark or unmark) will not
  1543.           cause the file to be saved upon exit from {COMMO}.  If no
  1544.           other changes occur (such as Date Last Called), you must use
  1545.           Alt-F in the Internal Editor to save the marks.
  1546.  
  1547.      _______________________________________________
  1548.  
  1549.      {set _dialpf,ATDT }      Default Dialing Prefix
  1550.      {set _dialsf, |}         Default Dialing Suffix
  1551.      _______________________________________________
  1552.  
  1553.           These reserved variables define strings that will be used to
  1554.           create the modem dialing command.  The prefix, telephone
  1555.           number and suffix will be strung together in that order and
  1556.           sent to your modem when you dial.
  1557.  
  1558.           Any number of additional prefixes and suffixes may be used
  1559.           by including variables in the telephone number string (see
  1560.           "[Alt-D]  Dialing Directory" for details).
  1561.  
  1562.  
  1563.  
  1564.                    {COMMO} (tm)  User Guide and Reference           32
  1565.  
  1566.  
  1567.           Use "ATDP" if you don't have a tone line.  Use "ATDT9," to
  1568.           get an outside line on a switchboard.  The suffix is usually
  1569.           just a carriage return (|).  Your modem manual has
  1570.           additional tips on dialing prefixes and suffixes.
  1571.  
  1572.      _______________________________________________
  1573.  
  1574.      {dct=45}       Dialing cycle time-out (seconds)
  1575.      _______________________________________________
  1576.  
  1577.           The maximum time to wait before hanging up and redialing. 
  1578.           Adjust if your modem needs more time to complete a call.
  1579.  
  1580.      _______________________________________________________
  1581.  
  1582.      {idt=2}        Delay between dialing attempts (seconds)
  1583.      _______________________________________________________
  1584.  
  1585.           Amount of time to wait between dialing attempts.  Adjust to
  1586.           give incoming calls a greater chance of getting through.
  1587.  
  1588.      ______________________________________________________________
  1589.  
  1590.      {set _dialsr,CONNECT}              Dialing success response(s)
  1591.      {set _dialfr,BUSY,NO CARRIER,NO DIALTONE}
  1592.                                         Dialing failure response(s) 
  1593.      ______________________________________________________________
  1594.  
  1595.           These reserved variables each define a list of response
  1596.           codes that can be found in your modem manual.  Do not
  1597.           include the speed in the CONNECT response if you are
  1598.           enabling AutoBaud.
  1599.  
  1600.           Some modems use a CARRIER response to indicate the modem
  1601.           speed, e.g. CARRIER 2400.  Using this instead of CONNECT
  1602.           will improve the accuracy of the Usage Log.  In order to
  1603.           avoid confusion with a NO CARRIER response, you should use:
  1604.  
  1605.            {set _dialsr,CARRIER }    Notice the space after CARRIER.
  1606.  
  1607.           Responses are case sensitive.  There should be no null
  1608.           strings or extra spaces.
  1609.  
  1610.  
  1611.  
  1612.                    {COMMO} (tm)  User Guide and Reference           33
  1613.  
  1614.  
  1615.      _____________________________________________________
  1616.  
  1617.      {set uldir,c:\commo}          Path to find uploads
  1618.      {set dldir,c:\commo}          Path to place downloads
  1619.      _____________________________________________________
  1620.  
  1621.           These variables are used in some of the macros in COMMO.MAC
  1622.           and SAMPLES.MAC, primarily in the Uploading and Downloading
  1623.           macros.  They are not reserved variables, so you may change
  1624.           their names.
  1625.  
  1626.      _______________________________________________________________
  1627.  
  1628.      {set dszprog,DSZ.COM}    Name of program in DSZ family that you
  1629.                               have (DSZ.COM, GSZ.EXE or DSZ.EXE)
  1630.      _______________________________________________________________
  1631.  
  1632.           This variable is used in macros that require an Omen
  1633.           Technology external protocol driver program.  Just enter one
  1634.           of the three programs shown and all of the Zmodem and Ymodem
  1635.           macros will use it (including the MOSTHOST).
  1636.  
  1637.      _________________________________________________________
  1638.  
  1639.      {set _uselog,c:\commo\commo.log}   Pathname for Usage Log
  1640.      _________________________________________________________
  1641.  
  1642.           This is a reserved variable that tells {COMMO} where to find
  1643.           your Usage Log.  The Usage Log keeps a record of the calls
  1644.           you make.  If a valid pathname is specified, entries will be
  1645.           made when:
  1646.  
  1647.                1) You connect to a system.
  1648.                2) You transfer a file using an internal protocol.
  1649.                3) You disconnect (or exit {COMMO}).
  1650.  
  1651.           IMPORTANT!  In order for the log to function properly your
  1652.           modem must be set to provide "true carrier detect" (see
  1653.           Appendix A).
  1654.  
  1655.           Use a null pathname or remove this item to disable the Usage
  1656.           Log.  A null pathname would look like this:
  1657.  
  1658.                {set _uselog}
  1659.  
  1660.           The Usage Log should be disabled when you are connecting
  1661.           directly to another computer (with a null modem cable).
  1662.  
  1663.           Specify the same log file as your external protocol driver
  1664.           (e.g., DSZ.LOG or MPT.LOG) and you will have a complete
  1665.           record of your calls, including upload/download statistics.
  1666.  
  1667.  
  1668.  
  1669.                    {COMMO} (tm)  User Guide and Reference           34
  1670.  
  1671.  
  1672.           If a filename only (no path) is specified, the current
  1673.           directory will be used.  The pathname of an open Capture
  1674.           File is not allowed.
  1675.  
  1676.           See also Appendix F "Usage Log Format."
  1677.  
  1678.      _______________________________________________________
  1679.  
  1680.      {cap=c:\commo\commo.cap}      Pathname for Capture File
  1681.      _______________________________________________________
  1682.  
  1683.           This is the initial setting for the Capture File pathname. 
  1684.           It may be changed later with the Alt-1 key command or with
  1685.           the CAPTure macro function (do not try to change the "_cap"
  1686.           built-in variable with SETV).
  1687.  
  1688.           If a filename only (no path) is specified, the current
  1689.           directory will be used.
  1690.  
  1691.           See also "Capture File Options."
  1692.  
  1693.      ____________________________________________________________
  1694.  
  1695.      {scr=c:\commo\commo.scr}      Pathname for Screen Image File
  1696.      ____________________________________________________________
  1697.  
  1698.           This is the initial setting for the Screen Image File
  1699.           pathname.  It may be changed later with the Alt-I key
  1700.           command, with the SCREen macro function, or from within the
  1701.           Scrollback Buffer window (do not try to change the "_scr"
  1702.           built-in variable with SETV).
  1703.  
  1704.           If a filename only (no path) is specified, the current
  1705.           directory will be used.  The pathname of an open Capture
  1706.           File is not allowed.
  1707.  
  1708.           See also "Screen Image Save" and "Scrollback"
  1709.  
  1710.      ________________________________________________
  1711.  
  1712.      {ebl=yes}      Expand blank lines (yes/no)
  1713.      {slf=yes}      Strip outgoing linefeeds (yes/no)
  1714.      {pac=}         ASCII Upload pacing character
  1715.      ________________________________________________
  1716.  
  1717.           These items are used with the ASCII Upload feature.
  1718.  
  1719.           Blank line expansion sends a space and a carriage return,
  1720.           instead of just a carriage return for lines with no data. 
  1721.           This prevents BBS line editors from terminating prematurely.
  1722.  
  1723.  
  1724.  
  1725.                    {COMMO} (tm)  User Guide and Reference           35
  1726.  
  1727.  
  1728.           Stripping linefeeds gives the data the appearance of being
  1729.           entered manually.  Linefeeds should not be stripped when the
  1730.           remote is not in "edit" mode.
  1731.  
  1732.           The pacing character shown is null (no pacing).  To use a
  1733.           ":" for pacing, change the item to
  1734.  
  1735.                {pac=:}
  1736.  
  1737.           See "ASCII Upload" for more details.
  1738.  
  1739.      __________________________________
  1740.  
  1741.      {mac=}         Startup macro label
  1742.      __________________________________
  1743.  
  1744.           This item indicates a macro to run when {COMMO} starts up. 
  1745.           The command line switch "/:" can be used to override it. 
  1746.           See "Command Line Options."
  1747.  
  1748.           Example:  {mac=begin}.
  1749.  
  1750.      _______________________________________________
  1751.  
  1752.      {edd=no}       Enter Dialing Directory (yes/no)
  1753.      _______________________________________________
  1754.  
  1755.           If this is set to "yes" the Dialing Directory will be
  1756.           entered when {COMMO} is started (if no Dialing Strings or
  1757.           Startup Macro are present on the command line).
  1758.  
  1759.      _____________________________________
  1760.  
  1761.      {loc=no}       Local Echo on (yes/no)
  1762.      _____________________________________
  1763.  
  1764.           If this is set to "yes" Local Echo will be on when {COMMO}
  1765.           is started.  See also "Alt-T  Set Toggles."
  1766.  
  1767.      ______________________________________
  1768.  
  1769.      {sts=yes}      Status Line on (yes/no)
  1770.      ______________________________________
  1771.  
  1772.           If this is set to "yes" the Status Line will be on when
  1773.           {COMMO} is started.
  1774.  
  1775.  
  1776.  
  1777.                    {COMMO} (tm)  User Guide and Reference           36
  1778.  
  1779.  
  1780.      ________________________________________
  1781.  
  1782.      {sig=no}       Signal Lights on (yes/no)
  1783.      ________________________________________
  1784.  
  1785.           If this is set to "yes" Signal Lights will be on when
  1786.           {COMMO} is started.
  1787.  
  1788.      _________________________________________
  1789.  
  1790.      {cpf=no}       Capture File open (yes/no)
  1791.      _________________________________________
  1792.  
  1793.           If this is set to "yes" Capture will be open when {COMMO} is
  1794.           started.  See "Capture File Options."
  1795.  
  1796.      ____________________________________________________
  1797.  
  1798.      {cpm=screen}        Capture Mode (screen/filter/raw)
  1799.      ____________________________________________________
  1800.  
  1801.           See "Capture File Options" for a description of each mode.
  1802.  
  1803.      __________________________________________________
  1804.  
  1805.      {tek=no}       Test for enhanced keyboard (yes/no)
  1806.      __________________________________________________
  1807.  
  1808.           Set this to "yes" if your system supports the enhanced (101
  1809.           key) keyboard.  This will enable you to assign F11, F12 and
  1810.           a number of other keys to your macros.  See Appendix A
  1811.           "Table of {COMMO} Key-labels" in the Macro Programming
  1812.           Guide.
  1813.  
  1814.      ____________________________________________________________
  1815.  
  1816.      {tsn=yes}      Display time of day with System Name (yes/no)
  1817.      ____________________________________________________________
  1818.  
  1819.           If this is "yes" the time of day will be displayed on the
  1820.           right side of the Status Line.  Set this to "no" if you want
  1821.           the System Name given more space.  Note that this has no
  1822.           effect when the Signal Lights are displayed.
  1823.  
  1824.      _______________________________________
  1825.  
  1826.      {snd=yes}      Master Sound on (yes/no)
  1827.      _______________________________________
  1828.  
  1829.           If this is set to "yes" sound will be on when {COMMO} is
  1830.           started.  If "no" all sounds will be silenced. 
  1831.  
  1832.  
  1833.  
  1834.                    {COMMO} (tm)  User Guide and Reference           37
  1835.  
  1836.  
  1837.      ________________________________________________
  1838.  
  1839.      {dca=yes}      Dialing connection alarm (yes/no)
  1840.      ________________________________________________
  1841.  
  1842.           Controls the alarm that signals a connection when Auto
  1843.           Dialing is used.  The alarm will not be sounded when a valid
  1844.           Linked Macro is specified in the Dialing Directory.
  1845.  
  1846.      ___________________________________________________
  1847.  
  1848.      {afa=yes}      ASCII Upload finished alarm (yes/no)
  1849.      ___________________________________________________
  1850.  
  1851.           Controls the alarm that signals completion of an ASCII
  1852.           Upload.
  1853.  
  1854.      ______________________________________________________
  1855.  
  1856.      {ers=yes}      Make sounds on errors/warnings (yes/no)
  1857.      ______________________________________________________
  1858.  
  1859.           This controls the special sounds made for certain errors and
  1860.           warning messages.
  1861.  
  1862.      ____________________________________________________
  1863.  
  1864.      {rng=3}        Maximum number of alarm rings (1-999)
  1865.      ____________________________________________________
  1866.  
  1867.           Sets the number of times the alarm will ring.  You may press
  1868.           a key at any time to stop the alarm.
  1869.  
  1870.      _________________________________________________________
  1871.  
  1872.      {sbs=10}       Scrollback buffer size in kilobytes (0-64)
  1873.      _________________________________________________________
  1874.  
  1875.           The actual minimum size of the buffer (which {COMMO} will
  1876.           compute) depends on the number of screen lines and columns. 
  1877.           For a 25x80 screen it will be about 4k bytes -- it will be
  1878.           larger for screens with more lines and/or columns.  This
  1879.           includes room to save the current screen.
  1880.  
  1881.           Setting the size to 0 disables the Scrollback feature.  See
  1882.           also "Scrollback."
  1883.  
  1884.  
  1885.  
  1886.                    {COMMO} (tm)  User Guide and Reference           38
  1887.  
  1888.  
  1889.      ______________________________________________________________
  1890.  
  1891.      {adn=no}       Auto-detect number of rows and columns (yes/no)
  1892.      ______________________________________________________________
  1893.  
  1894.           {COMMO} will support 25 to 127 rows and 80 to 255 columns on
  1895.           the display, but you MUST set the display into the proper
  1896.           mode before starting the program (EGA/VGA adapters usually
  1897.           come with utilities to set modes such as 50x80, 44x132,
  1898.           etc.).
  1899.  
  1900.           Set this item to "yes" if you want {COMMO} to automatically
  1901.           obtain the current number of rows and columns from the
  1902.           system.  Most systems provide this information.  If the
  1903.           display is unsatisfactory, you may have to set it to "no."
  1904.  
  1905.           NOTE:  The cursor may not display properly in 43 line mode. 
  1906.           This is a problem with some EGA adapters.
  1907.  
  1908.      ________________________________________________________
  1909.  
  1910.      {ucw=18}       Number of lines in upper Chat Mode window
  1911.      ________________________________________________________
  1912.  
  1913.           This allows you to adjust the line "split" in Chat Mode. 
  1914.           The minimum number of lines in the upper or lower window is
  1915.           three.
  1916.  
  1917.      _______________________________________________________________
  1918.  
  1919.      {swe=no}       Send when Enter is pressed in Chat Mode (yes/no)
  1920.      _______________________________________________________________
  1921.  
  1922.           If "no" {COMMO} will send each character as you type it.  If
  1923.           "yes" {COMMO} will wait until you press Enter, then send all
  1924.           that you have typed.
  1925.  
  1926.      _________________________________________________
  1927.  
  1928.      {sfi=no}       Speech Friendly Interface (yes/no) 
  1929.      _________________________________________________
  1930.  
  1931.           If this is "yes" {COMMO} will be much friendlier to users
  1932.           with speech synthesizer boards (these enable blind users to
  1933.           read the computer display).  Terminal Screen data and many
  1934.           error and information messages will be displayed using the
  1935.           BIOS.  Also, the up and down arrow keys move the cursor
  1936.           instead of scrolling the screen in windows such as Online
  1937.           Help, Scrollback and View String Variable Space.
  1938.  
  1939.  
  1940.  
  1941.                    {COMMO} (tm)  User Guide and Reference           39
  1942.  
  1943.  
  1944.      ______________________________________________________________
  1945.  
  1946.      {bsc=no}       Use BIOS for Terminal Screen scrolling (yes/no)
  1947.      {sno=no}       Snow checking on CGA adapter (yes/no)
  1948.      ______________________________________________________________
  1949.  
  1950.           Change these video parameters only if necessary.
  1951.  
  1952.           o    BIOS scrolling enables external scrollback programs to
  1953.                work, but is slower and may cause "flicker" in certain
  1954.                displays.
  1955.  
  1956.           o    Snow checking will also slow the display, but will help
  1957.                to eliminate the "snow" effect on CGA monitors.
  1958.  
  1959.      ______________________________________________
  1960.  
  1961.      {ema=no}       Enable mono attributes (yes/no)
  1962.      ______________________________________________
  1963.  
  1964.           If this is "no" the default mono attributes will be used, no
  1965.           matter what colors are set in the following items.  Set it
  1966.           to "yes" if you want to set your own monochrome attributes
  1967.           (high intensity, reverse video, underline, etc.).  This has
  1968.           no effect on color displays.
  1969.  
  1970.      _________________________________________
  1971.  
  1972.      {tsc=07}       Terminal Screen colors
  1973.      {slc=17}       Status Line colors
  1974.      {fwt=17}       File window text colors
  1975.      {fwb=70}       File window border colors
  1976.      {fws=3f}       File window cursor colors
  1977.      {swt=70}       Small window text colors
  1978.      {swb=17}       Small window border colors
  1979.      _________________________________________
  1980.  
  1981.           Press F7 while editing the Setup File to pop up the color
  1982.           chart.  You may use it with color or monochrome displays.
  1983.  
  1984.           NOTE:  For the most accurate ANSI-BBS or VT102 terminal
  1985.           emulation, the Terminal Screen colors should be set to {07}. 
  1986.           In many cases, {COMMO} uses this color when clearing
  1987.           portions of the screen or when a "reset attributes" sequence
  1988.           is received from the host.
  1989.  
  1990.           "File windows" are full-screen windows such as the Dialing
  1991.           Directory, Macro File, Scrollback Buffer, etc.  "Small
  1992.           windows" are the pop up windows such as Capture File Options
  1993.           or ASCII Upload.
  1994.  
  1995.  
  1996.  
  1997.                    {COMMO} (tm)  User Guide and Reference           40
  1998.  
  1999.  
  2000.           Colors should be set so that the different parts of the
  2001.           screen contrast with each other.  For example the Status
  2002.           Line should be easily discernable from the rest of the
  2003.           Terminal Screen.  And the borders and Selector Bar should
  2004.           stand out against the text portion of the file windows.
  2005.  
  2006.  
  2007.      (End of Setup File items)
  2008.  
  2009.  
  2010.      =================
  2011.      [Alt-H]   Hang Up
  2012.      =================
  2013.  
  2014.      Disconnects the call by dropping DTR.  This will put the modem
  2015.      "on-hook" if response to DTR is enabled (see Appendix A).  If
  2016.      your modem does not respond properly, you may define a macro to
  2017.      send a "hang-up" command.  For modems using the "AT" command set
  2018.      the macro would look like this:
  2019.  
  2020.         {alh} {send ~~~+++~~~ATH|} {}    Press Alt-H to hangup
  2021.         
  2022.      Of course, you may assign this macro to any key you like.
  2023.  
  2024.  
  2025.      ===========================
  2026.      [Alt-I]   Screen Image Save
  2027.      ===========================
  2028.  
  2029.      The Screen Image Save is used to append all of the text currently
  2030.      on the screen to a disk file.  This is sometimes handier than
  2031.      repeatedly opening and closing the Capture File.
  2032.  
  2033.      TIPS on using Screen Image Save:
  2034.  
  2035.      >    The pathname may not be the same as the pathname of an open
  2036.           Capture File.
  2037.  
  2038.      >    If the file cannot be opened, the old pathname is retained.
  2039.  
  2040.      NOTE:  The current Screen Image Save file is also used to save
  2041.      blocks of text in the Scrollback feature.
  2042.  
  2043.      See also "Capture File Options" and "Scrollback."
  2044.  
  2045.  
  2046.  
  2047.                    {COMMO} (tm)  User Guide and Reference           41
  2048.  
  2049.  
  2050.      ====================
  2051.      [Alt-K]   Scrollback
  2052.      ====================
  2053.  
  2054.      Scrollback allows you to see what was previously on your screen. 
  2055.      Screen data is saved to a memory buffer (the size is defined in
  2056.      the Setup File).  Set the size to 0 to disable the feature
  2057.      entirely.
  2058.  
  2059.      A number of commands are available in Scrollback:
  2060.  
  2061.      1)   You may navigate as in the Online Help file -- scroll
  2062.           up/down, page up/down, beginning/end of buffer, etc.
  2063.  
  2064.      2)   Use the String Search feature available in all {COMMO} file
  2065.           windows.
  2066.  
  2067.      3)   Change the Screen Image Save pathname.
  2068.  
  2069.      4)   Write any part of the Scrollback buffer to the current
  2070.           Screen Image Save file.
  2071.  
  2072.      5)   Exit and return to the same place the next time you call
  2073.           Scrollback.
  2074.  
  2075.      6)   Jump directly to the Dialing Directory or Macro Processor
  2076.           windows.
  2077.  
  2078.  
  2079.      =========================
  2080.      [Alt-M]   Macro Processor
  2081.      =========================
  2082.  
  2083.      The Macro Processor executes {COMMO} macros which are resident in
  2084.      memory.  Macros are loaded at program startup from a Macro File
  2085.      (the default is COMMO.MAC, but an alternate file may be loaded
  2086.      using the "/m" command line switch).  A new Macro File can be
  2087.      loaded at any time using the MACLoad macro function.  The Macro
  2088.      File is maintained with the Internal Editor.
  2089.  
  2090.      IMPORTANT:  Only macros resident in memory may be executed.
  2091.  
  2092.      The Macro Programming Guide shows you how easily you can automate
  2093.      program operations, link to external protocols (used for
  2094.      Uploading/Downloading), assign keys and perform a myriad of other
  2095.      functions.
  2096.  
  2097.      See Online Help for details on operations within the Macro
  2098.      Processor window.
  2099.  
  2100.  
  2101.  
  2102.                    {COMMO} (tm)  User Guide and Reference           42
  2103.  
  2104.  
  2105.      ==============================
  2106.      [Alt-N]   Multi Number Dialing
  2107.      ==============================
  2108.  
  2109.      Any number of entries may be "marked" in the Dialing Directory,
  2110.      then automatically dialed in sequence until a connection is
  2111.      established.  Multi Number Dialing may be initiated in one of
  2112.      four ways:
  2113.  
  2114.      1)   Bring up the Dialing Directory window with Alt-D, then move
  2115.           the Selector Bar to each desired entry and press [Space]
  2116.           (repeat the procedure to unmark an entry).  Press Alt-N to
  2117.           begin dialing at the location of the Selector Bar.
  2118.  
  2119.      2)   Specify entries with Dialing Strings on the command line
  2120.           used to run {COMMO} (see "Command Line Options").  Specified
  2121.           entries will be marked and dialed in sequence when {COMMO}
  2122.           is started.
  2123.  
  2124.      3)   Specify entries with Dialing Strings in a macro, using the
  2125.           MARK function.  Refer to the Macro Programming Guide.
  2126.  
  2127.      4)   Press Alt-N from the Terminal Screen.  Dialing of marked
  2128.           entries will resume with the next system in the sequence.
  2129.  
  2130.      See also "[Alt-D]  Dialing Directory" and the DIAL function in
  2131.      the Macro Programming Guide. 
  2132.  
  2133.  
  2134.      ==========================================
  2135.      [Alt-O]   Send Modem Initialization String
  2136.      ==========================================
  2137.  
  2138.      Pressing Alt-O at any time from the Terminal Screen will cause
  2139.      the Modem Initialization String to be sent to the modem (if one
  2140.      is defined).  This is useful if your modem was powered off or if
  2141.      the modem setup was changed.
  2142.  
  2143.  
  2144.      =================================
  2145.      [Alt-P]   Set Terminal Parameters
  2146.      =================================
  2147.  
  2148.      The Terminal Parameters affect the transmission of data to and
  2149.      from your computer.  They are usually displayed or defined with a
  2150.      string.  For example:
  2151.  
  2152.                {2400,8n1,1,A,0}    Speed,format,port,terminal,delay.
  2153.  
  2154.      {COMMO} keeps two complete sets of Terminal Parameters:
  2155.  
  2156.  
  2157.  
  2158.                    {COMMO} (tm)  User Guide and Reference           43
  2159.  
  2160.  
  2161.           1)   The Current Parameters as shown on the left side of the
  2162.                Status Line.
  2163.  
  2164.           2)   The Default Dialing Parameters.  These will be set each
  2165.                time a number is dialed unless overridden by parameters
  2166.                in the Dialing Directory.
  2167.  
  2168.  
  2169.      Parameter Descriptions
  2170.      ======================
  2171.  
  2172.           _____
  2173.  
  2174.           Speed
  2175.           _____
  2176.  
  2177.      The rate at which data travels between your computer and your
  2178.      modem (or remote system if no modem is used).  It is specified as
  2179.      "bits per second" or "bps."  Allowable values are 300, 600, 1200,
  2180.      2400, 4800, 9600, 19200, 38400, 57600, 115200.  These may be
  2181.      abbreviated to the first two characters in Serial Port Parameter
  2182.      strings.
  2183.  
  2184.      See "AutoBaud Detect" for more information on setting the Speed.
  2185.  
  2186.           ___________
  2187.  
  2188.           Data Format
  2189.           ___________
  2190.  
  2191.      This consists of three parts.  Allowable values are:
  2192.  
  2193.           character length:   7, 8
  2194.           parity:             [n]one, [e]ven, [o]dd, [m]ark, [s]pace
  2195.           stop-bits:          1, 2
  2196.  
  2197.      Examples:
  2198.  
  2199.           7o2       7 bit characters, odd parity, 2 stop bits
  2200.           8m1       8 bit characters, mark parity, 1 stop bit
  2201.  
  2202.      The most common formats, "8n1" and "7e1", may be abbreviated to
  2203.      "8" and "7" in parameter strings, such as:
  2204.  
  2205.           {2400,8,1,A,0}
  2206.  
  2207.  
  2208.  
  2209.                    {COMMO} (tm)  User Guide and Reference           44
  2210.  
  2211.  
  2212.           ___________
  2213.  
  2214.           Serial Port
  2215.           ___________
  2216.  
  2217.      The channel your computer uses to talk to the outside world.  May
  2218.      be 1, 2, 3 or 4 (for Com1, Com2, Com3 or Com4).
  2219.  
  2220.      NOTE:  PCjr users without the internal modem should specify Com2.
  2221.  
  2222.           _______________________
  2223.  
  2224.           Terminal Emulation Type
  2225.           _______________________
  2226.  
  2227.      {COMMO} supports the following terminal types:
  2228.  
  2229.           ANSI-BBS  (A)  For calling most bulletin board systems.
  2230.           VT102     (V)  For calling certain mainframes and online
  2231.                          services.
  2232.           TTY       (T)  For turning off almost all control functions
  2233.                          (lets you see ANSI control sequences).
  2234.           TTY(40)   (H)  HP 95LX version only.  Wraps terminal lines
  2235.                          at 40 columns.  Use when the host cannot be
  2236.                          configured for 40 columns.
  2237.  
  2238.           _____________________
  2239.  
  2240.           Inter-Character Delay
  2241.           _____________________
  2242.  
  2243.      This factor defines the amount of delay to insert between
  2244.      characters transmitted by the SEND macro function and by ASCII
  2245.      Upload.  Use only when the remote is too slow to process the data
  2246.      (drops characters).
  2247.  
  2248.      Each unit is about 5 thousandths of a second (5 ms) on a 4.77 MHz
  2249.      XT class machine.  Faster machines require higher values -- on a
  2250.      12 MHz AT each unit will only be about 1 ms.
  2251.  
  2252.      For example, to delay 20 ms between characters (50 cps) use a
  2253.      factor of:
  2254.  
  2255.                 4 on 4.77 MHz XT
  2256.                16 on 12 MHz AT
  2257.                27 on 20 MHz 386
  2258.  
  2259.      The factor will also vary when you use multi-tasking software, so
  2260.      adjust as necessary.  The maximum delay allowed is one second.
  2261.  
  2262.  
  2263.  
  2264.                    {COMMO} (tm)  User Guide and Reference           45
  2265.  
  2266.  
  2267.      Setting Terminal Parameters
  2268.      ===========================
  2269.  
  2270.           __________________________
  2271.  
  2272.           With the Alt-P Key Command
  2273.           __________________________
  2274.  
  2275.      Alt-P may be used at any time to change the Current Parameters or
  2276.      the Default Dialing Parameters.  Remember that Current Parameters
  2277.      will be reset to the Default Dialing Parameters whenever dialing
  2278.      begins.
  2279.  
  2280.           ________________________
  2281.  
  2282.           In the Dialing Directory
  2283.           ________________________
  2284.  
  2285.      Serial Port Parameters may be specified in a Dialing Directory
  2286.      entry to override the Default Dialing Parameters.  Specify only
  2287.      values that are different.  For example:
  2288.  
  2289.           {,,3,V}   A different serial port and terminal emulation is
  2290.                     required for this call.
  2291.  
  2292.           {,8o2}    Unusual format required.
  2293.  
  2294.           __________________________________________
  2295.  
  2296.           Using the Macro functions PARMs and DPARms
  2297.           __________________________________________
  2298.  
  2299.      Use these to set parameters during macro execution.  See the
  2300.      Macro Programming Guide.
  2301.  
  2302.  
  2303.      ======================
  2304.      [Alt-S]   Shell to DOS
  2305.      ======================
  2306.  
  2307.      When you Shell to DOS {COMMO} remains resident in memory and you
  2308.      may perform any DOS functions as you normally do.  Since {COMMO}
  2309.      is small in size, most of your memory is available when you use
  2310.      this key command.
  2311.  
  2312.  
  2313.  
  2314.                    {COMMO} (tm)  User Guide and Reference           46
  2315.  
  2316.  
  2317.      =====================
  2318.      [Alt-T]   Set Toggles
  2319.      =====================
  2320.  
  2321.      This key command is used to set a number of miscellaneous toggle
  2322.      (yes/no) parameters.  Some take effect while you are still in the
  2323.      Set Toggles window -- others when you exit the window.
  2324.  
  2325.      Some of the toggles will be described here.  The others are
  2326.      detailed in their respective sections of this document.
  2327.  
  2328.  
  2329.      Sound Control Toggle
  2330.      ====================
  2331.  
  2332.      This is the Master Sound Control toggle.  When sound is OFF all
  2333.      alarms, sounds and beeps will be silenced.  Alarms are
  2334.      individually controlled with items in the Setup File and with the
  2335.      "A" switch in EXECute macro functions.
  2336.  
  2337.  
  2338.      AutoBaud Toggle
  2339.      ===============
  2340.  
  2341.      AutoBaud Detect enables {COMMO} to automatically adjust to the
  2342.      line speed of the system you are calling.  You won't have to hang
  2343.      up and call back when you get the wrong speed.
  2344.  
  2345.      TIPS on using AutoBaud:
  2346.  
  2347.      >    Your modem must be set to return the connection speed
  2348.           responses such as "CONNECT 1200" (see Appendix A "Setting Up
  2349.           Your Modem").
  2350.  
  2351.      >    The Default Dialing Speed in the Setup File should be set to
  2352.           your modem's highest speed.
  2353.  
  2354.           ____________________
  2355.  
  2356.           Most 2400 bps modems
  2357.           ____________________
  2358.  
  2359.      Toggle AutoBaud Detect to the ON state.  Set the Default Dialing
  2360.      Speed in the Setup File to 2400.  The following modem responses
  2361.      will cause the indicated actions:
  2362.  
  2363.           CONNECT 2400  -->  serial port remains at 2400 bps
  2364.           CONNECT 1200  -->  serial port adjusted to 1200 bps
  2365.           CONNECT       -->  serial port adjusted to 300 bps
  2366.  
  2367.  
  2368.  
  2369.                    {COMMO} (tm)  User Guide and Reference           47
  2370.  
  2371.  
  2372.           _________________
  2373.  
  2374.           High-speed modems
  2375.           _________________
  2376.  
  2377.  
  2378.      Most high-speed modems require that the serial port be "locked"
  2379.      at 19200 bps or 38400 bps.  The modem will then automatically
  2380.      adjust to the line (modem-to-modem) speed.  In this case AutoBaud
  2381.      must be turned OFF to prevent {COMMO} from changing the serial
  2382.      port speed.
  2383.  
  2384.      IMPORTANT!  Check your modem manual for details.
  2385.  
  2386.  
  2387.      Local Echo Toggle
  2388.      =================
  2389.  
  2390.      Local Echo (sometimes called half-duplex) is normally used when
  2391.      you connect to a host that does not echo what you type.  {COMMO}
  2392.      will assume that the host is sending a linefeed with each
  2393.      carriage return.
  2394.  
  2395.      Typed characters will be displayed directly to the screen.
  2396.  
  2397.  
  2398.      Signal Lights Toggle
  2399.      ====================
  2400.  
  2401.      Turns ON/OFF the "modem lights" display on the Status Line. 
  2402.      Shows the state of the RS-232C signals, including send and
  2403.      receive.
  2404.  
  2405.      This toggles the right half of the Status Line from the System
  2406.      Name to the Signal Lights Display.  See "What is on the Status
  2407.      Line" in Online Help for a complete description of the Status
  2408.      Line indicators.
  2409.  
  2410.  
  2411.      ======================
  2412.      [Alt-U]   Utility Menu
  2413.      ======================
  2414.  
  2415.      The Utility Menu is supported by a macro in COMMO.MAC.  It
  2416.      contains a selection of features created by {COMMO} macros.
  2417.  
  2418.      Example features include:
  2419.  
  2420.           Edit any external text file less than 64k in size.
  2421.           Run any macro by name (label).
  2422.           Run the host mode macro, MOSTHOST.MAC.
  2423.           Edit the host mode macro.
  2424.  
  2425.  
  2426.  
  2427.                    {COMMO} (tm)  User Guide and Reference           48
  2428.  
  2429.  
  2430.  
  2431.      NOTE:  The Utility Menu will not be available when another Macro
  2432.      File has been loaded by the MACLoad macro function.
  2433.  
  2434.  
  2435.      ===============================
  2436.      [Alt-W]   Send Current Password
  2437.      ===============================
  2438.  
  2439.      Each entry in the Dialing Directory can have its own Password
  2440.      String.  After dialing a number, the Alt-W key command will send
  2441.      the current Password String to the remote system.
  2442.  
  2443.      For additional details on Passwords see "[Alt-D]  Dialing
  2444.      Directory."
  2445.  
  2446.  
  2447.      ===========================
  2448.      [Alt-X]   Exit from {COMMO}
  2449.      ===========================
  2450.  
  2451.      This key command will cause {COMMO} to terminate, saving all
  2452.      support files with outstanding changes.
  2453.  
  2454.      You may configure {COMMO} to leave DTR high when exiting so that
  2455.      you may exit and remain connected to a system (this is the
  2456.      default, see "[Alt-G]  Edit Setup File").
  2457.  
  2458.      If you re-enter {COMMO} while still online you should use the
  2459.      "/in" command line switch to prevent the Modem Initialization
  2460.      String from being sent.
  2461.  
  2462.      Alt-X may also be pressed from the Dialing Directory, Macro File
  2463.      or Scrollback windows for a quick exit.
  2464.  
  2465.  
  2466.      ==============================
  2467.      [Alt-1]   Capture File Options
  2468.      ==============================
  2469.  
  2470.      When Capture is OPEN all information written to your screen will
  2471.      be saved to the designated disk file.  This command allows you
  2472.      to:
  2473.  
  2474.           1)   OPEN/CLOSE the Capture File.
  2475.           2)   Change to a different file.
  2476.           3)   Change the Capture Mode.
  2477.  
  2478.      Data may be captured in one of three modes.  The startup Capture
  2479.      Mode is selected in the Setup File.
  2480.  
  2481.  
  2482.  
  2483.                    {COMMO} (tm)  User Guide and Reference           49
  2484.  
  2485.  
  2486.           If the mode is set to SCREEN, data will be captured exactly
  2487.           as it appears on the Terminal Screen.  This mode greatly
  2488.           improves the appearance of data captured from screens drawn
  2489.           with ANSI positioning sequences (animation).
  2490.  
  2491.           FILTER mode is used primarily when you need to capture lines
  2492.           longer than the width of the screen (e.g., to be printed on
  2493.           a wide carriage printer).  ANSI control sequences will be
  2494.           stripped out if ANSI-BBS or VT102 emulation is on. 
  2495.           Characters will be translated if the receive Translate Table
  2496.           is on.
  2497.  
  2498.           Use RAW mode when you want all data captured exactly as it
  2499.           comes from the serial port.  ANSI control sequences will not
  2500.           be stripped and length of lines will be preserved.  This
  2501.           mode can be used to capture ANSI animation and color to be
  2502.           "played back" later.
  2503.  
  2504.      TIPS on using the Capture File:
  2505.  
  2506.      >    IMPORTANT!  When capturing to a floppy drive, the diskette
  2507.           should not be removed until the Capture File is closed (this
  2508.           also applies if the "disk full" message appears).  DOS is
  2509.           unaware of a disk change and may overwrite the replacement
  2510.           disk.
  2511.  
  2512.      >    The old file will be closed if a new file is opened.
  2513.  
  2514.      >    If Capture Mode is set to SCREEN, text will be saved as it
  2515.           scrolls OFF the screen.  To prevent loss of data, the entire
  2516.           screen will be saved in the following situations:
  2517.  
  2518.                (1) whenever the screen is cleared
  2519.                (2) Capture is closed with Alt-1
  2520.                (3) {COMMO} is terminated
  2521.                (4) the mode is changed from SCREEN to FILTER or RAW
  2522.  
  2523.      >    If Capture Mode is set to FILTER or RAW, text will be saved
  2524.           as it arrives from the serial port.
  2525.  
  2526.      See also "Screen Image Save."
  2527.  
  2528.  
  2529.      ==========================
  2530.      [Alt-2]   Print Log Toggle
  2531.      ==========================
  2532.  
  2533.      Turns the Print Log ON/OFF.  When ON all information written to
  2534.      your screen will be printed to LPT1.  Handy for getting hard-copy
  2535.      of file lists, messages, etc.
  2536.  
  2537.      TIPS on using the Print Log:
  2538.  
  2539.  
  2540.  
  2541.                    {COMMO} (tm)  User Guide and Reference           50
  2542.  
  2543.  
  2544.  
  2545.      >    Text is printed as it scrolls OFF the screen.
  2546.  
  2547.      >    To prevent loss of data, the entire screen will be printed
  2548.           in the following situations:
  2549.  
  2550.                (1) whenever the screen is cleared
  2551.                (2) Print Log is turned off with Alt-2
  2552.                (3) {COMMO} is terminated
  2553.  
  2554.      >    Flow Control should be used if your printer cannot keep up
  2555.           with the incoming data (see Appendix C).
  2556.  
  2557.  
  2558.      ==========================
  2559.      [Alt--]   Chat Mode Toggle  (Alt minus)
  2560.      ==========================
  2561.  
  2562.      Chat Mode is normally used when you wish to converse via
  2563.      keyboard. The screen will be split with the upper portion showing
  2564.      what the remote is sending, while the lower portion shows what
  2565.      you type.
  2566.  
  2567.      The method used to send typed characters is selected in the Setup
  2568.      File under the section "Video and Chat Mode."  The two possible
  2569.      methods are:
  2570.  
  2571.           1)   Each character is sent as you type it.  This method is
  2572.                normally used when you are chatting with another person
  2573.                who is also in Chat Mode.
  2574.  
  2575.           2)   All characters are sent at once when you press Enter
  2576.                (up to 240 characters will be buffered).  Use this
  2577.                method when you are using a teleconferencing system or
  2578.                "CB Simulator."
  2579.  
  2580.      The number of lines in the upper and lower portions of the screen
  2581.      (the "line split") may also be set in the "Video and Chat Mode"
  2582.      section.
  2583.  
  2584.      TIPS on using Chat Mode:
  2585.  
  2586.      >    Alt-- (Alt minus) is used to enter AND exit Chat Mode.
  2587.  
  2588.      >    All {COMMO} functions are available in Chat Mode except
  2589.           Doorway Mode.
  2590.  
  2591.  
  2592.  
  2593.                    {COMMO} (tm)  User Guide and Reference           51
  2594.  
  2595.  
  2596.      =============================
  2597.      [Alt-=]   Doorway Mode Toggle
  2598.      =============================
  2599.  
  2600.      Definition: "Extended keys" are function keys, Alt keys, cursor
  2601.      keys, etc.  In other words, keys that do not generate ASCII
  2602.      characters.
  2603.  
  2604.      In Doorway Mode all extended keys will send their key codes to
  2605.      the remote (instead of activating {COMMO} functions).  Thus
  2606.      Doorway Mode can be used to operate most application software on
  2607.      the remote system when used with a host program such as Marshall
  2608.      Dudley's Doorway.  In addition some BBS full-screen editors use
  2609.      Doorway Mode.
  2610.  
  2611.      TIPS on using Doorway Mode:
  2612.  
  2613.      >    The Alt-= key is necessarily reserved for exiting Doorway
  2614.           Mode and thus cannot be sent to the remote.  Be sure to
  2615.           configure remote applications accordingly.
  2616.  
  2617.      >    The display should be set to the number of lines expected by
  2618.           the host program.  Usually this is 25 lines of text.  If
  2619.           your display is not in the proper mode, the results will be
  2620.           unpredictable.
  2621.  
  2622.      >    The Status Line is normally suppressed in Doorway Mode, but
  2623.           may be turned on by using the "S" switch in a macro:
  2624.  
  2625.                {:al=} {doorway-s} {}
  2626.  
  2627.           The "s" switch is ignored when exiting Doorway Mode and the
  2628.           Status Line will be restored to its previous state. 
  2629.           Remember that when the Status Line is on, there is one less
  2630.           usable line on the Terminal Screen.
  2631.  
  2632.      >    If it is necessary to clear the screen or to reset the
  2633.           terminal emulation mode parameters when starting Doorway
  2634.           Mode, use a macro.  For example:
  2635.  
  2636.                {:al=} {clear} {parms ,,,a} {doorway} {}
  2637.  
  2638.           This macro will execute when entering or exiting Doorway
  2639.           Mode (Alt-= must be used to exit, but any key may be
  2640.           assigned to enter Doorway Mode).
  2641.  
  2642.      >    For most applications you will want Terminal-Type set to
  2643.           ANSI-BBS.  It's a good idea to enter Doorway Mode before
  2644.           starting the host program.  The host may send commands to
  2645.           initialize the terminal.
  2646.  
  2647.  
  2648.  
  2649.                    {COMMO} (tm)  User Guide and Reference           52
  2650.  
  2651.  
  2652.      >    If Software Flow Control is enabled, the ASCII character
  2653.           values 17 and 19 (XON and XOFF) will not display.  If these
  2654.           characters are needed, Software Flow Control must be turned
  2655.           off.
  2656.  
  2657.  
  2658.      =============================
  2659.      [F1]   How to Use Online Help
  2660.      =============================
  2661.  
  2662.      A summary of {COMMO}'s operations is available by pressing F1. 
  2663.      The Online Help support file, COMMO.HLP, must be in the {COMMO}
  2664.      home directory or you will get an error message.
  2665.  
  2666.      This message will also be issued if there is not enough memory to
  2667.      load the Online Help file.  Note that the file is retained in
  2668.      memory until {COMMO} requires memory for some other program
  2669.      function.  It will automatically be re-read when necessary. 
  2670.  
  2671.      Once the Help window is entered you will see the Help control
  2672.      keys listed at the bottom of the screen.  At this point you may
  2673.      obtain more detailed information about using Online Help by
  2674.      typing "H".
  2675.  
  2676.  
  2677.      Modifying the Help File
  2678.      =======================
  2679.  
  2680.      When you are familiar with {COMMO} you may wish to reduce the
  2681.      size of the Help File.  Feel free to edit this file -- you can
  2682.      even set up your own menu.
  2683.  
  2684.      The search keys are in the bars separating the topics.  The
  2685.      character following the "T" in the middle of the bar may be
  2686.      changed to create your own key.  Keep in mind that the context-
  2687.      related Help uses topic characters that cannot be changed.
  2688.  
  2689.      The HELP macro function enables you to assign a key to go
  2690.      directly to any topic in Online Help.  For example:
  2691.  
  2692.                {:cf6} {help J} {}
  2693.  
  2694.      will go to topic "TJ" when Ctrl-F6 is pressed.  Use any single
  2695.      character as the key (do not include the "T").
  2696.  
  2697.      If you change the Help File, remember to keep a backup copy of
  2698.      the original.
  2699.  
  2700.  
  2701.  
  2702.                    {COMMO} (tm)  User Guide and Reference           53
  2703.  
  2704.  
  2705.      ====================================
  2706.      [PgUp]/[PgDn]  Uploading/Downloading
  2707.      ====================================
  2708.  
  2709.      When you press PgUp or PgDn you will be presented with a menu
  2710.      from which you may select a file transfer protocol.  Protocols
  2711.      provide the ability to transfer any kind of data using error
  2712.      correction methods.
  2713.  
  2714.      {COMMO} has the Xmodem and Xmodem-1k (old Ymodem) protocols built
  2715.      in and provides you with macros to send and receive.  In addition
  2716.      the Macro File is pre-configured with macros that execute various
  2717.      popular protocol drivers, including DSZ which performs Zmodem,
  2718.      Ymodem Batch and Ymodem-G uploads and downloads.
  2719.  
  2720.      The PgUp and PgDn menus are implemented using {COMMO}'s powerful
  2721.      Macro Processor which enables you to execute internal and
  2722.      external protocols easily and seamlessly (see below for details
  2723.      on obtaining and installing several of these drivers).
  2724.  
  2725.      You may add macros for any other protocol drivers that you need. 
  2726.      See the Macro Programming Guide for details on writing macros.
  2727.  
  2728.  
  2729.      How to Install External Protocol Drivers
  2730.      ========================================
  2731.  
  2732.      Protocols such as Zmodem, HS/Link and MPt offer greater
  2733.      convenience, speed and reliability.  They include features such
  2734.      as:
  2735.  
  2736.           1) Automatic startup.
  2737.           2) Transmission of file names, sizes and dates.
  2738.           3) Batch (multiple file) transfers.
  2739.           4) Resuming partial (failed) transfers.
  2740.           5) Bi-directional transfers (HS/Link only)
  2741.  
  2742.      External protocol "drivers" can be obtained from BBS's and other
  2743.      sources.  You can download them using {COMMO}'s internal
  2744.      protocols.
  2745.  
  2746.      To install DSZ, HS/Link, MPt or OZBEXT, just place the executable
  2747.      file (e.g., DSZ.COM, HSLINK.EXE, MPT.EXE, OZBEXT.EXE) in a
  2748.      directory which is specified in your DOS path statement.  If you
  2749.      don't have a path statement in your AUTOEXEC.BAT file, place the
  2750.      executable in your C:\COMMO directory.  In the latter case,
  2751.      change to this directory before you start {COMMO}.
  2752.  
  2753.      Each of the protocol driver programs has additional features that
  2754.      may be useful to you.  Refer to the program's documentation for
  2755.      more information.
  2756.  
  2757.  
  2758.  
  2759.                    {COMMO} (tm)  User Guide and Reference           54
  2760.  
  2761.  
  2762.  
  2763.      Using DSZ or GSZ
  2764.      ================
  2765.  
  2766.      NOTE:  These are Shareware programs from Omen Technology.  Like
  2767.      {COMMO}, they must be registered for continued use (some features
  2768.      are not enabled in the unregistered versions).  DSZ may almost
  2769.      always be found where you obtained {COMMO} and is usually
  2770.      archived as DSZmmdd.ZIP (mmdd is a release date).
  2771.  
  2772.      DSZ will transfer files using Zmodem, Ymodem Batch and Ymodem-G.
  2773.  
  2774.      The executable file to install is DSZ.COM.
  2775.  
  2776.      GSZ is functionally equivalent to DSZ.  In addition GSZ provides
  2777.      an attractive graphic display of the file transfer in progress. 
  2778.      To use GSZ you need only change one item in the Setup file:
  2779.  
  2780.           {set dszprog,GSZ.EXE}
  2781.  
  2782.      The executable file to install is GSZ.EXE.
  2783.  
  2784.  
  2785.      Using HS/Link
  2786.      =============
  2787.  
  2788.      HS/Link is a Shareware program that offers very fast file
  2789.      transfers.  It also has bi-directional capability for uploading
  2790.      and downloading simultaneously with a full-duplex modem (make
  2791.      sure the remote system allows this feature before attempting it).
  2792.  
  2793.      When you select a download with HS/Link (or if it is started
  2794.      automatically, see "Auto Receive"), you will be asked to enter a
  2795.      "Filename to Upload" as well.  Just press Enter for download
  2796.      only.
  2797.  
  2798.      The executable file to install is HSLINK.EXE.
  2799.  
  2800.  
  2801.      Using MPt
  2802.      =========
  2803.  
  2804.      MPt is a Shareware program that transfers files using the MPt
  2805.      protocol (similar to Zmodem, but not compatible).  It offers an
  2806.      excellent graphic display during file transfers.
  2807.  
  2808.      The executable file to install is MPT.EXE.
  2809.  
  2810.  
  2811.  
  2812.                    {COMMO} (tm)  User Guide and Reference           55
  2813.  
  2814.  
  2815.      Using OZBEXT
  2816.      ============
  2817.  
  2818.      OZBEXT is a file transfer program for CompuServe users (it is
  2819.      available without charge from CIS).  This protocol offers much
  2820.      better network throughput than Xmodem.
  2821.  
  2822.      OZBEXT will transfer files using the "B" and "B+" protocols.
  2823.  
  2824.      The executable file to install is OZBEXT.EXE.
  2825.  
  2826.  
  2827.      {COMMO} Auto Receive
  2828.      ====================
  2829.  
  2830.      This feature will automatically start a macro when a specified
  2831.      string is received from the serial port and is normally used for
  2832.      starting downloads.
  2833.  
  2834.      Up to 8 strings and respective macro labels may be defined in the
  2835.      "Terminal and Modem" section of the Setup File.  These are
  2836.      preconfigured for the Zmodem, HS/Link and MPt protocol
  2837.      "signature" strings, but you may change them or add new ones as
  2838.      desired.
  2839.  
  2840.      As an example, suppose one of the Auto Receive strings in your
  2841.      Setup File is:
  2842.  
  2843.                {pzbr,^XB00}        Zmodem Auto Receive
  2844.  
  2845.      This means that when the string "^XB00" is received, the macro at
  2846.      label "pzbr" will be started.  This string is the Zmodem
  2847.      signature string.
  2848.  
  2849.      In your Macro File you would have the corresponding macro:
  2850.  
  2851.        Z BATCH  {:pzbr} {exec %dszprog port %_por rz -mr %dldir} {}
  2852.  
  2853.      {COMMO} will execute the macro as soon as the signature string is
  2854.      received (be patient, a BBS may take several seconds to load and
  2855.      execute its own protocol program).
  2856.  
  2857.      IMPORTANT!  If you have not properly installed the protocol
  2858.      program, the message "Bad command or file name" will be
  2859.      periodically displayed by DOS.  If this happens type Ctrl-X
  2860.      repeatedly until the sender cancels the transfer.
  2861.  
  2862.      TIPS on using Auto Receive:
  2863.  
  2864.      >    If the macro called by Auto Receive EXECutes a DOS command,
  2865.           you may want to use EXECute Preview Mode for preliminary
  2866.           testing.  This will allow you to view the command before
  2867.  
  2868.  
  2869.  
  2870.                    {COMMO} (tm)  User Guide and Reference           56
  2871.  
  2872.  
  2873.           execution and to see the results afterwards.  Preview Mode
  2874.           may be toggled on/off using the Alt-T key command.
  2875.  
  2876.      >    Auto Receive will not trigger on characters that are
  2877.           displayed to the screen while a macro is running.
  2878.  
  2879.      >    If you need to download within a macro, you should do a
  2880.           LOOKfor to wait for the signature string, then CALL the
  2881.           download macro (make sure you have a RETUrn at the end).
  2882.  
  2883.      >    Using short strings, such as "^E" for CIS B protocol may
  2884.           result in unexpected triggering of the macro.  This is
  2885.           because other systems may send the same string for a
  2886.           different purpose (to display a "club" symbol, for example). 
  2887.           Thus it may be necessary to disable a string at times or to
  2888.           discontinue its use.
  2889.  
  2890.      >    A string may be disabled by removing the corresponding macro
  2891.           label in the Macro File, but this degrades performance since
  2892.           the Macro File must be scanned each time a "hit" occurs. 
  2893.           Instead, the Setup File item should be removed.
  2894.  
  2895.      >    Auto Receive can be set up for protocols that do not send
  2896.           signature strings, such as Xmodem, Ymodem, Ymodem-G, etc. 
  2897.           Use the prompt that the BBS sends just prior to the file
  2898.           transfer.  For example, "Start your Ymodem-G now."  Note
  2899.           that different systems may use different prompts.
  2900.  
  2901.      >    An Auto Receive string can be used to automatically continue
  2902.           Multi Number Dialing after you disconnect (in manual mode). 
  2903.           Set one of the strings to:
  2904.  
  2905.                     {aut=nocar,^jNO CARRIER^m}
  2906.  
  2907.           Then enter a macro in the Macro File:
  2908.  
  2909.                     {:nocar} {dial ,} {}
  2910.  
  2911.           When your modem sends "NO CARRIER" the macro will start. 
  2912.           Multi Number Dialing will resume if any more systems are
  2913.           marked in the Dialing Directory.
  2914.  
  2915.      See also "TIPS on creating LOOKfor strings" in the Macro
  2916.      Programming Guide, under LOOKfor.
  2917.  
  2918.  
  2919.  
  2920.                    {COMMO} (tm)  User Guide and Reference           57
  2921.  
  2922.  
  2923.      ==========   =====================
  2924.      Appendix A   Setting Up Your Modem
  2925.      ==========   =====================
  2926.  
  2927.      Please be aware that there are many different modems in use and
  2928.      that it is of the utmost importance that you configure your modem
  2929.      to work correctly with {COMMO}.  A few tips will be given here,
  2930.      but they are no substitute for the detailed installation
  2931.      instructions in your modem manual!
  2932.  
  2933.      When {COMMO} is started, a command string called the Modem
  2934.      Initialization String will be sent to the modem.  You must make
  2935.      certain that you have the correct string in your Setup File. 
  2936.      This string will perform part or all of the modem setup depending
  2937.      on the type of modem.  Examples will be given for the most common
  2938.      types.
  2939.  
  2940.      If your modem is external to your computer, be sure you have
  2941.      followed the installation instructions carefully and that the
  2942.      cable is connected to the computer's serial port.  It is wise to
  2943.      turn off power to the computer and the modem when connecting or
  2944.      disconnecting any cables.
  2945.  
  2946.      Also check the Default Dialing Parameters in the Setup File. 
  2947.      Make sure the serial port number is correct.
  2948.  
  2949.           _______________
  2950.  
  2951.           1200 bps Modems
  2952.           _______________
  2953.  
  2954.      Most 1200 bps modems have switches on them which must be set to
  2955.      provide the proper interaction with your computer and with
  2956.      {COMMO}.  Consult your modem manual concerning these switches and
  2957.      pay particular attention to the following:
  2958.  
  2959.           1)   Enable command recognition.  Allows the modem to
  2960.                recognize commands (dial, set registers, etc.).  Must
  2961.                be in the "enable" position or modem will be unusable.
  2962.  
  2963.           2)   Send result codes in English.  This switch should be
  2964.                set so that the modem will send verbal responses to
  2965.                commands instead of numbers.  This is usually
  2966.                controlled by a command also (such as ATV1).
  2967.  
  2968.           3)   Respond to DTR (data terminal ready).  This should NOT
  2969.                be in the "ignore" or "on all the time" position.  This
  2970.                switch allows the computer to signal the modem to hang
  2971.                up.
  2972.  
  2973.  
  2974.  
  2975.                    {COMMO} (tm)  User Guide and Reference           58
  2976.  
  2977.  
  2978.           4)   Respond to carrier detect or "allow true carrier." 
  2979.                This should NOT be set to the "on all the time"
  2980.                position.
  2981.  
  2982.      Here is an example Modem Initialization String which will set up
  2983.      a 1200 bps modem and override the switch settings (if possible):
  2984.  
  2985.           {~AT S0=0 S7=60 E0 Q0 V1 X1 |}
  2986.  
  2987.      The most important command to check is the "X" command, since its
  2988.      function varies the most from modem to modem.  The "X" command
  2989.      determines which responses the modem will generate during dialing
  2990.      (e.g. CONNECT, BUSY, etc.).  It may also activate an additional
  2991.      modem feature such as automatic redialing which will interfere
  2992.      with {COMMO}'s own redialing procedure.
  2993.  
  2994.      Your modem manual gives a description for each level of the "X"
  2995.      command: X0, X1, X2, ... , etc.  Generally you want to use the
  2996.      highest level that does not activate undesirable features.  If
  2997.      you will be using {COMMO}'s AutoBaud feature you will need the
  2998.      extended connect responses such as CONNECT 1200.  Also the BUSY
  2999.      response should be provided if possible.  In any case you should
  3000.      modify the Modem Initialization String to work with your
  3001.      particular modem.
  3002.  
  3003.           ____________________________
  3004.  
  3005.           2400, 9600, 14400 bps Modems
  3006.           ____________________________
  3007.  
  3008.      Most of the information in the section above on 1200 bps modems
  3009.      applies to higher speed modems as well.  However, these modems
  3010.      usually have software command settings to replace the switches. 
  3011.      These commands may be given every time you start {COMMO} or they
  3012.      may be permanently remembered by modems which have "non-volatile"
  3013.      memory.
  3014.  
  3015.      It will be assumed here that the commands are given every time
  3016.      you start {COMMO}.  If you wish to place the settings in non-
  3017.      volatile memory, consult your modem manual on how to do this. 
  3018.      Here is an example Modem Initialization String for most higher
  3019.      speed modems:
  3020.  
  3021.           {~AT S0=0 S7=180 E0 Q0 V1 X4 &C1 &D2 |}
  3022.  
  3023.      See the comments above concerning the "X" command since they
  3024.      apply to these modems as well.
  3025.  
  3026.      IMPORTANT!  Many modems that operate at 2400 bps and above
  3027.      require additional commands to control features such as error
  3028.      correction and data compression.  Consult the modem manual for
  3029.      details.  Insert these commands into the above string.
  3030.  
  3031.  
  3032.  
  3033.                    {COMMO} (tm)  User Guide and Reference           59
  3034.  
  3035.  
  3036.  
  3037.      If you need to change the Modem Initialization String, edit the
  3038.      Setup File with the Alt-G key command, then restart the program
  3039.      to send the string to the modem.
  3040.  
  3041.  
  3042.      Answering a call from another computer
  3043.      ======================================
  3044.  
  3045.      The following information assumes that you are not using the
  3046.      MOSTHOST or other {COMMO} host mode macro.  If you use a host
  3047.      macro, follow the instructions for installing and operating the
  3048.      host.
  3049.  
  3050.      There are two easy ways to use {COMMO} to answer when a friend or
  3051.      associate calls you by computer.  For best results, make sure you
  3052.      are in Chat Mode.  Press Alt-- (Alt minus) to enter/exit Chat
  3053.      Mode.
  3054.  
  3055.      1)   While in Chat Mode or in the Terminal Screen, wait for the
  3056.           phone to ring, then type "ATA<cr>" (upper case is not
  3057.           necessary with many modems).  Your modem should answer
  3058.           immediately (go off hook) and begin handshaking with the
  3059.           remote modem.
  3060.  
  3061.           When you see the CONNECT message you are ready to
  3062.           communicate.  At this point you can type, send data with
  3063.           macro keys, send a text file with ASCII Upload or send any
  3064.           file with an external protocol.
  3065.  
  3066.           You can use a macro key to send the answer command to the
  3067.           modem.  For example, to send it by pressing Alt-W, place the
  3068.           following macro in your Macro File.  When the phone rings,
  3069.           press F5:
  3070.  
  3071.                {nf5} {send ATA|} {}     Answer the phone!
  3072.  
  3073.      2)   The other method involves setting your modem into Auto
  3074.           Answer Mode.  This method is useful in some situations, but
  3075.           will cause the modem to answer whenever the phone rings. 
  3076.           This can be undesirable if you get a voice call.
  3077.  
  3078.           To set Auto Answer just type "ATS0=1<cr>" (or make "S0=1"
  3079.           part of your Modem Initialization String).  This will tell
  3080.           the modem to answer on ring "1" (adjust to as many rings as
  3081.           desired).  To turn off Auto Answer type "ATS0=0<cr>".  These
  3082.           may also be sent with macro keys. 
  3083.  
  3084.  
  3085.  
  3086.                    {COMMO} (tm)  User Guide and Reference           60
  3087.  
  3088.  
  3089.      Connecting two computers (null modem cable)
  3090.      ===========================================
  3091.  
  3092.      {COMMO} may be used on a "direct connection" between two
  3093.      computers or between a computer and another serial device. 
  3094.      Connect the two serial ports with a "null modem" cable.  Then
  3095.      start the program on each computer, having selected the
  3096.      appropriate Default Dialing Parameters in the Setup File(s).
  3097.  
  3098.      The null modem cable should be designed so that the transmit line
  3099.      on each end connects to the receive line on the other end.  No
  3100.      other signals are needed, but none of the RS-232C signals should
  3101.      be left "floating."  They should be tied high or low (or at least
  3102.      grounded).
  3103.  
  3104.      You may have to disable the Usage Log in the Setup File by
  3105.      setting the path to null: {set _uselog}.  The log is triggered by
  3106.      changes in Carrier Detect and will slow things down if CD is
  3107.      unpredictable.
  3108.  
  3109.  
  3110.  
  3111.                    {COMMO} (tm)  User Guide and Reference           61
  3112.  
  3113.  
  3114.      ==========   =========================
  3115.      Appendix B   {COMMO} and Multi-Tasking
  3116.      ==========   =========================
  3117.  
  3118.           ________
  3119.  
  3120.           DESQview
  3121.           ________
  3122.  
  3123.      Special care has been taken to ensure that {COMMO} is compatible
  3124.      with Quarterdeck Office Systems' DESQview(tm), a multi-tasking
  3125.      supervisor.  DESQview allows more than one program to execute at
  3126.      the same time.
  3127.  
  3128.      A sample Program Information File (CO-PIF.DVP) has been included
  3129.      in the {COMMO} package for your convenience.  This file is
  3130.      installed as follows:
  3131.  
  3132.           1)   Copy the file to your DESQview directory (usually
  3133.                C:\DV).
  3134.           2)   Run "Add a Program" (AP) from the "Open Window" menu.
  3135.           3)   Select "Other."  Specify the DESQview directory as the
  3136.                "Path."
  3137.           4)   Mark the {COMMO} entry, press Enter.  "CO" should now
  3138.                appear on your "Open Window" menu.
  3139.  
  3140.      The CO-PIF.DVP file has been set up to define a 150k memory
  3141.      window.  The amount of memory actually required is affected by
  3142.      the size of your COMMO.FON file, your COMMO.MAC file and the size
  3143.      of your Scrollback buffer.
  3144.  
  3145.      Test the size of the window by running DSZ, HS/Link, LIST, etc.,
  3146.      from the Macro Processor or Shell to DOS.  Be sure to test the
  3147.      execution of external programs with a "wait" at the end (or use
  3148.      EXECute Preview Mode) so that you can see any error messages (see
  3149.      EXEC function).
  3150.  
  3151.      CO-PIF.DVP can be changed with the "Change a Program" (CP)
  3152.      command on the "Open Window" menu.  You may also want to change
  3153.      the directory information or other parameters.
  3154.  
  3155.      TIPS on using {COMMO} with DESQview:
  3156.  
  3157.      >    For best performance the foreground and background "tick
  3158.           counts" should both be 10 or less.
  3159.  
  3160.      >    If you switch to another task, do not attempt to access any
  3161.           files which may be in use in the {COMMO} window.  Examples
  3162.           are the Capture File, the Screen Image File and files that
  3163.           may be currently involved in a file transfer (upload or
  3164.           download).  The result may be a loss of part or all of the
  3165.           data in the file.  This is a general DESQview no-no.  You
  3166.  
  3167.  
  3168.  
  3169.                    {COMMO} (tm)  User Guide and Reference           62
  3170.  
  3171.  
  3172.           may freely access these files in the Shell to DOS or Macro
  3173.           Processor features of {COMMO} (within the same window).
  3174.  
  3175.      >    If the memory allocated to the window is too small, {COMMO}
  3176.           will not be able to load the Online Help file.  Since the
  3177.           Online Help file is loaded only when requested, you needn't
  3178.           be concerned if you don't intend to use it.
  3179.  
  3180.      >    The video display may seem less smooth in DESQview.  This is
  3181.           a result of {COMMO} using the fastest possible display
  3182.           method, and is quite normal.  This effect can be reduced by
  3183.           specifying fewer clock ticks for foreground and background
  3184.           (4 and 4 seems to work well). 
  3185.  
  3186.      >    The Snow Checking option should not be used when {COMMO} is
  3187.           run under DESQview.  If you see "snow" type interference in
  3188.           your CGA display, use DESQview's own snow checking (request
  3189.           "synchronized access" in the Setup program).
  3190.  
  3191.           ________
  3192.  
  3193.           OmniView
  3194.           ________
  3195.  
  3196.      Display bleed-through may be avoided by telling OmniView that
  3197.      {COMMO} "Supports TopView Functions" or by using the "/T" switch
  3198.      on the OmniView command line.
  3199.  
  3200.      See "TIPS on using {COMMO} with DESQview" in the previous
  3201.      section, most of which apply to OmniView as well.
  3202.  
  3203.           _________
  3204.  
  3205.           DoubleDOS
  3206.           _________
  3207.  
  3208.      Color displays require the "DISPLAY = TEXT" option in
  3209.      DDCONFIG.SYS.  Run {COMMO} in the bottom partition -- about 130k
  3210.      to 150k should suffice if you plan to use Online Help and/or
  3211.      external protocols.  Increase this size in proportion to the size
  3212.      of your Scrollback buffer.
  3213.  
  3214.      Some non-multi-tasker-aware, direct-screen-writing programs
  3215.      executed with the Macro Processor or Shell to DOS may not display
  3216.      properly.  If this happens you may have to run {COMMO} in the top
  3217.      partition.
  3218.  
  3219.      Use the supplied DBLDANSI.SYS driver in place of your ANSI.SYS
  3220.      for running other programs in this partition ({COMMO} doesn't use
  3221.      it).
  3222.  
  3223.  
  3224.  
  3225.                    {COMMO} (tm)  User Guide and Reference           63
  3226.  
  3227.  
  3228.      With this setup you may run any non-graphics program in the top
  3229.      partition, including direct screen writers.  
  3230.  
  3231.      Monochrome displays require the REFRESH option in DDCONFIG.SYS. 
  3232.      Refer to the DoubleDOS user's manual for information on this.
  3233.  
  3234.      See "TIPS on using {COMMO} with DESQview" in the previous
  3235.      section, most of which apply to DoubleDOS as well.
  3236.  
  3237.  
  3238.  
  3239.                    {COMMO} (tm)  User Guide and Reference           64
  3240.  
  3241.  
  3242.      ==========   ============
  3243.      Appendix C   Flow Control
  3244.      ==========   ============
  3245.  
  3246.      Flow Control is a signalling system used by communications
  3247.      devices to prevent data from being transmitted faster than it can
  3248.      be processed by the receiving system.  This is especially
  3249.      important when data is transferred at high speeds.
  3250.  
  3251.      Flow Control is initialized in the Setup File and is used by
  3252.      {COMMO} for both sending and receiving.  You may specify Software
  3253.      Flow Control, Hardware Flow Control or both.  Changes may be made
  3254.      at any time using the "[Alt-T]  Set Toggles" key command (or with
  3255.      the HFLOw and SFLOw macro functions) and will be effective
  3256.      immediately.
  3257.       
  3258.      Software Flow Control uses a control character called XOFF (or
  3259.      ^S) to signal the remote to pause.  XON (^Q) is the signal to
  3260.      "resume transmission."  This is normally used only for ASCII
  3261.      data, since these characters may appear randomly within binary
  3262.      data.  An XOFF pause will automatically be released in 20 seconds
  3263.      if no XON is received.  It will also be released if you type a
  3264.      character in the Terminal Screen.
  3265.  
  3266.      Hardware Flow Control uses the RTS/CTS lines in your RS-232C
  3267.      (serial port) cable to signal pause/resume without interfering
  3268.      with the data.  It should only be used when you are connected to
  3269.      a device which also recognizes RTS/CTS Flow Control (such as a
  3270.      high-speed modem or another computer connected with a null modem
  3271.      cable).  A CTS-off (send) pause will not be released
  3272.      automatically.  Turn off Hardware Flow Control (using Alt-T) if
  3273.      you need to override it.
  3274.  
  3275.      TIPS on using Flow Control:
  3276.  
  3277.      >    Your modem must be properly initialized to utilize flow
  3278.           control (consult the manual for details).
  3279.  
  3280.      >    Since Software Flow Control uses the XOFF (ASCII 19) and XON
  3281.           (ASCII 17) characters, these will not display on the screen. 
  3282.           If it is necessary to display them, Software Flow Control
  3283.           must be turned off.
  3284.  
  3285.      >    It is especially important to use Flow Control when the
  3286.           Print Log is on, since data is usually received faster than
  3287.           it can be printed.  If you type a character to the remote
  3288.           during a flow control pause, the remote may begin sending
  3289.           again (some systems resume on any character, not just XON). 
  3290.           You may have to turn off the Print Log if this happens.
  3291.  
  3292.  
  3293.  
  3294.                    {COMMO} (tm)  User Guide and Reference           65
  3295.  
  3296.  
  3297.      ==========   ==============================
  3298.      Appendix D   ASCII Character Representation
  3299.      ==========   ==============================
  3300.  
  3301.      Sometimes it is necessary to enter control characters and other
  3302.      special characters in the {COMMO} support files or as input to
  3303.      {COMMO} key commands.
  3304.  
  3305.      For example, a carriage return (typed with the Enter key) is used
  3306.      to terminate your typed input.  Therefore a carriage return must
  3307.      be represented by some other character (or characters) in order
  3308.      to be used as data.
  3309.  
  3310.      The process of converting represented characters to actual
  3311.      characters is done in many places in {COMMO}.  Some examples are:
  3312.  
  3313.           1)   Strings sent to the modem.  These include the Modem
  3314.                Initialization String, dialing prefixes and suffixes,
  3315.                telephone numbers, the Password String, strings defined
  3316.                in macro functions such as SEND, SETLook (prompt
  3317.                response), VTCUr and VTPAd.
  3318.  
  3319.           2)   Strings defined in other macro functions such as
  3320.                LOOKfor, GOLOok, EXECute and DISPlay.
  3321.  
  3322.      All control characters may be represented using the (^) caret
  3323.      symbol (it is the shift character above the top row "6").  If you
  3324.      need to send a caret, use two carets (^^).
  3325.  
  3326.      For convenience, two "normal" characters have special meanings in
  3327.      certain contexts:
  3328.  
  3329.           The vertical bar (|) may be used to represent a carriage
  3330.           return.  If you need a vertical bar, use (^|).  In the
  3331.           EXECute function the vertical bar is never converted (it is
  3332.           used by DOS as the "pipe" symbol).
  3333.  
  3334.           The tilde (~) forces a one-half second delay when it is
  3335.           encountered in a string that is being sent to the modem.  If
  3336.           you need a tilde, use (^~).  This is effective only in
  3337.           strings that are sent to the modem.  In other strings the
  3338.           tilde is used as a tilde.
  3339.  
  3340.      Finally, curly braces { } are very special characters and may not
  3341.      be used as data in the support files.  They are represented as
  3342.      follows, using parentheses:
  3343.  
  3344.           Left curly brace         ^(
  3345.           Right curly brace        ^)
  3346.  
  3347.      Here is a list of some of the most common control characters and
  3348.      how to represent them.  Upper or lower case may be used.
  3349.  
  3350.  
  3351.  
  3352.                    {COMMO} (tm)  User Guide and Reference           66
  3353.  
  3354.  
  3355.  
  3356.           Carriage return          ^M or |
  3357.           Linefeed                 ^J
  3358.           Formfeed                 ^L
  3359.           Escape                   ^[
  3360.           Bell                     ^G
  3361.           XOFF                     ^S
  3362.           XON                      ^Q
  3363.           End of file              ^Z
  3364.  
  3365.      Here is a table of all ASCII control characters.  Values are
  3366.      decimal:
  3367.  
  3368.           0  ... ^@      7  ... ^G      14 ... ^N      21 ... ^U
  3369.           1  ... ^A      8  ... ^H      15 ... ^O      22 ... ^V
  3370.           2  ... ^B      9  ... ^I      16 ... ^P      23 ... ^W
  3371.           3  ... ^C      10 ... ^J      17 ... ^Q      24 ... ^X
  3372.           4  ... ^D      11 ... ^K      18 ... ^R      25 ... ^Y
  3373.           5  ... ^E      12 ... ^L      19 ... ^S      26 ... ^Z
  3374.           6  ... ^F      13 ... ^M      20 ... ^T      27 ... ^[
  3375.  
  3376.      ASCII 28 to 31 and those in the extended graphic character set
  3377.      (128 to 255), may be typed using the ALT-NUMERIC-KEYPAD method as
  3378.      follows:
  3379.  
  3380.           1.   Hold down the Alt key (and keep it down).
  3381.           2.   Enter the ASCII code in decimal using the numeric
  3382.                keypad keys (1, 2 or 3 digits are ok).
  3383.           3.   Release the Alt key.
  3384.  
  3385.  
  3386.  
  3387.                    {COMMO} (tm)  User Guide and Reference           67
  3388.  
  3389.  
  3390.      ==========   ==================
  3391.      Appendix E   Terminal Emulation
  3392.      ==========   ==================
  3393.  
  3394.      Terminal Emulation Type is indicated on the Status Line (in the
  3395.      Terminal Parameters string).  Available types are:
  3396.  
  3397.           A    ANSI-BBS  Used on bulletin boards and other systems.
  3398.           V    VT102     Used on minicomputers and mainframes.
  3399.           T    TTY       Supports only the basic control characters.
  3400.           H    TTY(40)   HP 95LX version only.  Wraps at 40 columns.
  3401.  
  3402.      The Terminal Emulation Type (as defined by the Default Dialing
  3403.      Parameter string) will be set whenever a system is dialed.  It
  3404.      may be changed temporarily using the Alt-P key command or the
  3405.      PARMs macro function.  The Default Dialing Parameters may be
  3406.      changed using the Alt-P key command or the DPARms macro function.
  3407.  
  3408.      TIPS on using terminal emulation:
  3409.  
  3410.      >    Whenever a change is made, a reset of mode parameters will
  3411.           be performed.  It is therefore important that the change be
  3412.           made BEFORE (or at the time of) connecting with a host (mode
  3413.           settings may be transmitted by the host).
  3414.  
  3415.      >    If some screens do not look right when VT102 emulation is
  3416.           used, you may need to turn LINEWRAP off (it defaults to on).
  3417.  
  3418.      >    Linewrap may be turned on/off locally using the DISPlay
  3419.           macro function.  Place one of the following in your login
  3420.           macro (or assign one of them to a key and execute it
  3421.           manually):
  3422.  
  3423.                     {display ,,,^[[?7h}      linewrap ON
  3424.                     {display ,,,^[[?7l}      linewrap OFF
  3425.  
  3426.      >    If colors do not always look right, it may be necessary to
  3427.           set the Terminal Screen colors in the Setup File to {07}. 
  3428.           See the note under "Colors" in the section "[Alt-G]  Setup
  3429.           File."
  3430.  
  3431.      >    Using the "H" emulation type with the HP 95LX version will
  3432.           cause terminal lines to wrap at 40 columns.  This is useful
  3433.           when calling systems that do not support 40 column screens. 
  3434.           Note that the basic emulation in this mode is TTY and that
  3435.           {COMMO} will not perform word wrapping (i.e., words may be
  3436.           split).
  3437.  
  3438.  
  3439.  
  3440.                    {COMMO} (tm)  User Guide and Reference           68
  3441.  
  3442.  
  3443.      Printer Support
  3444.      ===============
  3445.  
  3446.      {COMMO} supports the ANSI/VT102 printer functions, controlled by
  3447.      the remote system.
  3448.  
  3449.           The "Printer ON/OFF" function will turn {COMMO}'s Print Log
  3450.           ON/OFF.
  3451.  
  3452.           The "Dedicated Printing" function will send all input from
  3453.           the serial port directly to the printer.  This allows for
  3454.           "transparent" transmission of printer data, including
  3455.           control codes.
  3456.  
  3457.           The "Print Screen" function will print the entire current
  3458.           screen.
  3459.  
  3460.      The printer should be on and ready to print when these functions
  3461.      are used.  When "Dedicated Printing" is active no characters will
  3462.      be displayed on the screen.
  3463.  
  3464.  
  3465.      ANSI-BBS Keyboard Support
  3466.      =========================
  3467.  
  3468.      The sample Macro File is set up so you can use the PC keypad keys
  3469.      (arrow keys, PgUp, PgDn, etc.) with most BBS full-screen editors.
  3470.  
  3471.  
  3472.      VT102 Keyboard Simulation
  3473.      =========================
  3474.  
  3475.      Two keyboard files, VT102-1.MAC and VT102-2.MAC, provide support
  3476.      to simulate the VT102 keyboard.  You may merge one of these into
  3477.      COMMO.MAC if you intend to use VT102 all the time (replace the
  3478.      ANSI-BBS keys).  Be sure that you have no conflicting key-labels
  3479.      (remember that {COMMO} will use the first occurrence of a key-
  3480.      label).
  3481.  
  3482.      Or you can use the MACLoad function in your login macro to load
  3483.      the VT102 file automatically when you connect to the host.  Use
  3484.      the "R" switch to reload COMMO.MAC at disconnect.  For example:
  3485.  
  3486.           {macload-r vt102-1.mac}
  3487.  
  3488.      Both files support the following PC keypad functions (^ indicates
  3489.      the Ctrl key):
  3490.  
  3491.                Four cursor (arrow) keys
  3492.                Home   - Home cursor
  3493.                ^Home  - Insert line
  3494.                PgUp   - Page up
  3495.  
  3496.  
  3497.  
  3498.                    {COMMO} (tm)  User Guide and Reference           69
  3499.  
  3500.  
  3501.                ^PgUp  - Delete line
  3502.                PgDn   - Page down
  3503.                ^PgDn  - Clear screen
  3504.                End    - End of line
  3505.                Ins    - Insert mode
  3506.                Del    - Delete
  3507.                ^bs   -  Ctrl backspace (delete)
  3508.  
  3509.      VT102 numeric keypad keys are auto-switched by the host system
  3510.      between numeric mode and application mode.
  3511.  
  3512.      The four cursor keys are auto-switched between cursor mode and
  3513.      application mode.
  3514.  
  3515.      These files may be modified to create any keyboard support you
  3516.      desire (see description of VTCUr and VTPAd functions in the
  3517.      section "{COMMO} Macro Functions."
  3518.  
  3519.           ___________
  3520.  
  3521.           VT102-1.MAC
  3522.           ___________
  3523.  
  3524.      This file contains keyboard assignments that work best with the
  3525.      enhanced keyboard (because of the separate cursor keys, etc.).
  3526.  
  3527.      With Numlock ON the ten digits and period will simulate their
  3528.      equivalent VT102 functions.  In addition:
  3529.  
  3530.                F1 to F4 simulate PF1 to PF4
  3531.                Grey * is used for comma
  3532.                Grey - is used for dash
  3533.                Grey + is used for Enter
  3534.  
  3535.           ___________
  3536.  
  3537.           VT102-2.MAC
  3538.           ___________
  3539.  
  3540.      This file contains keyboard assignments that work best with the
  3541.      83-key keyboard (because of the location of the function keys on
  3542.      the left side).
  3543.  
  3544.      The following diagram shows how the ten function keys (Fn) and
  3545.      ten shifted function keys (SFn) relate to the VT102 keypad keys:
  3546.  
  3547.  
  3548.  
  3549.                    {COMMO} (tm)  User Guide and Reference           70
  3550.  
  3551.  
  3552.           F1=  PF1    F2=  PF2    SF1=  PF3    SF2=  PF4
  3553.  
  3554.           F3=   7     F4=   8     SF3=   9     SF4=   -
  3555.  
  3556.           F5=   4     F6=   5     SF5=   6     SF6=   ,
  3557.       
  3558.           F7=   1     F8=   2     SF7=   3     SF8=   Enter
  3559.  
  3560.           F9=   0     F10=  0     SF9=   .     SF10=  Enter
  3561.  
  3562.  
  3563.  
  3564.                    {COMMO} (tm)  User Guide and Reference           71
  3565.  
  3566.  
  3567.      ==========   ================
  3568.      Appendix F   Usage Log Format
  3569.      ==========   ================
  3570.  
  3571.      The {On} and {Off} entries are self-explanatory.
  3572.  
  3573.      Here is an example of a file transfer entry:
  3574.  
  3575.        {SX} 0  c:\ul\nlbbs.rep  1664  CRC 1024  0 errors 
  3576.  
  3577.           {SX}                Send {SX} or receive {RX} with Xmodem.
  3578.           0                   Transfer successful (0) or failed (1).
  3579.           c:\ul\nlbbs.rep     Pathname of file.
  3580.           1664                Bytes transferred.
  3581.           CRC 1024            Transfer method.
  3582.           0 errors            Total number of errors (corrected if
  3583.                               transfer was successful).
  3584.  
  3585.  
  3586.  
  3587.                    {COMMO} (tm)  User Guide and Reference           72
  3588.  
  3589.  
  3590.      ==========   ==========================
  3591.      Appendix G   Error Message Explanations
  3592.      ==========   ==========================
  3593.  
  3594.      If you get an error message that you don't understand, check
  3595.      below for additional information.
  3596.  
  3597.      ________________________________
  3598.  
  3599.      Sorry, out of memory
  3600.      Not enough memory for Scrollback
  3601.      ________________________________
  3602.  
  3603.           These messages may occur at program startup.  Check the
  3604.           following:
  3605.  
  3606.           1)   {COMMO} cannot allocate its internal buffers.  You must
  3607.                make more memory available.
  3608.  
  3609.           2)   {COMMO} cannot load the Dialing Directory and/or Macro
  3610.                File.  Try reducing the size of either of these files. 
  3611.                Removing comments may help.  Or make more memory
  3612.                available.
  3613.  
  3614.           3)   {COMMO} cannot allocate the Scrollback Buffer.  Reduce
  3615.                its size or make more memory available.
  3616.  
  3617.      _______________________________
  3618.  
  3619.      Cannot locate command processor
  3620.      _______________________________
  3621.  
  3622.           This is an unusual condition.  Type "SET" at the DOS prompt
  3623.           and be sure there is a "COMSPEC=" in the list.  If there is,
  3624.           make sure that COMMAND.COM is in the path specified.
  3625.  
  3626.      _______________________
  3627.  
  3628.      Not enough memory
  3629.      Program file not found
  3630.      Unable to execute shell
  3631.      _______________________
  3632.  
  3633.           A problem was encountered during Shell to DOS or EXEC:
  3634.  
  3635.           1)   There may not be enough memory to execute the command
  3636.                processor or external program you have specified.
  3637.  
  3638.           2)   The program file you specified in an EXECute function
  3639.                using the "D" switch cannot be located.  Make sure you
  3640.                specify the full path and filename.
  3641.  
  3642.  
  3643.  
  3644.                    {COMMO} (tm)  User Guide and Reference           73
  3645.  
  3646.  
  3647.           3)   Some other system error condition may exist.  Make sure
  3648.                that COMMAND.COM is still available in the "COMSPEC="
  3649.                path.
  3650.  
  3651.      ___________________________
  3652.  
  3653.      Hardware flow control pause
  3654.      ___________________________
  3655.  
  3656.           Hardware Flow Control is in effect and the remote system (or
  3657.           your modem) has requested a pause.  Try waiting a few
  3658.           seconds for the pause to clear; if that fails you may have
  3659.           to turn off Hardware Flow Control (use Alt-T, Set Toggles).
  3660.  
  3661.      _________________________________________
  3662.  
  3663.      File space full!  Delete unnecessary text
  3664.      _________________________________________
  3665.  
  3666.           {COMMO} allows about 65,000 bytes when editing any file (the
  3667.           Dialing Directory and Macro File occupy a common file
  3668.           space).  This limit may be reached when editing any of the
  3669.           files with the Internal Editor.  If this happens you must
  3670.           reduce the size of the file in question.  Try removing
  3671.           comment lines and any other extraneous information.
  3672.  
  3673.           This message may also be the result of loading a resident
  3674.           program (TSR) in the Shell to DOS or via the EXEC macro
  3675.           function.  Other causes involve a corruption of DOS
  3676.           parameters and require rebooting.
  3677.  
  3678.      _____________________
  3679.  
  3680.      Dial command too long
  3681.      _____________________
  3682.  
  3683.           The dial command is limited to 128 characters.
  3684.  
  3685.      ________________________
  3686.  
  3687.      Unable to open file
  3688.      Unable to open Help File
  3689.      File not found
  3690.      Path not found
  3691.      Too many files
  3692.      ________________________
  3693.  
  3694.           Check the following:
  3695.  
  3696.           1)   Your "SET COMMO=" command in your AUTOEXEC.BAT file. 
  3697.                It may be specifying the wrong directory.
  3698.           2)   That the path exists where the file should be.
  3699.  
  3700.  
  3701.  
  3702.                    {COMMO} (tm)  User Guide and Reference           74
  3703.  
  3704.  
  3705.           3)   That the file itself exists (this won't be the problem
  3706.                if the file is being created).
  3707.           4)   Too many files may be open.  You may need to increase
  3708.                your FILES= parameter in CONFIG.SYS.
  3709.           5)   The Online Help File must be less than 64K bytes in
  3710.                size.
  3711.           6)   You cannot use an open Capture File for any other
  3712.                purpose.
  3713.  
  3714.      ____________________________________
  3715.  
  3716.      Capture File Closed, disk is full!
  3717.      Information not saved, disk is full!
  3718.      ____________________________________
  3719.  
  3720.           The Capture File and Screen Image File should be edited
  3721.           regularly to ensure that they are not occupying too much
  3722.           disk space.
  3723.  
  3724.  
  3725.                               - end -
  3726.  
  3727.