Você pode ocupar seu conjunto de mensagens com definições de mensagem, importando arquivos de copybook COBOL, utilizando o assistente Novo Arquivo de Definição de Mensagem ou o utilitário da linha de comandos mqsicreatemsgdefs.
Cada arquivo de copybook COBOL 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 copybook COBOL, mas o assistente Novo Arquivo de Definição de Mensagem 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 da importação do arquivo de copybook COBOL 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 copybook COBOL, geralmente, existirão uma ou mais estruturas de nível 01. 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 de nível 01 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 você está importando utilizando o assistente Novo Arquivo de Definição de Mensagem, você só pode importar um arquivo de Copybook COBOL com cada operação de importação. Se estiver importando utilizando o utilitário da linha de comandos, poderá importar vários arquivos de copybook COBOL em cada operação de importação.
Se seu arquivo de copybook COBOL precisar de quaisquer outros copybooks para uma compilação bem-sucedida, será necessário fornecê-los e especificar sua localização, porque uma compilação de copybook é 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 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 do TDS devem ser definidas se as estruturas COBOL importadas tiverem que aparecer em uma mensagem TDS.
Se o formato físico TDS não for aplicável às suas estruturas COBOL, você poderá ignorar essas entradas da lista de tarefas porque elas são apenas avisos e não impedirão a geração de seu modelo 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 de linha de comandos mqsicreatemsgdefs permite importar vários arquivos COBOL em uma única operação. Todos os arquivos de copybook COBOL devem estar no único diretório e na localização do diretório transmitidos como um parâmetro ao utilitário.
Você fornece as informações específicas de ambiente necessárias utilizando um arquivo XML. Elas devem conter um elemento XML chamado <COBOL> que contém um conjunto de informações específicas do ambiente que se aplicam a todos os arquivos de Copybook COBOL 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 copybook, 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 o conjunto de mensagens criado 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 pré-ocupadas, que são copiadas para o conjunto de mensagens criado pela importação.