MQSeries Workflow 3.1.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 2. Important Notices 3. Changes 3.1 Changes in Hotfix #7 3.2 Changes in Hotfix #6 3.3 Changes in Hotfix #5 3.4 Changes in Hotfix #4 3.5 Changes in Hotfix #3 3.6 Changes in Hotfix #2 3.7 Changes in Hotfix #1 ------------------------------------------ 1. Installation of Service Pack #1 =========================================== 1.1 Installation on IBM OS/2 ------------------------------------------- 1.1.1 Which file must be downloaded? The Service Pack consists of several self-extracting executables. One for each National Language version of IBM MQSeries Workflow. Following the list of the self-extracting executables: O312ENU1.EXE - U.S. English language version including the common files of MQSeries Workflow O312CHS1.EXE - Simplified Chinese language version O312CHT1.EXE - Traditional Chinese language version O312DAN1.EXE - Danish language version O312DEU1.EXE - German language version O312ESP1.EXE - Spanish language version O312FIN1.EXE - Finnish language version O312FRA1.EXE - French language version O312HEB1.EXE - Hebrew language version O312HUN1.EXE - Hungarian language version O312ITA1.EXE - Italian language version O312JPN1.EXE - Japanese language version O312KOR1.EXE - Korean language version O312NLD1.EXE - Dutch language version O312NOR1.EXE - Norwegian language version O312PLK1.EXE - Polish language version O312PTB1.EXE - Brazilian Portuguese language version O312PTG1.EXE - Portuguese language version O312SVE1.EXE - Swedish language version O312TRK1.EXE - Turkish language version 1.1.2 Unpack the file Copy the O312ENU1.EXE to a temporary directory and execute it using the command: O312ENU1 /D \path 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 downloaded file to the temporary directory and execute it by the command: O312xxx1 /D \path 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. 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' 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. Reboot the system to activate the changes. 1.2 Installing the Service Pack on Windows NT and Windows 95 ------------------------------------------------------------ 1.2.1 Which file must be downloaded? The Service Pack consists of several self-extracting executables. One for each National Language version of IBM MQSeries Workflow. Following the list of the self-extracting executables: W312ENU1.EXE - U.S. English language version including the common files of MQSeries Workflow W312CHS1.EXE - Simplified Chinese language version W312CHT1.EXE - Traditional Chinese language version W312DAN1.EXE - Danish language version W312DEU1.EXE - German language version W312ESP1.EXE - Spanish language version W312FIN1.EXE - Finnish W312FRA1.EXE - French language version W312HEB1.EXE - Hebrew language version W312HUN1.EXE - Hungarian language version W312ITA1.EXE - Italian language version W312JPN1.EXE - Japanese language version W312KOR1.EXE - Korean language version W312NLD1.EXE - Dutch language version W312NOR1.EXE - Norwegian language version W312PLK1.EXE - Polish language version W312PTB1.EXE - Brazilian Portuguese language version W312PTG1.EXE - Portuguese language version W312SVE1.EXE - Swedish language version W312TRK1.EXE - Turkish language version 1.2.2 Unpack the file Copy the W312ENU1.EXE to a temporary directory and execute it using the command: W312ENU1 /D \path 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 downloaded file to the temporary directory and execute it by the command: W312xxx1 /D \path where 'xxx' is the language abbreviation. 1.2.3 Update your existing MQSeries Workflow installation To install this Service Pack, switch to the subdirectory xxx which is located in the directory where you have unpacked the downloaded file. To start the installation of the Service Pack, run SETUP.EXE located in the language subdirectory. For example, the SETUP.EXE for U.S. English is located in the ENU subdirectory after you unpack the files. 1.3 Installation on IBM AIX ---------------------------- This text file accompanies ServicePack 1 (Drv312csd1.tar.gz). Instructions to uncompress this package --------------------------------------- Drv312.csd1.tar.gz is a tar-ed, gzip-ed package. To uncompress the package you need to have the gzip utility available. Note: If gzip is not available on your AIX machine: You could transfer the file in binary mode to your PC if you happen to have gzip available there, uncompress it there and transfer it back (again in binary mode). Then un-tar with tar -vxf Drv312csd1.tar gzip for AIX is available on AIXPDSLIB: See http://aixpdslib.seas.ucla.edu/filetools/filetools.html or http://aixpdslib.seas.ucla.edu/filetools/gzip.html (AIX 3) http://aixpdslib.seas.ucla.edu/filetools/gzip4.html (AIX 4) See also http://www-frec.bull.fr/OSBU2_0/download.htm or http://www.bull.de/pub/ If you have gzip for AIX available, then the command to unpack this distribution is gzip -dc Drv312csd1.tar.gz | tar -vxf - To uncompress the file, move into a file system with sufficient space for 270 MBytes. If you want to check the package contents prior to actually extracting any files the command is gzip -dc Drv312csd1.tar.gz | tar -vtf - 1) First stop all running MQSeries Workflow processes and run fmcclean after MQSeries Workflow is stopped. 2) As root, perform the command 'slibclean'. 3) Update your MQSeries Workflow 3.1.2.0 installation: logon as root run smitty (or smit) select the options to get you to Update Installed Software to Latest Level...... Note: Your configuration (profile "fmcrc", /home/fmc/..., /var/fmc/...) will not be modified by the update. 4) Note for users which have a special installation setup ("security fix") applied: The access modification changes have to be re-applied now! 5) As updated DB2 bind files are included in this package, the following step has to be performed now: fmczdcdb -o:b Use the userid 'fmc' or any other userid with DB owner rights. Optionally you can perform the following step: 6. Replace the existing MQSeries queue definitions by running the following commands: a. fmczqdef -o:d This rebuilds the customized queue definition files: fmczques.mqs and fmczcltc.mqs b. runmqsc csd1q.log This creates the new queue definition for the trigger monitor using the updated file fmccques.mqs c. runmqsc csd1c.log Create the channel definitions using the hotfix file fmcccltc.mqs file d. Start the trigger monitor using the command: runmqtrm -m FMCQM -q FMCTRIGGER and then start again the MQWorkflow servers. 2. Important Notices =========================================== o If the fmcemain fails to start, then we recommend to shutdown MQSeries Workflow. Then you need to run the following commands as user fmc: - endmqm -i , e.g. endmqm -i FMCQM - dltmqm , e.g. dltmqm FMCQM - fmczqdef -o:i From now on you can start your MQSeries Workflow system as user fmc: strmqm , e.g. strmqm FMCQM runmqtrm -m FMCQM -q FMCTRIGGER &, assuming FMC is the qualifier being used fmcamain & o Hotfix #4 is required for MQSeries Workflow/390 o Starting with hotfix #3 the following MQSeries Workflow definitions have been changed: a.) Alias queue definition for the trigger monitor input queue does no longer refer to the SYSTEM.DEFAULT.INITIATION.QUEUE, but to the FMCTRIGGER queue which has been introduced. If this new resource definition has been applied, the MQSeries trigger monitor has to be started for MQSeries Workflow to use this dedicated trigger monitor input queue. (e.g. runmqtrm -m FMCQM -q FMCTRIGGER). The new MQ resource definition will become active as soon as you perform one of the following steps: a.) Create a new queue manager using FMCZQDEF utility with option -o:i b.) Whenever you run FMCZQDEF with -o:d option and running RUNMQSC manually to replace the resources c.) Whenever you run FMCZQDEF with -o:d option and later on with the -o:x option 3. Changes =========================================== This Service Pack contains the fixes of hotfix package #1, #2, #3, #4, #5, #6 and #7. Hotfix package #7 is not available as a separate download. It is only available from this Service Pack. The following APAR is fixed with this package: IX87658, IX88220, IY00484 3.1 Changes for Hotfix #7 ------------------------------ 1. ActiveX: Endless loop when terminating process instances When the user terminated a process instance, the user interface hangs due to an endless loop. This is fixed now. Platform: WinNT, Win95 2. Buildtime: Cleanup_time is set to 0 when System settings are saved to DB When making any changes in System and System Group but leaves the Cleanup Server settings unchanged (everything is inherited) for CLEANUP_TIME and CLEANUP_DELAY_TIME a 0 is written into the database and for DIST_RECEIVE_TIME the value ANYTIME is written into the database. These three values should all be NULL when inherited is checked for Cleanup Server settings. Although there are values in the database the GUI still shows the inherited flag! Platform: WinNT, Win95 3. ActiveX: Filters cannot be set If you create a new worklist and set the following filter: OWNER = QXGC3GC and STATE NOT IN Disabled and click OK to create the worklist, the worklist gets created correctly. If you then want to change the filter, you select Settings... from the worklist context menu. This displays the Worklist properties dialog, where you click on the Filter tab. After doing so, you click on the Add button to add another criteria and select NAME = MY ACTIVITY. You click on OK and then when you click OK on the Worklist properties dialog, the following message appears: fmcn6lpd (in the title bar), Invalid filter string, expected 'FE 0; FE 1; FE 2' and found 'STATE'. The only option is to click OK and when you do that, you lose all filter criteria. Platform: WinNT, Win95 4. ActiveX: Cannot set substitute in GUI It was not possible to set the substitute in the RTC GUI. Now the read-only field was changed to an entryfield and the user can update (or remove) his substitute. Platform: WinNT, Win95 5. ActiveX: Terminate workitem not implemented You have to terminate a running workitem to be able to transfer it. The transfer of a workitem is now implemented. Platform: WinNT, Win95 6. V3 to V3.1 Migration: Wrong isolation level used during setup of runtime database. The database configuration tool FMCZDCDB didn't bind four of the packages with isolation level UR (Uncommitted Read). This resulted in a performance degradation. Platform: independent of platform 7. Staff Resolution: Apply staff resolution fixes of 3.2.0 to 3.1.2 Platform: independent of platform 8. Buildtime: Buildtime fatal error after Hotfix #6 Trying to open the diagram for an existing process a message box (title IBM MQSeries Workflow Version 3.1. Buildtime) came up with "FMC259699E: "Unknown error occured, more information:" After clicking OK second message box (title IBM MQSeries Workflow Version 3.1. Buildtime) having the message: "FMC259685E: For the object '