EXEC CICS DELETE CHANNEL command (EXCI)
Delete a named channel and all the containers that are in it.
Description
DELETE CHANNEL (EXCI)
deletes the specified channel and all the containers
that are in it. When you delete a channel and its containers:
- Any data that is in the containers is discarded.
- All storage that relates to the channel and to its containers is released.
The application program that issues the
DELETE CHANNEL
command must
be the program that owns the channel. The program that owns the
channel is the program that created
the channel by naming it on one of the following commands:
- LINK PROGRAM CHANNEL
- MOVE CONTAINER CHANNEL TOCHANNEL
- PUT CONTAINER CHANNEL
An application program cannot delete the following channels:
- Any channel that the application program did not create
- Any channel that is read-only
- The transaction channel DFHTRANSACTION
Options
- CHANNEL(data-value)
- Specifies the 1–16 character name of the channel that is to be deleted. Every container that is owned by the channel is deleted, and the channel itself is deleted.
- 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 DELETE 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.
- 3
- The channel specified on the CHANNEL option is a read-only channel.
- 5
- The channel specified on the CHANNEL option is the transaction channel.
- 6
- The channel specified on the CHANNEL option is not owned by the calling program.
- 904
- XCEIP ESTAE invoked.