home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1993 #2 / Image.iso / comm / commo551.zip / ADDENDUM.DOC next >
Text File  |  1993-08-07  |  13KB  |  383 lines
  1.  
  2.  
  3.                             {COMMO} 5.5 Addendum
  4.                             ____________________
  5.  
  6.      This Addendum contains the major additions and/or changes to the
  7.      {COMMO} 5.41 documentation.  Print out this file and keep it with
  8.      your printed manual.  There is a complete list of changes (major
  9.      and minor) in the file HISTORY.
  10.  
  11.  
  12.      ===============================
  13.      In the User Guide and Reference
  14.      ===============================
  15.  
  16.  
  17.      Under "Command Line Options - Switches"
  18.      ---------------------------------------
  19.  
  20.      /{parms}       Default Dialing Parameters
  21.  
  22.           Any or all parameters may be specified.  Included parameters
  23.           will override those in the "ddp=" item in the Setup File.
  24.  
  25.  
  26.      Under "Alt-G  Edit Setup File"
  27.      ------------------------------
  28.  
  29.      __________________________________________
  30.  
  31.      {clm=auto}    Color Mode (auto/color/mono)
  32.      __________________________________________
  33.  
  34.           If this item is set to "auto," {COMMO} will auto detect the
  35.           display type and use the proper mode.  The default modes are
  36.           "color" for color displays and "mono" for monochrome
  37.           displays.
  38.  
  39.           If you have a laptop with a black and white LCD display
  40.           (VGA, EGA or CGA compatible), you can use the "mono" mode to
  41.           improve the contrast (color items below are ignored).
  42.  
  43.           Setting the mode to "color" will force the use of the
  44.           colors/attributes in the items below.  This is useful if you
  45.           have a monochrome display and you prefer to set your own
  46.           attributes.
  47.  
  48.           Press F7 while editing the Setup File (or other files) to
  49.           pop up the color chart.  You may use it with color or
  50.           monochrome displays.  Color settings have no effect when the
  51.           Color Mode is "mono" (or "auto" with a monochrome display).
  52.  
  53.           NOTE:  Terminal Screen colors/attributes may still be
  54.           changed if ANSI display data is received from the host.  It
  55.           may be necessary to adjust your settings at the host.
  56.  
  57.  
  58.  
  59.  
  60.      Under "Uploading and Downloading"
  61.      ---------------------------------
  62.  
  63.      Files for uploading (sending) are chosen from the file selection
  64.      menu (supported by SELECT.MAC).  Only one file should be selected
  65.      when using the Xmodem protocol.
  66.  
  67.  
  68.  
  69.      ==============================
  70.      In the Macro Programming Guide
  71.      ==============================
  72.  
  73.      ------------------------------------
  74.      New or Changed Function Descriptions
  75.      ------------------------------------
  76.  
  77.      _______
  78.  
  79.      CAPTure
  80.      _______
  81.  
  82.      Default key:   Alt-1
  83.      Description:   Capture File Options.
  84.  
  85.      Switches:
  86.  
  87.                N1 or N   Do not wait for a keypress if the disk fills
  88.                          up while capturing (a message is displayed
  89.                          for several seconds).  The setting remains in
  90.                          effect until the Capture File is closed.
  91.  
  92.                          NOTE:  This switch is effective only on a
  93.                          CAPTure function that successfully opens a
  94.                          Capture File.
  95.  
  96.                N0        Wait for Esc to be pressed if the disk fills
  97.                          up (default).
  98.  
  99.      Examples:
  100.  
  101.           {capture}                     Open Capture File Options
  102.                                         window.
  103.  
  104.           {capture y}                   Open current Capture File.
  105.  
  106.           {capture n}                   Close current Capture File.
  107.  
  108.           {capt y,c:\commo\file.xyz}    Open indicated Capture File.
  109.  
  110.           {capt n,c:\dl\newfile.cap}    Close current Capture File,
  111.                                         set new file as indicated.
  112.  
  113.      The current Capture File will always be closed when a new file is
  114.      opened.
  115.  
  116.      IMPORTANT!  If the disk fills while capture is open, a "disk
  117.      full" message will appear (see the "N" switch above) and the file
  118.      will be closed.  The built-in variable "_dfc" will be set to 1.
  119.  
  120.      See also CAPMode.
  121.  
  122.  
  123.  
  124.      ____
  125.  
  126.      FILE
  127.      ____
  128.  
  129.      Default key:   none
  130.      Description:   Find directory entry information.
  131.  
  132.      General form:
  133.  
  134.           {FILE filespec}
  135.  
  136.                filespec       The path and file mask to be used for
  137.                               finding directory entries (filenames and
  138.                               subdirectories).  May consist of drive,
  139.                               path and filename with wildcards.
  140.  
  141.      Switches:
  142.  
  143.                X1 or X        Find next matching entry.
  144.  
  145.                X0             Find first matching entry (default).
  146.  
  147.      Examples:
  148.  
  149.           {file c:\upload\*.*}     Find first filename or subdirectory
  150.                                    in the directory "c:\upload."
  151.  
  152.           {file-x}                 Find next filename in same
  153.                                    directory.
  154.  
  155.      The FILE function will find directory information about files and
  156.      subdirectories specified in "filespec."  The data will be made
  157.      available in the following built-in variables:
  158.  
  159.           _ffn      Filename or subdirectory name.  Subdirectory names
  160.                     will be preceded with a "\".  The parent directory
  161.                     (if any) will be indicated as "\..".
  162.  
  163.           _ffs      File size in bytes.
  164.  
  165.           _ffd      File date.  The format will be as specified in
  166.                     Setup File item "dat=".
  167.  
  168.           _fft      File time.  The format will be as specified in
  169.                     Setup File item "tim=".
  170.  
  171.      The FILE function must be executed without the "X" switch (or
  172.      with X0) to initialize the directory.  This will also make
  173.      available the first filename or subdirectory.  Subsequent
  174.      executions (with the "X" switch) will make subsequent names
  175.      available.
  176.  
  177.      Use the IFCOndition function to determine if a filename was made
  178.      available.  The first label ("true") will be taken if a filename
  179.  
  180.  
  181.  
  182.      was found;  the second label ("false") will be taken if no
  183.      additional filenames are available.
  184.  
  185.      NOTE:  The built-in variables will always contain the data for
  186.      the last filename found.  If no filename has ever been found, the
  187.      contents are unpredictable.
  188.  
  189.      _____
  190.  
  191.      IFxxx     NOTE:  The following applies to all "IF" functions.
  192.      _____
  193.  
  194.      Switches:
  195.  
  196.                C1 or C   A CALL is performed on the label.  When the
  197.                          CALLed routine RETUrns, execution will
  198.                          continue following the IFxxx.
  199.  
  200.                C0        A GOTO is performed (default).
  201.  
  202.      Examples:
  203.  
  204.                {ifxxx label10,label20}            Using GOTO
  205.                {ifxxx-c label10,label20}          Using CALL
  206.  
  207.      ______
  208.  
  209.      INFOrm
  210.      ______
  211.  
  212.      Default key:   none
  213.      Description:   Display an advisory message.
  214.  
  215.      General form:
  216.  
  217.           {INFOrm string}
  218.  
  219.                string    Message to be displayed.
  220.  
  221.      Switches:
  222.  
  223.                Q1 or Q   Query the user for a "Yes/No" response. 
  224.                          "Yes" will be the default if Enter is
  225.                          pressed.
  226.  
  227.                          The Condition Flag will be set to "true" if
  228.                          the response is "yes".  It will be set to
  229.                          "false" if the response is "no".  Test with
  230.                          IFCOndition.
  231.  
  232.                Q0        Query the user for a "Yes/No" response.  "No"
  233.                          will be the default if Enter is pressed.  The
  234.                          Condition Flag is set as above.
  235.  
  236.  
  237.  
  238.                Dn        Display the message for "n" seconds, then
  239.                          continue.  "n" may range from 1 to 999.
  240.  
  241.                S1 or S   An error sound will accompany the message
  242.                          (default).
  243.  
  244.                S0        No error sound will be made.
  245.  
  246.      Examples:
  247.  
  248.           {inform Press a key to continue}        Wait for Esc.
  249.           {info-qs0 Overwrite the file?}          Yes/No response, no
  250.                                                   error sound.
  251.           {info-d3 Login now in progress}         Display message for
  252.                                                   3 seconds, then
  253.                                                   continue.
  254.  
  255.      INFOrm will display a string in a pop-up box over the Terminal
  256.      Screen.  {COMMO} will normally wait for "Esc" to be pressed
  257.      (switches can alter this behavior).  The string length is limited
  258.      by the width of the screen.
  259.  
  260.      NOTE:  When the "Q" switch is used, Esc and Ctrl-Break will be
  261.      ignored.
  262.  
  263.      _______
  264.  
  265.      MACLoad
  266.      _______
  267.  
  268.      Default key:   none
  269.      Description:   Load a new Macro File.
  270.  
  271.      General form:
  272.  
  273.           {MACLoad filename,label}
  274.  
  275.                filename       The new Macro File.  Do NOT specify a
  276.                               path; the {COMMO} home directory will be
  277.                               used.
  278.  
  279.                label          A label to GOTO when the new file is
  280.                               loaded.  Optional.
  281.  
  282.      Switches:
  283.  
  284.                R1 or R   Specifies that COMMO.MAC will be reloaded
  285.                          when carrier detect is lost.  Normally this
  286.                          would occur at the end of the call.
  287.  
  288.                R0        Do not reload COMMO.MAC when carrier is lost
  289.                          (default).
  290.  
  291.      Examples:
  292.  
  293.  
  294.  
  295.           {macload-R vt102-1.mac}       Load vt102-1.mac, reload
  296.                                         COMMO.MAC at the end of the
  297.                                         call.
  298.  
  299.           {macl newmac.fil,abc}         Load newmac.fil, start macro
  300.                                         "abc" in the new file.
  301.  
  302.           {macload commo.mac,%mcall}    Load COMMO.MAC, GOTO the label
  303.                                         specified in the variable
  304.                                         "mcall".
  305.  
  306.      IMPORTANT!  The new Macro File must reside in the {COMMO} home
  307.      directory (do not specify a path).
  308.  
  309.      TIPS on using MACLoad:
  310.  
  311.      >    The new Macro File can be "called" (by setting a variable to
  312.           the return label).  Use this variable as the optional label
  313.           when "returning" to the calling Macro File.
  314.  
  315.      >    The macro stack is preserved during MACLoad.  Be sure that
  316.           your CALLs and RETUrns are in "sync" or the results may be
  317.           unpredictable.
  318.  
  319.      >    The current file will be saved to disk if changes are
  320.           outstanding.  The new file is then loaded in place of the
  321.           current one (all macros are replaced).  
  322.  
  323.      >    MACLoad should be the last function in a macro, since
  324.           control is not returned.
  325.  
  326.      ______
  327.  
  328.      WINDow
  329.      ______
  330.  
  331.      Default key:   none
  332.      Description:   Preserve window display.
  333.  
  334.      Switches:
  335.  
  336.                K1 or K   Do not allow the Terminal Screen to be
  337.                          restored when exiting from a window.
  338.  
  339.                K0        Allow the Terminal Screen to be restored when
  340.                          exiting from a window (default).
  341.  
  342.      Examples:
  343.  
  344.           {window-k}          Don't restore the Terminal Screen.
  345.  
  346.           {wind-k0}           Restore the Terminal Screen.
  347.  
  348.      This function will prevent the Terminal Screen from being
  349.      restored after a window function exits.  It is useful for making
  350.  
  351.  
  352.  
  353.      smooth, flicker-free transitions between windows or for placing
  354.      one pop-up window on top of another.
  355.  
  356.      The condition will remain active until either the "k0" switch is
  357.      used or the macro terminates.
  358.  
  359.  
  360.      ---------------------------------
  361.      New or Changed Built-in Variables
  362.      ---------------------------------
  363.  
  364.           _dsk      Current disk (e.g., C:)
  365.           _dir      Current directory (e.g., \upload, \)
  366.  
  367.           _ffn      Find file name (use with FILE function)
  368.           _ffs      Find file size
  369.           _ffd      Find file date
  370.           _fft      Find file time
  371.  
  372.           _msn      Menu label selection number, from last MENU
  373.                     function (1 to 26)
  374.  
  375.           _nam      Current System Name (up to 40 chars)
  376.           _num      Current Phone Number (up to 40 chars)
  377.  
  378.           _ela      Elapsed time in minutes:seconds
  379.  
  380.  
  381.                                   - end -
  382.  
  383.