home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 24 DOS / 24-DOS.zip / commo60.zip / ADDENDUM.DOC next >
Text File  |  1994-04-09  |  35KB  |  940 lines
  1.  
  2.  
  3.  
  4.                               {COMMO} 6.0 Addendum
  5.                               ____________________
  6.  
  7.      This Addendum contains the major additions and/or changes to the
  8.      {COMMO} 5.52 documentation.  Print out this file and keep it with your
  9.      printed manual.  There is a complete list of changes (major and minor)
  10.      in the file HISTORY.
  11.  
  12.  
  13.      ===============================
  14.      In the User Guide and Reference
  15.      ===============================
  16.  
  17.      Under "Alt-D  Dialing Directory"
  18.      --------------------------------
  19.  
  20.      ----------  5. Linked Macro:  {fcbbs}
  21.  
  22.  
  23.           The general form for this item is:
  24.  
  25.                {label,filename}
  26.  
  27.                     label
  28.                          A macro label where execution is to start
  29.                          (optional).  The label may be located in the
  30.                          resident Macro File or in the current auxiliary
  31.                          file.
  32.  
  33.                     filename
  34.                          The filename of a Macro File (optional).  If the
  35.                          file is not already in memory (resident or
  36.                          auxiliary), it will be loaded as the auxiliary
  37.                          prior to searching for the label.
  38.  
  39.           Examples:
  40.  
  41.                {fcbbs}
  42.                     Start at the label "fcbbs".
  43.  
  44.                {mailrun,fcbbs.mac}
  45.                     Start at the label "mailrun" after loading the
  46.                     auxiliary Macro File "fcbbs.mac".
  47.  
  48.                {,fcbbs.mac}
  49.                     Load the auxiliary Macro File "fcbbs.mac" and enter
  50.                     manual mode.
  51.  
  52.           If a valid label is specified, the Linked Macro will be started
  53.           when a connection is established with the remote system.  If no
  54.           macro is specified (or the macro label is not found), {COMMO}
  55.           will enter the Terminal Screen in manual mode.
  56.  
  57.  
  58.  
  59.           Additional options are available when using the DIAL macro
  60.           function.  See Part II for details.
  61.  
  62.  
  63.      Under "Alt-G  Edit Setup File"
  64.      ------------------------------
  65.  
  66.      ___________________________________________________
  67.  
  68.      {ncr=nocar}   Macro to execute when carrier is lost
  69.      ___________________________________________________
  70.  
  71.           {COMMO} will execute the macro specified here when the Carrier
  72.           Detect signal is lost.  This signal normally comes on when your
  73.           modem connects with a host system, and goes off when the call is
  74.           terminated.
  75.  
  76.           If a command window is on screen, the macro will activate when
  77.           the window is exited.  If a macro is running when carrier is
  78.           lost, the macro will be STOPped and {COMMO} will GOTO the label
  79.           specified.
  80.  
  81.           {COMMO} will search for the label first in the auxiliary Macro
  82.           File, then in the resident file.  If the label is not found,
  83.           {COMMO} will continue as usual.
  84.  
  85.           TIPS on using the carrier lost macro:
  86.  
  87.           >    IMPORTANT!  This feature is enabled only when a connection
  88.                is made using {COMMO}'s Auto Dialer.
  89.  
  90.           >    The macro will not activate if carrier is lost while in the
  91.                Swap to Disk (serial port is closed).
  92.  
  93.           >    The macro label can be changed or cancelled using the
  94.                NOCArrier macro function.  See Part II for details.
  95.  
  96.           >    Be sure that you have your modem configured to provide the
  97.                carrier detect signal.  See Appendix A for modem
  98.                information.
  99.  
  100.      ______________________________________________
  101.  
  102.      {dcn=c}   Method to cancel dialing (c/d/s,...)
  103.      ______________________________________________
  104.  
  105.           This item defines the method that {COMMO} will use to cancel a
  106.           dialing attempt in progress.  Dialing is cancelled when you press
  107.           Esc or when {COMMO} times out.  Options are:
  108.  
  109.                c    Send a carriage return
  110.                d    Drop DTR
  111.                s    Send a user-defined string
  112.  
  113.  
  114.  
  115.           The "s" option lets you define your own string.  The string can
  116.           be up to 8 characters in length, including any carets or tildes
  117.           (see Appendix D).  Here's an example that sends a Ctrl-X,
  118.           followed by a half-second delay and a carriage return:
  119.  
  120.                {dcn=s,^x~|}       Fictitious example
  121.  
  122.      _________________________________________________________
  123.  
  124.      {set protodir,c:\commo}   Path to find external protocols
  125.      _________________________________________________________
  126.  
  127.           This is the path where you keep your external protocol programs. 
  128.           Copy the executable programs, such as DSZ.COM and HSLINK.EXE,
  129.           into this directory and {COMMO} will know where to find them.  Do
  130.           not use a "\" at the end of the path.
  131.  
  132.      __________________________________________________
  133.  
  134.      {dmk=8300}
  135.          Scan code for Doorway Mode key (see COMMO.DOC)
  136.      __________________________________________________
  137.  
  138.           This item defines the key used to enter and exit Doorway Mode. 
  139.           The default key is Alt-=.  The scan code (such as "8300") is
  140.           obtained by pressing Alt-K in {COMMO}'s Internal Editor, then
  141.           pressing the key you wish to use.
  142.  
  143.           Note that a corresponding macro must exist in the Macro File. 
  144.           The macro (provided in COMMO.MAC) to use with Alt-= is:
  145.  
  146.                {:al=} {doorway} {}
  147.  
  148.           If you change the key definition in COMMO.SET, be sure to change
  149.           the key-label in COMMO.MAC.
  150.  
  151.      _____________________________________
  152.  
  153.      {mky=}   User-defined macro key-label
  154.      _____________________________________
  155.  
  156.           (Note that this feature is unavailable during shareware
  157.           evaluation.)
  158.  
  159.           This item allows you to assign a macro key-label to almost any
  160.           key or key combination on your keyboard.  Up to 32 "mky" items
  161.           may be used (any more will be ignored).  Here are some examples:
  162.  
  163.                {mky=cta,1e01}     Ctrl-A
  164.                {mky=bsh,2b5c}     Backslash
  165.  
  166.           Any valid, three character label may be used as a user-defined
  167.           key-label (such as "cta" in the example).  The scan code (such as
  168.  
  169.  
  170.  
  171.           "1e01") is obtained by pressing Alt-K in {COMMO}'s Internal
  172.           Editor, then pressing the key you wish to use.
  173.  
  174.           For additional information and certain restrictions, see Appendix
  175.           H "{COMMO} Macro Key-labels."
  176.  
  177.      ______________________________________________
  178.  
  179.      {avm=}   Alternate video mode (mode,rows,cols)
  180.      ______________________________________________
  181.  
  182.           You can toggle between two video modes (text modes only) if this
  183.           item is defined.  One important application for this is the 132
  184.           column feature in VT102 emulation.  It can also be used to toggle
  185.           between any two different video modes using the VIDEo macro
  186.           function.
  187.  
  188.           The "normal" video mode is the mode that is in effect when
  189.           {COMMO} is started.  That mode will always be restored
  190.           automatically when you exit the program.  If you Shell to DOS or
  191.           use the EXECute macro function, the current mode will remain in
  192.           effect.
  193.  
  194.           The mode field must be expressed as a hexadecimal number, while
  195.           the rows and columns are decimal numbers (minimum dimensions are
  196.           25x80).  As an example, suppose that your video adapter uses mode
  197.           23h (hexadecimal) to support a 25x132 screen.  Then you would
  198.           write this item as:
  199.  
  200.                {avm=23,25,132}     Alternate video mode
  201.  
  202.           Set mode "3" to use the standard 50 line mode supported by VGA
  203.           adapters or the standard 43 line mode supported by EGA adapters. 
  204.           For example:
  205.  
  206.                {avm=3,50,80}     Alternate video mode
  207.  
  208.           The following macro will restore the "normal" mode when Shelling
  209.           to DOS and bring back the alternate mode upon return (press Alt-S
  210.           to activate):
  211.  
  212.                {:als} {video-m0} {shell} {video-m1} {}
  213.  
  214.           Note that some screen "modes" are not hardware modes and cannot
  215.           be toggled using this feature.  Consult your video adapter manual
  216.           for a list of hardware modes supported (or contact the
  217.           manufacturer).
  218.  
  219.  
  220.  
  221.      ________________________________________________
  222.  
  223.      {set sel_up,no}
  224.          Go directly to picklist for uploads (yes/no)
  225.      ________________________________________________
  226.  
  227.           Set this item to "yes" and {COMMO} will skip the input prompt for
  228.           a filename.  Instead you will see the file picklist immediately.
  229.  
  230.  
  231.      Under "[Alt-=]  Doorway Mode Toggle"
  232.      ------------------------------------
  233.  
  234.      Definition: "Extended" keys are function keys, Alt keys, cursor keys,
  235.      etc.  In other words, keys that do not generate ASCII characters.
  236.  
  237.      In Doorway Mode all extended keys will send their key codes to the
  238.      remote (instead of activating {COMMO} functions).  Thus Doorway Mode
  239.      can be used to operate most application software on the remote system
  240.      when used with a host program such as Marshall Dudley's DOORWAY.  In
  241.      addition, some BBS full-screen editors use Doorway Mode.
  242.  
  243.      TIPS on using Doorway Mode:
  244.  
  245.      >    The Alt-= key is the default, but the "dmk" item in the Setup
  246.           File may be used to define any key.   The defined key is
  247.           necessarily reserved for exiting Doorway Mode and thus cannot be
  248.           sent to the remote.  Be sure to configure remote applications
  249.           accordingly.
  250.  
  251.      >    A macro must be present in the Macro File to toggle Doorway Mode. 
  252.           The supplied macro is:
  253.  
  254.                {:al=} {doorway} {}           Toggle Doorway Mode
  255.  
  256.           If you redefine the key with "dmk", don't forget to change the
  257.           key-label on the macro.
  258.  
  259.      >    When used with DOORWAY 2.22 or later, the Doorway Mode macro will
  260.           execute automatically when the DOORWAY program (on the host
  261.           system) starts up and when it exits back to DOS -- no keypress is
  262.           necessary.
  263.  
  264.           (Note that this feature is unavailable during shareware
  265.           evaluation.)
  266.  
  267.      >    The display should be set to the number of lines expected by the
  268.           host program.  Usually this is 25 lines of text.  If your display
  269.           is not in the proper mode, the results will be unpredictable.
  270.  
  271.      >    The Status Line is normally suppressed in Doorway Mode, but may
  272.           be turned on by using the "S" switch in the Doorway macro:
  273.  
  274.                {:al=} {doorway-s} {}
  275.  
  276.  
  277.  
  278.  
  279.           The "s" switch is ignored when exiting Doorway Mode and the
  280.           Status Line will be restored to its previous state.  Remember
  281.           that when the Status Line is on, there is one less usable line on
  282.           the Terminal Screen.
  283.  
  284.      >    If it is necessary to clear the screen or to reset the terminal
  285.           emulation mode parameters when starting Doorway Mode, modify the
  286.           Doorway macro.  For example:
  287.  
  288.                {:al=} {clear} {parms ,,,a} {doorway} {}
  289.  
  290.           This macro will execute when entering or exiting Doorway Mode.
  291.  
  292.      >    For most applications you will want Terminal-type set to
  293.           ANSI-BBS.  It's a good idea to enter Doorway Mode before starting
  294.           the host program.  The host may send commands to initialize the
  295.           terminal.
  296.  
  297.      >    If Software Flow Control is enabled, the ASCII character values
  298.           17 and 19 (XON and XOFF) will not display.  If these characters
  299.           are needed, Software Flow Control should be turned off.
  300.  
  301.  
  302.  
  303.      ==============================
  304.      In the Macro Programming Guide
  305.      ==============================
  306.  
  307.      ------------------------------------
  308.      New or Changed Function Descriptions
  309.      ------------------------------------
  310.  
  311.  
  312.      ===  CALL  ===
  313.  
  314.  
  315.      Default key:   none
  316.      Description:   Execute a macro subroutine.
  317.  
  318.      General form:
  319.  
  320.           {CALL label,filename}
  321.  
  322.                label
  323.                     The label that begins the subroutine to be executed.
  324.  
  325.                filename
  326.                     The name of the Macro File where the label is to be
  327.                     found.  This argument is OPTIONAL and is normally used
  328.                     only if the file is not already loaded.  Do NOT specify
  329.                     a path; the {COMMO} home directory will be used.
  330.  
  331.      Switches:
  332.  
  333.                F1 or F
  334.                     Force loading of the specified file (as the auxiliary
  335.                     file).  No filename comparison will be made.
  336.  
  337.                F0
  338.                     Compare filenames.  If the file is already loaded
  339.                     (resident or auxiliary), it will not be reloaded
  340.                     (default).
  341.  
  342.      Examples:
  343.  
  344.           {call abc}
  345.                Execute subroutine "abc".
  346.  
  347.           {call abc,other.mac}
  348.                Execute subroutine "abc" in the auxiliary Macro File
  349.                "other.mac".
  350.  
  351.      CALL will push the return location onto the macro stack; then it will
  352.      transfer control to the given label.  When a RETUrn is executed, the
  353.      location will be popped and control will return to the function
  354.      following the CALL.  If the CALL is located in the auxiliary Macro
  355.      File, the filename will be saved on the macro stack along with the
  356.      return location.
  357.  
  358.  
  359.  
  360.  
  361.      If a filename is specified, {COMMO} will check to see if the file is
  362.      already loaded (resident or auxiliary).  If not, the file will be
  363.      loaded as the auxiliary (the current auxiliary will be saved to disk
  364.      if there are any outstanding changes).
  365.  
  366.      TIPS on using CALL:
  367.  
  368.      >    It isn't necessary to specify a filename if the target label is
  369.           in the resident Macro File or in the current auxiliary file.
  370.  
  371.      >    A macro error will result if either the label or the file do not
  372.           exist.
  373.  
  374.      >    CALLs may be nested up to 32 deep.
  375.  
  376.      >    Use GOTO when you want to load or execute macros in another file
  377.           and you do not need to return.  This will prevent the macro stack
  378.           from filling with "dead" entries.
  379.  
  380.      >    Do not modify a Macro File while a CALL from that file is active
  381.           (the return location may be invalidated).
  382.  
  383.      See also RETUrn, GOTO, PUSHstack, POPStack, UNLOad, Appendix K.
  384.  
  385.  
  386.      ===  GOTO  ===
  387.  
  388.  
  389.      Default key:   none
  390.      Description:   Transfer control of macro execution.
  391.  
  392.      General form:
  393.  
  394.           {GOTO label,filename}
  395.  
  396.                label
  397.                     The label to which control will be transferred.
  398.  
  399.                filename
  400.                     The name of the Macro File where the label is to be
  401.                     found.  This argument is OPTIONAL and is normally used
  402.                     only if the file is not already loaded.  Do NOT specify
  403.                     a path; the {COMMO} home directory will be used.
  404.  
  405.  
  406.  
  407.      Switches:
  408.  
  409.                F1 or F
  410.                     Force loading of the specified file (as the auxiliary
  411.                     file).  No filename comparison will be made.
  412.  
  413.                F0
  414.                     Compare filenames.  If the file is already loaded
  415.                     (resident or auxiliary), it will not be reloaded
  416.                     (default).
  417.  
  418.      Examples:
  419.  
  420.           {goto mail_run}
  421.                Control transferred to label "mail_run".
  422.  
  423.           {goto mail_run,ginger.mac}
  424.                Control transferred to label "mail_run" in the auxiliary
  425.                Macro File "ginger.mac".
  426.  
  427.           {goto ,ginger.mac}
  428.                The auxiliary Macro File "ginger.mac" is loaded; macro
  429.                execution STOPs (no label given).
  430.  
  431.      If a filename is specified, {COMMO} will check to see if the file is
  432.      already loaded (resident or auxiliary).  If not, the file will be
  433.      loaded as the auxiliary (the current auxiliary will be saved to disk
  434.      if there are any outstanding changes).
  435.  
  436.      TIPS on using GOTO:
  437.  
  438.      >    It isn't necessary to specify a filename if the target label is
  439.           in the resident Macro File or in the current auxiliary file.
  440.  
  441.      >    A macro error will result if either the label or the file do not
  442.           exist.
  443.  
  444.      See also CALL, UNLOad, Appendix K.
  445.  
  446.  
  447.      ===  RETUrn  ===
  448.  
  449.  
  450.      Default key:   none
  451.      Description:   Return from a CALLed macro.
  452.  
  453.      Example:
  454.  
  455.           {return}
  456.                No arguments.
  457.  
  458.      This function will return control to the last location pushed onto the
  459.      macro stack (by CALL, PUSHstack, etc.).  The location may reside in a
  460.  
  461.  
  462.  
  463.      Macro File that is not currently loaded (loading will occur
  464.      automatically).
  465.  
  466.      TIPS on using RETUrn:
  467.  
  468.      >    If a RETUrn is encountered and no elements remain on the macro
  469.           stack, a STOP will occur.  This is useful in macros that are
  470.           CALLed and also used standalone (such as protocol file transfer
  471.           macros).
  472.  
  473.      >    If the macro filename popped from the macro stack is the same as
  474.           the current auxiliary file, no load will occur.
  475.  
  476.      See also CALL, CALOok, DIAL, PUSHstack, POPStack.
  477.  
  478.  
  479.      ===  FONFile  ===
  480.  
  481.  
  482.      Default key:   none
  483.      Description:   Load a new Dialing Directory file.
  484.  
  485.      Example:
  486.  
  487.           {fonf local.fon}
  488.                The Dialing Directory is replaced with the file LOCAL.FON.
  489.  
  490.      (Note that this feature is unavailable during shareware evaluation.)
  491.  
  492.      The current Dialing Directory file will be saved to disk if there are
  493.      any outstanding changes.  Dialing marks in the new file will be erased
  494.      if {cdm=yes} in the Setup File.
  495.  
  496.  
  497.      ===  SFICtrl  ===
  498.  
  499.  
  500.      Default key:   none
  501.      Description:   Speech Friendly Interface control.
  502.  
  503.      Examples:
  504.  
  505.           {sfic}
  506.                Toggle Speech Friendly Interface on/off.
  507.  
  508.           {sfic y}
  509.                Turn on Speech Friendly Interface.
  510.  
  511.           {sfic n}
  512.                Turn off Speech Friendly Interface.
  513.  
  514.  
  515.  
  516.      =================
  517.      In the Appendices
  518.      =================
  519.  
  520.  
  521.      ==========  Appendix E   Terminal Emulation
  522.  
  523.  
  524.      Terminal Emulation Type is indicated on the Status Line (in the
  525.      Terminal Parameters string).  Available types are:
  526.  
  527.           A    ANSI-BBS
  528.                     Used on bulletin boards and other systems.
  529.  
  530.           V    VT102 (VT100 compatible)
  531.                     Used on minicomputers and mainframes.
  532.  
  533.           T    TTY
  534.                     Supports only the basic control characters.
  535.  
  536.      The Terminal Emulation Type (as defined by the Default Dialing
  537.      Parameters string) will be set whenever a system is dialed.  It may be
  538.      overridden for the current call by using the Parms field in the
  539.      Dialing Directory entry.  It may also be changed temporarily using the
  540.      Alt-P key command or the PARMs macro function.  The Default Dialing
  541.      Parameters may be changed using the Alt-P key command or the DPARms
  542.      macro function.
  543.  
  544.      IMPORTANT!  The Terminal Emulation Type affects only received data (as
  545.      displayed to the screen).  The proper macros must be installed to
  546.      obtain the correct keyboard simulation.  The following sections
  547.      describe how to do this.
  548.  
  549.  
  550.      -----=====  ANSI-BBS Keyboard Support
  551.  
  552.  
  553.      The sample Macro File, COMMO.MAC, includes macros to use the PC keypad
  554.      keys (arrow keys, PgUp, PgDn, etc.) with most BBS full-screen editors. 
  555.      If these keys do not seem to work properly, especially if the left
  556.      arrow seems to hang the host, you should try the VT102 keyboard file
  557.      (see instructions below).  Do not set the "V" for display emulation
  558.      unless the host requires it.
  559.  
  560.  
  561.  
  562.      -----=====  VT102 Keyboard Simulation
  563.  
  564.  
  565.      The VT102 keyboard simulation macro file, VT102.MAC, works best with
  566.      the enhanced 101-key keyboard (turn on Numlock to use digits 0-9 and
  567.      the period).
  568.  
  569.      IMPORTANT!  The PgUp and PgDn keys are part of VT102 emulation.  To
  570.      bring up the upload or download protocol menus while VT102.MAC is
  571.      loaded, press Alt-Z.
  572.  
  573.      VT102.MAC will load automatically if "vt102" is specified as the
  574.      Linked Macro in a Dialing Directory entry.  For example:
  575.  
  576.        University UNIX  {555-1234} {password} {vt102} {,,,V}
  577.  
  578.      Notice also the presence of the "V" in the parms field, which enables
  579.      the display portion of the VT102 emulation.  VT102 is a superset of
  580.      VT100.
  581.  
  582.      The following special VT102 keyboard functions are supported.  The
  583.      first column is the PC key; the second column is the corresponding
  584.      VT102 function (^ indicates the Ctrl key):
  585.  
  586.                F1 ... F4              PF1 ... PF4
  587.                Arrows                 Four cursor keys
  588.                Home                   Home cursor
  589.                ^Home                  Insert line
  590.                PgUp                   Page up
  591.                ^PgUp                  Delete line
  592.                PgDn                   Page down
  593.                ^PgDn                  Clear screen
  594.                End                    End of line
  595.                Ins                    Insert mode
  596.                Del                    DEL
  597.                ^(BS)                  Ctrl backspace (DEL)
  598.                Keypad *               Keypad ,
  599.                Keypad -               Keypad -
  600.                Keypad +               Keypad Enter
  601.  
  602.      VT102 numeric keypad keys are auto-switched by the host system between
  603.      numeric mode and application mode.  The four cursor keys are auto-
  604.      switched between cursor mode and application mode.
  605.  
  606.      This file may be modified to create any keyboard support you desire
  607.      (see description of VTCUr and VTPAd functions in the section "{COMMO}
  608.      Macro Functions."
  609.  
  610.  
  611.  
  612.      -----=====  VT220 Keyboard Simulation
  613.  
  614.  
  615.      VT220 keyboard simulation uses the file VT220.MAC.  All of the
  616.      statements in the previous section apply (substitute the term VT220
  617.      for VT102).
  618.  
  619.      Note that {COMMO} does NOT support the enhanced display functions of
  620.      the VT220 terminal (it supports VT102).  Therefore the results may not
  621.      be satisfactory in all cases.
  622.  
  623.      The following special VT220 keyboard functions are supported:
  624.  
  625.                F1 ... F4              PF1 ... PF4
  626.                F5                     Break
  627.                F6 ... F12             F6 ... F12
  628.                Alt-F11 ... Alt-F14    F11 ... F14
  629.                Alt-F15                Help
  630.                Alt-F16                Do
  631.                Alt-F17 ... Alt-F20    F17 ... F20
  632.  
  633.                Arrows                 Four cursor keys
  634.                Home                   Find
  635.                Ins                    Insert here
  636.                Del                    Remove
  637.                End                    Select
  638.                PgUp                   Prev screen
  639.                PgDn                   Next screen
  640.  
  641.                Keypad *               Keypad ,
  642.                Keypad -               Keypad -
  643.                Keypad +               Keypad Enter
  644.                Backspace              DEL
  645.  
  646.  
  647.      -----=====  Printer Support
  648.  
  649.  
  650.      {COMMO} supports the ANSI/VT102 printer functions, controlled by the
  651.      remote system:
  652.  
  653.           The "Printer ON/OFF" function will turn {COMMO}'s Print Log
  654.           ON/OFF.
  655.  
  656.           The "Dedicated Printing" function will send all input from the
  657.           serial port directly to the printer.  This allows for
  658.           "transparent" transmission of printer data, including control
  659.           codes.
  660.  
  661.           The "Print Screen" function will print the entire current screen.
  662.  
  663.      The printer should be on and ready to print when these functions are
  664.      used.  When "Dedicated Printing" is active no characters will be
  665.      displayed on the screen.
  666.  
  667.  
  668.  
  669.  
  670.      TIPS on using terminal emulation:
  671.  
  672.      >    Whenever a change is made, a reset of mode parameters will be
  673.           performed.  It is therefore important that the change be made
  674.           BEFORE (or at the time of) connecting with a host (mode settings
  675.           may be transmitted by the host).
  676.  
  677.      >    If some screens do not look right when VT102 emulation is used,
  678.           you may need to turn LINEWRAP off (it defaults to on).
  679.  
  680.           Linewrap may be turned on/off locally using the DISPlay macro
  681.           function.  Place one of the following in your login macro (or
  682.           assign one of them to a key and execute it manually):
  683.  
  684.                {display ,,,^[[?7h}      linewrap ON
  685.                {display ,,,^[[?7l}      linewrap OFF
  686.  
  687.      >    {COMMO} will support auto-switching to 132 column mode, but you
  688.           must define the hardware video mode that causes your video
  689.           adapter to switch to 25x132 (rows, columns).  See the item {avm=}
  690.           under "[Alt-G]  Edit Setup File" for details.  Note that your
  691.           video adapter should be in 25x80 when you start {COMMO}.
  692.  
  693.      >    If colors do not always look right, it may be necessary to set
  694.           the Terminal Screen colors in the Setup File to {07}.  See the
  695.           note under "Colors" in the section "[Alt-G]  Edit Setup File."
  696.  
  697.  
  698.  
  699.      ==========  Appendix H   {COMMO} Macro Key-labels
  700.  
  701.  
  702.      Key-labels are special macro labels that let you start a macro by
  703.      pressing the associated key (they can also be the targets of GOTO,
  704.      CALL, etc.).  They fall into two general categories: predefined and
  705.      user-defined.
  706.  
  707.  
  708.      ----------  Table of PREDEFINED Key-labels
  709.  
  710.  
  711.      The caret (^) indicates the Ctrl key.  "Normal" means unshifted.
  712.  
  713.           Key Name     Key-label     Key Name     Key-label
  714.           ________     _________     ________     _________
  715.  
  716.           Normal-F1     nf1   ...    Normal-F10    nf0
  717.           Normal-F11    nfa          Normal-F12    nfb
  718.  
  719.           Ctrl-F1       cf1   ...    Ctrl-F10      cf0
  720.           Ctrl-F11      cfa          Ctrl-F12      cfb
  721.  
  722.           Shift-F1      sf1   ...    Shift-F10     sf0
  723.           Shift-F11     sfa          Shift-F12     sfb
  724.  
  725.           Alt-F1        af1   ...    Alt-F10       af0
  726.           Alt-F11       afa          Alt-F12       afb
  727.  
  728.           Alt-A         ala   ...    Alt-Z         alz
  729.           Alt-1         al1   ...    Alt-0         al0
  730.           Alt =         al=          Alt -         al-
  731.  
  732.           Escape        esc          Grey *        gr*
  733.           Grey -        gr-          Grey +        gr+
  734.  
  735.           Backspace     bsp          ^Backspace    cbs
  736.           Tab           tab          Shift-tab     stb
  737.           Enter         ent          ^Enter        cen
  738.  
  739.           Home          hom          End           end
  740.           PgUp          pgu          PgDn          pgd
  741.           Up-Arrow      upa          Down-Arrow    dna
  742.           Left-Arrow    lfa          Right-Arrow   rta
  743.           Insert        ins          Delete        del
  744.  
  745.           ^Home         chm          ^End          cnd
  746.           ^PgUp         cpu          ^PgDn         cpd
  747.           ^Right-Arrow  cra          ^Left-Arrow   cla
  748.  
  749.           Keypad-0      kp0   ...    Keypad-9      kp9
  750.           Keypad-.      kp.          ^PrtSc        cpr
  751.  
  752.  
  753.  
  754.           Alt-[         al[          Alt-]         al]
  755.           Alt-;         al;          Alt-'         al'
  756.           Alt-,         al<          Alt-.         al.
  757.           Alt-/         al/          Alt-\         al\
  758.           Alt-*         al*          Alt-`         al`
  759.           Alt-Kp(-)     ak-          Alt-Kp(+)     ak+
  760.           Alt-Return    art          Center Key    cky
  761.  
  762.      TIPS on using key-labels:
  763.  
  764.      >    Key-labels are always three characters in length.
  765.  
  766.      >    Some key-labels are not available on systems with an older BIOS. 
  767.           And some keys do not exist on the 83-key keyboard.
  768.  
  769.      >    If the same key-label appears more than once, the first
  770.           occurrence will be used (as with any macro label).
  771.  
  772.      >    Key-labels are not case sensitive.
  773.  
  774.      >    The Center Key is the Keypad 5 with Numlock off.
  775.  
  776.  
  777.      ----------  USER-DEFINED Key-labels
  778.  
  779.  
  780.      (Note that this feature is unavailable during shareware evaluation.)
  781.  
  782.      Almost any key combination on the keyboard may be defined with the
  783.      "mky" item in the Setup File (see "[Alt-G]  Edit Setup File" in Part
  784.      I).
  785.  
  786.      TIPS on using user-defined key-labels:
  787.  
  788.      >    You may have up to 32 user-defined key-labels.
  789.  
  790.      >    Keys with predefined key-labels may not be user-defined.  Check
  791.           the list above before defining a key.
  792.  
  793.      >    Use Alt-K in the Internal Editor to obtain the scan code for any
  794.           key.  When a scan code ends in "E0", change the "E0" to "00" to
  795.           define the key.
  796.  
  797.      >    Beware that some keys give the same scan code when used with
  798.           various shift keys (Ctrl, Alt or Shift) as when unshifted.  Some
  799.           examples are: Space, Esc, Return and Backspace.
  800.  
  801.      >    You cannot define keys formed with multiple shift keys.  For
  802.           example, you cannot use Ctrl-Alt-F1 or Ctrl-Shift-Home.
  803.  
  804.  
  805.  
  806.      ==========  Appendix K   {COMMO} Support Files
  807.  
  808.  
  809.      The {COMMO} support files are standard ASCII text files and may be
  810.      modified with any editor (or word processor in "non-document" mode). 
  811.      From within {COMMO} they may be edited with {COMMO}'s Internal Editor. 
  812.      Each support file may be up to 64k in size (if there is enough
  813.      memory).
  814.  
  815.      The only control characters (below ASCII 28) allowed in support files
  816.      (or in the Internal Editor) are CR/LF pairs and an EOF at the end. 
  817.      Where necessary, control characters may be represented symbolically as
  818.      shown in Appendix D.  For example, an ASCII 16 would be written as ^P.
  819.  
  820.      TIPS on using {COMMO} support files:
  821.  
  822.      >    All support files must reside in the {COMMO} home directory.
  823.  
  824.      >    A file currently in memory may be different from the file on disk
  825.           (files are saved automatically at certain times).  Therefore it
  826.           is advisable to use an external editor ONLY in the Swap to Disk
  827.           (files are saved prior to -- and reloaded after -- the Swap to
  828.           Disk).
  829.  
  830.  
  831.      ----------  The Internal Editor
  832.  
  833.  
  834.      {COMMO}'s Internal Editor is provided for your convenience.  It is not
  835.      intended to be a comprehensive text editor.  An external editor should
  836.      be used if more editing power is desired.  The Internal Editor may be
  837.      used to edit {COMMO} support files or any other text file smaller than
  838.      64k.
  839.  
  840.      When a file that can be edited is loaded, a fixed amount of expansion
  841.      space is allocated (no more than 64k total).  The amount of expansion
  842.      space is determined by the {esf=...} item in the Setup File.  The
  843.      Internal Editor will warn you while editing if the expansion space
  844.      fills up, at which point you may reload the file or restart {COMMO} if
  845.      you wish to continue editing (the file will be saved automatically).
  846.  
  847.      Key assignments for the Internal Editor are given in Online Help.  A
  848.      Color Chart will be displayed in the editor when F7 is pressed (useful
  849.      in the Setup File and for the DISPlay function in Macro Files).
  850.  
  851.  
  852.      ----------  The Setup File, COMMO.SET
  853.  
  854.  
  855.      The Setup File contains settings for many important parameters.  The
  856.      first time you run {COMMO} you should use the Alt-G key command to
  857.      edit this file to your own needs.
  858.  
  859.  
  860.  
  861.      IMPORTANT!  If you edit the Setup File, the changes will not take
  862.      effect until you restart {COMMO}.
  863.  
  864.      See "[Alt-G]  Edit Setup File" for details on each item.
  865.  
  866.  
  867.      ----------  The Dialing Directory, COMMO.FON
  868.  
  869.  
  870.      The Dialing Directory file contains information about each system that
  871.      you will be calling, including the telephone number, password, Linked
  872.      Macro and Terminal Parameter overrides.  Use the Alt-D key command to
  873.      dial numbers and to edit this file.
  874.  
  875.      A new Dialing Directory file may be loaded at any time using the
  876.      FONFile macro function, or manually within the Dialing Directory
  877.      window.  This feature may result in somewhat higher memory usage
  878.      during a {COMMO} session.  (Note that this feature is unavailable
  879.      during shareware evaluation.)
  880.  
  881.      See also "[Alt-D]  Dialing Directory."
  882.  
  883.  
  884.      ----------  The Resident Macro File, COMMO.MAC
  885.  
  886.  
  887.      The resident Macro File is loaded when you start {COMMO} and contains
  888.      macros that are available at all times.  Use the Alt-M key command to
  889.      select a macro for execution and to edit the resident Macro File.  A
  890.      complete description of {COMMO} macros is given in Part II.  Summary
  891.      lists of macro functions and key designators can be found in the
  892.      appendices and also in Online Help.
  893.  
  894.  
  895.      ----------  The Auxiliary Macro File
  896.  
  897.  
  898.      An auxiliary Macro File may be loaded (or replaced) at any time using
  899.      the CALL and GOTO macro functions.  A new auxiliary file may be loaded
  900.      manually within the Macro File window.  An auxiliary may also be
  901.      specified in a Dialing Directory entry and will load when a connection
  902.      is made with the remote system.
  903.  
  904.      When an auxiliary is loaded, the auxiliary and resident files behave
  905.      as one Macro File.  Note that the auxiliary is positioned logically
  906.      AHEAD of the resident, allowing macros in the resident to be
  907.      overridden when necessary.  You can CALL and GOTO between the files,
  908.      but a macro cannot span the two files.
  909.  
  910.      The current auxiliary may be released from memory using the UNLOad
  911.      macro function.
  912.  
  913.  
  914.  
  915.      ----------  The Online Help File, COMMO.HLP
  916.  
  917.  
  918.      The Online Help File contains the information for {COMMO}'s context-
  919.      related Online Help.  This file can be customized.
  920.  
  921.      See "F1  How to Use Online Help."
  922.  
  923.  
  924.      ----------  Changes to the Support Files
  925.  
  926.  
  927.      Whenever a change is made to any file, the internal change flag is set
  928.      for that file (indicated by an "*" next to the column number in the
  929.      Internal Editor).  Changes are normally saved automatically at program
  930.      exit or if another file is loaded, but you may press Alt-F in the
  931.      Internal Editor to immediately save any file to disk.
  932.  
  933.      If you do not wish to save your changes, you may press Alt-Q while in
  934.      the Internal Editor.  This will reset {COMMO}'s change flag and the
  935.      file will not be saved automatically (however, any subsequent changes
  936.      to the file will set the change flag again).
  937.  
  938.                               - end -
  939.  
  940.