This file library contains a downloadable PTF (Program Temporary Fixes) for IBM MERVA Automatic Message Import/Export Facility - Version 4.2.0 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * IBM MERVA Automatic Message Import/Export Facility - Version 4.2.0 * * PTF UQ80222 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * This directory contains : * * UQ80222.TXT - A copy of this file * * UQ80222.EXE - PTF UQ80222 installation program (download this file * * in binary format and call the UQ80222.exe to start * * the PTF Installation. Ensure that you have about 20 MB * * free space for this action.) * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * IMPORTANT * * * * PLEASE READ THE FOLLOWING DISCLAIMER. DOWNLOADING A PTF INDICATES * * YOUR ACCEPTANCE OF THE FOLLOWING DISCLAIMER: * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * IBM MERVA Automatic Message Import/Export Facility - Version 4.2.0 * * - DISCLAIMER * * * * PLEASE READ THE FOLLOWING CAREFULLY AND ENSURE THAT YOU UNDERSTAND * * THE TERMS AND CONDITIONS BEFORE DOWNLOADING OR USING ANY FILE HELD * * ON THIS LIBRARY. IF YOU DO NOT AGREE WITH OR UNDERSTAND THE * * DISCLAIMER THEN PLEASE DO NOT DOWNLOAD ANY FILE FROM THIS LIBRARY. * * * * You are solely responsible for determining the appropriateness of * * downloading any file from this library and assume all risks associated * * with the use of this downloaded file, including but not limited to the * * interruption of operations resulting from incomplete or faulty download. * * * * IBM accepts no liability for damages you may suffer as a result of your * * download and/or use of the downloaded file. * * * * Except as required by law, IBM will NOT be liable for any indirect, * * special or consequential damages, even if IBM has been advised of * * the possibility of their occurrence. * * * * Some jurisdictions do not allow the exclusion or limitation of * * incidental or consequential damages, so the above exclusion or * * limitation may not apply to you. * * * * Your use of the downloaded file(s) will be governed by the provisions * * of the applicable IBM license for IBM MERVA Automatic Message Import/ * * Export Facility - Version 4.2.0. * * * * IBM warranty is as specified in the applicable IBM license. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * If you choose not to download the files, you can always obtain the IBM MERVA Automatic Message Import/Export Facility - Version 4.2.0 PTF on CD ROM through your local IBM software support group. NOTE: It is very important that you read CAREFULLY the README.TXT file before you start with the PTF installation. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * Readme of PTF UQ80222: ====================== __________________________________________________________ Licensed materials - Property of IBM MERVA ESA Components (5648-B30) Version 4, Release 2 (C) Copyright IBM Corp. 1999, 2002 All rights reserved US government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp __________________________________________________________ IBM MERVA Automatic Message Import/Export Facility PTF UQ80222 September 2003 __________________________________________________________ Read this first! __________________________________________________________ Contents 1. INTRODUCTION 2. SYSTEM REQUIREMENTS 2.1. Using local MERVA API 2.2. Using MERVA Connection/2000 2.3. Using MQSeries 3. Fixed APAR's 3.1. Fixed APAR's in the PTF UQ80222 4. Installation 4.1. First Installation 4.2. Installing on top of a previous MIE installation 4.3. PTF Distribution Media 5. MERVA Manuals 1. INTRODUCTION This is a new release for the product number 5648B3006, MERVA Automatic Message Import/Export Facility (MIE). MIE is a software product for message transfer using files between the MERVA system and other message-processing systems. Note: On-line documentation is shipped with the product. Click on the appropriate icon. 2. SYSTEM REQUIREMENTS MIE requires - Windows 2000 with service pack 2 or a subsequent release or - Windows XP with service pack 1 or a subsequent release or - Windows 2003 server with at least 256 MB RAM and 20 MB free disk space. MIE requires "License Use Runtime" and a license key. An installable version of "License Use Runtime" is shipped with MERVA ESA Components V4.20 The license key is shipped on a separate diskette and must be enrolled using the "Basic License Tool" of "License Use Runtime". 2.1. Using local MERVA API You need a running MERVA USE & Branch V4.20 to use MIE for local message import/export. 2.2. Using MERVA Connection/2000 If MERVA Connection/2000 is used to communicate with the remote MERVA system, MERVA Connection/2000 V4.20 is required. Note: MERVA Connection/2000 is part of MERVA ESA Components V4.20 and must be installed separately. 2.3. Using MQSeries If MQSeries is used to communicate with the remote MERVA system, then MQSeries (Server) for Windows V5.2 or a subsequent release is required. The server on which MERVA is running must be MERVA ESA V4.1 or a subsequent release. Note: Since MIE's unit of work are message files, a transaction is not committed until the unit of work has reached a defined state. Therefore, the size of the MQSeries log area should be set according to the maximum number of messages that a file can contain. The MIE configuration parameters for setting the above are CMEMIE_EX_MMIF and CMEMIE_EX_TOUT. The MQSeries parameter MAXUMSGS (maximum number of uncommitted messages within a syncpoint) must also be set correspondingly. 3. Fixed APAR's 3.1. Fixed APAR's in the PTF UQ80222 3.1.1. APAR PQ78247 AUTOMATIC MESSAGE IMPORT/EXPORT FACILITY (MIE) R420 DEVELOPMENT APAR - Support of Windows XP and Windows 2003 server. - Improved error messages when messages cannot be imported due to incorrect message format or invalid file format. - A transaction was not committed in time and caused MQSeries RC 2003. This happened when messages were imported in very large time intervals. - No conversion took place when getting messages from the receive queue. Now the code conversion is done by MQSeries when getting the message from the queue and, therefore, no channel exit is required. 4. Installation To install this PTF no previous MIE V4.20 installation is required. In case you have MIE V4.20 already installed on Windows 2000, we recommend to save your *.prf files, deinstall MIE V4.20, and install this PTF as described in step 4.1. Nevertheless this PTF can also be installed on top of a previous MIE V4.2 installation as described in step 4.2. 4.1. First (new) Installation If you install MIE V4.2 for the first time (a new installation) you can either double-click setup.exe from the Explorer or run setup.exe from a Windows Command Prompt. Note: If you downloaded the PTF from the Internet, run the UQ80222.EXE. 4.2. Installing on top of a previous MIE installation If MIE 4.2 is already installed on your Windows 2000 system, you can use the following method, to install this MIE V4.2 PTF UQ80222: Run the command setup.exe /V" REINSTALLMODE=voums REINSTALL=ALL" from a Windows Command Prompt. Note: If you downloaded the PTF from the Internet, run UQ80222.EXE instead of setup.exe with the same parameters. 4.3. PTF Distribution Media This PTF will be distributed via CD-ROM. It can also be downloaded from our FTP server, which is accessible from the MERVA homepage: http://www.ibm.com/software/merva/ Select the 'Support' page, then "MERVA Automatic Message Import/Export Facility Version 4.2 - PTF List". It is recommended that you download PTFs in binary format. 5. MERVA Manuals The MERVA manuals are also available online, as PDF files, at the Internet address: http://www.ibm.com/software/merva To get a list of the available MERVA manuals, select the 'Support' page, then "Manuals for MERVA". It is recommended that you download manuals in binary format.