EXEC CICS QUERY CHANNEL command (EXCI)
Count the number of containers that are in a channel.
Description
QUERY CHANNEL (EXCI) counts the number of containers that are in a specified channel. You must specify the CHANNEL option and identify the channel explicitly. You can use the QUERY CHANNEL command with any channel, including the transaction channel (DFHTRANSACTION), and channels that EXCI created.
Options
- CHANNEL(data-value)
- Specifies the 1-16 character name of the channel.
- CONTAINERCNT(data-area)
- Returns, as a fullword binary value, a count of the number of containers that are in the specified channel.
- RETCODE(data-area)
-
Specifies a 20-byte area into which the external CICS
interface places return information. This area is formatted into
five 1–word fields. This command
will return information in the first two words. These words will
contain the RESP and RESP2 codes.
The other three words will be set to nulls.
- RESP
- The primary response code, which indicates whether the external CICS interface QUERY CHANNEL command caused an exception condition during its execution.
- RESP2
- The secondary response code that further qualifies, where necessary, some of the conditions that are raised in the RESP parameter.
Conditions
- 122 CHANNELERR
- RESP2 values:
- 2
- The channel specified on the CHANNEL option could not be found.