Work with Queue Status (WRKMQMQSTS)
- Where allowed to run
- All environments (*ALL)
- Threadsafe
- Yes
The Work with Queue Status (WRKMQMQSTS) command lists the jobs which have an IBM MQ queue currently open. The command allows you to determine what options a queue was opened with and also allows you to check to see which channels and connections have a queue open.
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| MQMNAME | Message Queue Manager name | Character value, *DFT | Optional, Positional 1 |
| QNAME | Queue name | Character value | Optional, Positional 2 |
| WHERE | Filter command | Single values: *NONE Other values: Element list | Optional, Positional 3 |
| Element 1: Filter keyword | *APPLDESC, *APPLTAG, *BROWSE, *CHLNAME, *CONNAME, *INPUT, *INQUIRE, *JOB, *OUTPUT, *SET, *URTYPE | ||
| Element 2: Filter operator | *GT, *LT, *EQ, *NE, *GE, *LE, *LK, *NL, *CT, *EX, *CTG, *EXG | ||
| Element 3: Filter value | Character value |
Message Queue Manager name (MQMNAME)
Specifies the name of the message queue manager.
The possible values are:
- *DFT
- Use the default queue manager.
- queue-manager-name
- Specify the name of the queue manager.
Queue name (QNAME)
Specifies the name of the local queue.
The possible values are:
- queue-name
- Specify the name of the local queue.
Filter command (WHERE)
This parameter can be used to selectively display only the jobs with particular attributes that have the queue open.
The parameter takes three arguments, a keyword, an operator and a value.
Generic strings are allowed for values which are names.
The operator can take one of the following values:
- *GT
- Greater than.
Applicable to integer and non-generic string values.
- *LT
- Less than.
Applicable to integer and non-generic string values
- *EQ
- Equal to.
Applicable to integer and non-generic string values.
- *NE
- Not equal to.
Applicable to integer and non-generic string values.
- *GE
- Greater than or equal to.
Applicable to integer and non-generic string values.
- *LE
- Less than or equal to.
Applicable to integer and non-generic string values.
- *LK
- Like.
Applicable to generic string values.
- *NL
- Not like.
Applicable to generic string values.
- *CT
- Contains.
Applicable to non-generic list values.
- *EX
- Excludes.
Applicable to non-generic list values.
- *CTG
- Contains generic.
Applicable to generic list values.
- *EXG
- Excludes generic.
Applicable to generic list values.
The keyword can take one of the following values:
- *APPLDESC
- The description of the application which has the queue open.
The filter value is the application description string.
- *APPLTAG
- The tag of the application which has the queue open.
The filter value is the application tag string.
- *BROWSE
- Whether the job has the queue open for browsing.
The filter value is either *NO or *YES.
- *CHLNAME
- The name of the channel which has the queue open.
The filter value is the channel name.
- *CONNAME
- The connection name of the channel which has the queue open.
The filter value is the connection name.
- *INPUT
- Whether the job has the queue open for input.
The filter value is one of the following:
- *NO
- The job does not have the queue open for input.
- *SHARED
- The job has the queue open for shared input.
- *EXCL
- The job has the queue open for exclusive input.
- *INQUIRE
- Whether the job has the queue open for inquiry.
The filter value is either *NO or *YES.
- *JOB
- The name of the job which has the queue open.
The filter value is the job name.
- *OUTPUT
- Whether the job has the queue open for output.
The filter value is either *NO or *YES.
- *SET
- Whether the job has the queue open for set.
The filter value is either *NO or *YES.
- *URTYPE
- The type of unit of work recovery identifier.
The filter value is one of the following:
- *QMGR
- Queue manager unit of work recovery identifier.
- *XA
- XA unit of work recovery identifier.
Examples
None
Error messages
Unknown