PTF SH13248 MIGRATION/INSTALLATION TIPS VisualInfo for AS/400 V4R3 with the WAF feature File date: June 16, 2000 Last modified: March 15, 2002 _________________________________________________ CONTENTS: Section 1: Preparation Steps Section 2: Installation and Migration Instructions Section 3: Post-Migration Instructions Section 4: Multiple WAF Environments Section 5: Getting Help _____________________________________________________________________ Section 1: Preparation Steps _____________________________________________________________________ The following steps can be done at any time prior to the WAF PTF installation: 1) GO LICPGM to install VI/400 V4R3 (using the product documentation and VI/400 V4R3 Planning and Installation Guide, GC34-4585). 2) Install the VI/400 V4R3 PTF's (for a list of the current and required PTFs, please see info APAR II11424 at the following web site: ftp://ftp.software.ibm.com/as400/products/visualinfo/fixes/v430/server Note: It is highly advisable to request these PTFs via ECS, but not to download them due to their size (they will take hours to download). You may also call SupportLine, and we will be glad to order all of them for you on CD-ROM or tape; they will arrive the next day. 3) Order PTF SH13248 on tape via ECS or VI/400 Support (1-800-237-5511). 4) Download and even restore WAF for V4R3 fixes from the FTP site: ftp://ftp.software.ibm.com/as400/products/visualinfo/fixes/v430/waf The weekend you plan to migrate, you would need to: 5) Run EKDPOST to migrate VI/400 data from V4R1 to V4R3. 6) Install PTF SH13248 using the sh13248.txt from the 'ftp../waf' site listed in step 4 above. 7) Activate the WAF for V4R3 fixes using the associated readme.txt from the same site. _____________________________________________________________________ Section 2: Installation and Migration Instructions _____________________________________________________________________ Note: The instructions below are essentially what is contained in file sh13248.txt, referenced in step 6 above. 1. Sign on as QSECOFR. Change sysval QALWOBJRST to *ALL. Type "GO LICPGM". Take option 11, Install Licensed Programs. 2. The system reads the loaded VI/400 CD-ROM. From the list of programs to install, type a "1" next to 5769VI1. Choose "ImagePlus VisualInfo for AS/400" and "ImagePlus VisualInfo Library and Object Server" from the LPP list. (Objects to install = 1 Programs and language objects). 3. You should receive the message "Work with licensed programs function has completed." The details behind that message show: "*PGM objects for product 5769VI1 option *BASE release V4R3M0 restored. *LNG objects for NLV2924 for product 5769VI1 option *BASE release V4R3M0 restored. *PGM objects for product 5769VI1 option 01 release V4R3M0 restored. *LNG objects for NLV2924 for product 5769VI1 option 01 release V4R3M0 restored." 4. Run DSPPTF on 5769VI1 to make sure all the PTFs listed in informational APAR II11424 are listed. You can get to II11424 at the following web site: ftp://ftp.software.ibm.com/as400/products/visualinfo/fixes/v430/server. Run LODPTF and APYPTF to get the appropriate PTFs installed before you run the EKDPOST procedure -- this is crucial! 5. Sign on as QSECOFR and add QVI to your libl. Type EKDPOST and press F4. Post Install VI/400 R430 (EKDPOST) Type choices, press Enter. Type of Install . . . . . . . . > 2 1=New, 2=Existing Environment . . . . . . . . . . > 2 1=Single, 2=Multiple (just one VI/400 env?) VI/400 file Library . . . . . . > EKDLIBFIL QUSRVI, Name (if you want to keep the same name as your exis- ting libfil library) File library . . . . . . . . . . EKDLIBFIL EKDLIBFIL, Name (your existing libfil library) Additional Parameters Remote Location Name . . . . . . Name Remote File Library . . . . . . Name 3-letter prefix . . . . . . . . QVI 3-letter prefix (cannot be the one you are already using for WAF) 6. After you receive the "Installation completed successfully" message, you are ready to work on the WAF PTF installation. Make sure the tape with PTF SH13248 is available. 7. Load the WAF feature PTF tape. Sign on as QSECOFR and issue RSTOBJ OBJ(PTFFILSF PTFTXTSF PTFEXTSF PTFAPISF PTFLIBSF PTFINSTSF) SAVLIB(QGPL) DEV(TAP01) RSTLIB(QGPL). Note: if you cannot restore all these save files in one fell swoop, then restore them individually. Then issue the following command: RSTLIB SAVLIB(PTFINST) DEV(*SAVF) SAVF(QGPL/PTFINSTSF). 8. Still signed on as QSECOFR, add PTFINST and the RSTLIB from step 7 to your libl. Then issue EKDPTF and press F4. PTF Install WAF/400 R410 (EKDPTF) Type choices, press Enter. File library . . . . . . . . . . EKDLIBFIL EKDLIBFIL, Name (matches VI/400 file library in step 5) Panel library . . . . . . . . . EKDLIBTXT EKDLIBTXT, Name Exit library . . . . . . . . . . EKDEXIT EKDEXIT, Name API library . . . . . . . . . . EKDAPI EKDAPI, Name Program library . . . . . . . . EKDLIB EKDLIB, Name It will not ask you about EKDGPL. 9. You should get message "EKD-8369 System was successfully installed." The system will have changed your JOBD in your xxxGPL library, and it will have created an xxxSBSJOBD in your new file library, which specifies jobq QSYSNOMAX in QSYS for xxxADMIN (where xxx is the 3-character prefix you specified in step 5). 10. The PTF SH13248 Readme says to make sure your libl is QTEMP, EKDLIBFIL (or whatever you named your "VI/400 file library" in step 5), EKDLIBTXT, EKDEXIT, EKDGPL, EKDAPI, EKDLIB and QGPL. 11. GRTOBJAUT *ALL to all objects in the libraries listed in step 10 and the libraries themselves, to the desired group profiles. 12. Install the WAF fixes for V4R3. These are currently contained in the waf430a.bin, waf430b.bin and waf430c.bin files on web site: ftp://ftp.software.ibm.com/as400/products/visualinfo/fixes/v430/waf/ These fixes are uploaded to your AS/400 and stored in a library named WAF430LIB, which should be added as the top library in your WAF users' library list. See the readme.txt at the same web site for installation directions. Don't forget to GRTOBJAUT *ALL to all the objects in WAF430LIB and the library itself to the desired group profiles. _____________________________________________________________________ Section 3: Post-Migration Instructions _____________________________________________________________________ 3.1 Make sure that the EKD411LIB library name is removed from all V4R3 users' job descriptions' library lists. 3.2 If you are using the OS/2 Work Management Builder, and you assign a new name for your xxxLIBFIL library during migration to V4R3, you will need to make a change to a message ID in the EKDMSG2 message file. This file is in your newly migrated xxxLIBFIL library. Please change the value of the USR0022 message ID in this file so that it contains the name of your new xxxLIBFIL library. This operation may be accomplished using PDM (Programming Development Manager). If this change is not made, journalling cannot be started (and error message CPF9801 on program EKDJRNSTRB will result). Without journalling started, the user will be unable to run the OS/2 WMB product. 3.3 If, when trying to run the "Delete work management profiles" option off the EKD300 menu, you receive the message "EKD-6749 Delete profiles were completed unsuccessfully" and the joblog shows that objects EKD0740L3, L4 and L5 were not found and there is a level check on file EKD0740L3, please do the following: Copy the source members EKD0740L3, L4, and L5 from file QDDSSRC in library QVI into file QDDSSRC in library xxxLIBFIL. Please call VisualInfo/400 SupportLine if you need assistance with this task. Copying the source members EKD0740L3, EKD0740L4, and EKD0740L5 into library xxxLIBFIL is all that is needed to fix this error. _____________________________________________________________________ Section 4: Multiple WAF Environments _____________________________________________________________________ 4.1 Special care needs to be taken if multiple WAF environments exist which share libraries (ex: ekdlib). If you have multiple environ- ments and do not plan to migrate them simultaneously, you will need to have at least 2 copies of all the non-file libraries, one which would stay at V4R1 code level and one which would be migrated to the V4R3 level. Then the related job description/library list for each environment would need to updated accordingly. _____________________________________________________________________ Section 5: Getting Help ______________________________________________________________________ 5.1 Call IBM support to report defects and for service and technical support. Telephone in the USA and Canada: 1-800-237-5511 5.2 Online publications for VisualInfo/400 and WAF can be viewed or printed by accessing the ImagePlus Library Web page at the following site: http://www-4.ibm.com/software/data/cm/cmgr/400/library.html These books are in Adobe Acrobat PDF format. Especially helpful might be the publication named ekds5mst, IBM ImagePlus Workfolder Application Facility for AS/400, V4.1 System Administration Guide (SC34-4625-00). This covers how to set up, use, and maintain the WAF for AS/400 product. It includes information about menus and panels. _____________________________________________________________________ Trademarks _____________________________________________________________________ The following are trademarks of the IBM Corporation in the United States or other countries: - AntiVirus - Application Systems/400, AS/400 - Client Access - IBM - ImagePlus - Operating System/400, OS/400 - Personal Communications The following are trademarks of other companies: - Adobe, Acrobat, Acrobat Reader (Adobe Systems, Inc) - ISIS (Pixel Translations) - Rumba (Walldata) - Windows and Windows NT (Microsoft Corporation) 03/15/02