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