LAST UPDATED: November 5, 2004 +------------------------------------------------------------+--------------+ | 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 SH15297 SH15297 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 SH15297 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 SH15297 ______________________________ 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 V5R3 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 iSeries V5R3. ***IMPORTANT*** This PTF will only load on systems which originally migrated from VisualInfo V4R1 with the WAF feature. Preparations for Installing PTF SH15297 _______________________________________ 1) To migrate from Content Manager for iSeries V5R1 with the WAF feature to Content Manager for iSeries V5R3, follow the tips below: a) Record the names of your WAF libraries used while on V5R1 for reference during the migration to V5R3 and installation of this PTF. (ex: EKDLIBFIL, EKDLIBTXT, EKDGPL, EKDAPI, EKDEXIT, EKDLIB). b) During the migration to Content Manager for iSeries V5R3, be sure to reference the migration/installation tips in the inst530.txt file on our FTP site: ftp://ftp.software.ibm.com/as400/products/contentmanager/v530/waf/ c) Record the name used for your "CM/400 File Library" in V5R3. This will be whatever name you specified for the parameter by that name during EKDPOST. For example, if you keep the default, your V5R1 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 V5R3 (ex: EKDLIBTXT, EKDGPL, EKDAPI, EKDEXIT, EKDLIB) 2) Before installing PTF SH15297, 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 SH15297 ______________________ 1. Signon to the server as QSECOFR. Load the WAF PTF SH15297 CD-ROM in the CD drive. 2. Run the WRKOPTVOL command to ascertain the Volume name on your WAF PTF CD-ROM. The example below uses BLANKVOLID01. Replace BLANKVOLID01 with your Volume label. CPY OBJ('/QOPT/BLANKVOLID01/PTFFILSF.SAV') + TOOBJ('/QSYS.LIB/QGPL.LIB/PTFFILSF.FILE') REPLACE(*YES) + FROMCCSID(*PCASCII) TOCCSID(*CALC) You can use F9 to retrieve the command and change the OBJ parameter until each of the save files are successfully restored (PTFAPISF.SAV, PTFEXTSF.SAV, PTFFILSF.SAV, PTFINSTSF.SAV, PTFLIBSF.SAV, and PTFTXTSF.SAV). 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 V5R3 file library during EKDPOST (ex: QUSRVI). For all other libraries, specify the name of your V5R1 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 V5R3 should be removed from the library list (ex: WAF510A or @SC* libraries). The code contained in this PTF provides fixes equivalent to the SC37185 PTF level of V5R1. Fixes beyond that PTF for V5R1 will be made available separately for this new WAF running on Content Manager for V5R3 at the following FTP site: ftp://ftp.software.ibm.com/as400/products/contentmanager/v530/ 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. Important note for WAF fax users ________________________________ WAF Fax Integration does not support the Facsimile Support/400 Enhanced Services. You should set the Enhanced Services (ENHSRV) parameter to *NO when starting Facsimile Support/400 using the STRFAXSPT command. (Note that the default for this parameter is *YES.) IBM Software Manufacturing Solutions