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