####################################################################### # # COMPONENT_NAME: IBM MQSeries Integrator Agent for CICS Transaction # Server Version 1.1.1 # # FILE: memo.ptf # # Program Number 5655-F25 # (C) COPYRIGHT International Business Machines Corp. 2001 # All Rights Reserved # Licensed Material - Property of IBM # # US Government Users Restricted Rights - Use, duplication or # disclosure restricted by GSA ADP Schedule Contract with IBM Corp. # ###################################################################### PTF Memo for IBM MQSeries Integrator Agent for CICS Transaction Server Version 1.1.1 ---------------------------------------------------------------------- This memo.ptf file corresponds to the following product release and mod levels: Version 1, release 1, mod level 1 with the first CSD of the MQSeries Integrator Agent for CICS Adapter Builder (component ID 5655-F2501), which is defined as PTF U200165 and is numbered 01. Version 1, release 1, mod level 1 of the MQSeries Integrator Agent for CICS Server Run Time (component ID 5655-F2500), which is defined as PTF UQ55583. The CSD will bring your MQSeries Integrator Agent for CICS Adapter Builder version 1.1 installation up to service level U200165. The PTF will bring your MQSeries Integrator Agent for CICS Server Run Time version 1.1 installation up to service level UQ55583. This CSD contains additional corrections or features as documented in the "Adapter Builder CSD History" and "Server Run Time PTF History" sections. This file will be updated whenever a cumulative service PTF is made available. It will be updated to contain information that you will need for updating IBM MQSeries Integrator Agent for CICS Adapter Builder and Server Run Time Version 1.1.1, as well as a summary of the contents of the latest CSD/PTFs and any earlier CSDs/PTFs. APAR information ---------------------------------------------------------------------- The following APARs are included in version 1.1.1 of the MQSeries Integrator Agent for CICS Transaction Server: Builder Component APAR: APAR IC30820 Run Time Component APAR: APAR PQ50194 ---------------------------------------------------------------------- This file is divided into two sections. One section is for the Adapter Builder and the other section is for the Server Run Time. Each section is organized as follows: o ADAPTER BUILDER COMPONENT - Installation and maintenance - Documentation Changes - Special information - Service and technical support - CSD history o SERVER RUN TIME COMPONENT - Installation and maintenance - Documentation changes - Special information - Service and technical support - PTF history THE ADAPTER BUILDER COMPONENT Adapter Builder Installation and Maintenance Information ---------------------------------------------------------------------- Maintenance updates can be supplied on CD-ROM, or they can be downloaded from the World Wide Web. The installation of this PTF requires approximately 40MB of disk space to do the PTF installation. Installing CSD01 ---------------------------------------------------------------------- If you need to apply maintenance updates to your Adapter Builder component perform the following steps: 1. Shut down the IBM MQSeries Integrator Agent for CICS Adapter Builder Control Center. 2. Ensure you are logged on as an Administrator 3. Run setup.exe 4. You will be presented with the "Welcome" dialog. Select the "Next>" button. 5. You will be informed that the install will update Windows Installer files and remove any prior releases of MQSeries Integrator Agent for CICS. You can either Continue or Cancel the install at this point. If you continue, proceed to step 6. 6. Type in or choose the directory where you have installed the base product and then select the "Next>" button. 7. From the "Ready to Install" dialog, verify that the installed components are correct and then select the "Next>" button to Proceed. 8. Any prior releases are removed before the CSD release is installed. No data will be lost. 9. Verify the installation was successful on the "Installation Summary" dialog. 10. Select the "Finish" button to complete the installation of the CSD. Adapter Builder Documentation Changes ---------------------------------------------------------------------- In addition to any amendments to the MQSeries Integrator Agent for CICS publications listed in the read.me file on the product CD-ROM, the following updates to the Builder Help system were also made: Mapping and SQL support Added descriptions and notes about advanced mapping and SQL support restrictions to 'Advanced data mapping' (MAPFCT3A.htm) and 'Mapping properties' (MAPFCT5A.htm) Added section 'Mapping data fields with valid values' in 'Advanced data mapping' topic (MAPFCT3A.htm) Changed Connector Flow to Microflow in graphics/text Defect #2718 - Added new section 'Adding SQL code for a decision test condition' to Decision types (DECTCO1A.htm) ESQL - COBOL Support Updated the following files: SQL support (SQLCFNXA.htm) SQL data types (SQLCFNX1A.htm) Basic SQL expressions (SQLCFNX2A.htm) SQL functions (SQLCFNX3A.htm) Specifying MQ Command Types: Added section 'Specifying the message type' section to 'Creating specification files' topic (PROPFL1A.htm) Enhanced Error Messages Added new topic 'Exception and Trace Messages' (ErrMsg1A) System-supplied CISC_SAMPLES messages Added new topic 'CICS_SAMPLES Message Set' (CICSSAMA.htm) Added new topic 'Using the Sample Transaction' (CICSTRNA.htm) Added new topic 'Using the Sample Parser' (CICSPARA.htm) New IMPORTED_SCREENS Transaction Category Added description to 'Import 3270 Screens to a Message Set' (IMPMSG6A.htm) ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Special Information on the Adapter Builder CSD ------------------------------------------------------------------ APAR PQ50194 has been incorporated into the MQSeries Integrator Agent for CICS server run time and is required to use the CSD version of the Adapter builder. Contact the IBM Support Center to obtain the current "PSP Bucket". PSP Buckets are identified by UPGRADEs, which specify product levels, and SUBSETs, which specify the FMIDs for a product level. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Adapter Builder Service and Technical Support ----------------------------------------------------------- A) Service Level Information ------------------------- IBM MQSeries Integrator Agent for CICS Adapter Builder, version 1.1.1, is the first PTF (CSD01) for the initial release of the Adapter Builder component. Product 5655-F25. B) Service Support Available from the Internet ------------------------------------------- You can find additional information on the MQSeries Web site, located at: http://www.ibm.com/software/ts/mqseries/ For current information on known problems and available fixes please see the Support option on the MQSeries Web site at: http://www.ibm.com/software/ts/mqseries/support From the MQSeries support page, you can obtain the latest information about the following topics: IBM Transaction Processing SupportPacs Closed APARs Fix Packages Frequently Asked Questions Tips and Techniques Device Drivers Forums Related Links +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Adapter Builder CSD History -------------------------------------------------------------------- A) CSD01 (PTF U200165) -------------------------------------------------------------------- This is the first CSD for IBM MQSeries Integrator Agent for CICS Adapter Builder Version 1.1.1 from IBM. It is delivered via PTF U200165. It contains fixes for all the problems listed below: 2511 The 3270 Importer Panel, and therefore the contained 3270 Emulator Window, cannot be re-sized 2529 Incorrect explanation of Length Counts for Integers in the online Help Information Center. 2648 A BIP0004E error occurs when performing Add to Workspace... Simple Type, for a Message Set. 2659 Error message BIP0013E contains unnecessary instructions to "...contact your IBM Support Center." 2664 The HELP button on the field Find option under the Data Mapping Expression tab of Map nodes does not present help information. 2669 Basic mathematics expressions in ESQL are not supported by COBOL generation. 2679 In a Map Node, assigning a decimal value (i.e. - 123.45) to a target field causes a generation error of BIP0067E, because the decimal point is being converted to an underscore. 2686 Help button on Reorder Elements Screen points to incorrect page in online Help Information Center. 2718 Explanation in online Help Information Center regarding Decision Types is not descriptive enough. 2727 Start (Programs) Menu contains an incomplete name for the IBM MQSeries Integrator Agent for CICS product. 2729 Generated COBOL program contains statements that extend beyond column 72 when two sub-flow nodes are directly connected without a map node between them. 2730 3270 Importer attempts to update a component that has not been "Checked Out". 2731 New Element Qualifiers are generated upon leaving the 3270 Element Qualifier Selection Panel even when none of the presented information has been modified. 2732 The 3270 Importer Panel displays an incorrect state for the Connect/Disconnect button after an Exception Message is displayed. 2734 Using a "Path" on the Adapter Generation Destination Panel that was previously used but does not currently exist (this can happen if a workspace was imported from another machine or a previously existing "Path" has been deleted) causes the generation to fail and no exception message is displayed. 2736 In a Map Node, Valid Values can only be assigned to target Elements that have valid values defined for that Element. 2738 In a Map Node, the list of Valid Values that can be assigned to a target Element should be "filterable". It should include either all the Valid Values (as it does now) or only the Valid Values defined for that Element in particular. 2745 The Valid Value of a source field in a Map node Data Mapping Operation is lost in the generated COBOL code if the Data Mapping Operation is reentered and the source field in question is not updated. 2754 New splash screen for MQSeries Integrator Agent for CICS CSD. 2756 MQSeries Integrator Agent for CICS Adapter Builder should have an error message numbering scheme similar to the MQSeries Integrator Agent for CICS Server Run Time. 2763 When importing a COBOL structure that contains fields with a Value clause (i.e. - 05 FLDNAME PIC X VALUE 'A'.), the Element Valid Values created for each field are indistinguishable by name 2766 The Parameter Update Job is created for Adapters even if they cannot be run. The Job should not be created for FEPI Adapters that are used within other Adapters and therefore cannot run on their own. 2767 In a Map Node, if the only assignment operation is to an MQSeries Integrator Agent for CICS "system supplied" Element, an error message is displayed during Adapter generation. 2768 An un-handled exception occurs, causing the system clock to never return to a pointer, in 3270 Element Qualifier selection when the offset and length values include the quotation marks (which are supposed to be for display purposes only). 2773 Request Messages created via a 3270 Screen Import contains an incorrect reference to the SCREEN_CONTROLS Compound Type in the CICS_SAMPLES Message Set and not to the SCREEN_CONTROLS Compound Type in current Message Set itself. -------------------------------------------------------------------- SERVER RUN TIME COMPONENT Server Run Time Installation and Maintenance Information -------------------------------------------------------------------- Contact the IBM Support Center to obtain the current "PSP Bucket". PSP Buckets are identified by UPGRADEs, which specify product levels, and SUBSETs, which specify the FMIDs for a product level. Installing the Server Run Time ----------------------------------------------------- MQSeries Integrator Agent for CICS is delivered with build time templates. These templates are delivered with both the builder and the run time components. These build templates are default versions of program code and JCL that require some customization to operate in your development environment. Typically, these templates will be customized on the OS/390 server and the customized versions will be moved to every client machine intending to generate and deploy CICS MQ adapters. For more information on the build time templates, see the relevant sections in the "Using the Control Center" book and "Run Time User's Guide". To install this version of the MQSeries Integrator Agent for CICS Transaction Server, follow standard SMP/E processing. Redefine the SLU Connection File 'DFHMACOF' and its alternate index 'DFHMAC1F' to reflect the new size of the record. The record size is now 428 bytes in length and must be redefined and any existing MQSeries Integrator Agent for CICS FEPI Navigators must be recompiled before attempting to run them. The new ACIAMAC copylib must be used in the compile JCL and templates to bring in the new SLU Connection file copybooks. Recompile program DFHMASP1 before attempting to run the Simulator. For more information on the Simulator, see the relevant sections in the "Run Time User's Guide". Server Run Time Documentation Changes ------------------------------------------------------ See the Summary of Changes section of the MQSeries Integrator Agent for CICS Run Time User's Guide Version 1.1.1 for a description of documentation changes. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Special Information on the Server Run Time ----------------------------------------------------- APAR IC30820 has been incorporated into the MQSeries Integrator Agent for CICS Adapter Builder (CSD01) and is required to use the PTF version of the MQSeries Integrator Agent for CICS Server Run Time component. Contact your IBM representative for information on how to obtain version 1.1.1. of the MQSeries Integrator Agent for CICS Adapter Builder ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Server Run Time Service and Technical Support --------------------------------------------------------------------- A) Service Level Information ---------------------------------------------------------------------- APAR PQ50194 has been incorporated into the server runtime component. Contact the IBM Support Center to obtain the current "PSP Bucket". PSP Buckets are identified by UPGRADEs, which specify product levels, and SUBSETs, which specify the FMIDs for a product level. B) Service Support Available from the Internet ---------------------------------------------------------------------- You can find additional information on the MQSeries Web site, located at: http://www.ibm.com/software/ts/mqseries/ For current information on known problems and available fixes please see the Support option on the MQSeries Web site at: http://www.ibm.com/software/ts/mqseries/support From the MQSeries support page, you can obtain the latest information about the following topics: IBM Transaction Processing SupportPacs Closed APARs Fix Packages Frequently Asked Questions Tips and Techniques Device Drivers Forums Related Links For current information on known problems and available fixes for CICS, please see the Support option on the CICS Web site at: http://www-4.ibm.com/software/ts/cics/support/ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Server Run Time PTF History ---------------------------------------------------------------------- A) PTF UQ55583 ---------------------------------------------------------------------- This is the first PTF for IBM MQSeries Integrator Agent for CICS Server Run Time Version 1.1.1 from IBM. It is delivered via PTF UQ55583. It contains fixes for all the problems listed below: 2728 DFHMAID1 definition for DFHMAIP2. Value EXECKEY(CICS) should be EXECKEY(USER). 2747 An invalid Process Name is being generated in DFHMADPL. When the Front-end controlling application does not pass the Process Name in the request message to the MQSeries Integrator Agent for CICS Server Run Time, the DFHMADPL program should generate a Process Name concatenating the userid, EIBTASKN and ABSTIME fields. If the userid field is less than 8 bytes long, the DFHMADPL program does not trim the spaces therefore causing a Process Name with embedded spaces. This causes the BTS DEFINE process to fail in DFHMADPL. 2748 Invalid page break in DFHMAMUP when output goes to > 1 page 2752 Alter the dimensions of the SLU Connection file (DFHMACOF) to enhance the overall performance of the MQSeries Integrator Agent for CICS FEPI Navigators. The file DFHMACOF and its alternate index (DFHMAC1F) were modified to insure only 1 record per Control Interval size of 512. The record size is now 428 bytes in length. This file and alternate index must be redefined and any existing MQSeries Integrator Agent for CICS FEPI Navigators must be recompiled before attempting to run them. In addition to the fixes described above, the Server Run Time component has been enhanced to allow for asynchronous MQSeries Put processing to a defined queue in a generated MQSeries Integrator Agent for CICS command within the microflow, without requiring a response from the MQSeries-enabled application. In the version 1.1.0, the Navigator initiated an MQSeries Get command after an MQSeries Put, waiting on a defined reply queue for a response to the MQSeries Put command. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ TRADEMARKS --------------------------------------------------------------------- The following terms are trademarks of the IBM Corporation in the United States or other countries or both: IBM CICS MQSeries SupportPac Windows is a trademark of Microsoft Corporation. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++