Software Announcement 299-008
January 26, 1999

IBM MQSeries Workflow for OS/390 Expands Business Integration to S/390 Platform

 ENUS299-008.PDF (39KB)


At a Glance

MQSeries Workflow for OS/390:

  • Provides high scalability, workload balancing, easy integration of existing critical mainframe applications, cross-platform integration of users and applications, and a graphical definition of processes.
  • Is the workflow server of choice for the support of enterprise-wide workflow for large enterprises, based on DB2 for reliable storage of process information and MQSeries for guaranteed once-only delivery of process information. It specifically aims at large users that may have many branches across the world and thousands of workflow clients participating in the enterprise workflow.
  • Will save resources during process execution with its single point of control and transaction safety, when processes are built on 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 info@isource.ibm.com with the word SUBSCRIBE in the body.

Overview

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.

Key Prerequisites

  • OS/390 Version 2 Release 5 (and above)
  • IBM MQSeries for OS/390 Version 2 Release 1
  • IBM MQSeries for OS/390 Version 2 Client Attachment Feature
  • IBM DB2® for OS/390 Version 5 Release 1

Planned Availability Date

March 26, 1999

Description

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.

Workflow Servers

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:

  • Data proximity, reducing network traffic
  • Workload management of MQ™-driven work
  • Extending transactions to include multiple applications
  • Scalability and availability of the Parallel Sysplex®
  • Reliability, integrity, and security

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.

Administration Interface

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:

  • Process input and output data to and from applications (container API)
  • Start, monitor, and control workflow processes (process API)
  • Handle worklists (worklist API)

The APIs support the following languages:

  • IBM COBOL for OS/390 & VM Version 2 Release 1
  • IBM C for OS/390 Version 2 Release 4

Year 2000

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.

Product Positioning

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:

  • U.S. English
  • French
  • German
  • Italian
  • Spanish
  • National Portuguese
  • Brazilian Portuguese
  • Japanese
  • Korean
  • Simplified Chinese
  • Traditional Chinese
  • Dutch
  • Danish
  • Polish
  • Finnish
  • Norwegian
  • Turkish
  • Hungarian
  • Swedish
  • Hebrew

Hardware and Software Support Services

SmoothStart™/Installation Services: IBM SmoothStart and Installation Services are not provided.

Reference Information

For the initial announcement of IBM MQSeries Workflow Version 3 Release 1, refer to Software Announcement 298-270 , dated July 28, 1998.

Trademarks

 
IMS, MQ, and SmoothStart are trademarks of International Business Machines Corporation in the United States or other countries or both.
 
MQSeries, OS/390, CICS, DB2, S/390, System/390, and Parallel Sysplex are registered trademarks of International Business Machines Corporation in the United States or other countries or both.
 
Windows is a trademark of Microsoft Corporation.
 
Windows NT is a registered trademark of Microsoft Corporation.
 
Other company, product, and service names may be trademarks or service marks of others.

Details on the MQSeries® Workflow for OS/390® APIs

MQSeries Workflow provides its APIs to run in the following environments:

  • OS/390 native
  • OS/390 CICS®
  • OS/390 IMS™

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.

  1. An MQSeries Workflow for OS/390 server cooperates with an MQSeries Workflow 3.1.2 client on any workstation platform supported by MQSeries Workflow 3.1.2. In addition, the installed MQSeries version must support the communication between the chosen client workstation platform and the OS/390 server. If the client and the OS/390 server are running different code pages, an OS/390 PTF with an appropriate code page conversion table must be installed. MQSeries Workflow clients on lower program levels than 3.1.2 cannot cooperate with an MQSeries Workflow 3.1 server.
  2. An OS/390 application that uses the MQSeries Workflow runtime API can use only an MQSeries Workflow for OS/390 server as the target for its API calls. It cannot use an MQSeries Workflow server on a workstation platform.
  3. An MQSeries Workflow server on a workstation cannot communicate with an MQSeries Workflow for OS/390 Program Execution server.
  4. The Administration Utility provided by MQSeries Workflow on the workstation platforms cannot be used to administer an MQSeries Workflow for OS/390 server. To achieve this purpose MQSeries Workflow for OS/390 offers its own set of operator control commands.
  5. The MQSeries Workflow 3.1.2 buildtime component on a workstation can be used to create workflow process models that are intended to run on an OS/390 platform. After the models have been created the user can export them on the workstation, send them, for example via file transfer, to an OS/390 system, and import them to an MQSeries Workflow runtime database.

Technical Information

Specified Operating Environment

Hardware Requirements

Buildtime Environment: A personal computer with Intel-based processor architecture is required (for example, Pentium™ 200 MHz). Recommended screen resolution is 1024 x 768.

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 Server Environment: A computer capable of running the OS/390 operating system.

Runtime Client Environment: For technical details, refer to Software Announcement 298-270 , dated July 28, 1998 (IBM MQSeries Workflow Version 3 Release 1).

Software Requirements

Buildtime Environment

  • Microsoft™ Windows NT Workstation V4.0 (with Service Pack 3) or Windows 95 (with Service Pack 1 or OSR2).
  • Buildtime Database: IBM DB2 Universal Database® Enterprise Edition for Windows NT Version 5, or IBM DB2 Universal Database Personal Edition for Windows 95 Version 5, or Microsoft JetEngine. (Workstation databases are included in IBM MQSeries Workflow for OS/390 V3.1.)

Runtime Server Environment

Operating System

  • OS/390 Version 2.5 or
  • OS/390 Version 2.6 to use the OS/390 workload manager capabilities
  • MQSeries Version 2.1
  • MQSeries Version 2.1 Client Attachment Feature (JMQ2107)
  • DB2 Universal Database for OS/390 Enterprise Edition Version 5.1.1

For the development of programs using the Workflow APIs and running on the OS/390 operating system, one of:

  • IBM COBOL for OS/390 & VM Version 2.1
  • IBM C for OS/390 Version 2.4

To use the non-transactional EXCI:

  • CICS Transaction Server for OS/390 Version 1.2 or CICS/ESA® Version 4
  • The CICS interregion communication program DFHIRP

To use the transactional EXCI (for safe applications):

  • CICS Transaction Server for OS/390 Version 1.3
  • The CICS interregion communication program DFHIRP

To use the CPIC:

  • IMS Version 5.1 or later
  • IMS Version 6 or later, if you want to support safe applications

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:

Planning Information

Direct Customer Support: For initial information, 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:

  • MQSeries Workflow for OS/390 Server program code on tape, cartridge, or 4-mm DAT
  • One CD-ROM containing the IBM MQSeries Workflow V3.1 program code for all national language versions supported
  • One CD-ROM containing the IBM MQSeries Workflow V3.1 softcopy documentation for all national language versions supported
  • Four CD-ROMs containing the IBM MQSeries Version 5 program code
  • One Proof of Entitlement for two MQSeries Workflow server Capacity Units
  • One Proof of Entitlement for one MQSeries Workflow Registered User
  • Seven CD-ROMs containing the IBM DB2 Universal Database Version 5 program code

System Integrity

IBM will accept APARs where the installation of this licensed program causes an exposure to the system integrity of OS/390.

OS/390 System Integrity Applies: Yes

Security, Auditability, and Control

The security and auditability features are:

  • Access to MQSeries Workflow program and data files is protected via local operating system security mechanisms.
  • User authentication is provided by means of an MQSeries Workflow user ID and password. Passwords are not transmitted over the line, neither at user logon nor when users change their passwords. No clear text password is stored in the MQSeries Workflow server databases.
  • OS/390 Security Server is used via SAF interface for program execution.
  • DB2® security applies for access control to MQSeries Workflow databases.
  • MQSeries security applies for access control to MQSeries Workflow queues.
  • Users must be authorized via FDL and/or MQSeries Workflow Buildtime to access MQSeries Workflow resources, such as processes, and to administer the system.
  • Auditing is provided via operating system security logs and a Workflow/390 audit log.

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

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:

New Licensees

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

Basic Machine-Readable Material: To order, select the feature number of the desired distribution medium:

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

Customization Options: Select the appropriate feature numbers to customize your order to specify the 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 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.

  • Concepts and Architecture
  • Getting Started with Buildtime
  • Getting Started with Runtime
  • Installation Guide
  • Administration Guide
  • Programming Guide

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

Agreement: IBM Customer Agreement

Designated Machine: Not required

Variable Charges Apply: No

Indexed Monthly License Charge (IMLC) Applies: No

Location License Applies: No

Use Limitation Applies: No

Educational Allowance Available: Yes, to qualified education customers

Volume Orders: Not applicable

Version-to-Version Upgrade Credits Apply: Yes

                                             Single
                                            Version
                         Replacement        Charging
Replaced Program         Program            Applies
 
IBM MQSeries             To a                 N/A
 Workflow                 follow-on,
 for OS/390               if any
 (5655-A96)

Warranty Applies: Yes

Licensed Program Materials Availability

  • Restricted Materials of IBM: Some
  • Non-Restricted Source Materials: Some
  • Object Code Only (OCO): Some
    • Publication that Identifies OCO Components: GI10-0483
    • Availability Date: March 26, 1998

Testing Period: Two months (Basic License only)

Support Line: S/390®

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

Trademarks

 
IMS is a trademark of International Business Machines Corporation in the United States or other countries or both.
 
MQSeries, OS/390, CICS, DB2 Universal Database, CICS/ESA, DB2, Parallel Sysplex, and S/390 are registered trademarks of International Business Machines Corporation in the United States or other countries or both.
 
Pentium is a trademark of Intel Corporation.
 
Windows and Microsoft are trademarks of Microsoft Corporation.
 
Windows NT is a registered trademark of Microsoft Corporation.
 
Other company, product, and service names may be trademarks or service marks of others.