home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 3 Comm / 03-Comm.zip / FORBROWS.ZIP / FORBREAD.ME < prev    next >
Text File  |  1992-09-17  |  10KB  |  245 lines
  1.  
  2.  
  3.  
  4. INTRODUCTION
  5. ____________
  6.  
  7. ForBrows is an offline computer conferencing tool, designed to work with
  8. IBM's OS/2 Bulletin Board System (OS2BBS).  ForBrows can assist you in down-
  9. loading, reading, and posting your own conference items.
  10.  
  11.  
  12. ABOUT ELECTRONIC CONFERENCING ON IBM'S OS2BBS
  13. _____________________________________________
  14.  
  15. IBM's OS2BBS conference consists of a number of files called "forums".  Each
  16. forum file consists of a "header", which explains the topic of the forum,
  17. followed by a varying number of entries called "appends".  An "append" is
  18. simply a note that has been appended to the forum file.  Each append will
  19. contain a subject line, and perhaps a reference to an earlier append.
  20.  
  21. The discussion in a forum generally centers around a specific topic.  The
  22. name of a forum usually provides a good hint about the topic being discussed.
  23. For example, the forum file called OS2GAMES.CFO contains a number of appends
  24. from different contributors, discussing various computer games that run under
  25. OS/2.
  26.  
  27.  
  28. USING FORBROWS FOR THE FIRST TIME
  29.  
  30. The first time you run FORBROWS.EXE, it will prompt you for information about
  31. where to save downloaded forums, where to create append files, etc.  In
  32. general, you will probably want to accept the suggested defaults.  The
  33. on-line help can be used for for more details about the initial ForBrows
  34. prompts.
  35.  
  36. TECHNICAL NOTE - It's important that the subdirectory name for downloaded
  37. OS2BBS forum files end in "\OS2BBS".  The final subdirectory name is used by
  38. ForBrows to figure out where any uploaded appends are to be sent.   If
  39. "\OS2BBS" is not used as the forum directory, then there is a table entry in
  40. FORBROWS.CTL which must be changed.  (See the HOSTSERVER= statements in
  41. FORBROWS.CTL for further details, if needed).
  42.  
  43. After ForBrows has finished prompting for default information, you will see
  44. the main ForBrows window.  Since you have not yet downloaded any forums for
  45. off-line viewing, the main window will be empty.  To download forum files for
  46. off-line viewing, begin by using PMHPO or the OS/2 communications manager to
  47. log-on to the IBM OS2BBS host system.  Then follow the instructions in the
  48. next section.
  49.  
  50.  
  51. DOWNLOADING FORUM FILES FOR THE FIRST TIME
  52.  
  53. 1.  Log-on to the IBM OS2BBS system using PMHPO or the OS/2 Communications
  54.     Manager.
  55.  
  56. 2.  Make sure you are on the IBMLink Main Menu screen within the PMHPO or
  57.     CommMgr window.
  58.  
  59. 3.  After you have logged-on successfully, switch back to the ForBrows
  60.     window, click on the "Conference" menu, and then select "Download fora or
  61.     files from host".  This will cause ForBrows to start the FORADOWN.EXE
  62.     program for you.
  63.  
  64. 4.  In the ForaDown window, click on the "List" button.  This will start a
  65.     sequence of interactions between ForaDown and the host OS2BBS system.
  66.     The end result will be that a list of available "forum" files will be
  67.     downloaded and displayed in the ForaDown list-box.  This step (because of
  68.     the download time) may take a couple of minutes, depending on the line
  69.     speed of your host connection.
  70.  
  71. 5.  After the download completes, you will see a list of available "forum"
  72.     files, each with the comment "Not yet Downloaded..."  beside it.  The
  73.     names of the forum suggest the topics that are discussed within them.
  74.     You may select items to download by clicking mouse button 1 on an item.
  75.     One or more items may be selected.
  76.  
  77. 6.  After selecting items, click on the "Download" button.  This will start
  78.     another sequence of interactions between ForaDown and the OS2BBS system.
  79.     As part of this step, each of the selected files will be downloaded to
  80.     your disk.  Because of the size of the forum files (some are quite large)
  81.     each download may take from a few minutes up to about 30 minutes.  The
  82.     time will vary depending on the size of the forum file, and the line
  83.     speed of your host connection.
  84.  
  85. 7.  Each time you log-on to the VM host system, you may want to perform
  86.     another "List".  This will provide ForaDown with new information about
  87.     which forum files have changed.  ForaBrows keeps some information about
  88.     each of the files you have downloaded.  The next time you download a
  89.     forum that you had downloaded earlier, ForaDown will attempt to download
  90.     only the updates to the forum, rather than the entire file.  The updates
  91.     are then merged with your existing copy.
  92.  
  93.  
  94. VIEWING DOWNLOADED FORUM FILES
  95.  
  96. After ForaDown has completed downloading the first forum, you may view it as
  97. follows:
  98.  
  99. o   Switch to the ForBrows window.
  100.  
  101. o   Under the "Conference" menu, select "List available fora...".
  102.  
  103. o   A file-list dialog will be displayed.  If your defaults were set up cor-
  104.     rectly, it should list the contents of the \OS2BBS subdirectory.
  105.  
  106. o   Click mouse button 1 over the name of the forum you wish to view.
  107.  
  108. o   Click on the "View" button.
  109.  
  110. o   The forum will be loaded into the ForBrows window for viewing.
  111.  
  112.  
  113.  
  114. ForBrows contains a row of buttons at the bottom of the window to assist in
  115. following subjects or references forward and backward, as well as going to
  116. the next or previous append.  For more information about ForBrows capabili-
  117. ties, please see the on-line help.
  118.  
  119.  
  120. REGISTERING A FORUM
  121.  
  122. After viewing a forum for the first time, ForBrows will ask you if you wish
  123. to add the forum to your profile.  If you click on "Yes", ForBrows will "reg-
  124. ister" the forum.  This means that the each time you view the forum, ForBrows
  125. will remember the last append that you viewed.  The next time a registered
  126. forum is browsed, ForBrows will try to display the next un-viewed append.
  127.  
  128. You may display the list of registered fora by selecting "List registered
  129. fora..." under the "Conference" menu.
  130.  
  131.  
  132. CREATING AN APPEND OFF-LINE
  133.  
  134. ForBrows makes it easy to create your own appends off-line, and to upload and
  135. post them later to the IBM OS2BBS host system.  To create a forum append:
  136.  
  137. o   While viewing the forum you wish to append to, click on the "Create
  138.     append for current forum..." selection under the "Conference" menu.
  139.  
  140. o   ForBrows will build a "skeleton" append, and then invoke an editor to
  141.     allow you to enter append text.
  142.  
  143. o   The skeleton append will contain the same subject line as the append you
  144.     were viewing.  The Ref: (reference) line will refer to the append you
  145.     were viewing.  If necessary, you may change the content of the Subject
  146.     and Ref lines.
  147.  
  148. o   The third line of the skeleton will be the "Append:" line.  Do not change
  149.     this line in any way; it contains important information that will be used
  150.     later when uploading and posting the append.  If altered incorrectly,
  151.     your append will be rejected by the OS2BBS host.
  152.  
  153. o   Enter any text you wish to append to the forum, then save the append
  154.     file.
  155.  
  156.  
  157. POSTING AN APPEND TO THE OS2BBS HOST
  158.  
  159. To upload the appends that you have created off-line, and post them to OS2BBS
  160. host, you must do the following:
  161.  
  162. 1.  Log-on to the IBM OS2BBS system using PMHPO or the OS/2 Communications
  163.     Manager.
  164.  
  165. 2.  Make sure you are on the IBMLink Main Menu screen within the PMHPO or
  166.     CommMgr window.
  167.  
  168. 3.  After you have logged-on successfully, switch back to the ForBrows
  169.     window, click on the "Conference" menu, and then select "Send appends to
  170.     host".  This will cause ForBrows to start the FORAUP.EXE program for you.
  171.  
  172. 4.  ForaUp will display a dialog window and list the contents of your append
  173.     subdirectory.  Your append files will have filenames based upon the date
  174.     and time they were created.
  175.  
  176. 5.  Select any appends you wish to post by clicking mouse button 1 over the
  177.     append name.
  178.  
  179. 6.  Click on the "Send" button.  This will start a series of interactions
  180.     with the OS2BBS host system; each selected append will be uploaded to the
  181.     host, and a host command will be issued to post the uploaded append to
  182.     the OS2BBS copy of the forum.
  183.  
  184. On-line help is available that explains ForaUp use in greater detail.
  185.  
  186.  
  187. A PARTIAL LIST OF FORUM FILES AVAILABLE FOR DOWNLOADING
  188.  
  189.     C-SET2.CFO - discusses the IBM C-SET2 compiler
  190.  
  191.     E-EDITOR.CFO - discusses the enhanced editor that comes with OS/2
  192.  
  193.     FORBROWS.CFO - discusses FORBROWS
  194.  
  195.     ISTHERE.CFO - discusses "Is there a product that..."
  196.  
  197.     MINIAPPS.CFO - discusses the mini-applications that come with OS/2
  198.  
  199.     NETWARE.CFO - discusses Novell NetWare for OS/2
  200.  
  201.     NEW2OS2.CFO - a beginner forum for new OS/2 users or programmers
  202.  
  203.     OS2APPS.CFO - for the discussion of application programs and systems
  204.     designed for OS/2.
  205.  
  206.     OS2BASE.CFO - discusses the OS/2 base operating system commands and func-
  207.     tions
  208.  
  209.     OS2BBS.CFO- discusses the OS/2 Bulletin Board System
  210.  
  211.     OS2CM.CFO - discusses the IBM Extended Services (ES) Communications
  212.     Manager
  213.  
  214.     OS2DBM.CFO - discusses the IBM Extended Services (ES) Database Manager
  215.  
  216.     OS2DOS.CFO - discusses OS/2 virtual Dos Machine (VDM) support
  217.  
  218.     OS2INST.CFO - discusses OS/2 installation
  219.  
  220.     OS2LAN.CFO - discusses the IBM LAN Server/Reqester (LS) for OS/2
  221.  
  222.     OS2MISC.CFO - OS/2 general question and answer, miscellaneous topics
  223.  
  224.     OS2PMPGM.CFO - discusses OS/2 Presentation Manager programming
  225.  
  226.     OS2PRG.CFO - discusses OS/2 base programming and system routines
  227.  
  228.     OS2PRINT.CFO - discusses OS/2 printing, print control, drivers, spooling,
  229.     etc.
  230.  
  231.     OS2QANDA.CFO - a forum for general OS/2 questions and answers
  232.  
  233.     OS2REXX.CFO - discusses the REXX language for OS/2
  234.  
  235.     OS2TCPIP.CFO - discusses IBM's OS/2 TCP/IP
  236.  
  237.     OS2TLKIT.CFO - discusses the OS/2 developer's toolkit
  238.  
  239.     OS2WIN.CFO - discusses OS/2 Windows support and programming
  240.  
  241.     OS2WPS.CFO - discusses the OS/2 2.0 Workplace Shell
  242.  
  243.     TESTER.CFO - a place for test appends
  244.  
  245.