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
Parent topic: CL commands reference for IBM i