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 would appear 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 J2EE 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.