Dieter Wackerow, Klaus Haaber-Bernth

1 IBMLU sing MQSeries on the AS/400 Dieter wackerow , Klaus haaber -BernthInternational Technical Support book was printed at 240 dpi (dots per inch). The final production redbook with the RED cover willbe printed at 1200 dpi and will provide superior graphics resolution. Please see How to Get ITSOR edbooks at the back of this book for ordering Technical Support OrganizationUsing MQSeries on the AS/400 July 1998 Take Note!Before using this information and the product it supports, be sure to read the general informationin Appendix B, Special Notices on Edition (July 1998)This edition applies to MQSeries for AS/400 Version 4 Release may be addressed to:IBM Corporation, International Technical Support OrganizationDept. HZ8 Building 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 theinformation in any way it believes appropriate without incurring any obligation to you.

2 Copyright International Business Machines Corporation 1998. All rights to Government Users Documentation related to restricted rights Use, duplication ordisclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM ..ixTables ..xiiiPreface ..xvThe Team That Wrote This xvComments Welcome ..xviChapter 1. Why Should You Use MQSeries on an AS/400?.. Is MQSeries Just Another AS/400 Queuing System?.. About MQSeries for AS/400 Version 4 Release MQSeries V5 and MQSeries for AS/400 What Is Familiar in MQSeries to the AS/400 Professional?.. Application and Message Messages from Data Queues Are Clients and Objects Are AS/400 Queue 6 Chapter 2. MQSeries Overview .. What Is Messaging and Queuing?.. Objects .. Message Queues.

3 Queue .. Queue .. Queue .. Queue .. Queue .. Queue .. Queue .. Creating a Queue Manipulating MQM Objects (RUNMQSC).. Clients and How MQSeries 21 Copyright IBM Corp. 1998 Communication between Queue to Define a Connection between Two to Start Communication to Start Channels to Start Applications to Test if the Queue Manager Is Communication between Client and to Define a Client/Server to Start a Client/Server to Test a Client/Server a Client/Server Connection The Message Queuing Interface (MQI).. A Code 41 Chapter 3. AS/400 for Signing On .. Main Menu and Command Entry Understanding the 5250 Screen UsingCommands .. Errors .. a Do I Do When Something Goes Wrong?.. Where Is the Error Log?

4 About Libraries .. Program Development Management (PDM).. About Library Library .. Library .. Library List .. More Job Attributes and Where They Come Job Job Is It Decided What Job Atttributes to Where Is the Editor?.. How Do I Compile?.. Did the Program Compile OK?.. Where Is the Printout?.. Basic AS/400 Basic AS/400 Backup and Data with Data between Data between 80ivUsing MQSeries on the AS/400 Receiver 81 Chapter 4. Installation and Considerations Before the Character Set Identifier (QCCSID).. Identifier (QLANGID).. Universal Time Offset (QUTOFFSET).. Part of the Library List (QSYSLIBL).. Part of the Library List (QUSRLIBL).. Object Restore Option (QALWOBJRST).. Installation .. PTFs (Program Temporary Fixes).

5 Verifying the Installation of Creating the Queue the Is the CCSID for My Language?.. a Queue Manager CRTMQM and Starting the MQM .. the Default the Queue Client Software for Clients Connected to the Migrating to for Product Code Product Code and Product Code, Definitions and Message Data .. 105 Chapter 5. Security Considerations .. MQ Command MQ User MQ Administrator (MQADM).. MQ Programmer (MQPGM).. Application User (Otto, Eva, ..).. Operator (QSYSOPR, MQOPR).. 115 Chapter 6. Running the Creating the MQ Creating the Environment for the Working with the RPG Sample Source of the Sample Programs .. the RPG Executing the Sample Messages to a Messages in a Messages from a Triggering a a Sample a Triggered a Program that Monitors the Initiation Messages into Triggered the Monitor in More Sample Inspecting Some Syncpoint and AS/400 Commit 137 Chapter 7.

6 AS/400 Communicating with Other AS/400 Communications MQSeries for AS/400 Using MQSeries for AS/400 Using Example: Connecting MQSeries for AS/400 to Windows the AS/400 MQ the Windows NT MQ and Receiving ..151 Chapter 8. Operating MQSeries for Handling Journal Objects in Backup and MQJournals .. a Damaged MQ Channel Operations .. Starting MQ Stopping MQ 163 Chapter 9. MQSeriesAdministration .. CL Commands for MQ Use of MQSC MQSeries for AS/400 Administration Administering an AS/400 from a Remote 175 Chapter 10. Service and Before Contacting IBM Contacting IBM 186 Appendix A. Sample Programs .. SWK - Display Active Jobs in Subsystem 187viUsing MQSeries on the AS/400 A Simple File: A Simple RPG Program with Commit DTA2 - Put Date and Time in a Data TCJOB - Save Keying Time When Tracing a Starting MQ Ending MQ Starting Sender 192 Appendix B.

7 Special Notices ..193 Appendix C. Related Publications .. International Technical Support Organization Redbooks on Other Publications ..197 How to Get ITSO 199 How IBM Employees Can Get ITSO 199 How Customers Can Get ITSO 200 IBM Redbook Order 201 List of 203 Index ..205 ITSO Redbook Evaluation .. 207 ContentsviiviiiUsing MQSeries on the AS/400 Figures 1. MQSeries at Runtime ..7 2. Program-to-Program Communication - One System ..9 3. Program-to-Program Communication - Two Systems ..9 4. RUNMQSC -Interactive ..17 5. RUNMQSC -UsingCommandFile ..18 6. RUNMQSC - InputFile, or AS/400 STRMQMMQSC ..18 7. RUNMQSC - OutputFile, or AS/400 WRKSPLF ..19 8. MQSeries Channels ..20 9. MQSeriesParts and Logic .. between Two Queue MQ CL Channels .. Applications.

8 The Queue Connection .. for Server Client/Server Window (RUNMQLSR).. and for Two Clients and of an MQSeries Sign On Main Command Entry with Active Jobs Job Description Job Description Panel - Job Description Panel - More to Specify More with Command Job Log All Messages with Object Links with Objects Using PDM with Objects Using PDM with Members Using PDM .. Physical File Member Panel (1).. Physical File Member Panel (2).. Library 64 Copyright IBM Corp. 1998 Library with Members Using an RPG a Program with Output Queue Object Authority - Example Object Authority - Example Software Licensed Programs - View Licensed Programs - View Listing.

9 PTF Job Definition of Language IDs (LANGID).. Message Queue Message Queue Manager (After F11).. Message Queue Message Queue - Not Authorized MQM Object User Profile Commands .. Message Queue with MQM MQM with Objects Using Objects .. with Members Using RPG/400 Program (CRTRPGPGM).. Work with MQM Message Spooled Spooled Writing to with Active Jobs, with Active Jobs, PGM-DTA2 .. MQM Process (CHGMQMPRC).. with Communication Routing Entry .. Comm Side Definitions .. Error with MQM 151xUsing MQSeries on the AS/400 Work with Channels Journal with Objects Using with MQM Work with Channels MQM Channel (PNGMQMCHL).. Commands .. MQM Administration.

10 Queue Manager Administration .. Object Display Work with with MQM Administration .. Wait for Remote MQM Message MQM Message with Job with Active with Output Spooled 180110. MQ Trace 181111. PTFL isting .. Program Temporary Fix (DSPPTF).. PTF with Problem with 186 FiguresxixiiUsing MQSeries on the AS/400 Tables 1. MQSeries Objects forMQM-to-MQMC onnection ..25 2. StartMQM-to-MQMC onnection ..27 3. MQSeriesDefinitions to Start Channels ..28 4. AS/400 Sample Programs and ProgrammingLanguages ..30 5. AS/400 Commit/Rollback Commands ..40 6. FilesChanged inV4R2 ..92 7. Case-SensitiveMQMNAME ..95 8. FilesChanged inV4R2 ..105 9. Definitions for Connecting Windows NT toAS/400 .. Processes ..163 Copyright IBM Corp.