`
`MQSeries Integrator
`
`Using the Control Center
`Version 2 Release 0
`
`IBM
`
`
`
`
`
`
`SC34-5602-00
`
`HP_1022_0001
`
`

`

`
`
`HP_1022_0002
`
`HP_1022_0002
`
`

`

`MQSeries Integrator
`
`Using the Control Center
`Version 2 Release 0
`
`IBM
`
`
`
`
`
`
`SC34-5602-00
`
`HP_1022_0003
`
`

`

` Note!
`
`Before using this information and the product it supports, be sure to read the general information under Appendix E, “Notices”
`on page 313.
`
`
`
`
`
`
`First edition (March 2000)
`
`This edition applies to IBM MQSeries Integrator Version 2 Release 0 and to all subsequent releases and modifications until otherwise
`indicated in new editions.
`
` Copyright International Business Machines Corporation 2000. All rights reserved.
`US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
`
`HP_1022_0004
`
`

`

`
`
`
` Contents
`
`+
`
`Contents
`
`About this book
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Who this book is for .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`What you need to know to understand this book .
`Terms used in this book
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Where to find more information .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`MQSeries Integrator publications
`.
`.
`.
`.
`.
`.
`.
`.
`MQSeries information available on the Internet
`
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`
`. xi
`. xi
`. xi
`. xi
`. xii
`. xii
`. xii
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`Part 1.
`
`Introducing the Control Center
`
`.
`
`.
`
`.
`
`. 1
`
`Chapter 1. Control Center concepts
`. 3
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Working with configuration data .
`. 3
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`The workspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
`. 5
`Monitoring the broker domain .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`Chapter 2. Getting started with the Control Center
`. 7
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`. 7
`Before you start
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`. 7
`Starting the Control Center .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`. 9
`Managing permissions to Control Center tasks .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
` 12
`Performing workspace tasks .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
` 15
`Naming Control Center resources .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Problem determination . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
`
`Part 2. Using the Control Center
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`. 17
`
`+
`+
`
`Chapter 3. Defining messages . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
`Basic message concepts .
` 21
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Working with messages in the XML domain .
` 25
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
` 31
`Working with messages in the MRM domain .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`Chapter 4. Defining message flows .
` 67
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
` 67
`Authorization to work with message flows .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
` 67
`The Message Flows view .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
` 69
`Creating a message flow .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
` 73
`Creating a message flow category
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Adding a message flow to your workspace
` 74
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
` 76
`Including one message flow in another .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
` 77
`Promoting message flow node properties
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Checking in message flows
` 81
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
` 82
`Creating your own message nodes .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
` 83
`The IBM Primitives
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Check node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
`Compute node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
`Database node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
`DataDelete node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
`DataInsert node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
`DataUpdate node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
`Extract node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
`Filter node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
`
` Copyright IBM Corp. 2000
`
`
`
`iii
`
`HP_1022_0005
`
`

`

`Contents
`
`
`
`
`
`
`MQInput node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
`MQOutput node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
`MQReply node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
`NEONFormatter node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
`NEONRules node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
`Publication node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
`ResetContentDescriptor node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
`Throw node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
`Trace node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
`TryCatch node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
`Warehouse node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
`. 137
`Using the IBM-supplied message flows
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`Chapter 5. Defining the broker topology .
`. 141
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`. 141
`Authorization to work with Topology
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`The Topology view .
`. 141
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`. 143
`Checking out the Topology .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`. 144
`Creating a broker
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`. 146
`Creating a collective
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`. 148
`Adding an existing broker to a collective .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`. 150
`Creating a broker to add to a collective
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`. 151
`Removing a broker from a collective .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Connecting brokers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
`. 153
`Deleting the connection between brokers
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Deleting a broker
`. 154
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Renaming a broker
`. 155
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`. 156
`Checking in the Topology
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Making changes operational
`. 157
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`
`Chapter 6. Assigning resources to a broker
`Authorization to assign resources to a broker
`.
`The Assignments view .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Creating an execution group .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Assigning message flows to execution groups
`Assigning message sets to brokers .
`.
`.
`.
`.
`.
`Removing resources from a broker
`.
`.
`.
`.
`.
`.
`Checking in the Assignments
`.
`.
`.
`.
`.
`.
`.
`.
`Making changes operational
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`
`.
`.
`
`.
`
`Chapter 7. Deploying configuration data .
`.
`Three types of deployment
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`The stages of the deployment process .
`.
`.
`.
`.
`Which data is deployed? .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Finding out whether deployment has worked .
`Deleting a broker from the system .
`.
`.
`.
`.
`.
`.
`Authorization to deploy configuration data .
`.
`.
`Deploying delta assignments
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Deploying complete assignments .
`.
`.
`.
`.
`.
`.
`.
`Deploying delta topics
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Deploying complete topics .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Deploying delta topology .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Deploying complete topology
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Deploying delta data of all types
`.
`.
`.
`.
`.
`.
`.
`.
`Deploying complete data of all types .
`.
`.
`.
`.
`.
`
`iv MQSeries Integrator V2.0 Using the Control Center
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`. 159
`. 159
`. 159
`. 161
`. 162
`. 165
`. 167
`. 169
`. 171
`
`. 173
`. 173
`. 174
`. 175
`. 175
`. 176
`. 177
`. 178
`. 179
`. 180
`. 181
`. 182
`. 183
`. 184
`. 185
`
`
`
`HP_1022_0006
`
`

`

`
`
`
`#
`
`Contents
`
`Forcing deployment of all data
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`. 186
`
`Chapter 8. Setting up publish/subscribe access control
`. 187
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Authorization to set up publish/subscribe access control
`. 187
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`The Topics view .
`. 187
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Creating topics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
`Adding a principal to an ACL
`. 191
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Checking in topics data .
`. 192
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Making changes operational
`. 193
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`
`Chapter 9. Running the broker domain .
`. 195
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`. 195
`Authorization to run the broker domain .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`The Operations and Log views
`. 195
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`. 198
`Monitoring the operational state of the broker domain .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`. 199
`Starting message flows .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Stopping message flows .
`. 201
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`. 203
`Starting user tracing .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`. 204
`Stopping user tracing .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`. 205
`The Subscriptions view .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Deleting subscriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
`
`
`
`Contents v
`
`HP_1022_0007
`
`

`

`Contents
`
`
`
`
`
`
`Part 3. Appendixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
`
`#
`#
`#
`#
`#
`#
`#
`
`+
`+
`
`+
`
`.
`
`Appendix A. A example scenario .
`. 211
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`The receipt message as an XML message
`. 212
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`. 213
`Defining the message in the message repository .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Assigning the message set to the broker
`. 220
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Message flows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
`Assigning message flows to the execution group .
`. 232
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Deploying the configuration
`. 233
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`Appendix B. C and COBOL default mappings
`Mapping C datatypes to MRM datatypes .
`.
`.
`.
`.
`Mapping COBOL datatypes to MRM datatypes .
`
`.
`.
`
`.
`.
`.
`
`.
`.
`.
`
`.
`.
`.
`
`.
`.
`.
`
`.
`.
`.
`
`.
`.
`.
`
`.
`.
`.
`
`.
`.
`.
`
`.
`.
`.
`
`.
`.
`.
`
`.
`.
`.
`
`.
`.
`.
`
`.
`.
`.
`
`.
`.
`.
`
`.
`.
`.
`
`.
`.
`.
`
`. 235
`. 235
`. 237
`
`Appendix C. SQL reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
`Basic message structure .
`. 243
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`A simple filter
`. 245
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Data types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
`Predicates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
`Other sorts of expression
`. 251
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Symbolic constants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
`Optional fields and NULLs .
`. 256
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Repeating fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
`Field references . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
`Compute node SQL .
`. 263
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`. 266
`More complicated SELECTs: ROWs and LISTs
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Querying external databases
`. 272
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Database node statements .
`. 275
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Function reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
`Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
`Examples for generic XML messages
`. 293
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`. 300
`Exception and destination list structure .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`Appendix D. NEON Rules and Formatter .
`. 307
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`. 307
`NEONFormatter and NEONRules nodes .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`. 307
`NEON formatter and rules engine .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`. 307
`Combining NEON rules with MQSeries Integrator
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`NEON subscriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
`
`.
`.
`.
`
`Appendix E. Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313
`Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
`
`Glossary of terms and abbreviations .
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`.
`
`. 317
`
`Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
`
`vi MQSeries Integrator V2.0 Using the Control Center
`
`
`
`HP_1022_0008
`
`

`

`
`
`
` Figures
`
`Figures
`
`1. The role of the Control Center in the broker domain
`.
`.
`.
`.
`.
`.
`.
`.
`2. The Control Center
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`3. Setting the user role .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`4. The New icon and the Key icon
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`5. A message tree structure .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`6. The components of a message
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`7. The Message Sets view
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`8. The Create a new Message Set dialog .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`9. The Create a new Element dialog .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`10. Create a new Compound Type using the SmartGuide
`.
`.
`.
`.
`.
`.
`.
`.
`11. The Message Flows view .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`12. Dragging message flow nodes into the Message Flow Definition pane
`13. A message flow showing connections between terminals
`.
`.
`.
`.
`.
`.
`.
`.
`14. Add an existing Message Flow dialog .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`15. The Promote Attribute dialog .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`16. The Check dialog
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`17. The Compute dialog .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`18. The Database dialog
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`19. The DataDelete dialog
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`20. The DataInsert dialog
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`21. The DataUpdate dialog
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`22. The Extract dialog
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`23. The Filter dialog
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`24. The MQInput dialog
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`25. The MQOutput dialog
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`26. The MQReply dialog .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`27. The NEONFormatter dialog
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`28. The NEONRules dialog
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`29. The Publication dialog .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`30. The ResetContentDescriptor dialog
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`31. The Throw dialog
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`32. The Trace dialog .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`33. The TryCatch dialog .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`34. The Warehouse dialog
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`35. The Topology view
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`36. Create a new Broker dialog
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`37. Create a new Collective dialog .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`38. Add an existing Broker dialog
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`39. The Assignments view
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`40. The Add an existing Message Flow dialog .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`41. The Add an existing Message Set dialog .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`42. The Topics view .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`43. The Operations view
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`44. The Log view .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`45. The Subscriptions view .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`46. Scenario message flow .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`47. XML message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
`48. The message set properties, showing the identifier.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`49. The receipt message extended with an MQRFH2 header.
`.
`.
`.
`.
`.
`.
`.
`.
`50.
`Input node properties
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`. 6
`. 9
` 12
` 15
` 22
` 35
` 43
` 44
` 48
` 54
` 68
` 70
` 71
` 74
` 78
` 85
` 87
` 91
` 94
` 97
` 100
` 103
` 105
` 110
` 114
` 116
` 118
` 120
` 122
` 124
` 127
` 129
` 130
` 134
` 142
` 144
` 146
` 148
` 160
` 162
` 165
` 187
` 196
` 197
` 205
` 211
`212
` 218
` 219
` 220
`
`
`
`vii
`
`.
`
`.
`
`+
`
`#
`#
`#
`#
`#
`
` Copyright IBM Corp. 2000
`
`HP_1022_0009
`
`

`

`Figures
`
`#
`#
`#
`#
`#
`#
`#
`#
`+
`#
`
`+
`+
`+
`
`51. Audit message flow .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`52. Check node properties
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`53. Warehouse node properties
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`54. Finance message flow
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`55. Extract node properties
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`56. Trace node properties .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`57. Stock message flow .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`58. Partner message flow .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`59. Filter node properties
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`60. Data Insert node properties
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`61. Repeating fields in a message .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`62. Message and destination list for an exception
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`63. Exception list structure
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`64. Retrieving the exception error code
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`65. Message flow that replicates MQSeries Integrator V1 functionality
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`
`
`
`
`
` 221
` 222
` 223
` 224
` 225
` 226
` 227
` 230
` 231
` 232
` 257
` 303
` 305
` 306
` 311
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`
`.
`.
`
`.
`.
`.
`.
`.
`.
`
`viii MQSeries Integrator V2.0 Using the Control Center
`
`
`
`HP_1022_0010
`
`

`

`
`
`
` Tables
`
`+
`+
`
`Tables
`
`.
`
`.
`.
`.
`
`1. Editing relationships and properties: check-out requirements
`.
`.
`.
`.
`.
`.
`2. The IBM Primitives
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`3. Check node terminals
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`4. Compute node terminals
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`5. Database node terminals
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`6. DataDelete node terminals
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`7. DataInsert node terminals
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`8. DataUpdate node terminals
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`9. Extract node terminals
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`10. Filter node terminals .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`11. MQInput node terminals
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`12. MQOutput node terminals
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`13. MQReply node terminals
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`14. NEONFormatter node terminals
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`15. NEONRules node terminals
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`16. Publication node terminals
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`17. ResetContentDescriptor node terminals
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`18. Throw node terminals
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`19. Trace node terminals
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`20. TryCatch node terminals
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`21. Warehouse node terminals
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`22. Deployment summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
`23. C datatypes and their default settings in the MRM .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`24. COBOL datatypes and their default settings in the MRM .
`.
`.
`.
`.
`.
`.
`.
`.
`25. Format of interval strings and qualifiers .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`26. Supported CASTs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
`27. Procedures for implementing message flows with NEON nodes
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`.
`.
`.
`
` 61
` 83
` 84
` 86
` 90
` 93
` 96
` 99
` 102
` 104
` 107
` 112
` 115
` 117
` 119
` 121
` 123
` 126
` 128
` 130
` 132
`174
` 236
` 238
` 248
`279
` 309
`
` Copyright IBM Corp. 2000
`
`
`
`ix
`
`HP_1022_0011
`
`

`

`Tables
`
`
`
`
`
`
`x MQSeries Integrator V2.0 Using the Control Center
`
`
`
`HP_1022_0012
`
`

`

`
`
`
`About this book
`
`About this book
`
`#
`#
`
`+
`
`This book describes how to use the MQSeries Integrator Version 2 Release 0
`Control Center.
`
`Changes for the first refresh of this book, issued after it was included on the
`MQSeries Integrator V2.0 product CD-ROM, are marked with the # character.
`
`Changes for the second refresh of this book are marked with the + character.
`
`Who this book is for
`This book is intended for anyone who needs to use the Control Center to perform
`these tasks:
`(cid:1) Defining messages and message sets
`(cid:1) Defining message flows
`(cid:1) Defining and managing the broker topology
`(cid:1) Setting up publish/subscribe access control
`
`What you need to know to understand this book
`You need to have read and understood the general introduction to all aspects of
`MQSeries Integrator V2.0 in the MQSeries Integrator V2.0 Introduction and
`Planning book.
`
`Terms used in this book
`Term
`
`Meaning
`
`click
`
`right click
`
`double-click
`
`drag
`
`Point to an object or action specified in the instructions, then
`press and release the left mouse button.
`
`Point to an object or action specified in the instructions, then
`press and release the right mouse button.
`
`Point to an object or action specified in the instructions then
`press and release the left mouse button twice in rapid
`succession.
`
`Point to an object specified in the instructions, then press
`and hold the left mouse button and move the mouse pointer
`to the desired location. Release the left mouse button.
`
` Copyright IBM Corp. 2000
`
`
`
`xi
`
`HP_1022_0013
`
`

`

`About this book
`
`
`
`
`
`
`Where to find more information
`Becoming familiar with the MQSeries Integrator library will help you accomplish
`MQSeries Integrator tasks quickly. The library covers planning, installation,
`administration, and client application tasks.
`
`MQSeries Integrator publications
`The following books make up the MQSeries Integrator V2.0 library:
`(cid:1) MQSeries Integrator V2.0 Introduction and Planning, GC34-5599
`(cid:1) MQSeries Integrator for Windows NT V2.0 Installation Guide, GC34-5600
`(cid:1) MQSeries Integrator V2.0 Messages, GC34-5601
`(cid:1) MQSeries Integrator V2.0 Using the Control Center, GC34-5602 (this book)
`(cid:1) MQSeries Integrator V2.0 Programming Guide, SC34-5603
`(cid:1) MQSeries Integrator V2.0 Administration Guide, SC34-5792
`
`+ MQSeries information available on the Internet
`+
`The MQSeries Business Solution, of which MQSeries Integrator is a part, has a
`+
`Web site at:
`http://www.ibm.com/software/ts/mqseries
`+
`
`+
`
`+
`
`+
`
`+
`
`+
`+
`+
`
`By following links from this web site you can:
`(cid:1) Obtain the latest information about all MQSeries family products.
`(cid:1) Access all the books for the MQSeries family products.
`(cid:1) Down-load MQSeries SupportPacs.
`
`You might be interested in the MQSeries Integrator problem determination Q&A
`SupportPac (MHI1) that you can access from:
` http://www.ibm.com/software/mqseries/txppacs/
`
`xii MQSeries Integrator V2.0 Using the Control Center
`
`
`
`HP_1022_0014
`
`

`

`
`
`
`Part 1.
`
`Introducing the Control Center
`
`.
`.
`
`Chapter 1. Control Center concepts
`. 3
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`. 3
`Working with configuration data .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`. 3
`Configuration and message repositories
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Shared and deployed configurations .
`. 4
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`The workspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
`Managing the contents of the workspace .
`. 4
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Saving the workspace .
`. 5
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`. 5
`Monitoring the broker domain .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
`.
`.
`.
`.
`.
`
`Chapter 2. Getting started with the Control Center
`. 7
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Before you start
`. 7
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`. 7
`Starting the Control Center .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Exiting the Control Center .
`. 9
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`. 9
`Managing permissions to Control Center tasks .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
` 11
`Adding users and groups to the MQSeries Integrator groups
`.
`.
`.
`.
`.
`.
`.
`.
`.
` 11
`Setting user roles
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
` 12
`Performing workspace tasks .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
` 12
`Creating a new workspace .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
` 12
`Opening an existing workspace
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
` 13
`Saving the workspace .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Importing resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
`Exporting the workspace
` 13
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
` 14
`Updating the workspace .
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Checking in resources .
` 14
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Naming Control Center resources .
` 15
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`Problem determination . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
`Controlling service traces .
` 16
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`.
`
` Copyright IBM Corp. 2000
`
`
`
`1
`
`HP_1022_0015
`
`

`

`
`
`
`
`
`2 MQSeries Integrator V2.0 Using the Control Center
`
`
`
`HP_1022_0016
`
`

`

`
`
`
`Control Center concepts
`
`Chapter 1. Control Center concepts
`
`This chapter introduces the Control Center by describing its role in an MQSeries
`Integrator broker domain, and defining those concepts that you need to understand
`as a Control Center user. For a comprehensive description of MQSeries Integrator
`concepts, see the MQSeries Integrator V2.0 Introduction and Planning book.
`
`The Control Center has two main functions in a broker domain. These are:
`(cid:1) The creation, manipulation, and deployment of configuration data for a broker
`domain
`(cid:1) The monitoring and management of the operational state of the same broker
`domain
`
`These functions are described in the remainder of this chapter.
`
`Working with configuration data
`When a broker is created using the mqsicreatebroker command, and started for
`the first time using the mqsistart command, it has no configuration to run. A
`broker can perform useful functions only when it has been given a configuration to
`run by the Control Center user.
`
`Configuration data is of three types:
`
`Assignments data
`Is the assignment of: execution groups to brokers; message flows to execution
`groups; and message sets to brokers.
`
`Topology data
`Is the relationship between brokers and collectives in a publish/subscribe network
`in the broker domain.
`
`Topics data
`Is topics and associated Access Control List (ACL) entries used in a
`publish/subscribe network in the broker domain.
`
`Configuration and message repositories
`Configuration data of all three types is created by Control Center users, and is
`managed by the Configuration Manager in two repositories called the configuration
`repository and the message repository.
`(cid:1) The message repository contains definitions of message sets.
`(cid:1) The configuration repository contains all other configuration data.
`
`There is only ever one Configuration Manager in a broker domain, but there can be
`any number of instances of the Control Center.
`
` Copyright IBM Corp. 2000
`
`
`
`3
`
`HP_1022_0017
`
`

`

`Control Center concepts
`
`
`
`
`
`
`Shared and deployed configurations
`The Configuration Manager manages two versions of the configuration data. These
`are the shared configuration and the deployed configuration.
`
` The workspace
`
`Shared configuration
`Consists of configuration data as created by one or more Control Center users
`and made visible to other Control Center users in the broker domain.
`
`Deployed configuration
`Is the configuration data that is operational in (that is, that is having an effect in)
`the broker domain.
`
`Configuration data in the shared configuration is sent to brokers by the
`Configuration Manager under the direction of Control Center users, by means of an
`an operation called deploy.
`If deployment is successful, the Configuration Manager
`updates its deployed configuration accordingly.
`
`It is
`The concept of the workspace is key to the operation of the Control Center.
`the term given to the “snapshot” of that part of the shared configuration data that
`you, as a Control Center user, want to work with. The shared configuration can
`consist of many brokers, collectives, execution groups, message flows, message
`sets, and topics, many of which are of no interest to you. The workspace allows
`you to work with a subset of this overall set of configuration data.
`
`All brokers, collectives, execution groups, and topics in the shared configuration
`always appear in your workspace. However, you can choose which message flows
`and message sets you want to appear, to make your view of the shared
`configuration more manageable. For example, if there are 500 message flows
`defined in the shared configuration, you can choose to see only the 10 that are
`owned by you. You do this using an operation called add. Similarly you can
`remove any configu