IBM United States
Software Announcement 203-030
February 4, 2003
IBM CICS Business Event Publisher for MQSeries Creates MQSeries Messages Based on Events in CICS Applications
At a Glance
Extend your existing CICS applications with IBM CICS Business Event Publisher, which creates MQSeries messages based on events generated within unmodified CICS applications. By using a GUI on a Windows-based workstation, users can specify events that generate messages, as well as the nature and destination of messages.
For ordering, contact:
Your IBM representative, an IBM Business Partner, or the Americas Call Centers at 800-IBM-CALL (Reference: LE001).
CICS® Business Event Publisher for MQSeries® V1.1 (Business Event Publisher) enables a rapid extension of existing applications running in CICS Transaction Server V1.3 or CICS Transaction Server V2.2. Business Event Publisher generates user-defined MQSeries messages as a side effect when certain EXEC CICS commands are executed by a CICS application. This message generation is transparent to the application program, so these remain unchanged when Business Event Publisher is used.
Rules control the generation of the MQSeries messages, which are defined using a Microsoft Windows®-based graphical utility. These rules enable the content of the MQSeries message to be customizable, as is the queue to receive the message.
Business Event Publisher rules can match, for example, VSAM file updates or temporary storage activity and so notify another application of a change to a record.
Benefits of Business Event Publisher are:
Business Event Publisher is an MQ message generator. At this time, it does not provide inbound MQ message support.
CICS Business Event Publisher for MQSeries V1.1 requires:
Components of Business Event Publisher reside in several places:
A CICS application program issues EXEC CICS commands to utilize CICS facilities. While executing these commands, CICS will execute user-supplied modules at various stages of processing. These modules are invoked at Global User Exit (GLUE) points and are called Exit modules. Business Event Publisher provides several Exit modules.
These Exit modules:
These operations are transparent to the application program that issued the EXEC CICS command.
By this means, Business Event Publisher generates MQSeries messages as a side effect to various EXEC CICS commands, providing a valuable extension to an existing application without that application having to change.
The rules themselves are generated on a workstation and sent to the Business Event Publisher Message Server using TCP/IP communications. These rules are cached in a Data Space for efficient access; operations are provided to refresh the cache.
Rules contain information such as:
The Business Event Publisher Message Server is responsible for the MQPUT operation to send the generated message to the required queue. MQPUT operations can be either within an Unit of Work or outside of one. In the former case, the Business Event Publisher Unit of Work is not that used by CICS, but is coordinated with the current CICS Unit of Work. This means that updates to CICS Recoverable Resources and the MQPUT will either both succeed or both fail.
Another component is the Business Event Publisher CICS Connector. This provides the link between the Business Event Publisher GLUE modules and the Business Event Publisher Message Server.
The Business Event Publisher Connector is accessed from within the CICS region through the Business Event Publisher GLUE modules. The CICS application is unaware of this additional function (although a rule can choose to send an EIBRESP2 return code on a failure).
More than one rule can be matched by the Connector, so multiple MQ messages can be generated as a side effect to the actual EXEC CICS command.
If the CICS application matches on many Business Event Publisher Rules, several MQ messages can be produced. A novel feature of Business Event Publisher is that, if these messages are placed on the same MQSeries queue, the messages can be concatenated together (along with additional control information) into one big message for enhanced performance.
The workstation GUI utility that generates the Business Event Publisher Rules can be configured so that sensitive information is not left on the workstation after usage of the Business Event Publisher GUI application. In addition to avoiding a single point of failure for storage of rules, this avoids a potential security exposure.
This GUI utility contains a powerful facility for the generation of rules
and the manipulation of the contents of MQ messages. A utility is
provided to import a COBOL COPYBOOK into the Business Event Publisher
environment so data manipulation and selection can be on the basis of
named items. In the unlikely event that these data manipulation
facilities are inadequate, a CICS Application Program can be used to
manually generate the contents of the MQ message.
Section 508 of the U.S. Rehabilitation Act
The following features support use by people with disabilities:
Softcopy .pdf documentation is shipped with the product. .pdf
documentation supports optional font enlargement, high-contrast display
settings, and may be operated by the keyboard alone. Alternative text is
not provided for screen-reader users, however, fully accessible softcopy
documentation, with alternative text for diagrams, will be made available
Value Unit Based Pricing
Value Unit based pricing will help to align the prices of these products to the principle of the Parallel Sysplex License Charge (PSLC) pricing curve which provides for a lower price per MSU (millions of service units per hour) for larger capacities.
There is also a price benefit when customers grow their capacity. Additional capacity will be based on the number of Value Units (MSUs) the customer has already installed, for example, additional capacity will not be priced starting at the base with a higher price per unit, but on the capacity that is already installed.
IPLA and Subscription and Support Considerations
International Program License Agreement (IPLA) licenses can be transferred from one machine to another within, but not limited to an enterprise. The customer may aggregate the capacity for all the processors on which the product is operated to achieve a more economic price. This will result in a single Proof of Entitlement. It is the customer's responsibility to manage the distribution of Value Units within the limits of the entitlement of the product license.
Subscription and Support must cover the same capacity as the product license entitlement. Subscription and Support will be available in the country in which the agreement is made.
Business Event Publisher is not a Message Broker. It generates MQ Series messages, but at this time does not have any capability to receive or process such inbound messages.
However, by its ability to generate notifications as a side effect when certain EXEC CICS commands are executed, Business Event Publisher provides some new opportunities for application extension. It is a strong point of Business Event Publisher that these existing CICS applications are not altered.
These additional functions become available for existing CICS applications using Business Event Publisher:
For additional information, visit:
The appropriate curriculum will include the enhancements described in this announcement.
Also, refer to the IBM Learning Services Web site for available courses in your country:
Call IBM Education and Training at 800-IBM-TEACH (426-8322) for catalogs, schedules, and enrollments.
Product information will be available through Offering Information (OITOOL) at:
The only hardcopy documentation delivered with Business Event Publisher will be the Program Directory. After planned availability, user documentation will be available softcopy to download in PDF format from the IBM Publications Center Web site. Customers who want hardcopy of the documentation can print copies from the PDF files.
Publication Form Number User Guide GC34-6295 Getting Started GC34-6296 Program Directory GI10-2564
Specified Operating Environment
Business Event Publisher runs on any S/390® or IBM zSeries machine on which the applicable operating system and software will run.
Business Event Publisher requires:
The Rules Database administration tool requires an attached (networked) workstation running either:
The Rules Database administration tool runs as a VisualBasic application;
the required software is provided in the operating system. TCP/IP
communication support is needed between the host and workstation
CICS Business Event Publisher for MQSeries V1.1 is delivered in a package containing:
Security, Auditability, and Control
CICS Business Event Publisher for MQSeries V1.1 uses the security and auditability features of the OS/390 or z/OS operating system under which it is operating.
The customer is responsible for evaluation, selection, and implementation of security features, administrative procedures, and appropriate controls in application systems and communication facilities.
CICS Business Event Publisher for MQSeries V1.1 is licensed under the IBM IPLA. It has a single charge unit, based on Value Units.
Value Unit Exhibit VUE007
Value Usage Level Minimum Maximum Units/MSU Base 1 3 1 PSLC/Level A 4 45 0.45 PSLC/Level B 46 175 0.36 PSLC/Level C 176 315 0.27 PSLC/Level D 316 + 0.2
Value Units/ HW Machine MP3000 H30 6 MP3000 H50 8 MP3000 H70 12 ESL Models 2
The products in this announcement have one charge unit Value Units.
Value Units for IBM 9672 Processors will be based upon the full capacity of these systems. This is applicable to all S/390-based systems that are measured on MSU capacity. Information on MSU capacities can be found in the IBM System/370, System/390®, and zSeries Machine Exhibit (Z125-3901).
Value Units for zSeries will be based upon full MSU capacity as defined in the Machine Exhibits.
There will be a tool available that provides support for transforming the MSU-based capacities of S/390 systems to new Value Units by calculating the applicable number of Value Units for a given number of MSUs.
The total number of Value Units is calculated according to the following example.
If the customer has installed 1,500 MSUs, the applicable Value Units would be:
Translation from MSUs to Value Units
Value Units/ Value MSUs * MSU = Units Base 3 * 1.00 = 3.00 Tier A 42 * .45 = 18.90 Tier B 130 * .36 = 46.80 Tier C 140 * .27 = 37.80 Tier D 1,185 * .20 = 237.00 Total 1,500 343.50
When calculating the total number of Value Units, the sum is to be rounded up to the next integer.
Note: For actual feature numbers, refer to below.
Value Units for non MSU-based S/390 Processors:
H50 = 8.00 Value Units
H70 = 12.00 Value Units
P/390, R/390, IBM 3006 = 2.00 Value Units
Basic License: To order, specify the program number, (5655-J99), feature number 9001 for asset registration and the one-time charge (OTC) feature number. Also specify the feature number of the desired distribution medium. To suppress shipment of media, select the license-only option in CFSW.
Medium Program Feature Description Number Number Medium CICS Business 5655-J99 5802 3480 Event Publisher ½-inch for MQSeries V1.1 Tape Cartridge CICS Business 5655-J97 6000 Paper Event Publisher for MQSeries V1.1 -- Software Subscription and Support
Translation from MSUs to Value Units
Value Units/ MSUs MSU Base 1-3 1.00 Tier A 4-45 0.45 Tier B 46-175 0.36 Tier C 176-315 0.27 Tier D 316+ 0.20
OTC Medium Program Feature Feature Description Number Number Number Medium CICS 5655-J99 5802 3480 Business tape Event Publisher for MQSeries V1.1 1 Value 0001 Unit 250 Value 0002 Units
Subscription and Support
To receive voice technical support via telephone during normal business hours, and future releases and versions at no additional charge, Subscription and Support must be ordered. The capacity of Subscription and Support (Value Units) must be the same as the capacity ordered for the product licenses.
To order, specify the support program number 5655-J97, and feature number 9001 for asset registration. IBM is also providing Subscription and Support for these products via a separately purchased offering under the terms of the IBM International Agreement for Acquisition of Support (IAAS). This offering:
Once Subscription and Support is ordered, the charges will renew automatically annually unless cancelled by the customer.
Annual Support Charge Program Feature Description Number Number Subscription and Support 5655-J97 for CICS Business Event Publisher for MQSeries V1.1 1 Value Unit 0001 250 Value Units 0002 Decline SW Subscription 0003 and Support (no charge)
Product media is shipped only via Customized Offerings (for example, CBPDO, ServerPac, Systempac®). Non-customized items (CDs, diskettes, source media, media kits) will continue to be shipped via the stand-alone product.
Terms and Conditions
Sub-Capacity Charges Terms and Conditions
IBM zSeries software charges at less than full machine capacity for eligible Data Management (DM), Application Development (AD), and CICS Tools apply when z/OS is running in z/Architecture (64 bit) mode on a zSeries 900, no other MVS-based operating system is licensed to that server, and the required information is provided by the customer in accordance with the applicable terms.
Sub-capacity charges for an eligible AD, DM, and CICS Tool are based on the z/OS product-defined capacity. To obtain charges at less than full machine capacity for eligible AD, DM, and CICS tools, the customer is required to:
Sub-Capacity Charges for AD, DM, and CICS Tools
To be eligible for sub-capacity charges for AD, DM, and CICS Tools, the machine on which the AD, DM, and CICS Tools are running must be eligible for WLC sub-capacity charges terms and conditions. The customer must have signed the Attachment for zSeries Workload License Charges-Pre-ILM , Z125-6516, and submitted at least one Sub-Capacity Report to IBM as defined in the attachment.
With sub-capacity charges, the charge for an eligible AD, DM, or CICS Tool is based on the z/OS product-defined capacity. To obtain charges at less than full machine capacity for each eligible AD, DM, and CICS Tool for each machine, the customer should:
Management of the Value Unit entitlements continues to be a customer responsibility. If one of the following occur on a machine to which AD or DM Tools are licensed, the customer must determine if additional Value Units and Subscription and Support need to be ordered for those tools to cover the increase:
The following agreements apply for maintenance and do not require customer signatures:
These products are licensed under the IBM IPLA, 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) as well as access to updates, releases, and versions of the program as long as support is in effect. S/390 and zSeries IBM Operational Support Services Support Line is an option for those customers who desire added services.
Program Support: Enhanced Support, called Subscription and Support, includes telephone assistance (voice support for defects during normal business hours) as well as access to updates, releases, and versions of the program as long as support is in effect. The customer will be notified of discontinuance of support with 12 months' notice.
Money-Back Guarantee: If for any reason you are dissatisfied with the program, return it within 30 days from the invoice date, to the party (either IBM or its reseller) from whom you acquired it, for a refund. This applies only to your first acquisition of the program.
For Operating System software, the revised IBM Operational Support Services Support Line offering will provide support for those operating systems and associated products that are not available with the newly announced Software Maintenance offering. This will ensure total support coverage for your enterprise needs, including IBM and selected non-IBM products. For complete lists of products supported under both the current and revised Support Line offering, refer to our Web site at:
For additional information on the revised IBM Operational Support Services, refer to Services Announcement 601-023 , dated July 10, 2001.
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.
Program Name: CICS Business Event Publisher for MQSeries V1.1
OTC Program Feature Description Number Number OTC CICS Business Event Publisher for MQSeries V1.1 5655-J99 1 Value Unit 0001 $ 5,000 250 Value Units 0002 1,250,000
Subscription and Support
Annual Support Charge Program Feature Description Number Number OTC CICS Business Event 5655-J97 Publisher for MQSeries V1.1 -- Subscription and Support 1 Value Unit 0001 $ 750 250 Value Units 0002 187,500
IBM Global Financing offers competitive financing to credit-qualified customers to assist them in acquiring IT solutions. Our offerings include financing for IT acquisition, including hardware, software, and services, both from IBM and other manufacturers or vendors. Offerings (for all customer segments: small, medium, and large enterprise), rates, terms, and availability can vary by country. Contact your local IBM Global Financing organization or visit the Web at:
To order, contact the Americas Call Centers, your local IBM representative, or your IBM Business Partner.
To identify your local IBM representative or IBM Business Partner, call 800-IBM-4YOU (426-4968).
Phone: 800-IBM-CALL (426-2255) Fax: 800-2IBM-FAX (242-6329) Internet: email@example.com Mail: The Americas Call Centers Dept. LE001 P.O. Box 2690 Atlanta, GA 30301-2690 Reference: LE001
The Americas Call Centers, our national direct marketing organization, can add your name to the mailing list for catalogs of IBM products.
Note: Shipments will begin after the planned availability date.