Container commands

The CICS® business transaction services commands that act 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 already exist, it is created. If the named container already 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 actually 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.

Related concepts
Process- and activity-related commands
Event-related commands
Browsing and inquiry commands
System events
Using the BTS API to write business applications
The Sale example application
Related reference
BTS application programming commands
[[ Contents Previous Page | Next Page Index ]]