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 em COBOL, o arquivo COBOL já deve estar
presente no workbench, por exemplo, no 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 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. Você pode incluir a camada física ao conjunto de mensagens antes ou
depois de importar uma estrutura de dados COBOL, mas é
recomendável que você inclua a camada
física antes da importação da estrutura de
dados.
- 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,
é altamente recomendável 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 Novo Arquivo de Definição de Mensagem, clicando em Arquivo > Novo > Arquivo de
Definição de Mensagem no menu
workbench. Como alternativa, você pode abrir o assistente clicando com o botão direito do mouse no copybook COBOL importado anteriormente 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.