Importación de libros de copias COBOL para crear definiciones de mensaje

Puede llenar el conjunto de mensajes con definiciones de mensaje importando archivos de libro de copias COBOL, utilizando el asistente para Nuevo archivo de definición de mensajes o el programa de utilidad de línea de mandatos 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 toma por omisión el nombre raíz del archivo de libro de copias COBOL, pero el asistente para Nuevo archivo de definición de mensajes le permite elegir un nombre de archivo raíz diferente.

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.

Por omisión, 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, residirán en la ubicación (valor por omisión) del espacio de trabajo. Este espacio de nombres por omisión se puede alterar temporalmente especificando un espacio de nombres de destino. Existen razones por las que es posible que desee llevar esto a cabo, consulte Espacios de nombre con mensajes no XML.

Normalmente en el archivo de libro de copias COBOL habrá una o varias estructuras de nivel 01. Puede seleccionar cuáles de estas estructuras se deben importar. Entonces la operación de importación importará esas 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 creará 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 definición de mensajes cuando se haya completado la importación.

Cuando esté realizando la importación utilizando el asistente para Nuevo archivo de definición de mensajes, sólo podrá importar un archivo de libro de copias COBOL con cada operación de importación. Si está realizando la importación utilizando el programa de utilidad de línea de mandatos, podrá 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.

Información física

Del mismo modo que crea información lógica, la importación también puede crear información física. Si el conjunto de mensajes contiene formatos físicos CWF (Formato físico personalizado), se rellenarán las propiedades de formato físico para todas las capas CWF. Si el conjunto de mensajes no contiene ningún formato físico CWF, sólo se crea información lógica. Asimismo, si realiza la importación desde la línea de mandatos, por omisión sólo se creará información lógica en el nuevo conjunto de mensajes. Si desea que también se cree información física, consulte el apartado Importación 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 por omisión.

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 un rango de entornos soportados; si no se muestra el entorno, deberá elegir el que coincida con mayor exactitud y revisar la información física creada utilizando el Editor de definición de mensajes después de que se haya completado la importación.

Invocación de línea de mandatos

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. Éste debe contener un elemento XML denominado <COBOL> que contiene un conjunto de información específica de entorno que se aplica a todos los archivos de 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 conjuntos diferentes de información a libros de copias diferentes, necesitará 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 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 le 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 creado por la importación.

Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
ad00832_