[IBM i]

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

Table 1. Command 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.