1COVER Book Cover ¸ Copyright IBM Corp. 1996, 1997 -------------------------------------------------------------------------- IBM Online Library: Installing and Using the Online Library Document Number GC31-8311-06 -------------------------------------------------------------------------- 1NOTICES Notices ¸ Copyright IBM Corp. 1996, 1997 !--- Note] ----------------------------------------------------------! ! ! ! Before using this information and the products it supports, be ! ! sure to read the general information under "Notices" in ! ! topic FRONT_1. ! ! ! !--------------------------------------------------------------------! 1EDITION Edition Notice ¸ Copyright IBM Corp. 1996, 1997 Seventh Edition (December 1997) This edition applies to CD-ROMs produced on or after September 1996 containing online books built for viewing with the BookManager READ products and the IBM Library Readers. This edition replaces and makes obsolete IBM Online Library: Installing and Using the Online Library, GC31-8311-05, AB0IN005. This book is available as an online book on many of the CD-ROMs distributed by the IBM Corporation and the IBMLink home page on the World Wide Web (http://www.elink.ibmlink.ibm.com/pbl/pbl). The filename of the online version is AB0IN006. You can view it with the BookManager READ products and the IBM Library Reader programs. It is also available as an ASCII file called INSTALL.TXT in the root directory of many of the IBM Online Library CD-ROMs. To order IBM publications, contact your IBM representative or write to the IBM branch office serving your locality. Publications are not stocked at the following address. IBM welcomes your comments. A form for your comments is provided at the back of this document. If the form has been removed from the printed book or is not accessible in the online book, address your comments to: IBM Corporation Department 55JA, Mail Station P384 522 South Road Poughkeepsie, NY 12601-5400 U.S.A. FAX: (International Access Code)+1+914+432-9405 IBMLink (United States customers only): KGNVMC(MHVRCFS) IBM Mail Exchange: USIB6TC9 at IBMMAIL Internet: mhvrcfs@vnet.ibm.com World Wide Web: http://www.s390.ibm.com/os390 IBM may use or distribute whatever information you supply in any way it believes appropriate without incurring any obligation to you. ¸ Copyright International Business Machines Corporation 1996, 1997. All rights reserved. Note to U.S. Government Users -- Documentation related to restricted rights -- Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corp. 1CONTENTS Table of Contents ¸ Copyright IBM Corp. 1996, 1997 Book Cover COVER Notices NOTICES Edition Notice EDITION Table of Contents CONTENTS Notices FRONT_1 Terms and Conditions for Items in the Online Library FRONT_1.1 Using and Copying Online Books FRONT_1.1.1 Using and Distributing the IBM Library Reader Programs FRONT_1.1.2 Using and Distributing the IBM Softcopy Receiver Tool FRONT_1.1.3 README Files for Online Library Components FRONT_1.2 Trademarks FRONT_1.3 What's New in This Edition CHANGES Chapter 1. What Is an IBM Online Library CD-ROM? 1.0 Ordering Online Library CD-ROMs 1.1 What Is the Structure of an IBM Online Library CD-ROM? 1.2 Using Online Library CD-ROMs in Your Business 1.3 Using Online Libraries on Your Workstation 1.3.1 Using Online Libraries on Your Network 1.3.2 Sharing and Centralizing Online Libraries on Your Host System 1.3.3 Using Online Libraries on Your AS/400 System 1.3.4 Chapter 2. Introducing the IBM Online Library Reader Programs 2.0 Identifying the Latest Level of IBM Reader Programs via the Internet 2.1 Downloading IBM Library Readers from the Internet 2.2 Planning for IBM Library Readers Installation 2.3 Chapter 3. Installing or Updating the IBM Library Reader/2 3.0 Software and Hardware Requirements for OS/2 3.1 Installing or Updating from a CD-ROM 3.2 Opening Your Online Library with Library Reader/2 3.3 Specifying Device Paths 3.3.1 Improving Viewing and Printing of the CKITLIST.TXT File on OS/2 Workstations 3.4 Chapter 4. Installing or Updating the IBM Library Reader/DOS 4.0 Software and Hardware Requirements for DOS 4.1 Installing or Updating from a CD-ROM 4.2 Opening Your Online Library with BookManager Library Reader/DOS 4.3 Specifying Device Paths 4.3.1 Chapter 5. Installing or Updating the IBM Library Reader for Windows on Windows 95 or NT 5.0 Software and Hardware Requirements for Microsoft Windows 5.1 Installing or Updating from a CD-ROM on Windows 95 or NT 5.2 Opening Your Online Library on Windows 95 or Windows NT 5.3 Specifying Device Paths 5.4 Specifying a Temporary Path 5.4.1 Specifying a Permanent Path 5.4.2 Chapter 6. Installing or Updating the IBM Library Reader for Windows 3.1 or WIN-OS/2 6.0 Software and Hardware Requirements for Microsoft Windows 6.1 Installing or Updating from a CD-ROM on WIN-OS/2 or Windows 3.1 6.2 Opening Your Online Library on Windows 3.1 or WIN-OS/2 6.3 Specifying Device Paths 6.4 Specifying a Temporary Path 6.4.1 Specifying a Permanent Path 6.4.2 Chapter 7. Using the Online Library on an AS/400 System 7.0 Installing and Using InfoSeeker on Your AS/400 System 7.1 Using Directories on the AS/400 System to Share the Online Library 7.2 Using the SCRT to Install Books to an AS/400 System Directory 7.3 Copying IBM Books to an AS/400 System Directory 7.4 Installing Books on AS/400 Version 3 Release 6 7.5 Chapter 8. Transferring Books To Your Workstation or Host with the Softcopy Receiver Tool 8.0 Using SCRT/MVS or SCRT/VM 8.1 Using SCRT/OS2, or SCRT/WIN95, or SCRT/WINNT 8.2 Using the SCRT on AS/400 8.3 Chapter 9. Using the Online Library on an MVS, OS/390, or VM Host 9.0 Estimating Host DASD Storage Requirements 9.1 Uploading Books, Bookshelves, and Search Indexes 9.2 Using the Softcopy Receiver Tool to Upload to a Host 9.2.1 Using the Bookshelf Upload Programs to Upload to a Host 9.2.2 Using the SEND Capability to Upload to a Host 9.2.3 Making Bookshelves Available to IBM Host Readers 9.3 Making Bookshelves Available on READ/MVS or the OS/390 Reader 9.3.1 Making Bookshelves Available on READ/VM 9.3.2 Making Bookshelves Usable on Your MVS or OS/390 Host 9.4 Uploading and Downloading Books, Bookshelves, and Indexes 9.5 Transferring Files to CICS 9.6 Chapter 10. Sharing the Online Library With Your VSE Host 10.0 Distributing the Online Library to VSE Workstations 10.1 Distributing the Online Library Using Diskettes 10.1.1 Uploading Books, Bookshelves, and Indexes to the PUN Queue 10.1.2 Receiving Books, Bookshelves, and Indexes from the PUN Queue 10.1.3 Chapter 11. Installing and Using the Online Message Facility 11.0 Additional Software Requirements for OMF 11.1 Installing the Online Message Facility on OS/2 11.2 Copying MPT Files to Your Hard Disk for OS/2 11.2.1 Shutting Down and Restarting Your OS/2 Workstation 11.2.2 Appendix A. Configuration Changes Made to Install the Library Reader on Windows A.0 Index INDEX Do You Have Questions, Problems, or Suggestions? BACK_1 In the U.S.A. BACK_1.1 In Other Countries BACK_1.2 In All Locations BACK_1.3 1FRONT_1 Notices ¸ Copyright IBM Corp. 1996, 1997 References in this publication to IBM products, programs, or services do not imply that IBM intends to make these available in all countries in which IBM operates. Any reference to an IBM product, program, or service is not intended to state or imply that only IBM's product, program, or service may be used. Subject to IBM's valid intellectual property or other legally protected rights, any functionally equivalent product, program, or service may be used instead of the IBM product, program, or service. The evaluation and verification of operation in conjunction with other products, except those expressly designated by IBM, are the responsibility of the user. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation 500 Columbus Avenue Thornwood, NY 10594 USA Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Corporation Mail Station P300 522 South Road Poughkeepsie, NY 12601-5400 USA Attention: Information Request Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee. The licensed program described in this document and all licensed material available for it are provided by IBM under the terms of the IBM Customer Agreement. This document is not intended for production use and is furnished as is without any warranty of any kind, and all warranties are hereby disclaimed including the warranties of merchantability and fitness for a particular purpose. FRONT_1.1 Terms and Conditions for Items in the Online Library ¸ Copyright IBM Corp. 1996, 1997 Before using or copying books and programs on Online Library CD-ROMs, you must first read and agree to the terms and conditions specified for them. If you do not agree, return the CD-ROM to IBM. By using and copying the books or programs, you agree to the terms and conditions and the license agreement. FRONT_1.1.1 Using and Copying Online Books ¸ Copyright IBM Corp. 1996, 1997 Unlicensed books have order numbers that begin with the letters G or S. The terms and conditions for using and copying unlicensed books provided in BookManager format are stated in a file called BOOKENG.AGR on CD-ROMs that contain these files. The file is in ASCII format and can be displayed or printed from your personal computer. Licensed books have order numbers that begin with the letter L. These books are classified "Licensed Materials--Property of IBM." The terms and conditions for using licensed books are stated in the Licensed Program Specifications for the product to which they apply and in the IBM Customer Agreement. FRONT_1.1.2 Using and Distributing the IBM Library Reader Programs ¸ Copyright IBM Corp. 1996, 1997 The terms and conditions for using and distributing the IBM Library Reader programs are stated in a file called PLALRENG.AGR included on CD-ROMs that contain these programs. The file is in ASCII format and can be displayed or printed from your personal computer. FRONT_1.1.3 Using and Distributing the IBM Softcopy Receiver Tool ¸ Copyright IBM Corp. 1996, 1997 The terms and conditions for using and distributing the IBM Softcopy Receiver Tool programs are stated in a file called SCRTENG.AGR included on CD-ROMs that contain these programs. The file is in ASCII format and can be displayed or printed from your personal computer. FRONT_1.2 README Files for Online Library Components ¸ Copyright IBM Corp. 1996, 1997 Before installing or using the following component of the IBM Online Library, consult the following README file for important information. This is an ASCII file in the root directory on CD-ROMs that contain this component. READSCRT.TXT IBM Softcopy Receiver Tool FRONT_1.3 Trademarks ¸ Copyright IBM Corp. 1996, 1997 The following terms are trademarks of the IBM Corporation in the United States, other countries, or both: AIX AS/400 BookManager CD Showcase CICS DFSMS Extended Services IBM IBMLink Library Reader Operating System/400 OS/2 OS/390 OS/400 Personal Computer AT Personal Computer XT PowerPC PS/ValuePoint PS/1 PS/2 RISC System/6000 S/370 S/390 SAA VSE/ESA VTAM WIN-OS/2 400 PC Direct is a trademark of Ziff Communications Company and is used by the IBM Corporation under license. Unix is a registered trademark in the United States and other countries licensed exclusively through X/Open Company Limited. C-bus is a trademark of Corollary, Inc. Microsoft, Windows, and the Windows 95 logo are trademarks or registered trademarks of Microsoft Corporation. Java and HotJava are trademarks of Sun Microsystems, Inc. Other company, product, and service names, which may be denoted by a double asterisk (**), may be trademarks or service marks of others. 1CHANGES What's New in This Edition ¸ Copyright IBM Corp. 1996, 1997 This section contains changes and updates made to this guide since the Sixth Edition, September 1997. * A new chapter containing instructions for installing and using the Library Reader for Windows on Windows 95 and Windows NT workstations has been added. * A new appendix containing configuration changes made by Library Reader for Windows. This information, previously contained in the chapter "Installing or Updating the Library Reader for Windows," now applies to the "Installing or Updating the Library Reader for Windows on Windows 95 and Windows NT" to the "Installing or Updating the Library Reader for Windows on Windows 3.1 and WIN-OS/2." !--- Usage Note - Saving Sort Order -------------------------------------! ! Library Reader for Windows 2.0.1 and BookManager READ for Windows ! ! 2.0.1 will save the sort order for bookshelves and books. To save the ! ! sort order, do the following: ! ! ! ! 1. In the bookshelf or book list, click on the View choice on the ! ! menu bar. ! ! ! ! 2. Select Sort. ! ! ! ! 3. Select the type of sort that you want as your default. ! ! ! ! 4. Click on the Options choice on the menu bar. ! ! ! ! 5. Select Save Window. ! ! ! ! ! ! The next time you start the library reader or READ for Windows, the ! ! sort order that you selected, will appear. ! ! ! !------------------------------------------------------------------------! 11.0 Chapter 1. What Is an IBM Online Library CD-ROM? ¸ Copyright IBM Corp. 1996, 1997 The IBM Online Library CD-ROMs are a way for IBM to provide you with online books that can be viewed and searched electronically on workstations and portable laptop PCs (running OS/2, DOS, Windows, or AIX), host systems (running VM, MVS, OS/390, AIX, or CICS) and the AS/400 System. IBM provides several different IBM Online Library CD-ROMs. Most of the CD-ROMs contain online books for many IBM products, programs for viewing and searching the online books, and utilities to help you distribute and manage the online libraries in your business. Some online libraries are on multiple CD-ROMs. Online Library CD-ROMs are updated periodically. Each update may include new products, new versions of existing products, updates to the existing libraries, and enhancements to the Library Reader programs used for viewing the online libraries. 1.1 Ordering Online Library CD-ROMs ¸ Copyright IBM Corp. 1996, 1997 You can determine which Online Library CD-ROMs are currently available, which products are on them, and how to order them by using any of the following sources: * The Online Library CD-ROM: Look in the root directory of the CD-ROM for an ASCII file named CKITLIST.TXT. You can view this file with a text editor or word processing program. * The World Wide Web (WWW): Point your browser to http://www.elink.ibmlink.ibm.com/pbl/pbl. Select Publications & Information, then select CD-ROM (collection kits). 1.2 What Is the Structure of an IBM Online Library CD-ROM? ¸ Copyright IBM Corp. 1996, 1997 The following table shows the directories and files common to Online Library CD-ROMs. Some Online Library CD-ROMs have additional directories and files for features unique to that particular collection. Online Library Collections that include multiple CD-ROMs might have the following files on only one CD-ROM in the collection. !------------------------------------------------------------------------! ! Information Files ! ! ! ! ! ! ! ! INSTALL.TXT ASCII file version of this guide ! ! CKITLIST.TXT List of available Online Library CDs and how to ! ! order them ! ! READSCRT.TXT Last minute information about the Softcopy ! ! Receiver Tool ! ! READWIN.TXT Last minute information about Library Reader for ! ! Windows** ! ! PLALRENG.AGR Terms for using Library Readers ! ! BOOKENG.AGR Terms for using Online Libraries ! ! SCRTENG.AGR Terms for using the Softcopy Receiver Tool ! !------------------------------------------------------------------------! ! Library Readers (directories) ! ! ! ! ! ! ! ! ILROS2 Program for installing Library Reader/2 ! ! ILRDOS Program for installing Library Reader/DOS ! ! ILRWIN Program for installing Library Reader for Windows ! !------------------------------------------------------------------------! ! Online Libraries (directories) ! ! ! ! ! ! ! ! Books The books and bookshelf search indexes on the ! ! CD-ROM ! ! Shelves The bookshelves on the CD-ROM ! !------------------------------------------------------------------------! ! Uploading and File Management Programs (directories) ! ! ! ! ! ! ! ! UPLOAD Programs for uploading libraries to MVS, OS/390, ! ! or VM host systems via an emulator ! ! SCRT Programs for the Softcopy Receiver Tool for ! ! uploading libraries to host systems or ! ! transferring libraries to a workstation. ! !------------------------------------------------------------------------! ! Utilities ! ! ! ! ! ! ! ! OMF (Directory) Program for installing the Online Message Facility ! ! (OMF)--this program applies only to Online ! ! Libraries that have books enabled for OMF ! ! MPT (Files) Message Parsing Template files used with OMF ! !------------------------------------------------------------------------! ! Miscellaneous (directories) ! ! ! ! ! ! ! ! TAPES CD-ROM identifier information ! !------------------------------------------------------------------------! ! Optional Directories and Files (may not be in your CD-ROM collection) ! ! ! ! ! ! ! ! Security management and performance tools ! ! Multimedia product demos and overviews ! !------------------------------------------------------------------------! 1.3 Using Online Library CD-ROMs in Your Business ¸ Copyright IBM Corp. 1996, 1997 Online Library CD-ROMs contain product libraries in online form. These online libraries can be used on workstations, host systems (MVS, OS/390, VM), AS/400 Systems, and portable PCs such as laptops. The libraries can also be used and shared on an RS/6000, and shared with VSE users. Online libraries can be easily transferred between workstations, from servers to clients, and between workstations and a host system. With the Online Library CD-ROMs, you can receive your documentation electronically, and set up an electronic document repository to manage, update, and distribute online books throughout your business. In addition, you can use the IBM BookManager technology to build and view your own documentation, thus creating a consistent, seamless information environment for your customers. 1.3.1 Using Online Libraries on Your Workstation ¸ Copyright IBM Corp. 1996, 1997 Here are some ways you can use the online libraries on your workstation. * Use the CD-ROM as the storage device and select books and libraries to open and view when you need them. * Download libraries or individual books from the CD-ROM to your workstation hard drive. This may improve your access time. * Do both: move the most frequently used libraries or individual books to your hard drive and use the remainder on the CD-ROM. 1.3.2 Using Online Libraries on Your Network ¸ Copyright IBM Corp. 1996, 1997 Here are some ways you can use the online libraries on a network. * Use the CD-ROM as the storage device to hold all of the libraries and let your customers select the online books to open and view when they want them. Multiple-CD CD-ROM drives are available so you can make a number of CD-ROMs available to your network customers. * Download libraries or individual books from the CD-ROM to your server hard drive. This may improve your access time. * Download libraries or individual books and Library Reader programs from the CD-ROM to user workstations on the network. * Do a combination: move the most frequently used libraries or individual books to your server hard drive or user workstations and use the remainder on the CD-ROM. 1.3.3 Sharing and Centralizing Online Libraries on Your Host System ¸ Copyright IBM Corp. 1996, 1997 You can use your workstation to copy libraries from the CD-ROM to your host system. 1.3.4 Using Online Libraries on Your AS/400 System ¸ Copyright IBM Corp. 1996, 1997 You can use your workstation to copy libraries from the CD-ROM to your AS/400 system. 12.0 Chapter 2. Introducing the IBM Online Library Reader Programs ¸ Copyright IBM Corp. 1996, 1997 The following table lists the readers available, by operating system, for viewing the IBM Online Libraries delivered on CD-ROMs. The IBM Library Readers, listed in the second column, are an abbreviated form of the IBM BookManager Readers. They are included at no charge on these CD-ROMs. These Library Readers are enabled to view only the books on online library CD-ROMs available from IBM. They cannot read any other online books in BookManager format. The BookManager READ products, listed in the third column of the table, allow you to view not only the books on IBM Online Library CD-ROMs, but also online books that you can build yourself using BookManager BUILD programs or that you receive from companies other than IBM that do not provide IBM Library Readers. The BookManager READ programs are available from IBM for a fee. The part number or program number for ordering them is listed in the table. A single part number is used for READ/2, READ/DOS, READ for Windows, and READ/6000. When you order this part number, you receive a CD-ROM with all four readers. You can select the reader you want and install it at your workstation. !-----------!------------------------!-----------------------------------! ! ! ! IBM BookManager Readers ! ! ! ! (available from IBM) ! ! ! IBM Library Readers !-----------------!-----------------! ! Operating ! (included on this ! ! Program/Part ! ! System ! CD-ROM) ! Name ! Number ! !-----------!------------------------!-----------------!-----------------! ! OS/2 ! Library Reader/2 ! READ/2 1.2.1 ! 84H1526 ! !-----------!------------------------!-----------------!-----------------! ! OS/2 ! Library Reader for ! READ for ! 84H1526 ! ! (WIN-OS/2)! Windows ! Windows 2.0 ! ! !-----------!------------------------!-----------------!-----------------! ! DOS ! Library Reader/DOS ! READ/DOS 1.2 ! 84H1526 ! !-----------!------------------------!-----------------!-----------------! ! Windows ! Library Reader for ! READ for ! 84H1526 ! ! 3.1, 95, ! Windows ! Windows 2.0 ! ! ! or NT ! ! ! ! !-----------!------------------------!-----------------!-----------------! ! AIX ! ! READ/6000 1.2 ! 84H1526 ! !-----------!------------------------!-----------------!-----------------! ! MVS ! ! READ/MVS 1.3 ! 5695-046 ! !-----------!------------------------!-----------------!-----------------! ! OS/390 ! ! BookManager ! See Note 1 ! ! ! ! READ ! ! !-----------!------------------------!-----------------!-----------------! ! VM ! ! READ/VM 1.3 ! 5684-062 ! !-----------!------------------------!-----------------!-----------------! ! CICS ! ! READ/GT ! See Note 2 ! !-----------!------------------------!-----------------!-----------------! ! OS/400 ! ! InfoSeeker ! See Note 3 ! !-----------!------------------------!-----------------!-----------------! ! Notes: ! ! ! ! 1. OS/390 BookManager READ is shipped as a component of OS/390. ! ! ! ! 2. The READ/GT reader is available from GT Software. ! ! ! ! 3. InfoSeeker is shipped as part of AS/400. ! !------------------------------------------------------------------------! 2.1 Identifying the Latest Level of IBM Reader Programs via the Internet ¸ Copyright IBM Corp. 1996, 1997 You can see if you are using the latest level of IBM Library Readers and IBM BookManager READ programs by going to the Service Page on the following Web site and compare the level of your reader with those listed: http://booksrv2.raleigh.ibm.com/homepage/service.html If you do not have the latest level, you can download it from the Internet. 2.2 Downloading IBM Library Readers from the Internet ¸ Copyright IBM Corp. 1996, 1997 The latest versions of the IBM Library Readers are also available electronically by following these instructions. 1. FTP to ps.software.ibm.com. 2. Log on as anonymous with your e-mail address as the password. 3. Go to: /ps/products/bookmanager/tools. 4. Refer to the README.TXT file in that directory. 2.3 Planning for IBM Library Readers Installation ¸ Copyright IBM Corp. 1996, 1997 You must install one of the IBM Library Readers provided on your CD-ROMs or one of the BookManager READ programs in order to view and search the online books and set up an online book library on your workstation. The CD-ROMs contain installation programs to help you do this. !--- Before You Begin ---------------------------------------------------! ! Make sure you are using code page 850 (the multilingual code page) ! ! with the IBM Online Library. If you are not using code page 850, ! ! BookManager may not run correctly. ! ! ! !------------------------------------------------------------------------! You may also use the installation programs later to: * Add or change devices such as hard drives and CD-ROM drives containing online books and bookshelves * Change your configuration files to point to these devices * Upgrade your Library Reader with a newer version If you already have a Library Reader installed on your workstation, run the installation program appropriate for your operating system (OS/2, DOS, or Windows). The installation program determines if the Library Reader on the CD-ROM is newer than the one installed on your workstation. You can then update the workstation reader, if necessary. If you already have BookManager READ or InfoSeeker installed, you do not need to install a Library Reader program, but you should: 1. Run the Library Reader/DOS installation program to update your configuration files to point the BookManager READ program to the devices containing books and bookshelves. 2. Update the BookManager environment variable in your CONFIG.SYS file to specify the path to the book and bookshelves by adding the pointers to the BOOKMGR statement in the CONFIG.SYS file. For example, if you want to point to the F drive, enter: f:\books;f:\shelves in the BOOKMGR statement. 13.0 Chapter 3. Installing or Updating the IBM Library Reader/2 ¸ Copyright IBM Corp. 1996, 1997 The installation program for IBM Library Reader/2 installs the Library Reader for the first time on your hard disk and updates your system configuration files to point to the books on your Online Library CD-ROM. If you have already installed Library Reader/2 or BookManager READ/2, you need to update your configuration files to point to the books on your new Online Library CD-ROM. 3.1 Software and Hardware Requirements for OS/2 ¸ Copyright IBM Corp. 1996, 1997 Required Software: IBM OS/2 Version 2.11 or later with corrective service XR06055 applied. Required Hardware * Any personal computer capable of running OS/2 V2.11 or later * Display device supported by the operating system (VGA or better resolution) * Any pointing device supported by OS/2 * 1.5 MB of RAM in addition to the storage required by OS/2 * 4.5 MB of hard-disk storage in addition to the storage required by OS/2 * One or more CD-ROM drives or the equivalent, and the equipment needed to attach them to your workstation Optional Hardware: An OS/2-supported printer 3.2 Installing or Updating from a CD-ROM ¸ Copyright IBM Corp. 1996, 1997 1. Insert the CD-ROM in the CD-ROM drive. 2. Go to an OS/2 command prompt to install Library Reader/2. 3. Switch to the drive letter of the CD-ROM drive that contains the Library Reader/2 program. If your CD-ROM drive is d: type d: and press enter. 4. Change to the directory on the CD-ROM that contains the Library Reader/2 program: type cd \ilros2 and press enter. If you are installing Library Reader/2 for the first time and do not have BookManager READ/2 installed, go to step 5. If you already have Library Reader/2 or BookManager READ/2 installed, update your CONFIG.SYS file to point to the books on your new CD-ROM: a. Specify the path to the book and bookshelves by adding a pointer to the READIBM (if you already have Library Reader/2 installed) or BOOKMGR (if you already have READ/2 installed) statement in the CONFIG.SYS file. For example, if you want to point to the F drive, enter: f:\books;f:\shelves in the READIBM statement. b. Go to step 10. 5. To start the Library Reader/2 installation program, type install and press enter. 6. After loading the installation files, the first panel of the installation program, IBM BookManager Library Reader/2 Installation is displayed. 7. Select Continue to start the install process. If you have previously installed Library Reader/2, do one of the following things: * Delete the version already installed and install the version on this CD-ROM * Update the version already installed 8. Continue the installation by following the information on the installation panels. For additional information during the installation, press Help or F1. 9. When the installation program is finished, the instructions on the panel tell you to either: * Start your Library Reader/2 (proceed to "Opening Your Online Library with Library Reader/2" in topic 3.3). * Reboot (shut down and restart) your system to activate the changes (proceed to step 10). 10. Reboot your OS/2 workstation: For OS/2 Version 2.11 or later with corrective service XR06055 applied: a. Click on your desktop (an unoccupied part of the screen). b. In the window that appears, select Shutdown. c. When the shutdown is complete, restart your system by pressing Ctrl+Alt+Del. For OS/2 WARP 3.0: a. Click on Shutdown on your LaunchPad. b. When the shutdown is complete, restart your system by pressing Ctrl+Alt+Del. 11. When your system is running again, you can open and use the IBM Library Reader/2 (proceed to "Opening Your Online Library with Library Reader/2" in topic 3.3). Notes: 1. The IBM Online Library folder icon from the previously installed Library Reader/2 is not removed from your OS/2 desktop when the new Library Reader/2 is installed. After you verify that the new Library Reader/2 program is installed and running to your satisfaction, you may remove the IBM Online Library folder icon and associated files from your OS/2 desktop. 2. The installation program makes the following changes in your CONFIG.SYS file. In this example, the default directory READIBM2 is used: SET PATH= It adds C:\READIBM2; SET HELP= It adds C:\READIBM2; LIBPATH= It adds C:\READIBM2; SET READIBM= It adds this statement with \books and \shelves for the drive you installed from, or, if this statement exists, it adds \books and \shelves for the drive you installed from The installation program also creates a Library Reader/2 folder. 3.3 Opening Your Online Library with Library Reader/2 ¸ Copyright IBM Corp. 1996, 1997 1. Choose the Online Library CD-ROM you want. 2. Insert the CD-ROM into the drive. Note: If you are using multiple CD-ROM drives, be sure that you put all of the Online Library CD-ROMs you plan to use in the drives before you start Library Reader/2 or BookManager READ/2 to open the IBM Online Library. 3. Open the Online Library. Start the Library Reader/2 program and display the list of available online library bookshelves. Select the method from the following table that matches the version of OS/2 you have installed: !-----------------------------!---------------------!--------------------! ! ! Library Reader/2: ! BookManager ! ! ! ! READ/2: ! !-----------------------------!---------------------!--------------------! ! OS/2 Window Command Prompt ! Enter: readibm /ds ! Enter: bookmgr /s ! ! Versions 2.0, 2.1, WARP ! ! ! ! 3.0: ! ! ! !-----------------------------!---------------------!--------------------! ! OS/2 Desktop: ! 1. Select the IBM ! N/A from desktop ! ! If you installed Library ! Online Library ! ! ! Reader/2 before or during ! folder. ! ! ! March 1996 ! 2. Click on the ! ! ! ! All Available ! ! ! ! Bookshelves ! ! ! ! icon. ! ! !-----------------------------!---------------------!--------------------! ! OS/2 Desktop: ! 1. Select the ! 1. Select the IBM ! ! If you installed Library ! Library ! BookManager ! ! Reader/2 after March 1996 ! Reader/2 ! folder. ! ! ! folder. ! 2. Select the ! ! ! 2. Click on the ! BookManager ! ! ! Library ! READ/2 folder. ! ! ! Reader/2 icon. ! 3. Click on the ! ! ! ! BookManager ! ! ! ! READ/2 icon. ! !-----------------------------!---------------------!--------------------! 4. When your BookManager Library Reader/2 or BookManager READ/2 starts, it displays a WELCOME panel from the screen, then displays a list of all the bookshelves that are available to you. This list can include: * The bookshelves on all the CD-ROMs in all your CD-ROM drives * The bookshelves on any other drives to which you have access * Your personal bookshelves (depending on how you customized your bookshelves, the list may only show your personal bookshelves); for information on customizing bookshelves, see the BookManager books in the Online Library Reference Bookshelf included on most Online Library CD-ROMs If this list is very long, you might want to sort it by title: a. Select View on the action bar; a pull-down window appears. b. Select Sort by ... or the type of sort you want. c. The Sort by ... choice opens a pop-up window in which you can select the sort by description or title. 5. Select a bookshelf and the list of books in the bookshelf appears on the screen. Follow the preceding instructions to sort by title if the list is very long. 6. Select the book you want to view or search. For instructions on using Library Reader/2, see IBM Online Library: Getting Started and Managing the Library, in the Online Library Reference Bookshelf included on most Online Library CD-ROMs. 3.3.1 Specifying Device Paths ¸ Copyright IBM Corp. 1996, 1997 If you cannot access a device that contains online books and bookshelves (such as a diskette drive, hard drive, or CD-ROM drive), you can specify either a temporary or permanent path to that device. 3.3.1.1 Specifying a Temporary Path ¸ Copyright IBM Corp. 1996, 1997 1. Select View on the Action bar. 2. From the pull-down window, select Change Path. 3. Specify the path to the books and bookshelves. For example, if you want to point to the F drive, enter: f:\books;f:\shelves. This path remains in effect until you exit the Library Reader/2 program. 3.3.1.2 Specifying a Permanent Path ¸ Copyright IBM Corp. 1996, 1997 To specify the path to the books and bookshelves, add pointers to the READIBM statement in the CONFIG.SYS file. For example, if you want to point to the F drive, enter: f:\books;f:\shelves in the READIBM statement. 3.4 Improving Viewing and Printing of the CKITLIST.TXT File on OS/2 Workstations ¸ Copyright IBM Corp. 1996, 1997 The following procedure shows how you can improve the on-screen viewing and printing of the CKITLIST.TXT (flat ASCII) file on OS/2 workstations. Use the Enhanced Editor for PM (EPM), which is shipped as part of OS/2, to view and print this file in a monospaced font presentation. 1. Open an OS/2 window. 2. Change to the directory containing the CKITLIST.TXT file. 3. Enter epm ckitlist.txt. 4. In the EPM window, select Command in the menu bar. 5. Select Command Dialog. 6. Enter monofont in the command line. 7. Press Enter or click OK. 14.0 Chapter 4. Installing or Updating the IBM Library Reader/DOS ¸ Copyright IBM Corp. 1996, 1997 The installation program for IBM Library Reader/DOS installs the Library Reader for the first time on your hard disk and updates your system configuration files to point to the books on your IBM Online Library CD-ROM. If you have already installed Library Reader/DOS or BookManager READ/DOS, you need to update your configuration files to point to the books on your new IBM Online Library CD-ROM. Note: If you are using Microsoft Windows, you must exit Windows before running the Library Reader/DOS installation program. 4.1 Software and Hardware Requirements for DOS ¸ Copyright IBM Corp. 1996, 1997 Required Software * DOS Release 3.3 or later * Microsoft MS-DOS CD-ROM extensions 2.0 or higher Required Hardware: * Any personal computer capable of running DOS Release 3.3 or later * Display device supported by the operating system (EGA, VGA, or better resolution is required for viewing vector raster images) * A minimum of 290 KB of memory (in addition to the memory required by the level of DOS you are using) * A hard disk with at least 1.5 MB available in addition to the storage required by DOS * One or more DOS-supported CD-ROM drives and the equipment needed to attach them to your workstation Optional Hardware: A DOS-supported printer 4.2 Installing or Updating from a CD-ROM ¸ Copyright IBM Corp. 1996, 1997 1. Insert the CD-ROM in the CD-ROM drive. 2. Go to a DOS command prompt. 3. Switch to the drive letter of the CD-ROM drive containing the Library Reader/DOS program. For example, if your CD-ROM drive is D: type d: and press Enter. 4. Change to the directory on the CD-ROM containing the Library Reader/DOS program: type cd \ilrdos and press Enter. You are now ready to do one of the following things: * Install Library Reader/DOS for the first time on your hard disk and update your system configuration file (AUTOEXEC.BAT) to point to the bookshelves and books on the CD-ROM. * Update or replace a previously installed Library Reader/DOS program. * Update your AUTOEXEC.BAT file to point to new devices containing bookshelves and books. * Update your AUTOEXEC.BAT file to point to the bookshelves and books on your new Online Library CD-ROM. 5. To start the Library Reader/DOS installation program, type INSTALL, then press Enter. 6. Read Panel 1, then press PgDn. 7. On Panel 2: a. Determine the selection that applies to your installation. The installation program automatically looks to see if a Library Reader/DOS or BookManager READ/DOS program is already installed on your workstation. If it finds a previously installed Library Reader, it determines if that one is as current as the one on your CD-ROM. The installation program tells you at the top of the panel if it found a Library Reader already installed. b. If you do not want the selection number the installation program has placed in the Selection Number box, you can type the number of your selection over it. c. Press PgDn to continue. 8. On Panel 3: a. Next to the line Drivers with IBM Library Books: make sure one of the boxes includes the drive letter of the CD-ROM drive containing the CD-ROM you want to access. If not, type the drive letter in one of the boxes. Note: While Panel 3 is displayed, you can add the drive letters of all hard drives, diskette drives, and CD-ROM drives containing online books you want to access. If you plan to download books from the CD-ROM, make sure to include the drive letter of the hard drive on which they resides. b. Make sure the Library Reader directory name specified on panel 3 is the name you want and the drive specified is where you want Library Reader/DOS installed. c. Make sure the Configuration file (AUTOEXEC.BAT) information is correct. d. When you are satisfied the information on panel 3 is correct, press F10 to complete the installation. 9. When the installation program is complete, it tells you if you must restart your system to make the changes effective. If you are told to restart your system, press Ctl+Alt+Del. Notes: 1. The installation program changes your AUTOEXEC.BAT file as follows: SET PATH= It appends C:\READIBM; SET READIBM= C:\READIBM\READIBM.PRO 2. The installation program creates the following profile: READIBM.PRO 3. The installation program changes your READIBM.PRO file as follows: -BPATH= It adds \books and \shelves for each drive specified if not already there. 4.3 Opening Your Online Library with BookManager Library Reader/DOS ¸ Copyright IBM Corp. 1996, 1997 1. Choose the IBM Online Library CD-ROM you want. 2. Insert the CD-ROM into the drive. Notes: a. If you are using multiple CD-ROM drives, be sure you put all of the Online Library CD-ROMs you plan to use in the drives before you start Library Reader/DOS or BookManager READ/DOS to open the Online Library. b. If you named your diskette drive when you installed your Online Library, you must also put a diskette in your diskette drive before opening the Online Library. 3. Open the IBM Online Library. To start Library Reader/DOS, go to a DOS command prompt and type: readibm *.bks To start BookManager READ/DOS, go to a DOS command prompt and type: bookmgr *.bks 4. When Library Reader/DOS or BookManager READ/DOS starts, it displays a WELCOME panel. Press Enter and a list of available bookshelves is presented. This list of bookshelves can include: * The bookshelves on all the CD-ROMs in all your CD-ROM drives * The bookshelves on any other drives to which you have access * Your personal bookshelves (depending on how you customized your bookshelves, the list might show only your personal bookshelves). For information on customizing bookshelves, see the Online Library Reference Bookshelf on most Online Library CD-ROMs. If this list is very long, you might want to sort it by title: a. Select View on the action bar; a pull-down window appears. b. Select Sort by ... or the type of sort you want. c. The Sort by ... choice opens a pop-up window in which you can select the sort by description or title. 5. Select a bookshelf and the list of books in the bookshelf appears on the screen. Follow the preceding instructions to sort by title if the list is very long. 6. Select the book you want to view or search. For instructions on using Library Reader/2, see BookManager READ/DOS and Library Reader/DOS: Displaying Online Books in the Online Library Reference Bookshelf included on most Online Library CD-ROMs. 4.3.1 Specifying Device Paths ¸ Copyright IBM Corp. 1996, 1997 If you cannot access a device containing online books and bookshelves (such as a diskette drive, hard drive, or CD-ROM drive), you can specify either a temporary or permanent path to that device: 4.3.1.1 Specifying a Temporary Path ¸ Copyright IBM Corp. 1996, 1997 1. Exit the Library Reader/DOS program. 2. Start the Library Reader/DOS from the command line and identify the path you want to temporarily use. For example, if you want to point to the F drive, enter: READIBM -bpath=f:\books; f:\shelves . This path remains in effect until you exit the Library Reader/DOS program. 4.3.1.2 Specifying a Permanent Path ¸ Copyright IBM Corp. 1996, 1997 1. Exit the Library Reader/DOS program. 2. Edit your READIBM.PRO file. 3. Update the line that says -bpath= to include the drive you want. For example, if you want to point to the F drive, enter f:\books; f:\shelves in the -bpath statement. 15.0 Chapter 5. Installing or Updating the IBM Library Reader for Windows on Windows 95 or NT ¸ Copyright IBM Corp. 1996, 1997 The installation program for Library Reader for Windows installs the Library Reader for the first time on your hard disk and updates your system configuration files to point to books on your new Online Library CD-ROM. If you have already installed Library Reader for Windows, you only need to update your configuration files to point to the books on your new Online Library CD-ROM. Notes: 1. If you have already installed BookManager READ for Windows, you do not need to install Library Reader for Windows but you should be sure BookManager READ for Windows has the paths it needs to find the books and bookshelves on your new Online Library CD-ROM. 2. Under Windows 95, the Library Reader for Windows runs as a 16-bit application. If you have questions or problems with installing or using the Online Library on Windows 95, contact the IBM Support Center at 1-800-237-5511. 5.1 Software and Hardware Requirements for Microsoft Windows ¸ Copyright IBM Corp. 1996, 1997 Required Software One of the following operating systems: * Microsoft Windows NT * Microsoft Windows 95 Optional Software Scalable fonts, for example: * TrueType (usually provided by Microsoft Windows) * Adobe Type I (may be provided by other products) Required Hardware * Any personal computer capable of running Windows 95 or NT * Display device supported by Windows 95 or NT (VGA or better resolution) * Any pointing device supported by Windows 95 or NT * 4 MB of RAM in addition to the storage required by Windows 95 or NT * 10 MB of hard-disk drive storage in addition to the storage required by Windows 95 or NT * One or more Windows-supported CD-ROM drives and the equipment needed to attach them to your workstation Optional Hardware: * A Windows-supported printer 5.2 Installing or Updating from a CD-ROM on Windows 95 or NT ¸ Copyright IBM Corp. 1996, 1997 These instructions assume your hard disk is C and your CD-ROM drive is D. If they are not, substitute the drive letters you are using for the letters shown in the examples. 1. Start Windows 95 or NT. 2. Click on the Start button. The Start menu appears. 3. Select the Run option. 4. The Run window appears. 5. In the Run window, if the following path does not appear: d:\ilrwin\install Then type this path: d:\ilrwin\install 6. Select the OK button. The message Please wait. Loading files... appears. Wait until the Install Library Reader for Windows 2.0.1 window appears with the Installation Instructions window already open. 7. Read the instructions in the Installation Instructions window. 8. Select the Continue button and wait until the Install window appears. Notes: a. In this window, you can choose not to have your AUTOEXEC.BAT file automatically updated by the install program. b. If you already have Library Reader for Windows installed, the Installation Options window appears instead of the Install window. You can choose to either update your existing Library Reader, or delete and reinstall it with the Library Reader on the CD-ROM. 9. In the Install window, select the OK button. 10. When the Install - directories window appears: a. Select program files. Notes: 1) You do not need to select documentation because the Library Reader for Windows books are available in the Online Library Reference Bookshelf on most Online Library CD-ROMs. You can also select the User's Guide from the Library Reader's Help window if a CD-ROM containing the Library Reader for Windows books is in your CD-ROM drive. 2) If you choose to install the documentation on your hard drive, be sure the following path appears For the Startup Path for Bookcases, Bookshelves and Books when the Install options - startup defaults window later appears: C:\BOOKS b. You can change the drive and directory name in which the program files are to be installed. The default is: C:\READIBMW If you want to change it, type your drive letter and directory name over the one shown. c. Select the Install button. The Install - progress window appears. When the installation is complete, the Install options - startup defaults window appears; it should show the paths to the bookcases, books, bookshelves, and notes. 11. In the Install options - startup defaults window, do as follows: a. For the Startup Path for Bookcases, Bookshelves and Books: 1) Add the paths for the \books and \shelves directories on your CD-ROM drive. For example: D:\BOOKS;D:\SHELVES If you have more than one CD-ROM drive, you can add the paths to them. If you plan to copy books to your hard disk, you can add the path to it as well. For example, if your hard disk is C and a second CD-ROM drive is E, the preceding example would now be: D:\BOOKS;D:\SHELVES;C:\BOOKS;C:\SHELVES;E:\BOOKS;E:\SHELVES 2) If Library Reader/DOS is also installed, this window shows the paths defined for it as well. You should remove the path to the Library Reader/DOS books: C:\READIBM b. For the Startup Path for Notes: 1) Make sure the path for the notes directory is the same as the directory in which the program files were installed. 2) If you have Library Reader/DOS installed, it shows this path: C:\READIBM. You must expand this to: C:\READIBMW 3) Select the OK button. The Installation and Maintenance window appears and should indicate the installation was a success. You do not need to remove the CD-ROM from the drive. 12. In the Installation and Maintenance window, select the OK button and the Install Library Reader for Windows 2.0.1 window reappears. Note: If you do not have SHARE or another file locking program, a window for installing such a program appears. Select the OK button in that window. 13. In the Install Library Reader for Windows 2.0.1 window, select the Exit button and an icon for Library Reader for Windows appears on your desktop. 14. Exit Windows. 15. Reboot your system. 16. When your system is running again, you can open and use the Library Reader for Windows (proceed to "Opening Your Online Library on Windows 95 or Windows NT" in topic 5.3). Note: If you previously installed BookManager READ for Windows and you just installed the Library Reader for Windows, the file associations for the books and bookshelves (files with extensions of .BOO and .BKS) that were made when you installed READ for Windows are changed by those for the Library Reader. (File associations are made for the last BookManager program you install.) You can do one of the following: * If you want to associate BookManager READ for Windows with these files, you must change the file associations back to READ for Windows. File associations are stored in the Windows registry. Use the REGEDIT command to change the Windows registry. Or, * Add BookManager READ for Windows to your Send to folder in the Windows directory. 5.3 Opening Your Online Library on Windows 95 or Windows NT ¸ Copyright IBM Corp. 1996, 1997 1. Insert the IBM Online Library CD-ROM into the CD-ROM drive. Note: If you are using multiple CD-ROM drives, be sure you put all of the Online Library CD-ROMs you plan to use in the drives before starting Library Reader or BookManager READ to open the Online Library. 2. Open the Online Library. You can access books in two ways: using icons to start the Library Reader for Windows or BookManager READ for Windows, or by using My Computer to directly locate and open a specific book. * Using Icons to Access the Online Library on Windows 95 or NT a. Click on the Start button. b. Select the Programs option. c. Select the Library Reader for Windows or BookManager READ for Windows group. d. In the Library Reader or BookManager READ group, select the icon for Library Reader for Windows or BookManager READ for Windows. Library Reader for Windows or BookManager READ for Windows starts and displays an About ... window. This window then disappears from the screen, and you see a list of the bookshelves available to you. This list may include: - The bookshelves on all the CD-ROMs in all your CD-ROM drives - The bookshelves on any other drives to which you have access - Your personal bookshelves (depending on how you customized your bookshelves, the list may only show your personal bookshelves); for information on customizing bookshelves, see the Online Library Reference Bookshelf included on most Online Library CD-ROMs. If this list is very long, you may want to sort it by title: 1) Select View on the action bar; a pull-down window appears. 2) Select Sort >; this opens a pop-up window in which you can select the sort by title. e. Select a bookshelf and the list of books in the bookshelf appears on the screen. Follow the preceding instructions to sort by title if the list is very long. f. Select the book you want to view or search. For instructions on using Library Reader for Windows, see BookManager READ for Windows: User's Guide in the Online Library Reference Bookshelf included on most Online Library CD-ROMs. g. To create and work with bookcases, go to the Library Reader for Windows or BookManager READ for Windows group, and select the icon for List of Bookcases. * Using My Computer to Access the Online Library on Windows 95 or NT a. Select the My Computer icon b. In the My Computer window, select a drive icon for the drive containing books. c. In the list of directories for that drive, select a directory containing books (a directory named \books is commonly used for storing books). d. In the list of files for that directory, select a book (filename.BOO) you want to open. Library Reader for Windows or BookManager READ for Windows displays first an About ... window, then the book you selected. For instructions on using Library Reader for Windows, see BookManager READ for Windows: User's Guide in the Online Library Reference Bookshelf included on most Online Library CD-ROMs. 5.4 Specifying Device Paths ¸ Copyright IBM Corp. 1996, 1997 If you cannot access a device containing online books and bookshelves (such as a diskette drive, hard drive, or CD-ROM drive), you can temporarily look at the books and bookshelves on that device, or you can permanently change the path to that device. 5.4.1 Specifying a Temporary Path ¸ Copyright IBM Corp. 1996, 1997 1. Select FILE. 2. From the FILE pull-down window, choose List Books or List Bookshelves. 3. Choose the directories you would like to see. 4. Choose OK. 5.4.2 Specifying a Permanent Path ¸ Copyright IBM Corp. 1996, 1997 1. Select the Options pulldown window. 2. From the pull-down window, select Startup Defaults. 3. In the Startup Path for Bookshelves and Books, specify the path to the books and bookshelves. For example, if you want to point to the F drive, enter: f:\books;f:\shelves. 4. Choose OK. This is stored and used the next (and each) time you run the IBM Library Reader for Windows program. 16.0 Chapter 6. Installing or Updating the IBM Library Reader for Windows 3.1 or WIN-OS/2 ¸ Copyright IBM Corp. 1996, 1997 The installation program for Library Reader for Windows installs the Library Reader for the first time on your hard disk and updates your system configuration files to point to books on your new Online Library CD-ROM. If you have already installed Library Reader for Windows, you need to update your configuration files to point to the books on your new Online Library CD-ROM. Notes: 1. If you have already installed BookManager READ for Windows, you do not need to install Library Reader for Windows but you should be sure BookManager READ for Windows has the paths it needs to find the books and bookshelves on your new Online Library CD-ROM. 6.1 Software and Hardware Requirements for Microsoft Windows ¸ Copyright IBM Corp. 1996, 1997 Required Software One of the following operating systems: * Microsoft Windows Version 3.1 in 386 enhanced mode * IBM OS/2 Version 2.11 or 3.0 (Warp) with WIN-OS/2 installed Optional Software Scalable fonts, for example: * TrueType (usually provided by Microsoft Windows 3.1 or OS/2) * Adobe Type I (may be provided by other products) Required Hardware * Any personal computer capable of running the Windows operating system * Display device supported by Windows 3.1 (VGA or better resolution) * Any pointing device supported by Windows 3.1 * 4 MB of RAM in addition to the storage required by Windows * 10 MB of hard-disk drive storage in addition to the storage required by Windows * One or more Windows-supported CD-ROM drives and the equipment needed to attach them to your workstation Optional Hardware: * A Windows 3.1-supported printer 6.2 Installing or Updating from a CD-ROM on WIN-OS/2 or Windows 3.1 ¸ Copyright IBM Corp. 1996, 1997 These instructions assume your hard disk is C and your CD-ROM drive is D. If they are not, substitute the drive letters you are using for the letters shown in the examples. 1. Start Windows. For OS/2 workstations with WIN-OS/2: a. Open the Command Prompts folder. b. Select the WIN-OS/2 icon. For Microsoft Windows 3.1 workstations (if you are not already in Windows): a. Go to the DOS command prompt. b. Type win. 2. Insert the IBM Online Library CD-ROM in the CD-ROM drive. 3. Go to the Program Manager window and select File from the action bar. 4. In the pull-down window, select the Run... option. The Run window appears. 5. In the Run window, type the following: d:\ilrwin\install 6. Select the OK button. The message Please wait. Loading files... appears. Wait until the Install Library Reader for Windows 2.0.1 window appears with the Installation Instructions window already open. 7. Read the instructions in the Installation Instructions window. 8. Select the Continue button and wait until the Install window appears. Notes: a. In this window, you can choose not to have your AUTOEXEC.BAT file automatically updated by the install program. b. If you already have Library Reader for Windows installed, the Installation Options window appears instead of the Install window. You can choose to either update your existing Library Reader, or delete and reinstall it with the Library Reader on the CD-ROM. 9. In the Install window, select the OK button. 10. When the Install - directories window appears: a. Select program files. Notes: 1) You do not need to select documentation because the Library Reader for Windows books are available in the Online Library Reference Bookshelf on most Online Library CD-ROMs. You can also select the User's Guide from the Library Reader's Help window if a CD-ROM containing the Library Reader for Windows books is in your CD-ROM drive. 2) If you choose to install the documentation on your hard drive, be sure the following path appears For the Startup Path for Boocases, Bookshelves and Books when the Install options - startup defaults window later appears: C:\BOOKS b. You can change the drive and directory name in which the program files are to be installed. The default is: C:\READIBMW If you want to change it, type your drive letter and directory name over the one shown. c. Select the Install button. The Install - progress window appears. When the installation is complete, the Install options - startup defaults window appears; it should show the paths to the bookcases, books, bookshelves, and notes. 11. In the Install options - startup defaults window, do as follows: a. For the Startup Path for Bookcases, Bookshelves and Books: 1) Add the paths for the \books and \shelves directories on your CD-ROM drive. For example: D:\BOOKS;D:\SHELVES If you have more than one CD-ROM drive, you can add the paths to them. If you plan to copy books to your hard disk, you can add the path to it as well. For example, if your hard disk is C and a second CD-ROM drive is E, the preceding example would now be: D:\BOOKS;D:\SHELVES;C:\BOOKS;C:\SHELVES;E:\BOOKS;E:\SHELVES 2) If Library Reader/DOS is also installed, this window shows the paths defined for it as well. You should remove the path to the Library Reader/DOS books: C:\READIBM b. For the Startup Path for Notes: 1) Make sure the path for the notes directory is the same as the directory in which the program files were installed. 2) If you have Library Reader/DOS installed, it shows this path: C:\READIBM. You must expand this to: C:\READIBMW 3) Select the OK button. The Installation and Maintenance window appears and should indicate the installation was a success. You do not need to remove the CD-ROM from the drive. 12. In the Installation and Maintenance window, select the OK button and the Install Library Reader for Windows 2.0.1 window reappears. Note: If you do not have SHARE or another file locking program, a window for installing such a program appears. Select the OK button in that window. 13. In the Install Library Reader for Windows 2.0.1 window, select the Exit button and an icon for Library Reader for Windows appears in the Program Manager window. 14. Exit Windows. 15. Reboot your system. 16. When your system is running again, you can open and use the Library Reader for Windows (proceed to "Opening Your Online Library on Windows 3.1 or WIN-OS/2" in topic 6.3). Note: If you previously installed BookManager READ for Windows and you just installed the Library Reader for Windows, the file associations for the books and bookshelves (files with extensions of .BOO and .BKS) that were made when you installed READ for Windows are changed by those for the Library Reader. (File associations are made for the last BookManager program you install.) If you want to associate BookManager READ for Windows with these files, you must change the file associations back to READ for Windows. 6.3 Opening Your Online Library on Windows 3.1 or WIN-OS/2 ¸ Copyright IBM Corp. 1996, 1997 1. Insert the IBM Online Library CD-ROM into the CD-ROM drive. Note: If you are using multiple CD-ROM drives, be sure you put all of the Online Library CD-ROMs you plan to use in the drives before starting Library Reader or BookManager READ to open the Online Library. 2. Open the Online Library. You can access books in two ways: using icons to start the Library Reader for Windows or BookManager READ for Windows, or by using File Manager to directly locate and open a specific book. * Using Icons to Access the Online Library with Windows 3.1 or WIN-OS/2 a. Go to the Program Manager window and select the icon for Library Reader for Windows group or BookManager READ for Windows group. b. In the Library Reader for Windows or BookManager READ for Windows window, select the icon for Library Reader for Windows or BookManager READ for Windows. Library Reader for Windows or BookManager READ for Windows starts and displays an About ... window. This window then disappears from the screen, and you see a list of the bookshelves available to you. This list may include: - The bookshelves on all the CD-ROMs in all your CD-ROM drives - The bookshelves on any other drives to which you have access - Your personal bookshelves (depending on how you customized your bookshelves, the list may only show your personal bookshelves); for information on customizing bookshelves, see the Online Library Reference Bookshelf included on most Online Library CD-ROMs. If this list is very long, you may want to sort it by title: 1) Select View on the action bar; a pull-down window appears. 2) Select Sort >; this opens a pop-up window in which you can select the sort by title. c. Select a bookshelf and the list of books in the bookshelf appears on the screen. Follow the preceding instructions to sort by title if the list is very long. d. Select the book you want to view or search. For instructions on using Library Reader for Windows, see BookManager READ for Windows: User's Guide in the Online Library Reference Bookshelf included on most Online Library CD-ROMs. e. To create and work with bookcases, go to the Library Reader for Windows or BookManager READ for Windows window, and select the icon for List of Bookcases. * Using File Manager to Access the Online Library with Windows 3.1 or WIN-OS/2 a. Go to the Main window and select the icon for File Manager. b. In the File Manager window, select a drive icon for a drive containing books. c. In the list of directories for that drive, select a directory containing books (a directory named \books is commonly used for storing books). d. In the list of files for that directory, select a book (filename.BOO) you want to open. Library Reader for Windows or BookManager READ for Windows displays first an About ... window, then the book you selected from File Manager. For instructions on using Library Reader for Windows, see BookManager READ for Windows: User's Guide in the Online Library Reference Bookshelf included on most Online Library CD-ROMs. 6.4 Specifying Device Paths ¸ Copyright IBM Corp. 1996, 1997 If you cannot access a device containing online books and bookshelves (such as a diskette drive, hard drive, or CD-ROM drive), you can temporarily look at the books and bookshelves on that device, or you can permanently change the path to that device. 6.4.1 Specifying a Temporary Path ¸ Copyright IBM Corp. 1996, 1997 1. Select FILE. 2. From the FILE pull-down window, choose List Books or List Bookshelves. 3. Choose the directories you would like to see. 4. Choose OK. 6.4.2 Specifying a Permanent Path ¸ Copyright IBM Corp. 1996, 1997 1. Select the Options pulldown window. 2. From the pull-down window, select Startup Defaults. 3. In the Startup Path for Bookshelves and Books, specify the path to the books and bookshelves. For example, if you want to point to the F drive, enter: f:\books;f:\shelves. 4. Choose OK. This is stored and used the next (and each) time you run the IBM Library Reader for Windows program. 17.0 Chapter 7. Using the Online Library on an AS/400 System ¸ Copyright IBM Corp. 1996, 1997 You can share the IBM Online Library on your AS/400 System using InfoSeeker on the AS/400 System to read books or using a BookManager Library Reader on an AS/400-attached workstation. AS/400 InfoSeeker became part of the Operating System/400 in Version 3 Release 1. It is a version of the BookManager Library Reader specially designed for use on the AS/400 System. With InfoSeeker, you can view online books from any workstation, including non-programmable workstations. The PC-based Library Reader programs provide features not available with InfoSeeker, including allowing you to: * Display the pictures in the books * Add margin notes to the books * Print topics with better quality * Print pictures On AS/400 Advanced Series systems using PowerPC technology and OS/400 Version 3 Release 6, you can install online books on the system by using the AS/400 CD-ROM drive. See "Installing Books on AS/400 Version 3 Release 6" in topic 7.5 for the procedure to do this. On Version 3 Release 1 systems, you can transfer online books from your CD-ROM to an AS/400 directory. You must do this if you want to view the books using InfoSeeker from a non-programmable workstation attached to an AS/400 System. You can also use the Online Library CD-ROM from a CD-ROM drive on a workstation. 7.1 Installing and Using InfoSeeker on Your AS/400 System ¸ Copyright IBM Corp. 1996, 1997 For information on setting up an IBM Online Library and using InfoSeeker, see: * AS/400 InfoSeeker: Getting Started, SC41-3001 (V3R1) * AS/400 InfoSeeker: Use, SC41-3002 (V3R1) * AS/400 InfoSeeker: Getting Started, SC41-4001 (V3R6) * AS/400 InfoSeeker: Use, SC41-4002 (V3R6) Once the books are installed, you start InfoSeeker by entering strinfskr on the AS/400 command line. 7.2 Using Directories on the AS/400 System to Share the Online Library ¸ Copyright IBM Corp. 1996, 1997 Client Access for OS/400 allows you to share the IBM books and bookshelves among several users who have programmable workstations. Each workstation can have the IBM Library Reader installed or you can install the IBM Library Reader in a shared AS/400 directory. For more information on setting up and using these directories, see the book for the client you are using: * Client Access/400 for Windows 3.1 User's Guide, SC41-3532 * Client Access/400 for DOS Extended Memory User's Guide, SC41-3501 * Client Access/400 for OS/2 User's Guide, SC41-3521 * Client Access/400 for DOS User's Guide, SC41-3557 * Client Access/400 Optimized for OS/2 - Getting Started, SC41-3510 7.3 Using the SCRT to Install Books to an AS/400 System Directory ¸ Copyright IBM Corp. 1996, 1997 You can use the Softcopy Receiver Tool (SCRT) to transfer the IBM Online Library from a CD-ROM on your personal computer to a directory on an AS/400 System. See Chapter 8, "Transferring Books To Your Workstation or Host with the Softcopy Receiver Tool" in topic 8.0 for instructions on using the SCRT. Note the following considerations for AS/400 when running SCRT V1.3: * The SCRT cannot install to a root drive on an AS/400 System. * A drive must be assigned to the AS/400 System directory. When using Client Access for AS/400, PC drive letters can be assigned to AS/400 directories (or folders). Normally, the IBM Online Library is installed to the QBKBOOKS/BOOKS folder on the AS/400. Therefore, the PC drive letter should be assigned to QBKBOOKS. For example, if drive j is assigned to QBKBOOKS on AS/400, the destination path for installing the library using SCRT would be j:\books. 7.4 Copying IBM Books to an AS/400 System Directory ¸ Copyright IBM Corp. 1996, 1997 The following examples assume D is the drive letter for the CD-ROM drive, \BOOKS is the directory containing the books on the CD-ROM, I is the drive letter assigned to the AS/400 System, and \QBKBOOKS\BOOKS is the directory to contain the Client Access for OS/400 books on the AS/400 System. Note: The QBKBOOKS/BOOKS directory is created when OS/400 is installed. It is the default directory for online books. The examples also assume you are copying the Client Access for OS/400 bookshelf and books. The file names for most Client Access for OS/400 books and its bookshelf begin with the letters QBKAK (V3R1) or QBJAK (V3R6). If you want to use different books or directories, substitute their names for the names used in the examples. To copy IBM books and bookshelves from a CD-ROM to a Client Access for OS/400 folder, follow these instructions: 1. Switch to the drive letter assigned to the AS/400 System. Type: i: 2. Copy the books you want in the folder from the CD-ROM with the COPY or XCOPY command. Type: copy d:\books\qbkak*.boo i:\qbkbooks\books copy d:\shelves\qbkak*.bks i:\qbkbooks\books copy d:\books\qbkak*.bki i:\qbkbooks\books You can also use the SCRT to install the books to the AS/400 System. Simply specify the path to the AS/400 directory as the target for the SCRT. Users can now access the books and bookshelves by assigning the directory drive to their workstations and identifying that drive to the Library Reader installation program if they are installing the IBM Library Reader on their workstations. Users of InfoSeeker can also access the books once they are installed in the directory. If the books are placed in a directory other than qbkbooks/books, you must define the directory to InfoSeeker. Use the Work with System Value (WRKSYSVAL) OS/400 control language command to specify the folder path in the QBOOKPATH system value. The paths specified for QBOOKPATH (up to five paths can be defined) must be of the form: /QDLS/directory to correctly access the library in the directory. For example, the default value is: /QDLS/QBKBOOKS/BOOKS 7.5 Installing Books on AS/400 Version 3 Release 6 ¸ Copyright IBM Corp. 1996, 1997 To install books to an AS/400 System from the AS/400 CD-ROM drive, place the CD-ROM in the drive. Enter: rstshf *shelf shelf(*list) dev(optical-device) vol(volume-name) on the AS/400 command line. optical-device is the name assigned to your CD-ROM drive on the AS/400 System (normally opt01); volume-name is the internal identifier of the CD-ROM platter. To determine the volume name, use the Work with Optical Volume (WRKOPTVOL) OS/400 control language command. A list of bookshelves is presented so you can select the ones you want to install. You can also choose whether you want the books installed to the AS/400 System (the bookshelves and bookshelf index files will be installed). To access books directly from the CD-ROM, you must identify the CD-ROM volume to InfoSeeker. Use the Work with System Value (WRKSYSVAL) OS/400 control language command to specify the folder path in the QBOOKPATH system value. To access books and bookshelves from the CD-ROM, you do not need to install anything to the AS/400 System. Simply use the WRKSYSVAL command to identify the BOOKS and SHELVES directories on the CD-ROM to InfoSeeker. The paths specified for QBOOKPATH (up to five paths can be defined) must be of the form: /QOPT/volume-name/directory to correctly access the CD-ROM. The QBOOKPATH system value can contain paths to directories (QDLS) and the CD-ROM (QOPT). See the book AS/400 Softcopy Library and Information Directory CD-ROMs, SK2T-2839, for complete descriptions of these procedures. 18.0 Chapter 8. Transferring Books To Your Workstation or Host with the Softcopy Receiver Tool ¸ Copyright IBM Corp. 1996, 1997 You can use the Softcopy Receiver Tool (SCRT) to select and receive online books and bookshelves from IBM Online Library CD-ROMs onto your OS/2 or Windows (95 or NT) workstation or to DASD on your MVS, OS/390, or VM host system. 8.1 Using SCRT/MVS or SCRT/VM ¸ Copyright IBM Corp. 1996, 1997 These programs handle the transfer of publications from distribution tapes and CD-ROMs on an MVS, OS/390, or VM host to host DASD The books, bookshelves, and search indexes are transferred from a host tape drive or a CD-ROM drive that is attached to the host through IBM S/370 and S/390 Optical Media Attach/2 to DASD on the host. Refer to IBM S/370 and S/390 Optical Media Attach/2 User's Guide, SC53-1200, and IBM Softcopy Receiver Tool: User's Guide, GC23-3663, for more information. An online version of the SCRT User's Guide is included in the IBM Online Library Reference Bookshelf, available on many IBM Online Library CD-ROMs. 8.2 Using SCRT/OS2, or SCRT/WIN95, or SCRT/WINNT ¸ Copyright IBM Corp. 1996, 1997 These programs handle the transfer of publications from CD-ROMs at a workstation to a hard disk on a workstation or LAN server or to DASD on an MVS, OS/390, or VM host. The books, bookshelves, and search indexes are transferred from a CD-ROM drive that is attached to your workstation to a hard disk on your own workstation or on an accessible workstation or LAN server or to DASD on your host. These programs offer the following alternatives for file transfer: * SEND support--uses a 3270 terminal emulator SEND command to transfer the selected files to your chosen host * FTP support--uses File Transfer Protocol to transfer the selected files to your chosen host * NFS support--uses Network File System to copy the selected files to NFS-mounted MVS or OS/390 DASD accessed as a drive letter on your workstation * Copy support-- copies the selected files to a local or remote drive accessed as a drive letter on your workstation For OS/2, run the program d:\SCRT\SCRT2\EBRSCRT2.EXE For Windows95 or WindowsNT, run the program d:\SCRT\SCRTW\EBRSCRTW.EXE where "d:" is your CD-ROM drive letter. For more information, refer to the online Help available via the action bar. 8.3 Using the SCRT on AS/400 ¸ Copyright IBM Corp. 1996, 1997 If you are using the SCRT to copy books to an AS/400 directory, you must first assign a drive letter to the target AS/400 directory. See "Using the SCRT to Install Books to an AS/400 System Directory" in topic 7.3 for more information. 19.0 Chapter 9. Using the Online Library on an MVS, OS/390, or VM Host ¸ Copyright IBM Corp. 1996, 1997 You can install and use the IBM Online Library on MVS, OS/390 and VM host systems. * To estimate the DASD storage you need, see "Estimating Host DASD Storage Requirements" in topic 9.1. * To upload books, bookshelves, and bookshelf search indexes to your host, see "Uploading Books, Bookshelves, and Search Indexes" in topic 9.2. * To make bookshelves available to BookManager READ/MVS, READ/VM, or the reader provided with OS/390, see "Making Bookshelves Available to IBM Host Readers" in topic 9.3. 9.1 Estimating Host DASD Storage Requirements ¸ Copyright IBM Corp. 1996, 1997 If you are uploading files to a host, you can use the following table to determine the approximate number of tracks or cylinders you need. !--------!-----------------!------------------!--------------------------! ! Device ! MB/Track ! MB/Cylinder ! Tracks/Cylinder ! !--------!-----------------!------------------!--------------------------! ! 3380 ! .047 ! .712 ! 15 ! !--------!-----------------!------------------!--------------------------! ! 3390 ! .056 ! .849 ! 15 ! !--------!-----------------!------------------!--------------------------! ! 9340 ! .047 ! .712 ! 15 ! !--------!-----------------!------------------!--------------------------! ! Formulas: ! ! ! ! 1. MB to upload = MB of books + MB of bookshelves + MB of bookshelf ! ! search indexes ! ! 2. Approximate tracks = MB to upload ö MB per track ! ! or ! ! Approximate cylinders = MB to upload ö MB per cylinder ! ! ! !------------------------------------------------------------------------! 9.2 Uploading Books, Bookshelves, and Search Indexes ¸ Copyright IBM Corp. 1996, 1997 You can transfer books, bookshelves, and search indexes from a workstation to an MVS, OS/390, or VM host and use them with BookManager READ/MVS READ/VM, or with the reader provided with OS/390. You do not need to rebuild the books or re-create the bookshelves and search indexes when you move them from your workstation to a host. The BookManager READ format for online books on the workstation is the same as it is on the host. The remainder of this section describes three ways to move books, bookshelves, and bookshelf search indexes to an MVS, OS/390 or VM host. 9.2.1 Using the Softcopy Receiver Tool to Upload to a Host ¸ Copyright IBM Corp. 1996, 1997 You can use the IBM Softcopy Receiver Tool (SCRT), program number 5648-032, to select and transfer online books and bookshelves from IBM CD-ROMs or IBM distribution tapes to a target host data set or filemode you specify. There are two methods for doing this: 1. Using SCRT/MVS or SCRT/VM: These programs handle the transfer of publications from distribution tapes and CD-ROMs on an MVS, OS/390, or VM host to host DASD. The books, bookshelves, and search indexes are transferred from a host tape drive or a CD-ROM drive that is attached to the host through IBM S/370 and S/390 Optical Media Attach/2 to DASD on the host. To transfer online books from a CD-ROM or tape drive attached to an MVS, OS/390, or VM host to host DASD, the SCRT requires IBM S/370 and S/390 Optical Media Attach/2. Refer to IBM S/370 and S/390 Optical Media Attach/2 User's Guide, SC53-1200, included in the Online Library Reference bookshelf included on most Online Library CD-ROMs. For more information, refer to IBM SCRT User's Guide, GC23-3663, included in the Online Library Reference bookshelf included on most Online Library CD-ROMs. 2. Using SCRT/OS2, SCRT/WIN95, or SCRT/WINNT: These programs handle the transfer of publications from CD-ROMs at a workstation to a hard disk on a workstation or LAN server or to DASD on an MVS, OS/390, or VM host. The books, bookshelves, and search indexes are transferred from a CD-ROM drive that is attached to your workstation to a hard disk on your own workstation or an accessible workstation or LAN server or to DASD on your host. To transfer online books from a CD-ROM at your workstation to DASD on an MVS, OS/390, or VM host, SCRT V2.3 offers 3 alternatives, all of which first allow you to select all or certain publications: * SEND support -- uses a 3270 terminal emulator SEND command to transfer the selected files to your chosen host. * FTP support -- uses File Transfer Protocol to transfer the selected files to your chosen host. * NFS support -- uses Network File System to copy the selected files to NFS-mounted MVS or OS/390 DASD accessed as a drive letter on your workstation For more information, invoke either d:\SCRT\SCRTW\EBRSCRTW.EXE (Windows) or d:\SCRT\SCRT2\EBRSCRT2.EXE (OS/2), where "d:" is your CD-ROM drive letter, on any Online Library CD-ROM, and then refer to the Help options in the action bar. 9.2.2 Using the Bookshelf Upload Programs to Upload to a Host ¸ Copyright IBM Corp. 1996, 1997 Online Library CD-ROMs include IBM Bookshelf Upload programs that help you upload complete bookshelves from a CD-ROM drive to an MVS, OS/390, or VM host. These programs upload all the files associated with a bookshelf as a group. The group includes the bookshelf file and all the book and bookshelf search index files. The EZ2UCDM program for MVS or OS/390 and EZ2UCDV program for VM create a series of SEND commands that upload all the files. You must have a 3270 terminal emulator that supports the SEND capability or the equivalent. If you are using these programs on an OS/2 workstation, you must use them in an OS/2 window. 9.2.2.1 Creating the Upload Command and Batch Programs ¸ Copyright IBM Corp. 1996, 1997 The following example assumes C is the drive letter for your hard disk, \upload is the directory you want to put the upload programs into, and D is the drive letter for your CD-ROM drive. If you use a different drive letter or directory name, replace them in the following examples with the directory and drive letters you are using. 1. Select the hard disk on which you want to put the upload programs: c: 2. Create a directory on that hard disk to hold the upload programs and the files they create: md \upload 3. Change your current directory to the one you just created: cd \upload 4. Copy the upload programs to the directory you are using. For MVS or OS/390: copy d:\upload\ez2ucdm.exe For MVS (Windows/NT users): copy d:\upload\ez2winm.exe For VM: copy d:\upload\ez2ucdv.exe 5. Start the EZ2UCDM or EZ2UCDV program. For MVS or OS/390: ez2ucdm For VM: ez2ucdv For Windows/NT and MVS: ez2winm The program starts and you see the message: Type the 1-character CD-ROM drive letter (for example, g) or type a drive letter and the path to the BookManager files (for example, g:\books). Then press ENTER. Drive letter or path ===> 6. You must tell the program where the BookManager files are located by doing one of the following ways: * Specifying the one-character CD-ROM drive letter; in which case the program searches the entire CD-ROM. If you are uploading files only from a CD-ROM, then IBM recommends you specify only its one-character drive letter. For example, if you want to upload BookManager files from a CD-ROM in drive D, type: Drive letter or path ===> d then continue with step 8. * Specifying paths to multiple directories, which can be on multiple disks. If you want to upload BookManager files on one of your hard disks and files from the CD-ROM, specify the drive letter and path of one of the directories containing BookManager files. For example, if you have created a personal bookshelf in directory C:\SHELVES, type: Drive letter or path ===> c:\shelves Continue with the next step. 7. If you previously entered a drive letter and path, you see the following message: Type an additional path to other BookManager files or leave blank if there are no more directories. Then press ENTER. Path ===> Type the drive letter and path to another directory containing BookManager files, and press Enter. You are then prompted to enter another directory. Continue entering the directories containing the BookManager files. When you have specified all of the directories, press Enter without typing a path; you are shown the next message. 8. Identify the destination of the files. For MVS or OS/390 you see this message: Type the high-level qualifiers for the data sets containing the files (for example, ibmbk). Then press ENTER. High-level qualifiers ===> Type the high-level qualifiers you want to use for the data sets on your MVS or OS/390 host. For example: High-level qualifiers ===> ibmbk Note: You should limit the number of MVS or OS/390 data set qualifiers to one or two. The EZ2UCDM program adds up to three additional qualifiers, shelf-name.book-name.type, to the names you supply. If the TSO users on your MVS or OS/390 system use a default high-level data set prefix that is not their user ID, you should use only one high-level qualifier and limit it to five characters (for example, IBMBK). These data set names start with sysprefix.userid. The sysprefix can contain eight characters; the userid can contain seven. After EZ2UCDM adds shelf-name.book-name.type, there is room only for an additional five-character, high-level qualifier if you want to ensure the user can create BookManager notes. For VM you see this message: Type the 1-character file mode of the minidisk where the files are to be placed (for example, a). Then press ENTER. Minidisk file mode ===> Type the mode letter of the minidisk you want to use on your VM host. Minidisk file mode ===> a Note: Any VM files or MVS or OS/390 data sets on your host with the same names as the files you are uploading are deleted and replaced. Press Enter. 9. Identify the 3270 session you want to use in response to this message: Type the 1-character ID identifying the 3270 session you want to use for the file transfers. Then press ENTER. If you do not specify a session, the first 3270 session you started is used. If your 3270 terminal emulator supports only a single 3270 session, just press ENTER. 3270 host session ===> Type the letter of the session you want to use, and press Enter. 3270 host session ===> a If your emulator only provides a single 3270 session, don't type anything; just press Enter. After you press Enter, you see the next message. Press Enter. 10. A summary of the information you have typed appears on your screen. Make sure you entered all the information correctly. For MVS or OS/390: You specified the following: Paths to the BookManager files: c:\shelves d:\books High-level qualifiers : IBMBK 3270 session ID : A Are these values correct ( Y ] N )? ===> For VM: You specified the following: Paths to the BookManager files: c:\shelves d:\books Minidisk file mode : A 3270 session ID : A Are these values correct ( Y ] N )? ===> If you are satisfied with the information, type Y and press Enter. You see the next message. Otherwise, type N and press Enter; the program repeats the previous questions, and you can change your answers. When you are satisfied, type Y on this panel and press Enter. This message appears on your screen: Now locating all the bookshelves so you can select the ones you want to upload to the host. 11. Wait until this list of names and descriptions of the bookshelves appears: Select the bookshelves to upload by pressing the: * Space bar to select and deselect entries to upload. * Up and down arrow keys to scroll the list of shelves. * Enter key when you have made all of your selections. Bookshelves 1 to 14 of 23 Shelf Date Title Upload? -______- -______- -________________________________________- -_____- EZ2ccnnn yy/mm/dd description . . . Use the up and down arrow keys to scroll through the list. To select a bookshelf to upload, press the Space bar when the cursor is on the row containing the name of a bookshelf you want. If you incorrectly selected a bookshelf, press the Space bar again to de-select it. You can also use the Y and N keys to select and de-select entries. The bookshelves you select are identified with a Y in the Upload column. After you have selected all the bookshelves you want to upload, press the Enter key. The EZ2UCDM or EZ2UCDV program creates the command or batch files you can use to upload the bookshelves to the host. The primary file created is SHELVES.CMD (for OS/2) or SHELVES.BAT (for DOS). These files are created in the current directory (c:\upload or the directory you used). Note: You can use the All-Collection or All-Disc bookshelves on an Online Library CD-ROM or set of CD-ROMs to upload all the books for one CD-ROM or an entire set at one time. You are now ready to upload the bookshelves. If you are uploading to an MVS or OS/390 host, continue with the instructions in "Allocating MVS or OS/390 Data Sets When You Upload Files" in topic 9.2.2.2. If you are uploading to VM, continue with the instructions in "Uploading the IBM Bookshelves to the Host" in topic 9.2.2.3. 9.2.2.2 Allocating MVS or OS/390 Data Sets When You Upload Files ¸ Copyright IBM Corp. 1996, 1997 The SEND command supports a very limited set of MVS or OS/390 allocation parameters. For example, it does not enable you to specify volume or unit information. The INDSBMGR file is a TSO/E REXX EXEC you can use on your MVS or OS/390 host to allocate BookManager data sets with additional MVS or OS/390 allocation parameters. Also, if you are replacing data sets that have been migrated by DFHSM, this EXEC deletes the original copy. This prevents the data sets from being recalled, only to be replaced by a newer copy. Therefore, IBM recommends you use the INDSBMGR EXEC if possible. Note: If you are using Data Facility Storage Management Subsystem (DFSMS) on your MVS or OS/390 host, you should define storage classes to handle BOOK, BKSHELF, and BKINDEX data sets. By default, when you use the SEND command, it uses the IND$FILE program on MVS or OS/390 to do the upload. You can upload INDSBMGR to your MVS or OS/390 host and tailor it to include the appropriate allocation information and have the SEND command use it instead of IND$FILE. Uploading and Customizing the INDSBMGR Program on Your MVS or OS/390 Host: Before you upload any bookshelves, you must upload the INDSBMGR program to your host. The program is in a file named INDSBMGR.REX. To upload this file to your MVS or OS/390 host: 1. Upload this file to MVS or OS/390 in binary format to a fixed-length, 80-byte record, sequential data set. For example, if your CD-ROM drive letter is D and your host session is A, you can type this command to upload the file from any CD-ROM in a collection to a data set named userid.INDSBMGR.REXX. send d:\upload\indsbmgr.rex a:'userid.indsbmgr.rexx' recfm(f) lrecl(80) 2. Copy this sequential data set to a PDS that is part of your SYSPROC or SYSEXEC concatenation. The member name should be INDSBMGR. 3. Edit the INDSBMGR member. 4. Near line 85, find the following variable instructions: /*= Site must modify these allocations =================*/ ALLOCATEOPTIONS_ALL = "" /* All files */ ALLOCATEOPTIONS_BOOK = "" /* For books */ ALLOCATEOPTIONS_SHELF = "" /* For bookshelves */ ALLOCATEOPTIONS_INDEX = "" /* For bookshelf indexes */ /*= End of site modifications ==========================*/ 5. Change these variables to include the additional parameters you want to add to your TSO data set allocations. These variables enable you to: ALLOCATEOPTIONS_ALL Add options to all data set allocations for all BOOK, BKSHELF, and BKINDEX files ALLOCATEOPTIONS_BOOK Add options to data set allocations for BOOK files only ALLOCATEOPTIONS_SHELF Add options to data set allocations for BKSHELF files only ALLOCATEOPTIONS_INDEX Add options to data set allocations for BKINDEX files only If you add a UNIT parameter to this statement, it is added to data set allocations for BOOK, BKSHELF, and BKINDEX files. For example: ALLOCATEOPTIONS_ALL = "UNIT(TSO)" If you add a VOLUME parameter to this statement, it is added only to data set allocations for BOOK files. For example: ALLOCATEOPTIONS_BOOK = "VOLUME(WORK01)" Using the INDSBMGR Program: IBM emulators using the SEND command let you change the host program they use. With IBM OS/2 Extended Edition, for example, you can set the OS/2 environmental variable IND_FILE to the name of the host program you want to run; with IBM PC/3270, you can set the DOS environmental variable IND$FILE. After you have uploaded and customized the INDSBMGR member at your MVS or OS/390 host, you can use it when you want to upload IBM books. Issue the appropriate SET command at your workstation to change the host upload program to INDSBMGR. For example, For OS/2 EE: set ind_file=indsbmgr For DOS: set ind$file=indsbmgr Note: Other emulators provide similar capabilities. See the documentation with your emulator for details. Continue with the instructions in "Uploading the IBM Bookshelves to the Host" in topic 9.2.2.3 to upload the files. Attention: Use the INDSBMGR command only with the CMD or BAT files built with the EZ2UCDM program. The REXX EXEC looks only for the options EZ2UCDM specifies. When you want to eliminate the INDSBMGR as the environmental variable, you can set it to null. For example: OS/2 EE: set ind_file= DOS: set ind$file= 9.2.2.3 Uploading the IBM Bookshelves to the Host ¸ Copyright IBM Corp. 1996, 1997 After you run the EZ2UCDM or EZ2UCDV program, you must use the SHELVES command to actually upload the BookManager files to your host. The SHELVES command starts the program you created using the EZ2UCDM or EZ2UCDV program. The SHELVES program contains the SEND commands that upload the files. The following examples assume the SEND command you usually use is in a directory named C:\PC3270. If the directory containing the SEND command you use is part of the PATH= statement, type: shelves If it is not, or you are not sure, do as follows: 1. Select the hard disk containing your SEND command: c: 2. Change to the directory containing your SEND command: cd \pc3270 3. Run the SHELVES program. For example, if the SHELVES program is in the C:\UPLOAD directory, type: c:\upload\shelves The bookshelves are uploaded to the host. When the uploading is finished, you should look at the FAILING.CMD file (for OS/2) or the FAILING.BAT file (for DOS) created in the directory containing the SHELVES command (for example, in C:\UPLOAD). It lists the files that failed to upload. You can look at this file with the TYPE command. For example: For OS/2: type c:\upload\failing.cmd ] more For DOS: type c:\upload\failing.bat ] more If this file contains any SEND commands, one or more uploads have failed. If there are only a few SEND commands, you can upload these files using the FAILING command. For example: c:\upload\failing If most of the files failed to upload, you should use the SHELVES command after correcting the problem that caused them to fail. After you have uploaded all the files successfully, you might want to print the BKSHELF.LST file also created in the same directory containing the SHELVES program. The BKSHELF.LST file contains a list of the bookshelves that have been uploaded. You can use it to verify all the files arrived successfully. You are now ready to make the IBM bookshelves available to BookManager READ/MVS, READ/VM, or the reader provided with OS/390 on your host. Continue with the instructions in "Making Bookshelves Available to IBM Host Readers" in topic 9.3. 9.2.2.4 Naming Host Data Sets and Files ¸ Copyright IBM Corp. 1996, 1997 When the EZ2UCDM or EZ2UCDV program creates the SEND commands to upload files from your OS/2 or DOS workstation to an MVS, OS/390, or VM host, it creates file names conforming to the file naming conventions used by BookManager READ on the host. Conventions for Naming MVS or OS/390 Data Sets: Three types of files are uploaded: books, bookshelves, and bookshelf search indexes. The following table shows OS/2 and DOS file names and the names these files will have on MVS or OS/390. Some people prefer to associate a book with the bookshelf pointing to it by including the shelf name as part of the book and bookshelf search index data set names. If you want to do this, you can set the environmental variable EZ2UCDMS to Y before invoking EZ2UCDM. To do so, issue the following OS/2 or DOS command: SET EZ2UCDMS=Y Convention for Naming VM Files: Three types of files are uploaded: books, bookshelves, and bookshelf search indexes. The following table shows OS/2 and DOS filenames and the names these files will have on VM. (In this example, file names longer than eight characters are used to spell out the names of the files. The actual filenames in your OS/2, DOS and VM environment are only eight characters long. The file types shown in the example are identical to what you see on your system.) !---------------------------!---------------------------! ! OS/2, DOS Filenames ! VM Filenames ! !---------------------------!---------------------------! ! book-name.boo ! book-name book ! ! shelf-name.bks ! shelf-name bkshelf ! ! index-name.bki ! index-name bkindex ! !---------------------------!---------------------------! 9.2.2.5 Deleting the SHELVES Files from Your Hard Disk ¸ Copyright IBM Corp. 1996, 1997 If you want to upload additional IBM bookshelves from other CD-ROMs, rerun the EZ2UCDM or EZ2UCDV program with the next CD-ROM. Then use the SHELVES command to upload the bookshelves from that CD-ROM. After you have uploaded all the files you want, you might want to delete all the files and the directory you created on your hard disk to upload bookshelves to your host. Note: Before you delete the files and the directory, you might want to copy the EZ2UCDM.EXE or EZ2UCDV.EXE files to another directory for use with other CD-ROMs. Better yet, copy them to a permanent directory specified in your PATH= statement. The following examples assume all the files you created to do the upload are in the C:\UPLOAD directory. To delete the directory you created: 1. Switch to the hard disk containing the EZ2UCDM or EZ2UCDV programs: c: 2. Switch to the root directory of this hard disk: cd \ 3. Delete all the files in the directory you created: del c:\upload\*.* 4. Confirm you want to delete all the files in the directory. Be sure the directory is C:\UPLOAD and not another directory containing data you want to keep. If you are sure, type y. 5. Remove the directory: rd \upload 9.2.3 Using the SEND Capability to Upload to a Host ¸ Copyright IBM Corp. 1996, 1997 You can send individual books, bookshelves, and bookshelf search indexes to your MVS, OS/390, or VM host with the SEND capability provided by a 3270 terminal emulator program or equivalent. To send individual IBM books, bookshelves, and bookshelf search indexes from your workstation to your host, you must: 1. Make sure you are logged onto your host session and your host's READY message is on the screen. 2. From the OS/2 or DOS command prompt, use the file transfer method you regularly use. For example, you can use: * The Communications Manager SEND command (from OS/2) * The 3270 Workstation Program SEND command or IBM Personal Communications/3270 SEND command (from DOS) You can use any other file transfer method you have, but it must let you specify character translation, file format, and record length. If you are unfamiliar with the SEND capability, refer to the manual for the file transfer method you are using. 3. Determine the appropriate character translation, record format, and record length for transferring IBM book (BOO), bookshelf (BKS), and bookshelf search index (BKI) files from an OS/2 or DOS workstation to an MVS, OS/390, or VM host. Look up the information you need in the following table: !------------------------------------!-----------!-----------!-----------! ! Type of File: ! Book ! Bookshelf ! Search ! ! ! ! ! Index ! !------------------------------------!-----------!-----------!-----------! ! DOS or OS/2 File Extent: ! .BOO ! .BKS ! .BKI ! !------------------------------------!-----------!-----------!-----------! ! MVS or OS/390 Lowest-level ! BOOK ! BKSHELF ! BKINDEX ! ! Qualifier or VM File Type: ! ! ! ! !------------------------------------!-----------!-----------!-----------! ! Character Translation: ! None ! ASCII to ! None ! ! ! ! EBCDIC ! ! !------------------------------------!-----------!-----------!-----------! ! Record Format: ! F ! V ! F ! !------------------------------------!-----------!-----------!-----------! ! Record Length: ! 4096 ! 259 ! 4096 ! !------------------------------------!-----------!-----------!-----------! ! CRLF: ! No ! Yes ! No ! !------------------------------------!-----------!-----------!-----------! ! How to upload the file ! Binary ! ASCII ! Binary ! !------------------------------------!-----------!-----------!-----------! You can look up the file names of the books, bookshelf, and bookshelf search indexes in the printed catalog, the online version (BOOK file) of this catalog, or the README file on your Online Library CD-ROM. 4. Use the SEND commands you need to upload books, bookshelf search indexes, and bookshelves to your host. Examples for OS/2 or DOS to MVS or OS/390: These examples assume your host session is A and you are transferring files from your CD-ROM drive D. Note: Although the commands appear on two lines in the following examples, you should enter them as a single command. send d:\books\book-name.boo a:ibmbk.book-name.book lrecl(4096) recfm(f) send d:\books\index-name.bki a:ibmbk.index-name.bkindex lrecl(4096) recfm(f) send d:\shelves\shelf-name.bks a:ibmbk.shelf-name.bkshelf ascii crlf lrecl(259) recfm(v) Note: If you are uploading a large file, you might have to include a SPACE parameter on the SEND command to allocate enough space for the file. Examples for OS/2 or DOS to VM: Here are examples of the SEND command you might use to move a file containing a book, a bookshelf search index, or a bookshelf from your OS/2 or DOS workstation to your VM host. These examples assume your host session is A and you are transferring files from your CD-ROM drive D. send d:\books\book-name.boo a:book-name book (lrecl 4096 recfm f send d:\books\index-name.bki a:index-name bkindex (lrecl 4096 recfm f send d:\shelves\shelf-name.bks a:shelf-name bkshelf (ascii crlf You are now ready to make the bookshelves available to the IBM host readers. Continue with the instructions in "Making Bookshelves Available to IBM Host Readers" in topic 9.3. 9.3 Making Bookshelves Available to IBM Host Readers ¸ Copyright IBM Corp. 1996, 1997 This section describes making bookshelves available to readers on MVS, OS/390 and VM. 9.3.1 Making Bookshelves Available on READ/MVS or the OS/390 Reader ¸ Copyright IBM Corp. 1996, 1997 1. Start BookManager READ/MVS or the OS/390 Reader (whichever is appropriate) and go to the list of bookshelves. 2. Do not select any bookshelves. Select Books choice on the action bar and press Enter. 3. In the window that appears, select 6. Perform file functions. 4. In the window that appears, select 5. Add. 5. Type, between single quotation marks, the name of the first bookshelf you uploaded and press Enter. 'ibmbk.ez2shelf-name.bkshelf' If you used the EZ2UCDM program to upload the files, the list of the bookshelves that were uploaded is in BKSHELF.LST. You may want to add to the master list, which is defined by the QLSHELF parameter in the EOXVOPTS REXX EXEC. For example, if you look at the EOXVOPTS member, you see a statement like this: QLSHELF = "'EOY.BKLSHELF'" The name of the master list here is: 'EOY.BKLSHELF' The bookshelf is now added. 6. Repeat steps 4, 5, and 6 for each bookshelf in BKSHELF.LST. When you have finished, press F12 to return to the list of bookshelves. If you used EZ2UCDM to create the SEND commands, you can skip the remaining steps in this section. If not, continue with the next step. 7. Type a slash (/) next to each bookshelf you just added. 8. Select the Books choice on the action bar and press Enter. 9. In the window that appears, select 6. Perform file functions. 10. In the window that appears, select 4. Edit. 11. In the window that appears, select 4. Add data set names. 12. In the window that appears, type the high-level qualifier that you added to each file name, and press Enter. For example, ibmbk 13. Press F12 to return to the previous window. 14. Press F6 to skip the bookshelf you just added. The next bookshelf you selected appears. 15. Repeat steps 10, 11, 12, and 13 for each bookshelf you selected. 16. When you have finished with all the bookshelves, a window with the list of bookshelves reappears. 17. Press F5 to refresh the list and see the newly added bookshelves. You are now ready to use the new bookshelves. You can use the BOOKMGR command in your host session to view the bookshelves and books in a collection of IBM books. Refer to the BookManager READ/MVS books for more information about using BookManager READ on your host. Note: To conserve space on your host DASD, you can release any unused space you allocated when you uploaded the books and bookshelf search indexes. You can use DFHSM to migrate the data set. 9.3.2 Making Bookshelves Available on READ/VM ¸ Copyright IBM Corp. 1996, 1997 Although it is not required, you should add the bookshelf files to the BookManager public library. Otherwise, you can access them directly if the minidisk containing the files is currently accessible. When you are finished transferring files to your VM host, you can use the BOOKMGR command in your host session to view the bookshelves and books. 9.4 Making Bookshelves Usable on Your MVS or OS/390 Host ¸ Copyright IBM Corp. 1996, 1997 When SCRT/MVS installs bookshelves on MVS or OS/390, they are not immediately usable by BookManager. First, the bookshelves do not contain the proper data set names for each book and bookshelf search index. Second, the bookshelves need to be added to your personal bookshelf list. BKSADD is a REXX EXEC that adds the correct data set names inside MVS or OS/390 bookshelves and adds MVS or OS/390 bookshelves to a Personal Bookshelf List. BKSADD has two program options: * Option L allows you to locate all the bookshelves under a given high-level qualifier (HLQ) and assign them to a personal bookshelf list. You determine the bookshelf list data set to be created or updated and the HLQ for the bookshelves to be added. * Option S lets you add the data set names inside one or more bookshelves. You select the HLQ for the bookshelves to be updated. You also select HLQs for the book and bookshelf search index data set names that go into the bookshelves. This option can generate data set names that do not exist and correct names already in the bookshelf. When there are multiple data sets matching a given book or book index, you can have the EXEC prompt you for a choice, or you can ignore conflicts. BKSADD runs interactively on MVS or OS/390 under TSO and does NOT require or use any special panel interface. It prompts you for all required input; it displays useful statistics and produces a detailed report on your disk. You must upload BKSADD to your MVS or OS/390 host from the CD-ROM before you can use it. The EXEC is located in the \scrt\scrtmvs subdirectory. When you upload it it, be sure to specify a record format of F, a logical record length of 80, no CRLF, and do not request character translation; it is a binary file. For more information on BKSADD, see the comments inside the BKSADD data set. For more information on REXX EXECs, refer to TSO/E V2 REXX: Users Guide, SN28-1299. Note: If your bookshelves are RECFM U, your TSO session must have access to the REPRO command. This EXEC also uses a variety of TSO/E commands such as ALLOCATE, DELETE, FREE, and RENAME. 9.5 Uploading and Downloading Books, Bookshelves, and Indexes ¸ Copyright IBM Corp. 1996, 1997 The following examples assume you are going to use the RECEIVE capability provided by a 3270 terminal emulator program or equivalent to download to a workstation. They also assume you are going to use your C hard disk and the \BOOKS directory to receive books and bookshelf search indexes and the \SHELVES directory to receive bookshelves from your host. 1. You must upload the IBM books, bookshelves, and bookshelf search indexes to your host before you can download them to a workstation. First follow the directions in "Uploading Books, Bookshelves, and Search Indexes" in topic 9.2 to transfer IBM books, bookshelves, and bookshelf search indexes you want to distribute to your host. Then return here and continue with the next step. 2. Make sure you are logged onto your host session and that your host's READY message is on the screen. 3. On the workstation to receive the books, switch to the hard drive you want to use. For example, type: c: 4. Create two directories, one to hold the IBM books and the bookshelf search indexes and the other to hold the bookshelves. md \books md \shelves 5. From the OS/2 or DOS command prompt, download the files with your usual file transfer method. For example, you can use: * The Communications Manager RECEIVE command (from OS/2 workstations) * The 3270 Workstation Program RECEIVE command or IBM Personal Communications/3270 RECEIVE command (from DOS workstations) You can use any other file transfer method you have, but it must enable you to specify whether you want the files translated. If you are unfamiliar with the RECEIVE capability, you may want to refer to the manual for the file transfer method you are using. 6. Determine the appropriate character translation for transferring IBM book (BOOK), bookshelf (BKSHELF), and bookshelf search index (BKINDEX) files from an MVS, OS/390, or VM host to an OS/2 or DOS workstation. Look up the information you need in the following table: !------------------------------------!-----------!-----------!-----------! ! Type of File: ! Book ! Bookshelf ! Bookshelf ! ! ! ! ! Search ! ! ! ! ! Index ! !------------------------------------!-----------!-----------!-----------! ! DOS or OS/2 File Extent: ! .BOO ! .BKS ! .BKI ! !------------------------------------!-----------!-----------!-----------! ! MVS or OS/390 Lowest-level ! BOOK ! BKSHELF ! BKINDEX ! ! Qualifier or VM File Type: ! ! ! ! !------------------------------------!-----------!-----------!-----------! ! Character Translation: ! None ! ASCII to ! None ! ! ! ! EBCDIC ! ! !------------------------------------!-----------!-----------!-----------! ! CRLF: ! No ! Yes ! No ! !------------------------------------!-----------!-----------!-----------! 7. Use the RECEIVE commands you need to download books, bookshelf search indexes, and bookshelves to your workstation. Examples are shown below. Examples for MVS or OS/390 to OS/2 or DOS: Here are examples of the RECEIVE command you might use to move a file containing a book, a bookshelf search index, or a bookshelf from your MVS or OS/390 host to your OS/2 or DOS workstation. These examples assume your host session is A and you are transferring the files to your C hard disk. Note: Some of these commands appear on two lines in the examples. You should enter them an a single command. receive c:\books\book-name.boo a:'ibmbk.book-name.book' receive c:\books\index-name.bki a:'ibmbk.index-name.bkindex' receive c:\shelves\shelf-name.bks a:'ibmbk.shelf-name.bkshelf' ascii crlf Examples for VM to OS/2 or DOS: Here are examples of the RECEIVE command you might use to move a file containing a book, a bookshelf search index, or a bookshelf from your VM host to your OS/2 or DOS workstation. These examples assume your host session is A and you are transferring the files to your C hard disk. Note: Some of these commands appear on two lines in the examples. You should enter them on a single line. receive c:\books\book-name.boo a:book-name book receive c:\books\index-name.bki a:index-name bkindex receive c:\shelves\shelf-name.bks a:shelf-name bkshelf (ascii crlf After you have downloaded all the books, you are ready to open the library. 9.6 Transferring Files to CICS ¸ Copyright IBM Corp. 1996, 1997 If READ/GT (available from GT Software) is installed in your CICS host environment, you can transfer BookManager files from your CD-ROM to your mainframe CICS system and use them with READ/GT. If you have access to GT Software's ASSIST/GT online referencing product, you can reference BookManager files from help windows displayed at the top of CICS application screens. 110.0 Chapter 10. Sharing the Online Library With Your VSE Host ¸ Copyright IBM Corp. 1996, 1997 You can share the IBM Online Library with the users of your VSE host in two ways: * For VSE running under VM: You can install the BookManager READ/VM licensed program on your VM host and upload the files you want to use. * For Stand-alone VSE: You can install BookManager Library Reader/2 or Library Reader/DOS or BookManager READ/2 or READ/DOS on your workstations and use the CD-ROMs at these workstations. 10.1 Distributing the Online Library to VSE Workstations ¸ Copyright IBM Corp. 1996, 1997 You can distribute the IBM Online Library to VSE workstations that do not have CD-ROM readers by using diskettes and using the PUN Queue. 10.1.1 Distributing the Online Library Using Diskettes ¸ Copyright IBM Corp. 1996, 1997 You can copy the library readers and Online Library files to diskettes on one workstation and copy them to the hard disk on another workstation. 10.1.2 Uploading Books, Bookshelves, and Indexes to the PUN Queue ¸ Copyright IBM Corp. 1996, 1997 You can transfer files to the VSE/POWER PUN queue from one workstation and then retrieve them from the queue at another workstation. 1. At your VSE host, make sure the VSE/POWER data file has enough free space. Enter the command D Q at the system console. The system displays the percentage of space already used in the data queue. To determine how much free space is available in the data file, multiply the displayed values for free DBLK groups, DBLK group size, and DBLK size (free DBLK groups ž DBLK group size ž DBLK size). To send files, set up the VSE host for normal file transfer to or from a workstation (see VSE/ESA Programming and Workstation Guide). 2. At the workstation OS/2 or DOS command prompt, switch to the drive with the directory containing the files you want to transfer. If the books are on your F drive, type: f: 3. Change to the directory on that drive containing the files. If the books are on the \BOOKS directory, type: cd \books 4. Do one of the following to transfer files to the PUN queue: * Use individual DOS or OS/2 SEND commands to transfer files to the PUN queue. For example: send dto32e00.boo dto32e00 (file=pun binary class=v dest=any lrecl=4000 * Create on OS/2 command like the following to transfer three books to the PUN queue at the same time: SEND GETBOOK.CMD GETBOOK (FILE=PUN BINARY CLASS=V DEST=ANY LRECL=4000 SEND DTO32E00.BOO DTO32E00 (FILE=PUN BINARY CLASS=V DEST=ANY LRECL=4000 SEND DTOU2000.BOO DTOU2000 (FILE=PUN BINARY CLASS=V DEST=ANY LRECL=4000 SEND DTOR2000.BOO DTOR2000 (FILE=PUN BINARY CLASS=V DEST=ANY LRECL=4000 Explanation: - The command file sends three books to PUN. - For DOS, this file would be named GETBOOK.BAT instead of GETBOOK.CMD. - CLASS=V designates the files belong to this specific queue class. You should make sure PUN is not started for the class you select. - DEST=ANY so any user can retrieve the books from the queue. - GETBOOK.CMD is a file for retrieving the books. 10.1.3 Receiving Books, Bookshelves, and Indexes from the PUN Queue ¸ Copyright IBM Corp. 1996, 1997 After you have transferred files to the VSE/POWER PUN queue from a workstation, you can retrieve them from the queue at another workstation. Before receiving any files, you should decide into which directory or partition on the receiving workstation you want to put them. The following example assumes you want to put the books into the \BOOKS directory on your C hard disk. After you decide where you want to put the books, make sure the destination you chose is in the PATH statement on the workstation. 1. Set up the VSE host for normal file transfer to a workstation. 2. At the workstation receiving the files from the PUN queue, use individual DOS or OS/2 RECEIVE commands to transfer files from PUN. If you sent a command file like the one described below to the PUN queue, you can receive it, and use it to receive the other files. For example, to receive the GETBOOK file from PUN queue: For OS/2: receive d:\books\getbook.cmd getbook (file=pun binary class=v For DOS: receive d:\books\getbook.bat getbook (file=pun binary class=v After you have retrieved the command file, use it to retrieve one or more queue entries from PUN. For example, if the GETBOOK file contains RECEIVE commands for three books, entering getbook receives the following files: RECEIVE D:\BOOKS\DTO32E00.BOO DTO32E00 (FILE=PUN BINARY CLASS=V RECEIVE D:\BOOKS\DTOU2000.BOO DTOU2000 (FILE=PUN BINARY CLASS=V RECEIVE D:\BOOKS\DTOOR000.BOO DTOOR000 (FILE=PUN BINARY CLASS=V The queue entries remain in PUN until you use PDELETE to delete them. 111.0 Chapter 11. Installing and Using the Online Message Facility ¸ Copyright IBM Corp. 1996, 1997 !--- Optional Feature ---------------------------------------------------! ! This procedure is for Online Library CD-ROMs containing books enabled ! ! for the Online Message Facility (OMF). Refer to the catalog shipped ! ! with your CD-ROMs to determine if you can use OMF. ! ! ! !------------------------------------------------------------------------! The Online Message Facility (OMF) is an OS/2 program displays the descriptions of host messages you receive in your host session. Using OS/2, you can click on the message number in a host window controlled by Communications Manager. OMF searches for that message in the appropriate book in the Online Library and uses the IBM Library Reader/2 or BookManager READ/2 to display the explanation in an OS/2 window. If the message you selected contains certain types of system codes, such as sense or abend codes, you can branch directly from the message description to the descriptions of the codes in that message. OMF also has a search function that lists the different types of message prefixes and codes contained in a set of online books. When you enter a code or message number, the OMF passes it to the appropriate online book. You can also use of all the functions of the IBM Library Reader/2 or BookManager READ/2 after OMF starts it. 11.1 Additional Software Requirements for OMF ¸ Copyright IBM Corp. 1996, 1997 This version of OMF requires OS/2 Version 2.0 or higher with Extended Services Version 1.0 or Communications Manager/2 Version 1.0. If you have installed an earlier version, you should reinstall this version. 11.2 Installing the Online Message Facility on OS/2 ¸ Copyright IBM Corp. 1996, 1997 Note: If you have already installed OMF on your workstation and you are just adding books on a new CD-ROM to your Online Library, you only need to copy the Message Parsing Template (MPT) files from the CD-ROM onto your hard disk. Skip the steps in this section and go directly to "Copying MPT Files to Your Hard Disk for OS/2" in topic 11.2.1. Follow these instructions to install the IBM Online Message Facility (OMF) on your OS/2 workstation. If you are a LAN user and this online book is included on your CD-ROM, refer to the IBM Online Message Facility: User's Guide, SV40-0336. 1. Go to an OS/2 command prompt. 2. Switch to the drive letter of the CD-ROM drive containing the Online Message Facility. If your CD-ROM drive is D, type: d: 3. Change to the directory on the CD-ROM containing the OMF: cd \omf 4. Start the OMF Installation Program: install The Install the Online Message Facility window appears on your screen. 5. In the window, do as follows: a. Make sure the target directory is correct. The default is a directory named \OMF on your hard disk. Note: If you have a previous release of OMF installed in a different directory, that directory appears instead of \omf. b. Make sure the configuration file is correct. c. If you do not want your configuration file updated, uncheck the Update box. If you do not update your configuration file, a file with the necessary changes is created for you. 6. Select the Install button. The OMF Installation window appears on your screen. Note: If you have a previous release of OMF installed, a window telling you the previous version is being replaced appears before the OMF Installation window appears. 7. The OMF Installation window tells you OMF was successfully installed and if you need to shut down and restart your system. 8. Select the OK button and do one of the following things: * If you are copying MPT files, do not shut your system down now. Go to "Copying MPT Files to Your Hard Disk for OS/2" in topic 11.2.1 and continue with step 5. * If you are not copying MPT files, continue with the instructions in "Shutting Down and Restarting Your OS/2 Workstation" in topic 11.2.2 to shut down and restart your system now. When your system is running again, an OMF folder appears. You can use this folder to start OMF. 11.2.1 Copying MPT Files to Your Hard Disk for OS/2 ¸ Copyright IBM Corp. 1996, 1997 To use the IBM Online Message Facility, you must copy Message Parsing Template (MPT) files from the CD-ROM to your hard disk. Be sure you copy the MPT files that match the books you are using. A list of the MPT files should be included in the information packaged with the CD-ROM or in its README file, and the MPT files should have the same file names as the books. These instructions assume your are using the \omf directory created by the OMF Installation Program on your C hard disk. 1. If you have not installed OMF, go to "Installing the Online Message Facility on OS/2" in topic 11.2 and follow the instructions for installing OMF. You might want to refer to the list of MPT files included on your CD-ROM and select the MPT files you want to copy before you continue to the next step. 2. Make sure you have the CD-ROM containing the MPT files in your CD-ROM drive. 3. Switch to the drive letter of your hard disk containing the directory created by the OMF Installation Program. If that hard disk is C, type: c: 4. Change to the OMF directory containing OMF and any MPT files you have copied previously. If you are using the default directory created by the OMF Installation Program, type: cd \omf 5. To copy all the MPT files from the CD-ROM to the OMF directory on your hard disk, type: copy d:\mpt\*.* To copy only selected MPT files, type the following command for each file you want to copy: copy d:\mpt\filename.mpt 6. If you have just installed OMF and were instructed to shut down and restart your system, continue with "Shutting Down and Restarting Your OS/2 Workstation" in topic 11.2.2. If you are just copying MPT files, you are done. 11.2.2 Shutting Down and Restarting Your OS/2 Workstation ¸ Copyright IBM Corp. 1996, 1997 For OS/2 Version 2.11 or later with corrective service XR06055 applied: 1. Click on your desktop (an unoccupied part of the screen). 2. In the window that appears, select Shutdown. 3. When the shutdown is complete, restart your system by pressing Ctrl+Alt+Del. For OS/2 WARP 3.0: 1. Click on Shutdown on your LaunchPad. 2. When the shutdown is complete, restart your system by pressing Ctrl+Alt+Del. 1A.0 Appendix A. Configuration Changes Made to Install the Library Reader on Windows ¸ Copyright IBM Corp. 1996, 1997 The installation program makes the following changes: * In your AUTOEXEC.BAT file, it appends C:\READIBMW to SET PATH=. * In the Windows subdirectory, it creates the following initialization file: READIBMW.INI. This file contains profile information including fonts, colors, and the books and bookshelf path. Note: In IBM BookManager READ for Windows, this file is called READWIN.INI. * The WIN.INI file is updated to contain associations for .BKS and .BOO so Windows knows to invoke READIBM.EXE when you double-click on one of these files. 1INDEX Index ¸ Copyright IBM Corp. 1996, 1997 !---! ! A ! !---! allocating MVS or OS/390 data sets when you upload files 9.2.2.2 AS/400 using the SCRT on 8.3 Version 3 Release 6, installing books on 7.5 AS/400 system installing and using InfoSeeker on your 7.1 to share the Online Library, using directories on the 7.2 using online libraries on your 1.3.4 AS/400 system directory copying IBM books to an 7.4 using the SCRT to install books to an 7.3 !---! ! B ! !---! batch programs creating the upload command and 9.2.2.1 BookManager 3.3 Library Reader/DOS, opening your Online Library with 4.3 READ or InfoSeeker, if you already have 2.3 READ/2 3.3 BOOKMGR 9.3.2 books drivers with IBM library 4.2 on AS/400 Version 3 Release 6, installing 7.5 to an AS/400 system directory, copying IBM 7.4 to an AS/400 system directory, using the SCRT to install 7.3 books, bookshelves, and indexes from the PUN queue, receiving 10.1.3 to the PUN queue, uploading 10.1.2 uploading 9.2 uploading and downloading 9.5 bookshelves and indexes from the PUN queue, receiving books, 10.1.3 and indexes to the PUN queue, uploading books, 10.1.2 and indexes, uploading and downloading books, 9.5 and search indexes, uploading books, 9.2 available on READ/MVS or the OS/390 reader, making 9.3.1 available on READ/VM, making 9.3.2 available to IBM host readers, making 9.3 to the host, uploading the IBM 9.2.2.3 upload programs to upload to a host, using the 9.2.2 usable on your MVS or OS/390 host, making 9.4 !---! ! C ! !---! CD-ROM in your business, using Online Library 1.3 installing or updating from a 3.2, 4.2, 5.2, 6.2 ordering Online Library 1.1 the Online Library 1.1 what is the structure of an IBM Online Library 1.2 cd-roms (collection kits) 1.1 centralizing online libraries on your host system, sharing and 1.3.3 change path 3.3.1.1 changes made to install the Library Reader on windows, configuration A.0 character translation 9.2.3, 9.5 CICS transferring files to 9.6 CKITLIST.TXT file on OS/2 workstations improving viewing and printing of the 3.4 code page requirements 2.3 collection kits CD-ROMs 1.1 configuration changes made to install the Library Reader on windows A.0 configuration file 4.2 conventions for naming MVS or OS/390 data sets 9.2.2.4 for naming VM files 9.2.2.4 copying IBM books to an AS/400 system directory 7.4 MPT files to your hard disk for OS/2 11.2.1 creating the upload command and batch programs 9.2.2.1 CRLF 9.2.3, 9.5 customizing the INDSBMGR program on your MVS or OS/390 host, uploading and 9.2.2.2 !---! ! D ! !---! DASD storage requirements estimating host 9.1 data sets and files, naming host 9.2.2.4 data sets when you upload files, allocating MVS or OS/390 9.2.2.2 data sets, conventions for naming MVS or OS/390 9.2.2.4 deleting the SHELVES files from your hard disk 9.2.2.5 device paths, specifying 3.3.1, 4.3.1, 5.4, 6.4 directories and files, optional 1.2 copying IBM books to an AS/400 system 7.4 Library Reader 4.2 Library Readers 1.2 miscellaneous 1.2 on the AS/400 system to share the Online Library, using 7.2 Online Libraries 1.2 uploading and file management programs 1.2 using the SCRT to install books to an AS/400 system 7.3 diskettes distributing the Online Library using 10.1.1 distributing the Online Library to VSE workstations 10.1 using diskettes 10.1.1 DOS examples for MVS or OS/390 to OS/2 or 9.5 examples for VM to OS/2 or 9.5 or OS/2 file extent 9.2.3, 9.5 software and hardware requirements for 4.1 to MVS or OS/390, examples for OS/2 or 9.2.3 to VM, examples for OS/2 or 9.2.3 downloading books, bookshelves, and indexes, uploading and 9.5 IBM Library Readers from the internet 2.2 drivers with IBM library books 4.2 !---! ! E ! !---! EE OS/2 9.2.2.2 estimating host DASD storage requirements 9.1 examples for MVS or OS/390 to OS/2 or DOS 9.5 for OS/2 or DOS to VM 9.2.3 for VM to OS/2 or DOS 9.5 examples for OS/2 or DOS to MVS or OS/390 9.2.3 extent DOS or OS/2 file 9.2.3, 9.5 !---! ! F ! !---! file extent DOS or OS/2 9.2.3, 9.5 file management programs (directories) uploading and 1.2 files configuration 4.2 information 1.2 optional directories and 1.2 to CICS, transferring 9.6 format record 9.2.3 !---! ! H ! !---! hard disk deleting the SHELVES files from your 9.2.2.5 hardware optional 3.1, 4.1, 5.1, 6.1 required 3.1, 4.1, 5.1, 6.1 hardware requirements for DOS, software and 4.1 for microsoft windows, software and 5.1, 6.1 for OS/2, software and 3.1 host sharing and centralizing online libraries on your 1.3.3 uploading the IBM bookshelves to the 9.2.2.3 using the bookshelf upload programs to upload to a 9.2.2 using the SEND capability to upload to a 9.2.3 using the Softcopy Receiver Tool to upload to a 9.2.1 host DASD storage requirements estimating 9.1 host data sets and files naming 9.2.2.4 host readers making bookshelves available to IBM 9.3 host, making bookshelves usable on your MVS or OS/390 9.4 host, uploading and customizing the INDSBMGR program on your MVS or OS/390 9.2.2.2 !---! ! I ! !---! IBM BookManager 3.3 IBM Online Library 3.3 identifying the latest level of IBM reader programs via the Internet 2.1 indexes from the PUN queue, receiving books, bookshelves, and 10.1.3 to the PUN queue, uploading books, bookshelves, and 10.1.2 uploading and downloading books, bookshelves, and 9.5 uploading books, bookshelves, and search 9.2 INDSBMGR on your MVS or OS/390 host, uploading and customizin g the 9.2.2.2 using the 9.2.2.2 information files 1.2 publications and 1.1 InfoSeeker if you already have BookManager READ or 2.3 on your AS/400 system, installing and using 7.1 installation planning for IBM Library Readers 2.3 installing and using InfoSeeker on your AS/400 system 7.1 books to an AS/400 system directory, using the SCRT to 7.3 or updating from a CD-ROM 3.2, 4.2, 5.2, 6.2 the OMF on OS/2 11.2 the Online Message Facility on OS/2 11.2 installing books on AS/400 Version 3 Release 6 7.5 Internet downloading IBM Library Readers from the 2.2 identifying the latest level of IBM reader programs via the 2.1 !---! ! L ! !---! level of IBM reader programs via the Internet identifying the latest 2.1 library to VSE workstations, distributing the online 10.1 using directories on the AS/400 system to share the online 7.2 using diskettes, distributing the online 10.1.1 with BookManager Library Reader/DOS, opening your online 4.3 with Library Reader for Windows, opening your online 5.3, 6.3 Library Reader directory 4.2 for Windows 95, Opening your Online Library with 5.3 for Windows NT, Opening your Online Library with 5.3 for Windows, opening your Online Library with 6.3 installed on your workstation, if you already have a 2.3 on Windows, configuration changes made to install the A.0 Library Reader/2 3.2, 3.3 opening your Online Library with 3.3 Library Reader/DOS opening your Online Library with BookManager 4.3 Library Readers (directories) 1.2 from the Internet, downloading 2.2 installation, planning for IBM 2.3 lowest-level qualifier MVS or OS/390 9.5 lowest-level qualifier or, MVS or OS/390 9.2.3 !---! ! M ! !---! making bookshelves available on READ/VM 9.3.2 miscellaneous directories 1.2 MPT files to your hard disk for OS/2, copying 11.2.1 MVS for Windows/NT 9.2.2.1 MVS or OS/390 examples for OS/2 or DOS to 9.2.3 lowest-level qualifier 9.2.3, 9.5 MVS or OS/390 data sets conventions for naming 9.2.2.4 when you upload files, allocating 9.2.2.2 MVS or OS/390 host making bookshelves usable on your 9.4 uploading and customizing the INDSBMGR program on your 9.2.2.2 MVS or OS/390 to OS/2 or DOS examples for 9.5 !---! ! N ! !---! naming host data sets and files 9.2.2.4 MVS or OS/390 data sets, conventions for 9.2.2.4 VM files, convention for 9.2.2.4 network using online libraries on your 1.3.2 !---! ! O ! !---! OMF additional software requirements for 11.1 installing 11.2 online libraries directories 1.2 on your AS/400 system, using 1.3.4 on your host system, sharing and centralizing 1.3.3 on your network, using 1.3.2 on your workstation, using 1.3.1 throughout your business, using and sharing 1.3.4 Online Library 3.3 to VSE workstations, distributing the 10.1 using directories on the AS/400 system to share the 7.2 using diskettes, distributing the 10.1.1 with BookManager Library Reader/DOS, opening your 4.3 with Library Reader for Windows, opening your 5.3, 6.3 with Library Reader/2, opening your 3.3 Online Library CD-ROM 1.1 ordering 1.1 structure 1.2 using in your business 1.3 Online Message Facility on OS/2, installing the 11.2 opening your Online Library with BookManager Library Reader/DOS 4.3 with Library Reader for Windows 5.3, 6.3 with Library Reader/2 3.3 optional directories and files 1.2 hardware 3.1, 4.1, 5.1, 6.1 software 5.1, 6.1 ordering Online Library CD-ROMs 1.1 OS/2 copying MPT files to your hard disk for 11.2.1 installing OMF 11.2 installing the Online Message Facility on 11.2 software and hardware requirements for 3.1 OS/2 EE 9.2.2.2 OS/2 file extent DOS or 9.2.3, 9.5 OS/2 or DOS examples for MVS or OS/390 to 9.5 examples for VM to 9.5 to MVS or OS/390, examples for 9.2.3 to VM, examples for 9.2.3 OS/2 workstations improving viewing and printing of the CKITLIST.TXT file on 3.4 shutting down and restarting 11.2.2 with WIN-OS/2 6.2 OS/390 examples for OS/2 or DOS to MVS 9.2.3 to OS/2 or DOS, examples for MVS or 9.5 OS/390 data sets conventions for naming MVS or 9.2.2.4 upload files, allocating MVS or 9.2.2.2 OS/390 host making bookshelves usable on your MVS or 9.4 uploading and customizing the INDSBMGR program on your MVS or 9.2.2.2 OS/390 lowest-level qualifier MVS or 9.2.3, 9.5 OS/390 reader making bookshelves available on 9.3.1 making bookshelves available on READ/MVS or the 9.3.1 !---! ! P ! !---! path changing 3.3.1.1 specifying a permanent 3.3.1.2, 4.3.1.2, 5.4.2, 6.4.2 specifying a temporary 3.3.1.1, 4.3.1.1, 5.4.1, 6.4.1 specifying device 3.3.1, 4.3.1, 5.4, 6.4 permanent path specifying a 3.3.1.2, 4.3.1.2, 5.4.2, 6.4.2 planning for IBM Library Readers installation 2.3 printing the CKITLIST.TXT file on OS/2 workstations improving viewing and 3.4 programs (directories) uploading and file management 1.2 publications and information 1.1 PUN queue receiving books, bookshelves, and indexes from the 10.1.3 uploading books, bookshelves, and indexes to the 10.1.2 !---! ! Q ! !---! queue receiving books, bookshelves, and indexes from the PUN 10.1.3 uploading books, bookshelves, and indexes to the PUN 10.1.2 !---! ! R ! !---! READ/2 BookManager 3.3 READ/MVS making bookshelves available on 9.3.1 READ/VM making bookshelves available on 9.3.2 reader if you already have a library 2.3 reader directory library 4.2 reader for Windows opening your Online Library with library 5.3, 6.3 reader on Windows configuration changes made to install the library A.0 reader, making bookshelves available on READ/MVS or the OS/390 9.3.1 readers making bookshelves available to IBM host 9.3 via the internet, identifying the latest level 2.1 readers (directories) library 1.2 readers from the Internet downloading IBM library 2.2 readers installation planning for IBM library 2.3 READIBM2 3.2 receiving books, bookshelves, and indexes from the PUN queue 10.1.3 record format 9.2.3 length 9.2.3 required hardware 3.1, 4.1, 5.1, 6.1 software 3.1, 4.1, 5.1, 6.1 requirements estimating host DASD storage 9.1 for DOS, software and hardware 4.1 for Microsoft Windows, software and hardware 5.1, 6.1 for OMF, additional software 11.1 for OS/2, software and hardware 3.1 restarting your OS/2 workstation 11.2.2 !---! ! S ! !---! SCRT on AS/400, using the 8.3 to install books to an AS/400 system directory, using the 7.3 SCRT/MVS using 8.1, 9.2.1 SCRT/OS2 using 8.2, 9.2.1 SCRT/VM using 8.1, 9.2.1 SCRT/WIN95 using 8.2, 9.2.1 SCRT/WINNT using 8.2, 9.2.1 search indexes uploading books, bookshelves, and 9.2 SEND capability to upload to a host using the 9.2.3 sharing and centralizing online libraries on your host system 1.3.3 sharing online libraries throughout your business, using and 1.3.4 sharing the Online Library using directories on the AS/400 system to 7.2 SHELVES files from your hard disk deleting the 9.2.2.5 shutting down and restarting your OS/2 workstation 11.2.2 Softcopy Receiver Tool to upload to a host, using the 9.2.1 software optional 5.1, 6.1 required 3.1, 4.1, 5.1, 6.1 software and hardware requirements for DOS 4.1 for Microsoft Windows 5.1, 6.1 for OS/2 3.1 software requirements for OMF, additional 11.1 specifying device paths 3.3.1, 4.3.1, 5.4, 6.4 permanent path 3.3.1.2, 4.3.1.2, 5.4.2, 6.4.2 temporary path 3.3.1.1, 4.3.1.1, 5.4.1, 6.4.1 stand-alone VSE 10.0 storage requirements estimating host DASD 9.1 structure of an IBM Online Library CD-ROM 1.2 !---! ! T ! !---! temporary path specifying 3.3.1.1, 4.3.1.1, 5.4.1, 6.4.1 transferring files to CICS 9.6 translation character 9.2.3, 9.5 !---! ! U ! !---! updating from a CD-ROM installing or 3.2, 4.2, 5.2, 6.2 upload command and batch programs, creating the 9.2.2.1 files, allocating MVS or OS/390 data sets when you 9.2.2.2 programs to upload to a host, using the bookshelf 9.2.2 the file, how to 9.2.3 to a host, using the bookshelf upload programs to 9.2.2 to a host, using the SEND capability to 9.2.3 to a host, using the Softcopy Receiver Tool to 9.2.1 uploading and customizing the INDSBMGR program on your MVS or OS/390 host 9.2.2.2 and downloading books, bookshelves, and indexes 9.5 and file management programs (directories) 1.2 books, bookshelves, and indexes to the PUN queue 10.1.2 books, bookshelves, and search indexes 9.2 the IBM bookshelves to the host 9.2.2.3 using and sharing online libraries throughout your business 1.3.4 directories on the AS/400 system to share the Online Library 7.2 InfoSeeker on your AS/400 system, installing and 7.1 online libraries on your AS/400 system 1.3.4 online libraries on your network 1.3.2 online libraries on your workstation 1.3.1 Online Library CD-ROMs in your business 1.3 SCRT/MVS 8.1 SCRT/OS2 8.2 SCRT/VM 8.1 SCRT/WIN95 8.2 SCRT/WINNT 8.2 the SCRT to install books to an AS/400 system directory 7.3 using the SCRT on AS/400 8.3 utilities 1.2 !---! ! V ! !---! viewing and printing the CKITLIST.TXT file on OS/2 workstations, improving 3.4 VM examples for OS/2 or DOS to 9.2.3 for VSE running under 10.0 to OS/2 or DOS, examples for 9.5 VM files convention for naming 9.2.2.4 VSE for stand-alone 10.0 running under VM, for 10.0 workstations, distributing the Online Library to 10.1 !---! ! W ! !---! WIN-OS/2 for OS/2 workstations with 6.2 Windows configuration changes made to install the Library Reader on A.0 opening your Online Library with Library Reader for 6.3 software and hardware requirements for Microsoft 5.1, 6.1 Windows 3.1 Windows 3.1 workstations 6.2 Windows 95 opening your Online Library with Library Reader for 5.3 Windows NT opening your Online Library with Library Reader for 5.3 Windows/NT and MVS 9.2.2.1 workstations distributing the Online Library to VSE 10.1 improving viewing and printing of the CKITLIST.TXT file on OS/2 3.4 shutting down and restarting OS/2 11.2.2 using online libraries 1.3.1 with WIN-OS/2, for OS/2 6.2 with Windows 3.1 6.2 world wide web (WWW) 1.1 WWW World Wide Web 1.1 1BACK_1 Do You Have Questions, Problems, or Suggestions? ¸ Copyright IBM Corp. 1996, 1997 For problems installing or using the library, or accessing books: BACK_1.1 In the U.S.A. ¸ Copyright IBM Corp. 1996, 1997 Do the following: 1. Call the IBM Support Center, 1+800+237-5511. You will first connect with a voice menu. Press 0 at any time to connect with a customer service representative. 2. Tell the customer rep your customer number (access code). If you do not have a customer number, use BookMgr as your generic customer number or access key. 3. The customer rep will ask you if this is a new or an existing problem. Answer: * New if this is the first time you have called about this problem. * Existing if you have a problem management record (PMR) number already assigned to the problem. Note: Make sure you have your PMR number available. 4. The customer rep will ask you what software application operating system you are using. Answer "My product ID is 5648-032-00." Note: Do not answer the operating system question, and if the rep says hold on while he transfers you to Socrates for the PS Support family entitlement, stop him] Tell him you want to use the product ID 5648-032-00 and that you do not want to be transferred to Socrates. 5. Give the customer rep your name, address, phone number, and a description of the problem. The customer rep will generate your PMR and queue it to SCKIT. 6. Hang up and wait for a call back. BACK_1.2 In Other Countries ¸ Copyright IBM Corp. 1996, 1997 Contact IBM through your usual service channel. BACK_1.3 In All Locations ¸ Copyright IBM Corp. 1996, 1997 For problems, questions, or suggestions about any of the books, contact IBM: * Mail the Readers' Comments form from the back of this booklet or one that you printed from an online book, or address comments to: IBM Corporation Department 55JA, Mail Station P384 522 South Road Poughkeepsie, NY 12601-6400 U.S.A. If you mail your comments, you must provide the postage. * FAX comments to: In the U.S. and Canada: 1+914+432-9405 In other countries.: IAC+1+914+432-9405 * Send comments electronically to: Internet: mhvrcfs@vnet.ibm.com World Wide Web: http://www.s390.ibm.com/os390 IBMLink: KGNVMC(MHVRCFS) IBM Mail Exchange: USIB6TC9 at IBMMAIL If you do not use the Readers' Comments form, please mention the order number of this guide (GC31-8311-06) or the book you are using in your comments. If you would like a reply, include your name and address, your company's name, and your phone or FAX number. IBM may use or distribute whatever information you supply in any way it believes appropriate without incurring any obligation to you.