Transient data queue services
JCICS supports the CICS transient data commands, DELETEQ TD, READQ TD, and WRITEQ TD. All options are supported except the INTO option.
Interaction between JCICS methods and EXEC CICS commands
For information about tools that allow Java programs to access existing CICS application data, see Interacting with structured data from Java.
Table 1
lists the methods and JCICS classes
that map to CICS transient data commands.
| Methods | JCICS class | EXEC CICS Commands |
|---|---|---|
| delete() | TDQ | DELETEQ TD |
| readData(), readDataConditional() | TDQ | READQ TD |
| writeData() | TDQ | WRITEQ TD |
- DELETEQ TD
- You can delete a transient data queue (TDQ) using the delete() method in the TDQ class.
- READQ TD
- The CICS INTO option is not supported in Java programs. You can
read from a TDQ using the
readData()
or the
readDataConditional()
method
in the
TDQ
class. These methods take as a parameter
an instance of a
DataHolder
object that will contain
the data read in a byte array. The storage for this byte array is
created by CICS and is garbage-collected at the end of the
program.
The readDataConditional() method drives the CICS NOSUSPEND logic. If a QBUSY condition is detected, it is returned to the application immediately as a QueueBusyException.
The readData() method suspends if it attempts to access a record in use by another task and there are no more committed records.
- WRITEQ TD
- You must provide data to be written to a TDQ in a Java byte array.