É possível preencher seu conjunto de mensagens com definições de mensagens, importando arquivos de cabeçalho C utilizando o assistente Novo Arquivo de Definição de Mensagem de Arquivo de Cabeçalho C ou o utilitário de linha de comandos 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ção de mensagem utiliza como padrão o nome raiz do arquivo de cabeçalho C, mas o assistente Novo Arquivo de Definição de Mensagem de Arquivo de Cabeçalho C permite escolher um nome de arquivo raiz diferente.
Se o arquivo de definição de mensagem já existir, isso indica que você deve 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 espaço de nomes XML noTarget e, portanto, residem no local (default) em seu espaço de trabalho. Esse espaço de nomes padrão pode ser substituído pela especificação de um espaço de nomes de destino. Consulte Espaços de Nomes com Mensagens MRM 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ção de mensagem.
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 importar utilizando o assistente Novo Arquivo de Definição de Mensagem de Arquivo de Cabeçalho C, é possível importar somente um arquivo de cabeçalho C em cada operação de importação. Mas, se importar utilizando o utilitário de linha de comandos, é possível importar diversos 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.
Além de criar informações lógicas, a importação também cria 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 suas estruturas C, será possível ignorar essas entradas da lista de tarefas, porque elas são apenas avisos e não impedirão que seu modelo seja gerado em outro formato; como um dicionário de mensagem.
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. Você pode especificar informações específicas do ambiente como parte da operação de importação e as propriedades necessárias serão definidas conseqüentemente. Há um intervalo de ambientes suportados; se seu ambiente não for mostrado, escolha a correspondência mais próxima e reveja as informações físicas criadas, utilizando o Editor de Definições de Mensagem após a conclusão da importação.
O utilitário da linha de comandos mqsicreatemsgdefs permite importar vários arquivos de cabeçalho em 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 as informações de localização de arquivo utilizando 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 criar um novo conjunto de mensagens no qual os arquivos de definição de mensagem 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.