IBM MQSeries Integrator Agent for CICS, efix version 1
Last Updated: September 23, 2002
An efix is an emergency fix provided by IBM to customers with a problem for which they cannot wait until an official PTF is available.
Efixes are built by developers on their own systems, and have gone through some basic testing by the developer. Since efixes do not go through the test suites that full releases do, there is always a risk for regressions and introduction of new problems. The customer should be aware of this fact, and take it into consideration when choosing to install any efix.
This readme file corresponds to the PTF U200194.
If this README file is updated, the updated file will be available via the Support mechanism for MQSI Agent for CICS.
This efix provides critical usability fixes to the MQSeries Integrator Agent for CICS Adapter Builder.
This efix does not impact the run time component of MQSeries Integrator Agent for CICS Transaction Server (APAR PQ50194, PTF UQ55583).
All users of the MQSeries Integrator Agent for CICS Transaction Server Adapter Builder version 1.1.1, (defined as PTF U200165 and numbered 01), should upgrade to this new efix level.
The usability corrections contained in the efix are described below.
The ESQL and the COBOL generation function have been fixed so that they correctly support subscripted access of fields in an array during mapping operations and conditional expressions.
When you click Browse on the Source Information Panel of the Cobol Language Message Importer dialog, the directory list is set to the directory of the most recent import for the selected message set, rather than the default WINNT\Profiles\User directory.
In addition, after the message has been imported, the Cobol Language Message Importer dialog will remain open until the user clicks Cancel.
This fix will expedite the process of importing multiple messages into a Message set since messages will often reside in the same source directory or file.
The ability to import screens via the CICS Transaction Gateway (CTG) as an alternative to connecting to a host via TCP IP is now supported.
The applicable CICS Transaction Gateway connection properties are contained on the 3270 Session Attributes tab of the 3270 Message Set. For descriptions of these properties and their associated values, refer to the Message Sets section of MQSeries Integrator Agent for CICS Help.
Note: There are many different configuration options for connecting a CICS Transaction Gateway to a CICS Transaction Server. For assistance, refer to the CICS Transaction Gateway Configuration Guides. MQSeries Integrator Agent for CICS does not support the displaying of security pop-up windows from the CICS Transaction Gateway. The CICSCLI /C /U /P command and options can be used to prevent the CICS Transaction Gateway from attempting to display these security pop-up windows.
A button that allows you to automatically remove all screen qualifiers has been added to the 3270 Element Qualifier Selection panel.
This will alleviate the time consuming task of removing the screen qualifiers manually.
A check box has been added to the 3270 Screen Importer panel to disable the automatic creation of qualifiers during a screen import operation. When automatic creation is disabled, the user will be directed to the 3270 Element Qualifier Selection panel after import (as is done currently when no fields are identified as automatic qualifiers) to manually select screen qualifiers. When the automatic qualifier option is not selected, the user will still have the option to go to the 3270 Element Qualifier Selection panel to adjust the identifiers as necessary, including the option described in the item above.
The list of screen elements on the 3270 Element Qualifier Selection panel now contains an icon as well as the element name so that one can easily distinguish those elements that have been chosen as qualifiers, from those that have not.
The online help has been updated to:
These updates explain the t_ and s0_ prefixes used in the SQL for Mapping. The Help also includes CTRL+Shift Keys and ESQL Syntax examples for advanced mapping.
A broken link in the help index has been fixed so that the topic for repository, local now displays when the user types the keyword repository in the Index tab of the Help Home Page, and then selects the topic local.
The COBOL Importer supports the inclusion of COPY statements within an imported data structure. This support provides two functions:
You can find this information in the About the Help system book folder.
The minOccurs XML attribute for each element created via the Cobol Message Import operation will now have a default setting of an empty string. Previously, a value of 1 was being set by default for all elements created via a Cobol Message Import operation. This caused the name of these elements to appear in the color red when viewed in a mapping node.
Note: The fix to the XML attribute minOccurs will apply only to those message fields imported after the implementation of this efix. Those message fields imported prior to the implementation of this change will remain the color red. The fact that these previously imported fields remain red, does not impact functionality.
Any Types that are created from a 3270 screen import operation will now have their name end with _Type in order to distinguish these resources from the Messages themselves.
Note: Only Types imported after the implementation of this efix will be corrected. Types imported prior to the implementation of this change will not have the _Type suffix. The fact that these previously imported Types will not have the _Type suffix, does not impact functionality.
The COBOL Message Importer has been fixed to support the following:
This README file shows you how to apply the efix detailed above.
To view the latest documentation for MQSI Agent for CICS click here.For the most up to date information on MQSI Agent for CICS, go to the MQSI Agent for CICS web site
You must have a previous version of the Adapter Builder installed, the setup.exe will upgrade all applicable file structures to the latest versions. The data that is associated with any adapter created with a previous version of the Adapter Builder will remain intact.
To apply the efix, perform the following steps:
On the product splash screen, verify that the version number is Version 1.1.1.
Proceed through the installation wizard until it completes.
An updated version of the DFHMAN06 build time template will be installed in the INSTALL_DIRECTORY/templates folder as part of this efix. This template is NOT one of the templates described as needing customization by the host system administrator in both the MQSI Agent for CICS Using the Control Center documentation and the MQSI Agent for CICS Run Time User's Guide. The efix version of the DFHMAN06 build time template is required to successfully generate adapters after you install the efix.
You can remove the efix by using one of the following two methods:
From the Add/Remove programs option from the Control Panel:
While re-running the Setup.exe program that was downloaded in step #1 of Applying the efix:
The following are trademarks of IBM Corporation in the United States and other countries:
IBM WebSphere MQSeries CICS
Microsoft, Windows, Windows NT, and the Windows logo are trademarks or registered trademarks of Microsoft Corporation in the United States and/or other countries.
Other company, product, or service names may be trademarks or service marks of others.
************************************************************************** ** £ COPYRIGHT INTERNATIONAL BUSINESS MACHINES CORPORATION 2000 ** ALL RIGHTS RESERVED. **************************************************************************
Note to US Government Users - Documentation related to restricted rights - Use, duplication, or disclosure is subject to restriction set forth in GSA ADP Schedule Contract with IBM Corp.