IBM United States
Software Announcement 201-059
March 13, 2001
IBM MQSeries Integrator Agent for CICS Transaction Server Enables MDp Customers to Move to Business Integration
At a Glance
MQSeries Integrator Agent for CICS Transaction Server provides:
The MQSeries® Integrator Agent for CICS® Transaction Server Version 1 Release 1 (MQSI Agent for CICS) is a product for application integration, running on OS/390®. It enables functional migration from the existing Message Driven processor (MDp) product (originally available from Early, Cloud & Company, and more recently delivered by IBM as a PRPQ (5799-A66)).
The MQSI Agent for CICS consists of two components:
Used together, the build time and run time components of MQSI Agent for CICS enable the construction and execution of adapters to process requests from controlling applications for business transactions running on host systems, in particular CICS and IMS.
The adapter runs when the MQSI Agent for CICS server run time receives a request message from the controlling application. If the controlling application is MQSeries-enabled, the request is in the form of an MQSeries message. Any other controlling application capable of initiating a CICS program can use a CICS-supplied interface to pass a request to run the adapter. A CICS-supplied interface can be ECI, EXCI, or an EXEC CICS LINK.
Target IMS and CICS applications may be driven via 3270 data streams. CICS applications may also be driven through a Distributed Program Link (DPL). MQSeries-enabled applications are accessed through MQSeries. The product contains server adapter programs that handle these three classes of applications.
For run time, the following are required:
For build time, the following are required:
Using the build time component, the user performs a series of processes, including connector flow modeling, to build an adapter. As output from the build time, an adapter consists of COBOL (source and copybooks) and JCL.
After an adapter has been built, the user moves it from the build time environment to an OS/390 server, where it is compiled as a CICS application. In its final form, the adapter consists of COBOL and CICS executables.
The adapter runs when the MQSI Agent for CICS Adapter run time receives a request message from a controlling application. Requests from controlling applications must be contained in a CICS communication area (COMMAREA). A controlling application can be any MQSeries-enabled application, or any application capable of initiating a CICS program through a CICS-supplied interface (that is, ECI, EXCI, or EXEC CICS LINK). Examples of controlling applications include:
If the controlling application is MQSeries-enabled, the request is in the form of an MQSeries message, and the application uses the MQSeries-CICS Bridge to pass the request message to the run time. Other controlling applications (as long as they can initiate a CICS program) use a CICS-supplied interface to pass the request message to the run time.
The controlling application is responsible for the overall business flow. It manages business context complex state, multiple request and reply interactions, asynchronous processing, overall business flow compensation, and the continuation of one logical request through multiple requests, if required.
Depending on how the connector flow was modeled, adapter request processing can employ (in any sequence) server adapter programs. Server adapter programs enable the controlling application to access:
MQSI Agent for CICS server adapter programs perform the processing modeled in the connector flows (also sometimes referred to as micro-flow scripts, navigation scripts, or micro-control flows). The server adapter program processing may:
To do this, there are three types of server adapter programs:
In VisualAge® for Java Enterprise Access Builder (EAB) terminology, the server adapter programs are called commands. The server adapter programs are generated as a result of modeling using the build time component of MQSI Agent for CICS.
The navigator programs, like the server adapter programs, are generated as a result of modeling via the build time component.
It consists of the following elements:
This program is not impacted by euro currency.
MQSI Agent for CICS enables migration from the current MDp product, and is intended initially for customers who have MDp. It allows these customers to migrate to IBM's strategic business integration solution, while protecting the investment they have made in MDp task objects. It also provides a range of requirements identified by MDp customers.
MQSI Agent for CICS is a member of the strategic family of business integration offerings that include MQSeries Integrator Version 2, MQSeries Workflow, MQSeries Adapter Offering, and IBM Connectors.
For information on CICS Transaction Server for z/OS Version 2, announced today, refer to Software Announcement 201-060 , dated March 13, 2001.
Product information is available through Offering Information (OITOOL) at:
One copy of each of the following hardcopy books is delivered with the product.
Order Title Number MQSeries(R) Integrator Agent for CICS(R) Transaction Server: Run Time User's Guide SC34-5899 MQSeries Integrator Agent for CICS Transaction Server: Using the Control Center SC34-5901 Program Directory: MQSeries Integrator Agent for CICS Transaction Server GI10-2534
Order Title Number MQSeries Integrator Agent for CICS Transaction Server: Publications Library SK3T-6900
One copy of the Publications Library CD-ROM is shipped with the product. It may also be purchased separately for $40. Specify feature number 8194. Contact your IBM representative.
MQSI Agent for CICS run time requires:
MQSI Agent for CICS build time requires:
MQSI Agent for CICS requires:
For build time, MQSI Agent for CICS requires:
MQSI Agent for CICS may be used via FEPI with CICS 3270 applications running under CICS/ESA® V4.1, or later; and with IMS 3270 applications running under IMS Transaction Manager V5.1, or later.
MQSI Agent for CICS run time runs as an application under CICS TS
V1.3, and so inherits the performance characteristics of that product.
The navigation steps depend on Business Transaction Services, and so
inherit its performance characteristics.
The run time component of MQSI Agent for CICS is provided in CBPDO and ServerPac, and is installed by SMP/E.
It also contains the following licensing materials in hardcopy:
Security, Auditability, and Control
The run time component of MQSI Agent for CICS runs as an application under CICS TS V1.3, and therefore uses the security, auditability, and control facilities provided by CICS. Support by an External Security Manager for FEPI pass-tickets is also used.
The customer is responsible for evaluation, selection, and implementation of security features, administrative procedures, and appropriate controls in application systems and communication facilities.
MQSeries Integrator Agent for CICS Transaction Server is an IPLA product with a single charge based on installations.
Software Subscription and Support is required to provide the same level of support as is delivered with standard S/390® ICA offerings, including voice defect support, together with code updates. It has a single annual charge, which must be purchased in the same quantity as MQSI Agent for CICS.
OTC(1) MQSeries Integrator Agent for Program Feature CICS Transaction Server Number Number Per Install 5655-F25 0001
Basic License: To order, specify the program number 5655-F25, and the OTC feature number. (Note that feature number 9001 for asset registration is not required.) Also specify the feature number of the desired distribution medium, as follows:
Medium Feature Description Number Medium MQSI Agent for CICS 5801 Magnetic Tape 9-track 6250 bpi 5802 3480 1/2-inch Tape Cartridge 6427 4-mm DAT Cartridge
Software Subscription and Support: To order the Software Subscription and Annual Support, specify program number 5655-F50 and the feature number from the table below. (Note that feature number 9001 for asset registration is not required.) The quantity of Software Subscription and Support licenses must be equal to the number of OTC licenses ordered.
Also specify the feature number of the distribution medium:
Medium Feature Description Number Medium MQSI Agent for CICS SW Subscription and Support 6448 Paper
Customization Options: Select the appropriate feature numbers to customize your order with delivery options desired. These features can be specified on the initial or MES orders.
Example: If publications are not desired for the initial order, specify feature # 3470 to ship media only. For future updates, specify feature # 3480 to ship media updates only. If, in the future, publication updates are required, order an MES to remove feature # 3480; then, the publications will ship with the next release of the program.
Feature Description Number Initial Shipments Serial number only (suppresses shipment 3444 of media and documentation) Ship media only (suppresses initial 3470 shipment of documentation) Ship documentation only (suppresses 3471 initial shipment of media) Update Shipments Ship media updates only (suppresses 3480 update shipment of documentation) Ship documentation only (suppresses 3481 update shipment of media) Suppress updates (suppresses update 3482 shipment of media and documentation) Expedite Shipments Local IBM office expedite 3445 (for IBM use only) Customer expedite process charge 3446 ($30 charge for each product)
Expedite shipments will be processed to receive 72-hour delivery from the
time IBM Software Delivery and Fulfillment (SDF) receives the order. SDF
will then ship the order via overnight air transportation.
MQSI Agent for CICS is shipped via the CBPDO and ServerPac Customized Offerings.
Terms and Conditions
These products are licensed under the IPLA, and the associated Agreement for Acquisition of Support, and the Addendum for Support (Z125-6435) which provides for support with ongoing access to releases and versions of the program. These programs have a one-time license charge for use of the program and an ongoing recurring charge for the enhanced support that includes telephone assistance (voice support for defects during normal business hours) and access to updates, releases, and versions of the program as long as support is in effect. S/390 SupportLine is an option for those customers who desire added services.
Licensing of MQSI Agent for CICS Adapter Builder: A license for MQSI Agent for CICS includes the right to make and use without additional charge, within the same enterprise, any number of copies of the MQSI Agent for CICS Adapter Builder, subject to their use being with the licensed MQSI Agent for CICS Adapter run time.
Software Subscription and Support: The Software Subscription and Support program number 5655-F50 includes the same level of support as is delivered as part of standard S/390 ICA offerings and is required with the licensing of program 5655-F25 in order to provide this support. Customers will not be entitled to voice defect support or code updates without purchasing 5655-F50. 5655-F50 must be purchased in the same quantity as 5655-F25. As described in the IBM/Lotus®/Tivoli® Software Support Handbook, this base support includes (for most System/390® products) problem support for suspected defects in IBM code and publications via fax, mail, telephone (voice), and electronic access. Support for high-severity problems is available 24 hours a day 7 days a week. Access the handbook at:
Click on IBM/Lotus/Tivoli Software Support Handbook . The handbook also describes Support Line, SoftwareXcel, and other on-site and remote services.
In addition, the target response times for this offering are the same as those for other S/390 ICA offerings.
S/390 Support Line is a fee service which can enhance your productivity by providing voice and electronic access into the IBM support organization. S/390 Support Line will help answer questions pertaining to usage, how-to, and suspected software defects for eligible products.
Installation and technical support is provided by IBM Global Services. For more information on services, call 800-IBM-4YOU (426-4968).
The prices provided in this announcement are suggested retail prices for the U.S. only and are provided for your information only. Dealer prices may vary, and prices may also vary by country. Prices are subject to change without notice. For additional information and current prices, contact your local IBM representative.
OTC Program Feature Description Number Number OTC Per Install 5655-F25 0001 $100,000 Annual Charge Program Feature Annual Description Number Number Charge SW Subscription 5655-F50 0001 $25,000 and Support
The number of Software Subscription and Support licenses must be equal to the number of OTC licenses ordered.
Contact your sales channel for Support Line pricing information.
Customer Financing: IBM Global Financing offers attractive financing to credit-qualified commercial and government customers and Business Partners in more than 40 countries. IBM Global Financing is provided by the IBM Credit Corporation in the United States. Offerings, rates, terms, and availability may vary by country. Contact your local IBM Global Financing organization. Country organizations are listed on the Web at: