Container commands

You can use CICS® business transaction services commands to perform actions on data-containers. For example, PUT CONTAINER (BTS) , GET CONTAINER (BTS) , MOVE CONTAINER (BTS) , and DELETE CONTAINER (BTS).

The CICS business transaction services commands that perform actions on data-containers are:
PUT CONTAINER (BTS)
Use this command to save data in a data-container associated with a specified BTS activity or process. If the named container does not exist, it is created. If the named container exists, its previous contents are overwritten.
GET CONTAINER (BTS)
Use this command to read data from a data-container associated with a specified BTS activity or process.
MOVE CONTAINER (BTS)
Use this command, instead of GET CONTAINER (BTS) and PUT CONTAINER (BTS), as a more efficient way of transferring data between activities. Using GET CONTAINER and PUT CONTAINER, you must:
  1. Issue a GET CONTAINER NODATA command to retrieve the length of the data in the source container.
  2. Allocate an area of working storage sufficient to hold the data.
  3. Issue a GET CONTAINER command to retrieve the data into working storage.
  4. Issue a PUT CONTAINER command to store the data in the target container.
Using MOVE CONTAINER, only one command is required and no working storage needs to be allocated. No data is moved; only CICS internal references are changed.

Use MOVE CONTAINER, rather than GET CONTAINER and PUT CONTAINER, if you have no need to keep the source container.

DELETE CONTAINER (BTS)
Use this command to delete a BTS data-container and discard any data that it contains.


dfhp90i.html | Timestamp icon Last updated: Monday, 5 June 2017