DELETE CONTAINER (CHANNEL)

Description

DELETE CONTAINER (CHANNEL) 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.

The channel that owns the container can be identified explicitly, by specifying the CHANNEL option, or implicitly, by omitting the CHANNEL option. When this option is omitted, the current channel is implied. If there is no current channel, the command is assumed to be an EXEC CICS® DELETE CONTAINER (BTS) command. For more information, see DELETE CONTAINER (BTS).

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.

Conditions

122 CHANNELERR

RESP2 values:

2

The channel specified on the CHANNEL option could not be found.

3

Either the current channel or the channel specified on the CHANNEL option is read-only.

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.