Objets d'enregistrement

Les objets d'enregistrement sont utilisés pour représenter des données transmises de et vers le système EIS. Dans le cas de l'ECI, il s'agit d'une représentation d'une COMMAREA. Après avoir obtenu une connexion vers le serveur CICS, une interaction peut être créée à partir de la connexion pour une requête particulière. De même que la connexion, les interactions peuvent avoir des propriétés personnalisées déterminées par la classe InteractionSpec spécifique à CICS (ECIInteractionSpec). Pour accomplir l'interaction, l'application appelle la méthode execute() et utilise les objets d'enregistrement spécifiques à CICS pour conserver les données. Par exemple :

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

Les objets d'enregistrement stockent les données d'entrée/sortie utilisées lors d'une interaction avec un EIS, par exemple un tableau d'octets représentant une ECI COMMAREA. L'exemple suivant illustre une interaction complète avec un EIS. Dans cet exemple, les objets de spécification et les objets d'enregistrement d'entrée/sortie sont utilisés pour définir les attributs spécifiques de l'interaction et de la connexion. L'exemple utilise des méthodes setter pour définir toute propriété spécifique au composant sur les objets Spec avant leur utilisation.

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(); 

L'adaptateur de ressources ECI permet au développeur J2EE d'accéder aux programmes CICS, en utilisant des COMMAREA pour transmettre les informations depuis le serveur et vers le serveur. Ce tableau illustre les objets JCA correspondant aux termes ECI. Les interfaces CCI pour CICS sont dans le package com.ibm.connector2.cics.