Esta seção descreve como criar uma nova definição de mensagem a partir de um arquivo de cabeçalho
C 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
um arquivo de cabeçalho C, o arquivo de cabeçalho já deve estar
presente no workbench, por exemplo, no projeto do conjunto de
mensagens. Isso permite selecionar o arquivo do cabeçalho no
assistente Novo Arquivo de Definição de Mensagem.
- O assistente permite importar arquivos de cabeçalho C com extensões .h, .c e .css. 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 no conjunto de mensagens antes ou depois de importar um arquivo de cabeçalho C, mas deve incluir a camada física antes de importá-lo para assegurar que seja preenchido com configurações do arquivo de cabeçalho C.
- Também é possível importar um arquivo de cabeçalho C da linha de comandos utilizando mqsicreatemsgdefs.
Se você utilizou
anteriormente o importador C 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 C do
Versão 2.1 não suportava tantas
construções C 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.
As seguintes etapas descrevem a criação de 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 um arquivo de cabeçalho em C:
- 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 workbench. Como alternativa, é possível abrir o assistente clicando em um arquivo de cabeçalho c anteriormente importado para o workbench e clicando em Novo
> Arquivo de Mensagem de Definição no menu.
- Na lista de opções exibida, clique no arquivo
de cabeçalho C, em seguida, clique em
Avançar.
- Percorra o restante do assistente preenchendo os detalhes
conforme necessário.
Quando tiver concluído a importação do arquivo de cabeçalho C 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 tem uma extensão de arquivo .c.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.