IBM Support

Upgrade BKSRV220, Subset HBKQ220

  Preventive Service Planning

Upgrade BKSRV220, Subset HBKQ220


Upgrade BKSRV220, Subset HBKQ220:

This subset contains installation information for BookServer/MVS BASE
and NLS Version 2, Release 2, Modification 0.


Change Summary

DATE LAST CHANGED SECTION 1. YY/MM/DD INSTALLATION INFORMATION NO ENTRIES 2. 00/03/03 DOCUMENTATION CHANGES 3. 00/11/27 GENERAL INFORMATION 4. 04/07/28 SERVICE RECOMMENDATIONS 5. YY/MM/DD CROSS PRODUCT DEPENDENCIES NO ENTRIES


Service Recommendation Summary

DATE APAR PTF VOLID COMMENTS 23 04/07/28 PQ55870 UQ70831 1000 HIPER WHEN THE UNIX SYSTEM 22 03/04/17 PQ59485 UQ73693 0304 HIPER WHEN ACCESSING BOOKS 21 03/04/17 PQ60067 UQ73693 0304 HIPER PDF DOCUMENTS ARE NOT 20 02/07/05 PQ62588 UQ67800 0207 HIPER FOR ENHANCED SECURITY, 19 02/02/15 PQ46651 UQ62598 0202 HIPER SEARCHING VIA BOOKSERVER 18 02/02/15 PQ46842 UQ62598 0202 HIPER BOOKSERVER LIMITATIONS 17 02/02/15 PQ55228 UQ62598 0202 HIPER SEARCHING SOME INDEXED 16 01/07/30 PQ48893 UQ55043 0107 HIPER ABEND0C4 IN FINDPDF AT 15. 01/04/16 PQ44899 UQ52984 0104 TOC FONTS ARE TOO SMALL 14. 01/04/16 PQ41421 UQ52984 0104 JAVASCRIPT ERROR - PERMISSION 13 01/01/10 PQ44257 UQ49880 0101 HIPER CROSS LINK OF BOOKS FAILS 12. 00/11/27 PQ37515 UQ48911 0011 BOOKS WITH TITLES OF C/C++ ARE 11. 00/11/27 PQ40691 UQ48911 0011 INTRODUCE PDF "ULTRALITE" 10. 00/11/27 PQ40327 UQ48911 0011 CROSS-BOOK LINKS BETWEEN BOOKS 9. 00/11/27 PQ39291 UQ48911 0011 THIS APAR ROLLS UP PROBLEMS 8. 00/11/27 PQ37671 UQ48911 0011 LINKS ARE BROKEN IN A BOOK CASE 7. 00/11/27 PQ36798 UQ48911 0011 BOOKS IN DATASETS WITH # SIGN IN 6. 00/08/21 PQ37619 UQ44217 0008 THE BOOKREAD API SHIPPED WITH 5. 00/04/28 PQ35512 UQ42601 0004 "USER COMPLETION CODE=4094 4. 00/04/28 PQ34585 UQ42601 0004 BOOKSHELF FAILING DUE TO IT'S 3. 00/04/28 PQ34588 UQ42601 0004 FIND BOOK FUNCTION ON THE 2. 00/04/28 PQ31191 UQ39283 0002 UPDATE THE BOOKSERVER GETTING 1. 99/10/04 PQ28399 UQ34074 9909 HIPER FIXES FROM ESP AND NLS.


Installation Information

This section contains changes to the product's Program Directory. 1. YY/MM/DD NO ENTRIES


Documentation Changes

This section outlines major errors in the product's published documentation. 1. 00/03/03 SECTION 9.4.5.4.8 WEBSPHERE APPLICATION SERVER CUSTOMIZATION CONSIDERATIONS OF THE OS/390 RELEASE 8 AND RELEASE 9 PROGRAM DIRECTORIES CONTAINS THE FOLLOWING DIRECTIVE, WHICH IS INCORRECT: exec /bookmgr-cgi/bookmgr.cmd/* /usr/lpp/booksrv/cgi-bin/bookmgr.exe* THE CORRECT DIRECTIVE IS: exec /bookmgr-cgi/bookmgr.cmd* /usr/lpp/booksrv/cgi-bin/bookmgr.exe*


General Information

2. 00/11/27 PDF "ULTRALITE" DOCUMENTATION BOOKSERVER IS ADDRESSING THE REQUIREMENT TO PROVIDE ACCESS TO HIGH-FIDELITY PRINT ON DEMAND DOCUMENTATION ALONG WITH HIGH PERFORMANCE, HIGH FUNCTION SOFTCOPY. THE FIRST PHASE OF SUPPORT FOR THIS REQUIREMENT PROVIDES ACCESS TO PDF FILES WITH FILENAME PREFIXES IDENTICAL TO THE PREFIXES OF THE CORRESPONDING BOOKMANAGER BOOKS. TO MAKE THIS FUNCTION ACCESSIBLE TO USERS, A LIBRARY ADMINISTRATOR SIMPLY PLACES THE PDF VERSION OF A DOCUMENT IN A FILE OR DATASET NAMED WITH THE SAME PREFIX AS THE FILE CONTAINING THE BOOKMANAGER BOOK VERSION OF THE DOCUMENT. THE PDF VERSION MUST BE PLACED WHERE BOOKSERVER CAN FIND IT. THESE EXAMPLES WILL EXPLAIN WHERE BOOKSERVER WILL LOOK FOR PDF FILES CORRESPONDING TO BOOKMANAGER BOOKS FOR EXAMPLE: A BOOK STORED IN AN MVS DATASET NAMED YADAYADA.BOOKMGRR.BOOK WILL CAUSE BOOKSERVER TO FIND A CORRESPONDING PDF DATASET NAME YADAYADA.BOOKMGRR.PDF. A SECOND EXAMPLE IF THE DATASET IN THE FIRST EXAMPLE IS NOT FOUND, HFS DIRECTORIES WILL BE SEARCHED FOR BOOKMGRR.PDF, BOOKMGRR.PDF AND BOOKMGRR.PDF. THE HFS DIRECTORIES TO BE SEARCHED ARE THE "COLLECTIONS" OR BOOK PATH DIRECTORIES SPECIFIED ON THE BOOKSERVER ADMINIS- TRATION PAGE. SO, IF THE BOOK PATH SPECIFIES "/U/TEST/BOOKS" AND "/U/JIMOD/BOOKS" THEN BOOKSERVER WILL LOOK FOR /U/TEST/BOOKS/BOOKMGRR.PDF AND /U/JIMOD/BOOKS/BOOKMGRR.PDF AND ALL LOWER CASE AND ALL UPPER CASE VERSIONS OF THE FILENAME A THIRD EXAMPLE IF BOOKS AND PDFS ARE SEGREGATED INTO DIFFERENT DIRECTORIES LIKE SO: BOOKS ARE IN /U/TEST/BOOKS AND PDFS ARE IN /U/TEST/PDF, THEN BOOKSERVER WILL ALSO LOOK FOR /U/TEST/PDF/BOOKMGRR.PDF AND /U/JIMOD/PDF/BOOKMGRR.PDF. A FOURTH EXAMPLE WHEN THE BOOKMANAGER BOOK NAMED BOOKMGRR.BOO IS STORED IN AN HFS FILE NAMED /U/TEST/BOOKS/BOOKMGRR.BOO, THE SEARCH FOR THE CORRESPONDING PDFS NAMED BOOKMGRR.PDF BEGINS AS IN THE SECOND AND THIRD EXAMPLES. THE USER INTERFACE FOR PDF ACCESS: WHEN A PDF EQUIVALENT DOCUMENT IS FOUND, A PDF ICON WILL BE PRESENTED TO BOOKSERVER USER. IN THE CONTEXT OF A LIST OF DOCUMENTS SUCH AS A SHELF, THE PDF ICON IS USED TO START THE ACROBAT BROWSER PLUGIN. IN THE CONTEXT OF TOPIC TOOL BAR, THE PDF ICON IS USED TO INITIATE DOWNLOADING THE PDF FILE. PDF DATASETS AND MIGRATION: THE PDF ICON REPRESENTS THE CURRENT STATE OF THE PDF FILE. IN THE CASE OF AN HFS FILE, THESE STATES ARE AVAILABLE AND NOT AVAILABLE. IN THE CASE OF PDF FILES STORED IN DATASETS, THE STATES THE DATASET CAN BE IN ARE: AVAILABLE, MIGRATED TO DASD, MIGRATED TO TAPE, BEING RECALLED FROM DASD AND BEING RECALLED FROM TAPE, AND NOT AVAILABLE. CLICKING ON THE ICON OF A MIGRATED PDF WILL CAUSE A RECALL REQUEST FOR THE DATASET TO BE ISSUED.CLICKING ON THE ICON OF A PDF BEING RECALLED WILL CAUSE THE STATUS OF THE DATASET TO BE RE-CHECKED, AND THE PAGE TO BE RE-DISPLAYED. RELOADING THE PAGE WILL ALSO RE-CHECK THE STATUS OF ANY PDF DATASETS IN A "RECALL PENDING" STATE. 1. 00/11/27 BOOKSERVER CONFIGURED FOR DBCS LANGUAGES WHEN BOOKSERVER IS CONFIGURED FOR DBCS LANGUAGES, JAPANESE, CHINESE, KOREAN,AND CONFIGURE TO USE THE FRAMES BASED END USER INTERFACE AND THE NETSCAPE BROWSER IS USED BY END USERS, THERE MAY BE PROBLEMS WITH THE APPEARANCE AND FUNCTIONALITY OF THE LINKS IN THE TABLE OF CONTENTS FRAME, WHICH WILL RENDER THOSE LINKS NON-FUNCTIONAL


Service Recommendations

23 04/07/28 PROBLEM: (PQ55870) WHEN THE UNIX SYSTEM SERVICES "MAN" COMMAND IS ISSUED VIA A TELNET SESSION THE DISPLAY CAN FREZE. USERS AFFECTED: All BookRead API users. RECOMMENDATION: INSTALL UQ70831 ON VOLID 1000 (HBKQ220) 22 03/04/17 PROBLEM: (PQ59485) WHEN ACCESSING BOOKS STORED AS HFS FILES WITH LOWER CASE NAMES, CATALOG SEARCH FAILS TO LOCATE THE APPLICABLE ENTRY. USERS AFFECTED: All BookServer/MVS 2.2 users. RECOMMENDATION: INSTALL UQ73693 ON VOLID 0304 (HBKQ220) 21 03/04/17 PROBLEM: (PQ60067) PDF DOCUMENTS ARE NOT LOCATED AFTER APPLICATION OF PTF UQ62598. USERS AFFECTED: All BookServer/MVS 2.2 users. RECOMMENDATION: INSTALL UQ73693 ON VOLID 0304 (HBKQ220) 20 02/07/05 PROBLEM: (PQ62588) FOR ENHANCED SECURITY, BOOKSERVER INSTALLATION WILL BE MODIFIED TO REMOVE WORLD WRITABLE ATTRIBUTE FROM DEFAULT PERMISSIONS. USERS AFFECTED: All BookServer V2.2 users. RECOMMENDATION: INSTALL UQ67800 ON VOLID 0207 (HBKQ220) 19 02/02/15 PROBLEM: (PQ46651) SEARCHING VIA BOOKSERVER RESULTS IN NO MATCHES. A SEARCH ON THE SAME STRING AND INDEX WILL, HOWEVER YIELD HITS IN READ/MVS. USERS AFFECTED: Bookmanager users searching a shelf when the index exceeds 128 megabytes in size. RECOMMENDATION: INSTALL UQ62598 ON VOLID 0202 (HBKQ220) 18 02/02/15 PROBLEM: (PQ46842) BOOKSERVER LIMITATIONS WITH SOME FIREWALL AND SSL CONFIGURATIONS USERS AFFECTED: Users with complex network configurations including firewalls or SSL. RECOMMENDATION: INSTALL UQ62598 ON VOLID 0202 (HBKQ220) 17 02/02/15 PROBLEM: (PQ55228) SEARCHING SOME INDEXED SHELVES RESULTS IN A BLANK WEB PAGE, AND A HEAP-CHECK ABEND IS WRITTEN TO THE CONSOLE LOG. USERS AFFECTED: Users searching a bookshelf which has an index stored in an HFS file when the shelf has a number of books divisible by eight. RECOMMENDATION: INSTALL UQ62598 ON VOLID 0202 (HBKQ220) 16 01/07/30 PROBLEM: (PQ48893) ABEND0C4 IN FINDPDF AT OFFSET 2FC. USERS AFFECTED: Users who store BookManager books in MVS datasets exclusively and who therefor configure no book directories on the administration page will experience this problem. RECOMMENDATION: INSTALL UQ55043 ON VOLID 0107 (HBKQ220) 15. 01/04/16 PROBLEM: (PQ44899) TOC FONTS ARE TOO SMALL USERS AFFECTED: ALL USERS. RECOMMENDATION: INSTALL UQ52984 ON VOLID 0104 (HBKQ220) 14 01/04/16 PROBLEM: (PQ41421) JAVASCRIPT ERROR - PERMISSION DENIED USING INTERNET EXPLORER 5.5 TO ACCESS TOPICS IN BOOKS IN MVS DATASETS. USERS AFFECTED: IE 5.5 USERS ACCESSING BOOKS IN MVS DATASETS AND HAVING FRAMES FUNCTION ON. RECOMMENDATION: INSTALL UQ52984 ON VOLID 0104 (HBKQ220) 13 01/01/10 PROBLEM: (PQ44257) CROSS LINK OF BOOKS FAILS FOR LARGE SHELVES IN FRAMES MODE. USERS AFFECTED: User's who attempt to use large shelves which refer to books stored in MVS datasets. RECOMMENDATION: INSTALL UQ49880 ON VOLID 0101 (HBKQ220) 12. 00/11/21 PROBLEM: (PQ37515) BOOKS WITH TITLES OF C/C++ ARE NOT USING THE FIND BOOK FUNCTION EVEN THOUGH THEY ARE PRESENT IN THE LIBRARY. USERS AFFECTED: USERS OF THE FIND BOOK FUNCTION ATTEMPTING TO FIND BOOKS WITH SPECIAL CHARACTERS IN THE TITLE. RECOMMENDATION: INSTALL UQ48911 ON VOLID 0011 (HBKQ220) 11. 00/11/27 PROBLEM: (PQ40691) WHEN A FILE IS FOUND WITH A SUFFIX '.PDF' AND A PREFIX SIMILAR TO THAT OF THE FILE CONTAINING THE BOOKMANAGER BOOK BEING DISPLAYED, OR MENTIONED, AN ICON REPRESENTING THAT PDF WILL BE PRESENTED. DEPENDING ON CONTEXT, CLICKING ON THESE ICONS WILL INITIATE EITHER A DOWNLOAD OF THE PDF, OPENING THE PDF WITH THE ACROBAT PLUGIN, OR RECALLING THE PDF FILE FROM MIGRATED STATUS. USERS AFFECTED: USERS WHO DESIRE CONVENIENT ACCESS TO HIGH-FIDELITY PRINT-ON-DEMAND VERSIONS OF BOOKMANAGER DOCUMENTS WILL ENJOY THE NEW FUNCTIONALITY INTRODUCED WITH THIS APAR. RECOMMENDATION: INSTALL UQ48911 ON VOLID 0011 (HBKQ220) 10. 00/11/27 PROBLEM: (PQ40327) WHEN ATTEMPTING CROSS-BOOK LINKING WITH BOOKS IN MVS DATASETS ERROR RECEIVED: "DOCUMENT NUMBER XXXX-XXXX COULD NOT BE FOUND OR HAS NOT BEEN CATALOGUED. THE CROSS-BOOK LINK FAILED." THIS ERROR OCCURS WHEN THE BOOKS ARE ALL LOCATED ON THE SAME BOOKSHELF. USERS AFFECTED: BOOKSERVER USERS AT INSTALLATIONS WHO INSTALL BOOKS IN MVS DATASETS, AND ACCESS THE BOOKS VIA BOOKSHELVES. RECOMMENDATION: INSTALL UQ48911 ON VOLID 0011 (HBKQ220) 9. 00/11/21 PROBLEM:(PQ39291) 1) VERSION 2.2 OF BOOKSERVER, PREVENTED ALL BOOKSERVER PAGES FROM BEING PROPERLY RENDERED WITHIN AN EXISTING FRAME. WITH THE EXCEPTION OF BOOK TOPIC PAGES THAT THEMSELVES FRAMED,(I.E. WHEN THE FRAMES- BASED EUI ADMINISTRATION OPTION IS SET) ALL BOOKSERVER PAGES SHOULD HAVE BEEN ALLOWED TO BE CONTAINED IN AN EXISTING FRAME. 2) WHEN FRAMES-BASED EUI WAS ENABLED, NETSCAPE'S BACK ARROW OFTEN RESULTED IN A BLANK TABLE OF CONTENTS FRAME. 3) WHEN A SEARCH HIT OCCURRED WITHIN A TOPIC TITLE, AT TIMES THE PAGE WAS SCROLLED BEYOND THE TITLE. 4) FOR SOME BOOKS, SOME REFLOWABLE TEXT WAS INCORRECTLY BEING RENDERED AS PREFORMATTED TEXT. USERS AFFECTED: TWO GROUPS OF USERS ARE AFFECTED BY THE CHANGES ROLLED UP IN THIS APAR. FIRST: USERS ACCESSING BOOKSERVER TOPICS USING THE NETSCAPE NAVIGATOR BROWSER AND THE FRAMES BASED EUI, WERE PRONE TO SEEING A BLANK TABLE OF CONTENTS FRAME WHENEVER THEY USED THE BROWSERS "BACK" BUTTON. SECOND: USERS ACCESSING BOOKS CONTAINING CERTAIN VECTOR GRAPHICS WOULD SEE A GARBLED RENDITION OF THOSE GRAPHICS. A HIGH FIDELITY VERSION OF THOSE GRAPHICS CAN NOW BE OBTAINED BY CONVERTING THE GRAPHICS IN THE BOOK TO STANDARD WEB SERVABLE FORMAT. INSTRUCTIONS AND THE TOOLS REQUIRED FOR TRANSMOGRIFICATION, (THE GRAPHICS FORMAT CONVERSION PROCESS), ARE AVAILABLE THROUGH THE WORLD WIDE WEB AT: HTTP://BOOKSRV2.RALEIGH.IBM.COM, THEN "SERVICE HINTS AND TIPS" THEN "DOWNLOAD THE LATEST VERSION OF THE IBM BOOK GRAPHICS CONVERSION UTILITY (TRANSMOGRIFIER)" RECOMMENDATION: INSTALL UQ48911 ON VOLID 0011 (HBKQ220) 8. 00/11/27 PROBLEM: (PQ37671) LINKS ARE BROKEN IN A BOOK CASE REFERRING TO A SHELF WITH A POUND SIGN, AND IN A SHELF WHERE BKMDSN HAS A TRAILING BLANK. USERS AFFECTED: Users of BookServer cases wishing to include shelves which contain pound signs in their filenames. RECOMMENDATION: INSTALL UQ48911 ON VOLID 0011 (HBKQ220) 7. 00/11/27 PROBLEM: (PQ36798) BOOKS IN DATASETS WITH # SIGN IN THEIR NAME CANNOT BE DISPLAYED WHEN FRAMES IS ENABLED USERS AFFECTED: USERS AT SITES WHERE THE BOOKMANAGER BOOKS ARE STORED IN DATASETS WITH NAMES CONTAINING POUND SIGNS. RECOMMENDATION: INSTALL UQ48911 ON VOLID 0011 (HBKQ220) 6. 00/08/21 PROBLEM: (PQ37619) 1) Use of the EPHBOOKREADCONFIG environment variable was incorrect. 2) Support for concatenated PARMLIBS was missing. 112105 return code from BOOKREAD when the default is used. USERS AFFECTED: Systems Programmers configuring OS/390 Release 7 and above would be affected when they configure BOOKREAD to support the Unix Systems Services "MAN" command. RECOMMENDATION: INSTALL UQ44217 ON VOLID 0008 (HBKQ220) 5. 00/04/28 PROBLEM: (PQ35512) "USER COMPLETION CODE=4094 REASON CODE=0000002C" MESSAGE APPEARS IN THE SYSTEM CONSOLE LOG AS A RESULT OF BOOKSERVER EXECUTION. USERS AFFECTED: BOOKSERVER USERS OF OS/390 V2R8 AND ABOVE. POTENTIALLY ANY USERS OF BOOKSERVER WHO HAPPEN TO HAVE CONFIGURED LE OPTIONS WITH HEAPCHK(ON). RECOMMENDATION: INSTALL UQ42601 ON VOLID 0004 (HBKQ220) 4. 00/04/28 PROBLEM: (PQ34585) BOOKSHELF FAILING DUE TO IT'S HUGE SIZE, AND THE FACT THAT IT CONTAINS 346 LOGICALLY DELETED BOOKS. USERS AFFECTED: USERS WITH A LARGE NUMBER OF LOGICALLY DELETED BOOKS ON A BOOKSHELF. THE DISPLAY OF A SHELF WITH A LARGE NUMBER OF LOGICALLY DELETED BOOKS WILL DISPLAY BLANK TITLES FOR RECOMMENDATION: INSTALL UQ42601 ON VOLID 0004 (HBKQ220) 3. 00/04/28 PROBLEM: (PQ34588) FIND BOOK FUNCTION ON THE LIBRARY PAGE OPENS ALL THE BOOK FILES INSTEAD OF USING THE CARD CATALOG. USERS AFFECTED: USERS WITH A LARGER NUMBER, OR LENGTHY, HFS BOOK DIRECTORIES CONFIGURED. RECOMMENDATION: INSTALL UQ42601 ON VOLID 0004 (HBKQ220) 2. 00/04/28 PROBLEM: (PQ31191) UPDATE THE BOOKSERVER GETTING STARTED BOOK CORRECT PROBLEM WITH UNCONFIGURED PICDIR PARAMETER USERS AFFECTED: ALL ENGLISH USER'S WILL NOW SEE THE RELEASE 2.2 GETTING STARTED BOOK. NORWEGIAN, SWEDISH,DANISH AND PORTUGUESE USERS WILL ALSO BE SHOWN THE ENGLISH GETTING STARTED BOOK FOR V2R2. ALL OTHER USERS CONTINUE TO SEE THE V2R1 GETTING STARTED BOOK AND HELP TOPICS. USERS WHO USED THE DEFAULT PICDIR PARAMETER WILL NOW BE ABLE TO ZOOM IN ON GRAPHICS RECOMMENDATION: INSTALL UQ39283 ON VOLID 0002 (HBKQ220) 1. 99/10/04 PROBLEM: (PQ28399) APPLYING PTF UQ34074 MAY CAUSE JAVASCRIPT ERRORS AND EMPTY TABLE OF CONTENTS FRAMES. USERS AFFECTED: THOSE USING THE FRAMES INTERFACE AFTER INSTALATION OF THE PTF, EITHER: 1) CLEAR THEIR PICTURE CACHE FROM THE BOOKSERVER ADMINISTRATION PAGE. OR 2) DELETE ALL THE FILES IN THEIR FRAMES DIRECTORY. RECOMMENDATION: INSTALL UQ34074 ON VOLID 9907


Cross Product Dependencies

This section contains information that is dependent upon another product other than this subset ID. It also contains information dealing with migration and product coexistance. 1. YY/MM/DD INTERDEPENDENT PRODUCT: PROBLEM: USERS AFFECTED: RECOMMENDATION: INSTALL XXXXXXX ON VOLID XXXX


Informational / Documentation


PTF / APAR Reference Lists

PTF Include List
UQ70831
PTF Exclude List
PE APAR List


End of Upgrade BKSRV220 , Subset HBKQ220 , as of 2018/09/17.



Document information

More support for: z/OS family

Modified date: 28 July 2004