MQSeries MQSC Command Reference

MQSeries MQSC Command Reference SC33-1369-13

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 for Compaq Tru64 UNIX Version 5 Release 1 v MQSeries for HP-UX Version 5.1 v MQSeries for OS/2 Warp Version 5.1 v MQSeries for OS/390 Version 5 Release 2 v MQSeries for SINIX and DC/OSx Version 2 Release 2 v MQSeries for Sun Solaris Version 5.1 v MQSeries for Sun Solaris, Intel Platform Edition, Version 5 Release 1 v MQSeries for Tandem NonStop Kernel Version 2 Release 2.0.1 v MQSeries for Windows NT Version 5.1 and to all subsequent releases and modifications until otherwise indicated in new editions. Copyright International Business Machines Corporation 1993, 2000. All rights reserved. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents Tables............... v About this book........... vii Who this book is for........... vii What you need to know to understand this book vii How to use this book........... vii Summary of changes......... ix Changes for this edition (SC33-1369-13)..... ix Changes for the previous edition (SC33-1369-12).. x Changes for the twelth edition (SC33-1369-11)... x Changes for the eleventh edition (SC33-1369-10).. x Chapter 1. Using MQSeries commands 1 Rules for using MQSeries commands...... 1 Characters with special meanings...... 2 Building command scripts......... 2 Rules for naming MQSeries objects....... 4 Queue names............. 4 Other object names........... 6 How to read syntax diagrams........ 7 Chapter 2. The MQSeries commands.. 9 ALTER CHANNEL............ 10 Sender channel............ 11 Server channel............ 13 Receiver channel........... 15 Requester channel........... 17 Client-connection channel........ 20 Server-connection channel........ 22 Cluster-sender channel......... 24 Cluster-receiver channel......... 26 Parameter descriptions......... 27 ALTER NAMELIST............ 28 Parameter descriptions......... 28 ALTER PROCESS............ 29 Parameter descriptions......... 29 ALTER QMGR............. 30 Parameter descriptions......... 31 ALTER Queues............. 39 ALTER QALIAS............ 39 ALTER QLOCAL........... 41 ALTER QMODEL........... 43 ALTER QREMOTE........... 45 Parameter descriptions......... 45 ALTER SECURITY............ 46 Parameter descriptions......... 46 ALTER STGCLASS............ 48 Parameter descriptions......... 48 ALTER TRACE............. 49 Parameter descriptions......... 49 ARCHIVE LOG............. 51 Parameter descriptions......... 51 Usage notes............. 52 CLEAR QLOCAL............ 54 Parameter descriptions......... 54 DEFINE BUFFPOOL........... 56 Parameter descriptions......... 56 DEFINE CHANNEL........... 57 Sender channel............ 58 Server channel............ 61 Receiver channel........... 64 Requester channel........... 66 Client-connection channel........ 68 Server-connection channel........ 70 Cluster-sender channel......... 72 Cluster-receiver channel......... 74 Parameter descriptions......... 76 DEFINE MAXSMSGS........... 93 Parameter descriptions......... 93 DEFINE NAMELIST........... 95 Parameter descriptions......... 96 DEFINE PROCESS............ 99 Parameter descriptions......... 100 DEFINE PSID............. 105 Parameter descriptions......... 105 DEFINE queues............ 106 DEFINE QALIAS........... 106 DEFINE QLOCAL........... 108 DEFINE QMODEL.......... 110 DEFINE QREMOTE.......... 113 Parameter descriptions......... 114 Usage notes............. 131 DEFINE STGCLASS........... 132 Parameter descriptions......... 132 Usage notes............. 135 DELETE CHANNEL........... 136 Parameter descriptions......... 136 DELETE NAMELIST........... 139 Parameter descriptions......... 139 DELETE PROCESS........... 141 Parameter descriptions......... 141 DELETE queues............ 143 DELETE QALIAS........... 143 DELETE QLOCAL.......... 144 DELETE QMODEL.......... 145 DELETE QREMOTE.......... 145 Parameter descriptions......... 146 DELETE STGCLASS........... 148 Parameter descriptions......... 148 DISPLAY CHANNEL........... 150 Parameter descriptions......... 152 DISPLAY CHSTATUS........... 157 Parameter descriptions......... 158 Usage notes............. 166 DISPLAY CLUSQMGR.......... 168 Parameter descriptions......... 169 DISPLAY CMDSERV........... 174 Usage notes............. 174 DISPLAY DQM............. 175 Copyright IBM Corp. 1993, 2000 iii

Parameter descriptions......... 175 Usage notes............. 176 DISPLAY GROUP............ 177 Usage notes............. 177 DISPLAY LOG............. 178 Parameter descriptions......... 178 Usage notes............. 178 DISPLAY MAXSMSGS.......... 180 Parameter descriptions......... 180 DISPLAY NAMELIST........... 181 Parameter descriptions......... 181 DISPLAY PROCESS........... 184 Parameter descriptions......... 185 DISPLAY QMGR............ 187 Parameter descriptions......... 189 DISPLAY QSTATUS........... 193 Parameter descriptions......... 194 DISPLAY QUEUE............ 200 Parameter descriptions......... 203 DISPLAY SECURITY........... 213 Parameter descriptions......... 213 DISPLAY STGCLASS........... 215 Parameter descriptions......... 215 DISPLAY THREAD........... 218 Parameter descriptions......... 218 DISPLAY TRACE............ 220 Parameter descriptions......... 221 DISPLAY USAGE............ 223 Parameter descriptions......... 223 MOVE QLOCAL............ 225 Parameter descriptions......... 225 Usage notes............. 226 PING CHANNEL............ 228 Parameter descriptions......... 229 PING QMGR............. 231 RECOVER BSDS............ 232 Parameter descriptions......... 232 REFRESH CLUSTER........... 233 Parameter descriptions......... 233 REFRESH SECURITY........... 234 Parameter descriptions......... 234 RESET CHANNEL........... 236 Parameter descriptions......... 237 RESET CLUSTER............ 239 Parameter descriptions......... 239 RESET QSTATS............. 241 Parameter descriptions......... 241 Usage notes............. 242 RESET TPIPE............. 243 Parameter descriptions......... 243 RESOLVE CHANNEL.......... 245 Parameter descriptions......... 245 Usage notes............. 247 RESOLVE INDOUBT........... 248 Parameter descriptions......... 248 RESUME QMGR............ 250 Parameter descriptions......... 250 RVERIFY SECURITY........... 251 Parameter descriptions......... 251 SET LOG............... 252 Parameter descriptions......... 252 Usage notes............. 253 START CHANNEL........... 254 Parameter descriptions......... 255 START CHINIT............. 258 MQSeries for OS/390.......... 258 MQSeries on other platforms....... 258 Parameter descriptions......... 258 START CMDSERV............ 260 Usage notes............. 260 START LISTENER............ 261 Parameter descriptions......... 262 START QMGR............. 264 Parameter descriptions......... 264 START TRACE............. 265 Parameter descriptions......... 266 STOP CHANNEL............ 270 Parameter descriptions......... 270 STOP CHINIT............. 274 Parameter descriptions......... 274 Usage notes............. 275 STOP CMDSERV............ 276 Usage notes............. 276 STOP LISTENER............ 277 Parameter descriptions......... 277 STOP QMGR............. 279 Parameter descriptions......... 279 STOP TRACE............. 281 Parameter descriptions......... 281 SUSPEND QMGR............ 284 Parameter descriptions......... 284 Appendix. Notices......... 287 Trademarks.............. 289 Glossary of terms and abbreviations 291 Bibliography............ 303 MQSeries cross-platform publications..... 303 MQSeries platform-specific publications.... 303 Softcopy books............. 304 HTML format............ 304 Portable Document Format (PDF)..... 304 BookManager format......... 305 PostScript format........... 305 Windows Help format......... 305 MQSeries information available on the Internet.. 305 Index............... 307 Sending your comments to IBM... 313 iv MQSeries MQSC Command Reference

Tables 1. How to read syntax diagrams....... 7 2. CHLDISP and CMDSCOPE for DISPLAY CHSTATUS CURRENT........ 167 3. CHLDISP and CMDSCOPE for DISPLAY CHSTATUS SHORT......... 167 4. CHLDISP and CMDSCOPE for DISPLAY CHSTATUS SAVED......... 167 5. Parameters that can be returned by the DISPLAY QUEUE command...... 206 6. CHLDISP and CMDSCOPE for PING CHANNEL............ 230 7. CHLDISP and CMDSCOPE for RESET CHANNEL............ 238 8. CHLDISP and CMDSCOPE for RESOLVE CHANNEL............ 247 9. CHLDISP and CMDSCOPE for START CHANNEL............ 256 10. Destinations allowed for each trace type 267 11. Constraints allowed for each trace type 267 12. IFCID descriptions for IFCID trace events and classes.............. 267 13. Resource Manager identifiers that are allowed 268 14. CHLDISP and CMDSCOPE for STOP CHANNEL............ 272 Copyright IBM Corp. 1993, 2000 v

vi MQSeries MQSC Command Reference

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 UNIX systems is used to denote the following UNIX operating systems: v MQSeries for AIX v MQSeries for AT&T GIS UNIX 1 v MQSeries for Compaq Tru64 UNIX v MQSeries for HP-UX v MQSeries for SINIX and DC/OSx v MQSeries for Sun Solaris (SPARC and Intel Platform Editions) Who this book is for This book is intended for system programmers, system administrators, and system operators. What you need to know to understand this book How to use this book To understand this book, you should be familiar with the system facilities for the platform on which you are installing the MQSeries product. If you are unfamiliar with the concepts of messaging and queuing, you should read An Introduction to Messaging and Queuing. For platforms other than OS/390, read those sections of the MQSeries Administration Guide, System Management Guide, or System Administration book for your platform that relate to the task you want to perform. For OS/390, read the sections of the MQSeries for OS/390 System Administration Guide, MQSeries for OS/390 System Setup Guide, or both that relate to the task you want to perform. These books are listed in Bibliography on page 303. 1. This platform has been renamed to NCR UNIX SVR4 MP-RAS, R3.0. Copyright IBM Corp. 1993, 2000 vii

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 glossary at the back of the book. viii MQSeries MQSC Command Reference

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 v v v v The name of the book for this edition has been changed to MQSC Command Reference. The text for the ALTER and DEFINE object commands has been merged. This edition includes the following new product release, MQSeries for OS/390 V5.2 The following commands have been added for this release: CLEAR QLOCAL supported on OS/390 DISPLAY LOG DISPLAY QSTATUS MOVE QLOCAL RESET QSTATS SET LOG Queue-sharing groups have been added to MQSeries for OS/390 V5.2 and the following command has been added to support this feature: DISPLAY GROUP Various parameters have been added to the commands in support of queue-sharing groups. The principal parameters are: CMDSCOPE This parameter has been added to all MQSeries Commands except: - DEFINE BUFFPOOL - DEFINE PSID - DISPLAY CMDSERV - DISPLAY GROUP - START CMDSERV - START QMGR - STOP CMDSERV CHLDISP This parameter has been added to the following commands: - DISPLAY CHSTATUS - PING CHANNEL - RESET CHANNEL - RESOLVE CHANNEL - START CHANNEL - STOP CHANNEL QSGDISP This parameter has been added to the ALTER, DELETE, DEFINE, and DISPLAY commands for: - Channels - Namelists - Processes - Queues - Storage classes Copyright IBM Corp. 1993, 2000 ix

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 the following products: MQSeries for AIX V5.1 MQSeries for HP-UX V5.1 MQSeries for OS/2 Warp V5.1 MQSeries for OS/390 V2.1 MQSeries for Sun Solaris V5.1 MQSeries for Windows NT V5.1 v The following Queue Manager Cluster commands were added to reflect queue manager cluster processing: DISPLAY CLUSQMGR DISPLAY QCLUSTER REFRESH CLUSTER RESET CLUSTER v The following Queue Manager commands were changed to reflect queue manager cluster processing: ALTER QMGR DISPLAY QMGR RESUME QMGR STOP QMGR SUSPEND QMGR v The following Namelist commands were changed to reflect queue manager cluster processing: ALTER NAMELIST DEFINE NAMELIST DELETE NAMELIST DISPLAY NAMELIST v Changes were also made to the following commands: ALTER CHANNEL ALTER PROCESS ALTER QALIAS ALTER QLOCAL ALTER QMODEL ALTER QREMOTE DEFINE CHANNEL DEFINE PROCESS DEFINE QALIAS DEFINE QLOCAL DEFINE QMODEL x MQSeries MQSC Command Reference

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

Changes xii MQSeries MQSC Command Reference

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. The MQSeries commands on page 9. Rules for using MQSeries commands You should observe the following rules when using MQSeries commands: v Each command starts with a primary parameter (a verb), and this is followed by a secondary parameter (a noun). This is then followed by the name or generic name of the object (in parentheses) if there is one, which there is on most commands. Following that, parameters can usually occur in any order; if a parameter has a corresponding value, the value must occur directly after the parameter to which it relates. v v v v v Note: On OS/390, the secondary parameter does not have to be second. Keywords, parentheses, and values can be separated by any number of blanks and commas. A comma shown in the syntax diagrams can always be replaced by one or more blanks. There must be at least one blank immediately preceding each parameter (after the primary parameter) except on OS/390. Any number of blanks can occur at the beginning or end of the command, and between parameters, punctuation, and values. For example, the following command is valid: ALTER QLOCAL ('Account' ) TRIGDPTH ( 1) Blanks within a pair of quotation marks are significant. Additional commas can appear anywhere where blanks are allowed and are treated as if they were blanks (unless, of course, they are inside quoted strings). Repeated parameters are not allowed. Repeating a parameter with its NO version, as in REPLACE NOREPLACE, is also not allowed. Strings that contain blanks, lowercase characters or special characters other than: Period (.) Forward slash (/) Underscore (_) Percent sign (%) must be enclosed in single quotation marks, unless they are: Issued from the MQSeries for OS/390 operations and control panels Generic names ending with an asterisk (on OS/400 these must be enclosed in single quotation marks) Copyright IBM Corp. 1993, 2000 1

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)) v v v v 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. A string containing no characters (that is, two single quotation marks with no space in between) is not valid. A left parenthesis followed by a right parenthesis, with no significant information in between, for example NAME ( ) is not valid except where specifically noted. Keywords are not case sensitive AltER, alter, and ALTER are all acceptable. Names that are not contained within quotation marks are converted to uppercase. Synonyms are defined for some parameters. For example, DEF is always a synonym for DEFINE, so DEF QLOCAL is valid. Synonyms are not, however, just minimum strings; DEFI is not a valid synonym for DEFINE. Note: There is no synonym for the DELETE parameter. This is to avoid accidental deletion of objects when using DEF, the synonym for DEFINE. Characters with special meanings The following characters have special meaning when you build MQSC commands: Blanks are used as separators. Multiple blanks are equivalent to a single blank, except in strings that have quotation marks (') round them., Commas are used as separators. Multiple commas are equivalent to a single comma, except in strings that have quotation marks (') round them. ' A single quotation mark indicates the beginning or end of a string. MQSeries leaves all characters that have quotation marks round them exactly as they are entered. The containing quotation marks are not included when calculating the length of the string. '' Two quotation marks together inside a string are treated by MQSeries as one quotation mark, and the string is not terminated. The double quotation marks are treated as one character when calculating the length of the string. ( An open parenthesis indicates the beginning of a parameter list. ) A close parenthesis indicates the end of a parameter list. : A colon indicates an inclusive range. For example (1:5) means (1,2,3,4,5). This notation can be used only in TRACE commands. * An asterisk means all. For example, DISPLAY TRACE (*) means display all traces, and DISPLAY QUEUE (PAY*) means display all queues whose names begin with PAY. When you need to use any of these special characters in a field (for example as part of a description), you must enclose the whole string in single quotation marks. Building command scripts You may want to build the MQSeries commands into a script when you use: v The CSQINP1, CSQINP2, and CSQINPX initialization data sets or the CSQUTIL batch utility on OS/390 2 MQSeries MQSC Command Reference

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 are held in a fixed-format data set, with a record length of 80. Only columns 1 through 72 can contain meaningful information; columns 73 through 80 are ignored. On AIX, HP-UX, OS/2 Warp, OS/400, Sun Solaris, and Windows NT, each line can be of any length up to the maximum allowed for your platform. On other UNIX systems, and Compaq (DIGITAL) OpenVMS, each line can be of any length up to and including 80 characters. On Tandem NSK each line can be of any length up to and including 72 characters. v A line must not end in a keyboard control character (for example, a tab). v If the last nonblank character on a line is: A minus sign ( ), this indicates that the command is to be continued from the start of the next line. A plus sign (+), this indicates that the command is to be continued from the first nonblank character in the next line. If you use + to continue a command remember to leave at least one blank before the next parameter (except on OS/390 where this is not necessary). Either of these can occur within a parameter, data value, or quoted string. For example, 'Fr+ ed' and 'Fred' Rules for using commands (where the e of the second line of the second example is in the first position of the line) are both equivalent to 'Fred' v v MQSC commands that are contained within an Escape PCF (Programmable Command Format) command cannot be continued in this way. The entire command must be contained within a single Escape command. (For information about the PCF commands, see the MQSeries Programmable System Management manual.) + and values used at the ends of lines are discarded when the command is reassembled into a single string. On AIX, HP-UX, OS/2 Warp, OS/400, Sun Solaris, and Windows NT you can use a semicolon character (;) to terminate a command, even if you have entered a + character at the end of the previous line. You can also use the semicolon in the same way on OS/390 for commands issued from the CSQUTIL batch utility program. Chapter 1. Using MQSeries commands 3

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 have the same name. However, an object cannot have the same name as any other object in the same name space. (For example, a local queue cannot have the same name as a model queue.) Names in MQSeries are case sensitive; however, you should remember that lowercase characters that are not contained within quotation marks are folded to uppercase. The character set that can be used for naming all MQSeries objects is as follows: v Uppercase A Z v Lowercase a z (however, on systems using EBCDIC Katakana you cannot use lowercase characters, and there are also restrictions on the use of lowercase letters for OS/390 console support) v Numerics 0 9 v Period (.) v Forward slash (/) v Underscore (_) v Percent sign (%). The percent sign (%) is a special character to RACF. If you are using RACF as the external security manager for MQSeries for OS/390, you should not use % in object names. If you do, these names are not included in any security checks when RACF generic profiles are used. Notes: 1. Leading or embedded blanks are not allowed. 2. You should avoid using names with leading or trailing underscores, because they cannot be handled by the MQSeries for OS/390 operations and control panels. 3. Any name that is less than the full field length can be padded to the right with blanks. All short names that are returned by the queue manager are always padded to the right with blanks. 4. Any structure to the names (for example, the use of the period or underscore) is not significant to the queue manager. 5. When using CL commands or menus on AS/400 systems, lowercase a-z, forward slash (/), and percent (%) are special characters. If you use any of these characters in a name, the name must be enclosed in quotation marks. Lowercase a-z characters are changed to uppercase if the name is not enclosed in quotation marks. Queue names Queues can have names up to 48 characters long. 4 MQSeries MQSC Command Reference

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 SYSTEM.ADMIN.COMMAND.QUEUE SYSTEM.ADMIN.PERFM.EVENT SYSTEM.ADMIN.QMGR.EVENT SYSTEM.CHANNEL.COMMAND SYSTEM.CHANNEL.INITQ SYSTEM.CHANNEL.REPLY.INFO SYSTEM.CHANNEL.SEQNO SYSTEM.CHANNEL.SYNCQ SYSTEM.CICS.INITIATION.QUEUE SYSTEM.CLUSTER.COMMAND.QUEUE SYSTEM.CLUSTER.REPOSITORY.QUEUE SYSTEM.CLUSTER.TRANSMIT.QUEUE SYSTEM.COMMAND.INPUT SYSTEM.COMMAND.REPLY.MODEL SYSTEM.DEAD.LETTER.QUEUE SYSTEM.DEFAULT.ALIAS.QUEUE SYSTEM.DEFAULT.INITIATION.QUEUE SYSTEM.DEFAULT.LOCAL.QUEUE SYSTEM.DEFAULT.MODEL.QUEUE SYSTEM.DEFAULT.REMOTE.QUEUE SYSTEM.MQSC.REPLY.QUEUE SYSTEM.QSG.CHANNEL.SYNCQ SYSTEM.QSG.TRANSMIT.QUEUE Queue for channel events Queue to which PCF command messages are sent (not for OS/390) Queue for performance events Queue for queue-manager events Queue used for distributed queuing on OS/390 using CICS Queue used for distributed queuing (without CICS on OS/390) Queue used for distributed queuing on OS/390 without CICS Queue used for distributed queuing on OS/390 using CICS Queue used for distributed queuing (without CICS on OS/390) Queue used for triggering (not for OS/390) Queue used to communicate repository changes between queue managers (AIX, HP-UX, OS/2 Warp, OS/390, OS/400, Sun Solaris, and Windows NT only) Queue used to hold information about the repository (AIX, HP-UX, OS/2 Warp, OS/390, OS/400, Sun Solaris, and Windows NT only) Transmission queue for all destinations managed by cluster support (AIX, HP-UX, OS/2 Warp, OS/390, OS/400, Sun Solaris, and Windows NT only) Queue to which command messages are sent on OS/390 Model queue definition for command replies (for OS/390) Dead-letter queue (not for OS/390) Default alias queue definition Queue used to trigger a specified process (not for OS/390) Default local queue definition Default model queue definition Default remote queue definition Model queue definition for MQSC command replies (not for OS/390) Shared local queue used for storing messages that contain the synchronization information for shared channels (OS/390 only) Shared local queue used by the intra-group queuing agent when transmitting messages between queue managers in the same queue-sharing group (OS/390 only) Chapter 1. Using MQSeries commands 5

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 SYSTEM.AUTO.RECEIVER SYSTEM.AUTO.SVRCONN SYSTEM.DEF.CLNTCONN SYSTEM.DEF.CLUSRCVR SYSTEM.DEF.CLUSSDR SYSTEM.DEF.RECEIVER SYSTEM.DEF.REQUESTER SYSTEM.DEF.SENDER SYSTEM.DEF.SERVER SYSTEM.DEF.SVRCONN SYSTEM.DEFAULT.NAMELIST SYSTEM.DEFAULT.PROCESS SYSTEMST Server-connection channel used for remote administration of a queue manager by the MQSeries Explorer (remote administration is not available on OS/390) Default receiver channel for auto definition (not for AT&T GIS UNIX, Compaq (DIGITAL) OpenVMS, Digital UNIX (Compaq Tru64 UNIX), OS/390, SINIX and DC/OSx, or Tandem NSK) Default server-connection channel for auto definition (not for AT&T GIS UNIX, Compaq (DIGITAL) OpenVMS, Digital UNIX (Compaq Tru64 UNIX), OS/390, SINIX and DC/OSx, or Tandem NSK) Default client-connection channel definition Default cluster-receiver channel definition (AIX, HP-UX, OS/2 Warp, OS/390, OS/400, Sun Solaris, and Windows NT only) Default cluster-sender channel definition (AIX, HP-UX, OS/2 Warp, OS/390, OS/400, Sun Solaris, and Windows NT only) Default receiver channel definition Default requester channel definition Default sender channel definition Default server channel definition Default server-connection channel definition Default namelist definition (AIX, HP-UX, OS/2 Warp, OS/390, OS/400, Sun Solaris, and Windows NT only) Default process definition Default storage class definition (OS/390 only) 6 MQSeries MQSC Command Reference

How to read syntax diagrams This book contains syntax diagrams (sometimes referred to as railroad diagrams). Each syntax diagram begins with a double right arrow and ends with a right and left arrow pair. Lines beginning with a single right arrow are continuation lines. You read a syntax diagram from left to right and from top to bottom, following the direction of the arrows. Other conventions used in syntax diagrams are: Table 1. How to read syntax diagrams Convention Meaning A B C Syntax diagrams You must specify values A, B, and C. Required values are shown on the main line of a syntax diagram. A You may specify value A. Optional values are shown below the main line of a syntax diagram. A B C Values A, B, and C are alternatives, one of which you must specify. A B C Values A, B, and C are alternatives, one of which you may specify., A B C You may specify one or more of the values A, B, and C. Any required separator for multiple or repeated values (in this example, the comma (,)) is shown on the arrow. Chapter 1. Using MQSeries commands 7

Syntax diagrams Table 1. How to read syntax diagrams (continued) Convention Meaning, You may specify value A multiple times. The separator in this example is optional. A A B C Values A, B, and C are alternatives, one of which you may specify. If you specify none of the values shown, the default A (the value shown above the main line) is used. Name The syntax fragment Name is shown separately from the main syntax diagram. Name: A B Punctuation and uppercase values Lowercase values (for example, name) Specify exactly as shown. Supply your own text in place of the name variable. 8 MQSeries MQSC Command Reference

Chapter 2. The MQSeries commands This chapter describes, in alphabetic order, all the MQSeries commands (MQSC) that can be issued by operators and administrators. Copyright IBM Corp. 1993, 2000 9

ALTER CHANNEL ALTER CHANNEL Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U U U U U U U Use ALTER CHANNEL to alter the parameters of a channel. Notes: 1. On OS/390, this is valid only for channels used for distributed queuing without CICS. If you are using CICS for distributed queuing, the equivalent function is available using the CKMC transaction. See the MQSeries Intercommunication manual. 2. For cluster-sender channels, you can only alter channels that have been created manually. Synonym: ALT CHL There is a separate syntax diagram for each type of channel: v Sender channel on page 11 v Server channel on page 13 v Receiver channel on page 15 v Requester channel on page 17 v Client-connection channel on page 20 v Server-connection channel on page 22 v Cluster-sender channel on page 24 v Cluster-receiver channel on page 26 10 MQSeries MQSC Command Reference

Sender channel ALTER CHANNEL ALTER CHANNEL ALTER CHANNEL(channel-name) (1) CHLTYPE(SDR) (3) BATCHINT(integer) BATCHSZ(integer) CMDSCOPE( ) (2) CMDSCOPE(qmgr-name) (11) CMDSCOPE(*) (11) CONNAME(string) CONVERT( NO ) YES DESCR(string) DISCINT(integer) (3) HBINT(integer) LONGRTY(integer) LONGTMR(integer) MAXMSGL(integer) MCANAME(string) (4) MCATYPE( PROCESS ) THREAD MCAUSER(string) (5) MODENAME(string), (6) MSGDATA( string ), (6) MSGEXIT( string ) NPMSPEED( FAST ) NORMAL (3) (5) (7) PASSWORD(string) QSGDISP(QMGR) (2) QSGDISP(COPY) (11) QSGDISP(GROUP) QSGDISP(PRIVATE),, (6) (6) RCVDATA( string ) RCVEXIT( string ) Chapter 2. The MQSeries commands 11

ALTER CHANNEL SCYDATA(string) SCYEXIT(string), (6) SENDDATA( string ), (6) SENDEXIT( string ) SEQWRAP(integer) SHORTRTY(integer) SHORTTMR(integer) (5) TPNAME(string) (8) TRPTYPE( DECNET ) LU62 (9) NETBIOS (9) SPX TCP (10) UDP (5) (7) USERID(string) XMITQ(string) Notes: 1 This parameter must follow immediately after the channel name except on OS/390. 2 Valid only on OS/390. 3 Valid only on AIX, HP-UX, OS/2 Warp, OS/390, OS/400, Sun Solaris, and Windows NT. 4 Valid only on AIX, HP-UX, OS/2 Warp, OS/400, Sun Solaris, and Windows NT. 5 Valid only if TRPTYPE is LU62. 6 You can specify more than one value on AIX, HP-UX, OS/2 Warp, OS/400, Sun Solaris, and Windows NT only. 7 Not valid on OS/390. 8 Valid only on Compaq (DIGITAL) OpenVMS. 9 Valid only on OS/2 Warp and Windows NT. 10 Valid only on AIX. 11 Valid only when the queue manager is a member of a queue-sharing group. You can use queue-sharing groups only on MQSeries for OS/390. 12 MQSeries MQSC Command Reference

Server channel ALTER CHANNEL ALTER CHANNEL ALTER CHANNEL(channel-name) (1) CHLTYPE(SVR) AUTOSTART( DISABLED ) ENABLED (2) (3) BATCHINT(integer) BATCHSZ(integer) CMDSCOPE( ) (5) CMDSCOPE(qmgr-name) (12) CMDSCOPE(*) (12) CONNAME(string) CONVERT( NO ) YES DESCR(string) DISCINT(integer) (3) HBINT(integer) LONGRTY(integer) LONGTMR(integer) MAXMSGL(integer) MCANAME(string) (4) MCATYPE( PROCESS ) THREAD MCAUSER(string) (6) MODENAME(string),, (7) (7) MSGDATA( string ) MSGEXIT( string ) NPMSPEED( FAST ) NORMAL (3) (6) (8) PASSWORD(string) QSGDISP(QMGR) (5) QSGDISP(COPY) (12) QSGDISP(GROUP) QSGDISP(PRIVATE), (7) RCVDATA( string ) Chapter 2. The MQSeries commands 13

ALTER CHANNEL, (7) RCVEXIT( string ) SCYDATA(string) SCYEXIT(string),, (7) (7) SENDDATA( string ) SENDEXIT( string ) SEQWRAP(integer) SHORTRTY(integer) SHORTTMR(integer) (6) TPNAME(string) (9) TRPTYPE( DECNET ) LU62 (10) NETBIOS (10) SPX TCP (11) UDP (6) (8) USERID(string) XMITQ(string) Notes: 1 This parameter must follow immediately after the channel name except on OS/390. 2 Valid only on Tandem NSK when TRPTYPE is LU62. 3 Valid only on AIX, HP-UX, OS/2 Warp, OS/390, OS/400, Sun Solaris, and Windows NT. 4 Valid only on AIX, HP-UX, OS/2 Warp, OS/400, Sun Solaris, and Windows NT. 5 Valid only on OS/390. 6 Valid only if TRPTYPE is LU62. 7 You can specify more than one value on AIX, HP-UX, OS/2 Warp, OS/400, Sun Solaris, and Windows NT only. 8 Not valid on OS/390. 9 Valid only on Compaq (DIGITAL) OpenVMS. 10 Valid only on OS/2 Warp and Windows NT. 11 Valid only on AIX. 12 Valid only when the queue manager is a member of a queue-sharing group. You can use queue-sharing groups only on MQSeries for OS/390. 14 MQSeries MQSC Command Reference

Receiver channel ALTER CHANNEL ALTER CHANNEL ALTER CHANNEL(channel-name) CHLTYPE(RCVR) (1) AUTOSTART( DISABLED ) ENABLED (2) BATCHSZ(integer) CMDSCOPE( ) (6) CMDSCOPE(qmgr-name) (10) CMDSCOPE(*) (10) DESCR(string) (3) HBINT(integer) MAXMSGL(integer) MCAUSER(string) (4) MRDATA(string) (4) MREXIT(string) (4) MRRTY(integer) (4) MRTMR(integer), (5) MSGDATA( string ), (5) MSGEXIT( string ) NPMSPEED( FAST ) NORMAL (3) PUTAUT( DEF ) CTX (6) ONLYMCA (6) ALTMCA QSGDISP(QMGR) (6) QSGDISP(COPY) (10) QSGDISP(GROUP) QSGDISP(PRIVATE),, (5) (5) RCVDATA( string ) RCVEXIT( string ) Chapter 2. The MQSeries commands 15

ALTER CHANNEL SCYDATA(string) SCYEXIT(string), (5) SENDDATA( string ), (5) SENDEXIT( string ) SEQWRAP(integer) (7) TRPTYPE( DECNET ) LU62 (8) NETBIOS (8) SPX TCP (9) UDP Notes: 1 This parameter must follow immediately after the channel name except on OS/390. 2 Valid only on Tandem NSK when TRPTYPE is LU62. 3 Valid only on AIX, HP-UX, OS/2 Warp, OS/390, OS/400, Sun Solaris, and Windows NT. 4 Not valid on OS/390. 5 You can specify more than one value on AIX, HP-UX, OS/2 Warp, OS/400, Sun Solaris, and Windows NT only. 6 Valid only on OS/390. 7 Valid only on Compaq (DIGITAL) OpenVMS. 8 Valid only on OS/2 Warp and Windows NT. 9 Valid only on AIX. 10 Valid only when the queue manager is a member of a queue-sharing group. You can use queue-sharing groups only on MQSeries for OS/390. 16 MQSeries MQSC Command Reference

Requester channel ALTER CHANNEL ALTER CHANNEL ALTER CHANNEL(channel-name) CHLTYPE(RQSTR) (1) AUTOSTART( DISABLED ) ENABLED (2) BATCHSZ(integer) CMDSCOPE( ) (8) CMDSCOPE(qmgr-name) (12) CMDSCOPE(*) (12) CONNAME(string) DESCR(string) (3) HBINT(integer) MAXMSGL(integer) MCANAME(string) MCATYPE( PROCESS ) THREAD (4) MCAUSER(string) (6) MODENAME(string) (5) MRDATA(string) (5) MREXIT(string) (5) MRRTY(integer) (5) MRTMR(integer), (7) MSGDATA( string ), (7) MSGEXIT( string ) NPMSPEED( FAST ) NORMAL (3) (5) (6) PASSWORD(string) PUTAUT( DEF ) CTX (8) ONLYMCA (8) ALTMCA Chapter 2. The MQSeries commands 17

ALTER CHANNEL QSGDISP(QMGR) (8) QSGDISP(COPY) (12) QSGDISP(GROUP) QSGDISP(PRIVATE), (7) RCVDATA( string ), (7) RCVEXIT( string ) SCYDATA(string) SCYEXIT(string),, (7) (7) SENDDATA( string ) SENDEXIT( string ) SEQWRAP(integer) (6) TPNAME(string) (9) TRPTYPE( DECNET ) LU62 (10) NETBIOS (10) SPX TCP (11) UDP (5) (6) USERID(string) Notes: 1 This parameter must follow immediately after the channel name except on OS/390. 2 Valid only on Tandem NSK when TRPTYPE is LU62. 3 Valid only on AIX, HP-UX, OS/2 Warp, OS/390, OS/400, Sun Solaris, and Windows NT. 4 Valid only on AIX, HP-UX, OS/2 Warp, OS/400, Sun Solaris, and Windows NT. 5 Not valid on OS/390. 6 Valid only if TRPTYPE is LU62. 7 You can specify more than one value on AIX, HP-UX, OS/2 Warp, OS/400, Sun Solaris, and Windows NT only. 8 Valid only on OS/390. 9 Valid only on Compaq (DIGITAL) OpenVMS. 10 Valid only on OS/2 Warp and Windows NT. 11 Valid only on AIX. 18 MQSeries MQSC Command Reference

ALTER CHANNEL 12 Valid only when the queue manager is a member of a queue-sharing group. You can use queue-sharing groups only on MQSeries for OS/390. Chapter 2. The MQSeries commands 19

ALTER CHANNEL Client-connection channel ALTER CHANNEL ALTER CHANNEL(channel-name) CHLTYPE(CLNTCONN) (1) CMDSCOPE( ) (2) CMDSCOPE(qmgr-name) (8) CMDSCOPE(*) (8) CONNAME(string) DESCR(string) (3) HBINT(integer) MAXMSGL(integer) (4) MODENAME(string) (4) PASSWORD(string) QMNAME(string) QSGDISP(QMGR) (2) QSGDISP(COPY) (8) QSGDISP(GROUP) QSGDISP(PRIVATE),, (5) (5) RCVDATA( string ) RCVEXIT( string ) SCYDATA(string) SCYEXIT(string), (5) SENDDATA( string ), (5) SENDEXIT( string ) (4) TPNAME(string) (6) TRPTYPE( DECNET ) LU62 (7) NETBIOS (7) SPX TCP (4) USERID(string) 20 MQSeries MQSC Command Reference

ALTER CHANNEL Notes: 1 This parameter must follow immediately after the channel name except on OS/390. 2 Valid only on OS/390. 3 Valid only on AIX, HP-UX, OS/2 Warp, OS/400, Sun Solaris, and Windows NT. 4 Valid only if TRPTYPE is LU62. 5 You can specify more than one value on AIX, HP-UX, OS/2 Warp, OS/400, Sun Solaris, and Windows NT only. 6 Valid only on Compaq (DIGITAL) OpenVMS. 7 Valid only for clients to be run on DOS, OS/2 Warp, Windows, and Windows NT. 8 Valid only when the queue manager is a member of a queue-sharing group. You can use queue-sharing groups only on MQSeries for OS/390. Chapter 2. The MQSeries commands 21

ALTER CHANNEL Server-connection channel ALTER CHANNEL ALTER CHANNEL(channel-name) CHLTYPE(SVRCONN) (1) AUTOSTART( DISABLED ) ENABLED (2) CMDSCOPE( ) (4) CMDSCOPE(qmgr-name) (8) CMDSCOPE(*) (8) DESCR(string) (3) HBINT(integer) MAXMSGL(integer) MCAUSER(string) (4) PUTAUT ( DEF ) ONLYMCA QSGDISP(QMGR) (4) QSGDISP(COPY) (8) QSGDISP(GROUP) QSGDISP(PRIVATE) SCYDATA(string) SCYEXIT(string), (5) SENDDATA( string ),, (5) (5) SENDEXIT( string ) RCVDATA( string ), (5) RCVEXIT( string ) (6) TRPTYPE( DECNET ) LU62 (7) NETBIOS (7) SPX TCP Notes: 1 This parameter must follow immediately after the channel name except on OS/390. 2 Valid only on Tandem NSK when TRPTYPE is LU62. 3 Valid only on AIX, HP-UX, OS/2 Warp, OS/400, Sun Solaris, and Windows NT. 4 Valid only on OS/390. 22 MQSeries MQSC Command Reference

ALTER CHANNEL 5 You can specify more than one value on AIX, HP-UX, OS/2 Warp, OS/400, Sun Solaris, and Windows NT only. 6 Valid only on Compaq (DIGITAL) OpenVMS. 7 Valid only for clients to be run on DOS, OS/2 Warp, Windows, and Windows NT. 8 Valid only when the queue manager is a member of a queue-sharing group. You can use queue-sharing groups only on MQSeries for OS/390. Chapter 2. The MQSeries commands 23

ALTER CHANNEL Cluster-sender channel ALTER CHANNEL ALTER CHANNEL(channel-name) CHLTYPE(CLUSSDR) (1) (3) BATCHINT(integer) BATCHSZ(integer) CLUSTER(clustername) CLUSNL(nlname) CMDSCOPE( ) (2) CMDSCOPE(qmgr-name) (10) CMDSCOPE(*) (10) CONNAME(string) CONVERT( NO ) YES DESCR(string) DISCINT(integer) HBINT(integer) LONGRTY(integer) LONGTMR(integer) MAXMSGL(integer) MCANAME(string) MCATYPE( PROCESS ) THREAD (4) MCAUSER(string) (5) MODENAME(string), (6) MSGDATA( string ), (6) MSGEXIT( string ) NPMSPEED( FAST ) NORMAL (5) (7) PASSWORD(string) QSGDISP(QMGR) (2) QSGDISP(COPY) (10) QSGDISP(GROUP) QSGDISP(PRIVATE),, (6) (6) RCVDATA( string ) RCVEXIT( string ) 24 MQSeries MQSC Command Reference

ALTER CHANNEL SCYDATA(string) SCYEXIT(string), (6) SENDDATA( string ), (6) SENDEXIT( string ) SEQWRAP(integer) SHORTRTY(integer) SHORTTMR(integer) (5) TPNAME(string) TRPTYPE( LU62 ) (8) NETBIOS (8) SPX TCP (9) UDP (5) (7) USERID(string) Notes: 1 This parameter must follow immediately after the channel name except on OS/390. 2 Valid only on OS/390. 3 Valid only on AIX, HP-UX, OS/2 Warp, OS/390, OS/400, Sun Solaris, and Windows NT. 4 Valid only on AIX, HP-UX, OS/2 Warp, OS/400, Sun Solaris, and Windows NT. 5 Valid only if TRPTYPE is LU62. 6 You can specify only one value on OS/390. 7 Not valid on OS/390. 8 Valid only on OS/2 Warp and Windows NT. 9 Valid only on AIX. 10 Valid only when the queue manager is a member of a queue-sharing group. You can use queue-sharing groups only on MQSeries for OS/390. Chapter 2. The MQSeries commands 25

ALTER CHANNEL Cluster-receiver channel ALTER CHANNEL ALTER CHANNEL(channel-name) CHLTYPE(CLUSRCVR) (1) (2) BATCHINT(integer) BATCHSZ(integer) CLUSTER(clustername) CLUSNL(nlname) CMDSCOPE( ) (6) CMDSCOPE(qmgr-name) (9) CMDSCOPE(*) (9) CONNAME(string) CONVERT( NO ) YES DESCR(string) DISCINT(integer) HBINT(integer) LONGRTY(integer) LONGTMR(integer) MAXMSGL(integer) MCATYPE( PROCESS ) THREAD MCAUSER(string) (3) MODENAME(string) (4) MRDATA(string) (4) MREXIT(string) (4) MRRTY(integer) (4) MRTMR(integer), (5) MSGDATA( string ), (5) MSGEXIT( string ) NETPRTY(integer) NPMSPEED( FAST ) NORMAL PUTAUT( DEF ) CTX (6) ONLYMCA (6) ALTMCA QSGDISP(QMGR) (6) QSGDISP(COPY) (9) QSGDISP(GROUP) QSGDISP(PRIVATE) 26 MQSeries MQSC Command Reference

ALTER CHANNEL,, (5) (5) RCVDATA( string ) RCVEXIT( string ) SCYDATA(string) SCYEXIT(string), (5) SENDDATA( string ), (5) SENDEXIT( string ) SEQWRAP(integer) SHORTRTY(integer) SHORTTMR(integer) (3) TPNAME(string) TRPTYPE( LU62 ) (7) NETBIOS (7) SPX TCP (8) UDP Notes: 1 This parameter must follow immediately after the channel name except on OS/390. 2 Valid only on AIX, HP-UX, OS/2 Warp, OS/390, OS/400, Sun Solaris, and Windows NT. 3 Valid only if TRPTYPE is LU62. 4 Not valid on OS/390. 5 You can specify one value only on OS/390. 6 Valid only on OS/390. 7 Valid only on OS/2 Warp and Windows NT. 8 Valid only on AIX. 9 Valid only when the queue manager is a member of a queue-sharing group. You can use queue-sharing groups only on MQSeries for OS/390. Parameter descriptions For a description of the parameters see DEFINE CHANNEL on page 57. Chapter 2. The MQSeries commands 27

ALTER NAMELIST ALTER NAMELIST Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U U U U U Use ALTER NAMELIST to alter a list of names. This is most commonly a list of cluster names or queue names. Notes: 1. On UNIX systems, the command is valid only on AIX, HP-UX, and Sun Solaris. Synonym: ALTNL ALTER NAMELIST ALTER NAMELIST(name) DESCR(string) CMDSCOPE( ) (2) CMDSCOPE(qmgr-name) (1) CMDSCOPE(*) (1), NAMES( ) name QSGDISP(QMGR) (2) QSGDISP(COPY) (1) QSGDISP(GROUP) QSGDISP(PRIVATE) Notes: 1 Valid only when the queue manager is a member of a queue-sharing group. You can use queue-sharing groups only on MQSeries for OS/390. 2 Valid only on OS/390. Parameter descriptions For a description of the parameters see DEFINE NAMELIST on page 95 28 MQSeries MQSC Command Reference

ALTER PROCESS ALTER PROCESS Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U U U U U U U Use ALTER PROCESS to alter the parameters of an existing MQSeries process definition. Synonym: ALT PRO ALTER PROCESS ALTER PROCESS(process-name) APPLICID(string) APPLTYPE( integer ) CICS DEF DOS IMS MVS NOTESAGENT NSK OS2 OS400 UNIX VMS WINDOWS WINDOWSNT CMDSCOPE( ) (2) CMDSCOPE(qmgr-name) (1) CMDSCOPE(*) (1) DESCR(string) ENVRDATA(string) QSGDISP(QMGR) (2) QSGDISP(COPY) (1) QSGDISP(GROUP) QSGDISP(PRIVATE) USERDATA(string) Notes: 1 Valid only when the queue manager is a member of a queue-sharing group. You can use queue-sharing groups only on MQSeries for OS/390. 2 Valid only on OS/390. Parameter descriptions For a description of the parameters see DEFINE PROCESS on page 99. Chapter 2. The MQSeries commands 29

ALTER QMGR ALTER QMGR Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U U U U U U U Use ALTER QMGR to alter the queue manager parameters for the local queue manager. Synonym: ALT QMGR ALTER QMGR ALTER QMGR qmgr attrs FORCE CMDSCOPE( ) (3) CMDSCOPE(qmgr-name) (2) CMDSCOPE(*) (2) Qmgr attrs: (1) AUTHOREV( ENABLED ) DISABLED (5) CCSID(integer) CHAD( DISABLED ) ENABLED (4) CHADEV( DISABLED ) ENABLED (6) (6) CHADEXIT(string) (6) CLWLDATA(string) (6) CLWLEXIT(string) (6) CLWLLEN(length) DEADQ(string) DEFXMITQ(string) DESCR(string) IGQ( DISABLED ) ENABLED (3) IGQAUT( DEF ) CTX ONLYIGQ ALTIGQ (3) (3) IGQUSER(useridr) INHIBTEV( ENABLED ) DISABLED LOCALEV( ENABLED ) DISABLED 30 MQSeries MQSC Command Reference

MAXHANDS(integer) (4) MAXMSGL(integer) ALTER QMGR (1) MAXUMSGS(integer) PERFMEV( ENABLED ) DISABLED REMOTEEV( ENABLED ) DISABLED REPOS(clustername) (6) (6) REPOSNL(nlname) STRSTPEV( ENABLED ) DISABLED TRIGINT(integer) Notes: 1 Not valid on OS/390. 2 Valid only when the queue manager is a member of a queue-sharing group. You can use queue-sharing groups only on MQSeries for OS/390. 3 Valid only on OS/390. 4 Valid only on AIX, HP-UX, OS/2 Warp, OS/400, Sun Solaris, and Windows NT. 5 Valid only on AIX, HP-UX, OS/2 Warp, OS/400, Sun Solaris, Tandem NSK, and Windows NT. 6 Valid only on AIX, HP-UX, OS/2 Warp, OS/390, OS/400, Sun Solaris, and Windows NT. Parameter descriptions The parameters you specify override the current values. Attributes that you do not specify are unchanged. Notes: 1. If you do not specify any parameters, the command completes successfully, but no queue manager options are changed. 2. Changes made using this command persist when the queue manager is stopped and restarted. FORCE Specify this to force completion of the command if both of the following are true: v The DEFXMITQ parameter is specified v An application has a remote queue open, the resolution for which would be affected by this change If FORCE is not specified in these circumstances, the command is unsuccessful. Chapter 2. The MQSeries commands 31

ALTER QMGR Queue manager parameters AUTHOREV Whether authorization (Not Authorized) events are generated: ENABLED Authorization events are generated. This value is not supported on OS/390. DISABLED Authorization events are not generated. This is the queue manager s initial default value. CCSID(integer) The coded character set identifier for the queue manager. The CCSID is the identifier used with all character string fields defined by the API. It does not apply to application data carried in the text of messages unless the CCSID in the message descriptor is set to the value MQCCSI_Q_MGR when the message is put to a queue. Specify a value in the range 1 through 65 535. The CCSID must specify a value that is defined for use on your platform, and use a character set that is appropriate to the platform. If you use this parameter to change the CCSID, applications that are running when the change is applied continue to use the original CCSID. Because of this, you must stop and restart all running applications before you continue. This includes the command server and channel programs. To do this, stop and restart the queue manager after making the change. This parameter is valid only on AIX, HP-UX, OS/2 Warp, OS/400, Sun Solaris, Tandem NSK, and Windows NT. See the MQSeries Application Programming Guide for details of the supported CCSIDs for each platform. CHAD Whether receiver and server-connection channels can be defined automatically: DISABLED Auto-definition is not used. This is the queue manager s initial default value. ENABLED Auto-definition is used. Cluster-sender channels can always be defined automatically, regardless of the setting of this parameter. This parameter is valid only on AIX, HP-UX, OS/2 Warp, OS/400, Sun Solaris, and Windows NT. CHADEV Whether channel auto-definition events are generated. DISABLED Auto-definition events are not generated. This is the queue manager s initial default value. ENABLED Auto-definition events are generated. 32 MQSeries MQSC Command Reference

This parameter is valid only on AIX, HP-UX, OS/2 Warp, OS/400, Sun Solaris, and Windows NT. CHADEXIT(string) Auto-definition exit name. If this name is nonblank, the exit is called when an inbound request for an undefined receiver, server-connection, or cluster-sender channel is received. It is also called when starting a cluster-receiver channel. The format and maximum length of the name depends on the environment: v v On OS/2 Warp, Windows, and Windows NT, it is of the form dllname(functionname) where dllname is specified without the suffix (.DLL ). The maximum length of the string is 128 characters. On OS/400, it is of the form: progname libname ALTER QMGR v v where program name occupies the first 10 characters and libname the second 10 characters (both blank-padded to the right if necessary). The maximum length of the string is 20 characters. On AIX, HP-UX, and Sun Solaris, it is of the form libraryname(functionname). The maximum length of the string is 128 characters. On OS/390, it is a load module name, maximum length 8 characters. This parameter is valid only on AIX, HP-UX, OS/2 Warp, OS/390, OS/400, Sun Solaris, and Windows NT. On OS/390, it applies only to cluster-sender and cluster-receiver channels. CLWLDATA(string) Cluster workload exit data (maximum length 32 characters). This is passed to the cluster workload exit when it is called. This parameter is valid only on AIX, HP-UX, OS/2 Warp, OS/390, OS/400, Sun Solaris, and Windows NT. CLWLEXIT(string) Cluster workload exit name. If this name is nonblank, the exit is called when a message is put to a cluster queue. The format and maximum length of the name depends on the environment: v v v v On UNIX systems, it is of the form libraryname(functionname). The maximum length is 128 characters. On OS/2 Warp and Windows NT, it is of the form dllname(functionname), where dllname is specified without the suffix (.DLL ). The maximum length is 128 characters. On OS/390, it is a load module name, maximum length 8 characters. On OS/400, it is of the form: progname libname where program name occupies the first 10 characters and libname the second 10 characters (both blank-padded to the right if necessary). The maximum length of the string is 20 characters. Chapter 2. The MQSeries commands 33