Use the Interaction interface to start a transaction on
a CICS® server.
The EPI resource adapter provides an implementation of the Interaction
interface but you should not use this directly. Each Interaction.execute()
call must have an EPIInteractionSpec instance associated with it.
Use the EPIInteractionSpec class directly, to define the properties
of the interaction:
- Set the FunctionName property to the name of the CICS transaction.
- Set the InteractionVerb to one of the following:
- SYNC_SEND - A synchronous call. It does not unblock until the
EPI transaction has sent all the information that is on a screen.
- SYNC_RECEIVE - A synchronous receive. Used to retrieve the current
contents of the screen.
- SYNC_SEND_RECEIVE - A synchronous call.
The EPIInteractionSpec class also allows you to set the following
properties:
- The AID key to be sent to CICS. The default value is enter.
- The position of the cursor.
- The output attribute type. This allows you to control what will
be held in the attribute byte for the field on a returned screen.
It applies only to the streamable interface (see Sending and receiving data).
The EPIInteractionSpec class returns the following properties which
can be used by the JEE component:
- Cursor position
- Screen size
- Terminal ID
- Map name
- Mapset name
Closing an EPIInteraction does not affect the state of the connection;
the terminal remains connected.