ibm.com/redbooks

WebSphere MQ in a z/OS Parallel Sysplex Environment

Eugene DeborinJeremy AccoratAndrew Barrett

Ulrike BurgholzerCheryll Clark

Peter KleinGudrun Vetter

Frances Williams

Learn how WebSphere MQ makes use of z/OS Quality of Service features

Provide a high-availability environment for your message-driven applications

Develop modern message-driven CICS Java applications

Front cover

WebSphere MQ in a z/OS Parallel Sysplex Environment

October 2002

International Technical Support Organization

SG24-6864-00

Copyright International Business Machines Corporation 2002. All rights reserved.Note to U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP ScheduleContract with IBM Corp.

First Edition (October 2002)

This edition applies to Version 5, Release 3 of WebSphere MQ for z/OS (product number 5655-F10).

Note: Before using this information and the product it supports, read the information in Notices on page xi.

Contents

Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiTrademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiiiThe team that wrote this redbook. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiiiBecome a published author . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvComments welcome. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi

Part 1. WebSphere MQ for z/OS environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Chapter 1. Business integration using WebSphere MQ . . . . . . . . . . . . . . . 31.1 Meeting the business challenge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41.2 High availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81.3 High capacity and workload balancing . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91.4 Easier system administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Chapter 2. Overview of Parallel Sysplex Technologies . . . . . . . . . . . . . . . 132.1 Parallel Sysplex definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

2.1.1 Hardware. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142.1.2 Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182.1.3 SYS1.PARMLIB members used for sysplex setup . . . . . . . . . . . . . . 192.1.4 Couple data sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202.1.5 Signaling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242.1.6 Structures within the coupling facility . . . . . . . . . . . . . . . . . . . . . . . . 272.1.7 Coupling Facility Resource Management (CFRM) . . . . . . . . . . . . . . 302.1.8 Sysplex Failure Management (SFM). . . . . . . . . . . . . . . . . . . . . . . . . 302.1.9 Automatic Restart Manager (ARM) . . . . . . . . . . . . . . . . . . . . . . . . . . 312.1.10 Workload Manager (WLM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312.1.11 MVS System Logger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322.1.12 Global Resource Serialization (GRS) . . . . . . . . . . . . . . . . . . . . . . . 322.1.13 Shared HFS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

2.2 Advantages of a Parallel Sysplex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372.3 DB2 data-sharing group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

2.3.1 DB2 data-sharing overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382.3.2 Using a DB2 data-sharing group . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

2.4 Advantages of DB2 data sharing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Chapter 3. z/OS Resource Recovery Services (RRS). . . . . . . . . . . . . . . . . 433.1 Concepts and terminology. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Copyright IBM Corp. 2002. All rights reserved. iii

3.1.1 Transaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443.1.2 Unit of work and unit of recovery (UR) . . . . . . . . . . . . . . . . . . . . . . . 443.1.3 Commit and backout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453.1.4 Resource managers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463.1.5 Syncpoint coordination . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

3.2 RRS overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493.3 Setting up and running RRS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

3.3.1 Log stream definition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503.3.2 RRS subsystem definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 543.3.3 RRS access authorization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 553.3.4 Starting and stopping RRS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 553.3.5 ISPF screens for RRS administration . . . . . . . . . . . . . . . . . . . . . . . . 56

3.4 Programming with RRS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583.4.1 RRS services and API. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583.4.2 WebSphere MQ RRS adapters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583.4.3 WebSphere MQ and DB2 stored procedures using RRS . . . . . . . . . 593.4.4 Migrating existing applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

3.5 Test scenarios for MQ applications using RRS. . . . . . . . . . . . . . . . . . . . . 613.5.1 Scenario 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 623.5.2 Scenario 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 643.5.3 Failing scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

3.6 A final word . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

Chapter 4. Automatic Restart Manager (ARM) . . . . . . . . . . . . . . . . . . . . . . 694.1 ARM overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 704.2 Set up the ARM environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

4.2.1 ARM couple data set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 704.2.2 ARM policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 714.2.3 ARM services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 734.2.4 XCF authority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 744.2.5 ARM exits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 744.2.6 Summary of ARM components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

4.3 Displaying ARM status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 754.4 Using ARM with WebSphere MQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

4.4.1 ARM restart on the same image . . . . . . . . . . . . . . . . . . . . . . . . . . . . 804.4.2 ARM restart (LU6.2 listener) on a different image. . . . . . . . . . . . . . . 814.4.3 ARM restart (TCP listener) on a different image . . . . . . . . . . . . . . . . 83

Chapter 5. Sysplex Distributor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 875.1 What is Sysplex Distributor? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 885.2 What are VIPA and DVIPA? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 895.3 VIPA takeover and takeback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 905.4 Workload management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

iv WebSphere MQ in a z/OS Parallel Sysplex Environment

5.5 Sysplex Distributor functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 945.6 Implementation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 965.7 Our test network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

Part 2. Advanced features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101

Chapter 6. WebSphere MQ for z/OS latest enhancements . . . . . . . . . . . 1036.1 Shared queues and queue-sharing groups . . . . . . . . . . . . . . . . . . . . . . . 104

6.1.1 Introduction of shared queue support . . . . . . . . . . . . . . . . . . . . . . . 1046.2 Shared channels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1056.3 Programming applications with shared queues. . . . . . . . . . . . . . . . . . .