MQSeries Workflow 3.2.2 - Service Pack #1 ----------------------------------------- INDEX ------------------------------------------ 1. Installation of Service Pack #1 1.1 Installation on IBM OS/2 1.2 Installation on Microsoft Windows 1.3 Installation on IBM AIX 1.4 Installation on Sun Solaris 1.5 Installation on HP-Unix 2. Important Notices 3. Changes 3.1 Changes in Service Pack #1 ------------------------------------------ 1. Installation of Service Pack #1 =========================================== 1.1 Installation on IBM OS/2 ------------------------------------------- 1.1.1 Which files must be downloaded? The Service Pack consists of several self-extracting executables. One for each National Language version of IBM MQSeries Workflow. If you need to update another language than U.S. English ("ENU"), both the U.S. English language version and the language dependent version must be downloaded. Following the list of the self-extracting executables: O322ENU1.EXE - U.S. English language version including the common files of MQSeries Workflow O322CHS1.EXE - Simplified Chinese language version O322CHT1.EXE - Traditional Chinese language version O322DAN1.EXE - Danish language version O322DEU1.EXE - German language version O322ESP1.EXE - Spanish language version O322FIN1.EXE - Finnish language version O322FRA1.EXE - French language version O322HEB1.EXE - Hebrew language version O322HUN1.EXE - Hungarian language version O322ITA1.EXE - Italian language version O322JPN1.EXE - Japanese language version O322KOR1.EXE - Korean language version O322NLD1.EXE - Dutch language version O322NOR1.EXE - Norwegian language version O322PLK1.EXE - Polish language version O322PTB1.EXE - Brazilian Portuguese language version O322PTG1.EXE - Portuguese language version O322TRK1.EXE - Turkish language version 1.1.2 Unpack the files Copy the O322ENU1.EXE to a temporary directory and execute it using the command: O322ENU1 /D . This command unpacks the common files and the U.S. English files. If you need to update another language than U.S. English ("ENU"), you must copy the additionally downloaded file to the temporary directory and execute it by the command: O322xxx1 /D . where 'xxx' is the language abbreviation. 1.1.3 Update your existing MQSeries Workflow installation To install this Service Pack, use the Install & Maintain icon in your MQSeries Workflow folder. Note: First stop any running MQSeries Workflow programs. 1. Double-click on the MQSeries Workflow Install & Maintain icon 2. Select FILE from the menu bar. 3. From FILE select OPEN CATALOG. 4. Select DRIVE. 5. From the Drive list box, select the drive which contains the Service Pack. 6. Use the SEARCH button to search for the catalog file FMCZIxxx.ICF of the Service Pack. It is located in the subdirectory 'xxx' of the directory where you have unpack the downloaded executable. Note: 'xxx' is the language used also with the downloaded executable. 7. Press OPEN. 8. Select ACTION from the menu bar. 9. From ACTION, select UPDATE. 10. Select the UPDATE button. 11. Select if YES for Rollback or NO for No-Rollback Reboot the system to activate the changes done by the Service Pack installation. 1.1.4 Upgrading your existing MQSeries Workflow Configuration As updated DB2 bind files are included in this package, you have to bind the new files to your MQSeries Workflow runtime databases. For every configuration on your system please invoke fmczrdb -y -o:b Now all bindings will be made for you. This may take several minutes. 1.2 Installing the Service Pack on Windows NT/2000/95/98 --------------------------------------------------------------------- 1.2.1 Which files must be downloaded? The Service Pack consists of several self-extracting and self-installing executables. One for each National Language version of IBM MQSeries Workflow. To make the distribution of client updates easier, there are three types of self-extracting executables to update Client, Buildtime or full installations, respectively. The Client and Buildtime packages contain only certain MQSeries Workflow components and they are only applicable if these components or a subset of these components are installed. Use the full package to update installations including more than these components. The Client package consists of the API Runtime Library, Program Execution Agent, Runtime Client, Lotus Notes Client, Admininstration Utility, Notes DB Templates, Samples, Java, CORBA Agent component. The Buildtime package includes Buildtime and Samples. Following the list of the self-extracting executables: Full Package: ------------- W322ENU1.EXE - U.S. English language version W322CSA1.EXE - Simplified Chinese language version W322CTA1.EXE - Traditional Chinese language version W322DAA1.EXE - Danish language version W322DEA1.EXE - German language version W322ESA1.EXE - Spanish language version W322FIA1.EXE - Finnish language version W322FRA1.EXE - French language version W322HEA1.EXE - Hebrew language version W322HUA1.EXE - Hungarian language version W322ITA1.EXE - Italian language version W322JPA1.EXE - Japanese language version W322KOA1.EXE - Korean language version W322NLA1.EXE - Dutch language version W322NOA1.EXE - Norwegian language version W322PLA1.EXE - Polish language version W322PBA1.EXE - Brazilian Portuguese language version W322PGA1.EXE - Portuguese language version W322TRA1.EXE - Turkish language version Client Package: --------------- W322CEN1.EXE - U.S. English language version W322CSC1.EXE - Simplified Chinese language version W322CTC1.EXE - Traditional Chinese language version W322DAC1.EXE - Danish language version W322DEC1.EXE - German language version W322ESC1.EXE - Spanish language version W322FIC1.EXE - Finnish language version W322FRC1.EXE - French language version W322HEC1.EXE - Hebrew language version W322HUC1.EXE - Hungarian language version W322ITC1.EXE - Italian language version W322JPC1.EXE - Japanese language version W322KOC1.EXE - Korean language version W322NLC1.EXE - Dutch language version W322NOC1.EXE - Norwegian language version W322PLC1.EXE - Polish language version W322PBC1.EXE - Brazilian Portuguese language version W322PGC1.EXE - Portuguese language version W322TRC1.EXE - Turkish language version Buildtime Package: ----------------- W322BEN1.EXE - U.S. English language version W322CSB1.EXE - Simplified Chinese language version W322CTB1.EXE - Traditional Chinese language version W322DAB1.EXE - Danish language version W322DEB1.EXE - German language version W322ESB1.EXE - Spanish language version W322FIB1.EXE - Finnish language version W322FRB1.EXE - French language version W322HEB1.EXE - Hebrew language version W322HUB1.EXE - Hungarian language version W322ITB1.EXE - Italian language version W322JPB1.EXE - Japanese language version W322KOB1.EXE - Korean language version W322NLB1.EXE - Dutch language version W322NOB1.EXE - Norwegian language version W322PLB1.EXE - Polish language version W322PBB1.EXE - Brazilian Portuguese language version W322PGB1.EXE - Portuguese language version W322TRB1.EXE - Turkish language version 1.2.2 Installing the Service Pack Make sure that you have stopped all running MQSeries Workflow processes before installing the Service Pack. Double click on the downloaded executable in the Windows Explorer. The program unpacks the files to the temporary directory and starts the installation right after unpacking. 1.2.3 Upgrading your existing MQSeries Workflow Configuration As updated DB2 bind files are included in this package, you have to bind the new files to your MQSeries Workflow runtime databases. For every configuration on your system please invoke fmczrdb -y -o:b Now all bindings will be made for you. This may take several minutes. 1.3 Installation on IBM AIX --------------------------- 1.3.1 Which files must be downloaded? Please download the package wf322a1u.tar.gz and unpack the file to a temporary subdirectory. 1.3.2 Installing the Service Pack 1) First, stop all running MQSeries Workflow processes, for example by shutting down the MQSeries Workflow System using the admin utility "fmcautil". 2) As root, perform the command 'slibclean'. 3) Update your MQSeries Workflow 3.2.2.x installation (with or without having hotfixes applied) using smit - "update to latest level" to level 3.2.2.10. Note: Your configuration (profiles, /var/fmc/...) will not be modified by the update. However, the installation profile /usr/lpp/fmc/fmcrc will be updated to reflect the new level "ServiceLevel=1". 4) As updated DB2 bind files are included in this package, you have to bind the new files to your MQSeries Workflow runtime databases. As user "fmc" invoke fmczutil and choose the configuration identifier of the configuration you would like to update. Then choose the 'r'untime database menu and select 'b'ind. Now all bindings will be made for you. This may take several minutes. After these steps your system is ready to run. You may restart your queue manager, the trigger monitor and the administration server as usual by invoking the following programs: strmqm FMCQM & runmqtrm -q FMCTRIGGER -m FMCQM & fmcamain & 1.4 Installation on SUN Solaris ------------------------------- 1.4.1 Which files must be downloaded? Please download the package wf322s1u.tar.gz and unpack the file to a temporary subdirectory. 1.4.2 Installing the Service Pack 1) First, stop all running MQSeries Workflow processes, for example by shutting down the MQSeries Workflow System using the admin utility "fmcautil". Make sure that all MQSeries Workflow processes are stopped and no file of the product is in use. 2) This is how to update your MQSeries Workflow 3.2.2.x files (with or without having hotfixes applied) to level 3.2.2.10: Issue the following command line as user "root", replace the path "/tmp/fmc-3.2.2-update.pkg" from this example with the fully qualified path and filename of your ".pkg" file: pkgadd -d /tmp/fmc-3.2.2-update.pkg accept the installation of this package and overwriting files of the previous package 3.2.2.x. Note: Your configuration(s) (profiles, /var/fmc/...) will NOT be modified by the update. However, the installation profile /opt/fmc/fmcrc will be updated to reflect the new level "ServiceLevel=1". 3) As updated DB2 bind files are included in this package, you have to bind the new files to your MQSeries Workflow runtime databases. As user "fmc" invoke fmczutil and choose the configuration identifier of the configuration you would like to update. Then choose the 'r'untime database menu and select 'b'ind. Now all bindings will be made for you. This may take several minutes. After these steps your system is ready to run. You may restart your queue manager, the trigger monitor and the administration server as usual by invoking the following programs: strmqm FMCQM & runmqtrm -q FMCTRIGGER -m FMCQM & fmcamain & 1.5 Installation on HP-Unix --------------------------- 1.5.1 Which files must be downloaded? Please download the package wf322h1u.tar.gz and unpack the file to a temporary subdirectory. 1.5.2 Installing the Service Pack 1) First, stop all running MQSeries Workflow processes, for example by shutting down the MQSeries Workflow System using the admin utility "fmcautil". Make sure that all MQSeries Workflow processes are stopped and no file of the product is in use. 2) This is how to update your MQSeries Workflow 3.2.2.x files (with or without having hotfixes applied) to level 3.2.2.10: Use "sam" to install the new package. Use the "software" icon, and select "add software to local host". Then choose installation from disc and enter the fully qualified path to the file "FMC322U1.PKG" and the filename itself. Choose "Install" from the "Actions" pulldown menu and confirm twice. After installation you will be ready to go on with step 3. If you do not want to use sam, you can use "swinstall" with the appropriate command line parameters that suit your needs. Note: Your configuration(s) (profiles, /var/fmc/...) will NOT be modified by the update. 3) Run the command fmczinsx -o upd to update the installation profile /opt/fmc/fmcrc with the new level "ServiceLevel=1". This value reflects the current service pack level of the installation. 4) As updated DB2 bind files are included in this package, you have to bind the new files to your MQSeries Workflow runtime databases. As user "fmc" invoke fmczutil and choose the configuration identifier of the configuration you would like to update. Then choose the 'r'untime database menu and select 'b'ind. Now all bindings will be made for you. This may take several minutes. After these steps your system is ready to run. You may restart your queue manager, the trigger monitor and the administration server as usual by invoking the following programs: strmqm FMCQM & runmqtrm -q FMCTRIGGER -m FMCQM & fmcamain & 2. Important Notices =========================================== When using JDK 1.2 with security enabled together with the MQWF Java Agent using RMI, the following authorizations must be added to {java.home}/jre/lib/security/java.policy: grant codeBase "file:/e:/Program Files/MQSeries Workflow/bin/-" { permission java.net.SocketPermission "*:1024-", "accept, connect, listen, resolve"; }; Be sure to use the correct path for your MQWF installation in the codeBase attribute. 3. Changes =========================================== 3.1 Changes for Service Pack #1 ------------------------------ The following problems are fixed: Nr. PMR Desc. 13270 /390: Admin server terminates due to DB2 cancellation 13681 OS/2: Configuration checker does not show MQSeries CSD 4 13726 FMLConnectName not written when using fmczutil -k (client using MQ server API) 13750 Enable Runtime Client to be able to connect to different system groups simultanously 13754 /390: Enable change of LE Runtime Options 13808 /390: Multiple OID encoding support 13816 Errors in HTML code when exporting from Buildtime 13831 Migration utility fails for DBCS databases 13844 Wrong error message when setting filter in Runtime Client 13848 Admin server abends when client uses invalid code page 13865 175851LD Exceptions occur when running multithreaded API programs 13868 Migration fails if one or more container names reach 32 byte 13869 Logon/logoff takes more time when system was idle for more than 5 minutes 13876 Performance problem in case of invalid XML characters 13880 Unicode 2.0 is not properly handled by UnicodeConverter 13886 Cleanup server abends with protection exception after deadlock 13897 Migration utility does not work correctly under HP and Sun 13911 /390: Increased pathlength in PES 13941 Multiple network adapter takeover problem