IBM OS/390 User Manual

Page of 673
for channel definitions under CICS/ESA find matching channel attributes in
MQSeries Distributed Queuing Guide, SC33-1139
define the channels using the CKMC CICS transaction.
Note:
Make sure that you use the same queue names in your OS/390 related
definitions which you used under VSE/ESA whenever possible. This will minimize
application changes.
Operating MQSeries for VSE/ESA includes:
initializing the MQSeries system and shutting it down
starting and stopping queues
opening, resetting and closing channels.
Monitoring offers functions to:
monitor channel and queue activities
browse queues.
Operating and monitoring facilities are provided through the MQSeries menu
under CICS for VSE/ESA.
For MQSeries for MVS/ESA similar functions are provided:
for system and queue definitions through MQSeries commands
for message channels under CICS through the DQM panels.
There is no direct migration support. You will have to make sure your
operational staff is trained to use the MQSeries for MVS/ESA facilities. You can
set up some procedures to automate these tasks.
9.5.4 MQSeries-based Applications
Applications using MQSeries for VSE/ESA are coded in COBOL for VSE and run
under CICS for VSE/ESA. They use the (MQSeries for VSE/ESA specific subset of)
MQI.
The first two application migration steps are independent of MQSeries:
 1. you have to migrate a program written in COBOL for VSE to OS/390. The
best choice is to migrate the application to IBM COBOL for MVS & VM
Release 2.
 2. you have to migrate a program written to run under CICS for VSE/ESA to run
under CICS/ESA.
For some details on these steps refer to the respective chapters in this book.
The next step is to consider the Message Queueing Interface (MQI). The effort
required for this step should be small since on a high level the MQI is identical
for all platforms.
You should use the
MQSeries Application Programming Reference, SC33-1673.
This book gives a full description of the MQSeries programming interface for
MQSeries for MVS/ESA. You should check that the MQI elements you used in
your VSE/ESA based applications are identical with the ones under OS/390.
Minor adaptations may be required.
As a final step you need to compile and link your applications under OS/390.
Chapter 9. Telecommunications S u b s y s t e m s
205