Start of change

EXEC CICS DELETE CHANNEL command (EXCI)

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

Read syntax diagramSkip visual syntax diagram
DELETE CHANNEL (EXCI)

>>-DELETE 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.
Start of changeRETCODE(data-area)End of change
Start of change 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.
End of change

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.
Start of change904End of change
Start of changeXCEIP ESTAE invoked.End of change


exci-deletechannel.html | Timestamp icon Last updated: Monday, 5 June 2017
End of change