home *** CD-ROM | disk | FTP | other *** search
/ Best Objectech Shareware Selections / UNTITLED.iso / boss / comm / misc / 005 / qwikstrt.doc < prev    next >
Encoding:
Text File  |  1992-01-18  |  46.3 KB  |  880 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.                                   Intellicomm (TM)
  7.                                         v0.94
  8.         Copyright (C) 1991-1992 Liberation Enterprises.  All rights reserved.
  9.                          Quick-Start Installation/Setup Help
  10.  
  11.      This document outlines Intellicomm's purpose in life, and in return what
  12.      the program requires of your computer system, in order to help you decide
  13.      whether to install it or not.  Once installed you are taken quickly
  14.      through the initial program setup, setting up only those items of
  15.      immediate importance.  Once the setup is complete and you enter
  16.      Intellicomm itself, you are taken on a relatively swift guided tour of the
  17.      program's major areas and you should be connected to a BBS (and may even
  18.      be performing auto-logons or could be well on your way to complete
  19.      automation) before long.
  20.  
  21.      It is recommended that you print this text before beginning, so you can
  22.      read it as we perform that actual installation and setup.  If you have a
  23.      printer, type "COPY QWIKSTRT.DOC PRN" (no quotes) from DOS for a printout. 
  24.      If you do not have a printer, please at least scan the text right through
  25.      so you'll have some idea where you're going.
  26.  
  27.      TECHNICAL SUPPORT
  28.  
  29.      If you have a problem, complement, suggestion, or question about
  30.      Intellicomm please contact ALL or WAYNE DUFF in any echoed Intellicomm or
  31.      Liberator Support conference on your local BBS.  Intellicomm echoes are
  32.      available on NorthAmeriNet, RelayNet/RIME, and soon on SmartNet and U'NI-
  33.      net (the Liberator echo will be renamed).  [If the BBS you call picks up
  34.      one or more of the above networks and does not carry the
  35.      Intellicomm/Liberator conference, just ask your Sysop to pick it up for
  36.      you.]  I also monitor Communications/Telecommunications and Shareware
  37.      echoes on the above networks plus EchoNet, ILink and Intelec.  Intellicomm
  38.      support is free to all for the asking.
  39.  
  40.      INTELLICOMM -- WHAT IT IS AND IS NOT
  41.  
  42.      Intellicomm is a communications program that bristles with useful
  43.      communications features, but that is unlike any communications program
  44.      you've ever used -- for Intellicomm was designed and PRICED specifically
  45.      with users of computer Bulletin Board Systems in mind.
  46.  
  47.      If you require terminal emulations other than ANSI, character translation
  48.      tables, or other such items for calling non PC equipment, you will have to
  49.      look elsewhere.  There are dozens of communications programs available for
  50.      general communications purposes, and we did not feel it was necessary to
  51.      add to the heap.
  52.  
  53.      However, if you ARE a user of Bulletin Board Systems, you're in for a real
  54.      treat as this program was designed especially for you.  Intellicomm
  55.      provides you with three levels of support for carrying out your BBS
  56.      sessions:  Manual, semi-automatic, and fully automatic and unattended
  57.      operation on virtually any BBS in the world!  The combination of a full-
  58.      featured terminal for manual use, a very full-featured automation system
  59.      for unattended sessions on multiple BBS types (auto mail and file
  60.      transfers, and much more), and sophisticated tools to help you manage your
  61.      OFFLINE time, provides a completely different atmosphere to work in, and
  62.      may change the way you look at "BBSing".
  63.  
  64.  
  65.  
  66.  
  67.      Intellicomm v0.94               Quick Start                              2
  68.      
  69.      
  70.  
  71.      Along with the hours of manual labour Intellicomm will save you, it also
  72.      offers benefits such as reduced long distance fees, if you call out-of-
  73.      town BBS's, since sessions can be carried out unattended overnight when
  74.      long distance rates are lowest.  The speed with which the program carries
  75.      out an automated session, typing extremely fast, without ever pausing to
  76.      look at help screens or thinking about what to do next, will also cut down
  77.      on your overall connect times!  Thus you can save not only tedious manual
  78.      labour, and long distance fees, but you can also get more done each day
  79.      with your limited online time.
  80.  
  81.      If you require further feature information before beginning, please refer
  82.      to the main User's Manual, ICOM.DOC.  A much more detailed feature list
  83.      welcomes you in that document.
  84.  
  85.      REQUIREMENTS
  86.  
  87.      Intellicomm requires an IBM PC/XT/AT/386/PS/2 or compatible with 290K of
  88.      free memory, running PC/MS-DOS 2.0 or higher.  It also requires 260K of
  89.      disk space without the File Tagger, or 360K if you choose to install the
  90.      File Tagger.
  91.  
  92.      You will also need an internal or external modem that has been properly
  93.      installed and connected to the telephone line.  Please refer to the
  94.      documentation that came with your modem if you have not installed it yet,
  95.      as modem installation varies widely, and is not covered in this document.
  96.      If your modem is "Hayes" compatible, Intellicomm setup will take less
  97.      time.  However, virtually any type of modem can be used through proper
  98.      program setup.
  99.  
  100.      INSTALLATION
  101.  
  102.      If you downloaded Intellicomm from a BBS, it is recommended BEFORE
  103.      installing the package using the auto-install program, that you log back
  104.      onto the BBS and try to download a file called ICOMBIF.ZIP (substitute
  105.      .ZIP with the compression type used on the BBS).  If this file exists,
  106.      download it and uncompress it into the same directory where the
  107.      uninstalled Intellicomm package exists.  This ICOMBIF archive will contain
  108.      special setup files for the BBS, which the setup program will
  109.      automatically install, and will save you time and effort setting up.
  110.  
  111.      Once you are ready to begin the installation, change to the disk/directory
  112.      where the uninstalled Intellicomm package is located and type "GO" to
  113.      begin.  Read the initial information screen, then select "Yes" to
  114.      continue.  As mentioned on the next screen, if installing TO a floppy disk
  115.      (i.e. to run Intellicomm from drive A:) you should start on drive B: (type
  116.      B: from DOS before starting) and install to A:\.
  117.  
  118.      Intellicomm first looks for its main setup file, ICOM.INI.  If this file
  119.      is not found the program assumes that a new installation is underway, and
  120.      asks for your monitor type.  If the program did NOT ask for your monitor
  121.      type after typing GO, press 'X' then select 'A' to exit to DOS and type
  122.      DEL *.INI.  Then enter GO again to start over.
  123.  
  124.      Select a display type by pressing the 'bold' letter shown within the
  125.      option, or by using the cursor keys or mouse to move the hilight then
  126.      press Enter or the left mouse button.  [Note that if you wish to stop the
  127.      installation process for some reason, you may press the Esc key at any
  128.      time.  The "GO" command may be used again when you wish to continue.]
  129.  
  130.  
  131.  
  132.  
  133.      Intellicomm v0.94               Quick Start                              3
  134.      
  135.      
  136.  
  137.      Next you will be prompted for a drive/directory to install Intellicomm in.
  138.      If the directory does not exist, it will be created.
  139.  
  140.      You are then asked if you wish to install the "File Tagger".  The File
  141.      Tagger is used to browse BBS New Files listings and "Tag" files that you
  142.      wish to get from BBS's.  It also keeps track of files you DO get, and
  143.      allows you to Tag these and send them to other BBS's.  The Tagger has as
  144.      many features for tagging files/browsing new files lists, as Intellicomm
  145.      does for calling BBS's, and it is not described in any detail here. 
  146.      Please refer to the User's Manual for more details if you require them.
  147.  
  148.      If you do not plan to do file transfers, or do not have the disk
  149.      space/memory for the Tagger and the 'catalogs' it keeps (the Tagger itself
  150.      is 100K, catalogs vary in size), then answer "No" to this question.  If
  151.      running off a 360K disk, it is recommended that you do not install the
  152.      File Tagger.
  153.  
  154.      Intellicomm and all necessary files will then be installed, and any
  155.      necessary subdirectories will be created in the main Icom directory.
  156.  
  157.      Next you must enter the communications 'port' your modem is connected to. 
  158.      If you are using an internal modem, normally the port is configured
  159.      through switches or jumpers on the modem.  See your modem manual or call
  160.      your dealer for details if you do not know which port you're connected to. 
  161.      Note that COM1, COM2, COM3 and COM4 are not as detached as they appear. 
  162.      If you have a mouse driver set up to use COM1, you cannot use your modem
  163.      on COM3, and likewise with COM2, COM4.  There are only two 'lines' inside
  164.      your computer for all four ports, and COM1/COM3 share the same line while
  165.      COM2/COM4 share another line.  Thus you can never have two 'active'
  166.      devices sharing the same line.  'Active' includes a mouse, for even if it
  167.      doesn't move it may still interfere with proper operation of the modem if
  168.      it's on the same 'line', even if on another port.  A printer would not be
  169.      considered active, so you can normally use a modem on COM1/2 and serial
  170.      printer on COM3/4.
  171.  
  172.      COM5 to COM8 are not standard ports and must be configured in the main
  173.      setup before use.  COM5-8 are initially set up to use COM1.  If you must
  174.      use them, refer to the 'Port' screen when you enter the main setup program
  175.      in a few seconds, then enter the proper information (advanced use only).
  176.  
  177.      Next we move to the 'baud rate' (port speed) your modem uses.  See what
  178.      your modem manual recommends as the proper 'baud rate'.  If you have a
  179.      2400 baud modem, it should be fine as is.  If you have a faster/slower
  180.      modem, pick the proper baud rate from the menu.  Note that if you have
  181.      what is called an "MNP" or error-correcting modem, the baud rate is
  182.      normally set HIGHER here than the actual speed of the modem.  See your
  183.      modem manual for details if you have an MNP or other error-correcting
  184.      modem.
  185.  
  186.      INTELLICOMM QUICK SETUP
  187.  
  188.      The Intellicomm Setup program is organized into six different 'sections'
  189.      or screens.  To change a given item on each screen, move the hilight bar
  190.      over the item using the up/down arrow keys, then press 'E' (or hilight
  191.  
  192.  
  193.  
  194.  
  195.      Intellicomm v0.94               Quick Start                              4
  196.      
  197.      
  198.  
  199.      'Edit' and press Enter/click the left mouse button).  Use the same
  200.      technique to select the various setup screens.
  201.  
  202.      In this first run-through it is recommended you look at all the settings
  203.      on each of the screens, so you will have some idea what is available
  204.      should you need to make a change later.  Note the important items pointed
  205.      out with the arrow (>), as these items vary in new setups.  Each of the
  206.      important items is described below.  Other, less important items, are
  207.      discussed in the main User's Manual.
  208.  
  209.      INTELLICOMM SETUP - GENERAL OPTIONS
  210.  
  211.      Password Access Key  is used as a safeguard to protect your BBS passwords
  212.      from alteration or viewing.  Intellicomm stores all your passwords for
  213.      BBS's encrypted in a special file, and does not allow viewing or editing
  214.      of any password without this key, if you choose to enter one.  If you are
  215.      the only user on the machine you're setting up on, you probably won't need
  216.      a Password Access Key.
  217.  
  218.      All other items on this screen should be fine at their defaults for now. 
  219.      You may come back and change items later, if necessary, by running the
  220.      SETUP.EXE program directly from DOS, or through a menu option from within
  221.      Intellicomm.
  222.  
  223.      Browse the rest of the screen, to see what is available in case you need
  224.      it later, then press 'm' to move to the Terminal screen.
  225.  
  226.      INTELLICOMM SETUP - TERMINAL ITEMS
  227.  
  228.      The first six items on this screen are common communications settings
  229.      which are completely dependant on your modem.  These items must be
  230.      configured in every communications program.
  231.  
  232.      Default Comm. Port  was discussed above, before entering the main setup
  233.      program.  Refer to the text above for further information.
  234.  
  235.      Default Port Settings  is baud, parity, data bits, stop bits.  Only the
  236.      baud rate (port speed) should concern you, as most BBS's use N,8,1.  See
  237.      what your modem manual recommends as the proper 'baud rate'.
  238.  
  239.      Software Flow Control  should remain on, unless your modem manual
  240.      specifically states to turn XON/XOFF flow control off.
  241.  
  242.      Hardware Flow Control  should remain set to "None", unless your modem
  243.      manual specifically states to turn CTS/RTS or DSR/DTR flow control on.
  244.      CTS/RTS is almost always used on modems above 2400 baud, though some
  245.      support DSR/DTR.  The main setup automatically turns CTS/RTS on above 2400
  246.      baud.
  247.  
  248.      Initialize Modem String  is probably the most important setting in
  249.      Intellicomm.  If you get this one wrong, chances are very good that you'll
  250.      run into problems later.  This string (group of commands) is sent to your
  251.      modem each time Intellicomm 'greets' it for the first time (before
  252.      dialing, etc.), and whatever you define here must handle AT LEAST the
  253.  
  254.  
  255.  
  256.  
  257.      Intellicomm v0.94               Quick Start                              5
  258.      
  259.      
  260.  
  261.      following:
  262.  
  263.        Function                         "Hayes" command
  264.       -------------------------------------------------------------------------
  265.        Set echo ON                              E1
  266.        Modem returns result codes               Q0
  267.        Display result codes as WORDS            V1
  268.         or in Verbose form                       
  269.        Enable busy signal detection             X4
  270.         The best policy is to set 'X' to the highest number available.  If X4
  271.         is not supported, Intellicomm will not be able to tell when the line
  272.         is busy when dialing.
  273.        Enable Carrier Detect                    &C1
  274.         Very important, but may also be set by a switch.  If your modem is 1200
  275.         baud you must remove this command, and find the switch for carrier
  276.         detect enable (normally switch 6 on Hayes compatibles).  If Carrier
  277.         detect enable is not set up properly, Intellicomm will be told that it
  278.         is connected at all times, and this will surely cause it to
  279.         malfunction.
  280.        Recognize change in Data Terminal Ready  &D2
  281.         Must be removed if 1200 baud.  & commands are only supported by 2400
  282.         baud modems and higher.  This causes the modem to hang up if DTR
  283.         changes.
  284.        Turn Auto Answer Off                     S0
  285.        Allow Communications Program to
  286.         handle timeout when dialing             S7=255
  287.  
  288.      Modem Hangup String  should be set to get your modem into command state
  289.      (the +++ does this for Hayes compatibles, ~ causes a 1 second pause), then
  290.      enter whatever command causes a hangup.  Note that in most cases a hangup
  291.      can be caused by lowering the Data Terminal Ready (DTR) status, and
  292.      Intellicomm tries this first if the item below is set to "Yes".  
  293.  
  294.      The rest of the items on this screen are not of immediate importance, and
  295.      can wait until later.  Most will never need changing.  Press 'D' now to
  296.      move to the Dialing screen.
  297.  
  298.      INTELLICOMM SETUP - DIALING ITEMS
  299.  
  300.      Dial Prefix 1  is the command to send to the modem just before sending an
  301.      actual telephone number.  You may use ^ to specify control characters
  302.      (e.g. ^M is Control-M or Enter), or ~ to cause a one-second pause.  The
  303.      command is usually ATDT for touch-tone, or ATDP for pulse dialing.
  304.  
  305.      Dial Prefix 2, 3, and the Dial Codes are for advanced/special purpose use
  306.      and may be defined later, if necessary.
  307.  
  308.      Dial Suffix  is what to end a dial command with.  The entire dial command
  309.      is sent to the modem like this (without the angle brackets, of course):
  310.  
  311.      <Dial Prefix>PHONE-NUMBER<Dial Suffix>
  312.  
  313.      ^M, the default Dial Suffix, is a Carriage Return (the Enter key).
  314.  
  315.  
  316.  
  317.  
  318.      Intellicomm v0.94               Quick Start                              6
  319.      
  320.      
  321.  
  322.      Dial Connected  is the result your modem returns when a connection is
  323.      made.  You should only have to change CONNECT if using a non-standard
  324.      modem.
  325.  
  326.      Auto Baud Detect  is supported only on Hayes compatible modems that return
  327.      connect messages in the format CONNECT 1200, CONNECT 2400, etc.  
  328.      Intellicomm looks for the baud rate immediately following the "Dial
  329.      Connected" string defined above.  If you are using an MNP or error-
  330.      correcting/high speed modem, Auto Baud Detect is normally turned OFF.
  331.  
  332.      Dial Busy/Retry 1-3  defines three result codes from your modem that
  333.      signify no connection was made from a dial attempt, but to retry the
  334.      number again later.  See your modem manual for suitable result codes.
  335.  
  336.      Exclude Dialing 1-3  defines three result codes from your modem that
  337.      signify no connection was made from a dial attempt, but to EXCLUDE that
  338.      number from further dialing (not permanently, but it will remain excluded
  339.      until a connection is eventually made or you exit the dialer).  For
  340.      example, if your modem returns the result VOICE, the number may be out of
  341.      service, and it would not be necessary to retry it.  The number is not
  342.      permanently excluded, however, since some BBS's operate only during
  343.      certain times of the day, while regular voice calls are taken at other
  344.      times.  This way, Intellicomm will not continuously redial the number for
  345.      the current session, but would dial the number again on the next
  346.      session/day when the BBS may be operating.
  347.  
  348.      The rest of the items on this screen should be fine at their default
  349.      values.  The Screen/File Transfer screen may also be saved for later, but
  350.      it would probably be useful to select it and give it a quick look so
  351.      you'll know what's there, and why to come back to it later.  When you're
  352.      ready to continue, press 'F' to move to the File/Path screen.
  353.  
  354.      INTELLICOMM SETUP - FILE/PATH
  355.  
  356.      Mail Reader  is the command Intellicomm sends to DOS when you select "Mail
  357.      Reader" from the Tools menu from within the program.  Enter the command to
  358.      run your Mail Reader just as you would if you were typing it from the DOS
  359.      command line prompt.
  360.  
  361.      Reply Dir  is the directory where your Mail Reader places your replies to
  362.      send to BBS's.  Intellicomm always looks for replies in this directory.
  363.  
  364.      Message Dir  is the directory where your Mail Reader expects to find
  365.      messages/message packets from BBS's.  Intellicomm places all newly
  366.      downloaded mail in this directory.
  367.  
  368.      Main Unpack, 2nd Unpack  are presently used only to extract New Files
  369.      Lists from ".QWK" message packets, which are message packets from a Qmail-
  370.      compatible message door.  Since many Qmail-compatible doors allow multiple
  371.      compression formats, Intellicomm allows you to define two unpack commands. 
  372.      If the first fails, the second is tried.
  373.  
  374.      Arc. Viewer  is the command Intellicomm sends to DOS when you select the
  375.      "Archive Viewer" command from within the program.  Enter the command to
  376.  
  377.  
  378.  
  379.  
  380.      Intellicomm v0.94               Quick Start                              7
  381.      
  382.      
  383.  
  384.      run your Archive Viewer just as you would from the DOS command line.
  385.  
  386.      File Viewer  is an external file viewing program (such as Buerg's LIST)
  387.      that is called when you select "View" from several DOS-oriented menus
  388.      inside Intellicomm.
  389.  
  390.      Swap Dir  is not pointed out by an arrow, but if you wish to have
  391.      Intellicomm swap itself out of memory to a RAMdisk when running external
  392.      programs, enter the RAMdisk path here.
  393.  
  394.      SAVING YOUR SETUP
  395.  
  396.      After you are satisfied with your settings, select eXit or press Esc, then
  397.      select Save Changes from the exit menu.  This completes the initial setup
  398.      of Intellicomm, and you will now be turned over to the main program
  399.      itself.
  400.  
  401.      Intellicomm chooses to display a payment reminder (a "price tag", which
  402.      will be removed after you buy the program, as with anything else you buy)
  403.      on each startup, rather than 'crippling' certain features as in some other
  404.      user-supported software.  We feel this method is the best, as it keeps
  405.      track of the usage to show you how much you use the program, and after the
  406.      reminder allows you to make full use of the program, as according to the
  407.      original Shareware recipe.
  408.  
  409.      THE JOB DIRECTORY, THE TERMINAL, AND THE BBS DIRECTORY
  410.  
  411.      You should now be looking at the Job Directory, which is the main area of
  412.      Intellicomm.  All other areas of the program are accessible from here, and
  413.      it is from here that you will eventually select or Tag "jobs" to Run,
  414.      which will automatically dial one or more BBS's and carry out entire
  415.      sessions online.
  416.  
  417.      However, first off a quick tour is in order so you can get acquainted with
  418.      the major areas of importance in the program, and how to move about.  We
  419.      will explore only the major areas together here.  Many others will be
  420.      self-explanatory as you explore on your own later.  As always the main
  421.      User's Manual is available for more detailed help.
  422.  
  423.      A useful key to use to move about the major areas of the program is the F1
  424.      function key.  Press F1 now and you will see a list of program areas, and
  425.      a key combination beside each area.  The Alt-keys are used to change to
  426.      the area directly, -without- pressing F1 first and calling up this menu. 
  427.      E.g. to move to the BBS Directory, just press Alt-D from almost anywhere.
  428.  
  429.      You may use these keys from most major areas of Intellicomm, but not all
  430.      areas, as it is necessary to disable them during certain activities.  If
  431.      you press a 'hotkey' and it does not work, try F1 and if this menu does
  432.      not pop up then the hotkeys are currently disabled (in the internal
  433.      Editor, for example, the hotkeys are not available).
  434.  
  435.      The hotkeys are the fastest way to move around the major areas of
  436.      Intellicomm, and you will probably make frequent use of them after you
  437.      become familiar with the different keys.  Until you memorize them, you can
  438.  
  439.  
  440.  
  441.  
  442.      Intellicomm v0.94               Quick Start                              8
  443.      
  444.      
  445.  
  446.      use the F1 key to select the area you wish to go to.
  447.  
  448.      Press 'X' or Esc now to exit the hotkey menu without changing areas.
  449.  
  450.      INTELLICOMM'S TERMINAL
  451.  
  452.      To access your modem directly, all communications programs use what is
  453.      called a Terminal, or "Terminal mode".  Whenever Intellicomm communicates
  454.      with your modem, other than when dialing, it does so through the Terminal. 
  455.      Press 'm' now to select Terminal from the menu, and we'll take a look.
  456.  
  457.      There should have been some activity as soon as you selected the Terminal,
  458.      as Intellicomm "initialized" your modem, by sending the Initialize Modem
  459.      String which we defined above.  The string should be visible on your
  460.      screen, and hopefully your modem returned OK to signify that the
  461.      command(s) were accepted.  If you have an OK, and the line at the bottom
  462.      of the screen shows "Offline" on the left side, skip to SHIP-SHAPE below.
  463.  
  464.      If your modem displayed ERROR, don't panic.  It is probably due to a bad
  465.      'command' in the Initialization string.  I.e. if you have &C1 or &D2 in
  466.      the string, and you are using a 1200 baud modem, these commands are most
  467.      likely the problem as they are normally only supported on 2400 baud modems
  468.      or higher; X4 may also need changing to X1, X2, or X3 on old modems.  You
  469.      can find out which command caused the error by entering each command
  470.      prefixed by the AT command.  For example:
  471.  
  472.      ATE1 X4  <-- example Initialization String [2 commands]
  473.      ERROR    <-- error returned from modem on entry to Terminal
  474.      ATE1     <-- you now type this to check the first command
  475.      OK       <-- modem returns OK, so it's not this one
  476.      ATX4     <-- you type this to check the X4
  477.      ERROR    <-- aha!  Here's the culprit
  478.      ATX3     <-- try a lower X value until OK is returned,
  479.      OK           then change X4 in the init string later
  480.  
  481.      If your modem displayed nothing at all, you probably have the wrong Port
  482.      and/or Baud set up, and should press Alt-P and try different ports/bauds,
  483.      then try entering ATZ each time until you get an OK back from your modem. 
  484.      Write the proper port/baud down when you discover them.  Another common
  485.      problem that may cause nothing at all to show on the screen is a mouse
  486.      driver that is using the same 'line' as the modem.  See the main setup
  487.      above where the "Default Comm. Port" is configured, for more details.
  488.  
  489.      One of the most common problems with modems is that the factory almost
  490.      always sets them up to "lie" about whether they are connected or not.  Why
  491.      this is the case we do not know, but if Intellicomm displays "Online" on
  492.      the status line at the bottom left corner, your modem is "lying"; it is
  493.      telling Intellicomm that it's connected when it isn't.
  494.  
  495.      The program cannot operate with your modem in this state.  Normally 1200
  496.      baud modems have a switch inside which controls this, referred to in most
  497.      modem manuals as the "carrier status" switch or "carrier detect" switch. 
  498.      If changing switch 6 to its opposite position doesn't cause Icom to
  499.      display "Offline" within 5 seconds, put the switch back and go through all
  500.  
  501.  
  502.  
  503.  
  504.      Intellicomm v0.94               Quick Start                              9
  505.      
  506.      
  507.  
  508.      the others (pausing for at least 5 seconds on each) until you find the
  509.      proper one.  If switches aren't the problem, you may have to enter a
  510.      special command.  Once the command is found in your modem manual, write it
  511.      down so you can add it to your Initialization String.
  512.  
  513.      If you had an improper modem init string, or had the wrong port set, then
  514.      you must enter the proper information in the Intellicomm main SETUP.EXE
  515.      program, or you'll run into the same error each time you use the Terminal.
  516.      You may run SETUP.EXE when we return to the Job Directory in a few
  517.      minutes.
  518.  
  519.      SHIP-SHAPE
  520.  
  521.      With your modem ship-shape we can now get on with the show.  Note that
  522.      there isn't much displayed on the Terminal, but this is because we aren't
  523.      connected to a BBS at present.  When we make a connection in a few
  524.      minutes, you will see text from the BBS here, and will also type things
  525.      back to the BBS from here.
  526.  
  527.      Note the 'status bar' at the bottom of the screen.  This bar gives you
  528.      quick information about the Terminal, such as whether you're connected,
  529.      and if so who you are connected to and how long you've been connected, or
  530.      "Offline" if you are not connected.  It shows which "mode" Intellicomm is
  531.      in, either Manual, or Auto, or Script.  Auto and Script are both automatic
  532.      modes, while Manual is... well, manual mode.
  533.  
  534.      The port settings are next, baud rate, parity, data bits, stop bits.  The
  535.      capture status is next.  "Capture off" means that the capture file is
  536.      closed, while if a filename is displayed there, such as ICOM.CAP, then the
  537.      capture file is 'open', or is writing each line that is displayed on the
  538.      screen right into the file.  This way you can review a session with a BBS
  539.      after you hang up, by browsing the capture file, and catch anything you
  540.      missed.
  541.  
  542.      Alt-Z (or the right mouse button) is what you should press if you forget
  543.      any of Intellicomm's terminal keys.  Note that the F1 key also works here
  544.      if you wish to exit the Terminal to another area.  Since you don't know
  545.      any of Intellicomm's terminal keys as yet, Alt-Z will probably be used
  546.      frequently.
  547.  
  548.      Press Alt-Z now and browse through the different menus using the cursor
  549.      keys or your mouse, noting that each command has a key combination
  550.      displayed beside it.  These key combinations are how you select the
  551.      command directly from the Terminal, without pressing Alt-Z and using the
  552.      menu.  For example, if you want to open/close/pause the capture file, you
  553.      can press Alt-L directly from the Terminal.
  554.  
  555.      That's it for our initial tour of the Terminal.  If you require more
  556.      information, please refer to the main User's Manual later.  Open the eXit
  557.      menu by pressing 'X', then press 'D' to exit the Terminal and move to the
  558.      BBS Directory.
  559.  
  560.      BBS DIRECTORY/BIF FILES
  561.  
  562.  
  563.  
  564.  
  565.      Intellicomm v0.94               Quick Start                             10
  566.      
  567.      
  568.  
  569.      The BBS Directory is used to Tag/Dial BBS's when placing calls for manual
  570.      sessions, and to set up the various information for each BBS, such as
  571.      phone numbers, and your name and password.
  572.  
  573.      The first thing we'll do from here is to look at and set up a "template"
  574.      (the entries with square brackets around their descriptions are templates)
  575.      with the proper information.  These template entries are not to be dialed,
  576.      as they do not contain any phone numbers.  They are used like partially
  577.      filled out forms, to serve as a starting point for setting up for a new
  578.      BBS.  Hilight one of the templates you're interested in (i.e. if you have
  579.      a phone number for a BBS of a particular type, such as a PCBoard BBS), and
  580.      press 'E' to Edit/view it.
  581.  
  582.      After the information is loaded from disk, the BBS Notes are automatically
  583.      displayed for viewing/editing, if any notes exist (if you see BIF Editor
  584.      on the top line, no notes existed).  The notes give you specific
  585.      information on setting up the BBS for use with Intellicomm, etc.  Press
  586.      Esc to exit the notes when ready.
  587.  
  588.      Next you will enter the BBS Information File Editor, or BIF Editor for
  589.      short.  BIFs are organized into five different sections or screens, as you
  590.      can see on the bottom menu, and they contain the "map" of the BBS that
  591.      Intellicomm needs to automate various tasks.  With BIF templates only a
  592.      few items must be changed, as these templates have already been almost
  593.      fully set up.  Only information which is specific to you (your name, for
  594.      example) must be changed.
  595.  
  596.      BIF templates are identified by a square bracket ([) starting the
  597.      "BBS/Host Name" item, and they are different from other BIFs in that they
  598.      never contain specific phone numbers, port settings or other BBS-specific
  599.      items; since templates are used as starting point to set up for EVERY BBS
  600.      of a given type (i.e. whenever you require a new BIF for a PCBoard-type
  601.      BBS you start with the PCBoard BIF template).  Thus, certain BBS-specific
  602.      items are never saved to disk in templates, whether you enter the
  603.      information in the BIF Editor or not.  The excluded items include Phone
  604.      Numbers, Port Settings, Last Connected (date), Total Connects, and
  605.      Password Answer (Logon screen).  Each of these items will change from BBS
  606.      to BBS and thus it would be useless to save them in BIF templates.
  607.  
  608.      The fastest way to set up any BIF or template is to give a quick browse to
  609.      each screen, double-checking the items with an arrow (>) following the
  610.      item's description.  If you don't know what an item is/does, move the
  611.      hilight bar to it (press TAB to change columns) and read the description
  612.      on the help line, or select it for Editing and see if you get another menu
  613.      to clear things up.
  614.  
  615.      You can move directly to a specific screen by selecting it from the bottom
  616.      menu, or just page through each screen using PgUp/PgDn.  Please press PgDn
  617.      now to move to the Logon screen.
  618.  
  619.      On this screen, hilight the "Logon Name" item, press 'E' to edit it, then
  620.      enter your name:
  621.  
  622.      +=| Logon/Global Commands |=============| Logon/Global Prompts |========+
  623.  
  624.  
  625.  
  626.  
  627.      Intellicomm v0.94               Quick Start                             11
  628.      
  629.      
  630.  
  631.      | Your Logon Name> Wayne Duff           Name . . . . . .                |
  632.                          
  633.      Note when you select "Edit" that the help in the box near the bottom
  634.      changes to give you specific information on entering your name.  I.e. you
  635.      may use ^ to specify control characters (^M = carriage return or Enter, ^[
  636.      is Esc, ~ causes a 1 second pause, @SCRIPTNAME runs a script, etc).  If
  637.      you must enter your first/last names separately on the BBS, you may do
  638.      this by specifying a carriage return after your first name: First^MLast,
  639.      or First^M~Last ... which may look funny, but it causes Enter to be
  640.      pressed then pauses for 1 second before entering your last name.
  641.  
  642.      If editing the Wildcat template, you must also enter your date of birth
  643.      and phone number in the two "External Extra" commands near the bottom. 
  644.      MMDDYY means month, day, year of birth, and 1235551234 would be replaced
  645.      with your area code and phone number (no hyphens or spaces).  This is how
  646.      Wildcat BBS's in North America ask for the information, when verifying it
  647.      occasionally.
  648.  
  649.      Page through the rest of the BIF template if you wish, to check the
  650.      various other items that have already been set up for you.  Select 'X' or
  651.      press Esc to exit when ready, then press Enter when asked for a filename
  652.      to re-save the template using the same filename.  You will return to the
  653.      BBS Directory after the BIF information is saved to disk.
  654.  
  655.      CALLING A BBS
  656.  
  657.      If you have a phone number for a BBS handy, you're ready to start dialing. 
  658.      If you know the 'type' of the BBS for which you have a phone number,
  659.      hilight that BBS template using the cursor keys.  If you don't know the
  660.      BBS type, hilight "Blank Template".  With the proper template hilighted,
  661.      select "Create".
  662.  
  663.      If any notes exist for the BBS, they are automatically displayed each time
  664.      you Create/Edit a BIF, until you connect to the BBS (normally you will
  665.      only see the notes once, when you first Create the BIF and enter the phone
  666.      numbers).  Once you connect the notes will not be automatically displayed
  667.      again.  Make sure you heed the information presented in the notes, or you
  668.      will surely run into automation problems later.  Press Esc to exit notes.
  669.  
  670.      The first step in setting up a newly Created BIF is to enter a description
  671.      of the BBS.  Since you are not creating a new BIF Template, you shouldn't
  672.      enter square brackets around the description.  What you enter here in the
  673.      BBS/Host Name item will be displayed later in the BBS Directory.
  674.  
  675.      Next, enter up to 5 telephone numbers where indicated.  Most Hayes
  676.      compatible modems don't care whether you use 555-1234, or 5551234, so it's
  677.      up to you.  If you know the highest baud rate of the BBS, set the "Port
  678.      Settings" to the highest speed supported by both your modem AND the BBS. 
  679.      If you don't know the proper baud rate, just leave it at the default for
  680.      now.  Nothing further should need changing on this screen.
  681.  
  682.      Next, press PgDn and check whether the Password Answer entry displays
  683.      <Confidential> or <NO PASSWORD>.  If it displays <Confidential>, Edit the
  684.      item and REMOVE the password.  Intellicomm will attempt to perform an
  685.  
  686.  
  687.  
  688.  
  689.      Intellicomm v0.94               Quick Start                             12
  690.      
  691.      
  692.  
  693.      automatic logon if a password is defined and in all likelihood you do not
  694.      want that at this point.  Take it one step at a time and get connected
  695.      manually first.  Once you're familiar with the BBS, and become more
  696.      comfortable with the various BIF "Logon" items and are reasonably
  697.      confident that they're set up properly for the BBS, you may enter a
  698.      password and have Intellicomm perform automated logons/sessions.
  699.  
  700.      As usual, press eXit to exit (Esc also normally eXits if you prefer that
  701.      key), then think up a suitable filename to save the BIF under.  Filenames
  702.      are left up to you so that you have direct access to the BIF file itself
  703.      and can distribute it to others if need be.  I.e. if you get a BIF working
  704.      for a given BBS, you may want to upload the file for others to use.  Your
  705.      password data is always stored separately from the BIF, so you needn't
  706.      worry about hiding your password when distributing .BIF files.  (Please do
  707.      not distribute a BIF to a BBS until you've used it for at least a couple
  708.      of weeks with no problems and have tested ALL areas of automation possible
  709.      on the BBS.  Uploading a BIF that is not properly set up/tested will do
  710.      more harm than good).
  711.  
  712.      IMPORTANT:  Once you save a BIF under a certain filename, you should never
  713.      rename the file directly from DOS or you will lose your password.  To give
  714.      a .BIF another name you may "Edit" it, then just enter a new filename when
  715.      you exit.  The old .BIF may then be safely deleted.  If you don't
  716.      understand, simply avoid renaming your .BIF files from DOS and you'll
  717.      never have to worry about it.
  718.  
  719.      Now, hilight the newly Created entry, and press 'D' to Dial.  You may
  720.      cancel dialing at any time by pressing Esc or 'X' for eXit, as usual.
  721.  
  722.      Once you connect to the BBS, use ALT-1 to enter your name when the BBS
  723.      asks for it (a terminal feature types the name set up in the BIF when ALT-
  724.      1 is pressed).  Note that if you make a mistake entering a command to the
  725.      BBS, you may call up the Keystroke Buffer, re-edit the command, then re-
  726.      send it to the BBS.  Press Alt-K to call up the Keystroke Buffer for a
  727.      quick look.  You just hilight the command you want to re-send, edit it
  728.      using the usual editing keys, then press Alt-S and Intellicomm will re-
  729.      type the full line for you.  If you want to re-enter an entire sequence of
  730.      commands you may hilight the starting point then press Alt-D and all lines
  731.      from the hilight down will be resent (ENTER is sent after each line).
  732.  
  733.      Once you get fully logged on, press ALT-B to enter the "scrollback
  734.      buffer".  This buffer is used to view text that has previously scrolled
  735.      off the screen, and for many other useful things.  The usual cursor keys
  736.      are used to move the cursor around and page through the scrollback text. 
  737.      Check the first few lines of the scrollback text, just after you connected
  738.      to the BBS, and it should tell you which TYPE of software is running at
  739.      the BBS (i.e. PCBoard, RBBS, Wildcat, etc).  Take note of the BBS type,
  740.      and don't worry if you accidentally chose the wrong type when setting up
  741.      the BIF; you can change the type of BBS very easily.
  742.  
  743.      A "block" of text can be marked by holding down a shift key while using
  744.      the cursor keys, and once a block is marked you may print it, save it to
  745.      disk or paste it into the Keystroke Buffer to later re-send to the BBS. 
  746.      Blocks may also be marked by pressing ALT-B then moving the cursor without
  747.  
  748.  
  749.  
  750.  
  751.      Intellicomm v0.94               Quick Start                             13
  752.      
  753.      
  754.  
  755.      holding down the shift keys; use whichever you prefer.  With a mouse,
  756.      blocks are marked by clicking (not holding down) the left mouse button,
  757.      moving the mouse to mark the block, then pressing the right button to call
  758.      up the menu to do what you like with the marked block (or click the left
  759.      button again to cancel the block).  Mark a block now, then press ALT-Z or
  760.      the right mouse button for the menu and you'll see both what you can do
  761.      with blocks, and what key-combinations accomplish the task without using
  762.      the menu.
  763.  
  764.      When pasting to the Keystroke Buffer, you may have it paste the block and
  765.      add ENTER after the blocked text, or add a SPACE after the blocked text.
  766.      If you are familiar with BBS "batch" transfers, and how filenames are
  767.      usually entered separated by spaces, you will see the purpose of the
  768.      latter.  The intended purpose of pasting blocks from the Scrollback to
  769.      Keystroke buffer is to allow you to request listings of files from the BBS
  770.      (a file search, or what have you), then enter the Scrollback Buffer to
  771.      view the files and paste certain filenames into the Keystroke Buffer for
  772.      later entry to the BBS (it saves writing them down).  If a SPACE is added
  773.      after each paste, the filenames pasted will end up on the SAME line of the
  774.      Keystroke Buffer, each separated by a space... from the BBS you then
  775.      request a batch transfer and dump the line of filenames.
  776.  
  777.      Select "Exit Editor" to exit the scrollback editor from the Alt-Z menu, or
  778.      just press Esc from outside the menu, and you will return to the Terminal.
  779.  
  780.      CHECKING THE BBS FOR A PRE-DEFINED BIF
  781.  
  782.      The first thing to check when you log onto a new BBS that you want to
  783.      automate is whether the Sysop or someone else (or Liberation Enterprises)
  784.      has set up a BBS Information File for that particular BBS.  If so, much of
  785.      the work is done and you are very close to full automation.  File
  786.      downloading techniques/commands vary from BBS to BBS, but normally you
  787.      must access the File Menu (if there is one), then enter D for download,
  788.      then to get the pre-defined BIF, enter the filename ICOMBIF.ZIP.  When
  789.      asked for a protocol, select "Zmodem" if available, and the file should
  790.      transfer automatically: if Zmodem isn't available select Ymodem, Xmodem-
  791.      1K, or regular Xmodem as available, then press PgDn and pick the same
  792.      protocol on the Intellicomm file menu (Enter ICOMBIF.ZIP if asked for a
  793.      filename).  Then follow these short instructions to install the BIF once
  794.      disconnected:
  795.       
  796.        1) Uncompress the file (PKUNZIP ICOMBIF.ZIP from DOS) and view any
  797.           instructions in a README file (TYPE README.TXT, etc).  The README
  798.           file may contain special installation instructions that should be
  799.           used instead of these instructions.
  800.        2) Type "COPY <name>.BIF \ICOM\BIF" from DOS (no quotes) to copy it into
  801.           your BIF directory -- <name> being the BIF name, and \ICOM\BIF being
  802.           your BIF directory.
  803.        3) Enter Icom's BBS Directory and select "Read" to read the new BIF into
  804.           your directory.
  805.        4) "Edit" the BIF to enter the proper port settings and your name/
  806.           password on the Logon screen.  That's it!  If the BIF was set up
  807.           properly you should be ready to set up "Jobs" to run from the Job
  808.           Directory.  This is as easy as selecting "Create" from the Job
  809.  
  810.  
  811.  
  812.  
  813.      Intellicomm v0.94               Quick Start                             14
  814.      
  815.      
  816.  
  817.           Directory, hilighting/selecting the proper BIF, then typing in the
  818.           numbers of the jobs you want to automate...  Believe it or not, it
  819.           can be that simple with a properly defined BIF.
  820.  
  821.      If the BBS notes told you to turn [X]pert mode on, or to turn BBS hotkeys
  822.      on, etc., now is a good time to do it.  You may then disconnect, and will
  823.      be automatically returned to the BBS Directory when the connection breaks.
  824.  
  825.      Next, "Edit" the BIF again so we may demonstrate one more useful item
  826.      before leaving you to experiment for a while on your own.  If you earlier
  827.      set up the BIF using the "Blank Template" or chose the wrong BBS type, you
  828.      will be happy to know that all you need to do to remedy the situation is
  829.      to select "Merge" from the bottom menu, then hilight the proper template
  830.      from the menu and Select it.  This will cause the BIF Template to be
  831.      merged with the current BIF, thus resetting all the prompts/commands and
  832.      most other items to the settings from the template.  Items that are
  833.      protected during Merges are BBS/Host Name, Phone Numbers/Port Settings,
  834.      your Password, and your Logon Name (if the logon name was blank in the
  835.      current BIF, it will be replaced with the name from the template though). 
  836.      Thus you will never lose these items in a Merge, but all others will be
  837.      overwritten with the template data.
  838.  
  839.      If you're feeling energetic, you may want to enter your BBS password in
  840.      the BIF now, eXit re-save it and try an auto-logon (just use Dial again to
  841.      have it dial/auto-logon... the password itself is the key that triggers
  842.      auto-logon attempts).  A successful auto-logon is your next goal if you
  843.      intend to use Intellicomm for automated sessions.
  844.  
  845.      Auto-logon or even automation problems are usually quite easy to fix, and
  846.      normally result from the fact that the BBS Operator changed the format of
  847.      a given question or message, causing Intellicomm to ignore it as it does
  848.      any other regular text.  Just make a note of the prompt/question that it
  849.      got stuck at, "Edit" the BIF, and enter the question as is showed up on
  850.      the BBS (make sure that you don't use text that commonly shows up
  851.      elsewhere; i.e. "password" usually works well as the password prompt to
  852.      cause Intellicomm to enter your password -- but that word may also show up
  853.      in various other places such as logon news, bulletins, or even on the main
  854.      menu, so make sure you use some punctuation ("Password?", or "Password:")
  855.      where possible).  Make sure you define enough of the prompt so that
  856.      Intellicomm won't confuse it with other text from the BBS, and of course
  857.      avoid text that changes such as the time of day or how long you've been
  858.      connected for (yes, it has been attempted).
  859.  
  860.      The EXAMPLES.DOC file, included with Intellicomm, contains example setups
  861.      for MegaMail/Qmail-type door automation, and explains how to set up for
  862.      automated file downloads.  If you're interested in either of these, please
  863.      refer to this document at your next opportunity.  ICOM.DOC can be explored
  864.      at your leisure, whenever you require specific information on a given item
  865.      or area of the program (each section discusses a different area; you
  866.      needn't sit down and read the entire manual like a book).  Help with full
  867.      automation and many other useful tips, techniques and tidbits are
  868.      presented in the main documentation.
  869.  
  870.      The time spent learning the program will more than pay itself back with
  871.  
  872.  
  873.  
  874.  
  875.      Intellicomm v0.94               Quick Start                             15
  876.      
  877.      
  878.  
  879.      unattended use -- learn it once, then sit back and enjoy the benefits! 
  880.