Summary of the content on the page No. 1
®
MQSeries
MQSC Command Reference
SC33-1369-13
Summary of the content on the page No. 2
Summary of the content on the page No. 3
® MQSeries MQSC Command Reference SC33-1369-13
Summary of the content on the page No. 4
Note! Before using this information and the product it supports, be sure to read the general information under “Appendix. Notices” on page 287. Fourteenth edition (November 2000) This edition applies to the following products: ® v MQSeries for AIX Version 5.1 ® v MQSeries for AS/400 Version 5 Release 1 ® v MQSeries for AT&T GIS UNIX Version 2 Release 2 v MQSeries for Compaq (DIGITAL) OpenVMS AXP Version 2 Release 2.1 v MQSeries for Compaq (DIGITAL) OpenVMS VAX Version 2 Release 2.1 | v MQSeries
Summary of the content on the page No. 5
Contents CLEAR QLOCAL ............54 Tables ............... v Parameter descriptions .........54 DEFINE BUFFPOOL ...........56 About this book........... vii Parameter descriptions .........56 Who this book is for ...........vii DEFINE CHANNEL ...........57 What you need to know to understand this book vii Sender channel ............58 How to use this book...........vii Server channel ............61 Receiver channel ...........64 Summary of changes......... ix Requester channel ...........66 ||
Summary of the content on the page No. 6
Parameter descriptions .........175 RVERIFY SECURITY...........251 Usagenotes.............176 Parameter descriptions .........251 || DISPLAY GROUP............177 || SETLOG...............252 || Usagenotes.............177 || Parameter descriptions .........252 || DISPLAY LOG.............178 || Usagenotes.............253 || Parameter descriptions .........178 STARTCHANNEL ...........254 || Usagenotes.............178 Parameter descriptions .........255 DISPLAY MAXSMSGS ..........180 STARTCHINIT.....
Summary of the content on the page No. 7
Tables 1. Howtoreadsyntaxdiagrams.......7 | 8. CHLDISP and CMDSCOPE for RESOLVE | 2. CHLDISP and CMDSCOPE for DISPLAY || CHANNEL ............247 || CHSTATUS CURRENT ........167 | 9. CHLDISP and CMDSCOPE for START | 3. CHLDISP and CMDSCOPE for DISPLAY || CHANNEL ............256 || CHSTATUSSHORT .........167 10. Destinations allowed for each trace type 267 | 4. CHLDISP and CMDSCOPE for DISPLAY 11. Constraints allowed for each trace type 267 || CHSTATUSSAVED .........167 12. IFCID descriptions for
Summary of the content on the page No. 8
vi MQSeries MQSC Command Reference
Summary of the content on the page No. 9
About this book This book describes the MQSeries commands (MQSC), which system operators and administrators can use to manage queue managers on the following MQSeries platforms: v Compaq (DIGITAL) OpenVMS v OS/2 Warp v OS/390 ® v OS/400 v Tandem NSK v UNIX operating systems v Windows NT | The commands are described in alphabetic order in “Chapter 2. The MQSeries | commands” on page 9. At the start of each command description, the platforms on | which you can use the command are shown. The term “
Summary of the content on the page No. 10
About this book When you have decided which commands you need to use, use this book to learn their syntax. The syntax of the MQSeries commands is represented in syntax diagrams. To learn how to read these diagrams, see “How to read syntax diagrams” on page 7. The parameters for each command are listed in the following order in the syntax diagrams: v Parameters that are required are listed first, in alphabetic order. v Parameters that are optional follow, again in alphabetic order. There is a glo
Summary of the content on the page No. 11
Summary of changes This section describes changes in this edition of MQSeries MQSC Command Reference. Changes since the previous edition of the book are marked by vertical lines to the left of the changes. | Changes for this edition (SC33-1369-13) | v The name of the book for this edition has been changed to MQSC Command | Reference. | v The text for the ALTER and DEFINE object commands has been merged. | v This edition includes the following new product release, MQSeries for OS/390 | V5.2 | The
Summary of the content on the page No. 12
Changes | | Changes for the previous edition (SC33-1369-12) | The thirteenth edition was not published. Changes for the twelth edition (SC33-1369-11) This edition included the following new product releases: v MQSeries for AS/400 V5.1 v MQSeries for Tandem NonStop Kernel V2.2.0.1 and the following new product: v MQSeries for Digital UNIX (Compaq Tru64 UNIX) V2.2.1 Changes for the eleventh edition (SC33-1369-10) This edition included the following additions: v Queue manager clusters were added to
Summary of the content on the page No. 13
Changes – DEFINE QREMOTE – DELETE CHANNEL – DISPLAY CHANNEL – DISPLAY CHSTATUS – DISPLAY QUEUE – DISPLAY PROCESS – DISPLAY STGCLASS – DISPLAY THREAD – DISPLAY USAGE – PING CHANNEL – REFRESH SECURITY – RESET CHANNEL – RESOLVE CHANNEL – RESOLVE INDOUBT – START CHANNEL – START CHINIT – START LISTENER – STOP CHANNEL – STOP CHINIT Summary of changes xi
Summary of the content on the page No. 14
Changes xii MQSeries MQSC Command Reference
Summary of the content on the page No. 15
Chapter 1. Using MQSeries commands MQSeries commands (MQSC) provide a uniform method of issuing human-readable commands on MQSeries platforms. For information about programmable command format (PCF) commands (not available on OS/390), see the MQSeries Programmable System Management manual. This chapter describes: v “Rules for using MQSeries commands” v “Rules for naming MQSeries objects” on page 4 v “How to read syntax diagrams” on page 7 The general format of the commands is shown in “Chapter 2
Summary of the content on the page No. 16
Rules for using commands – A single asterisk (for example, TRACE(*)) (on OS/400 these must be enclosed in single quotation marks) – A range specification containing a colon (for example, CLASS(01:03)) If the string itself contains a quotation mark, the quotation mark is represented by two single quotation marks. Lowercase characters not contained within quotation marks are folded to uppercase. v A string containing no characters (that is, two single quotation marks with no space in between) is n
Summary of the content on the page No. 17
Rules for using commands v The STRMQMMQSC command on OS/400 v The runmqsc command on Compaq (DIGITAL) OpenVMS, OS/2 Warp, Tandem NSK, UNIX systems, and Windows NT When you do this, follow these rules: v Each command must start on a new line. v On each platform, there might be platform-specific rules about the line length and record format. If scripts are to be readily portable to different platforms, the significant length of each line should be restricted to 72 characters. – On OS/390, scripts
Summary of the content on the page No. 18
Rules for using commands v A line starting with an asterisk (*) in the first position is ignored. This can be used to insert comments into the file. A blank line is also ignored. If a line ends with a continuation character (− or +), the command continues with the next line that is not a comment line or a blank line. Rules for naming MQSeries objects MQSeries queue, process, namelist, channel, and storage class objects exist in separate object name spaces, and so objects from each type can all h
Summary of the content on the page No. 19
Rules for naming objects Reserved queue names Names that start with “SYSTEM.” are reserved for queues defined by the queue manager. You can use the ALTER or DEFINE REPLACE commands to change these queue definitions to suit your installation. The following names are defined for MQSeries: SYSTEM.ADMIN.CHANNEL.EVENT Queue for channel events SYSTEM.ADMIN.COMMAND.QUEUE Queue to which PCF command messages are sent (not for OS/390) SYSTEM.ADMIN.PERFM.EVENT Queue for performance events SYSTEM.ADMIN.QMGR
Summary of the content on the page No. 20
Rules for naming objects Other object names Processes, namelists, and clusters can have names up to 48 bytes long. Channels can have names up to 20 bytes long. Storage classes can have names up to 8 bytes long. Reserved object names Names that start with “SYSTEM.” are reserved for objects defined by the queue manager. You can use the ALTER or DEFINE REPLACE commands to change these object definitions to suit your installation. The following names are defined for MQSeries: SYSTEM.ADMIN.SVRCONN Se
