Sei sulla pagina 1di 484
Front cover WebSphere MQ Integrator Deployment and Migration Geert Van de Putte Chris Griego Brian

Front cover

Front cover WebSphere MQ Integrator Deployment and Migration Geert Van de Putte Chris Griego Brian McCarty

WebSphere MQ Integrator Deployment and Migration

Geert Van de Putte Chris Griego Brian McCarty Peter Toogood Ralf Ziegler
Geert Van de Putte
Chris Griego
Brian McCarty
Peter Toogood
Ralf Ziegler
Chris Griego Brian McCarty Peter Toogood Ralf Ziegler Migration possibilities for brokers and NEON-based message

Migration possibilities for brokers and NEON-based message flows

possibilities for brokers and NEON-based message flows Multi-broker and multi-platform configuration scenarios New

Multi-broker and multi-platform configuration scenarios

Multi-broker and multi-platform configuration scenarios New features, including enhanced MRM and Java nodes ibm.com

New features, including enhanced MRM and Java nodes

ibm.com/redbooks

and multi-platform configuration scenarios New features, including enhanced MRM and Java nodes ibm.com /redbooks
and multi-platform configuration scenarios New features, including enhanced MRM and Java nodes ibm.com /redbooks
International Technical Support Organization WebSphere MQ Integrator Deployment and Migration April 2002 SG24-6509-00

International Technical Support Organization

WebSphere MQ Integrator Deployment and Migration

April 2002

SG24-6509-00

Take Note! Before using this information and the product it supports, be sure to read the general information in “Notices” on page ix.

First Edition (April 2002)

This edition applies to Version 2, Release 1 of WebSphere MQ Integrator, for use with Windows NT Version 4, Windows 2000, AIX and Sun Solaris, Program Numbers 5724-A82-00, 5724-A82-01 and 5724-A82-02.

Comments may be addressed to:

IBM Corporation, International Technical Support Organization Dept. HZ8 Building 662 P.O. Box 12195 Research Triangle Park, NC 27709-2195

When you send information to IBM, you grant IBM a non-exclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you.

© Copyright International Business Machines Corporation 2002. All rights reserved. Note to U.S Government Users – Documentation related to restricted rights – Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corp.

Contents

Notices

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.ix

Trademarks

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

x

. The team that wrote this

Preface

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.xi

.xi

Comments

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

xii

Chapter 1.

 

WebSphere MQ Integrator features overview

.

.

.

.

.

.

.

.

.

.

.

.

.

.

1

1.1 WebSphere MQ Integrator basics

 

2

1.1.1 Architecture of WebSphere MQ Integrator

 

4

1.1.2 The role of the Configuration Manager

 

5

1.1.3 The functionality of the

 

7

1.1.4 Publish/subscribe and the User Name Server

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

10

1.1.5 The user interface: the Control Center

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

11

1.2 Anatomy of a message flow

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

13

1.3 Enhanced Message Repository Manager

 

18

1.4 XML support

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

22

1.5 Database support

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

23

1.6 New

ESQL

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

24

1.7 Summary

of new features

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

25

Chapter 2.

 

Migration considerations

 

27

2.1 Considerations overview

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

28

2.2 Uninstalling the older version

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

28

2.3 Message repository changes

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

29

2.4 Moving components

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

30

2.5 Enhancement and schedule considerations

 

31

2.6 DB2 database upgrade

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

33

2.7 Recommendations

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

34

Chapter 3. Migration of an MQSeries Integrator environment

 

37

3.1 Evolution of the MQSeries Integrator environment

 

38

3.2 The original

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

39

3.3 Adding a new broker .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

44

3.4 Adding a new application

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

60

3.5 Adding a new broker using WebSphere MQ Integrator V2.1

 

77

3.6 Introducing a V2.1 Configuration Manager

 

92

3.7 Using a V2.0.2 broker with a V2.1.0 Configuration Manager

 

105

3.8 Product upgrade on AIX1, NT1 and NT2

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 108

 

3.8.1 Upgrade on

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 109

3.8.2 Upgrade on NT1

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

116

3.8.3 Upgrade on NT2

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

123

3.9

Consolidating Configuration Managers

 

128

Chapter 4. Deploying a broker on Sun Solaris using Oracle 8i

 

131

Introduction

4.1 .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 132

4.2 Getting

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 132

4.3 Software installation

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

133

4.4 Creating and configuring the broker

 

138

 

4.4.1 Connecting the broker’s queue managers and the Configuration

 

Manager

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 138

4.4.2 Configuring XA support

 

.

.

.

.

.

.

.

.

.

.

.

.

.

. 139

4.4.3 Verification of the installation

 

141

Chapter 5. Deploying a broker on Windows 2000 using SQL Server

 

143

5.1 Why install on SQL Server?

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

144

5.2 Getting

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 144

5.3 Installation of SQL Server 7.0 SP2

 

145

5.4 Installing a WebSphere MQ Integrator

 

153

 

5.4.1 Broker only installation

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

153

5.4.2 Using the SQLServer broker

 

157

5.4.3 Verification of the installation

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

162

Chapter 6.

New MRM features explored

 

163

6.1 Converting a delimited message to

 

164

 

6.1.1 Creating a new message

 

165

6.1.2 Adding the physical formats to the message

 

168

6.1.3 Creating message elements and

 

170

6.1.4 Creating a message using the compound

 

176

6.2 Creating a message flow to convert CSV to XML

 

179

 

6.2.1 Configuring the MQInput node

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 179

6.2.2 Configuring the Compute node

 

180

6.3 Deploying the message set and

 

184

6.4 Testing the message flow

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 186

6.5 Changing XML names in the output

 

187

6.6 Converting a tagged message to XML

 

191

 

6.6.1 Configuring a message set for tagged data

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 191

6.6.2 Testing the transformation of a tagged message

.

.

.

.

.

.

.

.

.

.

.

.

.

. 195

6.7 Using the debugger to examine the message tree

 

198

 

6.7.1

Importing the Web materials message sets and flows

 

203

Chapter 7.

Exploring the new XML features

 

205

7.1

Importing an XML DTD and using it in a flow

 

206

7.1.1 Creating a DTD .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 206

7.1.2 Creating the message set and adding an XML format

 

208

7.1.3 Importing the

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

208

7.1.4 Examining the imported message set definitions

 

212

7.1.5 Correcting some of the XML names

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 215

7.2 Using the message set in a flow

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 218

7.2.1 Configuring the Compute node

 

218

7.2.2 Testing the message flow

 

.

.

.

.

.

.

.

.

.

.

.

.

.

. 221

7.2.3 Modifying the message in the Compute

 

222

7.2.4 Problem solving with this flow

 

223

7.2.5 Some possible errors

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

227

7.3 Some more advanced features

 

229

7.3.1 Processing multiple persons in a single message

 

.

.

.

.

.

.

.

.

.

.

.

.

. 229

7.3.2 Using generic XML

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 232

7.3.3 Using ESQL reference

 

233

7.3.4 Importing the Web materials message set and flows

.

.

.

.

.

.

.

.

.

.

. 236

Chapter 8. Migration of solutions based on New Era Of Networks

 
 

functionality.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 237

8.1 New Era Of Networks

 

238

8.1.1 MQSeries Integrator V1.0 and V1.1

 

239

8.1.2 MQSeries Integrator V2.0 and V2.0.1

 

240

8.1.3 MQSeries Integrator V2.0.2

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 240

8.1.4 WebSphere MQ Integrator

 

241

8.2 Summary of changes

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

242

8.2.1

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

242

8.2.2

Environment

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

243

8.2.3

Functionality

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 246

8.3 Migration of the New Era Of Networks environment

 

249

8.3.1 Migration steps

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

250

8.3.2 Example migration from MQSeries Integrator to WebSphere MQ

 
 

Integrator

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

264

8.4 Working on New Era Of Networks messages

 

289

8.4.1 Scenario 1: A simple reformat procedure

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 291

8.4.2 Scenario 2: Exploiting WebSphere MQ Integrator functionality for