Mandato mqsicreatebar

Utilice el mandato mqsicreatebar para crear archivos archivadores de intermediario desplegables (BAR) que contienen flujos de mensajes y diccionarios.

Plataformas soportadas

  • Windows
  • Linux en x86

Finalidad

Si utiliza un depósito para almacenar los flujos de mensajes y diccionarios, puede escribir scripts para desplegar las aplicaciones de flujo de mensajes utilizando el mandato mqsicreatebar y las herramientas de línea de mandatos del depósito.

Sintaxis

Formato del diagrama de sintaxis      Diagrama de vía      Decimal con puntos

Parámetros

-data EspacioTrabajo
(Necesario) La vía de acceso del espacio de trabajo en el que se crean sus proyectos.

La ubicación del espacio de trabajo es también la ubicación predeterminada de los proyectos. Las vías de acceso relativas se interpretan como relativas al directorio desde el que se ha iniciado el mandato.

-b NombreBar
(Necesario) El nombre del archivo archivador BAR (formato de archivo comprimido) donde se almacena el resultado. El archivo BAR se sustituye si ya existe y se crea el archivo META-INF/broker.xml.
-cleanBuild
(Opcional) Renueva los proyectos en el espacio de trabajo y, a continuación, invoca una compilación limpia antes de añadir nuevos elementos al archivo BAR.
Utilice el parámetro -cleanBuild para renovar todos los proyectos en el archivo BAR y ejecutar una compilación limpia si se han realizado modificaciones en los recursos del archivo BAR, utilizando herramientas externas.
-version SerieVersión
(Opcional) Añade el carácter _ (subrayado) y el valor de SerieVersión a los nombres de las versiones compiladas de los archivos de flujos de mensajes (.cmf) añadidos al archivo BAR, antes de la extensión de archivo.
-Esql21
(Opcional) Compilar ESQL para intermediarios de la versión 2.1 del producto.
-p NombreProyecto
(Opcional) Proyectos que contienen archivos a incluir en el archivo BAR de un espacio de trabajo nuevo. Un espacio de trabajo nuevo es una carpeta del sistema sin la carpeta .metadata.

Los proyectos definidos ya deben existir en la carpeta definida en el parámetro -data, y deben incluir todos los proyectos y los proyectos de referencia que un recurso desplegable, definido en el parámetro -o, necesita.

El parámetro -p es opcional con un espacio de trabajo existente, pero debería utilizar -p, junto con un espacio de trabajo nuevo, en un entorno de compilación.

Si especifica un proyecto que es parte de su espacio de trabajo pero que actualmente está cerrado, el mandato abre y crea el proyecto para que los archivos del proyecto puedan incluirse en el archivo BAR.

-o VíaAccesoArchivo
(Opcional) La vía de acceso relativa del espacio de trabajo (incluido el proyecto) de un archivo msgflow o messageSet.mset que se debe añadir al archivo BAR.

Puede añadir más de un archivo desplegable en este mandato utilizando el formato siguiente: -o VíaAccesoArchivo1 VíaAccesoArchivo2 .... VíaAccesoArchivo'n'

-a NombreAplicación
(Opcional) Nombre de la aplicación que se añadirá al archivo BAR.

Puede añadir más de una aplicación utilizando el formato siguiente: -a NombreAplicación1 NombreAplicación2 .... NombreAplicacion'n'

-l NombreBiblioteca
(Opcional) Nombre de una biblioteca que se añadirá al archivo BAR.

Puede añadir más de una biblioteca utilizando el formato siguiente: -l NombreBiblioteca1 NombreBiblioteca2 .... NombreBiblioteca'n'

-deployAsSource
(Opcional) Incluya este parámetro para desplegar los archivos de recusos aplicables sin compilarlos.

Al utilizar el mandato mqsicreatebar, los recursos tales como los archivos .esql se compilan en archivos .cmf de flujos de mensajes y no sa añaden al archivo BAR como archivos de origen individuales.

Cuando se utiliza el parámetro -deployAsSource, todos los recursos aplicables se añaden al archivo BAR como archivos de origen, y no se compilan en archivos .cmf de flujos de mensajes.

-trace
(Opcional) Este parámetro muestra la información de rastreo para una compilación de archivo BAR.

El parámetro -trace escribe información de rastreo en la corriente de datos de salida del sistema, en el lenguaje especificado por el entorno local del sistema. Cuando añade una o más aplicaciones o bibliotecas al archivo BAR, la aplicación o biblioteca especificada y todos los proyectos referenciados se abren en el espacio de trabajo. La función de rastreo registra esta información para que pueda ver si falta algún proyecto referenciado.

-skipWSErrorCheck
(Opcional) Este parámetro fuerza la ejecución del proceso de compilación del archivo BAR, incluso si existen errores en el espacio de trabajo.

Autorización

En los sistemas Windows XP y Windows Server 2003, el ID de usuario que se utiliza para ejecutar este mandato debe ser miembro del grupo Administradores en el sistema local.

En sistemas Windows 7 y Windows Server 2008, el ID de usuario utilizado para ejecutar este mandato debe ejecutarse con privilegios ampliados en el sistema local:
  • El ID de usuario debe ser miembro del grupo Administradores.
  • El mandato debe iniciarse desde un entorno que tenga la autorización Ejecutar como administrador.

Si no ejecuta el mandato desde un entorno con privilegios, se le solicitará que confirme si desea continuar. Cuando pulse Aceptar, se creará una nueva consola de mandatos con privilegios y se completará el mandato, aunque todas las respuestas escritas en el entorno de privilegio se perderán cuando la consola se cierre al finalizar el mandato.

En Linux en x86, el ID de usuario debe tener acceso de grabación a los directorios -data (espacio de trabajo) y -b (ubicación del archivo BAR).

Respuestas

Este mandato devuelve las siguientes respuestas:
  • BIP0956 No se ha podido iniciar el mqsicreatebar
  • BIP0957 Se han suministrado argumentos incorrectos a mqsicreatebar
  • BIP0958 Nada que hacer en mqsicreatebar
  • BIP0959 Se han suministrado argumentos incorrectos a mqsicreatebar (Nombre de proyecto)
  • BIP0960 Se han suministrado argumentos incorrectos a mqsicreatebar (Directorio de proyecto)
  • BIP0961 Error al abrir el espacio de trabajo en mqsicreatebar (No se ha podido crear el proyecto)
  • BIP0962 Error al abrir el espacio de trabajo en mqsicreatebar (No se ha podido abrir el proyecto)
  • BIP0963 Error al guardar el archivo en mqsicreatebar
  • BIP0964 Se ha suministrado el argumento incorrecto "-o" a mqsicreatebar
  • BIP0965 Error al compilar archivos en mqsicreatebar

Ejemplos

Debe ejecutar el mandato desde el directorio eclipse. La ubicación predeterminada del directorio eclipse es C:\Archivos de programa\IBM\WMBT800\eclipse en ediciones Windows de 32 bits, C:\Archivos de programa (x86)\IBM\WMBT800\eclipse en ediciones Windows de 64 bits y /opt/IBM/WMBT800/eclipse en Linux en x86.

El ejemplo siguiente crea un archivo BAR denominado myflow.bar en el espacio de trabajo en C:\Workspace. El flujo de mensajes Test.msgflow del TestFlowProject se añade al archivo BAR.
mqsicreatebar -data C:\Workspace -b myflow.bar -p TestFlowProject -o TestFlowProject\TestFlow\Test.msgflow
El ejemplo siguiente crea un archivo BAR denominado myflow.bar en el espacio de trabajo en C:\Workspace. El flujo de mensajes Test.msgflow del TestFlowProject se añade al archivo BAR y todos los archivos de recursos aplicables se añaden al archivo BAR sin que se compilen.
mqsicreatebar -data C:\Workspace -b myflow.bar -p TestFlowProject -o TestFlowProject\TestFlow\Test.msgflow -deployAsSource
El ejemplo siguiente crea un archivo BAR denominado mySet.bar en el espacio de trabajo en C:\Workspace. El conjunto de mensajes messageSet.mset del TestSetProject se añade al archivo BAR.
mqsicreatebar -data C:\Workspace -b mySet.bar -o TestSetProject\TestSet\messageSet.mset
El ejemplo siguiente crea un archivo BAR denominado mySet.bar en el espacio de trabajo en C:\Workspace. El conjunto de mensajes messageSet.mset del TestSetProject y el flujo de mensajes Test.msgflow del TestFlowProject se añaden al archivo BAR.
mqsicreatebar -data C:\Workspace -b mySet.bar -o TestFlowProject\TestFlow\Test.msgflow
TestSetProject\TestSet\messageSet.mset 
El ejemplo siguiente crea un archivo BAR denominado myflow.bar en el espacio de trabajo en C:\Workspace. La aplicación Aplicación1 se añade al archivo BAR. La función de rastreo se activa.
mqsicreatebar -data C:\Workspace -b myflow.bar -a Aplicación1 -trace
Avisos | Marcas registradas | Este enlace se abre en una nueva ventana Descargas | Este enlace se abre en una nueva ventana Biblioteca | Este enlace se abre en una nueva ventana Soporte | Comentarios

Copyright IBM Corporation 1999, 2011Copyright IBM Corporation 1999, 2011.

        
        Última actualización
        
        Última actualización : 2011-11-07 13:56:17


Tema de referenciaTema de referencia | Versión 8.0.0.0 | an19540_