Este tópico descreve como criar uma nova definição de mensagem a partir de um arquivo de cabeçalho C utilizando o assistente de Novo Arquivo de Definição de Mensagem no WebSphere Message Broker
Toolkit.
Dica: Um conjunto de mensagens é o contêiner original
para modelos de mensagem usados pelo WebSphere Message
Broker.
No WebSphere Message
Broker Versão 8.0 e
mais recente, os arquivos de esquema de modelo de mensagem contidos em aplicativos
e bibliotecas são a maneira preferida de modelar mensagens para a maioria de formatos de
dados. Os conjuntos de mensagens continuam a ser suportados e serão necessários se você usar os domínios MRM ou IDOC. Para obter mais informações sobre modelagem de
mensagem, consulte Conceitos de Modelagem de Mensagens.
Antes de começar:
Conclua as seguintes tarefas:
Esteja ciente dos seguintes pontos:
- 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 WebSphere Message Broker
Toolkit, 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 pode 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.
- É possível importar um arquivo de cabeçalho C da linha de comandos utilizando mqsicreatemsgdefs.
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 de Novo Arquivo de
Definições de Mensagens clicando em ArquivoNovo Outro no
menu do WebSphere Message Broker
Toolkit. É aberta
uma janela na qual é possível selecionar um assistente.
- Expanda Message Broker - Desenvolvimento do
Conjunto de Mensagens, selecione Definição de Mensagem
e clique em Avançar. O assistente de Novo
Arquivo de Definições de Mensagens é aberto.
- Na lista de opções exibida, clique no arquivo
de cabeçalho C, em seguida, clique em
Avançar.
- Percorra o restante do assistente completando 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 WebSphere Message Broker
Toolkit
para verificar se apareceram novos avisos ou erros.