Oggetti Record

Gli oggetti Record vengono utilizzati per rappresentare il passaggio dei dati da e verso l'EIS. Nel caso dell'ECI, questa è una rappresentazione di una COMMAREA. Una volta ottenuta una connessione al server CICS, è possibile creare un oggetto Interaction dall'oggetto Connection per effettuare una richiesta particolare. Come Connection, anche gli oggetti Interaction possono avere proprietà personalizzate impostate dalla classe InteractionSpec specifica per CICS (ECIInteractionSpec). Per eseguire l'oggetto Interaction, l'applicazione richiama il metodo execute() e utilizza oggetti Record specifici per CICS per contenere i dati. Ad esempio:

Obtain a ConnectionFactory
Connection c = cf.getConnection(ConnectionSpec)
Interaction i = c.createInteraction()
InteractionSpec is = newInteractionSpec();
i.execute(spec, input, output)

Gli oggetti Record archiviano i dati di input/output utilizzati durante un'interazione con un EIS, ad esempio una matrice di byte che rappresenta una COMMAREA ECI. Il seguente esempio illustra un'interazione completa con un EIS. In questo esempio vengono utilizzati oggetti Record di input e di output e oggetti Spec per definire gli attributi specifici sia dell'interazione che della connessione. Vengono utilizzati setter per definire tutte le proprietà specifiche dei componenti sugli oggetti Spec prima che vengano utilizzati.

ConnectionFactory cf = [ricerca da spazio nomi JNDI]
ECIConnectionSpec cs = new ECIConnectionSpec();
cs.setXXX(); //Imposta tutte le proprietà specifiche della connessione
Connection conn = cf.getConnection( cs );
Interaction int = conn.createInteraction();
ECIInteractionSpec is = new ECIInteractionSpec();
is.setXXX(); //Imposta tutte le proprietà specifiche dell'interazione
RecordImpl in = new RecordImpl();
RecordImpl out = new RecordImpl();
int.execute( is, in, out );
int.close();
conn.close(); 

L'adattatore risorse ECI consente allo sviluppatore J2EE di accedere a programmi CICS, utilizzando COMMAREA per passare informazioni da e verso il server. Questa tabella illustra gli oggetti JCA che corrispondono ai termini ECI. Le interfacce CCI per CICS sono nel pacchetto com.ibm.connector2.cics.