home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Collection - Online Library - January 1996 / CKITOS2196.ISO / readwin.txt < prev    next >
Text File  |  1994-12-06  |  18KB  |  363 lines

  1. (C) Copyright IBM Corp. 1994
  2.  
  3.          BookManager Library Reader for Windows 2.0 - READWIN.TXT
  4.                            IBM ONLINE LIBRARY
  5.          -------------------------------------------------------
  6.  
  7. Welcome to BookManager* Library Reader* for Windows(TM) 2.0.
  8.  
  9. This READWIN.TXT file contains information you need for installing
  10. BookManager Library Reader for Windows 2.0, as well as information that
  11. was not available for our printed publications.
  12.  
  13. This READWIN.TXT file is divided into the following categories:
  14.    -  Notice of Terms and Conditions
  15.    -  Before You Install Library Reader for Windows
  16.    -  Installing Library Reader for Windows
  17.    -  Late-Breaking News
  18.    -  Windows hints and tips
  19.    -  BookManager Library Reader for Windows hints and tips
  20.    -  Trademarks
  21.  
  22.  
  23. NOTICE OF TERMS AND CONDITIONS
  24. ------------------------------
  25. +--- NOTE --------------------------------------------------------------+
  26. |                                                                       |
  27. | If you are installing the IBM BookManager Library Reader you must     |
  28. | first read and agree to the terms and conditions specified in the     |
  29. | Program License Agreement for the IBM BookManager Library Reader/2,   |
  30. | Library, Reader/DOS, or the BookManager Library Reader for            |
  31. | Windows in the file PLALRENG.AGR.                                     |
  32. |                                                                       |
  33. | Users of the IBM Online Library must also read and agree to the terms |
  34. | and conditions specified in the file BOOKENG.AGR.  Any use of IBM     |
  35. | machine-readable documentation indicates your acceptance of these     |
  36. | terms and conditions.                                                 |
  37. |                                                                       |
  38. +-----------------------------------------------------------------------+
  39.  
  40.  
  41. Before You Install READ for Windows
  42. -----------------------------------
  43.  1) The BookManager Library Reader installation program installs the
  44.     BookManager Library Reader for Windows program and publications on a
  45.     Windows workstation.
  46.  
  47.     If you already have the BookManager READ for Windows licensed program
  48.     installed, you do not need to install BookManager Library Reader for
  49.     Windows.  You can use your BookManager READ for Windows Licensed
  50.     program to view the books in the IBM Online Library by identifying
  51.     to BookManager READ for Windows the drives that will hold the
  52.     bookshelves and books in the IBM Online Library.
  53.  
  54.  2) On the Installation - Directories window, if you plan
  55.     on pressing the Disk Space button to determine if
  56.     you have enough space to install on a particular driver,
  57.     please note the following caution:
  58.  
  59.         CAUTION:  If you are connected to a LAN that has
  60.         a drive for removable media such as CD-ROM or
  61.         optical disk, MAKE SURE THERE IS A DISK IN THAT
  62.         DRIVE BEFORE CHOOSING THE DISK SPACE BUTTON.
  63.         Otherwise unpredictable results will occur. (P1075)
  64.  
  65.  
  66.  
  67. Installing Library Reader for Windows from this CD-ROM
  68. ------------------------------------------------------
  69.   To install the product:
  70.    1) Start Microsoft Windows.
  71.    2) From the File Menu (of Program Manager), choose Run.
  72.    3) Type D:\ILRWIN\INSTALL and press ENTER, where D: is the
  73.       drive letter for your CD-ROM drive.
  74.  
  75.   If you are using WIN-OS/2 and you experience a SYS3171 error
  76.   at the end of installation, you will see this message:
  77.   "A program caused exception C0000005 at xxxx. Due to insufficient
  78.   stack space, the exception was not dispatched.  The process is
  79.   terminated."
  80.  
  81.   This means that all of the files are installed successfully,
  82.   but because the installation did not finish, Software Installer (SI)
  83.   does not know that it is installed.  Therefore you will not be
  84.   able to delete the product or apply maintenance.
  85.   ACTION:
  86.    - If you encounter this at the end of the installation, you should
  87.      try to do the install again.  If you get the message again, you
  88.      are unable to use SI for maintenance or deleting.
  89.    - Contact OS/2 support and get the fix for APAR #PJ10867.
  90.  
  91.  
  92. - If your PATH statement in your AUTOEXEC.BAT is "PATH" (instead of PATH=
  93.   or SET PATH=) and you have more than one blank space before the word PATH,
  94.   and you requested that the installation program update your AUTOEXEC.BAT
  95.   then you will need to remove the SET PATH= that the installation program
  96.   added to the bottom of your AUTOEXEC.BAT. Also, append the path where
  97.   the program files were install to your existing PATH statement.
  98.  
  99.  
  100. Late-Breaking News
  101. ------------------
  102.  
  103. WORKING WITH BOOKSHELVES
  104. - If you are looking at a large bookshelf, the list of books in that
  105.   bookshelf may be truncated due to limitations of the listbox control.
  106.   If you get a message that the list was truncated, choose Include from
  107.   the View menu to see the books that were not originally
  108.   displayed. (P0604)
  109. - In cases where books and bookshelves are stored in separate
  110.   directories, make sure that the directories for both the books
  111.   AND the bookshelves are in the startup path.  This will aid
  112.   load time performance by retrieving book information from the
  113.   bookshelves. (P1043)
  114.  
  115. WORKING WITH NOTES
  116. - Public notes can be shared by many users.  In order to have public
  117.   notes, you must change the note file attribute to read only, using
  118.   Windows file manager or the equivalent.
  119.   A private note should be placed on a local disk in the your
  120.   workstation to prevent unauthorized write access.  It can also be
  121.   placed on a LAN drive with protected access.
  122.   This product does not have the mechanisms for multiple write access
  123.   to the note file. (P1172)
  124.  
  125. WORKING WITH SEARCH
  126. - If you are performing a cross-book search on books listed in the
  127.   bookshelf search index, and the search request has a word with more
  128.   than 3 special characters in it, no matches will be found.  To
  129.   see the matches, limit words in the search request to no more
  130.   than 3 special characters. (P1124)
  131. - If you experience unexpected results when going to the next or
  132.   previous search match, you should scroll forward or backward
  133.   within the topic. (P1207, P1159)
  134. - You can enter only 50 phrases (separated by commas) in a search
  135.   request.  It was documented that 64 phrases was the maximum. (P960)
  136.  
  137. WORKING WITH PRINT
  138. - When viewing graphics using Print Preview, the following command buttons
  139.   at the top of the window may not be visible:  Two Pages, Zoom In, Zoom Out,
  140.   and Close.  However, the shortcut keys for these buttons (T, I, O, and C
  141.   respectively) are still active and can be used in place of the buttons.
  142.   (P1243)
  143.  
  144. NAVIGATING IN BOOKSHELVES
  145. - Ctrl+Page Up and Ctrl+Page Down function as Page Up and Page Down in the
  146.   following areas: List of Bookshelves, Bookshelf, and all list boxes.
  147.   In the Book window they scroll to the beginning or end of the topic
  148.   respectively. (P1246)
  149.  
  150. SYSTEM SITUATIONS
  151. - If you experience a SYS3171 error when exiting the product or at the
  152.   end of the installation, contact OS/2 support and get the fix for
  153.   APAR #PJ10867. (P2001)
  154. - Due to a known bug in Windows 3.1, 3.11, Windows for Workgroups 3.11,
  155.   and WIN-OS/2, doing extensive zooming on some kinds of pictures
  156.   may result in a blank window.  If this occurs, simply revert to
  157.   the previous zoom level. (P0909)
  158. - If you are using WIN-OS/2 and you experience a General Protection
  159.   Fault (GPF) in the display driver, contact OS/2 support to get the
  160.   latest version of the display device driver. (P1146)
  161.  
  162.  
  163. Windows hints and tips
  164. ----------------------
  165.  
  166. Beyond these performance enhancements lie the true upgrades -- faster
  167. processors, faster video graphic adapters, faster disk and CDROM drives.
  168.  
  169. For adequate performance, production office workers should use a PC
  170. with 25MHz or better 386DX with 8MB of RAM.
  171.  
  172.  
  173.    Using lots of files?
  174. #1 Make sure files and buffers are set high enough.  BookManager uses
  175. many files:  bookshelf, book, note, profile, unicode table, bookshelf
  176. index and temporary files.  Opening many books can exhaust the file and
  177. buffer setting in CONFIG.SYS.  Sometimes that out-of-memory error
  178. message means something completely different.  Many systems come
  179. preconfigured with a minimal 30 files and 10 buffers.  It is recommended
  180. that you set your FILES=120 and BUFFERS=80 in the CONFIG.SYS.  If you
  181. use a SmartDrive utility, reduce your BUFFERS=80 to BUFFERS=20.
  182.  
  183.    Remove expanded memory
  184. #2 If you don't use any applications under Windows that require expanded
  185. memory (EMS) you can disable EMS driver in Windows to improve performance.
  186. Edit the SYSTEM.INI 386ENH section, add the line NOEMMDRIVER=ON, and
  187. restart Windows.  If your not sure whether your applications use EMS
  188. don't alter this setting.
  189.  
  190.    Use SmartDrive
  191. #3 Use SmartDrive, which is supplied with Windows, to reduce retrieval
  192. time from your hard disk.  This is both a read and a write cache that
  193. shortens your wait for the disk drive in most circumstances.  SmartDrive
  194. should always be used; using the /C parameter is encouraged only if you
  195. write notes or update bookshelves.
  196.  
  197.    Still double buffering?
  198. #4 If double buffering is not needed, turn it off.  Check your
  199. CONFIG.SYS file for this statement:  DEVICE=SMARTDRV.EXE /DOUBLE_BUFFER.
  200. To determine whether your system needs the double buffer feature, type
  201. SMARTDRIVE /S at the DOS prompt.  A SmartDrive status report is
  202. displayed.  If the last column in the report reads "no", you can remove
  203. the double buffer line from your CONFIG.SYS file.
  204.  
  205.    Set up a permanent swap file
  206. #5 To set up a permanent swap file go into the Windows control panel's
  207. 386 Enhanced option and press the Virtual Memory button.  You will be
  208. able to open more books and other applications by augmenting RAM with
  209. virtual memory.  If Windows runs out of real memory, it will use the
  210. virtual memory set up by the permanent swap file.  Unfortunately, a
  211. permanent swap file improves performance only if Windows has no RAM to
  212. allocate to applications.  If your hard disk's "in use" light goes on
  213. when you switch applications, adding 1MB to 2MB of RAM will make a
  214. bigger difference in the speed of BookManager than any swap file will.
  215.  
  216.    Fast Disk
  217. #6 To boost I/O performance go to the Windows control panel's Enhanced
  218. option, select Virtual Memory, change and turn on "Use 32-bit file
  219. access."  This is activated for disk drives that support the WD1003
  220. standard used in most Western Digital disk controllers.  If used, this
  221. device driver never needs to switch into real mode in order to read from
  222. or write to a disk.  This speeds disk access significantly.
  223.  
  224.    Defragment your hard disk
  225. #7 The final performance improvement you should consider is to use a
  226. disk-optimizing program on your hard drive.  Such programs rearrange
  227. the data on your disks so that when you start BookManager or open a
  228. book, the entire file can be read with the minimum number of physical
  229. movements of the disk's read-write heads.
  230.  
  231.  
  232. BookManager Library Reader for Windows hints and tips
  233. -----------------------------------------------------
  234.  
  235.    Use code page 850 to display special characters
  236. #8 Check the code page setting to ensure that you are getting the best
  237. possible character display translation.  Check the code page setting in
  238. your CONFIG.SYS or AUTOEXEC.BAT.  If you are not using code page 850,
  239. refer to the user's guide for your operating system for information on
  240. using the CHCP command to change it.
  241.  
  242.    Table of contents in a book
  243. #9 To improve performance opening a book, make a table of contents (TOC)
  244. and include all topic levels when you build the book.  If a TOC is not
  245. built into the book, the entire book must be read in order to
  246. dynamically build the TOC and then collapse it to the highest topic
  247. level.
  248.  
  249.    Bookshelf size
  250. #10 Although bookshelves can contain an unlimited number of books, as a
  251. rule of thumb, bookshelves should not exceed more than 50 books.  For
  252. performance reasons, it is recommended to group related books together
  253. on a bookshelf of no more than 50 books.  Searching, adding, and
  254. removing books in a large bookshelf can adversely affect performance.
  255.  
  256.    Searching bookshelves
  257. #11 To improve searching many books in a bookshelf it is strongly
  258. recommended to use a bookshelf index file.  The bookshelf index file is
  259. created using the an index utility currently available only from the VM
  260. and MVS BookManager family of products.  Performance is improved because
  261. every book does not have to be opened and searched.  When the search
  262. term is only one word, then only the bookshelf index file is searched.
  263. However, if a phrase or a Boolean search is entered, the index file is
  264. searched first, then the books with search matches are verified by
  265. opening each book and searching it.
  266.  
  267.    List books function
  268. #12 To list books quickly, bookshelves are read to locate book
  269. information such as the book title and date.  This prevents each book
  270. from having to be opened to retrieve this data.  If the number of books
  271. is greater than 60, the bookshelves found in your startup path will be
  272. used to list the books.  To improve performance, when displaying a list
  273. of more than 60 books, avoid using a startup path that has many
  274. bookshelves and very large bookshelves (shelves containing thousands of
  275. books).
  276.  
  277.    Book searching
  278. #13 To improve search performance and to get more than 400 topic hits go
  279. to the Extended search dialog and select list topics in sequence.  This
  280. will bypass topic ranking algorithms.
  281.  
  282.    Picture this
  283. #14 To improve performance while reading a book, and to use fewer
  284. resources in Windows, view pictures in a separate window.  You can set
  285. this in the Workspace dialog box by choosing Workspace from the Options
  286. menu.  You can then display only the picture you want to see by tabbing
  287. to the picture link and pressing Enter or double-clicking the picture
  288. link.
  289.  
  290.    View book text only
  291. #15 If you want a larger text viewing area, turn off the tool bar and
  292. status bar.  You can set this temporarily in the View menu, or
  293. permanently by choosing Workspace from the Option menu.  You can also
  294. move the split bar, which separates the topic from the table of
  295. contents, all the way to the right, removing the table of contents from
  296. view.  You can then use a topic list on demand from the Navigate menu.
  297.  
  298.    Cross-book linking
  299. #16 You can link to other books from an author-defined link only if the
  300. book is located in the same bookshelf the original book was opened from.
  301. This will also work in the list of books as long as the other book you
  302. are linking to is in the same path used when the list of books window
  303. was built.  Remember, the level number of the document number is not
  304. used.  So, the first book found with a matching document number (minus
  305. the level) is opened.
  306.  
  307.    Close a few windows
  308. #17 Applications can generate many windows, which can steal time away
  309. from your main task because you cannot control the percentage of time
  310. that each running window claims.  Even when other Windows applications
  311. are in the background, supposedly idle, they can slow down BookManager.
  312. Close some of these windows to return some precious resources and reduce
  313. CPU cycles in Windows.
  314.  
  315.    Maximize the size of your window
  316. #18 When several window frames are visible on your screen, Windows must
  317. expend a few CPU cycles to keep track of which one the mouse pointer is
  318. over, changing the mouse cursor, issuing messages and so on.  Maximizing
  319. your screen to full size reduces this overhead.
  320.  
  321.    SHARE your files
  322. #19 To prevent the corruption of your note files if duplicate books or
  323. other applications are using the same note file, DOS SHARE.EXE or
  324. equivalent must be installed.  Notes for an existing note file will be
  325. unavailable until SHARE is installed.  SHARE also protects your note
  326. file in a LAN environment.  To install SHARE, add the statement
  327. INSTALL=C:\DOS\SHARE.EXE to your CONFIG.SYS file.  Change C:\DOS to your
  328. DOS path location.
  329.  
  330.    Public and private note files
  331. #20 Unfortunately, note files cannot be shared for updating.  A public
  332. note file can, however, be shared on a LAN and read by many users.  To
  333. share a public note, the note file attribute must be set to read-only.
  334. The public note file should be located in the same path used by the
  335. book.  To set a file to read-only, go to Windows File Manager, select
  336. the file you want to make read-only, then from the File menu choose
  337. Properties.  In the Properties dialog box, check the Read Only
  338. attribute.  To attach a public note file to the user's book, the startup
  339. note path should be blank so the note file will be found using the
  340. book's path.  As an alternative, the Startup Defaults for notes,
  341. available through the Option menu, can specify the same path where the
  342. public note file is located.  A separate directory can be setup, on the
  343. LAN, to contain only public notes.
  344.  
  345.    Crash support
  346. #21 Add DRWATSON to your LOAD= line in the WIN.INI file, so that the Dr.
  347. Watson utility will capture information if you crash.  Once it finds a
  348. crash, it will prompt you to enter a description of what you were doing
  349. at the time and will create a text file (DRWATSON.LOG) with all of the
  350. relevant system information, which you can share with a BookManager
  351. technical support person.
  352.  
  353. In addition, to keep track of your windows startup, load Windows with
  354. the WIN/B command, which creates a text file BOOTLOG.TXT.
  355.  
  356.  
  357.  
  358. Trademarks
  359. ----------
  360.   (TM) Windows is a trademark of Microsoft Corporation
  361.     *  BookManager is a trademark of IBM Corporation
  362.     *  Library Reader is a trademark of IBM Corporation
  363.