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