WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

Conjuntos de Mensagens: Importando de Arquivos de Cabeçalho C para Criar Definições de Mensagens

Crie um arquivo de definição de mensagem de um arquivo de cabeçalho C para uso nos domínios MRM e IDOC.
Dica: Este tópico será relevante apenas se você estiver usando arquivos de definição de mensagens. Como alternativa, considere o mais novo assistente de Novo Modelo de Mensagem para criar um esquema para utilização no domínio DFDL; consulte Criando um Arquivo de Esquema DFDL de um Arquivo de Cabeçalho C.

É possível preencher o conjunto de mensagens com definições de mensagens, importando arquivos de cabeçalho C, usando o assistente de Novo Arquivo de Definições de Mensagens do Arquivo de Cabeçalho C ou o comando mqsicreatemsgdefs.

Cada arquivo de cabeçalho C importado resulta em um novo arquivo de definição de mensagem. O nome-raiz do arquivo de definições de mensagens usa como padrão o nome-raiz do arquivo de cabeçalho C, mas o assistente de "Novo Arquivo de Definições de Mensagens do Arquivo de Cabeçalho C" permite escolher um nome de arquivo raiz diferente.

Se o arquivo de definição de mensagem já existir, você deverá ter permitido a substituição para a continuação da importação e, nesse caso, o conteúdo existente será excluído e recriado.

Por padrão, todos os arquivos de definição de mensagem criados como resultado de uma importação de um arquivo de cabeçalho C pertencem ao namespace XML noTarget e, portanto, residem no local (default) em seu espaço de trabalho. Esse namespace padrão pode ser substituído pela especificação de um namespace de destino. Consulte Namespaces com Mensagens Não XML para as razões para fazer isso.

No arquivo de cabeçalho C, geralmente, existem uma ou mais estruturas C. Você pode selecionar qual dessas estruturas deseja importar. A operação de importação importa essas estruturas, além de outras necessárias. Todas as estruturas importadas são convertidas em elementos, grupos e tipos equivalentes no arquivo de definições de mensagens.

Você também pode especificar qual das estruturas selecionadas devem ser mensagens no arquivo de definição de mensagem. A operação de importação cria uma mensagem e um elemento global correspondente no arquivo de definição de mensagem para cada estrutura especificada. Se você não especificar que as mensagens devem ser criadas, deverá criá-las manualmente utilizando o editor de Definições de Mensagem após a conclusão da importação.

Se você importar usando o assistente de "Novo Arquivo de Definições de Mensagens do Arquivo de Cabeçalho C", é possível importar apenas um arquivo de cabeçalho C em cada operação de importação. Mas, se importar usando o utilitário de linha de comandos, é possível importar vários arquivos de cabeçalho C em cada operação de importação.

Se seu arquivo de cabeçalho C precisar de quaisquer outros arquivos de cabeçalho para uma compilação bem-sucedida, será necessário fornecê-los e especificar seu local, porque uma compilação do arquivo de cabeçalho é executada como parte da operação de importação.

É criado um arquivo de relatório durante a operação de importação. Por padrão, ele está localizado na pasta registro do conjunto de mensagens. Por padrão, ele utiliza o nome do arquivo de definição de mensagem, com .report.txt anexado.

Informações Físicas

Além de criar informações lógicas, a importação também pode criar informações físicas.

Se o conjunto de mensagens contiver qualquer formato físico CWF (Custom Wire Format), as propriedades de formato físico para todas as camadas CWF são preenchidas.

Se o conjunto de mensagens não contiver nenhum formato físico CWF, apenas as informações lógicas serão criadas. Além disso, se você importar a partir da linha de comandos, apenas as informações lógicas serão criadas no novo conjunto de mensagens por padrão.

As propriedades dos formatos físicos XML e TDS não são ocupadas e, portanto, utilizam valores padrão.

Se você tiver uma ou mais camadas TDS, a importação poderá gerar entradas na lista de tarefas, avisando-o de que algumas propriedades de TDS devem ser definidas, se as estruturas em C importadas tivessem que aparecer em uma mensagem TDS.

Se o formato físico TDS não for aplicável às estruturas C, é possível ignorar essas entradas da lista de tarefas, porque elas são apenas avisos e não evitarão que o modelo seja gerado em outro formato, como um dicionário de mensagem, por exemplo.

Como são criadas informações físicas, o ambiente de destino do aplicativo (plataforma e compilador) é importante, porque controla a forma que, por exemplo, os inteiros aparecem na mensagem. É possível especificar informações específicas do ambiente como parte da operação de importação e as propriedades necessárias serão definidas, consequentemente. Há um intervalo de ambientes suportados; se seu ambiente não for mostrado, escolha a correspondência mais próxima e revise as informações físicas criadas usando o Editor de Definição de Mensagens após a conclusão da importação.

Chamada da Linha de Comandos

O utilitário de linha de comandos mqsicreatemsgdefs permite importar vários arquivos de cabeçalho C em uma única operação. Todos os arquivos de cabeçalho em C devem ser colocados no mesmo diretório e a localização do diretório transmitida como um parâmetro para o utilitário.

Você fornece as informações específicas de ambiente necessárias e inclui informações de local do arquivo usando um arquivo XML. Elas devem conter um elemento XML chamado <C> que contém um conjunto de informações que se aplicam a todos os arquivos de cabeçalho em C importados durante uma chamada de utilitário. É fornecido um arquivo XML padrão chamado mqsicreatemsgdefs.xml. Se quiser aplicar diferentes conjuntos de informações em diferentes arquivos de cabeçalho, você deve criar diversos arquivos XML e executar o utilitário diversas vezes.

O utilitário mqsicreatemsgdefs também permite a criação de um conjunto de mensagens no qual os arquivos de definições de mensagens são colocados, como parte da operação de importação. Você também pode escolher basear esse novo conjunto de mensagens em um conjunto de mensagens existente. Esse recurso permite preparar um conjunto de mensagens vazio contendo propriedades de formato físico CWF e de CWF do nível do conjunto de mensagens já ocupadas, que são copiadas para o conjunto de mensagens criado pela importação.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:29:04


Tópico de ConceitoTópico de Conceito | Versão 8.0.0.5 | ad00831_