MQSeries Workflow 3.1.2 - Service Pack #2 ----------------------------------------- INDEX ------------------------------------------ 1. Installation of Service Pack #2 1.1 Installation on IBM OS/2 1.1 Installation on Microsoft Windows 1.2 Installation on IBM AIX 2. Important Notices 3. Changes 3.1 Changes in Hotfix #8 3.2 Changes in Hotfix #7 3.3 Changes in Hotfix #6 3.4 Changes in Hotfix #5 3.5 Changes in Hotfix #4 3.6 Changes in Hotfix #3 3.7 Changes in Hotfix #2 3.8 Changes in Hotfix #1 ------------------------------------------ 1. Installation of Service Pack #2 =========================================== 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: O312ENU2.EXE - U.S. English language version including the common files of MQSeries Workflow O312CHS2.EXE - Simplified Chinese language version O312CHT2.EXE - Traditional Chinese language version O312DAN2.EXE - Danish language version O312DEU2.EXE - German language version O312ESP2.EXE - Spanish language version O312FIN2.EXE - Finnish language version O312FRA2.EXE - French language version O312HEB2.EXE - Hebrew language version O312HUN2.EXE - Hungarian language version O312ITA2.EXE - Italian language version O312JPN2.EXE - Japanese language version O312KOR2.EXE - Korean language version O312NLD2.EXE - Dutch language version O312NOR2.EXE - Norwegian language version O312PLK2.EXE - Polish language version O312PTB2.EXE - Brazilian Portuguese language version O312PTG2.EXE - Portuguese language version O312SVE2.EXE - Swedish language version O312TRK2.EXE - Turkish language version 1.1.2 Unpack the file Copy the O312ENU2.EXE to a temporary directory and execute it using the command: O312ENU2 /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 downloaded file to the temporary directory and execute it by the command: O312xxx2 /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. 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: W312ENU2.EXE - U.S. English language version including the common files of MQSeries Workflow W312CHS2.EXE - Simplified Chinese language version W312CHT2.EXE - Traditional Chinese language version W312DAN2.EXE - Danish language version W312DEU2.EXE - German language version W312ESP2.EXE - Spanish language version W312FIN2.EXE - Finnish W312FRA2.EXE - French language version W312HEB2.EXE - Hebrew language version W312HUN2.EXE - Hungarian language version W312ITA2.EXE - Italian language version W312JPN2.EXE - Japanese language version W312KOR2.EXE - Korean language version W312NLD2.EXE - Dutch language version W312NOR2.EXE - Norwegian language version W312PLK2.EXE - Polish language version W312PTB2.EXE - Brazilian Portuguese language version W312PTG2.EXE - Portuguese language version W312SVE2.EXE - Swedish language version W312TRK2.EXE - Turkish language version 1.2.2 Unpack the file Copy the W312ENU2.EXE to a temporary directory and execute it using the command: W312ENU2 /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 downloaded file to the temporary directory and execute it by the command: W312xxx2 /D . 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. 1.2 Installation on IBM AIX ------------------------------ 1) First stop all running MQSeries Workflow processes 2) As root, perform the command 'slibclean'. 3) Update your MQSeries Workflow 3.1.2.0 installation (with or without having hotfixes applied) using smit - "update to latest level" to level 3.1.2.200. 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 csd2q.log This creates the new queue definition for the trigger monitor using the updated file fmccques.mqs c. runmqsc csd2c.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, #7 and Hotfix #8. Hotfix package #7 and #8 are not available as a separat download. They are only available from this Service Pack. The following APARs are fixed with this package: IX87658, IX88220, IY00484 3.1 Changes for Hotfix #8 ------------------------------ 1. PEA: consumes too much CPU on AIX ( PMR 20130 ) PEA consumes too much CPU on AIX. The symptom is that 10 PEAs on midrange AIX system cause the system to virtually hang. The problem was reported by Takahashi-san from IBMJP, as well as by Tower in Australia. Platform: AIX 2. Execution Server: trap in condition evaluation ( PMR15558 ) Execution server trap in condition evaluation There is a bug in condition evalution which causes an internal exception in the Runtime Server. The problem is that condition evaluation did not recover correctly when accessing the container of a dead-path eliminated activity resulted a 'container not found' code. Platform: independent of platform 3. Filter: TS should be local time ( PMR 02094 ) Timestamps in filter strings should be interpreted as local time and converted to UTC for the use on server side. Platform: independent of platform 4. Database: Deadlock /w SQL Code -924 ( PMR 46044 ) Platform: independent of platform 5. Execution Server: Filter Assertion in Execution Server ( PMR 23465 ) *** Assertion failed in FMC.PT310SHP.INL#(FMCDSDF)(25543): *_parametersAsSql.PreDB2LOBWrite() == *rhs._parametersAsSql.P reDB2LOBWrite() Aborting ... CEE3204S The system detected a protection exception. From entry point fmckAssert(const char*,const char*,unsigned int) at compile unit offset +000002DC at address 1F15E834. Platform: independent of platform 6. Import/Export: Format of exported FDL (record length) The export facility shoud not produce lines longer than 254 characters. E.g. the user ids related to a role should not exported in a single row. The standard visible area on /390 is up to 72 characters. Platform: independent of platform 3.2 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 ist. 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 '