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