Record objects

Record objects represent data exchanged between your application and CICS®, and these record objects are the basis of J2C record or data beans.
Record objects are used to represent data passing to and from the EIS. In the case of the ECI, this is a representation of a COMMAREA. After an connection has been obtained to the CICS server, an Interaction can be created from the Connection in order to make a particular request. As with the Connection, Interactions can have custom properties set by the CICS-specific InteractionSpec class (ECIInteractionSpec). To perform the Interaction, the application callsthe execute() method and uses CICS-specific Record objects to hold the data. For example:
Obtain a ConnectionFactory
Connection c = cf.getConnection(ConnectionSpec)
Interaction i = c.createInteraction()
InteractionSpec is = newInteractionSpec();
i.execute(spec, input, output)
Record objects store the input/output data that is used during an interaction with an EIS, for example a byte array representing an ECI COMMAREA. The following example shows a complete interaction with an EIS. In this example input and output Record objects and Spec objects are used to define the specific attributes of both the interaction and the connection. The example uses setters to define any component-specific properties on the Spec objects before they are used.
ConnectionFactory cf = [Lookup from JNDI namespace]
ECIConnectionSpec cs = new ECIConnectionSpec();
cs.setXXX(); //Set any connection specific properties
Connection conn = cf.getConnection( cs );
Interaction int = conn.createInteraction();
ECIInteractionSpec is = new ECIInteractionSpec();
is.setXXX(); //Set any interaction specific properties
RecordImpl in = new RecordImpl();
RecordImpl out = new RecordImpl();
int.execute( is, in, out );
int.close();
conn.close(); 
The ECI resource adapter allows a J2EE developer to access CICS programs, using COMMAREAs to pass information to and from the server. This table shows the JCA objects corresponding to the ECI terms The CCI interfaces for CICS are in the com.ibm.connector2.cics package.
ECI term J2C object: property
Abend code CICSTxnAbendException
COMMAREA Record
ECI timeout ECIInteractionSpec:ExecuteTimeout
LUW identifier J2EE transaction
Password ECIConnectionSpec:Password
Program name ECIInteractionSpec:FunctionName
Server name ECIConnectionFactory:ServerName
TPNName ECIInteractionSpec:TPNName
TranName ECIInteractionSpec:TranName
User ID  

Feedback