MQSeries® MQSC Command Reference SC33-1369-13
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.
Contents Tables . . . . . . . . . . . . . . . v About this book . . . . . . . . . . . vii Who this book is for . . . . . . . . . . What you need to know to understand this book How to use this book . . . . . . . . . . . vii vii . 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) . Changes for the eleventh edition (SC33-1369-10) . . . x . x . . . . . . .
| | | | | | | | | | | | | | | Parameter descriptions Usage notes . . . . DISPLAY GROUP . . . Usage notes . . . . DISPLAY LOG . . . . Parameter descriptions Usage notes . . . . DISPLAY MAXSMSGS . Parameter descriptions DISPLAY NAMELIST. . Parameter descriptions DISPLAY PROCESS . . Parameter descriptions DISPLAY QMGR . . . Parameter descriptions DISPLAY QSTATUS . . Parameter descriptions DISPLAY QUEUE . . . Parameter descriptions DISPLAY SECURITY . . Parameter descriptions DISPLAY STGCLASS . .
Tables | | | | | | 1. 2. 3. 4. 5. | | | | 6. 7. How to read syntax diagrams . . . . CHLDISP and CMDSCOPE for DISPLAY CHSTATUS CURRENT . . . . . . CHLDISP and CMDSCOPE for DISPLAY CHSTATUS SHORT . . . . . . . CHLDISP and CMDSCOPE for DISPLAY CHSTATUS SAVED . . . . . . . Parameters that can be returned by the DISPLAY QUEUE command . . . . CHLDISP and CMDSCOPE for PING CHANNEL . . . . . . . . . . CHLDISP and CMDSCOPE for RESET CHANNEL . . . . . . . . . . © Copyright IBM Corp. 1993, 2000 . . . 7 . .
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.
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.
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.
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.
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.
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 not valid.
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.
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 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.
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.
Syntax diagrams 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.
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 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. A B C Name ! The syntax fragment Name is shown separately from the main syntax ! diagram.
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.
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.
ALTER CHANNEL Sender channel ALTER CHANNEL ALTER CHANNEL(channel-name) CHLTYPE(SDR) (1) BATCHINT(integer) CMDSCOPE(’ ’) BATCHSZ(integer) CONVERT( ) DESCR(string) (3) HBINT(integer) (2) CMDSCOPE(qmgr-name) (11) CMDSCOPE(*) NO YES MODENAME(string) DISCINT(integer) MCANAME(string) MCAUSER(string) LONGTMR(integer) MCATYPE( PROCESS THREAD ) , MSGEXIT( " string ) (6) NPMSPEED( FAST NORMAL QSGDISP(QMGR) PASSWORD(string) (5) (7) (4) (5) MSGDATA( "
ALTER CHANNEL SCYDATA(string) SCYEXIT(string) , SENDDATA( " string SEQWRAP(integer) , SENDEXIT( " string ) SHORTTMR(integer) ) USERID(string) (5) SHORTRTY(integer) (6) TPNAME(string) (5) TRPTYPE( DECNET LU62 (8) NETBIOS (9) SPX TCP (10) UDP (6) (7) ) (9) XMITQ(string) Notes: 12 1 This parameter must follow immediately after the channel name except on OS/390. 2 Valid only on OS/390.
ALTER CHANNEL Server channel ALTER CHANNEL ALTER CHANNEL(channel-name) CHLTYPE(SVR) (1) AUTOSTART( BATCHINT(integer) BATCHSZ(integer) CONVERT( (3) HBINT(integer) (3) CONNAME(string) ) CMDSCOPE(’ ’) DISABLED ENABLED MAXMSGL(integer) MCAUSER(string) NO YES DESCR(string) LONGRTY(integer) MCANAME(string) MODENAME(string) (5) CMDSCOPE(qmgr-name) (12) CMDSCOPE(*) ) (2) (12) DISCINT(integer) PROCESS THREAD ) (4) (6) , MSGDATA( " string NPMSPEED( FAS
ALTER CHANNEL SCYDATA(string) , RCVEXIT( " string (7) SCYEXIT(string) ) , SENDDATA( " string SEQWRAP(integer) TPNAME(string) , (7) ) SENDEXIT( " SHORTRTY(integer) (6) TRPTYPE( DECNET LU62 USERID(string) (6) (8) string (7) ) SHORTTMR(integer) (9) NETBIOS (10) SPX TCP (11) UDP ) (10) XMITQ(string) 1 This parameter must follow immediately after the channel name except on OS/390. 2 Valid only on Tandem NSK when TRPTYPE is LU62.
ALTER CHANNEL Receiver channel ALTER CHANNEL ALTER CHANNEL(channel-name) (1) CHLTYPE(RCVR) AUTOSTART( CMDSCOPE(’ ’) BATCHSZ(integer) HBINT(integer) MRDATA(string) MREXIT(string) MRRTY(integer) , MSGDATA( " string (5) , NPMSPEED( (5) MSGEXIT( " string ) FAST NORMAL QSGDISP(QMGR) PUTAUT( DEF CTX ) ONLYMCA ALTMCA (4) ) MCAUSER(string) (4) (4) MRTMR(integer) DESCR(string) (10) MAXMSGL(integer) (4) ) (6) CMDSCOPE(qmgr-name) (10) CMDSCOPE(*) (3)
ALTER CHANNEL SCYDATA(string) SCYEXIT(string) , SENDDATA( " string string TRPTYPE( DECNET LU62 NETBIOS (8) SPX TCP (9) UDP ) SEQWRAP(integer) , SENDEXIT( " (5) (5) (7) ) ! ) (8) Notes: 16 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.
ALTER CHANNEL Requester channel ALTER CHANNEL ALTER CHANNEL(channel-name) CHLTYPE(RQSTR) (1) AUTOSTART( CMDSCOPE(’ ’) BATCHSZ(integer) HBINT(integer) MCATYPE( PROCESS THREAD ) (4) (5) MRDATA(string) CONNAME(string) (12) (3) MAXMSGL(integer) MCAUSER(string) MREXIT(string) (5) , MSGDATA( " string MODENAME(string) MRRTY(integer) (7) MSGEXIT( " string PASSWORD(string) (5) (6) (5) ) , MCANAME(string) (5) MRTMR(integer) ) (8) CMDSCOPE(qmgr-n
ALTER CHANNEL QSGDISP(QMGR) (8) QSGDISP(COPY) , (12) QSGDISP(GROUP) QSGDISP(PRIVATE) (7) RCVDATA( " string SCYDATA(string) , RCVEXIT( " string (7) ) SCYEXIT(string) ) , SENDDATA( " string SEQWRAP(integer) (7) , ) TPNAME(string) SENDEXIT( " (6) string TRPTYPE( (7) DECNET LU62 ) (9) NETBIOS (10) SPX TCP (11) UDP USERID(string) (5) ) (10) (6) Notes: 18 1 This parameter must follow immediately after the channel name except on OS/390.
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.
ALTER CHANNEL Client-connection channel ALTER CHANNEL ALTER CHANNEL(channel-name) CMDSCOPE(’ ’) CHLTYPE(CLNTCONN) (1) (2) CMDSCOPE(qmgr-name) (8) CMDSCOPE(*) (3) HBINT(integer) CONNAME(string) (8) MAXMSGL(integer) MODENAME(string) PASSWORD(string) (4) QMNAME(string) (4) QSGDISP(QMGR) DESCR(string) (2) QSGDISP(COPY) (8) QSGDISP(GROUP) QSGDISP(PRIVATE) , RCVDATA( " string SCYDATA(string) (5) , RCVEXIT( " string ) (5) SCYEXIT(string) , SENDDATA( " st
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.
ALTER CHANNEL Server-connection channel ALTER CHANNEL ALTER CHANNEL(channel-name) AUTOSTART( DISABLED ENABLED DESCR(string) (2) ) HBINT(integer) (4) PUTAUT (4) ( DEF ONLYMCA (8) CMDSCOPE(qmgr-name) (8) CMDSCOPE(*) (3) MAXMSGL(integer) QSGDISP(QMGR) (1) CMDSCOPE(’ ’) CHLTYPE(SVRCONN) MCAUSER(string) (4) SCYDATA(string) QSGDISP(COPY) ) (8) QSGDISP(GROUP) QSGDISP(PRIVATE) SCYEXIT(string) , SENDDATA( " string (5) ) , SENDEXIT( " string , (5) )
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.
ALTER CHANNEL Cluster-sender channel ALTER CHANNEL ALTER CHANNEL(channel-name) BATCHSZ(integer) CLUSTER(clustername) CMDSCOPE(’ ’) DESCR(string) (3) DISCINT(integer) CLUSNL(nlname) PROCESS THREAD ) (4) , ) (6) ) FAST NORMAL QSGDISP(QMGR) PASSWORD(string) , NPMSPEED( (5) ) MCANAME(string) MSGDATA( " string MSGEXIT( " string NO YES LONGRTY(integer) MCAUSER(string) (5) MODENAME(string) CONVERT( HBINT(integer) MAXMSGL(integer) (7) (6)
ALTER CHANNEL SCYDATA(string) SCYEXIT(string) , SENDDATA( " string SEQWRAP(integer) , SENDEXIT( " string ) SHORTTMR(integer) USERID(string) (5) ) (6) SHORTRTY(integer) (6) TPNAME(string) (5) TRPTYPE( LU62 NETBIOS (8) SPX TCP (9) UDP (8) ) ! (7) 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.
ALTER CHANNEL Cluster-receiver channel ALTER CHANNEL ALTER CHANNEL(channel-name) BATCHSZ(integer) CLUSTER(clustername) CMDSCOPE(’ ’) DESCR(string) LONGTMR(integer) MODENAME(string) (4) MRDATA(string) MRTMR(integer) (4) ONLYMCA ALTMCA LONGRTY(integer) PROCESS THREAD MRRTY(integer) , (5) (5) ) (4) ) (6) (6) ) NPMSPEED( FAST NORMAL ) ) QSGDISP(QMGR) DEF CTX ) NETPRTY(integer) MSGEXIT( " string NO YES (4) , CONVERT( (3) MREXIT(string)
ALTER CHANNEL , RCVDATA( " string SCYDATA(string) , (5) RCVEXIT( " ) string (5) ) SCYEXIT(string) , SENDDATA( " string , SENDEXIT( " string SEQWRAP(integer) (5) SHORTTMR(integer) (5) ) SHORTRTY(integer) ) TPNAME(string) (3) TRPTYPE( LU62 NETBIOS (7) SPX TCP (8) UDP (7) ! ) 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.
ALTER NAMELIST ALTER NAMELIST Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp U U U Compaq NSK UNIX systems Windows NT 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.
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.
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.
ALTER QMGR MAXHANDS(integer) MAXUMSGS(integer) MAXMSGL(integer) (1) PERFMEV( REMOTEEV( ENABLED DISABLED ) STRSTPEV( ENABLED DISABLED ) (4) ENABLED DISABLED REPOS(clustername) ) (6) REPOSNL(nlname) (6) 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.
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.
ALTER QMGR 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.
ALTER QMGR This parameter is valid only on AIX, HP-UX, OS/2 Warp, OS/390, OS/400, Sun Solaris, and Windows NT. CLWLLEN(length) The maximum number of bytes of message data that is passed to the cluster workload exit. | | | Specify a value: v Between zero and 100 MB on MQSeries for OS/390 systems v Between zero and 999 999 999 on other platforms | The initial default value is 100. This parameter is valid only on AIX, HP-UX, OS/2 Warp, OS/390, OS/400, Sun Solaris, and Windows NT.
ALTER QMGR Note: If characters are used that are not in the coded character set identifier (CCSID) for this queue manager, they might be translated incorrectly if the information is sent to another queue manager. | IGQ Whether intra-group queuing is to be used. | This parameter applies only to OS/390. | | | | ENABLED Message transfer between queue managers within a queue-sharing group uses the shared transmission queue (SYSTEM.QSG.TRANSMIT.QUEUE).
ALTER QMGR IGQUSER Nominates a user ID (referred to as the IGQ user ID) to be used by the IGQ agent (IGQA) to establish authority to put messages to a destination queue. | | | | | This parameter applies only to OS/390. Possible values are: | | | | Blanks | | | Specific user ID Indicates that the user ID specified in the receiving queue manager’s IGQUSER parameter should be used. | | | | | | Notes: 1.
ALTER QMGR This parameter is valid only on AIX, HP-UX, OS/2 Warp, OS/400, Sun Solaris, and Windows NT. MAXUMSGS(integer) The maximum number of uncommitted messages within a syncpoint. This is a limit on v the number of messages that can be retrieved, plus v the number of messages that can be put within any one syncpoint. It does not apply to messages that are put or retrieved outside syncpoint. The number includes any trigger messages and report messages generated within the same unit of recovery.
ALTER QMGR If both REPOS and REPOSNL are blank, or REPOS is blank and the namelist specified by REPOSNL is empty, this queue manager does not have a full repository, but might be a client of other repository services that are defined in the cluster. This parameter is valid only on AIX, HP-UX, OS/2 Warp, OS/390, OS/400, Sun Solaris, and Windows NT. STRSTPEV Whether start and stop events are generated: ENABLED Start and stop events are generated. This is the queue manager’s initial default value.
ALTER Queues ALTER Queues This section contains the following commands: v “ALTER QALIAS” v “ALTER QLOCAL” on page 41 v “ALTER QMODEL” on page 43 v “ALTER QREMOTE” on page 45 These queues are supported on the following platforms: Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U U U U U U U ALTER QALIAS Use ALTER QALIAS to alter the parameters of an alias queue.
ALTER Queues 40 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 AIX, HP-UX, OS/2 Warp, OS/390, OS/400, Sun Solaris, and Windows NT. 4 Valid only on Compaq (DIGITAL) OpenVMS, OS/2 Warp, UNIX systems, and Windows NT.
ALTER Queues ALTER QLOCAL Use ALTER QLOCAL to alter the parameters of a local queue.
ALTER Queues QDPLOEV( ENABLED DISABLED ) QDPMAXEV( QSVCINT(integer) RETINTVL(integer) TRIGDATA(string) TRIGDPTH(integer) USAGE( NORMAL XMITQ ENABLED DISABLED SCOPE( ) QMGR CELL QSVCIEV( ) TRIGMPRI(integer) (5) NONE HIGH OK ) STGCLASS(string) TRIGTYPE( FIRST EVERY DEPTH NONE (1) ) ) Notes: 42 1 Valid only 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.
ALTER Queues ALTER QMODEL Use ALTER QMODEL to alter the parameters of a model queue.
ALTER Queues QSVCINT(integer) TRIGDPTH(integer) RETINTVL(integer) TRIGMPRI(integer) STGCLASS(string) TRIGTYPE( (1) FIRST EVERY DEPTH NONE TRIGDATA(string) ) USAGE( NORMAL XMITQ ) Model q attr: DEFTYPE( TEMPDYN PERMDYN SHAREDYN ) (1) Notes: 44 1 Valid only 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 AIX, HP-UX, OS/2 Warp, OS/400, Sun Solaris, and Windows NT.
ALTER Queues ALTER QREMOTE Use ALTER QREMOTE to alter the parameters of a local definition of a remote queue, a queue-manager alias, or a reply-to queue alias.
ALTER SECURITY ALTER SECURITY Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U Use ALTER SECURITY to define system-wide security options. Synonym: ALT SEC ALTER SECURITY ALTER SECURITY CMDSCOPE(’ ’) CMDSCOPE(qmgr-name) (1) CMDSCOPE(*) (1) security attrs ! Security attrs: INTERVAL(integer) TIMEOUT(integer) Notes: 1 Valid only when the queue manager is a member of a queue-sharing group.
ALTER SECURITY | | | | | | * The command is executed on the local queue manager and is also passed to every active queue manager in the queue-sharing group. The effect of this is the same as entering the command on every queue manager in the queue-sharing group. INTERVAL(integer) The interval between checks for user IDs for which the TIMEOUT has expired. The value is in minutes, in the range 0–10080 (one week). If INTERVAL is specified as 0, no user timeouts occur.
ALTER STGCLASS ALTER STGCLASS Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U Use ALTER STGCLASS to alter the characteristics of a storage class.
ALTER TRACE ALTER TRACE Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U Use ALTER TRACE to change the trace events (IFCIDs) being traced for a particular active trace. ALTER TRACE stops the specified trace, and restarts it with the altered parameters. Note: ALTER TRACE does not affect any RMID(231) settings (although a subsequent DISPLAY TRACE command will show them altered).
ALTER TRACE And: TNO(integer) The number of the trace to be altered. This limits the list to a particular trace, identified by its trace number (1 through 32). You can specify only one trace number. | | | CMDSCOPE This parameter specifies how the command is executed when the queue manager is a member of a queue-sharing group. | | CMDSCOPE cannot be used for commands issued from the first initialization input data set CSQINP1.
ARCHIVE LOG ARCHIVE LOG Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U Use ARCHIVE LOG as part of your backup procedure. It takes a copy of the current active log following the latest syncpoint. Synonym: ARC LOG ARCHIVE LOG ARCHIVE LOG MODE(QUIESCE) CANCEL OFFLOAD WAIT(NO) TIME(nnn) WAIT(YES) CMDSCOPE(’ ’) CMDSCOPE(qmgr-name) ! (1) Notes: 1 Valid only when the queue manager is a member of a queue-sharing group.
ARCHIVE LOG You can specify a queue manager name, other than the queue manager on which the command was entered, only if you are using a queue-sharing group environment and if the command server is enabled. | | | | MODE(QUIESCE) Stops any new update activity on the MQSeries subsystem for a specified period of time, and brings all existing users to a point of consistency after a commit. When the specified period of time expires, archiving of the current active log takes place.
ARCHIVE LOG 3. You can issue an ARCHIVE LOG without the MODE(QUIESCE) option when a STOP QMGR MODE(QUIESCE) is in progress, but not when a STOP QMGR MODE (FORCE) is in progress. 4. You can issue a DISPLAY THREAD command to discover whether an ARCHIVE LOG command is active. The DISPLAY command returns message CSQV400I if an ARCHIVE LOG command is active. Chapter 2.
CLEAR QLOCAL CLEAR QLOCAL Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U U U U U U U Use CLEAR QLOCAL to clear the messages from a local queue. Synonym: CLEAR QL CLEAR QLOCAL CLEAR QLOCAL(q-name) CMDSCOPE(’ ’) CMDSCOPE(qmgr-name) (2) CMDSCOPE(*) QSGDISP(PRIVATE) QSGDISP(SHARED) (1) (2) (1) (2) ! Notes: 1 Valid only on OS/390. 2 Valid only when the queue manager is a member of a queue-sharing group.
CLEAR QLOCAL | | | | qmgr-name The command is executed on the queue manager you specify, providing the queue manager is active within the queue-sharing group. You can specify a queue manager name, other than the queue manager on which the command was entered, only if you are using a queue-sharing group environment and if the command server is enabled. | | | | | | | | | | * The command is executed on the local queue manager and is also passed to every active queue manager in the queue-sharing group.
DEFINE BUFFPOOL DEFINE BUFFPOOL Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U Use DEFINE BUFFPOOL to define a buffer pool that is used for holding messages in main storage. Note: DEFINE BUFFPOOL can be issued only from the CSQINP1 initialization data set. Synonym: DEF BP DEFINE BUFFPOOL DEFINE BUFFPOOL(buf-pool-id) BUFFERS(1000) BUFFERS(integer) ! Parameter descriptions If this command is not issued, the default number of buffers is assumed.
DEFINE CHANNEL DEFINE 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 DEFINE CHANNEL to define a new channel, and set its parameters. 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, see the MQSeries Intercommunication manual. 2.
DEFINE CHANNEL Sender channel DEFINE CHANNEL DEFINE CHANNEL(channel-name) CHLTYPE(SDR) (1) CONNAME(string) TRPTYPE (3) ( DECNET LU62 (4) NETBIOS (5) SPX TCP (6) UDP BATCHINT(0) XMITQ(string) (7) (8) BATCHINT(integer) CONVERT(NO) (7) DESCR(’ ’) CONVERT(YES) BATCHSZ(50) (8) (7) DISCINT(6000) MCANAME(’ ’) MODENAME(’ ’) MCATYPE(THREAD) (7) (10) MODENAME(string) MSGEXIT( " (7) (10) PASSWORD(’ ’) (10) (12) MQSeries MQSC Command Reference (7) , (11) str
DEFINE CHANNEL RCVDATA(’ ’) RCVDATA( " SCYEXIT(’ ’) (7) , (11) RCVEXIT(’ ’) string (7) RCVEXIT( " ) SENDDATA(’ ’) SCYEXIT(string) SENDDATA( " SEQWRAP(999 999 999) SEQWRAP(integer) TPNAME(’ ’) USERID(’ ’) , (11) SCYDATA(’ ’) string ) SENDEXIT(’ ’) string SHORTRTY(10) (7) SHORTRTY(integer) SCYDATA(string) (7) , (11) (7) SENDEXIT( " ) SHORTTMR(60) (7) , (11) string ) (7) SHORTTMR(integer) (7) (10) TPNAME(string) (7) (7) (10) (7) (10) (12) USERI
DEFINE CHANNEL You can use queue-sharing groups only on MQSeries for OS/390.
DEFINE CHANNEL Server channel DEFINE CHANNEL DEFINE CHANNEL(channel-name) CHLTYPE(SVR) (1) TRPTYPE (3) ( DECNET LU62 (4) NETBIOS (5) SPX TCP (6) UDP AUTOSTART(DISABLED) AUTOSTART(ENABLED) CMDSCOPE(’ ’) DESCR(’ ’) (8) (8) (8) LONGRTY(integer) LONGTMR(integer) (5) (8) CONVERT(NO) (8) CONVERT(YES) (8) (9) HBINT(integer) LONGTMR(1200) (9) MAXMSGL(4 194 304) (8) MAXMSGL(integer) MCATYPE(PROCESS) MSGDATA( " LIKE(channel-name) MCANAME(’ ’) MSGDATA(’
DEFINE CHANNEL NPMSPEED(FAST) (8) (9) NPMSPEED(NORMAL) PASSWORD(’ ’) (9) (8) (11) (13) PASSWORD(string) QSGDISP(QMGR) (11) (13) QSGDISP(COPY) (2) QSGDISP(GROUP) RCVDATA(’ ’) RCVDATA( " SCYEXIT(’ ’) (8) , (12) RCVEXIT(’ ’) string (8) RCVEXIT( " ) SENDDATA(’ ’) SCYEXIT(string) SENDDATA( " SEQWRAP(999 999 999) (8) TPNAME(’ ’) (8) (11) TPNAME(string) (11) , (12) string string ) SENDEXIT( " ) (8) SHORTRTY(integer) USERID(’ ’) (8) SCYDATA(string) SENDEXIT
DEFINE CHANNEL 13 Not valid on OS/390. 14 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.
DEFINE CHANNEL Receiver channel DEFINE CHANNEL DEFINE CHANNEL(channel-name) CHLTYPE(RCVR) (1) TRPTYPE (2) ( DECNET LU62 (3) NETBIOS (4) SPX TCP (5) UDP AUTOSTART(DISABLED) AUTOSTART(ENABLED) DESCR(’ ’) MAXMSGL(integer) MSGDATA(’ ’) MSGDATA( " (9) NPMSPEED(FAST) MQSeries MQSC Command Reference (8) MCAUSER(’ ’) MRRTY(10) (7) (8) (8) ) (12) LIKE(channel-name) (7) MSGEXIT( " PUTAUT(DEF) PUTAUT(CTX) (7) (9) MRDATA(’ ’) MRDATA(string) MRTMR(1000) (9) MSGE
DEFINE CHANNEL RCVDATA(’ ’) RCVDATA( " SCYEXIT(’ ’) (7) , (10) RCVEXIT(’ ’) string (7) ) SENDDATA(’ ’) SCYEXIT(string) SENDDATA( " SEQWRAP(999 999 999) RCVEXIT( " (7) , (10) SCYDATA(’ ’) string ) SENDEXIT(’ ’) string SCYDATA(string) (7) , (10) (7) ) SENDEXIT( " (7) , (10) string ) (7) ! SEQWRAP(integer) Notes: 1 This parameter must follow immediately after the channel name except on OS/390.
DEFINE CHANNEL Requester channel DEFINE CHANNEL DEFINE CHANNEL(channel-name) CHLTYPE(RQSTR) TRPTYPE (2) ( DECNET LU62 (3) NETBIOS (4) SPX TCP (5) UDP (14) LIKE(channel-name) MCATYPE(PROCESS) MRDATA(’ ’) MRTMR(1000) (7) (11) MRTMR(integer) 66 NOREPLACE MSGDATA(’ ’) REPLACE MQSeries MQSC Command Reference NPMSPEED(FAST) (7) (8) NPMSPEED(NORMAL) (8) (7) (8) HBINT(integer) (7) (7) (11) MREXIT(string) MSGDATA( " (7) BATCHSZ(integer) HBINT(300) MCAUSER(string)
DEFINE CHANNEL PUTAUT(DEF) (7) QSGDISP(QMGR) PUTAUT(CTX) (13) PUTAUT(ONLYMCA) (13) PUTAUT(ALTMCA) RCVEXIT(’ ’) RCVEXIT( " SENDDATA(’ ’) SENDDATA( " QSGDISP(COPY) (14) RCVDATA( " SCYDATA(’ ’) (7) SCYDATA(string) string SENDEXIT(’ ’) string SEQWRAP(999 999 999) SCYEXIT(’ ’) (7) , (12) string ) (7) SCYEXIT(string) ) (7) , (12) RCVDATA(’ ’) (14) QSGDISP(GROUP) (7) , (12) (13) ) (7) SEQWRAP(integer) SENDEXIT( " TPNAME(’ ’) (7) , (12) string (7) (10) TPN
DEFINE CHANNEL Client-connection channel DEFINE CHANNEL DEFINE CHANNEL(channel-name) TRPTYPE (3) ( DECNET LU62 (4) NETBIOS (5) SPX TCP DESCR(’ ’) CHLTYPE (6) ) (5) CMDSCOPE(’ ’) (6) HBINT(integer) MAXMSGL(4 194 304) (6) PASSWORD(string) (2) (8) QMNAME(’ ’) (8) (10) LIKE(channel-name) (7) (6) MODENAME(string) (6) (8) NOREPLACE (6) QSGDISP(QMGR) QMNAME(string) RCVDATA( " SCYDATA(’ ’) , (9) RCVEXIT(’ ’) string (6) SCYDATA(string) SENDDATA(’
DEFINE CHANNEL TPNAME(’ ’) (6) TPNAME(string) (8) (8) USERID(’ ’) (6) USERID(string) (8) ! (8) Notes: 1 This parameter must follow immediately after the channel name except on OS/390. 2 Valid only on OS/390. 3 This is not mandatory on AIX, HP-UX, OS/2 Warp, OS/390, OS/400, Sun Solaris, and Windows NT. 4 Valid only on Compaq (DIGITAL) OpenVMS. 5 Valid only for clients to be run on DOS, OS/2 Warp, Windows, or Windows NT.
DEFINE CHANNEL Server-connection channel DEFINE CHANNEL DEFINE CHANNEL(channel-name) TRPTYPE (2) ( (3) DECNET LU62 NETBIOS (4) SPX TCP (4) DESCR(’ ’) (10) (6) (6) PUTAUT(ONLYMCA) (8) (5) (6) HBINT(integer) RCVDATA( " SCYDATA(’ ’) (6) , (9) QSGDISP(COPY) (6) SCYDATA(string) RCVEXIT(’ ’) string ) RCVEXIT( " SCYEXIT(’ ’) (6) MQSeries MQSC Command Reference (6) (10) (10) (6) , (9) string SENDDATA(’ ’) SCYEXIT(string) SENDDATA( " 70 (7) (8) Q
DEFINE CHANNEL SENDEXIT(’ ’) SENDEXIT( " (6) ! , (9) string ) Notes: 1 This parameter must follow immediately after the channel name except on OS/390. 2 This is not mandatory on AIX, HP-UX, OS/2 Warp, OS/390, OS/400, Sun Solaris, and Windows NT. 3 Valid only on Compaq (DIGITAL) OpenVMS. 4 Valid only for clients to be run on DOS, OS/2 Warp, Windows, or Windows NT. 5 Valid only on Tandem NSK. 6 This is the default supplied with MQSeries, but your installation might have changed it.
DEFINE CHANNEL Cluster-sender channel DEFINE CHANNEL DEFINE CHANNEL(channel-name) CHLTYPE(CLUSSDR) BATCHSZ(50) (4) CMDSCOPE(’ ’) DISCINT(6000) (4) HBINT(300) DISCINT(integer) (4) MCANAME(’ ’) (4) MCAUSER(string) DESCR(’ ’) (4) MSGEXIT( " , (7) PASSWORD(’ ’) (4) (6) (8) PASSWORD(string) (6) (8) (4) (6) MSGDATA(’ ’) (6) MQSeries MQSC Command Reference (4) , (7) string ) (4) NOREPLACE NPMSPEED(FAST) REPLACE NPMSPEED(NORMAL) ) QSGDISP(QMGR) QSG
DEFINE CHANNEL (4) RCVEXIT(’ ’) , (7) RCVEXIT( " SENDDATA(’ ’) SENDDATA( " string , (7) string ) (4) (4) SCYEXIT(string) (4) , (7) SENDEXIT( " SHORTRTY(10) SEQWRAP(integer) (4) SHORTRTY(integer) string ) SHORTTMR(60) (4) SHORTTMR(integer) (4) (6) (6) USERID(’ ’) TRPTYPE( SCYEXIT(’ ’) ) SENDEXIT(’ ’) SEQWRAP(999 999 999) TPNAME(’ ’) (4) SCYDATA(string) (4) TPNAME(string) SCYDATA(’ ’) LU62 (9) NETBIOS (9) SPX TCP (10) UDP ) (4) (6) (8) USERID(str
DEFINE CHANNEL Cluster-receiver channel DEFINE CHANNEL DEFINE CHANNEL(channel-name) CHLTYPE(CLUSRCVR) BATCHINT(0) (3) BATCHINT(integer) CONVERT(NO) (3) HBINT(300) DISCINT(integer) LONGRTY(999 999 999) LONGRTY(integer) MCATYPE(THREAD) (3) MCATYPE(PROCESS) MRTMR(1000) (7) (3) (4) (4) (3) (4) MRTMR(integer) 74 NETPRTY(integer) MQSeries MQSC Command Reference (3) CLUSNL(nlname) (3) DESCR(string) LIKE(channel-name) LONGTMR(1200) (3) LONGTMR(integer) M
DEFINE CHANNEL PUTAUT(DEF) (3) QSGDISP(QMGR) PUTAUT(CTX) (7) PUTAUT(ONLYMCA) (7) PUTAUT(ALTMCA) , (5) SENDDATA(’ ’) SENDDATA( " (10) RCVDATA( " SCYDATA(’ ’) (3) string SENDEXIT(’ ’) string , (5) string ) (3) SCYEXIT(string) ) (3) , (5) (3) SCYEXIT(’ ’) SCYDATA(string) SEQWRAP(999 999 999) ) (3) (3) , (5) SENDEXIT( " SHORTRTY(10) SEQWRAP(integer) TPNAME(’ ’) (10) QSGDISP(GROUP) (3) RCVEXIT(’ ’) RCVEXIT( " QSGDISP(COPY) RCVDATA(’ ’) (7) string (3
DEFINE CHANNEL Parameter descriptions | | | | | | | The parameter descriptions also apply to the ALTER CHANNEL command, with the following exceptions: v The LIKE parameter applies only to the DEFINE CHANNEL command. v The REPLACE and NOREPLACE parameter applies only to the DEFINE CHANNEL command. v The variations in the CMDSCOPE and QSGDISP parameters between the ALTER CHANNEL and DEFINE CHANNEL commands are described. | Parameters are optional unless the description states that they are required.
DEFINE CHANNEL | | | | | | v The BATCHSZ of the receiving channel v Three less than the maximum number of uncommitted messages allowed at the sending queue manager (or one if this value is zero or less) v Three less than the maximum number of uncommitted messages allowed at the receiving queue manager (or one if this value is zero or less) The maximum number of uncommitted messages is specified by the MAXUMSGS parameter of the ALTER QMGR command, or the DEFINE MAXSMSGS command on OS/390.
DEFINE CHANNEL | | | CMDSCOPE This parameter applies to OS/390 only and specifies how the command is executed when the queue manager is a member of a queue-sharing group. | | CMDSCOPE must be blank, or the local queue manager, if QSGDISP is set to GROUP. | | ‘’ | | | | qmgr-name The command is executed on the queue manager you specify, providing the queue manager is active within the queue-sharing group.
DEFINE CHANNEL For the first form, the TP name and mode name must be specified for the TPNAME and MODENAME parameters; otherwise these parameters must be blank. Note: For client-connection channels, only the first form is allowed. Symbolic name The symbolic destination name for the logical unit information for the queue manager, as defined in the side information data set. The TPNAME and MODENAME parameters must be blank.
DEFINE CHANNEL For receiver and non fully qualified server channels, this is the process name of the SNAX/APC process, the ICE open name, and the name of the local LU, for example: CONNAME('$PPPP.#OPEN.LOCALLU') The name of the local LU can be an asterisk (*), indicating any name. NetBIOS A unique NetBIOS name (limited to 16 characters). SPX The 4-byte network address, the 6-byte node address, and the 2-byte socket number.
DEFINE CHANNEL It should contain only displayable characters. The maximum length is 64 characters. In a DBCS installation, it can contain DBCS characters (subject to a maximum length of 64 bytes). Note: If characters are used that are not in the coded character set identifier (CCSID) for this queue manager, they might be translated incorrectly if the information is sent to another queue manager.
DEFINE CHANNEL SYSTEM.DEF.SVRCONN SYSTEM.DEF.CLNTCONN SYSTEM.DEF.CLUSSDR SYSTEM.DEF.CLUSRCVR Server-connection channel Client-connection channel Cluster-sender channel Cluster-receiver channel This is equivalent to defining the following object: LIKE(SYSTEM.DEF.SENDER) for a sender channel, and similarly for other channel types. These default channel definitions can be altered by the installation to the default values required.
DEFINE CHANNEL MAXMSGL(integer) Specifies the maximum message length that can be transmitted on the channel. This is compared with the value for the partner and the actual maximum used is the lower of the two values. The value zero means the maximum message length for the queue manager. | | | On AIX, HP-UX, OS/2 Warp, OS/400, Sun Solaris, and Windows NT, specify a value greater than or equal to zero, and less than or equal to the maximum message length for the queue manager.
DEFINE CHANNEL | | | | | | | | v On OS/390, the user ID assigned to the channel-initiator started task by the OS/390 started-procedures table. v For TCP/IP, other than OS/390, the user ID from the inetd.conf entry, or the user that started the listener. v For SNA, other than OS/390, the user ID from the SNA server entry or (in the absence of this) the incoming attach request, or the user that started the listener. v For NetBIOS or SPX, the user ID that started the listener.
DEFINE CHANNEL This parameter is valid only for channels with a channel type (CHLTYPE) of RCVR, RQSTR, or CLUSRCVR. It is not supported on OS/390. MRTMR(integer) The minimum interval of time that must pass before the channel can retry the MQPUT operation. This time interval is in milliseconds. This parameter controls the action of the MCA only if the message-retry exit name is blank.
DEFINE CHANNEL On AIX, HP-UX, OS/2 Warp, Sun Solaris, and Windows NT, you can specify the name of more than one exit program by specifying multiple strings separated by commas. However, the total number of characters specified must not exceed 999. On OS/400, you can specify the names of up to 10 exit programs by specifying multiple strings separated by commas. On other platforms you can specify only one message exit name for each channel.
DEFINE CHANNEL If the sending side and the receiving side do not agree about this parameter, or one does not support it, NORMAL is used. This parameter is valid only for channels with a CHLTYPE of SDR, SVR, RCVR, RQSTR, CLUSSDR, or CLUSRCVR. It is valid only on AIX, HP-UX, OS/2 Warp, OS/390, OS/400, Sun Solaris, and Windows NT. PASSWORD(string) Password (maximum length 12 characters). This is used by the message channel agent when attempting to initiate a secure LU 6.
DEFINE CHANNEL || QSGDISP ALTER DEFINE | | | | | | | | | COPY The object definition resides on the page set of the queue manager that executes the command. The object was defined using a command that had the parameters QSGDISP(COPY). Any object residing in the shared repository, or any object defined using a command that had the parameters QSGDISP(QMGR), is not affected by this command.
DEFINE CHANNEL | | RCVEXIT(string) Channel receive exit name. | | | | | | On platforms other than Tandem NSK, if this name is nonblank, the exit is called at the following times: v Immediately before the received network data is processed. The exit is given the complete transmission buffer as received. The contents of the buffer can be modified as required. v At initialization and termination of the channel.
DEFINE CHANNEL SENDDATA(string) Channel send exit user data (maximum length 32 characters). This is passed to the channel send exit when it is called. On AIX, HP-UX, OS/2 Warp, Sun Solaris, and Windows NT, you can specify data for more than one exit program by specifying multiple strings separated by commas. The total length of the field must not exceed 999 characters. On OS/400, you can specify up to 10 strings, each of length 32 characters.
DEFINE CHANNEL successfully connected. However, if the cause of the failure is such that retry is unlikely to be successful, retries are not attempted. The value must be greater than or equal to zero, and less than or equal to 999 999 999. This parameter is valid only for channels with a channel type (CHLTYPE) of SDR, SVR, CLUSSDR, or CLUSRCVR. SHORTTMR(integer) For short retry attempts, this is the maximum number of seconds to wait before reattempting connection to the remote queue manager.
DEFINE CHANNEL On AIX, HP-UX, OS/2 Warp, OS/390, OS/400, Sun Solaris, and Windows NT, this parameter is optional because, if you do not enter a value, the value specified in the SYSTEM.DEF.channel-type definition is used. However, no check is made that the correct transport type has been specified if the channel is initiated from the other end. On OS/390, if the SYSTEM.DEF.channel-type definition does not exist, the default is LU62. This is required on all other platforms.
DEFINE MAXSMSGS DEFINE MAXSMSGS Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U Use DEFINE MAXSMSGS to define the maximum number of messages that a task can get or put within a single unit of recovery. Notes: 1. You can issue the DEFINE MAXSMSGS command at any time to change the number of messages allowed. 2. This command is valid only on OS/390. For other platforms use the MAXUMSGS parameter of the ALTER QMGR command instead.
DEFINE MAXSMSGS You can specify a queue manager name other than the queue manager on which it was entered, only if you are using a shared queue environment and if the command server is enabled. | | | * | | | | | 94 MQSeries MQSC Command Reference The command is executed on the local queue manager and is also passed to every active queue manager in the queue-sharing group. The effect of this is the same as entering the command on every queue manager in the queue-sharing group.
DEFINE NAMELIST DEFINE NAMELIST Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp U U U Compaq NSK UNIX systems Windows NT U U Use DEFINE NAMELIST to define 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.
DEFINE NAMELIST Parameter descriptions The parameter descriptions also apply to the ALTER NAMELIST command, with the following exceptions: v The LIKE parameter applies only to the DEFINE NAMELIST command. v The REPLACE and NOREPLACE parameter applies only to the DEFINE NAMELIST command. v The variations in the CMDSCOPE and QSGDISP parameters between the ALTER NAMELIST and DEFINE NAMELIST commands are described. (name) Name of the list. This is required.
DEFINE NAMELIST This is equivalent to specifying: LIKE(SYSTEM.DEFAULT.NAMELIST) A default namelist definition is provided, but it can be altered by the installation to the default values required. See “Rules for naming MQSeries objects” on page 4. | | | On MQSeries for OS/390, the queue manager searches page set 0 for an object with the name you specify. The disposition of the LIKE object is not copied to the object you are defining. | | | Notes: 1. QSGDISP (GROUP) objects are not searched. 2.
DEFINE NAMELIST | QSGDISP ALTER | | | | | | | | | QMGR The object definition resides on the page set The object is defined on the page set of the of the queue manager that executes the queue manager that executes the command. command. The object was defined using a This is the default value. command that had the parameters QSGDISP(QMGR). Any object residing in the shared repository, or any local copy of such an object, is not affected by this command. This is the default value.
DEFINE PROCESS DEFINE 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 DEFINE PROCESS to define a new MQSeries process definition, and set its parameters.
DEFINE PROCESS USERDATA(’ ’) (3) USERDATA(string) ENVRDATA(’ ’) (3) ENVRDATA(string) Notes: 1 Valid only 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 This is the default supplied with MQSeries, but your installation might have changed it. 4 The default depends on the platform, and can be changed by your installation.
DEFINE PROCESS NSK OS2 OS400 UNIX VMS WINDOWS WINDOWSNT DEF Represents a Tandem NSK application. Represents an OS/2 Warp application. Represents an OS/400 application. Represents a UNIX application. Represents a Digital OpenVMS application. Represents a Windows application. Represents a Windows NT application. This causes the default application type for the platform at which the command is interpreted to be stored in the process definition. This default cannot be changed by the installation.
DEFINE PROCESS It should contain only displayable characters. The maximum length is 64 characters. In a DBCS installation, it can contain DBCS characters (subject to a maximum length of 64 bytes). Note: If characters are used that are not in the coded character set identifier (CCSID) for this queue manager, they might be translated incorrectly if the information is sent to another queue manager.
DEFINE PROCESS || QSGDISP ALTER DEFINE | | | | | | | | | COPY The object definition resides on the page set of the queue manager that executes the command. The object was defined using a command that had the parameters QSGDISP(COPY). Any object residing in the shared repository, or any object defined using a command that had the parameters QSGDISP(QMGR), is not affected by this command.
DEFINE PROCESS USERDATA to the started application as part of the parameter list. The parameter list consists of the MQTMC2 structure (containing USERDATA), followed by one blank, followed by ENVRDATA with trailing blanks removed. For MQSeries message channel agents, the format of this field is a channel name of up to 20 characters. See the MQSeries Intercommunication manual for information about what these need as APPLICID.
DEFINE PSID DEFINE PSID Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U Use DEFINE PSID to define a page set and associated buffer pool. Note: You can issue DEFINE PSID only from the CSQINP1 initialization data set. If more than one DEFINE PSID command is issued for the same page set, only the last one is actioned.
DEFINE QUEUES DEFINE queues This section contains the following commands: v “DEFINE QALIAS” v “DEFINE QLOCAL” on page 108 v “DEFINE QMODEL” on page 110 v “DEFINE QREMOTE” on page 113 These queues are supported on the following platforms: Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U U U U U U U DEFINE QALIAS Use DEFINE QALIAS to define a new alias queue, and set its parameters. Note: An alias queue provides a level of indirection to another queue.
DEFINE QUEUES (1) DEFPRTY(0) DEFPSIST(NO) DEFPRTY(integer) PUT(ENABLED) (1) DESCR(’ ’) DEFPSIST(YES) (1) DESCR(string) (1) PUT(DISABLED) Alias q attrs: CLUSNL(' ') (1) CLUSNL(nlname) DEFBIND(OPEN) (2) (2) (1) DEFBIND(NOTFIXED) TARGQ(’ ’) CLUSTER(' ') (1) (2) CLUSTER(clustername) (2) (2) GET(ENABLED) GET(DISABLED) (1) (2) SCOPE(QMGR) SCOPE(CELL) (1) (3) (3) (1) TARGQ(string) Notes: 1 This is the default supplied with MQSeries, but your installation might hav
DEFINE QLOCAL DEFINE QLOCAL Use DEFINE QLOCAL to define a new local queue, and set its parameters.
DEFINE QLOCAL INITQ(’ ’) (1) INITQ(string) MSGDLVSQ(PRIORITY) (1) NOHARDENBO MSGDLVSQ(FIFO) PROCESS(’ ’) (7) MAXMSGL(4 194 304) MAXDEPTH(integer) (1) MAXMSGL(integer) (1) SHARE HARDENBO (8) NOTRIGGER NOSHARE (1) TRIGGER (1) PROCESS(string) QDEPTHHI(80) (1) QDEPTHLO(40) QDEPTHHI(integer) QDPLOEV(DISABLED) (1) QDPHIEV(DISABLED) QDPMAXEV(ENABLED) (1) QSVCINT(integer) (1) QSVCIEV( RETINTVL(999 999 999) (1) (3) (3) (1) TRIGMPRI(integer) TRIGDATA(
DEFINE QLOCAL 7 This is the default supplied with MQSeries (except on OS/390, where it is 999 999 999), but your installation might have changed it. 8 This is the default supplied with MQSeries (except on OS/390, where it is NOSHARE), but your installation might have changed it. 9 Valid only on Compaq (DIGITAL) OpenVMS, OS/2 Warp, UNIX systems, and Windows NT. DEFINE QMODEL Use DEFINE QMODEL to define a new model queue, and set its parameters.
DEFINE QMODEL DISTL(NO) (3) DISTL(YES) INITQ(’ ’) (4) GET(ENABLED) (4) MAXDEPTH(5000) INITQ(string) (3) NOHARDENBO MSGDLVSQ(FIFO) INDXTYPE( QDEPTHHI(80) PROCESS(string) (3) QDPLOEV(ENABLED) (3) NOSHARE (3) QDPMAXEV(ENABLED) (3) (3) TRIGDPTH(1) TRIGDATA(string) (3) TRIGDPTH(integer) NOTRIGGER (3) (3) (3) QDPHIEV(DISABLED) QDEPTHLO(integer) QSVCIEV( (3) HIGH OK ) STGCLASS(string) (3) TRIGMPRI(integer) (3) STGCLASS(’DEFAULT’) TRIGMPRI(0)
DEFINE QMODEL 112 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 This is the default supplied with MQSeries, but your installation might have changed it. 4 Valid only on AIX, HP-UX, OS/2 Warp, OS/400, Sun Solaris, and Windows NT. 5 This is the default supplied with MQSeries (except on OS/390, where it is 999 999 999), but your installation might have changed it.
DEFINE QREMOTE DEFINE QREMOTE Use DEFINE QREMOTE to define a new local definition of a remote queue, a queue-manager alias, or a reply-to queue alias, and to set its parameters. | | A remote queue is one that is owned by another queue manager that application processes connected to this queue manager need to access.
DEFINE QREMOTE DEFBIND(OPEN) (1) DEFBIND(NOTFIXED) SCOPE(QMGR) (1) (2) (2) (5) RNAME(’ ’) (1) RNAME(string) XMITQ(’ ’) RQMNAME(’ ’) (1) RQMNAME(string) (1) XMITQ(string) SCOPE(CELL) (5) Notes: 1 This is the default supplied with MQSeries, but your installation might have changed it. 2 Valid only on AIX, HP-UX, OS/2 Warp, OS/390, OS/400, Sun Solaris, and Windows NT. 3 Valid only on OS/390. 4 Valid only when the queue manager is a member of a queue-sharing group.
Define queues Apart from maintaining a value for this parameter, the queue manager takes no action based on its value. Specify a value greater than or equal to zero, and less than or equal to 999 999 999. | | | CFSTRUCT(cfname) Specifies the name of the Coupling Facility structure where you want messages stored when you use shared queues. | This parameter is supported only on OS/390 for local and model queues.
Define queues Only one of the resultant values of CLUSTER or CLUSNL can be nonblank; you cannot specify a value for both. On local queues, this parameter cannot be set for transmission, SYSTEM.CHANNEL.xx, SYSTEM.CLUSTER.xx, or SYSTEM.COMMAND.xx queues, and on OS/390 only, for SYSTEM.QSG.xx queues. | | | This parameter is valid only on AIX, HP-UX, OS/2 Warp, OS/390, OS/400, Sun Solaris, and Windows NT. CLUSTER(clustername) The name of the cluster to which the queue belongs.
Define queues cluster queue. This allows the queue manager to select a specific queue instance when the message is put using MQPUT, and to change that selection subsequently should the need arise. The MQPUT1 call always behaves as if NOTFIXED had been specified. This parameter is valid only on AIX, HP-UX, OS/2 Warp, OS/390, OS/400, Sun Solaris, and Windows NT. DEFPRTY(integer) The default priority of messages put on the queue.
Define queues DESCR(string) Plain-text comment. It provides descriptive information about the object when an operator issues the DISPLAY QUEUE command. It should contain only displayable characters. The maximum length is 64 characters. In a DBCS installation, it can contain DBCS characters (subject to a maximum length of 64 bytes).
Define queues v One or more applications has a queue open which resolved through this definition as a queue-manager alias Note: FORCE is not required if this definition is in use as a reply-to queue alias only. If FORCE is not specified in the circumstances described, the command is unsuccessful. GET Whether applications are to be permitted to get messages from this queue: ENABLED Messages can be retrieved from the queue (by suitably authorized applications).
Define queues Note: You cannot set INDXTYPE to MSGTOKEN if: v The queue is a model queue with a definition type of SHAREDYN v The queue is a temporary dynamic queue v The queue is a transmission queue v You specify QSGDISP(SHARED) | | | | | | | | If altering or replacing an existing nonshared queue, the INDXTYPE parameter can be changed to NONE, MSGID, or CORRELID at any time, and the change takes effect immediately if all the following conditions are satisfied: v No applications have the queue open v The
Define queues SYSTEM.DEFAULT.ALIAS.QUEUE Alias queue SYSTEM.DEFAULT.LOCAL.QUEUE Local queue SYSTEM.DEFAULT.MODEL.QUEUE Model queue SYSTEM.DEFAULT.REMOTE.QUEUE Remote queue | | This is equivalent to defining the following object: | for an alias queue, and similarly for other queue types. LIKE(SYSTEM.DEFAULT.ALIAS.QUEUE) These default queue definitions can be altered by the installation to the default values required.
Define queues larger than the maximum expected length of user data in any message that could be put on a transmission queue. If this value is reduced, any messages that are already on the queue, whose length exceeds the new maximum, are not affected. Applications can use this parameter to determine the size of buffer they need to retrieve messages from the queue. Therefore, the value should only be reduced if it is known that this will not cause an application to operate incorrectly.
Define queues This parameter can also be changed using the MQSET API call. QDEPTHHI(integer) The threshold against which the queue depth is compared to generate a Queue Depth High event. | | | This parameter is supported only on local and model queues. For more information about the effect that shared queues on OS/390 have on this event, see the MQSeries Event Monitoring book.
Define queues A Queue Depth Low event indicates that an application has retrieved a message from a queue, and this has caused the number of messages on the queue to become less than or equal to the queue depth low threshold (see the QDEPTHLO parameter). Note: The value of this parameter can change implicitly. For more information on this, and the effect that shared queues on OS/390 have on this event, see the description of the Queue Depth Low event in theMQSeries Event Monitoring book.
Define queues | QSGDISP ALTER DEFINE | | | | | | | || | | | | | | | GROUP The object definition resides in the shared repository. The object was defined using a command that had the parameters QSGDISP(GROUP). Any object residing on the page set of the queue manager that executes the command (except a local copy of the object), or any object defined using a command that had the parameters QSGDISP(SHARED), is not affected by this command.
Define queues A Service Interval High event is generated when a check indicates that no messages have been retrieved from the queue for at least the time indicated by the QSVCINT parameter. A Service Interval OK event is generated when a check indicates that messages have been retrieved from the queue within the time indicated by the QSVCINT parameter. Note: The value of this parameter can change implicitly.
Define queues If SCOPE(CELL) is specified on Compaq (DIGITAL) OpenVMS, UNIX systems, OS/2 Warp, or Windows NT, and there is already a queue with the same name in the cell directory, the command fails, whether or not REPLACE is specified. RETINTVL(integer) The number of hours (greater than or equal to zero, and less than or equal to 999 999 999) from the queue creation date and time (the date and time at which the queue was defined), after which the queue is no longer needed.
Define queues The name is not checked to ensure that it contains only those characters normally allowed for MQSeries object names (see “Rules for naming MQSeries objects” on page 4). SCOPE Specifies the scope of the queue definition. This parameter is supported only on alias, local, and remote queues. QMGR The queue definition has queue-manager scope. This means that the definition of the queue does not extend beyond the queue manager that owns it.
Define queues | | If you specify QSGDISP(SHARED) or DEFTYPE(SHAREDYN), this parameter is ignored. TARGQ(string) The local name of the base queue being aliased. (See “Rules for naming MQSeries objects” on page 4.) The maximum length is 48 characters. This parameter is supported only on alias queues.
Define queues This parameter can also be changed using the MQSET API call. TRIGTYPE Whether and under what conditions a trigger message is written to the initiation queue (named by the INITQ parameter): This parameter is supported only on local and model queues. FIRST Whenever the first message of priority equal to or greater than that specified by the TRIGMPRI parameter of the queue arrives on the queue.
Usage notes Usage notes 1. For alias queues: a. DEFINE QALIAS(otherqname) TARGQ(aliasqueue) CLUSTER(c) has the effect of advertising queue aliasqueue by the name otherqname. b. DEFINE QALIAS(otherqname) TARGQ(aliasqueue) has the effect of allowing a queue advertised by the name otherqname to be used on this queue manager by the name aliasqueue. 2. For remote queues: a.
DEFINE STGCLASS DEFINE STGCLASS Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U Use DEFINE STGCLASS to define a storage class to page set mapping.
DEFINE STGCLASS Note: Exceptionally, certain all numeric storage class names are allowed, but are reserved for the use of IBM service personnel. The storage class must not be the same as any other storage class currently defined on this queue manager. | | | CMDSCOPE This parameter specifies how the command is executed when the queue manager is a member of a queue-sharing group. | | CMDSCOPE must be blank, or the local queue manager, if QSGDISP is set to GROUP.
DEFINE STGCLASS Notes: 1. QSGDISP (GROUP) objects are not searched. 2. LIKE is ignored if QSGDISP(COPY) is specified. | | | NOREPLACE and REPLACE Whether the existing definition, and with the same disposition, is to be replaced with this one. This is optional. The default is NOREPLACE. Any object with a different disposition is not changed. | | | | NOREPLACE The definition should not replace any existing definition of the same name.
DEFINE STGCLASS | QSGDISP ALTER | | | | | PRIVATE The object resides on the page set of the queue manager that executes the command, and was defined with QSGDISP(QMGR) or QSGDISP(COPY). Any object residing in the shared repository is unaffected. | | | | | | | | | QMGR The object definition resides on the page set The object is defined on the page set of the of the queue manager that executes the queue manager that executes the command. command.
DELETE CHANNEL DELETE 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 DELETE CHANNEL to delete a channel definition. Notes for OS/390 users: 1. This is valid only for channels used for distributed queuing without CICS. If you are using CICS for distributed queuing, see the MQSeries Intercommunication manual. 2.
DELETE CHANNEL CLNTTBL The channel table for CLNTCONN channels. On Compaq (DIGITAL) OpenVMS, OS/2 Warp, OS/400, Tandem NSK, UNIX systems, and Windows NT this is normally associated with a queue manager, but can be a system-wide, queue-manager independent channel table if you set up a number of environment variables. For more information about setting up environment variables, see the MQSeries Clients manual.
DELETE CHANNEL QMGR | | | | | | The object definition resides on the page set of the queue manager that executes the command. The object was defined using a command that had the parameters QSGDISP(QMGR). Any object residing in the shared repository, or any local copy of such an object, is not affected by this command. This is the default value.
DELETE NAMELIST DELETE NAMELIST Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp U U U Compaq NSK UNIX systems Windows NT U U Use DELETE NAMELIST to delete a namelist definition. Notes: 1. On UNIX systems, the command is valid only on AIX, HP-UX, and Sun Solaris. Synonym: DELETE NL DELETE NAMELIST CMDSCOPE(’ ’) DELETE NAMELIST(name) CMDSCOPE(qmgr-name) (2) CMDSCOPE(*) QSGDISP(QMGR) QSGDISP(COPY) QSGDISP(GROUP) (1) (2) (1) ! (2) Notes: 1 Valid only on OS/390.
DELETE NAMELIST You can specify a queue manager name, other than the queue manager on which the command was entered, only if you are using a queue-sharing group environment and if the command server is enabled. | | | | * | | | | The command is executed on the local queue manager and is also passed to every active queue manager in the queue-sharing group. The effect of this is the same as entering the command on every queue manager in the queue-sharing group.
DELETE PROCESS DELETE 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 DELETE PROCESS to delete a process definition. Synonym: DELETE PRO DELETE PROCESS DELETE PROCESS(process-name) CMDSCOPE(’ ’) (1) CMDSCOPE(qmgr-name) (2) CMDSCOPE(*) QSGDISP(QMGR) QSGDISP(COPY) QSGDISP(GROUP) (2) (1) ! (2) Notes: 1 Valid only on OS/390. 2 Valid only when the queue manager is a member of a queue-sharing group.
DELETE PROCESS You can specify a queue manager name, other than the queue manager on which the command was entered, only if you are using a queue-sharing group environment and if the command server is enabled. | | | | * | | | | The command is executed on the local queue manager and is also passed to every active queue manager in the queue-sharing group. The effect of this is the same as entering the command on every queue manager in the queue-sharing group. QSGDISP This parameter applies to OS/390 only.
DELETE Queues DELETE queues This section contains the following commands: v “DELETE QALIAS” v “DELETE QLOCAL” on page 144 v “DELETE QMODEL” on page 145 v “DELETE QREMOTE” on page 145 These queues are supported on the following platforms: Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U U U U U U U DELETE QALIAS Use DELETE QALIAS to delete an alias queue definition.
DELETE Queues DELETE QLOCAL Use DELETE QLOCAL to delete a local queue definition. You can specify that the queue must not be deleted if it contains messages, or that it can be deleted even if it contains messages. Synonym: DELETE QL DELETE QLOCAL DELETE QLOCAL(q-name) QSGDISP(QMGR) QSGDISP(COPY) QSGDISP(GROUP) QSGDISP(SHARED) NOPURGE PURGE CMDSCOPE(’ ’) CMDSCOPE(qmgr-name) (2) CMDSCOPE(*) (1) (2) (1) (2) (2) Notes: 144 1 Valid only on OS/390.
DELETE Queues DELETE QMODEL Use DELETE QMODEL to delete a model queue definition. Synonym: DELETE QM DELETE QMODEL DELETE QMODEL(q-name) CMDSCOPE(’ ’) CMDSCOPE(qmgr-name) (2) CMDSCOPE(*) QSGDISP(QMGR) QSGDISP(COPY) QSGDISP(GROUP) (1) (2) (1) ! (2) Notes: 1 Valid only 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.
DELETE Queues Parameter descriptions (q-name) The name of the queue must be defined to the local queue manager for all of the queue types. For an alias queue this is the local name of the alias queue to be deleted. For a model queue this is the local name of the model queue to be deleted. For a remote queue this is the local name of the remote queue to be deleted. For a local queue this is the name of the local queue to be deleted. You must specify which queue you want to delete.
DELETE Queues | | | | | | QSGDISP Specifies the disposition of the object to which you are applying the command (that is, where it is defined and how it behaves). If the object definition is shared, you do not need to delete it on every queue manager that is part of a queue-sharing group. (Queue-sharing groups are available only on MQSeries for OS/390.) | | | | | | COPY The object definition resides on the page set of the queue manager that executes the command.
DELETE STGCLASS DELETE STGCLASS Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Compaq NSK UNIX systems Windows NT U Use DELETE STGCLASS to delete a storage class definition Synonym: DELETE STC DELETE STGCLASS DELETE STGCLASS(name) CMDSCOPE(’ ’) CMDSCOPE(qmgr-name) (1) CMDSCOPE(*) QSGDISP(QMGR) (1) QSGDISP(COPY) QSGDISP(GROUP) ! (1) Notes: 1 Valid only when the queue manager is a member of a queue-sharing group.
DELETE STGCLASS The effect of this is the same as entering the command on every queue manager in the queue-sharing group. | | | | | QSGDISP Specifies the disposition of the object to which you are applying the command (that is, where it is defined and how it behaves). | | | | | | COPY The object definition resides on the page set of the queue manager that executes the command. The object was defined using a command that had the parameters QSGDISP(COPY).
DISPLAY CHANNEL DISPLAY 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 DISPLAY CHANNEL to display a channel definition. 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, see the MQSeries Intercommunication manual. 2. You can only display cluster-sender channels if they were created manually.
DISPLAY CHANNEL , " ALTDATE ALTTIME (1) (1) (2) AUTOSTART (1) BATCHINT BATCHSZ CHLTYPE (1) CLUSTER (1) CLUSNL CONNAME CONVERT DESCR DISCINT (1) HBINT LONGRTY LONGTMR MAXMSGL MCANAME (1) MCATYPE MCAUSER MODENAME (3) MRDATA (3) MREXIT (3) MRRTY (3) MRTMR MSGDATA MSGEXIT (1) NETPRTY (1) NPMSPEED PASSWORD PUTAUT QMNAME RCVDATA RCVEXIT SCYDATA SCYEXIT SENDDATA SENDEXIT SEQWRAP SHORTRTY SHORTTMR TPNAME TRPTYPE USERID XMITQ Notes: 1 Valid only on AIX, HP-UX, OS/2 Warp, OS/390, OS/400, Sun Solaris, and Windows
DISPLAY CHANNEL 5 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 You must specify the name of the channel definition you want to display. This can be a specific channel name or a generic channel name.
DISPLAY CHANNEL If no parameters are specified (and the ALL parameter is not specified or defaulted), the default is that the channel names only are displayed. On OS/390, the CHLTYPE is also displayed. | | | CMDSCOPE This parameter applies to OS/390 only and specifies how the command is executed when the queue manager is a member of a queue-sharing group. | | CMDSCOPE must be blank, or the local queue manager, if QSGDISP is set to GROUP.
DISPLAY CHANNEL in the queue-sharing group without duplicating those in the shared repository. | | | | COPY Display information only for objects defined with QSGDISP(COPY). | | | GROUP Display information only for objects defined with QSGDISP(GROUP). This is allowed only if there is a shared queue manager environment. | | | | PRIVATE Display information only for objects defined with QSGDISP(QMGR) or QSGDISP(COPY). Note that QSGDISP(PRIVATE) displays the same information as QSGDISP(LIVE).
DISPLAY CHANNEL CLUSNL The name of the namelist that specifies the list of clusters to which the channel belongs. CONNAME Connection name. CONVERT Whether sender should convert application message data. DESCR Description. DISCINT Disconnection interval. HBINT Heartbeat interval. LONGRTY Long retry count. LONGTMR Long retry timer. MAXMSGL Maximum message length for channel. MCANAME Message channel agent name.
DISPLAY CHANNEL 156 USERID User identifier for initiating LU 6.2 session. XMITQ Transmission queue name.
DISPLAY CHSTATUS DISPLAY CHSTATUS Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp UNIX systems Compaq NSK Windows NT U U U U U U U Use DISPLAY CHSTATUS to display the status of one or more channels. Note: On OS/390: 1. This is valid only for channels used for distributed queuing without CICS. If you are using CICS for distributed queuing, see the MQSeries Intercommunication manual. 2. The command fails if the channel initiator has not been started. 3. The command server must be running.
DISPLAY CHSTATUS Current-only status: , " BATCHES BATCHSZ BUFSRCVD BUFSSENT BYTSRCVD BYTSSENT CHSTADA CHSTATI (1) HBINT (2) JOBNAME LONGRTS LSTMSGDA LSTMSGTI (3) MAXMSGL (2) MCASTAT MSGS (1) NPMSPEED SHORTRTS STOPREQ Short status: (3) QMNAME Notes: 1 Valid only on AIX, HP-UX, OS/2 Warp, OS/390, OS/400, Sun Solaris, and Windows NT. 2 Ignored if specified on OS/390. 3 Valid only on OS/390. 4 Valid only when the queue manager is a member of a queue-sharing group.
DISPLAY CHSTATUS Status for all channels that meet the selection criteria is given, whether the channels were defined manually or automatically. Before explaining the syntax and options for this command, it is necessary to describe the format of the status data that is available for channels and the states that channels can have. | | There are three classes of data available for channel status. These are saved, current, and (on OS/390 only) short.
DISPLAY CHSTATUS even of establishing contact with the partner. Current channels have current status and might also have saved status. The term Active is used to describe the set of current channels which are not stopped. Inactive channels These are channels that either: v Have not been started v On which a client has not connected v Have finished v Have disconnected normally (Note that if a channel is stopped, it is not yet considered to have finished normally – and is, therefore, still current.
DISPLAY CHSTATUS | | | | | | | | CHLDISP This parameter applies to OS/390 only and specifies the disposition of the channels for which information is to be displayed, as used in the START and STOP CHANNEL commands, and not that set by QSGDISP for the channel definition. Values are: ALL This is the default value and displays requested status information for private channels.
DISPLAY CHSTATUS CONNAME(connection-name) The connection name for which status information is to be displayed, for the specified channel or channels. | This parameter can be used to limit the number of sets of status information that is displayed. If it is not specified, the display is not limited in this way. The value returned for CONNAME might not be the same as in the channel definition, and might differ between the current channel status and the saved channel status.
DISPLAY CHSTATUS | | v The type of status information returned (CURRENT, SAVED, or on OS/390 only, SHORT) v STATUS (except for SAVED on OS/390) v On OS/390, CHLDISP If no parameters requesting specific status information are specified (and the ALL parameter is not specified), no further information is returned. If status information is requested which is not relevant for the particular channel type, this is not an error.
DISPLAY CHSTATUS This is only YES while the sending Message Channel Agent is waiting for an acknowledgment that a batch of messages, which it has sent, has been successfully received. It is NO at all other times, including the period during which messages are being sent, but before an acknowledgment has been requested. For a receiving channel, the value is always NO. LSTLUWID The logical unit of work identifier associated with the last committed batch of messages transferred.
DISPLAY CHSTATUS A channel in this state can be restarted only by issuing the START CHANNEL command, or starting the MCA program in an operating-system dependent manner. | | | REQUESTING A local requester channel is requesting services from a remote MCA. On OS/390, STATUS is not displayed if saved data is requested. Note: For an inactive channel, CURMSGS, CURSEQNO, and CURLUWID have meaningful information only if the channel is INDOUBT. However they are still displayed and returned if requested.
DISPLAY CHSTATUS This information is not available on OS/390. The parameter is ignored if specified. HBINT The heartbeat interval being used for this session. LONGRTS Number of long retry wait start attempts left. This applies only to sender or server channels. LSTMSGDA Date when the last message was sent or MQI call was handled, see LSTMSGTI. LSTMSGTI Time when the last message was sent or MQI call was handled.
DISPLAY CHSTATUS | Table 2.
DISPLAY CLUSQMGR DISPLAY CLUSQMGR Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp U U U Compaq NSK UNIX systems Windows NT U U Use DISPLAY CLUSQMGR to display a cluster information about queue managers in a cluster. Notes: 1. On UNIX systems, the command is valid only on AIX, HP-UX, and Sun Solaris. 2. On OS/390, the command fails if the channel initiator has not been started.
DISPLAY CLUSQMGR , " ALTDATE ALTTIME BATCHINT BATCHSZ CONNAME CONVERT DESCR DISCINT HBINT LONGRTY LONGTMR MAXMSGL MCANAME MCATYPE MCAUSER MODENAME (3) MRDATA (3) MREXIT (3) MRRTY (3) MRTMR MSGDATA MSGEXIT NETPRTY NPMSPEED (3) PASSWORD PUTAUT RCVDATA RCVEXIT SCYDATA SCYEXIT SENDDATA SENDEXIT SEQWRAP SHORTRTY SHORTTMR TPNAME TRPTYPE (3) USERID Notes: 1 Valid only on OS/390. 2 Valid only when the queue manager is a member of a queue-sharing group.
DISPLAY CLUSQMGR all parameters are still displayed. This is the default if you do not specify a generic name and do not request any specific parameters. CHANNEL(generic-name) This is optional, and limits the information displayed to cluster queue managers with the specified channel name. The value can be a generic name. CLUSTER(generic-name) This is optional, and limits the information displayed to cluster queue managers with the specified cluster name. The value can be a generic name.
DISPLAY CLUSQMGR CLUSRCVR As a cluster-receiver channel from an explicit definition. QMTYPE The function of the queue manager in the cluster: REPOS Provides a full repository service. NORMAL Does not provide a full repository service. QMID The internally generated unique name of the queue manager. STATUS The current status of the channel for this queue manager. This is one of the following: STARTING A request has been made to start the channel but the channel has not yet begun processing.
DISPLAY CLUSQMGR A channel in this state can be restarted only by issuing the START CHANNEL command, or starting the MCA program in an operating-system dependent manner. REQUESTING A local requester channel is requesting services from a remote MCA. SUSPEND Whether this queue manager is suspended from the cluster or not (as a result of the SUSPEND QMGR command). This is either YES or NO.
DISPLAY CLUSQMGR RCVDATA Channel receive exit user data RCVEXIT Channel receive exit names SCYDATA Channel security exit user data SCYEXIT Channel security exit name SENDDATA Channel send exit user data SENDEXIT Channel send exit names SEQWRAP Sequence number wrap value SHORTRTY Short retry count SHORTTMR Short retry timer TRPTYPE Transport type TPNAME LU 6.2 transaction program name USERID User identifier for initiating LU 6.2 session Chapter 2.
DISPLAY CMDSERV DISPLAY CMDSERV Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U Use DISPLAY CMDSERV to display the status of the command server. Synonym: DIS CS DISPLAY CMDSERV DISPLAY CMDSERV Usage notes 1. The command server takes messages from the system command input queue, and commands using CMDSCOPE, and processes them. DISPLAY CMDSERV displays the status of the command server. 2.
DISPLAY DQM DISPLAY DQM Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U Use DISPLAY DQM to display information about the channel initiator. | Notes: 1. This is valid only for channels used for distributed queuing without CICS. If you are using CICS for distributed queuing, see the MQSeries Intercommunication manual. 2. The command server must be running.
DISPLAY DQM Usage notes | 1. The response to this command is a series of messages showing the current status of the channel initiator. This includes the following: v Whether the channel initiator is running or not v Which listeners are started, and information about them.
DISPLAY GROUP | || | | | | DISPLAY GROUP Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U | | Use DISPLAY GROUP to display information about the queue-sharing group to which the queue manager is connected. | Synonym: DIS GROUP | DISPLAY GROUP | DISPLAY GROUP ! | | | | | | | | | | | Usage notes 1.
DISPLAY LOG | || | | DISPLAY LOG Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U | | | Use DISPLAY LOG to display archive log information. | Synonym: DIS LOG | DISPLAY LOG CMDSCOPE(’ ’) CMDSCOPE(qmgr-name) (1) CMDSCOPE(*) (1) ! | | Notes: | 1 Valid only when the queue manager is a member of a queue-sharing group.
DISPLAY LOG | | | | v The current parameter values for MAXRTU and DEALLCT, that can be set by the SET LOG command v Availability status of allocated dedicated tape units v Volume and data set names associated with all busy tape units | Chapter 2.
DISPLAY MAXSMSGS DISPLAY MAXSMSGS Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U Use DISPLAY MAXSMSGS to see the maximum number of messages that a task can get or put within a single unit of recovery. Notes: 1. This command is valid only on OS/390. For other platforms, use the MAXUMSGS parameter of the DISPLAY QMGR command instead. 2. You can issue the DISPLAY MAXSMSGS command at any time to see the number of messages allowed.
DISPLAY NAMELIST | DISPLAY NAMELIST Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp U U U Compaq NSK UNIX systems Windows NT U U Use DISPLAY NAMELIST to display the names in a namelist. Note: On UNIX systems, the command is valid only on AIX, HP-UX, and Sun Solaris.
DISPLAY NAMELIST v One or more namelists that match the specified name (generic-namelist-name) The name of the namelist definition to be displayed (see “Rules for naming MQSeries objects” on page 4). A trailing asterisk (*) matches all namelists with the specified stem followed by zero or more characters. An asterisk (*) on its own specifies all namelists. The namelists must all be defined to the local queue manager. ALL Specify this to display all the parameters.
DISPLAY NAMELIST | | to list ALL objects matching | | in the queue-sharing group without duplicating those in the shared repository. name | | COPY Display information only for objects defined with QSGDISP(COPY). | | | GROUP Display information only for objects defined with QSGDISP(GROUP). This is allowed only if there is a shared queue manager environment. | | | | PRIVATE Display information for objects defined with QSGDISP(QMGR) or QSGDISP(COPY).
DISPLAY PROCESS DISPLAY 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 DISPLAY PROCESS to display the attributes of one or more MQSeries processes.
DISPLAY PROCESS Parameter descriptions You must specify the name of the process you want to display. This can be a specific process name or a generic process name. By using a generic process name, you can display either: v All process definitions v One or more processes that match the specified name (generic-process-name) The name of the process definition to be displayed (see “Rules for naming MQSeries objects” on page 4).
DISPLAY PROCESS | | | | If there is a shared queue manager environment, and the command is being executed on the queue manager where it was issued, this option also displays information for objects defined with QSGDISP(GROUP). | | | | If QSGDISP(LIVE) is specified or defaulted, or if QSGDISP(ALL) is specified in a shared queue manager environment, the command might give duplicated names (with different dispositions). | | COPY Display information only for objects defined with QSGDISP(COPY).
DISPLAY QMGR DISPLAY 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 DISPLAY QMGR to display the queue manager parameters for this queue manager. Synonym: DIS QMGR DISPLAY QMGR. CMDSCOPE(’ ’) DISPLAY QMGR ALL CMDSCOPE(qmgr-name) (5) CMDSCOPE(*) (3) (5) requested attrs ! Requested attrs: Chapter 2.
DISPLAY QMGR , " ALTDATE (1) (1) ALTTIME AUTHOREV CCSID (2) CHAD (1) CHADEV (1) CHADEXIT (1) CLWLEXIT (1) CLWLDATA (1) CLWLLEN CMDLEVEL COMMANDQ (3) CPILEVEL DEADQ DEFXMITQ DESCR (2) DISTL (3) IGQ (3) IGQAUT (3) IGQUSER INHIBTEV LOCALEV MAXHANDS MAXMSGL MAXPRTY (4) MAXUMSGS PERFMEV PLATFORM (1) QMID QMNAME (3) QSGNAME REMOTEEV (1) REPOS (1) REPOSNL STRSTPEV SYNCPT TRIGINT Notes: 188 1 Valid only on AIX, HP-UX, OS/2 Warp, OS/390, OS/400, Sun Solaris, and Windows NT.
DISPLAY QMGR 3 Valid only on OS/390. 4 Not valid on OS/390. 5 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 ALL Specify this to cause all parameters to be displayed. If this parameter is specified, any parameters that are requested specifically have no effect; all parameters are still displayed.
DISPLAY QMGR AUTHOREV Whether authorization events are generated. CCSID Coded character set identifier. This applies to all character string fields defined by the application programming interface (API), including the names of objects, and the creation date and time of each queue. It does not apply to application data carried as the text of messages. CHAD Whether auto-definition of receiver and server-connection channels is enabled.
DISPLAY QMGR – The queue is inhibited for puts – The sending node does not have authority to put the message on the queue v An exception message needs to be generated, but the queue named is not known to that queue manager Note: Messages that have passed their expiry time are not transferred to this queue when they are discarded.
DISPLAY QMGR PERFMEV Whether performance-related events are generated. PLATFORM The architecture of the platform on which the queue manager is running. This is MVS, OPENVMS, NSK, OS2, OS400, UNIX, or WINDOWSNT. QMID The internally generated unique name of the queue manager. This parameter is valid only on AIX, HP-UX, OS/2 Warp, OS/390, OS/400, Sun Solaris, and Windows NT. QMNAME The name of the local queue manager. See “Rules for naming MQSeries objects” on page 4.
DISPLAY QSTATUS | || | | | | DISPLAY QSTATUS Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp UNIX systems Compaq NSK U | Use DISPLAY QSTATUS to display the status of one or more queues.
DISPLAY QSTATUS | , " APPLTAG APPLTYPE ASID BROWSE CHANNEL CONNAME INPUT INQUIRE OUTPUT (1) (1) (2) PSBNAME (2) PSTID QSGDISP SET (3) TASKNO (3) TRANSID (4) URID USERID | | Notes: | 1 Channel initiator only | 2 IMS only | 3 CICS only | 4 RRSBATCH only | 5 Valid only when the queue manager is a member of a queue-sharing group. Parameter descriptions | | | | | | | You must specify the name of the queue for which you want to display status information.
DISPLAY QSTATUS on its own matches all queues. The queues must all be defined to the local queue manager or queue-sharing group. | | | ALL This is the default if you do not specify a generic name, and do not request any specific parameters. | | | | | Display all of the status information for each specified queue. CMDSCOPE This parameter specifies how the command is executed when the queue manager is a member of a queue-sharing group.
DISPLAY QSTATUS | | | v Current queue depth (CURDEPTH parameter) v Queue-sharing group disposition (QSGDISP parameter) - only if there is a queue-sharing group environment. | | | | The following parameters can be specified for TYPE(QUEUE) to request additional information for each queue. If a parameter is specified that is not relevant for the queue, operating environment, or type of status information requested, that parameter is ignored.
DISPLAY QSTATUS | | | | | v v v v v | v Whether handle is providing set access (SET parameter) | | | | The following parameters can be specified for TYPE(HANDLE) to request additional information for each queue. If a parameter that is not relevant is specified for the queue, operating environment, or type of status information requested, that parameter is ignored. | | | | | | | | APPLTAG A string containing the tag of the application connected to the queue manager.
DISPLAY QSTATUS | | | | | | | | INPUT | | | | | INQUIRE Indicates whether the handle is providing inquire access to the queue. The value is one of the following: YES The handle is providing inquire access. NO The handle is not providing inquire access. | | | | | OUTPUT Indicates whether the handle is providing output access to the queue. The value is one of the following: YES The handle is providing output access. NO The handle is not providing output access.
DISPLAY QSTATUS | | TRANSID A 4-character CICS transaction identifier. This parameter is returned only when the APPLTYPE parameter has the value CICS. | | | | | | | | | | URID The 32-character hexadecimal form of the 16-byte RRS unit-of-recovery identifier associated with the handle. This parameter is returned only when the APPLTYPE parameter has the value RRSBATCH. USERID The user identifier associated with the handle. This parameter is not returned when APPLTYPE has the value SYSTEM. | Chapter 2.
DISPLAY QUEUE DISPLAY QUEUE Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U U U U U U U Use DISPLAY QUEUE to display the attributes of one or more queues of any type. Notes: 1. On AIX, HP-UX, OS/2 Warp, OS/390, OS/400, Sun Solaris, and Windows NT, you can use the following commands (or their synonyms) as an alternative way to display these attributes.
DISPLAY QUEUE QSGDISP(LIVE) (5) QSGDISP(ALL) QSGDISP(QMGR) QSGDISP(COPY) (2) (generic-name) (5) QSGDISP(GROUP) QSGDISP(PRIVATE) (5) QSGDISP(SHARED) TYPE(queue-type) STGCLASS (2) ! requested attrs Requested attrs: Chapter 2.
DISPLAY QUEUE , " ALTDATE ALTTIME BOQNAME BOTHRESH CLUSDATE (1) (1) (1) (1) CLUSQMGR (1) CLUSQT (1) CLUSTIME CRDATE CRTIME CURDEPTH (1) DEFBIND DEFPRTY DEFPSIST DEFSOPT DEFTYPE DESCR (3) DISTL GET HARDENBO (2) INDXTYPE INITQ IPPROCS MAXDEPTH MAXMSGL MSGDLVSQ OPPROCS PROCESS PUT QDEPTHHI QDEPTHLO QDPHIEV QDPLOEV QDPMAXEV (1) QMID QSVCIEV QSVCINT QTYPE RETINTVL RNAME RQMNAME (4) SCOPE SHARE TARGQ TRIGDATA TRIGDPTH TRIGGER TRIGMPRI TRIGTYPE USAGE XMITQ 202 MQSeries MQSC Command Reference
DISPLAY QUEUE Notes: 1 Valid only on AIX, HP-UX, OS/2 Warp, OS/390, OS/400, Sun Solaris, and Windows NT. 2 Valid only on OS/390. 3 Valid only on AIX, HP-UX, OS/2 Warp, OS/400, Sun Solaris, and Windows NT. 4 Not valid on OS/390 or OS/400. 5 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 You must specify the name of the queue definition you want to display.
DISPLAY QUEUE If you do not enter a value to qualify this parameter, it is treated as a requested parameter, and cluster name information is returned about all the queues displayed. This parameter is valid only on AIX, HP-UX, OS/2 Warp, OS/390, OS/400, Sun Solaris, and Windows NT. CLUSNL(generic-name) This is optional, and limits the information displayed if entered with a value in brackets: v For queues defined on the local queue manager, only those with the specified cluster list.
DISPLAY QUEUE environment, and the command is being executed on the queue manager where it was issued, also display information for objects defined with QSGDISP(SHARED). | | | | | | | ALL Display information for objects defined with QSGDISP(QMGR) or QSGDISP(COPY). | | | | | | If there is a shared queue manager environment, and the command is being executed on the queue manager where it was issued, this option also displays information for objects defined with QSGDISP(GROUP) or QSGDISP(SHARED).
DISPLAY QUEUE | | QMGR The object was defined with QSGDISP(QMGR). | | GROUP The object was defined with QSGDISP(GROUP). | | COPY The object was defined with QSGDISP(COPY). | | SHARED The object was defined with QSGDISP(SHARED). STGCLASS(generic-name) This is optional, and limits the information displayed to queues with the storage class specified if entered with a value in brackets. The value can be a generic name.
DISPLAY QUEUE Table 5.
DISPLAY QUEUE Table 5. Parameters that can be returned by the DISPLAY QUEUE command (continued) Local queue Model queue Alias queue Remote queue RNAME U RQMNAME U SCOPE⁴ U U SHARE U U STGCLASS³ U U Cluster queue U U TARGQ TRIGDATA U U TRIGDPTH U U TRIGGER U U TRIGMPRI U U TRIGTYPE U U USAGE U U XMITQ U Notes: 1. Supported only on AIX, HP-UX, OS/2 Warp, OS/390, OS/400, Sun Solaris, and Windows NT 2.
DISPLAY QUEUE QMGR The cluster queue represents a queue manager alias. QREMOTE The cluster queue represents a remote queue. CLUSTER The name of the cluster that the queue is in. CLUSTIME The time at which the definition became available to the local queue manager, in the form hh.mm.ss. CRDATE The date on which the queue was defined (in the form yyyy-mm-dd). CRTIME The time at which the queue was defined (in the form hh.mm.ss). CURDEPTH Current depth of queue.
DISPLAY QUEUE | | | A permanent dynamic queue was created when an application issued an MQOPEN API call with the name of this model queue specified in the object descriptor (MQOD). | | On OS/390, in a queue-sharing group environment, the queue was created with QSGDISP(SHARED). DESCR Descriptive comment. DISTL Whether distribution lists are supported by the partner queue manager. (Supported only on AIX, HP-UX, OS/2 Warp, OS/400, Sun Solaris, and Windows NT.) GET Whether the queue is enabled for gets.
DISPLAY QUEUE QDPLOEV Whether Queue Depth Low events are generated. QDPMAXEV Whether Queue Full events are generated. QMID The internally generated unique name of the queue manager that hosts the queue. QSVCIEV Whether service interval events are generated. QSVCINT Service interval event generation threshold. QTYPE Queue type. On AIX, HP-UX, OS/2 Warp, OS/400, Sun Solaris, and Windows NT, the queue type is always displayed if you specify a generic queue name and do not request any other parameters.
DISPLAY QUEUE XMITQ Transmission queue name.
DISPLAY SECURITY DISPLAY SECURITY Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U Use DISPLAY SECURITY to display the current settings for the security parameters. Synonym: DIS SEC DISPLAY SECURITY DISPLAY SECURITY CMDSCOPE(’ ’) CMDSCOPE(qmgr-name) (1) CMDSCOPE(*) (1) ! requested attrs Requested attrs: ALL , " INTERVAL SWITCHES TIMEOUT Notes: 1 Valid only when the queue manager is a member of a queue-sharing group.
DISPLAY SECURITY * | | | | ALL | The command is executed on the local queue manager and is also passed to every active queue manager in the queue-sharing group. The effect of this is the same as entering the command on every queue manager in the queue-sharing group. Display the TIMEOUT, INTERVAL, and SWITCHES parameters. This is the default if no requested parameters are specified. INTERVAL Time interval between checks. SWITCHES Display the current setting of the switch profiles.
DISPLAY STGCLASS DISPLAY STGCLASS Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U Use DISPLAY STGCLASS to display information about storage classes.
DISPLAY STGCLASS A trailing asterisk (*) matches all storage classes with the specified stem followed by zero or more characters. An asterisk (*) on its own specifies all storage classes. CMDSCOPE This parameter specifies how the command is executed when the queue manager is a member of a queue-sharing group. | | | | | If QSGDISP is set to GROUP, CMDSCOPE must be blank or the local queue manager.
DISPLAY STGCLASS in the queue-sharing group without duplicating those in the shared repository. | | | | COPY Display information only for objects defined with QSGDISP(COPY). | | | GROUP Display information only for objects defined with QSGDISP(GROUP). This is allowed only if there is a shared queue manager environment. | | PRIVATE Display information only for objects defined with QSGDISP(QMGR) or QSGDISP(COPY). | | QMGR Display information only for objects defined with QSGDISP(QMGR).
DISPLAY THREAD DISPLAY THREAD Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U Use DISPLAY THREAD to display information about active and in-doubt threads. Threads shown as in doubt on one invocation of this command will probably be resolved for subsequent invocations.
DISPLAY THREAD qmgr-name The command is executed on the queue manager you specify, providing the queue manager is active within the queue-sharing group. | | | | You can specify a queue manager name, other than the queue manager on which the command was entered, only if you are using a queue-sharing group environment and if the command server is enabled.
DISPLAY TRACE DISPLAY TRACE Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U Use DISPLAY TRACE to display a list of active traces.
DISPLAY TRACE Parameter descriptions All parameters are optional. Each option that is used limits the effect of the command to active traces that were started using the same option, either explicitly or by default, with exactly the same parameter values. * Does not limit the list of traces. This is the default. The CLASS option cannot be used with DISPLAY TRACE(*).
DISPLAY TRACE Destination block | DEST Limits the list to traces started for particular destinations. More than one value can be specified, but do not use the same value twice. If no value is specified, the list is not limited.
DISPLAY USAGE DISPLAY USAGE Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U Use DISPLAY USAGE to display information about the current state of a page set. Synonym: DIS USAGE DISPLAY USAGE DISPLAY USAGE CMDSCOPE(’ ’) CMDSCOPE(qmgr-name) (1) CMDSCOPE(*) PSID(*) (1) ! PSID(integer) Notes: 1 Valid only when the queue manager is a member of a queue-sharing group.
DISPLAY USAGE DISPLAY USAGE returns three sets of information in the following messages: CSQI018I The number of pages currently being used on the page set specified. CSQI030I The number of extents at restart, and the number of times the page set has been expanded dynamically since restart. CSQI024I The restart RBA (relative byte address) for the subsystem. This value can be used to determine where to truncate logs, if required.
MOVE QLOCAL | || | | | | MOVE QLOCAL Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U | Use MOVE QLOCAL to move all the messages from one local queue to another. | Synonym: MOVE QL | MOVE QLOCAL | | MOVE QLOCAL(source) CMDSCOPE(’ ’) CMDSCOPE(qmgr-name) | | TYPE(MOVE) TYPE(ADD) QSGDISP(PRIVATE) (1) QSGDISP(SHARED) (1) TOQLOCAL(target) ! | | Notes: | 1 | Valid only when the queue manager is a member of a queue-sharing group.
MOVE QLOCAL You can specify a queue manager name, other than the queue manager on which the command was entered, only if you are using a queue-sharing group environment and if the command server is enabled. | | | | QSGDISP Specifies the disposition of the source queue. | | | | | PRIVATE The queue is defined with QSGDISP(QMGR) or QSGDISP(COPY). This is the default value. | | | SHARED The queue is defined with QSGDISP(SHARED). This is valid only in a queue-sharing group environment.
MOVE QLOCAL | | | | | | | | 4. The priority, context, and persistence of each message are not changed. 5. The command performs no data conversion and calls no exits. 6. Confirm-on-delivery (COD) report messages are not generated but confirm-on-arrival (COA) report messages are. This means that more than one COA report message can be generated for a message. 7. The MOVE QLOCAL command transfers the messages in batches. At COMMIT time, if the trigger conditions are met, trigger messages are produced.
PING CHANNEL PING 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 PING CHANNEL to test a channel by sending data as a special message to the remote queue manager, and checking that the data is returned. The data is generated by the local queue manager. Notes: 1. On OS/390: a. This is valid only for channels used for distributed queuing without CICS.
PING CHANNEL Parameter descriptions (channel-name) The name of the channel to be tested. This is required. | | | CMDSCOPE This parameter applies to OS/390 only and specifies how the command is executed when the queue manager is a member of a queue-sharing group. | | If CHLDISP is set to SHARED, CMDSCOPE must be blank or the local queue manager. | | ‘’ | | | | qmgr-name The command is executed on the queue manager you specify, providing the queue manager is active within the queue-sharing group.
PING CHANNEL | | | v On another specific named queue manager in the group. v On the most suitable queue manager in the group, determined automatically by the queue manager itself. | | The various combinations of CHLDISP and CMDSCOPE are summarized in Table 6 | Table 6.
PING QMGR | | PING QMGR || | | Compaq (DIGITAL) OpenVMS | | U OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U U U U U | Use PING QMGR to test whether the queue manager is responsive to commands. | | | | Note: If commands are issued to the queue manager by sending messages to the command server queue, this command causes a special message to be sent to it, consisting of a command header only, and checking that a positive reply is returned.
RECOVER BSDS | | || | | RECOVER BSDS Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U | | | | Use RECOVER BSDS to reestablish a dual bootstrap data set (BSDS) after one has been disabled by a data set error. | | | Note: Command processing consists of allocating a data set with the same name as the one that encountered the error and copying onto the new data set the contents of the BSDS that does not have an error.
REFRESH CLUSTER REFRESH CLUSTER Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp U U U Compaq NSK UNIX systems Windows NT U U Use REFRESH CLUSTER to discard all locally held cluster information (including any autodefined channels that are in doubt), and force it to be rebuilt. This enables you to perform a “cold-start” on the cluster. Notes: 1. On UNIX systems, the command is valid only on AIX, HP-UX, and Sun Solaris. 2.
REFRESH SECURITY REFRESH SECURITY Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U Use REFRESH SECURITY to cause a security refresh to be carried out. Synonym: REF SEC REBUILD SECURITY is another synonym for REFRESH SECURITY. REFRESH SECURITY REFRESH SECURITY ( * MQADMIN MQNLIST MQPROC MQQUEUE ) CMDSCOPE(’ ’) CMDSCOPE(qmgr-name) (1) CMDSCOPE(*) (1) ! Notes: 1 Valid only when the queue manager is a member of a queue-sharing group.
REFRESH SECURITY | | | CMDSCOPE This parameter specifies how the command is executed when the queue manager is a member of a queue-sharing group. | | CMDSCOPE cannot be used for commands issued from the first initialization input data set CSQINP1. | | ‘’ | | | | qmgr-name The command is executed on the queue manager you specify, providing the queue manager is active within the queue-sharing group.
RESET CHANNEL RESET 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 RESET CHANNEL to reset the message sequence number for an MQSeries channel with, optionally, a specified sequence number to be used the next time that the channel is started. Notes: 1. On OS/390: a. This is valid only for channels used for distributed queuing without CICS. If you are using CICS for distributed queuing, see the MQSeries Intercommunication manual. b.
RESET CHANNEL Parameter descriptions (channel-name) The name of the channel to be reset. This is required. | | | CMDSCOPE This parameter applies to OS/390 only and specifies how the command is executed when the queue manager is a member of a queue-sharing group. | | If CHLDISP is set to SHARED, CMDSCOPE must be blank or the local queue manager. | | ‘’ | | | | qmgr-name The command is executed on the queue manager you specify, providing the queue manager is active within the queue-sharing group.
RESET CHANNEL | Table 7. CHLDISP and CMDSCOPE for RESET CHANNEL | | CHLDISP CMDSCOPE( ) or CMDSCOPE (local-qmgr) CMDSCOPE (qmgr-name) | | PRIVATE Reset private channel on the local queue manager Reset private channel on the named queue manager | | SHARED Reset a shared channel on all Not permitted active queue managers. | | | | | | | | | | | This might automatically generate a command using CMDSCOPE and send it to the appropriate queue managers.
RESET CLUSTER | | || | | | | RESET CLUSTER Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp U U U Compaq NSK UNIX systems Windows NT U U | Use RESET CLUSTER to perform special operations on clusters. | | | Notes: 1. On UNIX systems, the command is valid only on AIX, HP-UX, and Sun Solaris. 2. On OS/390, the command fails if the channel initiator has not been started.
RESET CLUSTER You can specify a queue manager name, other than the queue manager on which the command was entered, only if you are using a queue-sharing group environment and if the command server is enabled. | | | | QMNAME(qmname) The name of the queue manager to be forcibly removed.
RESET QSTATS | || | | | | RESET QSTATS Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U | | Use RESET QSTATS to report performance data for a queue and then to reset that data. | Synonym: None | RESET QSTATS(generic q-name) CMDSCOPE(’ ’) CMDSCOPE(qmgr-name) (1) CMDSCOPE(*) ! (1) | | Notes: | 1 | | | | Valid only when the queue manager is a member of a queue-sharing group.
RESET QSTATS | | | MSGSOUT The number of messages removed from the queue by destructive (non-browse) MQGET calls since the statistics were last reset. | | | The count includes messages removed from the queue in units of work that have not yet been committed, but the count is not decremented if the units of work are subsequently backed out. CMDSCOPE This parameter specifies how the command is executed when the queue manager is a member of a queue-sharing group.
RESET TPIPE | RESET TPIPE Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U Use RESET TPIPE to reset the recoverable sequence numbers for an IMS Tpipe used by the MQSeries-IMS bridge. Notes: 1. This command is used in response to the resynchronization error reported in message CSQ2020E, and initiates resynchronization of the Tpipe with IMS. 2. The command fails if the queue manager is not connected to the specified XCF member. 3.
RESET TPIPE qmgr-name The command is executed on the queue manager you specify, providing the queue manager is active within the queue-sharing group. | | | | You can specify a queue manager name, other than the queue manager on which the command was entered, only if you are using a queue-sharing group environment and if the command server is enabled. | | | | XCFMNAME(mname) The name of the XCF member within the group specified by XCFGNAME to which the Tpipe belongs.
RESOLVE CHANNEL RESOLVE 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 RESOLVE CHANNEL to request a channel to commit or back out in-doubt messages. | Notes: 1. On OS/390: a. This is valid only for channels used for distributed queuing without CICS. If you are using CICS for distributed queuing, see the MQSeries Intercommunication manual. b. The command server and the channel initiator must be running. 2.
RESOLVE CHANNEL COMMIT The messages are committed, that is, they are deleted from the transmission queue BACKOUT The messages are backed out, that is, they are restored to the transmission queue CMDSCOPE This parameter applies to OS/390 only and specifies how the command is executed when the queue manager is a member of a queue-sharing group. | | | | | If CHLDISP is set to SHARED, CMDSCOPE must be blank or the local queue manager.
RESOLVE CHANNEL | Table 8. CHLDISP and CMDSCOPE for RESOLVE CHANNEL | | CHLDISP CMDSCOPE( ) or CMDSCOPE (local-qmgr) CMDSCOPE (qmgr-name) | | PRIVATE Resolve private channel on the local queue manager Resolve private channel on the named queue manager | | SHARED Resolve a shared channel on all active queue managers. Not permitted | | | | | | | | | | | This might automatically generate a command using CMDSCOPE and send it to the appropriate queue manager.
RESOLVE INDOUBT | | || | | RESOLVE INDOUBT Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U | | | | Use RESOLVE INDOUBT to resolve threads left in doubt because MQSeries or a transaction manager could not resolve them automatically. | | Note: This command does not apply to units of recovery associated with batch or TSO applications, unless you are using the RRS adapter.
RESOLVE INDOUBT qmgr-name The command is executed on the queue manager you specify, providing the queue manager is active within the queue-sharing group. | | | | You can specify a queue manager name, other than the queue manager on which the command was entered, only if you are using a queue-sharing group environment and if the command server is enabled. | | | | | NID Network identifier. Specifies the thread or threads to be resolved.
RESUME QMGR RESUME QMGR Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp U U U Compaq NSK UNIX systems Windows NT U U Use RESUME QMGR to inform other queue mangers in a cluster that the local queue manager is available again for processing and can be sent messages. It reverses the action of the SUSPEND QMGR command. Notes: 1. On UNIX systems, the command is valid only on AIX, HP-UX, and Sun Solaris. 2. On OS/390, the command fails if the channel initiator has not been started.
RVERIFY SECURITY RVERIFY SECURITY Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U Use RVERIFY SECURITY to set a reverification flag for all specified users. The user is reverified the next time that security is checked for that user. Synonym: REV SEC Note: REVERIFY SECURITY is another synonym for RVERIFY SECURITY.
SET LOG | | || | | SET LOG Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U | | | Use SET LOG to modify certain log system parameter values. | Synonym: SET LOG | | SET LOG MAXRTU(integer) DEFAULT | | CMDSCOPE(’ ’) CMDSCOPE(qmgr-name) DEALLCT(minutes) DEALLCT(1440) DEALLCT(NOLIMIT) (1) ! | | Notes: | 1 Valid only when the queue manager is a member of a queue-sharing group.
SET LOG | | | 2. If the number specified is greater than the current specification, the maximum number of tape units allowable for reading archive logs increases. | | | | | 3. If the number specified is less than the current specification, tape units that are not being used are immediately deallocated to adjust to the new value. Active, or premounted, tape units remain allocated. 4. A tape unit is a candidate for deallocation because of a lowered value only if there is no activity for the unit.
START CHANNEL START 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 START CHANNEL to start a channel. Notes: 1. On OS/390: a. This is valid only for channels used for distributed queuing without CICS. If you are using CICS for distributed queuing, see the MQSeries Intercommunication manual. b. The command server and the channel initiator must be running. 2.
START CHANNEL Parameter descriptions (channel-name) The name of the channel definition to be started. This is required. The name must be that of an existing channel defined on this queue manager. | | | CMDSCOPE This parameter applies to OS/390 only and specifies how the command is executed when the queue manager is a member of a queue-sharing group. | | If CHLDISP is set to SHARED, CMDSCOPE must be blank or the local queue manager.
START CHANNEL | | | | v On another specific named queue manager in the group. v On every active queue manager in the group. v On the most suitable queue manager in the group, determined automatically by the queue manager itself. | | The various combinations of CHLDISP and CMDSCOPE are summarized in Table 9 | Table 9.
START CHANNEL | Table 9. CHLDISP and CMDSCOPE for START CHANNEL (continued) | | CHLDISP CMDSCOPE( ) or CMDSCOPE (local-qmgr) CMDSCOPE (qmgr-name) | | | | | FIXSHARED For a shared SDR, RQSTR, and SVR channel, with a nonblank CONNAME, start as a shared channel on the local queue manager. For a shared SDR, RQSTR, Not permitted and SVR with a nonblank CONNAME, start as a shared channel on the named queue manager. For all other types, this option is not permitted.
START CHINIT START CHINIT Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp U U U U Compaq NSK UNIX systems Windows NT U U Use START CHINIT to start a channel initiator. Note: On OS/390: 1. This is valid only for channels used for distributed queuing without CICS. If you are using CICS for distributed queuing, see the MQSeries Intercommunication manual. 2. The command server must be running.
START CHINIT | | | | | | | | | | qmgr-name The command is executed on the queue manager you specify, providing the queue manager is active within the queue-sharing group. You can specify a queue manager name, other than the queue manager on which the command was entered, only if you are using a queue-sharing group environment and if the command server is enabled.
START CMDSERV START CMDSERV Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U Use START CMDSERV to initialize the command server. Synonym: STA CS START CMDSERV START CMDSERV ! Usage notes | | | | 1. START CMDSERV starts the command server and allows it to process commands in the system-command input queue (SYSTEM.COMMAND.INPUT), mover commands, and commands using CMDSCOPE. | | | | 2.
START LISTENER START LISTENER Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp U U U Compaq NSK UNIX systems Windows NT U U Use START LISTENER to start a channel listener. | | | | | | | | | Notes: 1. On UNIX systems, the command is valid only for AIX, HP-UX, and Sun Solaris. 2. On OS/390: a. This is valid only for channels used for distributed queuing without CICS. If you are using CICS for distributed queuing, see the MQSeries Intercommunication manual. b.
START LISTENER PORT(1414) LUNAME(string TRPTYPE(TCP) TRPTYPE(LU62) (1) (2) (1) IPADDR(ip-address INDISP(GROUP) (1) (3) (3) PORT(port-number) INDISP(QMGR) (1) ) (1) (1) (3) (1) (4) ! ) Notes: 1 Valid only on OS/390. 2 Valid only for TRPTYPE(LU62). 3 Valid only for TRPTYPE(TCP). 4 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.
START LISTENER LUNAME(string) The symbolic destination name for the logical unit as specified in the APPC side information data set. (This LU must be the same LU that is specified in the channel initiator parameters to be used for outbound transmissions.) This parameter is valid only for channels with a transmission protocol (TRPTYPE) of LU 6.2. A START LISTENER command which specifies TRPTYPE(LU62) must also specify the LUNAME parameter. This parameter is supported only on OS/390.
START QMGR START QMGR Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U Use START QMGR to initialize the queue manager. When the operation has been completed, the queue manager is active and available to CICS, IMS, batch, and TSO applications. Synonym: STA QMGR START QMGR PARM(CSQZPARM) START QMGR ENVPARM(jcl-substitution) (1) PARM(member-name) Notes: 1 MSTR is accepted as a synonym for ENVPARM Parameter descriptions These are optional.
START TRACE START TRACE Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U Use START TRACE to start traces. When you issue this command, a trace number is returned in message number CSQW130I. You can use this trace number (TNO) in ALTER TRACE, DISPLAY TRACE, and STOP TRACE commands.
START TRACE Parameter descriptions If you do not specify a trace type to be started, the default (GLOBAL) trace is started. The types are: ACCTG Collects accounting data that can be used to charge your customers for their use of your queue manager. The synonym is A. Note: Accounting data can be lost if the accounting trace is started or stopped while applications are running.
START TRACE functioning before the START TRACE command is issued. The SMF record numbers reserved for use by MQSeries are 115 and 116. A serviceability routine reserved for IBM use only; not for general use. SRV Note: If your IBM support center need you to use this destination for your trace data they will supply you with module CSQWVSER. If you try to use destination SRV without CSQWVSER an error message will be produced at the OS/390 console when you issue the START TRACE command.
START TRACE Table 12.
START TRACE Table 13. Resource Manager identifiers that are allowed (continued) RMID Resource manager 26 Instrumentation accounting and statistics 148 Connection manager 197 CF manager 199 Functional recovery 200 Security management 201 Data management 211 Lock management 212 Message management 213 Command server 215 Buffer management 231 Channel Initiator 242 MQSeries-IMS bridge 245 DB2® manager TDATA Reserved for IBM service.
STOP CHANNEL STOP 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 STOP CHANNEL to stop a channel. Notes: 1. On OS/390: a. This is valid only for channels used for distributed queuing without CICS. If you are using CICS for distributed queuing, see the MQSeries Intercommunication manual. b. The command server and the channel initiator must be running. 2.
STOP CHANNEL | | | CMDSCOPE This parameter applies to OS/390 only and specifies how the command is executed when the queue manager is a member of a queue-sharing group. | | If CHLDISP is set to SHARED, CMDSCOPE must be blank or the local queue manager. | | ‘’ | | | | qmgr-name The command is executed on the queue manager you specify, providing the queue manager is active within the queue-sharing group.
STOP CHANNEL | Table 14. CHLDISP and CMDSCOPE for STOP CHANNEL | | CHLDISP CMDSCOPE( ) or CMDSCOPE (local-qmgr) CMDSCOPE (qmgr-name) CMDSCOPE(*) | | PRIVATE Stop as a private channel on the local queue manager. Stop as a private channel on the named queue manager Stop as a private channel on all active queue managers | | | | | SHARED For RCVR, SVRCONN, and SVR with a blank CONNAME, stop as shared channel on all active queue managers.
STOP CHANNEL | | | processing. (The batch is then ended and no more messages are sent, even if there are messages waiting on the transmission queue.) | | | | For a receiving channel, if there is no batch in progress, the channel waits for either: v The next batch to start v The next heartbeat (if heartbeats are being used) | before it stops. | | For server-connection channels, allows the current connection to end. | This is the default.
STOP CHINIT | | || | | STOP CHINIT Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U | | | Use STOP CHINIT to stop a channel initiator. | | | | Notes: 1. This is valid only for channels used for distributed queuing without CICS. If you are using CICS for distributed queuing, see the MQSeries Intercommunication manual. 2. The command server must be running.
STOP CHINIT | | | | | | | | SHARED Specifies whether the channel initiator should attempt to restart any active shared sending channels that it owns on another queue manager. The possible values are: RESTART Shared sending channels are to be restarted. This is the default. STOP Shared sending channels are not to be restarted. Usage notes 1.
STOP CMDSERV STOP CMDSERV Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U Use STOP CMDSERV to stop the command server. Synonym: STOP CS STOP CMDSERV STOP CMDSERV ! Usage notes 1. STOP CMDSERV stops the command server from processing commands in the system-command input queue (SYSTEM.COMMAND.INPUT), mover commands, and commands using CMDSCOPE. 2.
STOP LISTENER STOP LISTENER Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U Use STOP LISTENER to stop a channel listener. | | | | | | | Notes: 1. This is valid only for channels used for distributed queuing without CICS. If you are using CICS for distributed queuing, see the MQSeries Intercommunication manual. 2. The command server and the channel initiator must be running. 3.
STOP LISTENER qmgr-name The command is executed on the queue manager you specify, providing the queue manager is active within the queue-sharing group. | | | | You can specify a queue manager name, other than the queue manager on which the command was entered, only if you are using a queue-sharing group environment and if the command server is enabled. | | | | | | | | | | | | | | INDISP Specifies the disposition of the inbound transmissions that the listener handles.
STOP QMGR STOP QMGR Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U Use STOP QMGR to stop the queue manager. Synonym: There is no synonym for this command. STOP QMGR STOP QMGR MODE(QUIESCE) MODE(FORCE) MODE(RESTART) CMDSCOPE(’ ’) CMDSCOPE(qmgr-name) (1) CMDSCOPE(*) ! (1) Notes: 1 Valid only when the queue manager is a member of a queue-sharing group. Parameter descriptions The parameters are optional.
STOP QMGR operator can determine whether any connections remain by using the DISPLAY THREAD command, and can cancel remaining connections using OS/390 commands. This option deregisters MQSeries from the MVS automatic restart manager (ARM). FORCE Terminates programs currently being executed, including utilities. No new program is allowed to start. This option might cause in-doubt situations. This option might not work if all the active logs are full, and log archiving has not occurred.
STOP TRACE STOP TRACE Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp Compaq NSK UNIX systems Windows NT U Use STOP TRACE to stop tracing. Synonym: There is no synonym for this command.
STOP TRACE You must specify a trace type or an asterisk. STOP TRACE(*) stops all active traces. The trace types are: ACCTG Accounting data (the synonym is A) Note: Accounting data can be lost if the accounting trace is started or stopped while applications are running. For information about the conditions that must be satisfied for successful collection of accounting data, see the MQSeries for OS/390 System Setup Guide.
STOP TRACE See “START TRACE” on page 265 for a list of allowed destinations for each trace type. Constraint block CLASS(integer) Limits the action of the STOP TRACE to traces started for particular classes. See the START TRACE command for a list of allowed classes. A range of classes can be specified as m:n (for example, CLASS(01:03)). You cannot specify a class if you did not specify a trace type. The default is CLASS(*), which does not limit the command.
SUSPEND QMGR SUSPEND QMGR Compaq (DIGITAL) OpenVMS OS/390 OS/400 OS/2 Warp U U U Compaq NSK UNIX systems Windows NT U U Use SUSPEND QMGR to inform other queue mangers in a cluster that the local queue manager is not available for processing and cannot be sent messages. Its action can be reversed by the RESUME QMGR command. Notes: 1. On UNIX systems, the command is valid only on AIX, HP-UX, and Sun Solaris. 2. On OS/390, the command fails if the channel initiator has not been started.
SUSPEND QMGR You can specify a queue manager name, other than the queue manager on which the command was entered, only if you are using a queue-sharing group environment and if the command server is enabled. | | | | | MODE Specifies how the suspension of availability is to take effect: QUIESCE Other queue managers in the cluster are advised that the local queue manager should not be sent further messages. FORCE All inbound channels to other queue managers in the cluster are stopped forcibly.
286 MQSeries MQSC Command Reference
Appendix. Notices This information was developed for products and services offered in the United States. IBM may not offer the products, services, or features discussed in this information in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used.
Notices Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM United Kingdom Laboratories, Mail Point 151, Hursley Park, Winchester, Hampshire, England SO21 2JN.
Notices Trademarks The following terms are trademarks of International Business Machines Corporation in the United States, or other countries, or both: AIX DB2 OS/2 RACF AS/400 IBM OS/390 VTAM CICS MQSeries OS/400 Lotus Notes is a trademark of Lotus Development Corporation in the United States, or other countries, or both. Microsoft®, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States and/or other countries.
290 MQSeries MQSC Command Reference
Glossary of terms and abbreviations This glossary defines MQSeries terms and abbreviations used in this book. If you do not find the term you are looking for, see the Index or the IBM Dictionary of Computing, New York: McGraw-Hill, 1994. This glossary includes terms and definitions from the American National Dictionary for Information Systems, ANSI X3.172-1990, copyright 1990 by the American National Standards Institute (ANSI).
Glossary work. After the operation is complete, a new unit of recovery or unit of work begins. Contrast with commit. basic mapping support (BMS). An interface between CICS and application programs that formats input and output display data and routes multiple-page output messages without regard for control characters used by various terminals. BMS. Basic mapping support. bootstrap data set (BSDS).
Glossary command server. The MQSeries component that reads commands from the system-command input queue, verifies them, and passes valid commands to the command processor. commit. An operation that applies all the changes made during the current unit of recovery or unit of work. After the operation is complete, a new unit of recovery or unit of work begins. Contrast with backout. completion code. A return code indicating how an MQI call has ended. configuration file.
Glossary First Failure Support Technology (FFST). Used by MQSeries on UNIX systems, MQSeries for OS/2 Warp, MQSeries for Windows NT, and MQSeries for AS/400 to detect and report software problems. dump analysis and elimination (DAE). An OS/390 service that enables an installation to suppress SVC dumps and ABEND SYSUDUMP dumps that are not needed because they duplicate previously written dumps. first-in-first-out (FIFO).
Glossary H handle. See connection handle and object handle. hardened message. A message that is written to auxiliary (disk) storage so that the message will not be lost in the event of a system failure. See also persistent message. I ILE. Integrated Language Environment®. immediate shutdown. In MQSeries, a shutdown of a queue manager that does not wait for applications to disconnect. Current MQI calls are allowed to complete, but new MQI calls fail after an immediate shutdown has been requested.
Glossary | | | | locally-defined object. On OS/390, an object whose definition is stored on page set zero. The definition can be accessed only by the queue manager that defined it. Also known as a privately-defined object. log. In MQSeries, a file recording the work done by queue managers while they receive, transmit, and deliver messages, to enable them to recover in the event of failure. log control file.
Glossary N OPM. Original Program Model. namelist. An MQSeries object that contains a list of names, for example, queue names. Original Program Model (OPM). The AS/400 Original Program Model. This is no longer supported on MQSeries. It is replaced by the Integrated Language Environment (ILE). name service. In MQSeries on UNIX systems, MQSeries for OS/2 Warp, and MQSeries for Windows NT, the facility that determines which queue manager owns a specified queue. name service interface (NSI).
Glossary can access messages on the queues that the queue manager owns. See also local queue manager and remote queue manager. An MQSeries object that defines the attributes of a particular queue manager. point of recovery. In MQSeries for OS/390, the term used to describe a set of backup copies of MQSeries for OS/390 page sets and the corresponding log data sets required to recover these page sets.
Glossary Registry Editor. In Windows NT, the program item that allows the user to edit the Registry. for OS/390, examples of resources are buffer pools, page sets, log data sets, queues, and messages. Registry Hive. In Windows NT, the structure of the data stored in the Registry. resource manager. An application, program, or transaction that manages and controls access to shared resources such as memory buffers and data sets. MQSeries, CICS, and IMS are resource managers. relative byte address (RBA).
Glossary number ensures that the receiving channel can reestablish the message sequence when storing the messages. server. (1) In MQSeries, a queue manager that provides queue services to client applications running on a remote workstation. (2) The program that responds to requests for information in the particular two-program, information-flow model of client/server. See also client. server channel.
Glossary sending program waits for a reply to its message before resuming its own processing. Contrast with asynchronous messaging. termination notification. A pending event that is activated when a CICS subsystem successfully connects to MQSeries for OS/390. syncpoint. An intermediate or end point during processing of a transaction at which the transaction’s protected resources are consistent.
Glossary undo/redo record. A log record used in recovery. The redo part of the record describes a change to be made to an MQSeries object. The undo part describes how to back out the change if the work is not committed. unit of recovery. A recoverable sequence of operations within a single resource manager. Contrast with unit of work. unit of work. A recoverable sequence of operations performed by an application between two points of consistency.
Bibliography This section describes the documentation available for all current MQSeries products. MQSeries cross-platform publications Most of these publications, which are sometimes referred to as the MQSeries “family” books, apply to all MQSeries Level 2 products. The latest MQSeries Level 2 products are: v MQSeries for AIX, V5.1 v MQSeries for AS/400, V5.1 v MQSeries for AT&T GIS UNIX, V2.2 v MQSeries for Compaq (DIGITAL) OpenVMS, V2.2.1.1 v MQSeries for Compaq Tru64 UNIX, V5.
Bibliography | | | | | | MQSeries for OS/390, V5.2 MQSeries for OS/390 Concepts and Planning Guide, GC34-5650 MQSeries for OS/390 System Setup Guide, SC34-5651 MQSeries for OS/390 System Administration Guide, SC34-5652 MQSeries for OS/390 Problem Determination Guide, GC34-5892 MQSeries for OS/390 Messages and Codes, GC34-5891 MQSeries for OS/390 Licensed Program Specifications, GC34-5893 MQSeries for OS/390 Program Directory MQSeries link for R/3, Version 1.
Bibliography PDF versions of all current MQSeries books are also available from the MQSeries product family Web site at: http://www.ibm.com/software/mqseries/ BookManager® format The MQSeries library is supplied in IBM BookManager format on a variety of online library collection kits, including the Transaction Processing and Data collection kit, SK2T-0730.
MQSeries on the Internet 306 MQSeries MQSC Command Reference
Index A ACTION parameter RESET CLUSTER 239 RESET TPIPE 244 RESOLVE CHANNEL 245 RESOLVE INDOUBT 248 active thread, display 218 active trace, display list of 220 ADD parameter, MOVE QLOCAL 226 administrator commands 285 alias queue alter parameters 39 define 106 delete definition 143 display attributes 200 ALL parameter DISPLAY CHANNEL 152 DISPLAY CHSTATUS 162 DISPLAY CLUSQMGR 169 DISPLAY NAMELIST 182 DISPLAY PROCESS 185 DISPLAY QMGR 189 DISPLAY QSTATUS 195 DISPLAY QUEUE 203 DISPLAY SECURITY 214 DISPLAY STGCL
CLUSDATE parameter (continued) DISPLAY QUEUE 208 CLUSINFO parameter, DISPLAY QUEUE 203 CLUSNL parameter DEFINE CHANNEL 77 DEFINE queues 115 DISPLAY CHANNEL 155 DISPLAY QUEUE 204, 208 RESUME QMGR 250 SUSPEND QMGR 284 CLUSQMGR parameter, DISPLAY QUEUE 208 CLUSQT parameter, DISPLAY QUEUE 208 cluster refresh 233 reset 239 CLUSTER parameter DEFINE CHANNEL 77 DEFINE queues 116 DISPLAY CHANNEL 154 DISPLAY CLUSQMGR 170 DISPLAY QUEUE 203, 209 RESUME QMGR 250 SUSPEND QMGR 284 cluster queue manager, display 168 cluste
DESCR parameter (continued) DISPLAY CHANNEL 155 DISPLAY CLUSQMGR 172 DISPLAY NAMELIST 183 DISPLAY PROCESS 186 DISPLAY QMGR 191 DISPLAY QUEUE 210 DISPLAY STGCLASS 217 DEST parameter DISPLAY TRACE 222 START TRACE 266 STOP TRACE 282 DETAIL parameter, DISPLAY TRACE 221 DISCINT parameter DEFINE CHANNEL 81 DISPLAY CHANNEL 155 DISPLAY CLUSQMGR 172 DISPLAY CHANNEL command 150 DISPLAY CHSTATUS command 157 DISPLAY CLUSQMGR command 168 DISPLAY CMDSERV command 174 DISPLAY DQM command 175 DISPLAY GROUP command 177 DISPL
MAXPRTY parameter, DISPLAY QMGR 191 MAXRTU parameter, SET LOG 252 maxsmsgs define 93 display 180 MAXUMSGS parameter, ALTER QMGR 37 MCANAME parameter DEFINE CHANNEL 83 DISPLAY CHANNEL 155 DISPLAY CLUSQMGR 172 MCASTAT parameter, DISPLAY CHSTATUS 166 MCATYPE parameter DEFINE CHANNEL 83 DISPLAY CHANNEL 155 DISPLAY CLUSQMGR 172 MCAUSER parameter DEFINE CHANNEL 83 DISPLAY CHANNEL 155 DISPLAY CLUSQMGR 172 MODE parameter ARCHIVE LOG 52 STOP CHANNEL 272 STOP QMGR 279 SUSPEND QMGR 285 model queue alter parameters 43
QMID parameter (continued) DISPLAY QUEUE 211 QMNAME parameter DEFINE CHANNEL 87 DISPLAY CHANNEL 155 DISPLAY QMGR 192 DISPLAY THREAD 219 RESET CLUSTER 240 RESOLVE INDOUBT 249 QMTYPE parameter, DISPLAY CLUSQMGR 171 QSGDISP parameter CLEAR QLOCAL 55 DEFINE CHANNEL 87 DEFINE NAMELIST 97 DEFINE PROCESS 102 DEFINE queues 124 DEFINE STGCLASS 134 DELETE CHANNEL 137 DELETE NAMELIST 139 DELETE PROCESS 141 DELETE QLOCAL 147 DELETE STGCLASS 149 DISPLAY CHANNEL 153 DISPLAY NAMELIST 182 DISPLAY PROCESS 185 DISPLAY QSTATU
storage class (continued) delete 148 display 215 storage classes, rules for names of 6 STRSTPEV parameter ALTER QMGR 38 DISPLAY QMGR 192 SupportPac 305 SUSPEND parameter, DISPLAY CLUSQMGR 172 SUSPEND QMGR command 284 SWITCHES parameter, DISPLAY SECURITY 214 SYNCPT parameter, DISPLAY QMGR 192 TYPE parameter (continued) DISPLAY QUEUE 206 DISPLAY THREAD 219 MOVE QLOCAL 226 U UNCOM parameter, DISPLAY QSTATUS 196 unit-of-work ID, display 218 URID parameter, DISPLAY QSTATUS 199 usage, page set display 223 T U
Sending your comments to IBM If you especially like or dislike anything about this book, please use one of the methods listed below to send your comments to IBM. Feel free to comment on what you regard as specific errors or omissions, and on the accuracy, organization, subject matter, or completeness of this book. Please limit your comments to the information in this book and the way in which the information is presented.
314 MQSeries MQSC Command Reference
Printed in the United States of America on recycled paper containing 10% recovered post-consumer fiber.
Spine information: MQSeries® MQSeries MQSC Command Reference
