É possível preencher seu conjunto de mensagens com definições de mensagens, importando arquivos de copybook COBOL, usando o assistente de Novo Arquivo de Definições de Mensagens do Arquivo COBOL ou o comando mqsicreatemsgdefs.
Cada copybook COBOL 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 copybook COBOL, mas o assistente de Novo Arquivo de Definições de Mensagens do Arquivo COBOL 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 da importação do arquivo de copybook COBOL 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 copybook COBOL, geralmente, existem 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 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 de nível 01 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 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 COBOL", é possível importar apenas um arquivo de copybook COBOL em cada operação de importação. Se usar o utilitário de linha de comandos, é possível importar diversos 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 mensagens, com .report.txt anexado.
O copybook não deve conter nomes de campo que sejam palavras-chave reservadas COBOL.
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. Se importar a partir da linha de comandos, apenas as informações lógicas são criadas no novo conjunto de mensagens por padrão. Se você desejar que as informações físicas sejam criadas também, consulte Conjuntos de Mensagens: Importando da Linha de Comandos para obter detalhes.
As propriedades de formato físico XML e TDS não são preenchidas e, portanto, utilizam valores padrão.
Se houver uma ou mais camadas TDS, a importação pode gerar entradas na lista de tarefas, avisando que algumas propriedades 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 estruturas COBOL, é possível ignorar essas entradas da lista de tarefas porque elas são apenas avisos e não evitarão a geração de seu modelo em outro formato, como um dicionário de mensagens, 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.
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 em um único diretório e o local do diretório deve ser transmitido como um parâmetro ao utilitário.
Você fornece as informações específicas de ambiente necessárias usando 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 do utilitário. É fornecido um arquivo XML padrão chamado mqsicreatemsgdefs.xml. Se deseja 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 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 o conjunto de mensagens criado em um conjunto de mensagens existente. Esse recurso permite que você prepare um conjunto de mensagens vazio que contém um formato físico CWF e propriedades CWF preenchidas no nível do conjunto de mensagens, que são, então, copiadas para o conjunto de mensagens criado pela importação.