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 Mensagens 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 mensagens. O nome raiz do arquivo de definição de mensagens assume como padrão o nome raiz do arquivo de cabeçalho em C, mas o assistente Novo Arquivo de Definição de Mensagens permite a escolha de um nome de arquivo raiz diferente.
Se o arquivo de definição de mensagens 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.
Todos os arquivos de definição de mensagens criados como resultado da importação do arquivo de cabeçalho em C pertencem ao espaço de nomes XML noTarget e, portanto, residirão na localização (padrão) em seu espaço de trabalho.
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 mensagens.
Você também pode especificar qual das estruturas selecionadas devem ser mensagens no arquivo de definição de mensagens. A operação de importação cria uma mensagem e um elemento global correspondente no arquivo de definição de mensagens 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 Mensagens, 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 log do conjunto de mensagens.Por padrão, ele utiliza o nome do arquivo de definição de mensagens, 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 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.
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 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.
Conceitos Relacionados
Conceitos de Modelagem de Mensagens
Arquivos de Definição de Mensagem
Importar de Copybooks COBOL para Criar Definições de Mensagens
Tarefas Relacionadas
Trabalhando com Conjunto de Mensagem
Criando um Arquivo de Definição de Mensagem
Importando a partir de C
Importando a partir da Linha de Comandos
Avisos |
Marcas |
Downloads |
Biblioteca |
Suporte |
Feedback
![]() ![]() |
ad00831_ |