home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 3 Comm / 03-Comm.zip / FORBROWS.ZIP / FORBROWS.HLP (.txt) < prev    next >
OS/2 Help File  |  1992-08-14  |  21KB  |  736 lines

  1.  
  2. ΓòÉΓòÉΓòÉ 1. Description, Installation, Start-up ΓòÉΓòÉΓòÉ
  3.  
  4. ForBrows - An OS/2 Electronic Conferencing Tool 
  5.  
  6. ForBrows lets you view electronic conferences that exist on a local disk drive, 
  7. or conferences on a LAN disk.  An electronic conference consists of one or more 
  8. "forums", where each forum is a file that containing "appends" from 
  9. contributors discussing a particular subject. 
  10.  
  11. ForBrows provides functions to assist in navigating appends, following 
  12. particular subjects within a forum, following references, remembering the last 
  13. viewed append within a forum, creating appends, etc. 
  14.  
  15. ForBrows evolved during an 18 month period at IBM's T.J. Watson Research 
  16. Center, as part of the Research Division's CORE project. ForBrows components 
  17. were developed by Laurent Esnault, Tom Rogers, and David Slauson. 
  18.  
  19. See Also: ForBrows Installation,  Starting ForBrows 
  20.  
  21.  
  22. ΓòÉΓòÉΓòÉ 1.1. ForBrows Installation ΓòÉΓòÉΓòÉ
  23.  
  24. All of the files that are distributed as part of the FORBROWS package should be 
  25. installed into a single subdirectory on your disk. 
  26.  
  27. To use ForBrowse, you will need the following files: 
  28.  
  29.  o FORBROWS.EXE - the forum browser 
  30.  o FORADOWN.EXE - the download program 
  31.  o FORAUP.EXE  - the append upload program 
  32.  o FORBROWS.HLP - the online help file for ForBrows 
  33.  o FORADOWN.HLP - the online help file for ForaDown 
  34.  o PMSDTDLG.DLL  - contains "open-file" dialog 
  35.  o STORMGR.DLL  - used by "open-file" dialog 
  36.  o FORBROWS.CTL file - contains information about the host BBS system, etc. 
  37.  o FORBROWS.INI - information about previously viewed fora.  FORBROWS will 
  38.    create this file for you. 
  39.  o Access to a Fora fileserver, or subdirectories containing fora files. 
  40.  
  41.  The DLL files will need to be placed within a subdirectory named in the 
  42.  LIBPATH= statement of your CONFIG.SYS. 
  43.  
  44.  Subdirectories for FORUM files 
  45.  
  46.  If you wish to create appends, you will need to keep your fora files in a disk 
  47.  or LAN subdirectory that has the same name as the IBM conference disk that you 
  48.  will be appending to.  For example, FORBROWS FORUM is contained on IBM's IBMPC 
  49.  conference disk (as are most other PC-related fora).  To append to FORBROWS 
  50.  FORUM, you will need to have a fora subdir called \IBMPC. 
  51.  
  52.  Technical Note If you wish to use ForBrows's built-in functions for sending 
  53.  appends to the IBM host, you will need the EHLLAPI components of the OS/2 
  54.  Communications Manager or PMHPO.  EHLLAPI is an Applications Programming 
  55.  Interface for controlling 3270 emulator sessions.  EHLLAPI requires the 
  56.  following DLL files under the Communications Manager; ACS3EHAP, ACSGCBLD, 
  57.  ACSSVC, ACS3ELKE, ACS3ECT, RPSMAIN, RNLCHARS. If using PMHPO, you will need 
  58.  TAPHLL32.DLL for the EHLLAPI support. 
  59.  
  60.  
  61. ΓòÉΓòÉΓòÉ 1.2. Starting ForBrows ΓòÉΓòÉΓòÉ
  62.  
  63. To start ForBrowse, type 
  64.  
  65.  
  66.   FORBROWS <d:\pathname\>
  67.  
  68.  
  69.   Example:  FORBROWS C:\IBMPC\
  70.  
  71. at the OS/2 command prompt in a directory that contains both FORBROWS.EXE and 
  72. FORBROWS.CTL. 
  73.  
  74. If you start ForBrows with the optional parameter, d:\pathname\, then ForBrows 
  75. will display the new file dialog upon startup, and list all of the files in the 
  76. \pathname\ subdirectory. 
  77.  
  78. Note that the this optional parameter requires the trailing '\' after the 
  79. pathname in order to be handled properly. 
  80.  
  81.  
  82. ΓòÉΓòÉΓòÉ 2. ForBrows Main Window ΓòÉΓòÉΓòÉ
  83.  
  84. The main window contains a menu bar along the top, a client area for viewing 
  85. forum text, scroll bars, navigation buttons, and a message line at the bottom 
  86. of the window. 
  87.  
  88. See Also Navigation Buttons, Marking Text, Hyper-Link Searching. 
  89.  
  90.  
  91. ΓòÉΓòÉΓòÉ 2.1. Navigation Buttons ΓòÉΓòÉΓòÉ
  92.  
  93. ForBrows has the following navigation buttons near the bottom of the main 
  94. window; 
  95.  
  96.  Sub<- scroll back to previous append with the same Subject line. 
  97.  
  98.  sub-> scroll forward to next append with the same Subject line. 
  99.  
  100.  Ref<- scroll back to previous append indicated in the Ref line. 
  101.  
  102.  ref-> scroll forward to referencing append. 
  103.  
  104.  App<- scroll back to previous append. 
  105.  
  106.  app-> scroll forward to next append. 
  107.  
  108.  See Also Accelerator Keys. 
  109.  
  110.  
  111. ΓòÉΓòÉΓòÉ 2.2. Marking Text ΓòÉΓòÉΓòÉ
  112.  
  113. Forum text in the main window can be marked by clicking and holding Mouse 
  114. Button 1, and then dragging the mouse down over the lines you wish to mark. 
  115. After text has been marked, it can be copied to the clipboard, or used as a 
  116. bookmark (ie. you can quickly jump to the marked text later on while viewing 
  117. the same forum). 
  118.  
  119. Usage Notes ForBrows can only mark entire lines of text. ForBrows only marks 
  120. one block of lines at a time;  If you mark a new set of lines, any previously 
  121. marked lines are unmarked. You may also un-mark any previously marked lines by 
  122. clicking button 2 anywhere over the text. 
  123.  
  124. The Bookmark List 
  125.  
  126. Even though ForBrows only keeps one actively marked block of text, the starting 
  127. location of the last 20 marked blocks is saved in ForBrows's "Bookmark" list. 
  128. If you find that you need to jump to an earlier marked block, you can use the 
  129. Go To Bookmark list function under the Navigation Menu. 
  130.  
  131. The bookmark list is automatically reset when you browse another forum. 
  132.  
  133.  
  134. ΓòÉΓòÉΓòÉ 2.3. Hyper-Link Searching ΓòÉΓòÉΓòÉ
  135.  
  136. ForBrows implements a kind of pseudo hyper-link capability. If you double-click 
  137. mouse button 2 over text in the main window, ForBrows will extract 30 
  138. characters, starting at the word you clicked-on, and place the characters in a 
  139. Search dialog. 
  140.  
  141. See Also Search Dialog. 
  142.  
  143.  
  144. ΓòÉΓòÉΓòÉ 3. Keys Help ΓòÉΓòÉΓòÉ
  145.  
  146. There are three kinds of ForBrows command keys: 
  147.  
  148.   1. The Function Keys 
  149.  
  150.   2. The Accelerator Keys 
  151.  
  152.   3. The Scrolling Keys 
  153.  
  154.  
  155. ΓòÉΓòÉΓòÉ 3.1. The Function Keys ΓòÉΓòÉΓòÉ
  156.  
  157.  Key     Action 
  158.  
  159.  F1      Displays on-line help. 
  160.  F3      Closes the window.  If it's the last window, ForBrowse is terminated. 
  161.  F4      Loads a new file in the same window. 
  162.  F5      Loads a new file in a new window. 
  163.  F6      Refresh the current forum, if a newer file is available. 
  164.  F9      Displays the list of available subjects. 
  165.  F10     Selects the menu bar. 
  166.  F11     Displays the list of registered fora. 
  167.  F12     Displays the list of available fora. 
  168.  
  169.  
  170. ΓòÉΓòÉΓòÉ 3.2. The Accelerator Keys ΓòÉΓòÉΓòÉ
  171.  
  172.  Key               Action 
  173.  
  174.  Enter             Goes to next append. 
  175.  Shift Enter       Goes to previous append. 
  176.  m                 Go to marked text 
  177.  Shift S           Goes back to previous append with the same subject. 
  178.  s                 Goes forward to the next append with the same subject. 
  179.  Shift R           Goes to back to the referenced append. 
  180.  r                 Goes forward to referencing append. 
  181.  /                 Search for text 
  182.  Control A         Append creation; reference currently-displayed append 
  183.  Control F         Repeats last search. 
  184.  Control L         Go to line number. 
  185.  Control M         Modify currently-displayed append 
  186.  Control N         Toggles the display of line numbers. 
  187.  Control O         Toggles the "One Append At a Time" mode. 
  188.  Control R         Refreshes the current forum (in the main window).  Or 
  189.                    refresh the list (in the registered fora dialog). 
  190.  Control S         Send Append(s) to host. 
  191.  Control Insert    Copies displayed append to the clipboard. 
  192.  
  193.  
  194. ΓòÉΓòÉΓòÉ 3.3. The Scrolling Keys ΓòÉΓòÉΓòÉ
  195.  
  196.  Key               Action 
  197.  
  198.  Arrow Keys        Scrolls one line or one char, vertically or horizontally. 
  199.  Page Up           Scrolls one page up.  When the "One Append At a Time Mode" 
  200.                    is selected and the last line is displayed, ForBrowse go to 
  201.                    the next append. 
  202.  Page Down         Scrolls one page Down.  When the "One Append At a Time Mode" 
  203.                    is selected and the first line is displayed, ForBrowse go to 
  204.                    the previous append. 
  205.  Home              Goes to the first line of the append if the "One Append At a 
  206.                    Time Mode" is selected. 
  207.                    Scrolls window to beginning of line, if not. 
  208.  End               Goes to the last line of the append if the "One Append At a 
  209.                    Time Mode" is selected. 
  210.                    Scrolls window to end of longest line, if not. 
  211.  Control Home      Goes to the first line, or append, of the file. 
  212.  Control End       Goes to the last line, or append, of the file. 
  213.  Space             Scrolls window to see the last found string. 
  214.  
  215.  
  216. ΓòÉΓòÉΓòÉ 4. File Menu ΓòÉΓòÉΓòÉ
  217.  
  218. The File Menu contains menu items that allow you to open (ie. load and view) a 
  219. new fora file, create a new ForBrows window, copy an append or marked text to 
  220. the clipboard, print an append or forum, or exit. 
  221.  
  222.  
  223. ΓòÉΓòÉΓòÉ 4.1. View another file ΓòÉΓòÉΓòÉ
  224.  
  225. The "View another file" file menu selection will display a dialog box entitled, 
  226. "Select File", that allows you to load and view a new forum file. 
  227.  
  228. Using the "Select File" dialog 
  229.  
  230. By default, the dialog lists all of the files in the current subdirectory.  You 
  231. can load any file in the list by double-clicking on the filename.  If you 
  232. double-click on a subdirectory name within the list, then the contents of that 
  233. subdirectory will be listed. 
  234.  
  235. The listboxes in the dialog can be used to change the drive, subdirectories, or 
  236. filespecs that are selected. 
  237.  
  238. If you wish, you may bypass using the list-box by filling in the "Open File" 
  239. entry field near the top of the dialog window and pressing Enter. 
  240.  
  241.  
  242. ΓòÉΓòÉΓòÉ 4.2. New Window... ΓòÉΓòÉΓòÉ
  243.  
  244. The "New Window..." menu selection will display a new instance of ForBrows, in 
  245. another window. 
  246.  
  247.  
  248. ΓòÉΓòÉΓòÉ 4.3. Copy Append... ΓòÉΓòÉΓòÉ
  249.  
  250. Copy Append will place the contents of the currently viewed append in the OS/2 
  251. clipboard. 
  252.  
  253.  
  254. ΓòÉΓòÉΓòÉ 4.4. Copy Marked Text... ΓòÉΓòÉΓòÉ
  255.  
  256. Copy Marked Text will place the contents of the most recently marked text in 
  257. the OS/2 clipboard.  Forum text can be marked by clicking and holding Mouse 
  258. Button 1, and then dragging the mouse down over the lines you wish to mark. 
  259.  
  260.  
  261. ΓòÉΓòÉΓòÉ 4.5. Print Append ΓòÉΓòÉΓòÉ
  262.  
  263. Copies the currently viewed append to a printer.  A dialog window will be 
  264. displayed to allow you to select which printer (LPTn) you wish to print to. 
  265.  
  266.  
  267. ΓòÉΓòÉΓòÉ 4.6. Print Forum ΓòÉΓòÉΓòÉ
  268.  
  269. Copies the currently viewed forum file to a printer.  A dialog window will be 
  270. displayed to allow you to select which printer (LPTn) you wish to print to. 
  271.  
  272. NOTE: a forum file can be quite large, and may take awhile to print. You will 
  273. usually find it better to print an append. 
  274.  
  275.  
  276. ΓòÉΓòÉΓòÉ 5. Search Menu ΓòÉΓòÉΓòÉ
  277.  
  278. The Search menu provides access to ForBrows's search functions.  You may search 
  279. for text within the forum that you are currently viewing, repeat a previous 
  280. search, or scroll directly to the last text that was found. 
  281.  
  282.  
  283. ΓòÉΓòÉΓòÉ 5.1. Find... ΓòÉΓòÉΓòÉ
  284.  
  285. When you select the "Find..." menu item, ForBrows will display the Search 
  286. dialog.  From the search dialog, you may specify the text that you wish to 
  287. locate. 
  288.  
  289. Using the Search Dialog 
  290.  
  291. Type the text that you wish to search for in the dialog's entry field.  After 
  292. you press Enter, or click on the "Find" button, ForBrows will attempt to locate 
  293. the text that you entered.  If the text is found, ForBrows will automatically 
  294. scroll to the append containing the found text.  The found text will be 
  295. highlighted using the color that was specified for marked text in the ForBrows 
  296. "Set Colors" dialog. 
  297.  
  298. The check-boxes within the Search dialog control whether or not the search is 
  299. case sensitive, is limited to the current append, or is to search backward from 
  300. the current position within the forum. 
  301.  
  302. Usage Note; The search begins at the currently displayed location within the 
  303. forum file.  If you wish to search the entire forum, press Ctrl-Home to scroll 
  304. to the beginning of the forum, and then request a search. 
  305.  
  306. See Also: Find Next,  Set Colors 
  307.  
  308.  
  309. ΓòÉΓòÉΓòÉ 5.2. Find Next ΓòÉΓòÉΓòÉ
  310.  
  311. If you have performed a text search, and wish to repeat the search without 
  312. re-entering the search argument, you may do so with Find Next. 
  313.  
  314. See Also: Find... 
  315.  
  316.  
  317. ΓòÉΓòÉΓòÉ 5.3. Scroll to Found Text ΓòÉΓòÉΓòÉ
  318.  
  319. If you have performed a text search, and have since scrolled forward within the 
  320. forum, you may return to previously found text by selecting "Scroll to Found 
  321. Text". 
  322.  
  323. See Also: Find... 
  324.  
  325.  
  326. ΓòÉΓòÉΓòÉ 6. Options Menu ΓòÉΓòÉΓòÉ
  327.  
  328. The options menu provides selections that control the way ForBrows operates. 
  329. Selections are provided for changing colors and fonts, scrolling behavior, 
  330. auto-refresh, message handling, and saving the settings. 
  331.  
  332.  
  333. ΓòÉΓòÉΓòÉ 6.1. Colors... ΓòÉΓòÉΓòÉ
  334.  
  335. The "Set Colors" dialog allows you to customize the colors that will be used 
  336. within the ForBrows window. Sample text is displayed that shows your 
  337. selections. You may set foreground and background colors for the following 
  338. ForBrows text types: 
  339.  
  340.  o Plain Text  - the forum text 
  341.  o Marked Text - text marked with the mouse or marked as the result of a text 
  342.    search. 
  343.  o Message Text - text displayed in ForBrows's message field 
  344.  o Append Header - the line that appears at the top of each append. 
  345.  
  346.  You may change colors by clicking on the dialog's color buttons. Select the 
  347.  text type by clicking on the type within the list.  To apply the color, press 
  348.  enter, or click on the Set button. 
  349.  
  350.  Making your color selections permanent:  select "Save Settings" from the 
  351.  "Options" menu.  Your current color settings will be saved in OS2.INI. 
  352.  
  353.  
  354. ΓòÉΓòÉΓòÉ 6.2. Fonts... ΓòÉΓòÉΓòÉ
  355.  
  356. The "Set Font" dialog allows you to specify the font name, size, and type (bold 
  357. italic, underscore). Sample text is displayed that shows your selections. 
  358.  
  359. Your font selection can be applied to the displayed text by pressing Enter, or 
  360. by clicking on the Set button. 
  361.  
  362. Making your font selections permanent:  select "Save Settings" from the 
  363. "Options" menu.  Your current font settings will be saved in OS2.INI. 
  364.  
  365.  
  366. ΓòÉΓòÉΓòÉ 6.3. Line Numbers ΓòÉΓòÉΓòÉ
  367.  
  368. Toggles the display of line numbers within the text that ForBrows displays. If 
  369. there is a check beside this menu item then line numbers will be displayed. 
  370.  
  371.  
  372. ΓòÉΓòÉΓòÉ 6.4. Beep on Messages ΓòÉΓòÉΓòÉ
  373.  
  374. Toggles beeping when a ForBrows message is issued.  Some people are annoyed by 
  375. beeping and may wish to turn it off. If there is a check beside this menu item 
  376. then beeping is on. 
  377.  
  378.  
  379. ΓòÉΓòÉΓòÉ 6.5. Hide the Message Line ΓòÉΓòÉΓòÉ
  380.  
  381. If you do not wish to see ForBrows status messages, then you may hide the 
  382. message line. If there is a check beside this menu item then the message line 
  383. will not be displayed. 
  384.  
  385.  
  386. ΓòÉΓòÉΓòÉ 6.6. Scrolling across Appends ΓòÉΓòÉΓòÉ
  387.  
  388. If selected, then the scrolling keys will cause ForBrows to display the 
  389. next/previous append if you attempt to scroll past the bottom or top of the 
  390. current append.  If not selected, you must explicitly select "Go to 
  391. next/previous append". If there is a check beside this menu item then scrolling 
  392. across appends is enabled. 
  393.  
  394.  
  395. ΓòÉΓòÉΓòÉ 6.7. New Forum on last Append ΓòÉΓòÉΓòÉ
  396.  
  397. When this option is selected then ForBrows will display a list of fora when you 
  398. scroll past the end of the last append of the current forum. 
  399.  
  400.  
  401. ΓòÉΓòÉΓòÉ 6.8. Set Profile File... ΓòÉΓòÉΓòÉ
  402.  
  403. ForBrows saves information in a file about your position within "registered" 
  404. fora.  You may specify the name and location of the file via this menu and its 
  405. associated dialog. 
  406.  
  407.  
  408. ΓòÉΓòÉΓòÉ 6.9. Set Installation Defaults... ΓòÉΓòÉΓòÉ
  409.  
  410. If you wish to use ForBrows to download fora and create and upload appends, you 
  411. will need to use this facility to specify your editor, and the subdirectories 
  412. that will hold your append and fora files.  This dialog contains the following 
  413. fields: 
  414.  
  415. Editor filespec 
  416.  
  417. For append creation and viewing, ForBrows has a built in mini-editor which is 
  418. similar to the OS/2 system editor. If you wish, you may specify another editor 
  419. in this field, in the form 
  420.  
  421.     d:\path\filename.exe 
  422.  
  423. However, for append creation, we currently recommend that you use FORBROWS's 
  424. built in mini-editor (the default), since it will do a better job of detecting 
  425. and cleaning up empty appends. 
  426.  
  427. Subdir for append files 
  428.  
  429. Enter the drive and path, in the form 
  430.  
  431.     d:\pathname 
  432.  
  433. The first time you use ForBrows, it will pre-fill this field with a recommended 
  434. name. If the subdirectory you specify does not exist, ForBrows will offer to 
  435. create it for you. 
  436.  
  437. Append signature text 
  438.  
  439. When you create an append, ForBrows will automatically create a "signature" 
  440. line, if you wish.  We recommend that in addition to your name, you consider 
  441. adding your organization name and location. For example, 
  442.  
  443. Jean-Luc Picard, USS Enterprise, Milky Way Galaxy 
  444.  
  445. However, you may want to be somewhat more specific than our example was about 
  446. the location. 
  447.  
  448. Subdir for downloaded fora files 
  449.  
  450. Enter the drive and path, in the form 
  451.  
  452.     d:\pathname 
  453.  
  454. The first time you use ForBrows, it will pre-fill this field with a recommended 
  455. name. If the subdirectory you specify does not exist, ForBrows will offer to 
  456. create it for you. 
  457.  
  458. How will you connect to the IBM host? 
  459.  
  460. Click on the appropriate button. If you are using a modem and dial-up 
  461. connection, you are probably using PM HPO.  If you are co-ax connected, you are 
  462. using Comm Mgr. This field is important, because it tells ForBrows which 
  463. communications component it must interface with during upload/download. 
  464.  
  465.  
  466. ΓòÉΓòÉΓòÉ 6.10. Save Settings ΓòÉΓòÉΓòÉ
  467.  
  468. Selecting this menu item tells ForBrows to save the current color, font, window 
  469. size, and window position.  The next time ForBrows is started, it will use the 
  470. saved settings. 
  471.  
  472. Settings are automatically saved upon exit from ForBrows. 
  473.  
  474.  
  475. ΓòÉΓòÉΓòÉ 7. Navigation Menu ΓòÉΓòÉΓòÉ
  476.  
  477. The navigation menu contains selections that control movement within a forum. 
  478. The following navigation functions are provided: 
  479.  
  480.  o Go to previous Append - scrolls to the append immediately before the 
  481.    currently displayed append. 
  482.  
  483.  o Go to Next Append - scrolls to the append immediately after the currently 
  484.    displayed append. 
  485.  
  486.  o Go to previous Reference - If the current append has a ref: line, go to the 
  487.    referenced append. 
  488.  
  489.  o Return to referencing append - If you've followed a previous reference, 
  490.    return to the referencing append that you started from. 
  491.  
  492.  o Follow subject backward - If the current append has a Subject: line, find 
  493.    the previous append (if any) that contains the same subject line. 
  494.  
  495.  o Follow subject forward - If the current append has a Subject: line, find the 
  496.    next append (if any) that contains the same subject line. 
  497.  
  498.  o Go to top of forum - go to the first append in forum... generally the forum 
  499.    header. 
  500.  
  501.  o go to bottom of forum - go to the last append in the forum. 
  502.  
  503.  o Go to list of subjects - display a list of all the subjects contained in 
  504.    this forum. 
  505.  
  506.  o Go to line number - go to a specific line number within the forum. 
  507.  
  508.  o Go to marked text - if you have previously marked a block of lines within 
  509.    this forum, go to the marked lines. See Also Marking Text. 
  510.  
  511.  o Go to Bookmark list - display a list of previously marked lines, in FIFO 
  512.    (First In, First Out) order. If no lines have been marked, no list will be 
  513.    displayed. 
  514.  
  515.  o Clear all Bookmarks - empty the Bookmark list. This does not clear the last 
  516.    marked block, only the bookmark list. 
  517.  
  518.  o Refresh current forum - if the forum has been updated since we began viewing 
  519.    it, load the new copy. 
  520.  
  521.  o View one append at a time - when selected, only one append's text is 
  522.    displayed.  If not selected, then the forum is simply displayed as a flat 
  523.    file. 
  524.  
  525.  
  526. ΓòÉΓòÉΓòÉ 8. Conference Menu ΓòÉΓòÉΓòÉ
  527.  
  528. The "Conference" menu selections provide access to the registered fora, as well 
  529. as functions for downloading forum files, and sending appends to the IBM 
  530. conferencing disk. 
  531.  
  532.  
  533. ΓòÉΓòÉΓòÉ 8.1. List Registered Fora ΓòÉΓòÉΓòÉ
  534.  
  535. ForBrows allows you to "register" forum files. Any time you view a registered 
  536. forum, ForBrows remembers the line number of the last append that you viewed. 
  537. The next time you view a registered forum, ForBrows will display the next 
  538. append that you have not yet seen. 
  539.  
  540. List of Registered Fora Dialog 
  541.  
  542. This dialog displays a list of all your registered forum files.  The list is 
  543. divided into three sections: 
  544.  
  545.  o Updated since Last Viewed - files that have changed since the last time you 
  546.    viewed them. 
  547.  
  548.  o Partially Viewed - forum files that you have begun to read, but you have not 
  549.    yet viewed the last append. 
  550.  
  551.  o Fully Viewed - you have viewed the last append in each of these files. 
  552.  
  553.  Double-clicking on any of the forum entries will cause ForBrows to load 
  554.  (browse) that forum file. Entries may also be selected via the cursor keys, 
  555.  and then loaded by pressing enter. 
  556.  
  557.  List Fields 
  558.  
  559.  Each entry in the list of registered fora contains the following fields (from 
  560.  left to right): 
  561.  
  562.  o View status - '>' means that you have not yet viewed the latest updates to 
  563.    the forum; '*' means that you have. If this left-most field is blank, the 
  564.    forum has not changed since you last viewed it. 
  565.  
  566.  o Forum - the filename of the forum.  The name usually conveys some idea of 
  567.    the subjects being discussed in the forum. 
  568.  
  569.  o Conference - the name of the conference in which the forum resides.  Under 
  570.    OS/2, this corresponds to the subdirectory in which the forum file is kept. 
  571.  
  572.  o Date - the date, in yy/mm/dd format, of the last update to the forum. 
  573.  
  574.  o Size - the size, in kilobytes, of the forum file. 
  575.  
  576.  o Size - the approximate size, in kilobytes, of the not-yet-viewed remainder 
  577.    of the forum. 
  578.  
  579.  Searching for Registered Fora 
  580.  
  581.  If your registered fora list gets long, you may want to search for a 
  582.  registered forum name, rather than scrolling through the list.  The "Search 
  583.  for Forum Name" field allows you to specify the name of the forum you are 
  584.  looking for. 
  585.  
  586.  NOTE that this field only invokes a search of the registered fora names, not 
  587.  the list of all available fora. 
  588.  
  589.  Delete Button 
  590.  
  591.  This deletes the currently selected forum from the registered forum list.  It 
  592.  does not delete the file, merely the registered list entry. 
  593.  
  594.  Refresh Button 
  595.  
  596.  This refreshes the list of registered fora.  If any forum files have been 
  597.  updated since the list was displayed, then clicking on this button will 
  598.  display the updated list. 
  599.  
  600.  
  601. ΓòÉΓòÉΓòÉ 8.2. Download Fora from Host ΓòÉΓòÉΓòÉ
  602.  
  603. This displays a dialog to assist you in downloading forum files from the IBM 
  604. host system.  Before you can download fora, you must be logged-on to the IBM 
  605. host system. 
  606.  
  607. Note: This feature is not available in the IBM internal version of ForBrows. 
  608.  
  609.  
  610. ΓòÉΓòÉΓòÉ 8.3. Send Appends to Host ΓòÉΓòÉΓòÉ
  611.  
  612. This menu selection displays the Send Append dialog to assist you in uploading 
  613. and posting your append files to the IBM host system.  Before you can upload 
  614. and post appends, you must be logged-on to the IBM host system. 
  615.  
  616. Send Append Dialog 
  617.  
  618. This dialog contains the following fields and controls; 
  619.  
  620. Choose 3270 Session 
  621.  
  622. Each active 3270 emulator window contains a short name, A thru Z. ForBrows 
  623. provides up to six radio buttons, to allow you to specify which 3270 window is 
  624. to be the target of the append upload.  You should click on the button for the 
  625. session that is connected to the IBM conferencing system. 
  626.  
  627. If there are no 3270 sessions active, all radio buttons will be disabled, as 
  628. well as the "Send" button. 
  629.  
  630. List File Spec(s) 
  631.  
  632. This entry field will be pre-filled with drive and pathname you gave for 
  633. appends in ForBrows's Set Installation Defaults dialog. If you wish to list 
  634. files in other subdirectories, you may specify other drive and path information 
  635. in this field. 
  636.  
  637. Select Append Files for Processing 
  638.  
  639. This listbox contains the names of files.  You may select files by clicking 
  640. mouse button 2 over a list entry.  After an entry is selected, you may process 
  641. the file by clicking on the View, Send, or Discard buttons. 
  642.  
  643. List Button 
  644.  
  645. Lists the files specified in the File Spec(s) entry field. 
  646.  
  647. View Button 
  648.  
  649. View (browse) the selected file. 
  650.  
  651. Send Button 
  652.  
  653. Upload the selected file to the IBM host, and append it to the appropriate 
  654. forum on the IBM master conferencing disk. The append is sent to the 3270 
  655. session specified via the "Choose 3270 Session" radio button. 
  656.  
  657. After append is sent, it is copied to a \POSTED subdirectory. The \POSTED 
  658. subdirectory will be a child of your append subdirectory. 
  659.  
  660. This button will be disabled if you do not have a 3270 window connected to an 
  661. IBM host. 
  662.  
  663. Technical Note This function uses EHLLAPI calls to drive the targeted 3270 
  664. session, and requires ACS3EHAP.DLL in the LIBPATH if you are using the OS/2 
  665. Communications Manager.  If you are using PMHPO, you will need TAPHLL32.DLL. 
  666.  
  667. Discard Button 
  668.  
  669. Erase the selected file.  You will be asked to verify the erasure. 
  670.  
  671. Cancel Button 
  672.  
  673. Return to the the main ForBrows window. 
  674.  
  675.  
  676. ΓòÉΓòÉΓòÉ 9. Creating Appends ΓòÉΓòÉΓòÉ
  677.  
  678. While viewing a forum, you may want to take part in the discussion.  There are 
  679. currently two ways to create an append.  One way is to drag and drop from 
  680. ForBrows to LaMail, IBM's TCP/IP mail application.  However, not all user's 
  681. have LaMail, so ForBrows has built-in functions, under the "Conference" menu, 
  682. for append creation and posting. 
  683.  
  684. You may either create a new append, or modify one of your previously posted 
  685. appends.  After you have created your append, you must send it to the IBM host 
  686. system, so that it will be appended to the forum file and become visible to 
  687. others. 
  688.  
  689. See Also Create a New Append, Modify Current Append, Send Appends to Host. 
  690.  
  691.  
  692. ΓòÉΓòÉΓòÉ 9.1. Create a New Append ΓòÉΓòÉΓòÉ
  693.  
  694. When you select this menu item, ForBrows will invoke the editor which you 
  695. specified in the Set Installation Defaults dialog.  ForBrows creates a skeleton 
  696. append file, with a Subject and Reference line, along with an Append line, 
  697. which contains information about the forum to which you are appending. 
  698.  
  699. The skeleton append which ForBrows creates will contain a Subject line 
  700. identical to the append which you are currently viewing, and will also 
  701. reference the currently viewed append. If these lines are inappropriate for the 
  702. append you are creating, simply use your editor to delete or change the 
  703. contents of these lines. However, you should not alter the contents of the 
  704. Append line; if you do so, and place invalid information in this line, then the 
  705. append may not be placed within the correct host forum. 
  706.  
  707. Usage Note; With the current version of ForBrows, you must be viewing a forum 
  708. before you can create an append. 
  709.  
  710. See Also Modify Current Append, Send Appends to Host. 
  711.  
  712.  
  713. ΓòÉΓòÉΓòÉ 9.2. Modify Current Append ΓòÉΓòÉΓòÉ
  714.  
  715. When you select this menu item while viewing one of your previously posted 
  716. appends, ForBrows will invoke the editor which you specified in the Set 
  717. Installation Defaults dialog.  ForBrows creates a skeleton append file, with a 
  718. Subject and Reference line, along with an Append line, which contains 
  719. information about the forum append which you are modifying, and the contents of 
  720. the append being modified. 
  721.  
  722. Usage Note; The host conferencing software will only allow you to modify an 
  723. append which was originally submitted from your own host userid. In other 
  724. words, you may not modify someone else's append. ForBrows will allow you to 
  725. create and send an append modifying someone else's append, but the IBM host 
  726. will not accept it. 
  727.  
  728. See Also Create a New Append, Send Appends to Host. 
  729.  
  730.  
  731. ΓòÉΓòÉΓòÉ 10. Window Menu ΓòÉΓòÉΓòÉ
  732.  
  733. This menu displays a selection of all active ForBrows windows.  You may switch 
  734. between windows by clicking on the appropriate item. 
  735.  
  736. See Also: New Window...