Les objets d'enregistrement représentent des données échangées entre votre application
et CICS ; ces objets d'enregistrement constituent la base de l'enregistrement J2C ou des beans de données.
Les objets d'enregistrement sont utilisés pour représenter des données transmises de et vers le système EIS. Pour ECI, il s'agit d'une représentation d'une COMMAREA. Après l'obtention d'une connexion au serveur CICS, une interaction peut être créée à partir de la connexion pour une demande particulière. Comme les connexions, les interactions peuvent avoir des propriétés personnalisées définies par la classe InteractionSpec spécifique à CICS (ECIInteractionSpec). Pour effectuer l'interaction, l'application appelle la méthode execute() et utilise des objets Record spécifiques à CICS pour stocker les données. Par exemple :
Obtain a ConnectionFactory
Connection c = cf.getConnection(ConnectionSpec)
Interaction i = c.createInteraction()
InteractionSpec is = newInteractionSpec();
i.execute(is,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 Java™ EE
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.
| Terme ECI |
Objet J2C : propriété |
| Code de fin anormale |
CICSTxnAbendException |
| COMMAREA |
Enregistrement |
| Délai d'attente ECI |
ECIInteractionSpec:ExecuteTimeout |
| Identificateur LUW |
Transaction Java EE |
| Password |
ECIConnectionSpec:Password |
| Nom de programme |
ECIInteractionSpec:FunctionName |
| Nom du serveur |
ECIConnectionFactory:ServerName |
| TPNName |
ECIInteractionSpec:TPNName |
| TranName |
ECIInteractionSpec:TranName |
| ID utilisateur |
|