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