Objetos Record representam dados trocados entre seu aplicativo e o
CICS, e esses objetos de registro são a base do
registro J2C ou bean de dados.
Objetos Record são usados para representar dados passados para e do EIS. Para ECI,
essa é uma representação de COMMAREA. Após uma conexão ser obtida com o servidor
CICS, uma Interaction pode ser criada a partir da
conexão para fazer uma solicitação específica. Assim como com a Conexão, as Interações
podem ter propriedades customizadas configuradas pela classe InteractionSpec específica
do CICS (ECIInteractionSpec). Para executar a Interação, o
aplicativo chama o método execute() e usa objetos de Registro específicos do CICS para
reter os dados. Por exemplo:
Obtain a ConnectionFactory
Connection c = cf.getConnection(ConnectionSpec)
Interaction i = c.createInteraction()
InteractionSpec is = newInteractionSpec();
i.execute(is,input,output)
Objetos Record armazenam os dados de entrada/saída que são usados durante uma
interação com um EIS, por exemplo, uma matriz de bytes representando uma COMMAREA de ECI. O exemplo a seguir mostra uma interação completa com um EIS. Neste exemplo, os objetos Record e os objetos Spec de entrada e saída são usados para
definir atributos específicos da interação e da conexão. O exemplo usa configuradores
para definir todas as propriedades específicas do componente nos objetos Spec antes de
elas serem usadas.
ConnectionFactory cf = [Lookup from JNDI namespace]
ECIConnectionSpec cs = new ECIConnectionSpec();
cs.setXXX(); //Configure todas as propriedades específicas da conexão
Connection conn = cf.getConnection(cs);
Interaction int = conn.createInteraction();
ECIInteractionSpec is = new ECIInteractionSpec();
is.setXXX(); //Configure todas as propriedades específicas da interação
RecordImpl in = new RecordImpl();
RecordImpl out = new RecordImpl();
int.execute( is, in, out );
int.close();
conn.close();
O adaptador de recursos ECI permite que um desenvolvedor
Java™ EE acesse programas
CICS usando COMMAREAs para passar informações para
e do servidor. Esta tabela mostra objetos JCA correspondentes aos termos ECI. As
interfaces CCI para o CICS estão no pacote
com.ibm.connector2.cics.
| Termo ECI |
Objeto J2C: propriedade |
| Código de aborto |
CICSTxnAbendException |
| COMMAREA |
Record |
| Tempo limite do ECI |
ECIInteractionSpec:ExecuteTimeout |
| Identificador de LUW |
Transação do Java EE |
| Senha |
ECIConnectionSpec:Password |
| Nome do programa |
ECIInteractionSpec:FunctionName |
| Nome do Servidor |
ECIConnectionFactory:ServerName |
| TPNName |
ECIInteractionSpec:TPNName |
| TranName |
ECIInteractionSpec:TranName |
| ID do Usuário |
|