EXEC CICS DELETE CONTAINER command (EXCI)

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.

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 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.

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.

904

XCEIP ESTAE invoked.

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.