EXEC CICS DELETE CHANNEL command (EXCI)

Delete a named channel and all the containers that are in it.

DELETE CHANNEL (EXCI)

Read syntax diagramSkip visual syntax diagramDELETE CHANNEL( data-value)RETCODE( data-area)

Conditions: CHANNELERR

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.