Este tutorial descreve como usar o assistente de bean J2C para a construção de
um bean acionado por mensagens que processe uma transação de entrada do IMS™.
Este tutorial pode exigir alguns componentes instaláveis opcionais. Se encontrar erros ou não puder localizar as opções da interface com o usuário ao executar a amostra, assegure-se de que você instalou os componentes opcionais apropriados:
- IBM® WebSphere® Application Server, versão V7.0, V8.0 ou V8.5.
Para utilizar essa amostra, é necessário ter um servidor de aplicativos
instalado e configurado. Para verificar se um ambiente de tempo de execução do servidor
está disponível, clique em
,
expanda Servidor e clique em
Tempos de Execução Instalados. Você pode utilizar essa área de janela para incluir, remover ou editar definições
de tempo de execução do servidor instaladas. Também é possível fazer download e instalar suporte para
um novo servidor.
Ele
está dividido em vários exercícios que devem ser concluídos em sequência
para que o tutorial funcione corretamente. Este tutorial ensina você a usar o assistente
Java™ Bean J2C para criar um
Java bean que executa uma transação no
IMS. Ao concluir os exercícios, você
- Usa o assistente Bean J2C para criar um bean acionado por mensagens que execute uma
transação de entrada do IMS
- Implementa e executa o MDB no WebSphere
Application Server
- Configura e executa o aplicativo de amostra de callout do
IMS para emitir uma mensagem de callout síncrona
Visão Geral
Quando um aplicativo IMS emite uma solicitação para
um aplicativo Java externo ou serviço da web e
espera que uma resposta seja retornada na mesma transação, a solicitação é referida como
um callout síncrono a partir da perspectiva de um aplicativo
IMS e como uma transação de entrada a partir da
perspectiva do WebSphere Application Server.
Quando um aplicativo IMS emite uma solicitação de
callout síncrono, ele deve especificar um descritor de destino
IMS OTMA que manipule o roteamento da mensagem. Esse
destino contém o nome do canal de transação (TPIPE) que é usado para reter a mensagem de
callout. O IMS TM Resource Adapter que é
implementado no WebSphere Application Server
pega as solicitações de callout da fila de suspensão.
Etapas para implementação de
uma solução de callout síncrono para um aplicativo
IMS:
- Criar ou modificar um aplicativo IMS para emitir
uma solicitação de callout usando a chamada DL/I ICAL (no sistema host
IMS)
- Definir um descritor de destino OTMA (no sistema host
IMS)
- Criar um aplicativo J2C para uma transação de entrada do
IMS
- Executar o aplicativo IMS para emitir a
solicitação de callout síncrono (no sistema host IMS)
Nota: Este tutorial demonstra a etapa 3 da implementação geral.
Para verificação e
teste de ponta a ponta, se você escolher importar a amostra de entrada do
IMS, este tutorial também fornecerá instruções para
modificar a amostra de entrada para que você possa usar o aplicativo de amostra de
callout do IMS que é fornecido com a função de
callout síncrono do IMS por meio do Installation
Verification Program (IVP) do IMS. Esse IVP de
amostra de callout do IMS inclui:
- Um aplicativo IMS de amostra que, quando
executado, emite uma solicitação de callout síncrono. Esse aplicativo especifica o uso de
um descritor de destino OTMA predefinido (IVPDTOR4) e um canal de transação (IVPPIPE4)
para roteamento e enfileiramento de mensagens de callout. Tudo que esse aplicativo
IMS de amostra faz é emitir uma solicitação de
callout com uma mensagem "HELLO FROM IMS" e esperar
uma resposta.
- Atividades e tarefas do IVP que podem ser executadas para a configuração do descritor
de destino OTMA necessário para roteamento de mensagem de callout e canal de transação
(uma fila) para reter a mensagem de callout.
O diagrama a seguir
descreve o fluxo de mensagens de callout síncrono do
IMS usando o nome do descritor de destino OTMA e o
valor TPIPE (nome da fila) que são fornecidos no IVP de amostra de callout do
IMS.
Objetivos do aprendizado Nesse tutorial, você irá:
- Usa o assistente Bean J2C para criar um bean acionado por mensagens que execute uma
transação de entrada do IMS
- Implementa e executa o MDB no WebSphere
Application Server
- Configura e executa o aplicativo IMS para
mensagens de callout síncronas
Tempo
Necessário
Este
tutorial leva aproximadamente 30 minutos para ser concluído. Se você explorar outros conceitos relacionados a este tutorial, poderá levar mais tempo
para ser concluído.
Nível de Qualificação
Experiente
Público
Este tutorial destina-se aos usuários que estão familiarizados com o Enterprise
Information Systems (EIS) e o IMS em particular.
Requisitos do Sistema
Para concluir este tutorial,
é necessário ter as seguintes ferramentas e componentes instalados:
- IBM® WebSphere® Application Server, versão V7.0, V8.0 ou V8.5.
- J2EE Connector (J2C) Tools instalado
- Informações sobre o ambiente do IMS:
Neste tutorial, seu aplicativo interage com um programa de aplicativo no
IMS. Você precisa obter informações como nome do
host e número da porta do IMS Connect e o nome do
armazenamento de dados do IMS no qual a transação é
executada. Entre em contato com o administrador de sistemas
IMS para obter essas informações. Além disso, é
preciso executar alguns trabalhos de configuração no
IMS se você quiser executar esta amostra.
- Uma cópia do arquivo COBOL SYCALOUT.cpy: Você pode localizar
esse arquivo no diretório de instalação do produto:
<installdir>\IBM\SDP70Shared\plugins\com.ibm.j2c.cheatsheet.content_7.0.0\samples\IMS\inbound.
Se quiser armazená-lo localmente, é possível copiar o código daqui:
dsycalout.cpy
- Um espaço de trabalho vazio.
Pré-requisitos
Para concluir este tutorial
do início ao fim, você deve estar familiarizado com:
- Programação Java e J2EE
- Conceitos básicos do IMS Transaction Manager
(IMS TM)
- Pré-requisitos no sistema host IMS: