MQSeries Workflow 3.2.2 - Service Pack #3 ----------------------------------------- INDEX ------------------------------------------ 1. Installation of Service Pack #3 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 #3 ------------------------------------------ 1. Installation of Service Pack #3 =========================================== 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: O322ENU3.EXE - U.S. English language version including the common files of MQSeries Workflow O322CHS3.EXE - Simplified Chinese language version O322CHT3.EXE - Traditional Chinese language version O322DAN3.EXE - Danish language version O322DEU3.EXE - German language version O322ESP3.EXE - Spanish language version O322FIN3.EXE - Finnish language version O322FRA3.EXE - French language version O322HEB3.EXE - Hebrew language version O322HUN3.EXE - Hungarian language version O322ITA3.EXE - Italian language version O322JPN3.EXE - Japanese language version O322KOR3.EXE - Korean language version O322NLD3.EXE - Dutch language version O322NOR3.EXE - Norwegian language version O322PLK3.EXE - Polish language version O322PTB3.EXE - Brazilian Portuguese language version O322PTG3.EXE - Portuguese language version O322TRK3.EXE - Turkish language version 1.1.2 Unpack the files Copy the O322ENU3.EXE to a temporary directory and execute it using the command: O322ENU3 /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: O322xxx3 /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 which involves the Runtime Database Utilities component 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: ------------- W322ENA3.EXE - U.S. English language version W322CSA3.EXE - Simplified Chinese language version W322CTA3.EXE - Traditional Chinese language version W322DAA3.EXE - Danish language version W322DEA3.EXE - German language version W322ESA3.EXE - Spanish language version W322FIA3.EXE - Finnish language version W322FRA3.EXE - French language version W322HEA3.EXE - Hebrew language version W322HUA3.EXE - Hungarian language version W322ITA3.EXE - Italian language version W322JPA3.EXE - Japanese language version W322KOA3.EXE - Korean language version W322NLA3.EXE - Dutch language version W322NOA3.EXE - Norwegian language version W322PLA3.EXE - Polish language version W322PBA3.EXE - Brazilian Portuguese language version W322PGA3.EXE - Portuguese language version W322TRA3.EXE - Turkish language version Client Package: --------------- W322ENC3.EXE - U.S. English language version W322CSC3.EXE - Simplified Chinese language version W322CTC3.EXE - Traditional Chinese language version W322DAC3.EXE - Danish language version W322DEC3.EXE - German language version W322ESC3.EXE - Spanish language version W322FIC3.EXE - Finnish language version W322FRC3.EXE - French language version W322HEC3.EXE - Hebrew language version W322HUC3.EXE - Hungarian language version W322ITC3.EXE - Italian language version W322JPC3.EXE - Japanese language version W322KOC3.EXE - Korean language version W322NLC3.EXE - Dutch language version W322NOC3.EXE - Norwegian language version W322PLC3.EXE - Polish language version W322PBC3.EXE - Brazilian Portuguese language version W322PGC3.EXE - Portuguese language version W322TRC3.EXE - Turkish language version Buildtime Package: ----------------- W322ENB3.EXE - U.S. English language version W322CSB3.EXE - Simplified Chinese language version W322CTB3.EXE - Traditional Chinese language version W322DAB3.EXE - Danish language version W322DEB3.EXE - German language version W322ESB3.EXE - Spanish language version W322FIB3.EXE - Finnish language version W322FRB3.EXE - French language version W322HEB3.EXE - Hebrew language version W322HUB3.EXE - Hungarian language version W322ITB3.EXE - Italian language version W322JPB3.EXE - Japanese language version W322KOB3.EXE - Korean language version W322NLB3.EXE - Dutch language version W322NOB3.EXE - Norwegian language version W322PLB3.EXE - Polish language version W322PBB3.EXE - Brazilian Portuguese language version W322PGB3.EXE - Portuguese language version W322TRB3.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 which involves the Runtime Database Utilies component 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 wf322a3u.tar.gz (79MB) and unpack the file to a temporary subdirectory. You need approximately 200MB to unpack the file. 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.30. 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=3". 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 wf322s3u.tar.gz (32MB) and unpack the file to a temporary subdirectory. You need approximately 120MB to unpack the file. 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.30: 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=3". 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 wf322h3u.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.30: 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 "FMC322U3.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=3". 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 #3 ------------------------------ MQSeries Workflow now comes with a feature that makes sure that all server resources (e.g. memory) are freed regularily. The feature is enabled by setting the profile variable RTRecycleThreshold. This defines the maximum number of server transactions that a server instance performs before it frees its resources. The actual threshold is determined by a random threshold based on threshold defined in RTRecycleThreshold. Not setting the profile variable or setting it to 0 (or a negative number) disables this feature. You could enable this feature when you experience: o that memory consumption increases o that server performance decreases when servers are running for a long period e.g. weeks. The feature applies to the execution server, cleanup server and scheduling servers on distributed platforms. To make the changes active, it is necessary to update the IBM MQSeries Workflow profile fmcrc. In a default installatin and configuration, this file can be found in /var/fmc/cfgs/FMC. The keyword is: RTRecycleThreshold If you want to shutdown and restart a fmcemain every 1000 transactions, you need to specify fmczchk -c inst:m,RTRecycleThreshold,1000 Any fmcemain started after having specified this, will quit after 1000 transactions and then start a new one. The following problems are fixed: Nr. PMR/APAR Desc. 14818 fmczchk does not translate configuration ID to uppercase Therefore the configuration might not be found on UNIX 14965 fmczchk: AssertionException in Fmckstr PositionChar 14530 IY15338 Intermediate PEA cores on Unix due to SIGCHLD 14575 Build Time Japanese version: garbled characters on Windows 2000 e.g. in activity names 14846 Missing java run time in Xbootclasspath 14467 Memory Leak using UPES InvokeProgram 14476 PMR 91711 Memory leak using DATA DEFAULT connector 14518 PMR 91711 Memory leak in trace Context setter methods on SUN and HP 14797 Memory leak in XML out message 14401 Return MQSeries action code 'close' to API 14602 PMR 49884.499 Migration problem on AIX 14612 IY16621 Execution server shutdown performance enhanced 14809 PMR 01203 Provide module flow trace information for MQ transaction calls 14928 IY16881 FDL import problem 14349 Staffresolution problem causes an abend of the emain server