Executando a Amostra ISO8583
Esta amostra fornece dois métodos de teste alternativos:
- Um plug-in para o Toolkit, que fornece uma Visualização de Teste TCPIP gráfica que envia e recebe dados de soquete TCPIP. Isso está descrito detalhadamente na seção
Usando a Visualização de Teste TCPIP
- Um aplicativo, ISO8583TestApplication, é fornecido, usando um fluxo de mensagens para transformação entre as mensagens MQ e os dados do soquete TCPIP. Isso está descrito detalhadamente na seção
Usando o ISO8583TestApplication
Ambas as abordagens fornecem dois testes (um para os dados que fluem em cada direção) e também pressupõem
que a Configuração Padrão tenha sido criada.
Instruções são fornecidas na documentação do WebSphere Message Broker para
Criar a Configuração Padrão.
Comece executando as seguintes etapas manuais:
- Esta amostra fornece uma Visualização de Teste TCPIP para o WebSphere Message Broker Toolkit. Para
instalar esse plug-in, no Toolkit, selecione a opção de menu Ajuda -> Instalar Novo Software. Será solicitado que você
selecione um local de instalação. Use o botão Incluir para Incluir um Repositório Local e especifique
no diálogo pop-up o projeto TCPIP_Tester_Update local que foi colocado em sua área de trabalho ao instalar a amostra.
Supondo que sua área de trabalho esteja em C:\workspace, o diálogo será semelhante a este:

- Clique em OK e será retornado para o assistente de instalação. Selecione o recurso:

- Clique em Avançar e a página Detalhes da Instalação será exibida:

- Clique em Concluir. Poderá ser solicitado que você reinicie o Toolkit, mas na maioria dos casos isso não deve ser necessário (selecione Aplicar Mudanças Agora).
- Para verificar se o plug-in foi instalado corretamente, selecione a opção de menu Janela -> Mostrar Visualização -> Outros e, no diálogo pop-up, escolha TCPIP, conforme mostrado abaixo:

- Se a visualização não estiver disponível, reinicie o Toolkit usando a opção -clean.
- Implemente o aplicativo de amostra ISO8583Application.
- Caso você já tenha testado usando ISO8583TestApplication, certifique-se de haver excluído esse aplicativo do Grupo de Execução antes de continuar. Você não deve tentar conectar a Visualização de Teste TCPIP ao soquete também!
- Agora você está pronto para executar a amostra.
Testar ISO8583 para XML
- Se ainda não tiver feito isso, ative a Visualização de Teste TCPIP no menu Janela -> Mostrar Visualização.
Por padrão, a propriedade Nome do host (que especifica o nome do host ou o endereço IP da instalação do Message Broker em que o ISO8583Application foi implementado) é preenchida com o valor localhost. Por padrão, a propriedade Porta (que especifica a porta usada pelos fluxos de mensagens ISO8583_TCPIP_to_WMQ e ISO8583_WMQ_to_TCPIP) é preenchida com o valor 111. Você pode alterar esses valores se desejar, mas eles devem corresponder às propriedades dos fluxos de mensagens implementados.
- Clique no botão Procurar e navegue até o arquivo de dados de teste Test_ISO8583_to_XML.txt. Este arquivo de teste está localizado no ISO8583Application, que a amostra importa na área de trabalho do Toolkit.
- Clique no botão Conectar TCPIP. A janela do console na base da Visualização de Teste TCPIP deve relatar que a conexão
com o fluxo de mensagens foi estabelecida com êxito:
2012/07/05 13:02:17 Conexão de TCPIP: Uma conexão de soquete foi criada para hospedar o host local, número da porta 1111
Você deve ver que os campos Nome do host e Porta foram desativados. Eles permanecerão assim até que a conexão seja encerrada mais tarde.
- Clique no botão Enviar TCPIP. A Visualização de Teste deve enviar os dados do arquivo nomeado para o soquete em que o fluxo de mensagens está recebendo. A janela do console na base da Visualização de Teste TCPIP deve relatar que os dados foram enviados com êxito:
2012/07/05 13:02:33 Envio de TCPIP: Dados de saída gravados para o soquete foram obtidos do arquivo C:\workspace\ISO8583TestApplication\Test_ISO8583_to_XML.txt
2012/07/05 13:02:33 Envio de TCPIP: <DATA SHOWN HERE>
- Clique no botão Desconectar TCPIP. Observe que a configuração do fluxo de mensagens de amostra é tal que
ele não tentará ler os dados até que o soquete tenha sido encerrado. A janela do console na base da Visualização de Teste TCPIP deve relatar que a conexão foi encerrada com êxito:
2012/07/05 13:02:43 Desconexão de TCPIP: A conexão de soquete para hospedar o host local, número da porta 1111, foi encerrada.
- Use a ferramenta do cliente de teste WebSphere Message Broker Toolkit para ler a mensagem de saída correspondente que deve estar no formato XML da fila de saída denominada ISO8583.OUT. Abra o arquivo de teste de fluxo ISO8583_TCPIP_to_WMQ_Dequeue.mbtest, que está localizado no projeto ISO8583Application. Clique no botão Obter Mensagem. A mensagem de saída esperada da fila de saída (ISO8583.OUT) deve estar no formato XML e é mostrada na seção Mensagens de Saída Esperadas.
A imagem abaixo mostra o console Visualização de Teste TCPIP ao testar ISO8583 para XML:

Testar XML para ISO8583
- Ative a Visualização de Teste TCPIP. Por padrão, a propriedade Nome do host (que especifica o nome do host ou o endereço IP da instalação do Message Broker em que o ISO8583Application foi implementado) é preenchida com o valor localhost. Por padrão, a propriedade Porta (que especifica a porta usada pelos fluxos de mensagens ISO8583_TCPIP_to_WMQ e ISO8583_WMQ_to_TCPIP) é preenchida com o valor 111. Você pode alterar esses valores se desejar, mas eles devem corresponder às propriedades dos fluxos de mensagens implementados.
- Clique no botão Conectar TCPIP. A janela do console na base da Visualização de Teste TCPIP deve relatar que a conexão
com o fluxo de mensagens foi estabelecida com êxito:
2012/07/05 13:12:02 Conexão de TCPIP: Uma conexão de soquete foi criada para hospedar o host local, número de porta 1111
Você deve ver que os campos Nome do host e Porta foram desativados. Eles permanecerão assim até que a conexão seja encerrada mais tarde.
- Uma mensagem de entrada XML de exemplo é fornecida no arquivo Test_XML_to_ISO8583.txt. Este arquivo de teste está localizado no ISO8583Application, que a amostra importa na área de trabalho do Toolkit. Use a ferramenta do cliente de teste WebSphere
Message Broker Toolkit para gravar esta mensagem na fila de entrada do fluxo de mensagem ISO8583_WMQ_to_TCPIP, que é denominado ISO8583.IN. Abra o arquivo de teste do fluxo ISO8583_WMQ_to_TCPIP_Enqueue.mbtest que está localizado no projeto ISO8583Application. Clique no botão Inserir Mensagem.
- Volte para a Visualização de Teste TCPIP e clique no botão Receber TCPIP. A Visualização de Teste deve receber os dados do soquete para o qual eles foram enviados pelo fluxo de mensagens. A janela do console na base da Visualização de Teste TCPIP deve relatar que os dados foram recebidos com êxito:
2012/07/05 13:12:22 Recebimento de TCPIP: Dados de entrada foram lidos do soquete: <DATA SHOWN HERE>
- O formato da mensagem de saída esperado é mostrado na seção Mensagens de Saída Esperadas
- Clique no botão Desconectar TCPIP. A janela do console na base da Visualização de Teste TCPIP deve relatar que a conexão foi encerrada com êxito:
2012/07/05 13:12:25 Desconexão de TCPIP: A conexão do soquete para hospedar o host local, número de porta 1111, foi encerrada.
A imagem abaixo mostra o console Visualização de Teste TCPIP ao testar XML para ISO8583:

Se você importou e implementou a amostra usando o link em ISO8583 Visão Geral da Amostra, as filas MQ requeridas terão sido criadas para você e ISO8583Application terá sido implementado.
Como alternativa, se você não tiver feito isso e apenas importou os projetos em sua área de trabalho, crie as filas (ISO8583.IN,
ISO8583.OUT, ISO8583.TESTER.IN, ISO8583.TESTER.OUT) e implemente ISO8583Application manualmente agora.
Este método de teste também exige que você implemente manualmente o aplicativo de teste ISO8583TestApplication. Faça isso agora.
O aplicativo de teste contém um fluxo de mensagens muito simples que media dados entre mensagens e conexões de soquete TCPIP:

Testar ISO8583 para XML
- Inicie o cliente de teste integrado do WebSphere Message Broker Toolkit abrindo o arquivo de teste de fluxo SendTCPIP_with_ISO8583TestTool.mbtest que está localizado no projeto ISO8583TestApplication. Esse teste é configurado para ler os dados de exemplo ISO8583 do arquivo denominado Test_ISO8583_to_XML.txt (no projeto ISO8583Application) e gravá-lo na fila de entrada (ISO8583.TESTER.IN) do fluxo de teste. Clique no botão Enviar Mensagem no cliente de teste para inserir a mensagem na fila.
- O fluxo de mensagens ISO8583TestTool simplesmente lerá a mensagem e a enviará para o soquete TCPIP de entrada do fluxo de mensagens principal ISO8583_TCPIP_to_WMQ. O fluxo de mensagens ISO8583_TCPIP_to_WMQ analisará a mensagem ISO8583 usando o modelo DFDL fornecido, removerá PrimaryBitmap e SecondaryBitmap (que não são necessários na mensagem de saída XML) e transformará os dados como uma mensagem XML de saída, que é gravada para a fila de saída ISO8583.OUT. Leia esta mensagem de saída correspondente usando a ferramenta cliente de teste do Message Broker Toolkit. Abra o arquivo de teste de fluxo ISO8583_TCPIP_to_WMQ_Dequeue.mbtest que está localizado no projeto ISO8583Application. Clique no botão Obter Mensagem. A mensagem de saída esperada da fila de saída (ISO8583.OUT) deve estar no formato XML e é mostrada na seção Mensagens de Saída Esperadas.
Testar XML para ISO8583
- Inicie o cliente de teste integrado do WebSphere Message Broker Toolkit abrindo o arquivo de teste de fluxo ISO8583_WMQ_to_TCPIP_Enqueue.mbtest que está localizado no projeto ISO8583Application. Esse teste é configurado para ler os dados de exemplo XML do arquivo denominado Test_XML_to_ISO8583.txt (no projeto ISO8583Application) e gravá-lo na fila de entrada (ISO8583.IN) do fluxo principal. Clique no botão Enviar Mensagem no cliente de teste para inserir a mensagem na fila.
- O fluxo de mensagens ISO8583_WMQ_to_TCPIP analisará o XML, analisará os campos que ele contém e criará
PrimaryBitmap e SecondaryBitmap de acordo. O fluxo enviará então a mensagem com formato ISO8583 para o soquete de saída, que será recebido pelo fluxo de teste ISO8583TestTool. Esses dados serão gravados na fila de saída
ISO8583.TESTER.OUT. Leia esta mensagem de saída usando a ferramenta cliente de teste do Message Broker Toolkit. Abra o arquivo de teste do fluxo ReceiveTCPIP_with_ISO8583TestTool.mbtest que está localizada no projeto ISO8583TestApplication.
Clique no botão Obter Mensagem. A mensagem de saída esperada da fila de saída (ISO8583.TESTER.OUT) deve estar no formato ISO8583 e é mostrada na seção Mensagens de Saída Esperadas.
Voltar para o Início da Amostra