IBM GC34-5557-00 - Manual

Tables 1. National-language versions of MQSeriesfor AS/400, V5.1. . . . . . . . . 14 2. Authorities required to open an object 29 3. Authorities for Context andAlternateUserID . . . . . . . . . 29 4. MQSeries for AS/400 books . . . . . 91 5. MQSeries publications – file names 95 6. Sample programs –...

Welcome to MQSeries for AS/400 This book describes IBM ® MQSeries for AS/400, Version 5.1. It explains how to plan for, install, and begin to use the product. For latest information aboutMQSeries for AS/400, V5.1, refer also to the readme file on the publicationsCD-ROM, and to the MQSeries family We...

Chapter 1. About MQSeries This chapter introduces IBM MQSeries and describes its relationship withother products. It contains basic explanations of the following topics: v “Message Queuing” v “Messages and Queues” on page 2 v “MQSeries Objects” on page 3 v “Clients and Servers” on page 6 v “Instrume...

What is a Queue? A queue is a data structure that stores messages. The messages may be put onthe queue by applications or by a queue manager as part of its normaloperation. Queues exist independently of the applications that use them. A queue canexist in main storage (if it is temporary), on disk or...

Queue Managers A queue manager provides queuing services to applications, and manages thequeues that belong to it. It ensures that: v Object attributes are changed according to the commands received. v Special events such as trigger events or instrumentation events aregenerated when the appropriate ...

Namelists A namelist is an MQSeries object that contains a list of other MQSeries objects.Typically, namelists are used by applications such as trigger monitors, wherethey are used to list a number of queues. The advantage of using a namelist isthat it is maintained independently of applications. Yo...

Instrumentation Events You can use MQSeries instrumentation events to monitor the operation ofqueue managers. Instrumentation events cause special messages, which are called eventmessages, to be generated whenever the queue manager detects a predefinedset of conditions. For example, the following co...

Java support MQSeries classes for Java ™ include support for MQSeries for AS/400, V5.1. New calls MQSeries for AS/400, V5.1 supports the following new calls: v MQCONNX, which allows you to specify queue-managerconnection options. v MQCMIT, MQBACK, and MQBEGIN, which allow MQSeries tocoordinate a loc...

Message queue size A message queue can be up to 2 GB. Message size A single message can be up to 100 MB. Administration application The administration application is not supported in MQSeries forAS/400, V5.1. What’s New Chapter 2. What’s New in MQSeries for AS/400, V5.1 11

Chapter 3. Planning to Install the MQSeries for AS/400Server This chapter provides a summary of the requirements for running MQSeriesfor AS/400. It discusses the network protocols and compilers supported, thedelivery media, and the various components of the product. The information in this chapter a...

AS/400 Install Libraries and Directories MQSeries for AS/400 installs into the AS/400 library structure and also usesdirectories in the IFS root file system. AS/400 Library Structure Installation of MQSeries for AS/400 creates the following libraries: QMQM The MQSeries base product library. QMQMSAMP...

derived from the name of the queue manager prefixed with the charactersQM. For example, for a queue manager called TEST, the library would becalled QMTEST. You can use the WRKLIB command to list all the libraries that MQSeries forAS/400 has created. Against the queue manager libraries, you will see ...

User Profiles When you install MQSeries for AS/400, V5.1, a number of user profiles arecreated. These include QMQM, QMQMADM, and NOBODY. These threeobjects are central to the correct running of MQSeries for AS/400. Under nocircumstances should you alter or delete them. If you do, IBM cannotguarantee...

Samples Sample application programs. The source is supplied in theQMQMSAMP library and executables are supplied in the QMQMlibrary. See “Appendix A. Sample MQI Programs” on page 99. MQSeries online documentation HTML and PDF versions of the books are supplied on thepublications CD-ROM. They are not ...

QCCSID Every message has a coded-character set identifier (CCSID) in its header. TheCCSID tag identifies the code page and character set of the source. ForCCSIDs that are supported on the AS/400 see the AS/400 National LanguageSupport book. The CCSID information is obtained, when a queue manager is ...

Installation Procedure 1. To install the MQSeries for AS/400, V5.1 base product, issue thecommand: RSTLICPGM LICPGM(5733A38) DEV(install device) OPTION(*BASE) where: v 5733A38 is the product identifier for MQSeries for AS/400, V5.1, and v install device is the device from which the product is to be ...

Verifying the Installation To ensure that the product has loaded correctly, issue the Display SoftwareResources (DSPSFWRSC) command and check that the licensed program 5733A38 is listed. If you have installed the base and the optional samples, you should see: Resource ID Option Feature Description 5...

Quiescing MQSeries The orderly shutdown of MQSeries for AS/400 is called quiescing. You mayneed to quiesce MQSeries for AS/400, for example, to: v Take a backup of the system, or v Update MQSeries for AS/400 Quiescing previous releases of MQSeries for AS/400 To quiesce one of the previous releases o...

What are the Differences MQSeries for AS/400, V5.1 provides significant new function over previousreleases, including support for multiple queue managers, queue managerclusters, and substantially increased message and queue sizes. Enabling thisnew function has involved some changes to the internal a...

The process is the same except that: v If you are moving to a new machine, there is one additional step, which isto transfer data from the old machine to the new. v If you are upgrading the system on the same machine, you must save yourMQSeries data because the migration process completely deletes y...

8. Save details of your existing MQSeries authorities. To find these details,issue the DSPMQMOBJN command to list the queue manager and all theMQSeries queues and processes that you have. Then issue theDSPMQMAUT command to list the access that users have to each ofthese objects. 9. Quiesce the produ...

2. Restore the MQSeries objects for libraries QMQMDATA and QMQMPROCusing the following commands: RSTLIB SAVLIB(QMQMDATA) DEV(*SAVF) SAVF(QGPL/QMQMDATA) RSTLIB SAVLIB(QMQMPROC) DEV(*SAVF) SAVF(QGPL/QMQMPROC) 3. Restore the MQSeries local and remote journals using the followingcommand: RSTOBJ OBJ(AMQ*...

Note: Any PCF applications must be given explicit access to the queues.See the MQSeries for AS/400 V5.1 System Administration book forfurther information about security. Table 2. Authorities required to open an object Opening MQSeries objectwith option MQOO_ MQSeries object authorityrequired - earli...

2. Ensure that the MQSeries subsystem, QMQM, is active. To do this, issuethe command: DSPSBSD SBSD(QMQM/QMQM) If it is inactive, issue the command: STRSBS SBSD(QMQM/QMQM) 3. Ensure that the newly-created default queue manager is available. Tocheck this, use the command: DSPMQM If it is not available...

Deleting MQSeries for AS/400, V5.1 There are two ways of deleting MQSeries for AS/400: v A standard deletion removes MQSeries product code but preserves userdata. v An entire deletion removes both MQSeries product code and user data. Standard Deletion Perform a standard deletion of the MQSeries for ...

3. End the MQSeries subsystem, by entering: ENDSBS SBS(QMQM/QMQM) 4. Delete the directory /QIBM/UserData/mqm and its subdirectories. Dothis using the EDTF command and then use option 9 for the mqmdirectory. Note: If you do this, you will no longer have any information regardingyour installation. Use...

Chapter 5. Using MQSeries for AS/400, V5.1 This chapter introduces MQSeries command sets and some basic tasks thatyou can perform to get yourself started with MQSeries for AS/400, V5.1. Tasks include creating and starting a queue manager, and creating, clearing,browsing, and deleting a local queue. ...

CL Commands The AS/400 CL commands for MQSeries can be grouped as follows: v Channel commands - used to create, start, and delete channels. v Cluster commands - used to work with queue manager clusters. v Command server commands - used to display, start, and end the commandserver. v Data type conver...

Command Usage SPDMQMCLQM (suspend cluster queuemanager) to inform cluster queue managers that the localqueue manager is not available. STRMQM (start message queue manger) to start a local queue manager. STRMQMCHL (start MQM channel) to start a channel. STRMQMCHLI (start MQM channel initiator) to sta...

PCF Commands MQSeries programmable command format (PCF) commands allow you toprogram administration tasks into an administration program. For a completedescription of the PCF commands and how to use them, see the MQSeriesProgrammable System Management book. Working with MQSeries If you are new to MQ...

2. On the CRTMQM panel, type in a Message Queue Manager name, forexample TEST.QMANAGER and press Enter. The name of the queue manager can be a maximum of 48 characters inlength. Valid characters are detailed in MQSeries for AS/400 V5.1 SystemAdministration book.The queue manager is then created, alo...

There are 4 options you can use when ending a queue manager: 1. OPTION (*CNTRLD) . This allows current transactions to complete, and all applications to disconnect, before ending the queue manager. This optionis the default. 2. OPTION (*IMMED) . This immediate shutdown allows any current calls to co...

User Exits Before using user exits on MQSeries for AS/400, V5.1, relink them with thethreaded libraries and ensure that they are thread-safe and teraspace enabled.See the MQSeries Application Programming Guide and the MQSeriesIntercommunication book for further information about creating user exitpr...

Chapter 6. Planning to Install MQSeries Clients This chapter provides a summary of the hardware and software required torun the following MQSeries clients: v MQSeries client for AIX v MQSeries client for DOS v MQSeries client for HP-UX v MQSeries client for OS/2 Warp v MQSeries client for Sun Solari...

v AIX Version 4.2 (5765-655 or 5765-C34) or AIX Version 4.3 or later.Later levels of some listed products might be required for AIX Version 4.2,SMP, and SP ™ . Later levels of operating system might be required to support corequisite products. Connectivity For TCP/IP connectivity: v TCP/IP (in the o...

MQSeries Client for Java This allows Java applets running on your client machine tocommunicate with MQSeries. It includes security exits for encryptionand authentication of messages sent across the Web by the MQSeriesClient for Java. These exits consist of some Java classes. To use theclient for Jav...

Compilers for MQSeries applications on Digital UNIX clients The following compiler is supported: v DEC C, Version 5.2 for Digital UNIX DOS Client: Hardware and Software Required This section outlines the hardware and software requirements for an MQSeriesclient for DOS. Hardware An MQSeries client ca...

Components for DOS MQSeries Client The MQSeries client code for your platform. MQSeries Toolkit This includes: v Sample programs - some of these are required for verifying theinstallation of the MQSeries client/server system v Header files that you can use when writing applications to run onthe clie...

Compilers for MQSeries Applications on HP-UX Clients The following compilers are supported: v Micro Focus COBOL for UNIX, Version 4.0 v HP-UX ANSI C compiler v C Softbench, Version 5.0 v HP CFRONT C++, Version 3.1 v IBM C and C++ compilers, Version 3.6 v HP ANSI C++ Components for HP-UX These are id...

Optional software v IBM Directory and Security Server for OS/2 Warp, Version 4 or latercompatible versions. This must be the U.S. Domestic version supportingDES encryption if the user wishes to run the MQSeries-supplied DCE send,receive, or message exits. v If used as a DCE server this software is k...

for Java must be installed on an HPFS formatted drive. Forinformation about Java runtime see “HTML and PDF Books on theWorld Wide Web” on page 96. Note: If it is possible on your platform, at installation time theCLASSPATH environment variable will either be updated ifalready present, or created if ...

Optional software Transarc DCE, Version 1.1. This must be the U.S. version supporting DESencryption for users to run the MQSeries-supplied DCE send, receive ormessage exits. DCE names and security modules for MQSeries are provided as part of theMQSeries for Sun Solaris product. Compilers for MQSerie...

Compilers for MQSeries Applications on Windows 3.1 Clients The following compiler is supported: v Microsoft Visual C++, Version 1.5 Components for Windows 3.1 These are identical to those for DOS. See “Components for DOS” on page 49. Windows 95 and Windows 98 Client: Hardware and Software Required T...

v Microsoft Visual C++ for Windows 95 and Windows NT, Version 4.0 andVersion 5.0 v IBM C and C++ compilers, Version 3.6 v IBM PL/I for Windows, Version 1.2 v IBM VisualAge for PL/I for Windows v IBM VisualAge PL/I Enterprise, Version 2.1 v IBM Visual Basic for Windows, Version 4.0 (16-bit) and Versi...

Chapter 7. Installing MQSeries Clients This chapter describes the following: v “Installing MQSeries Clients on the Same Machine as the Server” v “Installing on AIX” v “Installing on DOS” on page 64 v “Installing on HP-UX” on page 65 v “Installing on OS/2 Warp” on page 66 v “Installing on Sun Solaris...

The MQSeries client is installed into the /usr/mqm directory. This cannot bechanged. However, if you do not have enough space in the /usr/mqm filesystem, follow the procedure given in “Creating Another File System for theClient” on page 59. If you have a previous version of the MQSeries for AIX clie...

3. Add a password to the new user ID. You can display the window fordoing this using this sequence: Security & Users Passwords 4. Add the newly created group mqm to an existing user ID. You can display the window for doing this using this sequence: Security & Users Users Change / Show Charac...

7. Click on Install/Update.A bundle of software products is created: mqm.Client 8. Choose the mqm.Client bundle and click on Install/Update again.A work in progress window gives information as the installation proceeds. 9. At the end of installation you can click on the View log button and scrollto ...

Migrating from an Earlier Version of MQSeries for AIX If you want to migrate from an MQSeries for AIX V5.0 client to an MQSeriesfor AIX V5.1 client, you must first end all MQSeries activity on the targetmachine, and remove any shared resources that are used by MQSeries. Dothis either by shutting dow...

Installation of the MQSeries for AIX V5.1 client will fail if a file systemmounted as /usr/lpp/mqm is detected. If you are migrating from an earlierversion and a file system exists for this directory, you will need to do one ofthe following things before installing the MQSeries for AIX V5.1 client. ...

Software Installation and Maintenance Install and Update Software Install and Update from ALL Available Software 3. Press the List button to display the Single Select List window. 4. Select:/dev/cd0 (CD-ROM Drive) 5. Press the List button on the Software to Install field. 6. Select the message catal...

5. Edit the autoexec.bat file using a suitable editor. If the PATH statementexists, add the following to it: c:\mqmdos;c:\mqmdos\bin;c:\mqmdos\en_us If the PATH statement does not exist, add the following line to theautoexec.bat file. SET PATH=c:\mqmdos;c:\mqmdos\bin;c:\mqmdos\en_us Removing an MQSe...

For stand-alone machines, you can create the new user and group IDs locally.For machines administered in a network information services (NIS) domain,you can create the user and group IDs on the NIS master server machine. Installation Use the HP-UX swinstall program, or use SAM, after mounting the CD...

You can install the version of the MQSeries client software specific to yournational language. This means that the installation program, online help andmessages will be in your national language. Installation Online help is available by selecting the Help push button or by pressing PF1. Before you s...

Use the push buttons as necessary: v To display descriptions of the selected options, select Descriptions. v To select all of the options, select Select all. v To deselect all of the options, select Deselect all. The Work and File Directory field allows you to specify a drive anddirectory other than...

Note that the MQSeries client is a set of services and it does not have tobe explicitly run. Therefore the folder does not have an object called a“client”. 13. Remove the installation CD-ROM from the drive. 14. If your CONFIG.SYS file has been updated, shut down the system andrestart. If the CONFIG....

Attention Note that the INSTALL.EXE file in the root directory of the CD-ROMmust not be used to perform unattended installations. You must instead invoke the INSTALL.EXE file located in the directorycorresponding to the language version of the product that you want toinstall. Starting Unattended Ins...

command, you must type it as one continuous line. In the example above,for clarity, the command is spread over several lines. In this example, the MQSeries client is installed from the redirected drive J: onthe server, according to the options supplied in the response fileAMQISMC2.RSP. Note that dri...

When you specify this parameter, no progress indicator panel is shownand error messages are logged in the error log file. (You specify the pathname of the error log file using the /L1 parameter.) If you do not specifyall of the information required for the action to complete, an error occurs. If you...

CFGUPDATE Specifies whether CONFIG.SYS is updated automatically. Valid valuesfor this keyword are: AUTO Automatically updates CONFIG.SYS MANUAL Does not update CONFIG.SYS Actions: INSTALL, UPDATE, DELETE. COMP Specifies the name of a component on which to perform an action. Seethe server or client c...

file found that matches the specification is included. If thespecification is not valid, no general response file is included. Note: You should not have more than five levels of included responsefiles. Actions: All actions. OVERWRITE Specifies whether to overwrite files automatically during installa...

Note: If you plan to install an MQSeries client and server on the samemachine, see “Installing MQSeries Clients on the Same Machine as theServer” on page 57. The MQSeries product is installed into the /opt/mqm directory. This cannot bechanged. Before Installation Before you can install an MQSeries c...

b. You are prompted for a list of components to be installed. Select theones you require - if you want to install all the components, select all.The component MQSeries Client for Java should be installed only ifyou have Java 1.1.1 (or later compatible) runtime code on yourmachine. You also require V...

Installation 1. Insert the MQSeries Client CD-ROM into the CD-ROM drive. 2. The installation automatically starts and an MQSeries Language Selectionwindow is displayed. Note: If you have disabled auto-playing of CD-ROMs, run SETUPinstead, from the root directory. This window presents you with a list...

If you view the README file, close the window of the README tocontinue the installation process. 10. The installation of the MQSeries client is now complete, and a window isdisplayed giving you the option of restarting your computer now orleaving it until later. It is recommended that you restart yo...

v SetupKo – Korean v SetupPt – Brazilian Portuguese v SetupTw – Traditional Chinese 4. From the selected language directory, run setup.exe , with the -r option to create a response file.This can be done by: a. Highlighting setup.exe b. Dragging it to the Start, Run dialog c. Adding -r to the end of ...

1. Use the NET USE command as follows: NET USE devicename \\ servername \ netname For example: where: v J: is the logical drive name to be connected to the shared resourcedirectory. v MQMSHARE is the netname for M:\INSTMQS. 2. Go to the language directory that contains the SETUP.EXE and SETUP.ISSfil...

setupen - English setuppt - Brazilian Portuguese setupfr - French setupde - German setupit - Italian setupjp - Japanese setupko - Korean setupes - Spanish setupcn - Simplified Chinese setuptw - Traditional Chinese 4. Run setup.exeThe MQSeries Welcome window is displayed. 5. Make sure you are install...

Select Yes, I want to restart my computer now and click on the Finish button to complete the setup. 12. When setup is complete, the MQSeries Client folder is added to theProgram Manager. Note that the MQSeries client is a set of services andit does not have to be explicitly run, so the folder does n...

Installing from a LAN There are two ways to put MQSeries installation files on a LAN file server foreasier access: you can make the MQSeries for Windows NT Client CD-ROMdrive shareable, or you can copy the installation files from the CD-ROM to afile server, by following these steps: 1. Create a fold...

Using the System Management Server with MQSeries for Windows NT This section describes how to install, or remove, an MQSeries for WindowsNT client using the System Management Server (SMS). Creating SMS Packages and Jobs for MQSeries You must create: v An SMS software package containing the MQSeries ...

Note: If you specified a local path in the Source Directory entry field,you get a pop-up dialog warning you that the local path youspecified might not be accessible to SMS components running onanother machine. Click on the OK button to continue. 10. Click on the OK button to close the Package Proper...

3. Carry out an installation on a machine and record the options selected toinstall the product in a response file. To do this you must run setup.exewith the -r parameter, and optionally, the -noinst parameter: a. Load the MQSeries for Windows NT client CD-ROM. If you haveautorun enabled, the langua...

you omit the -g<logfile> parameter, Setup creates a file calledamqilogn.txt in the data-files folder on the machine running theinstallation. In this case, any messages generated before the data-filesfolder is created are lost. The -g<logfile> parameter must be placedbefore the -f1 and th...

Chapter 8. Obtaining Additional Information This chapter describes the documentation for MQSeries for AS/400, V5.1. Itstarts with a list of the publications, and then discusses: v “Hardcopy Books” on page 93 v “Online Information” on page 93 MQSeries for AS/400, V5.1 is described in the following bo...

Table 4. MQSeries for AS/400 books (continued) OrderNumber Title Description SC33-1872 MQSeriesIntercommunication Defines the concepts of distributed queuing,and explains how to set up a distributedqueuing network in a variety of MQSeriesenvironments. In particular, it demonstrateshow to (1) configu...

Table 4. MQSeries for AS/400 books (continued) OrderNumber Title Description SC33-1673 MQSeries ApplicationProgramming Reference Provides comprehensive referenceinformation for users of the MQI. It includes:data-type descriptions; MQI call syntax;attributes of MQSeries objects; return codes;constant...

Publications CD-ROM Included with the product is a publications CD-ROM. On this CD-ROM thereare three directories; books, amqaa60w, and readme. CD-ROM books directory The books directory contains the MQSeries for AS/400 books in HTML andPDF formats. To access them point you Web browser to books/star...

CD-ROM amqaa60w directory The amqaa60w directory contains a package of searchable PDF files. Thepackage comprises a set of panels, books, and index files and provides amethod of searching the MQSeries library on your workstation using AdobeAcrobat Reader with Search. The package is available in U.S....

BookManager CD-ROMs The MQSeries library is supplied in IBM BookManager ® format on a variety of online library collection kits, including the Transaction Processing and Datacollection kit, SK2T-0730. You can view the softcopy books in IBMBookManager format using the following IBM licensed programs:...

Appendix A. Sample MQI Programs MQSeries for AS/400 provides a set of short sample MQI programs. You canchoose to install these when you install the base product. If you do installthem, you get them in both source form and object form. You can use theobjects as they are or you can modify and recompi...

Table 6. Sample programs – source files (continued) Technique C COBOL RPG Browsing first 20 characters of amessage AMQSGBR4 AMQ0GBR4 AMQnGBR4 Browsing complete messages AMQSBCG4 – – Using a shared input queue AMQSINQ4 AMQ0INQ4 AMQnINQ4 Using an exclusive input queue AMQSREQ4 AMQ0REQ4 AMQnREQ4 Using ...

Appendix B. Applying Maintenance to MQSeries for AS/400 This appendix tells you how to apply maintenance to MQSeries for AS/400. Service updates for MQSeries for AS/400 are supplied as PTFs (ProgramTemporary Fixes). They may be supplied on a CD-ROM, or you may obtainthem electronically as save files...

improvements and/or changes in the product(s) and/or the program(s)described in this information at any time without notice. Any references in this information to non-IBM Web sites are provided forconvenience only and do not in any manner serve as an endorsement of thoseWeb sites. The materials at t...

Index A administration command sets MQSeries commands (MQSC) 36 programmable command format commands (PCF) 37 administration interface 9AIX client custom installation 61hardware and software 45installing 60removing 64 application data 2time-independent 2 applications multithreaded 10non-version 5 45...

Sending your comments to IBM If you especially like or dislike anything about this book, please use one ofthe methods listed below to send your comments to IBM. Feel free to comment on what you regard as specific errors or omissions, andon the accuracy, organization, subject matter, or completeness ...

IBMR Printed in the United States of Americaon recycled paper containing 10%recovered post-consumer fiber. GC34-5557-00