Importando Arquivos de Cabeçalho C para Criar Definições de Mensagem

Você pode ocupar seu conjunto de mensagens com definições de mensagens, importando arquivos de cabeçalho em C, utilizando o assistente Novo Arquivo de Definição de Mensagem ou o utilitário da linha de comandos mqsicreatemsgdefs.

Cada arquivo de cabeçalho em C importado resulta em um novo arquivo de definição de mensagem. O nome raiz do arquivo de definição de mensagem assume como padrão o nome raiz do arquivo de cabeçalho em C, mas o assistente Novo Arquivo de Definição de Mensagem permite a escolha de 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 da importação do arquivo de cabeçalho C pertencem ao espaço de nomes XML noTarget e, portanto, residirão na localização (padrão) 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. Para saber as razões pelas quais você pode querer fazer isso, consulte Espaços de Nomes com Mensagens Não XML.

No arquivo de cabeçalho em C, geralmente haverá uma ou mais estruturas em C. Você pode selecionar qual dessas estruturas deseja importar. A operação de importação importa essas estruturas, além de outras requeridas. 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.

Quando estiver importando utilizando o assistente Novo Arquivo de Definição de Mensagem, você pode apenas importar um arquivo de cabeçalho em C com cada operação de importação. Se estiver importando utilizando o utilitário da linha de comandos, poderá importar vários arquivos de cabeçalho em C em cada operação de importação.

Se seu arquivo de cabeçalho em C precisar de quaisquer outros arquivos de cabeçalho para uma compilação bem-sucedida, será necessário fornecê-los e especificar sua localização, 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 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 serão ocupadas. 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. Se você desejar que as informações físicas sejam criadas também, consulte Importando a partir da Linha de Comandos para obter detalhes.

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 em 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, tal como, um dicionário de mensagens.

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, será necessário escolher a correspondência mais próxima e rever as informações físicas criadas, utilizando o Editor de Definições de Mensagem após a conclusão da importação.

Chamada da Linha de Comandos

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 desejar aplicar diferentes conjuntos de informações a diferentes arquivos de cabeçalho, será necessário criar vários arquivos XML e executar o utilitário várias 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.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
ad00831_