Quick Beginnings
MQSeries for AS/400
V5.1
GC34-5557-00
Page
Quick Beginnings
MQSeries for AS/400
V5.1
GC34-5557-00
First edition March
Contents
Chapter 3. Planning to Install the MQSeries
Chapter 4. Installing, Migrating to, and
Chapter 5. Using MQSeries for AS/400
Chapter 6. Planning to Install MQSeries
Chapter 7. Installing MQSeries Clients
Clients
iv MQSeries for AS/400, V5.1 Quick Beginnings
Chapter 8. Obtaining Additional
vi MQSeries for AS/400, V5.1 Quick Beginnings
Tables
National-language versions of MQSeries
MQSeries for AS/400 books
for AS/400
viii MQSeries for AS/400, V5.1 Quick Beginnings
Welcome to MQSeries for AS/400
Conventions
Conventions
x MQSeries for AS/400, V5.1 Quick Beginnings
Chapter 1. About MQSeries
Message Queuing
MQI ± a Common Application Programming Interface
What is a Message?
Message Queuing Time-Independent Applications
Message-Driven Processing
Messages and Queues
Messages and Queues What is a Queue?
MQSeries Objects
MQSeries Objects Queue Managers
Queues
MQSeries Objects Process Definitions
Channels
MQSeries Objects Namelists
Clients and Servers
Instrumentation Events Instrumentation Events
Types of Event
Queue manager events
Performance events
Transactional Support Transactional Support
8 MQSeries for AS/400, V5.1 Quick Beginnings
MQSeries Administration Interface MQAI
Chapter 2. Whats New in MQSeries for AS/400
MQSeries queue manager clusters
Support for Windows 98 clients
Two-phase commit
Whats New
Java support
New calls
Administration application
Message queue size
Message size
Whats New
Whats New
12 MQSeries for AS/400, V5.1 Quick Beginnings
Chapter 3. Planning to Install the MQSeries for AS/400 Server
Hardware Requirements
Disk Space Required
Software Requirements
Connectivity AS/400 Install Libraries and Directories
AS/400 Library Structure
QMQM
QMQMSAMP
IFS Root File System
QIBM/ProdData/mqm
QIBM/UserData/mqm
Connectivity
Connectivity User Profiles
Compilers Supported for MQSeries for AS/400, V5.1 Applications
Delivery
MQSeries for AS/400 Components
Creating the System-Default Objects
Samples
MQSeries online documentation
Readme file
18 MQSeries for AS/400, V5.1 Quick Beginnings
Chapter 4. Installing, Migrating to, and Deleting MQSeries for AS/400
Before Installation
Setting System Values
QCCSID
QUTCOFFSET
QSYSLIBL
QALWOBJRST
Installation Installation Procedure
Installation of Translated Versions
Reinstallation
Verifying the Installation Verifying the Installation
Post Installation Tasks
Quiescing MQSeries Quiescing MQSeries
Quiescing previous releases of MQSeries for AS/400
Quiescing MQSeries Quiescing V5.1 of MQSeries for AS/400
Migrating to MQSeries for AS/400
CALL QMQM/AMQSTOP4 PARM*ALL *FORCE
ENDSBS SBSQMQM/QMQM
Migrating MQSeries What are the Differences
Overview of Migration Process
Migrating MQSeries
Before Migration
Migration
Migrating MQSeries
11. Save your MQSeries data
Migrating MQSeries
CALL PGMQMQM/MIGRATEMQM
CALL PGMQMQM/AMQRMCHA PARMQMGRNAME
CALL PGMQMQM/AMQRMSYA PARMQMGRNAME
Verifying the Migration
Migrating MQSeries
Table 2. Authorities required to open an object
Table 3. Authorities for Context and AlternateUserID
Migration Verification
After Migration
Deleting MQSeries Deleting MQSeries for AS/400
Standard Deletion
Entire Deletion
Deleting MQSeries
Chapter 5. Using MQSeries for AS/400
Introducing Command Sets
Before you Start
Before you Start CL Commands
v Data type conversion command - used to convert data types
Using CL Commands
Command
CVTMQMDTA convert MQM data type command
Before you Start
MQSeries MQSC Commands
Running MQSC Commands
Before you Start
Before you Start PCF Commands
Working with MQSeries
Creating a Queue Manager
Figure 1. CRTMQM panel
Starting a Queue Manager
Creating a Local Queue
The queue manager is then created, along with a set of default objects
Working with MQSeries
Working with MQSeries
4. Fill in the name of your queue manager in the
Working with MQSeries
Figure 4. Create MQM Queue panel part
Figure 5. Create MQM Queue panel part
40 MQSeries for AS/400, V5.1 Quick Beginnings
Working with MQSeries Sending a Test Message
Browsing Queues
Clearing a Local Queue
Deleting a Local Queue
Deleting a Queue Manager
Checking what Queue Managers you have Running
Other Things to Do
There are 4 options you can use when ending a queue manager
Setting the Queue Manager CCSID for MQSeries for AS/400
User Exits User Exits
44 MQSeries for AS/400, V5.1 Quick Beginnings
Chapter 6. Planning to Install MQSeries Clients
Applications on Version 5 Clients
AIX Client Hardware and Software Required
Hardware
Hardware and Software, AIX
Compilers for MQSeries Applications on AIX Clients
Components for AIX
Connectivity
Digital UNIX Client Hardware and Software Required
MQSeries Client for Java
MQSeries Internet Gateway documentation
MQSeries Internet Gateway
Hardware and software, Digital UNIX
Compilers for MQSeries applications on Digital UNIX clients
DOS Client Hardware and Software Required
Compilers for MQSeries Applications on DOS Clients
Components for DOS Components for DOS
HP-UX Client Hardware and Software Required
MQSeries Toolkit
Hardware
Hardware and Software, HP-UX
Compilers for MQSeries Applications on HP-UX Clients
Components for HP-UX
OS/2 Warp Client Hardware and Software Required
Hardware and Software, OS/2 Warp
Compilers for MQSeries Applications on OS/2 Warp Clients
Components for OS/2 Warp
MQSeries Development Toolkit
Sun Solaris Client Hardware and Software Required
Components for OS/2 Warp
Hardware
Software
Hardware and Software, Sun Solaris
Compilers for MQSeries Applications on Sun Solaris Clients
Components for Sun Solaris
Windows 3.1 Client Hardware and Software Required
Hardware and Software, Windows
Compilers for MQSeries Applications on Windows 3.1 Clients
Components for Windows
Windows 95 and Windows 98 Client Hardware and Software Required
Components for Windows 95 and Windows
Windows NT Client Hardware and Software Required
Compilers for MQSeries Applications on Windows NT Clients
Components for Windows 95 and Windows
Hardware and Software, Windows NT
Components for Windows NT
Chapter 7. Installing MQSeries Clients
Installing MQSeries Clients on the Same Machine as the Server
Installing on AIX
Installing on AIX
Before Installation
v /var/mqm v /var/mqm/log
Creating Another File System for the Client
Creating the mqm User ID and Group
Installing on AIX
Easy Installation
Installing on AIX
1. Log on as root
Custom Installation
7. Click on Install/Update
5. Select /dev/cd0 CD-ROM Drive
Installing on AIX
Changes to the Installation Path
Migrating from an Earlier Version of MQSeries for AIX
4. Select /dev/cd0 CD-ROM Drive
Installing on AIX
Changing the National Language
Installing on AIX
1. Type smit 2. Follow this sequence of windows
Installing on DOS
Using Setup
Translated Messages
Removing an MQSeries Client from AIX
Installing on HP-UX
Removing an MQSeries Client from DOS
Installing on DOS
Before Installation
Installation
Kernel Configuration
Installing on OS/2 Warp
Removing an MQSeries Client from HP-UX
Installing on OS/2 Warp
Installation
1. Open an OS/2 Warp window or start a full-screen session
Installing on OS/2 Warp
Use the push buttons as necessary
Unattended Installation on OS/2 Warp
Installing on OS/2 Warp
13. Remove the installation CD-ROM from the drive
Starting Unattended Installation
Installing on OS/2 Warp
Installation and Maintenance Parameters
Aaction
Installing on OS/2 Warp
The installation and maintenance parameters are as follows
L1error log
Tinstall target directory
TUupdate CONFIG.SYS directory
Ginclude path
Installation Response Files
Keywords for Response Files
Installing on OS/2 Warp
CFGUPDATE
DELETEBACKUP
Actions INSTALL WORK
Actions INSTALL INCLUDE
Installing on Sun Solaris
SAVEBACKUP
Actions UPDATE
Removing an MQSeries Client from OS/2 Warp
Installing on Sun Solaris
Before Installation
Installation
usr/bin/ps -ef /bin/grep vold
Installing on Windows 95 or Windows
Removing an MQSeries Client from Sun Solaris
Installing on Sun Solaris
Kernel Configuration
Installing on Windows 95 or Installation
78 MQSeries for AS/400, V5.1 Quick Beginnings
Installing on Windows 95 or
Unattended Installation on Windows 95 and Windows
Setting up the Server
Installing on the Remote Machine
Installing on Windows 95 or
Installing on Windows
Removing an MQSeries Client from Windows 95 and Windows
Installing on Windows 95 or
Installation
Installing on Windows
setupen - English setuppt - Brazilian Portuguese setupfr - French
setupcn - Simplified Chinese setuptw - Traditional Chinese
82 MQSeries for AS/400, V5.1 Quick Beginnings
Installing on Windows NT
Installation Procedure
Removing an MQSeries Client from Windows
Installing on Windows
Installing on Windows NT
84 MQSeries for AS/400, V5.1 Quick Beginnings
Installing on Windows NT Installing from a LAN
Using the System Management Server with MQSeries for Windows NT
v Automated Uninstallation of IBM MQSeries - Windows NT client
Creating SMS Packages and Jobs for MQSeries
Creating the MQSeries SMS Software Package
Unattended Installation on Windows NT
Creating the MQSeries SMS Job
Installing on Windows NT
logfile
Installing on Windows NT
Installing on the Remote Machine
Removing an MQSeries Client from Windows NT
Classes for Java
responsefile
secondarylogfile
Configuring a Client Configuring and Verifying a Client
90 MQSeries for AS/400, V5.1 Quick Beginnings
Chapter 8. Obtaining Additional Information
v ªHardcopy Booksº on page v ªOnline Informationº on page
MQSeries for AS/400, V5.1 is described in the following books
Table 4. MQSeries for AS/400 books
Additional Information
Table 4. MQSeries for AS/400 books continued
Hardcopy Books
Online Information
Additional Information
You can order publications from the IBMLink Web site at
Online Information Publications CD-ROM
CD-ROM books directory
Online Information
v enUS English v frFR French v deDE German v itIT Italian
CD-ROM amqaa60w directory
CD-ROM readme directory
Online Information
Online Information BookManager CD-ROMs
Online Help
98 MQSeries for AS/400, V5.1 Quick Beginnings
Appendix A. Sample MQI Programs
C, COBOL, and RPG Program Samples
Samples
Samples
Appendix A. Sample MQI Programs
102 MQSeries for AS/400, V5.1 Quick Beginnings
Appendix B. Applying Maintenance to MQSeries for AS/400
Reinstalling MQSeries for AS/400
104 MQSeries for AS/400, V5.1 Quick Beginnings
Appendix C. Notices
Notices
Notices Trademarks
108 MQSeries for AS/400, V5.1 Quick Beginnings
Index
events continued instrumentation 7 types of
QALWOBJRST
Page
112 MQSeries for AS/400, V5.1 Quick Beginnings
Sending your comments to IBM
IBMR
GC34-5557-00
MQSeries for AS/400, V5.1 Quick Beginnings
Spine information
MQSeries for AS/400