IBM MQ for Linux, UNIX, Windows and z/OS Verhoef TRAINING POCKET BOOK Third Edition Verhoef Training Ltd 11 Kingsmead Square, Bath, BA1 2AB t: 01225 339705 f: 01225 339671 e: [email protected] www.verhoef-training.co.uk Other Verhoef Courses Applications Development • Programming Languages • Systems Analysis and Design • Project and Service Management • OO and Structured Methods • Web Development Databases • DB2 • Oracle • SQLServer • MySQL • MongoDB • PostgreSQL UNIX • AIX • Linux • Solaris • HPUX • Shell Enterprise Servers • z/OS, z/VM, IBMi • Fujitsu VME PC and LAN Support • Windows • Networking • Firewalls and Security The content for Verhoef Training’s WebSphereMQ Pocket Book was written by Ian Cronk. IBM MQ content is at v9. IBM MQ and WebSphere are trademarks of IBM. Copyright © Verhoef Training Ltd 2017. No part of this pocket book may be reproduced either whole or in part by any means including but not limited to photocopying scanning or imaging without the express permis- sion of Verhoef Training Ltd. 3 Contents MQ Control Commands 3 - 5 MQSC Commands 6 - 7 MQ Process List 8 QM.ini 9 - 10 MQS.ini 11 - 12 MQ SupportPacs 13 - 14 MQ Reason Codes 15 - 26 MQ Utilities for z 27 z System Parameters 28 - 31 MQ Certification 32 - 33 MQ Quick Reference 34 - 35 Verhoef’s MQ Courses 36 MQ Control Commands addmqinf Add IBM MQ configuration information ( Windows and UNIX platforms only). amqmdain amqmdain is used to configure or control some Windows specific administrative tasks. amqmfsck (file system check) amqmfsck checks whether a shared file system on UNIX and IBM i systems meets the requirements for storing the queue manager data of a multi- instance queue manager. crtmqcvx Create data conversion code from data type structures. crtmqdir [V9] Create, check, and correct IBM MQ directories and files. crtmqenv Create a list of environment variables for an installation of IBM MQ, on UNIX, Linux, and Windows. crtmqinst Create installation entries in mqinst.ini on UNIX and Linux systems. crtmqm Create a queue manager. dspmq Display information about queue managers. The equivalent utility to dspmq on z/OS® is CSQUDSPM. 3 dspmqinst Display installation entries from mqinst.ini on UNIX, Linux, and Windows. dspmqrte Determine the route that a message has taken through a queue manager network. dspmqspl Use the dspmqspl command to display a list of all policies and details of a named policy. dspmqtrc Format and display IBM MQ trace. dspmqtrn Display in-doubt and heuristically completed transactions. dspmqver Display IBM MQ version and build information. dspmqweb (display mqweb server configuration) [V9] Display information about the status of the mqweb server. The mqweb server is used to support the IBM MQ Console and administrative REST API. endmqcsv Stop the command server for a queue manager. endmqlsr End all listener process for a queue manager. endmqdnm Stop the .NET monitor for a queue ( Windows only). endmqm Stop a queue manager or switch to a standby queue manager. endmqsvc End the IBM MQ service on Windows. endmqtrc End trace for some or all of the entities that are being traced. endmqweb (end mqweb server) [V9] Stop the mqweb server that is used to support the IBM MQ Console and administrative REST API. mqcertck (certify TLS setup) Use the mqcertck command to diagnose potential SSL or TLS problems with your queue managers. mqconfig Checks that the system configuration meets the requirements to run IBM MQ ( UNIX and Linux platforms only). MQExplorer (launch MQ Explorer ) Start MQ Explorer ( Windows and Linux x86-64 platforms only). mqrc (MQ return code) Display information about return codes. rcdmqimg Write the image of an object or group of objects to the log for media recovery. rcrmqobj Re-create an object, or group of objects, from their images contained in the log. rmvmqinf Remove IBM MQ configuration information ( Windows and UNIX platforms only). rsvmqtrn Resolve in-doubt and heuristically completed transactions runmqbcb (run IBM MQ Bridge to Blockchain) [z/OS – v9] Configure and run the IBM MQ Bridge to Blockchain. runmqccred (obfuscate passwords for mqccred exit) Obfuscate passwords in the .ini file used by the mqccred security exit. runmqchi Run a channel initiator process to automate starting channels. runmqchl Start a sender or requester channel 4 5 runmqdlq Start the dead-letter queue handler to monitor and process messages on the dead-letter queue. runmqdnm Start processing messages on a queue using the .NET monitor ( Windows only). runmqlsr Run a listener process to listen for remote requests on various communication protocols. runmqras Use the runmqras command to gather IBM MQ diagnostic information together into a single archive, for example to submit to IBM Support. runmqsc Run IBM MQ commands on a queue manager. runmqsfb [Linux - V9] Configure and run the IBM MQ Bridge to Salesforce. runmqtmc Start the trigger monitor on a client. runmqtrm Start the trigger monitor on a server. runswchl runswchl (switch cluster channel) on UNIX, Linux, and Windows. setmqaut Change the authorizations to a profile, object, or class of objects. Authorizations can be granted to, or revoked from, any number of principals or groups. setmqcrl Administer CRL (certificate revocation list) LDAP definitions in an Active Directory ( Windows only). setmqenv Use the setmqenv command to set up the IBM MQ environment on UNIX, Linux, and Windows. setmqinst Set IBM MQ installations, on UNIX, Linux, and Windows. setmqm Set the associated installation of a queue manager. setmqprd Enroll an IBM MQ production license. setmqscp Publish client connection channel definitions in an Active Directory ( Windows only). setmqspl Use the setmqspl command to define a new security policy, alter an already existing one, or remove an existing policy. setmqxacred (add XA credentials) Use the setmqxacred command to add or modify credentials in the IBM MQ XA credentials store. strmqcfg Start MQ Explorer ( Windows and Linux x86-64 platforms only). strmqcsv Start the command server for a queue manager. strmqsvc Start the IBM MQ service on Windows. strmqm Start a queue manager or ready it for standby operation. strmqtrc Enable trace at a specified level of detail, or report the level of tracing in effect. strmqweb (start mqweb server) [V9] Start the mqweb server that is used to support the IBM MQ Console and administrative REST API. 5 MQSC Commands ALTER AUTHINFO AMQP channel ALTER BUFFPOOL DEFINE CHANNEL (MQTT) ALTER CFSTRUCT DEFINE COMMINFO ALTER CHANNEL DEFINE LISTENER Sender channel DEFINE LOG Server channel DEFINE MAXSMSGS Receiver channel Requester channel DEFINE NAMELIST Client-connection channel DEFINE PROCESS Server-connection channel DEFINE PSID Cluster-sender channel DEFINE queues Cluster-receiver channel DEFINE QALIAS AMQP channel DEFINE QLOCAL ALTER CHANNEL (MQTT) DEFINE QMODEL ALTER COMMINFO DEFINE QREMOTE ALTER LISTENER DEFINE SERVICE ALTER NAMELIST DEFINE STGCLASS ALTER PROCESS DEFINE SUB ALTER PSID DEFINE TOPIC ALTER QMGR DELETE AUTHINFO ALTER queues DELETE AUTHREC ALTER QALIAS DELETE BUFFPOOL ALTER QLOCAL DELETE CFSTRUCT ALTER QMODEL DELETE CHANNEL ALTER QREMOTE DELETE CHANNEL (MQTT) ALTER SECURITY DELETE COMMINFO ALTER SERVICE DELETE LISTENER ALTER SMDS DELETE NAMELIST ALTER STGCLASS DELETE POLICY ALTER SUB DELETE PROCESS ALTER TOPIC DELETE PSID ALTER TRACE DELETE queues ARCHIVE LOG DELETE QALIAS BACKUP CFSTRUCT DELETE QLOCAL CLEAR QLOCAL DELETE QMODEL CLEAR TOPICSTR DELETE QREMOTE DEFINE AUTHINFO DELETE SERVICE DEFINE BUFFPOOL DELETE SUB DEFINE CFSTRUCT DELETE STGCLASS DEFINE CHANNEL DELETE TOPIC Sender channel DISPLAY ARCHIVE Server channel DISPLAY AUTHINFO Receiver channel DISPLAY AUTHREC Requester channel DISPLAY AUTHSERV Client-connection channel DISPLAY CFSTATUS Server-connection channel DISPLAY CFSTRUCT Cluster-sender channel DISPLAY CHANNEL Cluster-receiver channel 6 7 DISPLAY CHANNEL (MQTT) PURGE CHANNEL DISPLAY CHINIT RECOVER CFSTRUCT DISPLAY CHLAUTH REFRESH CLUSTER Generic IP addresses REFRESH QMGR DISPLAY CHSTATUS REFRESH SECURITY DISPLAY CHSTATUS (AMQP) RESET CFSTRUCT DISPLAY CHSTATUS (MQTT) RESET CHANNEL DISPLAY CLUSQMGR RESET CLUSTER DISPLAY CMDSERV RESET QMGR DISPLAY COMMINFO RESET QSTATS DISPLAY CONN RESET SMDS DISPLAY ENTAUTH RESET TPIPE DISPLAY GROUP RESOLVE CHANNEL DISPLAY LISTENER RESOLVE INDOUBT DISPLAY LOG RESUME QMGR DISPLAY LSSTATUS RVERIFY SECURITY DISPLAY MAXSMSGS SET ARCHIVE DISPLAY NAMELIST SET AUTHREC DISPLAY POLICY SET CHLAUTH DISPLAY PROCESS Generic IP addresses DISPLAY PUBSUB SET LOG DISPLAY QMGR SET POLICY DISPLAY QMSTATUS SET SYSTEM DISPLAY QSTATUS START CHANNEL DISPLAY QUEUE START CHANNEL (MQTT) DISPLAY SBSTATUS START CHINIT DISPLAY SECURITY START CMDSERV DISPLAY SERVICE START LISTENER DISPLAY SMDS START QMGR DISPLAY SMDSCONN START SERVICE DISPLAY STGCLASS START SMDSCONN DISPLAY SUB START TRACE DISPLAY SVSTATUS STOP CHANNEL DISPLAY SYSTEM STOP CHANNEL (MQTT) DISPLAY TCLUSTER STOP CHINIT DISPLAY THREAD STOP CMDSERV DISPLAY TOPIC STOP CONN DISPLAY TPSTATUS STOP LISTENER DISPLAY TRACE STOP QMGR DISPLAY USAGE STOP SERVICE MOVE QLOCAL STOP SMDSCONN PING CHANNEL STOP TRACE PING QMGR SUSPEND QMGR 7 MQ Process List (Linux and UNIX) amqzmuc0 Critical process manager amqzxma0 Execution controller amqzfuma OAM process amqzlaa0 LQM agents amqzlsa0 LQM agents amqzmuf0 Utility Manager amqzmur0 Restartable process manager amqzmgr0 Process controller amqfqpub Publish Subscribe process amqfcxba Broker worker process amqrmppa Process pooling process amqcrsta Non-threaded responder job process amqcrs6b LU62 receiver