Importación desde los libros de copias COBOL para crear definiciones de mensajes

Puede rellenar su conjunto de mensajes con definiciones de mensajes importando archivos del libro de copias COBOL, utilizando el asistente de Nuevo archivo de definiciones de mensajes o el programa de utilidad de línea de mandatos mqsicreatemsgdefs.

Cada archivo del libro de copias COBOL que importa genera un archivo de definiciones de mensajes nuevo. Por omisión, el nombre raíz del archivo de definiciones de mensajes es el nombre raíz del archivo del libro de copias COBOL pero el asistente de Nuevo archivo de definiciones de mensajes le permite seleccionar un nombre de archivo raíz diferente.

Si ya existe el archivo de definiciones de mensajes, debe permitir que se sobregrabe para poder continuar con la importación, en cuyo caso el contenido existente se suprime y se vuelve a crear.

Todos los archivos de definiciones de mensajes que se crean como resultado de la importación del archivo del libro de copias COBOL pertenecen al espacio de nombres XML noTarget y, por lo tanto, residirán en la ubicación (default) del espacio de trabajo.

En el archivo del libro de copias COBOL habrá generalmente una o varias estructuras de nivel 01. Puede seleccionar qué estructuras importará. A continuación, se importarán estas estructuras mediante la operación de importación más las que sean necesarias. Todas las estructuras importadas se convierten a elementos, grupos y tipos equivalentes en el archivo de definiciones de mensajes.

También puede especificar qué estructuras, de las seleccionadas, serán mensajes en el archivo de definiciones de mensajes. La operación de importación crea un mensaje y un elemento global correspondiente en el archivo de definiciones de mensajes para cada estructura que especifique. Si no especifica que se han de crear mensajes, debe crearlos manualmente utilizando el Editor de definiciones de mensajes después de haber completado la importación.

Cuando importa con el asistente de Nuevo archivo de definiciones de mensajes solamente puede importar un archivo del libro de copias COBOL con cada operación de importación. Si importa utilizando el programa de utilidad de línea de mandatos puede importar varios archivos del libro de copias COBOL en cada operación de importación.

Si el archivo del libro de copias COBOL necesita otros archivos de cabeceras para poder compilar correctamente, debe proporcionarlos y especificar su ubicación debido a que se efectúa una compilación del archivo del libro de copias como parte de la operación de importación.

Se crea un archivo de informe durante la operación de importación. Por omisión, éste está situado en la carpeta log del conjunto de mensajes. Por omisión, toma el nombre del archivo de definiciones de mensajes al que se le añade .report.txt.

Información física

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 formatos físicos personalizados (CWF) entonces se rellenan las propiedades de formato físico de todas las capas del formato físico CWF. Si el conjunto de mensajes no contiene ningún formato físico CWF, sólo se crea la información lógica. Asimismo, si importa desde la línea de mandatos, por omisión, solamente se crea la información lógica en el nuevo conjunto de mensajes. Si desea que se cree información física también, consulte Importación de la línea de mandatos para obtener información detallada.

Las propiedades del formato físico XML y TDS no se rellenan, por lo tanto, acepte los valores por omisión.

Si tiene una o varias capas TDS, al importar puede que haya entradas en la lista de tareas que le avisen de que se deben establecer determinadas propiedades TDS si las estructuras COBOL que ha importado aparecen en un mensaje TDS.

Si los formatos físicos TDS no se pueden aplicar a las estructuras COBOL, puede ignorar estas entradas de la lista de tareas ya que simplemente son avisos y no impedirán que se genere el modelo en otro formato como, por ejemplo, un diccionario de mensajes.

Dado que se crea la información física, el entorno de destino de la aplicación (la plataforma y el compilador) es importante porque rige el modo en que, por ejemplo, aparecen los enteros en el mensaje. Puede especificar la información específica del entorno como parte de la operación de importación y las propiedades necesarias se establecerán en consecuencia. Hay un rango de entornos soportados. Si no aparece su entorno, debe seleccionar la coincidencia más cercana y revisar la información física creada utilizando el Editor de definiciones de mensajes después de haber completado la importación.

Invocación desde la línea de mandatos

El programa de utilidad de línea de mandatos mqsicreatemsgdefs le permite importar varios archivos Inicio del cambioCOBOLFin del cambio en una sola operación. Todos los archivos del libro de copias COBOL deben estar en un directorio individual y la ubicación del directorio se pasa como un parámetro al programa de utilidad.

Ha de proporcionar la información específica del entorno necesaria con un archivo XML. Este debe contener un elemento XML llamado<COBOL> que contiene un conjunto de información específica del entorno que se aplica a todos los archivos del libro de copias COBOL importados durante una invocación del programa de utilidad. Se proporciona un archivo XML por omisión denominado mqsicreatemsgdefs.xml. Si desea aplicar diferentes conjuntos de información a los diferentes archivos del libro de copias, tiene que 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 nuevo en los que se pueden colocar los archivos de definiciones de mensajes, como parte de la operación de importación. También puede optar por basar el conjunto de mensajes creado en un conjunto de mensajes existente. Este recurso le permite preparar un conjunto de mensajes vacío con un formato físico CWF rellenado previamente con las propiedades CWF a nivel de conjunto de mensajes que, a continuación, se copian en el conjunto de mensajes que ha creado la importación.

Conceptos relacionados
Conceptos de diseño de mensajes
Archivos de definiciones de mensajes
Importación de archivos de cabeceras C para crear definiciones de mensajes

Tareas relacionadas
Trabajar con un conjunto de mensajes
Crear un archivo de definiciones de mensajes
Importación desde Libros de copia COBOL
Importación de la línea de mandatos