Start of change

EXEC CICS DELETE CONTAINER command (EXCI)

Delete a named channel container.

Read syntax diagramSkip visual syntax diagram
DELETE CONTAINER (EXCI)

>>-DELETE--CONTAINER(data-value)--CHANNEL(data-value)----------->

>--RETCODE(data-area)------------------------------------------><

Conditions: CHANNELERR, CONTAINERERR, INVREQ

Description

DELETE CONTAINER (EXCI) deletes a container from a channel and discards any data that it contains.

The container is identified by name and by the channel for which it is a container - the channel that “owns” it.

Options

CHANNEL(data-value)
Specifies the name (1–16 characters) of the channel that owns the container. You can specify the channel name DFHTRANSACTION to use the transaction channel.
CONTAINER(data-value)
Specifies the name (1–16 characters) of the container to be 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 CONTAINER 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 read-only.
Start of change904End of change
Start of changeXCEIP ESTAE invoked.End of change
110 CONTAINERERR
RESP2 values:
10
The container named on the CONTAINER option could not be found.
16 INVREQ
RESP2 values:
4
The command was issued outside the scope of a currently-active channel.
30
You cannot delete a CICS-defined read-only container.


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