WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

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 que utilicen el mandato mqsicreatebar y las herramientas de línea de mandatos del depósito para desplegar sus aplicaciones de flujo de mensajes.

Sintaxis

Leer el esquema de sintaxisOmitir el esquema de sintaxis visual
>>-mqsicreatebar-- -data -EspacioTrabajo--+----------------+---->
                                          '- -b -NombreBar-'   

>--+--------------+--+-------------------------+---------------->
   '- -cleanBuild-'  '- -version -SerieVersión-'   

>--+----------+--+-----------------------------+---------------->
   '- -Esql21-'  |      .--------------------. |   
                 |      V                    | |   
                 '- -p -----NombreProyecto---+-'   

>--+----------------------+--+------------------+--------------->
   '- -a -ApplicationName-'  '- -deployAsSource-'   

>--+---------------+--+-----------------------+----------------->
   '- -compileOnly-'  '- -l -NombreBiblioteca-'   

>--+------------------------------+----------------------------->
   '- -d -NombreDominioAplicación-'   

>--+-----------------------+--+--------------------+------------>
   '- -o -VíaAccesoArchivo-'  '- -skipWSErrorCheck-'   

>--+---------------------------------------+-------------------><
   '- -trace - -v -víaAccesoArchivoRastreo-'   

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
(Opcional) El nombre del archivo archivador (formato de archivo comprimido) BAR donde se almacena el resultado. El archivo BAR se sustituye si ya existe y se crea el archivo META-INF/broker.xml.

Este parámetro es necesario si no se utiliza el parámetro -compileOnly.

-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.

-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'

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

Cuando se utiliza el mandato mqsicreatebar, los recursos como los archivos .esql se compilan en archivos .cmf de flujo de mensajes y no se añaden al archivo BAR como archivos de origen individuales. Si se incluye este parámetro, crea ESQL en línea, en lugar de ESQL desplegable del valor predeterminado.

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.

No puede incluir la versión compilada (.cmf) y la versión de origen (.msgflow) de un flujo de mensajes en un archivo BAR.

-compileOnly
(Opcional) Incluya este parámetro para compilar conjuntos de mensajes y código Java™ antes de ejecutar el mandato mqsipackagebar. Se compilan todos los archivos relevantes en el espacio de trabajo que se especifica mediante el parámetro -data. Para obtener más información sobre el mandato mqsipackagebar, consulte Mandato mqsipackagebar.

Si se especifica este parámetro con el parámetro -b y uno o más de los parámetros -a, -l, -d o -o, el mandato genera tanto los recursos compilados como el archivo BAR especificado.

-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'

-d NombreDominioAplicación
(Opcional) Nombre de un dominio de aplicación .NET que se debe añadir al archivo BAR.

Puede añadir más de un dominio de aplicación utilizando el formato siguiente: -d NombreDominioAplicación1 NombreDominioAplicación2 .... NombreDominioAplicación1'n'

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

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

-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.
-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.

-v víaAccesoArchRastreo
(Opcional) Este parámetro especifica el nombre de archivo del registro de salida al que se envía la información de rastreo.

Si especifica el nombre o la vía de acceso relativa del archivo, el archivo se crea en el directorio de trabajo predeterminado. Para utilizar este parámetro, también debe establecer el parámetro -trace. No puede especificar el parámetro -v solo.

Autorización

En sistemas Windows XP y Windows Server 2003, el ID de usuario utilizado para ejecutar este mandato debe ser miembro del grupo mAdministradores 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 elevados 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

Puede ejecutar el mandato mqsicreatebar desde una ventana abierta en cualquier lugar de la estructura de archivos siempre que la variable de entorno PATH especifique la vía de acceso correcta al directorio WMB toolkit.
  • En ediciones de 32 bits de Windows, la ubicación predeterminada del directorio WMB toolkit es C:\Archivos de programa\IBM\WMBT800
  • En ediciones de 64 bits de Windows, el valor predeterminado es C:\Program Files (x86)\IBM\WMBT800, y
  • En Linux en x86, el valor predeterminado es /opt/IBM/WMBT800.
Es posible que su instalación sea distinta a la instalación predeterminada.

El parámetro -b especifica el nombre del archivo BAR y una vía de acceso alternativa opcional para la generación de archivos BAR. Cuando no se especifica una vía de acceso como parte del parámetro -b, la ubicación en la estructura de archivo donde se ejecuta el mandato mqsicreatebar especifica dónde se crea el archivo BAR. Por ejemplo, si está actualmente en C:\> y ejecuta el mandato mqsicreatebar, el archivo BAR se crea en C:\. Sin embargo, si ejecuta mqsicreatebar especificando -b c:\myfiles\myflow.bar, el archivo BAR se crea en el directorio myfiles.

El ejemplo siguiente crea un archivo BAR denominado myflow.bar en el directorio donde se emite el mandato. El flujo de mensajes Test.msgflow del TestFlowProject se añade al archivo BAR como un archivo de flujo de mensajes compilado (.cmf).
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 directorio myfiles. 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 C:\myfiles\myflow.bar -p TestFlowProject -o TestFlowProject\TestFlow\Test.msgflow -deployAsSource
El ejemplo siguiente crea un archivo BAR denominado mySet.bar. 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. El conjunto de mensajes messageSet.mset del TestSetProject y el flujo de mensajes Test.msgflow del TestFlowProject se añaden al archivo BAR. El flujo de mensajes se añade como un archivo de flujo de mensajes compilado (.cmf).
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. La aplicación Aplicación1 se añade al archivo BAR y la función de rastreo se activa.
mqsicreatebar -data C:\Workspace -b myflow.bar -a Aplicación1 -trace
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última actualización:
        
        Última actualización: 2015-02-28 17:00:08


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