January 26, 1999
IBM MQSeries Workflow for OS/390 Expands Business Integration to S/390 Platform
At a Glance
MQSeries Workflow for OS/390:
For ordering, contact:
Your IBM representative, an IBM Business Partner, or IBM Americas Call Centers at 800-IBM-CALL (Reference: LE001).
EXTRA! EXTRA! . . .
Subscribe to IBM iSource, your electronic source for customized IBM information! Go to our Web site at http://www.ibm.com/isource or send an e-mail to email@example.com with the word SUBSCRIBE in the body.
IBM MQSeries® Workflow for OS/390® Version 3
MQSeries Workflow is the IBM solution for the definition and execution of business processes to achieve business integration. Its implementation leads to significant quality and productivity improvements and enables enterprises to react quickly to meet market challenges.
Runtime clients for various workstation platforms and a license for one Registered User are included. Additional Registered Users must be ordered as features under IBM MQSeries Workflow Version 3.1. A graphical buildtime environment for Windows NT® and Windows 95 makes it easy to visualize, design, and modify business process flows. Code and a license to use are included.
With the new MQSeries releases you can integrate your host applications into business workflows, taking advantage of Work Load Manager prioritized queues in OS/390, and gaining the same high degree of transactional integrity you have in a CICS® or IMS environment.
MQSeries Workflow is a member of the MQSeries family of products that automate workflow between applications, and automate business processes involving people and applications to give organizations more control of their business activities. It helps you in daily business operations, planning, and management, to align and integrate resources and applications, to improve efficiency, and to gain higher market share. In addition, it enables the design of applications tailored to your business. Building on the foundation of IBM MQSeries for OS/390 Version 2, IBM's industry-leading, messaging middleware, it enables integration across heterogeneous environments.
This announcement satisfies the Statement of General Direction. Refer to Software Announcement 298-270 , dated July 28, 1998.
Planned Availability Date
MQSeries Workflow for OS/390 expands Business Integration to the S/390® platform. It helps you model your business processes and execute them in a highly automated way. It allows you to effectively integrate the two most valuable assets that make up a business process: staff work and applications.
MQSeries Workflow for OS/390 is a powerful business integration product with all the strengths of the S/390 platform reliability, availability, security, and scalability making your way of doing business more robust and more cost effective.
A GUI buildtime editor running on Windows NT or Windows 95 allows you to model your business processes in a graphical way, including people and their roles, applications, and data to be transferred among both people and applications.
These described processes are stored in a DB2 database and executed at runtime by the Execution Server. Applications can be invoked on client platforms or on OS/390 itself.
Invocation of CICS and IMS applications can be done easily through the Program Execution Server, which handles the synchronous or asynchronous invocation of these transactions and the transfer of data back and forth. Other types of S/390 applications can be plugged in and then integrated in a similar way.
Based on Message Queuing
MQSeries Workflow for OS/390 uses IBM MQSeries for OS/390 Version 2 as the underlying middleware for client/server communication, communication between server components, and server transaction commit coordination with DB2. IBM MQSeries for OS/390 Version 2 is a prerequisite.
Based on Relational Database
MQSeries Workflow for OS/390 stores buildtime and runtime data in a relational database. The MQSeries Workflow for OS/390 servers exploit the industrial strength, capacity, scalability, transaction, reliability, security, and administration functions built into IBM DB2 for OS/390 Version 5 Release 1, which is a prerequisite.
The MQSeries Workflow for OS/390 servers connect all MQSeries Workflow clients, and control the execution of processes throughout your organization. A server consists of one or more components, such as administration server, execution server, scheduling server, or cleanup server. The MQSeries Workflow for OS/390 servers have been designed for exploitation of the System/390® features, such as:
MQSeries Workflow for OS/390 exploits the typical System/390 strength of scalable performance. Multiple instances of execution servers and program execution servers can be run in parallel sharing the same database. This will allow users to connect multiple workflow clients to the same workflow runtime database, sharing the same workflow definitions and running process instances.
The Program Execution Server allows the integration of existing and newly written applications running in CICS or IMS. For legacy applications, a powerful and customizable data mapping is provided. Programs can be invoked synchronously or asynchronously. In addition to the built-in support for data mapping and invocation, MQSeries Workflow offers customizable user exits to allow you to tailor the program execution facility according to your individual environment.
MQSeries Workflow for OS/390 offers a console interface for administration purposes. The administrator uses the console to submit workflow administration requests. These requests are processed by the administration server component of MQSeries Workflow for OS/390.
Application Programming Interfaces
MQSeries Workflow for OS/390 offers APIs to:
The APIs support the following languages:
This product is Year 2000 ready. When used in accordance with its associated documentation, it is capable of correctly processing, providing, and/or receiving date data within and between the twentieth and twenty-first centuries, provided that all products (for example, hardware, software, and firmware) used with the product properly exchange accurate date data with it.
For the initial announcement of IBM MQSeries Workflow Version 3.1, refer to Software Announcement 298-270 , dated July 28, 1998.
Message Driven Processing (MDP) provides workflow capability to CICS-based application solutions such as ECC's Callflow. MQSeries Workflow for OS/390 can interface with MDP or Application Integration Feature (AIF) applications.
National Language Support
The IBM MQSeries Workflow for OS/390 server is enabled to support connected clients that determine the national languages. They are available in these national languages:
Hardware and Software Support Services
For the initial announcement of IBM MQSeries Workflow Version 3 Release 1, refer to Software Announcement 298-270 , dated July 28, 1998.
Details on the MQSeries® Workflow for OS/390® APIs
MQSeries Workflow provides its APIs to run in the following environments:
In the native and CICS environments all types of APIs are supported. MQSeries Workflow for OS/390 does not support the process and worklist APIs under IMS. Here, only the container API is provided. MQSeries Workflow for OS/390 APIs support only C and COBOL programming languages.
Specified Operating Environment
Operating Recommended Recommended Environment Main Memory Hard Disk Windows(TM) 95 64 MB 1 GB Windows NT(R) 96 MB 1 GB
Note: Make sure you have sufficient swap space.
Runtime Client Environment: For technical details, refer to Software Announcement 298-270 , dated July 28, 1998 (IBM MQSeries Workflow Version 3 Release 1).
For the development of programs using the Workflow APIs and running on the OS/390 operating system, one of:
To use the non-transactional EXCI:
To use the transactional EXCI (for safe applications):
To use the CPIC:
Runtime Client Environment: For technical details, refer to Software Announcement 298-270 , dated July 28, 1998 (IBM MQSeries Workflow Version 3 Release 1).
Performance Considerations: The performance of IBM MQSeries Workflow for OS/390 Version 3 depends heavily on the usage characteristics of the process models and organization definitions, average and maximum size of the worklist, capacity and utilization of the MQSeries Workflow server machine, speed and the memory size of the server and client machines, and transmission speed and load of the communication channels.
For a systems assurance review of your specific implementation of MQSeries Workflow for OS/390, refer to the following URL:
Packaging: IBM MQSeries Workflow for OS/390 Version 3 is available as one program package, containing all product components for all supported operating environments. The MQSeries Workflow for OS/390 package includes:
IBM will accept APARs where the installation of this licensed program causes an exposure to the system integrity of OS/390.
Security, Auditability, and Control
The security and auditability features are:
The customer is responsible for evaluation, selection, and implementation of security features, administrative procedures, and appropriate controls in application systems and communication facilities.
The publication MQSeries Workflow for OS/390 is available. General information is available under various topics on the MQSeries Workflow Web pages. Visit the following URL:
Orders for new licenses of IBM MQSeries Workflow for OS/390 will be accepted now. Shipment will begin on the planned availability date.
Orders entered after the planned availability date will be assigned a schedule date for the week following order entry.
Basic License: To order a basic license of MQSeries Workflow for OS/390, specify program number 5655-A96 and feature number 9001 for asset registration. The number of Registered Users that are required must be ordered as features under IBM MQSeries Workflow Version 3.1, part number 09L8161. Specify the feature number of the desired distribution medium shown below.
Entry Support License (ESL): To order an ESL, specify the program number, feature number 9001 for asset registration, and the applicable ESL one-time charge (OTC) feature number. Also specify the feature number of the desired distribution medium.
ESL OTC Program Number/Description Feature Number 5655-A96, MQSeries Workflow 0013 for OS/390
ESL machines can be determined by referring to the IBM Entry End User/390 Attachment (Z125-4379).
Parallel Sysplex® License Charge (PSLC) Basic License: To order a basic license, specify the program number and feature number 9001 for asset registration. Specify the PSLC Base feature. If applicable, specify the PSLC Level A and PSLC Level B features and quantity.
If there is more than one program copy in a Parallel Sysplex, the charge for all copies is associated to one license by specifying the applicable PSLC feature numbers and quantity represented by the sum of the Service Units in Millions (MSUs) in your Parallel Sysplex. For all other program copies, specify the PSLC No-Charge (NC) Identifier feature on the licenses.
Also, specify the feature number of the desired distribution medium.
PSLC PSLC Basic License Machine Feature MLC Feature MSU Capacity Number Description 1 0001 PSLC Base, 1 MSU 2 0002 PSLC Base, 2 MSU 3 0003 PSLC Base, 3 MSU 4 -- 45 0004 PSLC Level A, 1 MSU 0005 PSLC Level A, 42 MSU 46 -- 175 0006 PSLC Level B, 1 MSU 0007 PSLC Level B, 10 MSU 0008 PSLC Level B, 50 MSU 176 or more 0009 PSLC Level C, 1 MSU 0010 PSLC Level C, 10 MSU 0011 PSLC Level C, 50 MSU NA 0012 PSLC N/C ID
Single Byte Languages Feature Environment Number Distribution Medium OS/390 5801 9/6250 bpi magnetic tape OS/390 5802 3480 cartridge OS/390 6010 4-mm DAT
Example: If publications are not desired for the initial order, specify feature number 3470 to ship media only. For future updates, specify feature number 3480 to ship media updates only. If, in the future, publication updates are required, order an MES to remove feature number 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 Solutions (SDS) receives the order. SDS will then ship the order via overnight air transportation.
Unlicensed Documentation: For the MQSeries Workflow for OS/390 server, the following documentation will be available. A memo and one copy of the following publications are supplied automatically with the basic machine-readable material:
Order Title Number MQSeries Workflow for OS/390: Program Directory GI10-0483 Licensed Programming Specifications GC33-7029 Customization and Administration SC33-7030 Programming SC33-7031 Messages and Codes SC33-7032
General information about MQSeries Workflow for OS/390 is available under various topics on the MQSeries Workflow Web pages. For more information visit the following URL:
Additional copies of unlicensed publications will be available for a fee after availability. These copies may be ordered through the System Library Subscription Service (SLSS) or by direct order.
Additional softcopy documentation is available on CD-ROM, containing the IBM MQSeries Workflow for OS/390 Version 3 publications for all national language versions supported.
Displayable Softcopy Documentation: These manuals are available as part of the basic machine-readable material and can be displayed with an HTML browser or with Adobe Acrobat Reader. The manuals are stored as HTML and PDF files on a CD-ROM dedicated to softcopy documentation, which is shipped in the program package. Translations in national languages are included as well.
The files can also be used with an HTML browser or with an Adobe Acrobat Reader, respectively, to create unmodified printed copies of these manuals. Terms and conditions for use of the machine-readable files are shipped with the files.
Subsequent updates (technical newsletters or revisions between releases) to the publications shipped with the product will be distributed to the user of record for as long as a license for this software remains in effect. A separate publication order or subscription is not needed.
Optional Publications: The following hardcopy publications had been created originally for the workstation program. They are available separately and can be ordered optionally for a charge. To order, contact your IBM Business Partner or IBM representative.
Form Number Title (English Only) IBM MQSeries Workflow Version 3.1: Concepts and Architecture (Introduction) GH12-6285 Getting Started with Buildtime SH12-6286 Getting Started with Runtime SH12-6287 Installation Guide SH12-6288 Administration Guide SH12-6289 Programming Guide SH12-6291
Terms and Conditions
Single Version Replacement Charging Replaced Program Program Applies IBM MQSeries To a N/A Workflow follow-on, for OS/390 if any (5655-A96)
Call Now to Order
To order, contact the IBM North America Sales Centers, your local IBM representative, or your IBM Business Partner.
IBM North America Sales Centers, our national direct marketing organization, can add your name to the mailing list for catalogs of IBM products.
Phone: 800-IBM-CALL Fax: 800-2IBM-FAX Internet: firstname.lastname@example.org Mail: IBM North America Sales Centers Dept. LE001 P.O. Box 2690 Atlanta, GA 30301-2690 Reference: LE001
To identify your local IBM Business Partner or IBM representative, call 800-IBM-4YOU.
Note: Shipments will begin after the planned availability date.