Importación de archivos de cabecera C para crear definiciones de mensaje

Puede llenar el conjunto de mensajes con definiciones de mensaje importando archivos de cabecera C mediante la utilización del asistente para Nuevo archivo de definición de mensajes o del programa de utilidad de línea de mensajes mqsicreatemsgdefs.

Cada archivo de cabecera C 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 cabecera C, 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 cabecera C 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 cabecera C habrá una o varios estructuras C. 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 cuáles de las estructuras 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 cabecera C 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 cabecera C en cada operación de importación.

Si el archivo de cabecera C necesita otros archivos de cabecera para compilarse satisfactoriamente, deberá proporcionar dichos archivos y especificar su ubicación, porque se realiza una compilación del archivo de cabecera 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 C que ha importado deben aparecer en un mensaje TDS.

Si el formato físico TDS no es aplicable a las estructuras C, 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 de cabecera C en una sola operación. Todos los archivos de cabecera C deben ponerse en el mismo directorio y la ubicación de directorio se debe pasar como parámetro al programa de utilidad.

Deberá proporcionar la información específica de entorno necesaria e incluir información de ubicación de archivo utilizando un archivo XML. Éste debe contener un elemento XML denominado <C> que contenga un conjunto de información que se aplique a todos los archivos de cabecera C 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 diferentes archivos de cabecera, 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 este nuevo conjunto de mensajes 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 ya rellenadas, que a continuación se copia 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
ad00831_