Esta seção descreve como criar uma nova definição de mensagem a partir de uma estrutura de dados COBOL
utilizando o assistente de Arquivo de Nova Definição de Mensagem no workbench.
Antes de começar:
Para concluir esta tarefa, você deve ter concluído as tarefas a seguir:
Antes de iniciar esta tarefa, é necessário considerar os pontos
listados abaixo:
- Para criar um novo arquivo de definição de mensagem a partir de uma estrutura de dados COBOL, o arquivo COBOL já deve estar presente no workbench,
por exemplo, em seu projeto do conjunto de mensagens. Isso permite selecionar o arquivo no assistente
Novo Arquivo de Definição de Mensagem.
- O assistente permite importar arquivos COBOL com as extensões .cbl, .ccp, .cob e .cpy. Se o arquivo de origem possuir
uma extensão diferente, será necessário renomeá-lo antes de tentar
importá-lo.
- Se o conjunto de mensagens no qual você está incluindo o novo
arquivo de definição de mensagem não
tiver uma camada CWF (Custom Wire Format), apenas as informações
lógicas aparecerão no modelo. É possível incluir a camada física no conjunto de mensagens antes ou depois da importação de uma estrutura de dados de COBOL, mas você deve incluir a camada física antes de importar a estrutura de dados para assegurar que seja preenchida com configurações do copybook COBOL.
- Também é possível importar uma estrutura de dados COBOL a partir da linha de comandos
utilizando mqsicreatemsgdefs.
Se você utilizou
anteriormente o importador COBOL do
WebSphere MQ Integrator Versão 2.1 para criar um modelo de
mensagens, poderá descobrir que o importador do
WebSphere Message Broker
Versão 6.0 não produz exatamente os
mesmos resultados. Em específico, o importador COBOL do
Versão 2.1 não suportava tantas
construções COBOL quanto o WebSphere Message Broker
Versão 6.0 e
a convenção de nomenclatura para tipos compostos do
Versão 2.1 não é a mesma da convenção
de nomenclatura para grupos e tipos complexos do
WebSphere Message Broker
Versão 6.0. Em poucos casos, a
convenção de nomenclatura para os elementos do
Versão 2.1 não é a mesma da convenção
de nomenclatura para os elementos
WebSphere Message Broker
Versão 6.0. Se você tiver criado um ESQL de fluxo de mensagens na Versão 2.1
para manipular o modelo de mensagem derivado de COBOL e importado esse ESQL
para o WebSphere Message Broker
Versão 6.0 utilizando o comando mqsimigratemsgflows,
e se agora estiver recriando seu modelo de mensagens utilizando o importador COBOL do WebSphere Message Broker
Versão 6.0,
você deve rever a exatidão do ESQL.
As etapas abaixo descrevem como criar um arquivo de
definição de mensagem completamente novo e como sobrescrever o
conteúdo de um arquivo existente.
Para criar um arquivo de definição de mensagem a partir de uma estrutura de dados COBOL:
- Alterne para o Perspectiva do Desenvolvimento de Aplicativos do Intermediário.
- Abra o assistente para Novo Arquivo de Definição de Mensagem, clicando em Arquivo
> Novo > Arquivo de Definição de Mensagem, no menu do workbench. Como alternativa, você pode abrir o assistente clicando com o botão direito do mouse em um copybook COBOL já importado para o workbench e clicando em Novo> Arquivo de Definição de Mensagem, no menu.
- Na lista de opções exibida, clique no arquivo
COBOL e clique em Avançar.
- Percorra o restante do assistente preenchendo os detalhes
conforme necessário.
Quando tiver concluído a importação do arquivo COBOL utilizando o assistente:
- Verifique com atenção se existem erros no relatório criado durante
a importação do arquivo. Esse relatório
pode ser encontrado no diretório registro
dentro do projeto que contém a definição de mensagem que você tentou
criar. O relatório possui uma extensão de arquivo .cobol.report.txt,
prefixada com o nome especificado para o arquivo de nova definição de mensagem.
- Reveja as mensagens mostradas na lista de tarefas do workbench
para verificar se apareceram novos avisos ou erros.