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

 ENUS203-030.PDF (43KB)


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).

Overview

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:

  • Real-time data propagation
  • External logging or notification of CICS-related activity
  • Non-CICS functions acting as write-only data repositories

Business Event Publisher is an MQ message generator. At this time, it does not provide inbound MQ message support.

Key Prerequisites

CICS Business Event Publisher for MQSeries V1.1 requires:

  • OS/390® V2.10, or z/OS™ at any level
  • CICS Transaction Server for OS/390 V1.3, or CICS Transaction Server for z/OS V2.2
  • MQSeries for OS/390 V2.1, or later
  • A Workstation running Windows NT®, Windows 2000, or Windows XP
  • TCP/IP on both host and workstation machines

Planned Availability Date

March 28, 2003

Description

Components of Business Event Publisher reside in several places:

  • A Microsoft Windows-based PC hosts a GUI module which is used to generate rules.
  • These rules reside on the mainframe and are only accessed by Business Event Publisher Address Spaces.
  • Inside the CICS region Business Event Publisher supplies various exit programs which are executed as CICS Global User Exit modules.

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:

  • Scan the rules for a matching request
  • Use a matched rule to generate the contents of a MQ Message
  • Use a matched rule to place the message on a given MQ queue

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:

  • A VTAM® APPLID for a CICS region
  • A Transaction ID
  • A Security Identity (User ID)
  • The resource type and name (such as a VSAM file name)
  • The MQSeries queue name to be used
  • The data to be placed in the MQSeries message

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 Connector:

  • Scans the rules for a match against the current activity (which is monitored in the Business Event Publisher GLUE modules).
  • Generates the MQ message based on the matched rule.
  • Sends the generated message to the Business Event Publisher Message Server for placement on the relevant MQ queue.
  • Ensures that transactional activity occurring in the Business Event Publisher Message Server and that within the CICS region are coordinated. All updates to CICS Recoverable Resources and the Business Event Publisher MQPUTs are committed or neither succeed. In effect, but not physically, the scope of the CICS Unit of Work extends into 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:

  • Operation by keyboard alone
  • Optional font enlargement and high-contrast display settings
  • Tested with screen readers and screen magnifiers for use by people with visual impairment
  • Suitable for people with hearing impairment

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 on request.

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.

Note that Value Units of a given product cannot be exchanged/interchanged/aggregated with Value Units of another product.

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.

Product Positioning

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:

  • Real-time data propagation

    A change to data held in, say, a VSAM record can be notified to an entity external to CICS. This can be used to trigger further activity based on the data change. Without use of Business Event Publisher, this notification would have to be coded in the CICS application, whereas with Business Event Publisher it occurs transparently.

  • External logging or notification of CICS-related activity

    It can be very tedious to code logging function within CICS and this often involves complicated off-line processing. Use of Business Event Publisher permits this logging to occur without any application code (so removing or avoiding complexity), but more importantly in real time. Consequently, logging analysis need not necessarily wait until an off-line operation has occurred to make the information available.

  • Non-CICS functions acting as write-only data repositories

    Activity to critical and non-critical data repositories have to be coded in the same way within a CICS application. Use of Business Event Publisher can separate critical (coded in the application) and non-critical (done via Business Event Publisher).

Trademarks

 
z/OS is a trademark of International Business Machines Corporation in the United States or other countries or both.
 
CICS, MQSeries, OS/390, and VTAM are registered trademarks of International Business Machines Corporation in the United States or other countries or both.
 
Microsoft is a trademark of Microsoft Corporation.
 
Windows and Windows NT are registered trademarks of Microsoft Corporation.
 
Other company, product, and service names may be trademarks or service marks of others.

Education Support

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.

Offering Information

Product information will be available through Offering Information (OITOOL) at:

Publications

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

Technical Information

Specified Operating Environment

Hardware Requirements

Business Event Publisher runs on any S/390® or IBM eServer zSeries™ machine on which the applicable operating system and software will run.

The Rules Database administration tool requires any machine capable of running the applicable operating system.

Software Requirements

Business Event Publisher requires:

  • OS/390® V2.10 (5647-A01) or z/OS™ (any level) (5694-A01), but not z/OS.e
  • Plus one of the following CICS® servers:
    • CICS Transaction Server for OS/390 V1.3 (5655-147) or
    • CICS Transaction Server for z/OS V2.2 (5697-E93)
  • And, any of the following MQSeries® products:
    • MQSeries for OS/390 V2.1 (5655-A95)
    • MQSeries for OS/390 V5.2 (5655-F10)
    • WebSphere® MQ for z/OS V5.3 (5655-F10)

The Rules Database administration tool requires an attached (networked) workstation running either:

  • Windows NT®, or
  • Windows® 2000, or
  • Windows XP

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 machines.

Planning Information

Packaging

CICS Business Event Publisher for MQSeries V1.1 is delivered in a package containing:

  • IBM International Program License Agreement (IPLA) in multilanguage booklet (Z125-3301)
  • License Information for Business Event Publisher (L-TMAN-5GXDV8) in multiple languages
  • IPLA Pointer Sheet (Z127-1000)
  • Proof of Entitlement (PoE)
  • Program Directory for CICS Business Event Publisher for MQSeries V1.1
  • 3480 ½-inch tape cartridge containing a CBPDO or other Customized Offering delivery of the product

The Rules Database administration tool is included in the product installed on the mainframe, and is then downloaded to the workstation where it is installed by InstallShield.

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.

Ordering Information

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.

Ordering Example

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.

Example: In the above order example for a product running on machines with 1,500 MSUs requiring 344 Value Units, order feature number 0001, quantity 94 and feature number 0002, quantity 1.

Note: For actual feature numbers, refer to below.

Value Units for non MSU-based S/390 Processors:

MP3000 Models

    H30 = 6.00 Value Units
    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:

  • Includes and extends the support services provided in the base support to include technical support via telephone during normal business hours.
  • Entitles customers to future releases and versions at no additional charge. Note that the customer is not entitled to new products.

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)

Customization Options: Not applicable

Customized Offerings

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:

  • Determine the MSUs needed for each machine on which the tools will run. Only machines on which the customer has implemented sub-capacity Workstation License Charges (WLC) according to the above terms and conditions, are eligible for charges at less than full machine capacity for the tools.
  • Use the product-defined capacity for z/OS (as specified on the Sub-Capacity Reports submitted to IBM for sub-capacity WLC) as the sub-capacity (MSUs) for each tool.
  • Submit any additional MSUs and/or Value Units required for each product along with the current entitlement in Value Units for each product.

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:

  • Determine the MSUs needed for the machine on which the tools will run. In a data sharing environment, determine the aggregate MSUs needed on the machine where the tools run. Use the product-defined capacity (MSUs) for z/OS (as specified on the Sub-Capacity Reports submitted to IBM for sub-capacity WLC) as the sub-capacity (MSUs) for each Tool.
  • Submit any additional MSUs and/or Value Units required for each product along with the current entitlement in Value Units for each product.
  • If the use of sub-capacity pricing terms for AD, DM, and CICS Tools results in a reduced requirement for Value Units, thus freeing up entitlements, customers can reallocate the entitlement difference by distributing the Value Units across a larger or different set of systems, or reserve them for future growth. There will be no refunds for these freed up Value Units. Subscription and Support volumes and entitlements for existing contracts will continue to be at the same levels as the acquired licenses.

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 z/OS-defined capacity is increased.
  • The requirements for WLC sub-capacity charges are no longer met.

Licensing: IBM IPLA. PoEs are required for all authorized use.

The following agreements apply for maintenance and do not require customer signatures:

  • IBM Agreement for Acquisition of Support (Z125-6011)

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.

Limited Warranty Applies: Yes

Program Services: This program has program services for a minimum of one year from acquisition from IBM or authorized business partner.

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.

Copy and Use on Home/Portable Computer: No

Volume Orders (IVO): No

Passport Advantage Applies: No

Software Maintenance Applies: No

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.

IBM Operational Support Services — Support Line: Yes

AIX®/UNIX® Upgrade Protection Applies: No

Entitled Upgrade for Current AIX/UNIX Upgrade Protection Licensees: No

iSeries™ Software Subscription Applies: No

Variable Charges Apply: No

Educational Allowance Available: Yes, 15% education allowance applies to qualified education institution customers.

Prices

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

Global Financing

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:

Order Now

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:  ibm_direct@vnet.ibm.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.

Trademarks

 
zSeries, the e-business logo, z/OS, System/370, z/Architecture, MVS, and iSeries are trademarks of International Business Machines Corporation in the United States or other countries or both.
 
S/390, OS/390, CICS, MQSeries, WebSphere, System/390, Systempac, and AIX are registered trademarks of International Business Machines Corporation in the United States or other countries or both.
 
Windows NT and Windows are registered trademarks of Microsoft Corporation.
 
UNIX is a registered trademark of the Open Company in the United States and other countries.
 
Other company, product, and service names may be trademarks or service marks of others.