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