IBM Softcopy Librarian - Version=4.6 Product Id. 5648032. The version on the April 2012 collection kits is V4.6 The version on the April 2010 collection kits is V4.4. The version on the April 2009 collection kits is V4.3. The version on the September 2007 collection kits is V4.2j. The version on the December 2004 collection kits is V4.2h. The version on the September 2004 collection kits is V4.2h. The version on the June 2004 collection kits is V4.2g. The version on the March 2004 collection kits is V4.2d. The version on the December 2003 collection kits is V4.2d. The version on the October 2003 collection kits is V4.2b. The version on the August/September 2003 collection kits is V4.2. The version on the June 2003 collection kits is V4.1k Refresh. The version on the March 2003 collection kits is V4.1k Refresh. The version on the December 2002 collection kits is V4.1k Refresh. The version on the September 2002 collection kits is V4.1j. The version on the June 2002 collection kits is V4.1i. The version on the March 2002 collection kits is V4.1g. The version on the December 2001 collection kits is V4.1e. The version on the September 2001 collection kits is V4.1c. PLEASE NOTE - Remember, Support for Softcopy Librarian (SCL) has changed from notifying the IBM Support Center and opening a PMR to sending concerns/problems, suggestions via email to 'bookmgr@us.ibm.com'. These items will now be handled on an 'as time permits' basis. PLEASE READ - V4.2x or earlier versions are not supported on Microsoft Windows Vista or later. V4.3 or later is required for support on Microsoft Windows Vista. V4.3 is not supported on Microsoft Windows 7. V4.4 (and later) is required for support on Microsoft Windows 7. If you have installed V4.2 on Microsoft Windows Vista, you will need to uninstall V4.2 before you install IBM Softcopy Librarian V4.3 or later. When installing on Windows Vista you may receive a message from User Account Control. You will need to select 'Allow' to continue the installation. File location changes: In IBM Softcopy Librarian V4.3 and later, the sources.fil and repository.fil, both now reside in the output directory. On Microsoft Windows XP the default directory for these files is: x:\Program Files\IBM\IBM Softcopy Librarian V4\output where x is the install drive IBM Softcopy Librarian is installed to. On Microsoft Windows Vista and Windows 7 the default directory for these files is: x:\\Roaming\IBM\ibm softcopy librarian\output where x is the install drive IBM Softcopy Librarian is installed to. By default on Microsoft Windows Vista and Windows 7, the Program Files directory is set to read only. Please be advised that Version 4 uses 'Passive' FTP. Version 3 used 'Active'. Presently Version 4 does not support 'Active' FTP. It has also been noted that 'shelves' directories with 'book/pdf' directories as sub directories and vice versa, may cause problems with the SCL catalog. We currently do not recommend that your file structure be set up in this manner. Testing is done with directories set up subordinate only to the root or to another directory unrelated to the repositories. Fixes/Changes in V4.6. This supersedes V4.4. There is no V4.5. Environment variable "APPDATA" now used to construct the default userDirectory path for Windows 7. Users need write permission to this directory. Fixes/Changes in V4.4. This supersedes V4.3. This version developed/tested using: IBM JAVA 1.5, Microsoft Windows 2000, Windows XP Professional w/Service Pack 3, Windows Vista Business with Service Pak 2 and Windows 7. Updated Softcopy Librarian for Microsoft Windows 7 support. Updated the SCL recatalog function for Microsoft Windows Vista and Windows 7. Improved error handling and tracing. Fixes/Changes in V4.3. This supersedes V4.2j. This version developed/tested using: JAVA 1.5- IBM SDK-1, Microsoft Windows 2000, Windows XP Professional w/Service Pack 3, and Windows Vista Business with Service Pak 1. Updated Softcopy Librarian for Windows Vista support. Install an icon on the Windows desktop for IBM Softcopy Librarian. Fixes/Changes in V4.2j. This supersedes V4.2i. This version developed/tested using: JAVA - IBM SDK-1_4_2_07, Windows 2000 and Windows XP Professional w/Service Pack 2. Corrected a problem when uploading a new bookshelf to MVS, the new bookshelf gets the name of an existing bookshelf in the Softcopy Librarian database. Corrected missing URI definition when transmitting PDF's to z/OS repository. Fixed code used to determine the transmit rate when sending source to a repository. Renamed debug.bat to ebrsclnj.bat. Fixes/Changes in V4.2i. This supersedes V4.2h. This version developed/tested using: JAVA - J2SDK-1_4_2_03, JET Excelsior Pro 3.15, and Windows XP Professional w/Service Pack 2. XKS API 05/12/04. Be aware that this version updates both JAVA and JET to new levels. The new version of JAVA now includes multi language support thus when JET is configured it included this support thus the '.exe' SCL install 'ebrsclwj' executable has grown to an approximate file size of somewhere around 45mb. Corrected a problem found in testing where the index '.bki' file type was being appended to an already '.bki' within internally used processes in the code. Also corrected a problem whereas when SCR invoked the User's Guide it errored. SCL was invoking the User's Guide with parameters whereas it appears that the format of these parameters has changed. We now invoke this manual without parameters. Fixed code that was causing errors in the 'Download from Internet' function invoked for files residing in an MVS repository. Corrected a problem when re-transferring missing files to a host-based repository which caused the shelf parameters to be blanked out. Corrected wrong dialog information for large transfers. Fixes/Changes in V4.2h Implemented 08/12/2004. This supersedes V4.2g. This version developed/tested using: JAVA - J2SDK-1_3_1_06, JET Excelsior Pro 3.11, and Windows 2000 Professional. XKS API 05/12/04. Corrected a problem where as the password, if changed on the 'Properties' function, was not being saved and stored. Added support for PDF User's Guide. Support added for the inclusion/processing of 'Index' information as it pertains only to '.boo' documents within an XKSHELF. Indexing for '.PDF' documents is currently unavailable. Corrected problem with the retention of 'FTP Site Commands'. Commands were being stored with a substitute character for a carriage return but when the file was read and the commands broken back out the substitute character was not being replaced by the carriage return thus sending multiple commands on one line which would only execute the first one encountered. Fixes/Changes in V4.2g Implemented 02/09/2004. This supersedes V4.2f. This version developed/tested using: JAVA - J2SDK-1_3_1_06, JET Excelsior Pro 3.11, and Windows 2000 Professional. XKS API 01/14/04. The 'Auto Proxy' routine needed a 'file structure' as part of the URL to process a 'script' correctly. This requirement was eliminated. Changed the FTP process to reinitiate the 'logon' procedure, under certain circumstances, when the connection has been dropped. Reinstated selected functions on 'pull downs' and 'pop ups'. Corrected an internal error whereas the 'changingGroupKey' function was abending if there were identical books within a shelf and there was no actual book present or if the same \ index was being pointed to by multiple bookshelves with no index record present. Corrected a problem where an ending '\' was not being inserted at the end of the 'XKSHELF' and 'PDF'path definition when defining/updating a 'Local or Network Drive' repository. SCL will no longer format its Desktop with Windows other than 'Sources and Repositories' and 'Messages' which are the default. We have found that if any errors are present in formatting the other Windows which cause SCL not to initialize fully, then there could be problems in shutting SCL down. It is also difficult to set trace options to help in debugging the initialization problem. Customers must edit the 'User. ini' file to eliminate the improper initialization and mis- takes here can lead to further problems. Added support which will allow both 'BOO' and 'PDF' Document types to be processed in XKS shelves. Deleted the 'NOINDEX' insertion implemented in V4.2f, having found that it is architected that BKS type shelves can be created with BKSINDEX=blank, BKIDATETIME=blank, BKSIMDSN=blank, and BKSLEXIS=blank. Code now checks for a blank and then formats SCL internal fields with blanks. Customers were having problems with the 'NOINDEX' that was defaulted to. Customers could experience the 'NOINDEX.BKI' showing up in red on their repository window. If so, edit the associated bookshelf and insert blanks where the 'NOINDEX' appears. SCL has been changed to accept a null 'BKSINDEX' field. Fixes/Changes in V4.2f Implemented 01/09/2004. This supersedes V4.2e. This version developed/tested using JAVA - J2SDK-1_3_1_06, JET Excelsior Pro 3.11, and Windows 2000 Professional. Added logic to further to help with HSM recalls. Check the 'Hints and Tips'. If the 'BKSINDEX' field in the shelf is null' or 'blank' it will be formatted with the name 'NOINDEX'. Think we have corrected the 'upper case' problem concerning the 'shelf' and 'book' titles. Reinstated multiple 'select/deselect' function on 'file' view. Updated 'Hints and Tips'. Fixes/Changes in V4.2e Implemented 12/01/2003. This supersedes V4.2d. This version developed/tested using JAVA - J2SDK-1_3_1_06, JET Excelsior Pro 3.11, and Windows 2000 Professional. Changed code to look for both .htm and .html when displaying the 'Getting Started', 'Reporting a Problem', 'Hints and Tips', 'Check for Updates', documents. Added a 'Hints and Tips' HTML document. Fixed the 'Replaced By' function which was not working correctly. Fixed a problem where as the 'EBRXTEMP.XKS' document was temporarily being written to the 'index' path instead of the 'xkshelf' path in UNIX defined z/OS or OS/390 Repositories. Fixes/Changes in V4.2d Implemented 11/08/2003. This supersedes V4.2c. This version developed/tested using JAVA - J2SDK-1_3_1_06, JET Excelsior Pro 3.11, and Windows 2000 Professional. Verified/fixed 'Send To' function as it applies to repository to repository sending. XKS/PDF support was never implemented in the original release. Fixed problem with the Bookshelf List (BKLSHELF) z/OS. When list is initially created it is created under temp name using a HLQ embedded with 'EBRXTEMP'. This temp file was not apply- ing all of the HLQ(s) as supplied in the repository. If more than one HLQ was entered the last one was being ignored. This could cause security violations when creating files. Updated the 'updatewj.htm - Check for Updates(manual)' to correspond with changes to file names and procedures. Fixes/Changes in V4.2c Implemented 10/03/2003. This supersedes V4.2b. This version developed/tested using JAVA - J2SDK-1_3_1_06, JET Excelsior Pro 3.11, and Windows 2000 Professional. Verified/fixed 'Exclude from Shelf' and 'Download from Internet' functions. Changed Install to create Registry entry: HKEY_LOCAL_MACHINE\SOFTWARE\IBM\IBM SoftCopy Librarian V4\4.2n. Changed install to create Registry entry: HKEY_CURRENT_USER\SOFTWARE\BM\IBM SoftCopy Librarian V4.2 This reverses implementation on 09/17/2003. FTP errors on 'PASV' command. '227' response received did not contain () encasing addr/node. Changed code to ignore all data except that consisting of the address/node information. Fixes/Changes in V4.2b Implemented 09/17/2003. This supersedes V4.2a. This version developed/tested using JAVA - J2SDK-1_3_1_06, JET Excelsior Pro 3.11, and Windows 2000 Professional. Fixed problem in building OS390 Book List (BKLSHELF) to delete '.BKS' or '.XKS' suffix on shelf name. Registry entry will now reflect Version N.N plus letter designation as opposed to just N.N in HKEY_CURRENT_USER /software/ibm/. Also, corrected a situation found where the Book Dataset Name in the Book Shelf sometimes contained ".boo" instead of ".book" as the low level qualifier. Fixes/Changes in V4.2a Implemented 08/31/2003. This supersedes V4.2 This version developed/tested using JAVA - J2SDK-1_3_1_06, JET Excelsior Pro 3.11, and Windows 2000 Professional. Reviewed 'Getting Started' Document and changed code to access either 'getstart.htm' or '.html'. Verified the 'Edit Title' function is working correctly. Corrections to windows/panels displayed in reference to size and content. Corrections to 'pulldowns' in reference to enabling/disabling functions. NOTE - The following functions: 'Clone', 'Sync', 'Send To'(as it applies to the 'Repository' (Not 'Source') function), 'Up- date Shelf', 'Exclude from Shelf', and 'Download from the Internet', are currently not available. These items have the highest priority and we are currently working them as time per- mits with emphasis being placed on the 'Send To', 'Update Shelf' , 'Exclude from Shelf', and 'Download from Internet' functions. Please - Let us know if you are using the 'Sync.' and 'Clone' functions. We are thinking of deleting this service. Send comments to bookmgr@us.ibm.com. Also, an 'Unknown' against an 'XKS' shelf and/or its files, u- sually refers to an invalid response in obtaining the shelf. This is primarily caused by and invalid 'DTD'. Visit 'http:// publib.boulder.ibm.com/epubs/df' to obtain 'DTD(s)' and down- load them to the SCL 'run' (usually the install) directory. If several are shown then download the ones you currently do not have because you never can tell which 'DTD' an 'XKS' shelf is using. And again, we have noticed 'null pointer exceptions' in the 'aListWindow' method. Please restart SCL when this happens. Most generally any updating by SCL has usually been done and you are moving on to something else when this happens. Product/Execution Recommendations V4.2: If you have installed SCL from a Collection Kit, please execute the 'check for updates' function and install any newer version found on the Web Site. This is particularly important with a new release because the WEB Site version would most likely contain updates not on the Collection Kit version. This product is now packaged with a JRE of 1_3_1_06 and customers no longer need to have a copy of the SUN (or any) JRE installed on their system. SCL is initiated by executing 'ebrsclwj.bat' or 'debug.bat'. The latter will initiate a 'DOS' or "command Prompt' window that could help with debugging when necessary. The above will set the system variables: 'xercesc_nls_home=' and 'xml4c _home=' to the 'run' directory of the SCL install path (This most generally would be 'Program Files\IBM\IBM SoftCopy Librarian'). The variables will be only good for that session of SCL but the variables can be set permanently by using the operating system administration function. We have included a 'bat' file with the install that can be used to validate the new XKS shelf format. 'validxml.bat' will set the environmental variables and invoked under a 'command session' and initiated with parameters of 'a path to an XKS shelf record' and -print will verify and display the XKS shelf at the terminal. Example - validxml -print c:\path\XKShelfName.xks We do not recommend or support the transferring to more than one repository at a time. Multiple FTP(s) can cause lock out(s) especially on temporary files being created, they may also cause catalogs to be created improperly, and they may cause work station SCL files to be allocated/created/updated improperly. If the data on the 'Repository - ' window appears to be incor- rect at any time during the execution of SCL, use the ' delete cache' function with the 'create catalog' option to rebuild the catalog for the repository in question. Fixes/Changes in V4.2 Implemented 06/27/2003. Extended Shelf/PDF Support. SCL will now not only support the older BKS shelf architecture but also the new XKS shelf architecture and will transfer from the Internet, CD Collection Kit, and Local Source, not only books, adhering to the BKS architecture, but also PDF's that adhere to the new XKS architecture. WARNING - Please be aware that in this first implementation some features such as cloning, synchronization, 'send to' as it pertains to transferring from one repository to another, and other select functions may not be functionable because of the XKS shelf architecture. We will be implementing these features for XKS sup- port in the near future. IBM Softcopy Librarian - Version=4.1k Refresh Product Id. 5648032. This supersedes V4.1j. This version developed/tested using J2SDK-1_3_1_04. October 28, 2002 Please NOTE - Support for Softcopy Librarian has changed from notifying the IBM Support Center and opening a PMR to sending concerns/ problems suggestions via email to 'bookmgr@us.ibm.com'. These items will now be handled on an 'as time permits' basis. Product/Execution Recommendations V4.1k: At this time we recommend that this product execute with JRE 1.3 as opposed to JRE 1.4. Even though we have tested with JRE 1.4 we have found that 1.4 is not as stable as 1.3 with not only some of the other IBM BookManager products but also with WEB browsers and products from other vendors. We do not recommend or support the downloading to more than one repository at a time. Multiple FTP(s) can cause lock out(s) especially on temporary files being created, they may also cause catalogs to be created improperly, and they may cause work station SCL files to be allocated/created/updated improperly. IBM Softcopy Librarian (SCL) V4 Fixes/Changes in 4.1k Refresh Implemented 10/28/2002. - Hopefully fixed the problem where the FTP Process locks when reaching a 'blksize=' which has no value. Looks like when a new repository was created the defaults were not being saved. Fixes/Changes in 4.1k Implemented 09/27/2002 - This 'NOTEPAD' text document 'ebrsclwj.txt', which always has been available after the install and located in the \Program Files\IBM\IBM SoftCopy Librarian\ directory, is now viewable via START, Programs, IBM Softcopy Librarian, Service, Service. - Changed the 'setup' function not to preload 'EBRMGMT' into the 'Book Shelf List' HLQ field or append it automatically as the 'BKLSHELF' HLQ when nothing was entered. NOTE - There is no longer a default HLQ. This is now a required entry and a HLQ must be entered. In the same light, changed the 'FTP' function to append the 'BKLSHELF' HLQ to the 'EBRXTEMP' qualifier before creating the temporary file. The 'BKLSHELF' temporary file will now be renamed with the 'HLQ' entered in the 'new' or 'properties' setup of the repository + 'BKLSHELF', for example, if the 'BKLSHELF' HLQ entered in the 'new' or 'properties' function is 'BKLSHLQ' then the temporary file created previously was 'EBRXTEMP.BKLSHELF' where now it will be 'BKLSHLQ.EBRXTEMP.BKLSHELF'. The file will then be renamed 'BKLSHLQ.BKLSHELF'. The problem with the previous method was that if only one (1) HLQ was entered for 'BKLSHELF' the 'EBRXTEMP' was not preceded with any HLQ at all unless there was at least 2 HLQ's entered on the new/properties function for 'BKLSHELF'. This usually caused RACF errors. The new procedure will allow one (1) or more than one HLQ(s) to be entered for 'BKLSHELF' and should eliminate the RACF error. NOTE - Any HLQ(s) entered must be authorized for the 'userid' if security checking is involved. - Changed the 'Search' function to 'highlight' ('select') the row where the hit was found as opposed to trying to position the cursor at the hit which was the current method (not working correctly) being used. - Changed If/Else logic to correct a problem where if the Repository Name was altered via the 'properties' function, the new name would not replace the old name in the window 'title' when the same 'repository' was opened. - Changed 'migrate' to decrypt the 'port number' when converting the V3.x repository files. Fixes/Changes in 4.1j Implemented 05/20/2002 - Increased the width of the 'Product Categories' Window from the 'Open Source' function, so the Window 'heading/title' would display in full. Fixes/Changes in 4.1i - To fix a hang during Create Catalog, now ignore a bookshelf if BKIBOOKS= is missing. Fixes/Changes in 4.1h - To workaround an ArrayIndexOutOfBounds exception (bug in Java runtime) when opening a Source window, attempt to open the window up to ten times. - Uppercase the shelves filenames in the BKLSHELF dataset - Fixed the concatenation of directory names when creating a catalog on LAN or HFS. - Fixed a Java exception occurring when excluding books from an open shelf view. - Datasetnames no longer set to "" in bkshelf when excluding books. - Details window shows size "Unknown" rather than "0" when the size is not known. - Properly identifies Windows 95 when attempting to open the User's Guide. - Set BKIMDSN to blank instead of an invalid datasetname if shelf does not have an index. Fixes/Changes in 4.1g - Three changes for cloning or repository-to-repository transfers: o Since attempting to calculate filesizes from the FTP Dir results of OS/390 is problematic, always set the filesize to 0 and force a download of a dataset in order to get its true size. o Use the user-specified blocksizes for OS/390 repositories when calculating number of blocks to allocate rather than using a hard-coded 24576. o Send FTP Noop commands to the target repository to keep the connection alive while downloading a huge file. - Change to issue user-speficied site commands AFTER issuing standard site commands. Fixes/Changes in 4.1f - Added icons to the windows - Fixed a migration problem on some non-US English systems Fixes/Changes in 4.1e - Resolved Repository window not being emptied when all shelves were deleted but there was a missing book. - Resolved problem introduced in 4.1d. Change made to ignore VSAM datasets also caused migrated datasets to be ignored, resulting in many missing books. Fixes/Changes in 4.1d - Fixed a java exception which arises when the FTP listing of MVS datasets includes a VSAM dataset. Symptom was that the Create Catalog function never completes and never displays an error message. Fixes/Changes in 4.1c - Fixed a problem with invoking other files (eg Help->Reporting a Problem) on NT based platforms. - Fixed a problem where change from Manual to Direct proxy didn't actually change the settings, ie the Manual settings where still in effect. Fixes/Changes in 4.1b - Fixed migration from V3 problem to allow "." in repository titles. - Fixed migration from V3 problem where multiple hlqs specified for books caused a problem for indexes. - Changed the pointer to the IBM Service Handbook in the User's Guide and in problem.htm. - Fixed the install program to add "uninstall" into Add/Remove Programs. Fixes/Changes in 4.1a - First generally available release. System requirements: Software (We support only the following). - Microsoft Windows XP, Windows Vista, or Windows 7 with the latest service paks applied. Hardware - 1GHz equivalent or faster CPU. - Mimimum 100MB of free space on your hard drive Installation: ebrsclwj.exe is an InstallShield executable. Invoke ebrsclwj to begin the install program. A Java Runtime Environment of at least 1.5.7 is required to run ebrsclnj.bat. Version 4.2 and above will be packaged with the JET compiler which compiles with the JAVA SDK used in the development of the code. IBM Softcopy Reader for Windows version 3.9 or above is needed to view the User's Guide. The latest version of this program will always be available at http://www-01.ibm.com/software/applications/office/bkmgr/librarian.html or http://www-01.ibm.com/support/docview.wss?uid=swg27018857 Uninstallation: This program is uninstalled via the Add/Remove Programs function available from the Control Panel. Documentation: The SCL V4 User's Guide is available by selecting the "User's Guide" icon on the system Start menu NOTE: SCL V4.6 contains the same User Guide as SCL V4.3.