Puede llenar el conjunto de mensajes con definiciones de mensajes importando archivos de libro de copias COBOL, mediante el asistente para "Nuevo archivo de definición de mensajes a partir de un archivo COBOL" o el mandato mqsicreatemsgdefs.
Cada libro de copias COBOL que importe producirá un nuevo archivo de definición de mensajes. El nombre raíz del archivo de definición de mensajes adopta el valor predeterminado del nombre raíz del archivo de libro de copias COBOL, pero el asistente para "Nuevo archivo de definición de mensajes a partir de un archivo COBOL" permite que elija un nombre de archivo raíz distinto.
Si el archivo de definición de mensajes ya existe, tendrá que haber habilitado la sobregrabación para que continúe la importación, en cuyo caso el contenido existente se suprimirá y se volverá a crear.
De forma predeterminada, todos los archivos de definición de mensajes creados como resultado de la importación de archivos de libro de copias COBOL pertenecen al espacio de nombres XML noTarget y, por consiguiente, residen en la ubicación (valor predeterminado) del espacio de trabajo. Este espacio de nombres predeterminado se puede alterar temporalmente especificando un espacio de nombres de destino. Consulte Espacios de nombre con mensajes no XML para ver las razones por las que tal sea conveniente realizar esta acción.
Normalmente en el archivo de libro de copias COBOL hay una o varias estructuras de nivel 01. Puede seleccionar cuáles de estas estructuras se deben importar. Entonces la operación de importación importa dichas estructuras, más otras que necesite. Todas las estructuras importadas se convertirán en los elementos, grupos y tipos equivalentes en el archivo de definición de mensajes.
También puede especificar cuales de las estructuras de nivel 01 seleccionadas deben ser mensajes en el archivo de definición de mensajes. La operación de importación crea un mensaje y el elemento global correspondiente en el archivo de definición de mensajes para cada estructura que especifique. Si no especifica que se deben crear mensajes, deberá crearlos manualmente utilizando el Editor de definiciones de mensajes cuando se haya completado la importación.
Si importa utilizando el asistente "Nuevo archivo de definición de mensajes a partir de un archivo COBOL", sólo podrá importar un archivo de libro de copias COBOL con cada operación de importación. Si utiliza el programa de utilidad de la línea de mandatos, puede importar varios archivos de libro de copias COBOL en cada operación de importación.
Si el archivo de libro de copias COBOL necesita otros libros de copias para compilarse satisfactoriamente, deberá proporcionar dichos libros de copias en el mismo directorio, porque se realiza una compilación del libro de copias como parte de la operación de importación.
Durante la operación de importación se crea un archivo de informe. Éste está ubicado por omisión en la carpeta log del conjunto de mensajes. Por omisión, toma el nombre del archivo de definición de mensajes, al que se añade .report.txt.
El libro de copias no debe contener nombres de campo que sean palabras clave reservadas COBOL.
Además de crear información lógica, la importación también puede crear información física. Si el conjunto de mensajes contiene algún formato físico CWF (Formato físico personalizado), se llenan las propiedades del formato físico de todas las carpas CWF. Si el conjunto de mensajes no contiene ningún formato físico CWF, sólo se crea información lógica. Si importa desde la línea de mandatos, sólo se crea información lógica en el nuevo conjunto de mensajes de forma predeterminada. Si desea que también se cree información física, consulte Conjuntos de mensajes: importar desde la línea de mandatos para encontrar información detallada.
Las propiedades de formato físico XML y TDS no se llenan y, por consiguiente, toman los valores predeterminados.
Si tiene una o varias capas TDS, la importación puede producir entradas en la lista de tareas, avisándole que se deben establecer determinadas propiedades TDS si las estructuras COBOL que ha importado deben aparecer en un mensaje TDS.
Si el formato físico TDS no es aplicable a las estructuras COBOL, puede ignorar estas entradas de lista de tareas porque son sólo avisos y no impiden que el modelo se genere en otro formato, por ejemplo un diccionario de mensajes.
Puesto que se crea información física, el entorno de destino de aplicación (plataforma y compilador) es importante porque controla el modo en que, por ejemplo, aparecen los enteros en el mensaje. Puede especificar información específica de entorno como parte de la operación de importación y las propiedades necesarias se establecerán como corresponda. Hay una serie de entornos soportados; si no se muestra el entorno, elija el que coincida con mayor exactitud y revise la información física creada utilizando el Editor de definición de mensajes después de que se haya completado la importación.
El programa de utilidad de línea de mandatos mqsicreatemsgdefs le permite importar varios archivos COBOL en una sola operación. Todos los archivos de libro de copias COBOL deben estar en un solo directorio y la información de directorio se debe pasar como parámetro al programa de utilidad.
La información específica de entorno necesaria se proporciona utilizando un archivo XML. Este archivo debe contener un elemento XML denominado <COBOL> que contiene un conjunto de información específica sobre el entorno que se aplica a todos los archivos de libro de copias COBOL que se importan durante una invocación del programa de utilidad. Se proporciona un archivo XML predeterminado denominado mqsicreatemsgdefs.xml. Si desea aplicar diferentes conjuntos de información a diferentes libros de copias, debe crear varios archivos XML y ejecutar el programa de utilidad varias veces.
El programa de utilidad mqsicreatemsgdefs también le permite crear un conjunto de mensajes en el que se colocarán los archivos de definición de mensajes, como parte de la operación de importación. También puede elegir basar el conjunto de mensajes creado en un conjunto de mensajes existente. Este recurso permite preparar un conjunto de mensajes vacío que contenga un formato físico CWF y propiedades CWF de nivel de conjunto de mensajes rellenadas previamente, que a continuación se copian en el conjunto de mensajes que se crea mediante la importación.