LAST UPDATED: September 28, 2001 +------------------------------------------------------------+--------------+ | IBM | | +------------------------------------------------------------+--------------+ +------------------------------------------------------------+--------------+ TO: Licensees of IBM Content Manager for iSeries Version 5, IBM Operating System/400 SUBJECT: Program Number 5733-A18 -- Release 01, Modification Level 00 PTFs for Feature 5050 The material you have received is listed on the enclosed Packing List. Please review the Packing List to ensure you have received all items listed. The enclosed Machine Readable Materials contain the only PTF(s) currently valid. The MRM label(s) show the following PTF sequence number(s). PTF MRM LABEL SH15232 SH15232 This Program Temporary Fix (PTF) is subject to the provisions of the Agreement for IBM Licensed Programs. By this Agreement, the customer has agreed not to provide or otherwise make available the PTF(s) to any person other than customer or IBM employees. If the customer wishes to dispose of the licensed PTF(s), which remains the property of IBM, the customer should destroy the PTF(s) and certify the destruction thereof to IBM in writing. The PTF(s) may not be given to third parties, except during the period any such person is on the customer's premises with the customer's permission for the purposes specifically related to the customer's use of the PTF(s). IBM Content Manager for iSeries Version 5 Workfolder Application Facility Feature (WAF) _____________________________________________ Product Number: 5733-A18 This document contains installation instructions for PTF SH15232 as well as information about the functions provided in this PTF. It should be used to supplement the WAF product documentation from V4R1. The WAF functions provided in this PTF are equivalent to those provided in the VisualInfo for AS/400 WAF Feature in V4R1 at PTF level SH13230 or it's equivalent (EKD411* libraries). Who Should Install PTF SH15232 ______________________________ This PTF is intended for customers who originally used VisualInfo for AS/400 V4R1 with the WAF feature but now wish to migrate to Content Manager for V5R1 yet continue to make use of WAF functions. With this PTF, existing WAF customers will be able to continue to use the WAF functions from V4R1 while running with Content Manager for V5R1. ***IMPORTANT*** This PTF will only load on systems which originally migrated from VisualInfo V4R1 with the WAF feature. Preparations for Installing PTF SH15232 _______________________________________ 1) To migrate from VisualInfo for AS/400 V4R3 with the WAF feature to Content Manager for iSeries V5R1, follow the tips below: a) Record the names of your WAF libraries used while on V4R3 for reference during the migration to V5R1 and installation of this PTF. (ex: EKDLIBFIL, EKDLIBTXT, EKDGPL, EKDAPI, EKDEXIT, EKDLIB). b) During the migration to Content Manager for iSeries V5R1, be sure to reference the migration/installation tips in the inst510.txt file on our FTP site: ftp://ftp.software.ibm.com/as400/products/contentmanager/v510/waf/ c) Record the name used for your "VI/400 File Library" in V5R1. This will be whatever name you specified for the parameter by that name during EKDPOST. For example, if you keep the default, your V4R3 file library (ex: EKDLIBFIL) will be renamed to QUSRVI, making QUSRVI the new name of your file library. d) Do not delete the other WAF libraries after migrating to Content Manager for V5R1 (ex: EKDLIBTXT, EKDGPL, EKDAPI, EKDEXIT, EKDLIB) 2) Before installing PTF SH15232, backup any existing Content Manager libraries. To do so, sign on as security officer and use the iSeries Save Library Command (SAVLIB) from the SAVE menu. Installing PTF SH15232 ______________________ 1. Signon to the server as QSECOFR. 2. Issue the RSTOBJ command as follows to restore each of the following save files: PTFFILSF, PTFTXTSF, PTFEXTSF, PTFAPISF, PTFLIBSF, PTFINSTSF RSTOBJ OBJ(PTFFILSF) SAVLIB(QGPL) DEV(TAPXX) ENDOPT(*LEAVE) + RSTLIB(XXXXXX) replacing XX for the tape device name and appropriate restore library (we recommend QGPL). You can use F9 to retrieve the command and change the OBJ parameter until each of the save files are successfully restored. 3. Issue the following command from the server command line once the save files have been uploaded. This restores the installation library: RSTLIB SAVLIB(PTFINST) DEV(*SAVF) SAVF(XXXXXX/PTFINSTSF) 4. Add PTFINST to your library list using ADDLIBLE. 5. Type the command EKDPTF and press F4 to prompt it. NOTE: The command (EKDPTF) will perform the necessary restores from the save files and some additional installation process steps. Do not attempt to restore the libraries from the save files yourself. 6. Complete the prompts with your library names. For the File library, be sure to use the name you specified for your V5R1 file library during EKDPOST (ex: QUSRVI). For all other libraries, specify the name of your V4R3 WAF libraries, (ex: EKDLIBTXT, EKDGPL, EKDAPI, EKDEXIT, EKDLIB). 7. Press Enter. Message "EKD8369 System was successfully installed" will be issued when the PTF apply is complete. Post Installation Instructions ______________________________ 1. After successfully applying the PTF, authority should be granted to all the affected libraries as specified during the installation. Use the server command GRTOBJAUT to grant *ALL authority to each library and the objects in them to the group profile(s) used by your WAF environment. 2. The library lists for each environment will need to be set up to reference the appropriate libraries. This is normally controlled via job descriptions (ex: ekdjobd and qvijobd) associated with user profiles. NOTE: This PTF does not permit the sharing of Content Manager and WAF program libraries. While the file or data library is shared, the programs are not. As depicted below, the library list should be controlled to match whether a user is working through Content Manager or WAF. Example library list for working in the WAF environment: QTEMP QUSRVI EKDLIBTXT EKDEXIT EKDGPL EKDAPI EKDLIB QGPL Example library list for working in Content Manager environment: QTEMP QUSRVI QVI QGPL NOTE: Fix libraries used while running Content Manager V5R1 should be removed from the library list (ex: WAF430LIB or #SC* libraries). The code contained in this PTF provides fixes equivalent to the SH13248 PTF level of V4R3. Fixes beyond that PTF for V4R3 will be made available separately for this new WAF running on Content Manager for V5R1 at the following FTP site: ftp://ftp.software.ibm.com/as400/products/contentmanager/v510/ under the WAF directory. Directions related to applying those fixes will also be included at that site. 3. After the successful migration of all WAF environments, you may delete the PTFINST library and the save files that were created by this process: PTFINSTSF, PTFFILSF, PTFTXTSF, PTFEXTSF, PTFAPISF, and PTFLIBSF. IBM Software Manufacturing Solutions