-------------------------------------------------------------------- Title -------------------------------------------------------------------- IBM MQSeries® Integrator Agent for CICS® Transaction Server Version 1.1.2 -------------------------------------------------------------------- Copyright statement -------------------------------------------------------------------- Program Number 5655-F25 © Copyright International Business Machines Corporation 2003. All rights reserved.US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. -------------------------------------------------------------------- Contents -------------------------------------------------------------------- About this release New in this release Product fix history Backward compatibility Installation, migration, upgrade and configuration information Uninstall information Documentation updates Notices and trademarks -------------------------------------------------------------------- About this release -------------------------------------------------------------------- This CSD release of IBM MQSeries Integrator Agent for CICS, Version 1.1.2, impacts both the Adapter builder component and the Server run time component. The Adapter builder component is delivered via PTF U200205. This release information corresponds to the following product release and modification levels: Version 1, release 1, mod level 2 with the CSD02 of the MQSeries Integrator Agent for CICS Adapter Builder (component ID 5655-F2501) The Server runtime component is delivered via PTF UQ74575. This release information corresponds to the following product release and modification levels: Version 1, release 1, mod level 2 of the MQSeries Integrator Agent for CICS Server Run Time (component ID 5655-F2500) -------------------------------------------------------------------- New in this release -------------------------------------------------------------------- This release contains the following new usability corrections: ==>Screen delete - The Screen delete usability correction will allow users to delete all the resources from a Message Set that were created during a previous Screen Import operation. A Delete button has been added to the 3270 Screen Importer. This button will only be enabled when a screen is recognized. ==>LU assignment processing for non-unique UserIDs - The LU assignment processing for non-unique UserIDs usability correction allows sites that use non-unique UserIDs to enable MQSI Agent for CICS to perform the necessary run time processing. LU assignment for non-unique UserIDs provides the following processing: - LUs within the same FEPI pool be assigned uniquely to a non-unique user UserID and left assigned to that UserID during invocation of potentially multiple FEPI Navigators within the scope of a single executing business request. - That multiple of these business requests may be executing concurrently for the same non-unique UserID. - The provision for LUs to remain assigned,(signed-on and in-session for a specific unique userId) across multiple invocations of subsequent processes that may require usage of that LU. This means the LU could remain assigned to the user UserID on the MQSI Agent for CICS Connection file after the process is complete. ==>Table translation support- The Table translation support usability correction allows build time developers to implement a very specific use of the ESQL SELECT statement to access and READ the translation table for the purpose of performing key and value pair look-ups. ==>In-line DPL - The In-line DPL usability correction allows users to access existing program assets from within a FEPI microflow. This may be of particular use in the case where the user has program source code that is already or can be easily compiled into a linkable CICS program for incorporation in a FEPI microflow. This usability correction supports situations where the user would like to incorporate logic that cannot be modeled using the MQSI Agent for CICS adapter builder. When deployed in the run time environment, the FEPI microflow will execute a direct link to the user program (DPL command) as part of the activity as opposed to defining and starting a new BTS activity (as is the normal process for a DPL command used in a non-FEPI microflow). -------------------------------------------------------------------- Product fix history -------------------------------------------------------------------- Adapter builder fix history: The following fixes and CSDs have been incorporated into version 1.1.2 of the MQSeries Integrator Agent for CICS Adapter Builder : PTF U200194 PTF U200165 APAR IC35603 The CSD will bring your MQSeries Integrator Agent for CICS Adapter Builder version 1.1 installation up to service level U200205. Note:APAR PQ70595 (PTF UQ74575) has been incorporated into the MQSeries Integrator Agent for CICS server run time and is required to use the service level U200205 version of the Adapter builder. ------------------------------------------------------------ Server runtime fix history: The following fixes and CSDs have been incorporated into version 1.1.2 of the MQSeries Integrator Agent for CICS Server runtime : PTF UQ55583 APAR PQ70595 The PTF will bring your MQSeries Integrator Agent for CICS Server runtime version 1.1 installation up to service level UQ74575 Note:APAR IC35603 has been incorporated into the MQSeries Integrator Agent for CICS Adapter Builder (CSD02) and is required to use the service level UQ74575 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.2. of the MQSeries Integrator Agent for CICS 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. -------------------------------------------------------------------- Backward compatibility -------------------------------------------------------------------- Version 1.1.2 of MQSeries Integrator Agent for CICS supercedes all prior versions -------------------------------------------------------------------- Installation, migration, upgrade and configuration information -------------------------------------------------------------------- -------------------------------------------------------------------- Hardware and software requirements -------------------------------------------------------------------- See the chapter on Planning to install the builder in the Using the Control Center documentation for hardware and software requirements for the Adapter Builder. See the chapter titled About MQSeries Integrator Agent for CICS Transaction Server run time for hardware and software requirements for the server runtime. -------------------------------------------------------------------- Installation -------------------------------------------------------------------- Adapter builder: The installation of the adapter builder PTF requires approximately 40MB of disk space. ==>Installing PTF U200205: 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 CSD02 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. Server runtime: ==>Applying PTF UQ74575: To install this version of the MQSeries Integrator Agent for CICS Transaction Server, follow standard SMP/E processing. 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" -------------------------------------------------------------------- Configuration -------------------------------------------------------------------- When applying the PTF to the host: ==> Obtain the build time templates that have been customized on the OS/390 server. ==> Re-deploy your FEPI adapter. ==> If your site will be using new FEPI non-unique userid parameter you must update the FEPI rsc file prior to re-deploying adapter. By re-deploying the adapter, the Properties file will be updated with the new FEPI parm ID. If using the IVP for testing a FEPI adapter, you must: ==> re-customize and rerun the IVP Properties file update job (DFHMAID3) ==> re-compile DFHMAIP1 and DFHMAIP5. The mapset DFHMAS1 must be reassembled and the program DFHMASP1 must be recompiled before attempting to run the Simulator. For more information on the Simulator, see the relevant sections in the "Run Time User's Guide". Changes that may impact your FEPI adapters at run time ----------------------------------------------------------------- Make sure that you obtain the build time templates that have been customized on the OS/390 server. Redeploy your FEPI adapter to include the new FEPI parm ID on the properties file. -------------------------------------------------------------------- Uninstallation information -------------------------------------------------------------------- For information how to uninstall the Adapter Builder component of MQSI Agent for CICS, see the section titled "Remove the builder" in the MQSeries Integrator Agent for CICS - Using the Control Center documentation. The server runtime component of MQSI Agent for CICS is SMP/E compliant. Follow standard SMP/E procedures for removing product libraries. -------------------------------------------------------------------- Documentation updates -------------------------------------------------------------------- See the "Summary of Changes" sections of both the Using the Control Center documentation and the Run Time User's Guide for list of documentation changes applied to the latest release. In addition to any amendments to the MQSeries Integrator Agent for CICS publications, the following updates were applied to the Builder Help system : Support of Inline DPL: --------------------------------------- MQSI Agent for CICS Transaction Server (MIACIN1A.htm) Microflows (CFMAINXA.htm) Command types (COMTCO2A.htm) Command node (ConnectorProcessingNodeType_Command.htm) Specification files (PROPFLXA.htm) Glossary (MQSIGIsA.htm) Support of Screen Delete: --------------------------------------- New topic for Screen Delete: Screen delete (IMPMSGAA.htm) Support of Table Translation --------------------------------------- Advanced data mapping (MAPFCT3A.htm) SQL support (SQLCFNXA.htm) Glossary (MQSIGLSA.htm) Spport of LU owner assignment processing for non-unique IDs -------------------------------------------------------------------- Specification files (PROPFLXA.htm) Creating specification files (PROPFL1A.htm) Using LU assignment processing for non-unique UserIDs (NUNIQUE.htm) Changed MQSeries to WebSphere MQ where appropriate in graphics/text --------------------------------------------------------------------- Trademarks and notices --------------------------------------------------------------------- The following terms are trademarks of the IBM Corporation in the United States or other countries or both: IBM CICS MQSeries SupportPac WebSphere WebSphere MQ Windows is a trademark of Microsoft Corporation. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++