QTYPE keyword - SELECT and REJECT subcommands

QTYPE is an optional keyword for the SELect and REJect subcommands and limits processing to specific queues. You can specify a list of queue types with the QTYPE keyword. Consider the following when specifying the QTYPE keyword:

If you only specify client queue types for the QTYPE keyword on a SELect or REJect subcommand, the DEQueue, UNLoad, and DISplay commands will search only the indicated queues for matching messages. For the REQueue command, the MSGRSQTY field in the message prefix determines the queue type for filtering.
When a private queue keyword ( COLDQ or LOCKQ) is used with QTYPE by itself or in combination with client queue types, only messages which are currently on the private queue AND which were originally on one of the listed client queues will match. For example, QTYPE=(COLDQ,SERIAL) will display only serial transactions on the cold queue. You must use two SELect subcommands to select both the COLDQ and the SERIAL client queue.
If you specify the QTYPE keyword on a SELect or REJect subcommand with a DISplay, DEQueue, or UNLoad command for non-shared queues, the subcommand will match nothing and an error may result.
If you specify the QTYPE keyword on a SELect or REJect subcommand with a REQueue command, filtering will be based on the queue type in the message (if any). Because the queue type in the message can only be a client queue type, the COLDQ and LOCKQ parameters will not match. Also, messages that were created on a non-shared queues system will have a queue type of zero and will not match.
When specified on SELect or REJect subcommands with the REQueue command, QTYPE is used only to select messages. You can requeue messages to any queue, regardless of the QTYPE keyword.

The following table lists the QTYPE keyword parameters.

Parameter	Description
ALLDEST	processes all queues that are listed for the ALLTRAN and ALLTERM parameters Note Only client queues will match unless you explicitly select private queues.
ALLTERM	limits processing to queues 5, 7, 8, and 9 Note You can use CNT as an alias for ALLTERM. Only client queues will match unless you explicitly select private queues.
ALLTRAN	limits processing to queues 1, 3, and 4 Note You can use SMB as an alias for ALLTRAN. Only client queues will match unless you explicitly select private queues.
COLDQ	private queue Note Private queue types are not allowed on SELect and REJect subcommands with the REQueue command. When you specify a private queue type for the QTYPE keyword by itself or in combination with a client queue type, only messages which are currently on the private queue AND which were originally on one of the listed client queues will match. For example, QTYPE=(COLDQ,SERIAL) will only display serial transactions on the cold queue. You must use two SELECT subcommands to select both the COLDQ and the SERIAL client queue.
ControlQ	private queue Note Private queue types are not allowed on SELect and REJect subcommands with the REQueue command. The control queue does not contain IMS messages, but contains CQS control information. You can use the DISplay commands to display these control elements. However, you cannot use other keywords except for the DESTination keyword, which you can use to select the key. Note You can use CNTLQ as an alias for ControlQ.
LOCKQ	private queue Note Private queue types are not allowed on SELect and REJect subcommands with the REQueue command. When you specify a private queue type for the QTYPE keyword by itself or in combination with a client queue type, only messages which are currently on the private queue AND which were originally on one of the listed client queues will match. For example, QTYPE=(LOCKQ,SERIAL) will only display serial transactions on the lock queue. You must use two SELECT subcommands to select both the LOCKQ and the SERIAL client queue.
Q1	limits processing to queue 1 Note You can use 1, TRAN1, TRANRDY, and TRANSACT as aliases for Q1.
Q2	limits processing to queue 2 (a staging queue) Note The staging queue types are not allowed on the REQueue command. The staging queues contain continuation segments for IMS messages, but not the beginning of the message. You cannot use destination- or message-related selection keywords when selecting the staging queues. Note You can use 2 as an alias for Q2.
Q3	limits processing to queue 3 Note You can use 3, TSUSP3, and SUSPEND as aliases for Q3.
Q4	limits processing to queue 4 Note You can use 4, TSERL4, and SERIAL as aliases for Q4.
Q5	limits processing to queue 5 Note You can use 5, LTERM5, and LTRM5 as aliases for Q5.
Q6	limits processing to queue 6 (a staging queue) Note The staging queue types are not allowed on the REQueue command. The staging queues contain continuation segments for IMS messages, but not the beginning of the message. You cannot use destination- or message-related selection keywords when selecting the staging queues. Note You can use 6 as an alias for Q6.
Q7	limits processing to queue 7 Note You can use 7, APPC7, and TPNAME7 as aliases for Q7.
Q8	limits processing to queue 8 Note You can use 8, REMOTE8, and RMT8 as aliases for Q8.
Q9	limits processing to queue 9 Note You can use 9 and OTMA9 as aliases for Q9.
STAGEQ	limits processing to queues 2 and 6 Note The staging queue types are not allowed on the REQueue command. The staging queues contain continuation segments for IMS messages, but not the beginning of the message. You cannot use destination- or message-related selection keywords when selecting the staging queues.

The figure that follows illustrates the queues that are processed for each parameter.

QTYPE keyword - SELECT and REJECT subcommands

Comments