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 mqsipackagebar

Utilice el mandato mqsipackagebar para crear archivos archivador de intermediario (BAR) desplegables. Puede utilizar este mandato para crear archivos BAR en máquinas que no tienen el WebSphere Message Broker Toolkit instalado.

Plataformas soportadas

Para configurar el entorno para que pueda ejecutar el mandato mqsipackagebar en máquinas que no tienen WebSphere Message Broker instalado, consulte Configurar entornos sin el componente de intermediario instalado.

Finalidad

Si utiliza un depósito para almacenar los flujos de mensajes y diccionarios, puede escribir scripts que utilicen el mandato mqsipackagebar y las herramientas de línea de mandatos que están disponibles en el repositorio para desplegar sus aplicaciones de flujo de mensajes.

Los recursos que añade a un archivo BAR utilizando el mandato mqsipackagebar no se compilan cuando se añaden. Para desplegar un archivo BAR que se crea mediante este mandato, debe añadir recursos desplegables en el archivo BAR. Por ejemplo, si desea incluir código Java™ o conjuntos de mensajes en el archivo BAR, primero debe compilar estos archivos antes de utilizar el mandato mqsipackagebar para añadirlos al archivo BAR. Para compilar estos recursos, consulte Compilar recursos para el mandato mqsipackagebar. No puede incluir la versión compilada (.cmf) y la versión de origen (.msgflow) de un flujo de mensajes en un archivo BAR.

No utilice los caracteres siguientes en los nombres de recursos que desee incluir en el archivo BAR:
  • (espacio) ! ( ) + - : ; < = > ? [ ] ’ } {

Sintaxis

Leer el esquema de sintaxisOmitir el esquema de sintaxis visual
>>-mqsipackagebar-- -a -NombreBar--+---------------------+------>
                                   '- -w --UbicaciónRaíz-'   

   .-----------------------------------------------.   
   |           .----------------------.            |   
   V           V                      |            |   
>------+- -o ------VíaAccesoArchivo---+--------+---+------------>
       |       .----------------------.        |       
       |       V                      |        |       
       +- -k ------NombreAplicación---+--------+       
       |       .----------------------.        |       
       |       V                      |        |       
       +- -y ------NombreBiblioteca---+--------+       
       |       .-----------------------------. |       
       |       V                             | |       
       '- -n ------NombreDominioAplicación---+-'       

>--+------+--+------+--+-------------------------------+-------><
   +- -u -+  '- -i -'  '- -v --víaAccesoArchivoRastreo-'   
   '- -d -'                                                

Parámetros

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

-w UbicaciónRaíz
(Opcional) La ubicación predeterminada para los proyectos que desea incluir en el archivo BAR. Las vías de acceso relativas se interpretan como relativas a UbicaciónRaíz. Si no define UbicaciónRaíz, las vías de acceso relativas se interpretan como relativas al directorio desde el que se ha iniciado el mandato.

-o VíaAccesoArchivo
(Opcional) La vía de acceso (incluido el proyecto) de un archivo desplegable que se debe añadir al archivo BAR; por ejemplo archivos .msgflow, .subflow o messageSet.dictionary. Las vías de acceso relativas se interpretan como relativas a la vía de acceso que ha definido para UbicaciónRaíz. Si no define UbicaciónRaíz, las vías de acceso relativas se interpretan como relativas al directorio desde el que se ha iniciado el mandato.

Cuando se utilizan juntas, la opción -o especifica la vía de acceso a los archivos desplegables y la opción -w especifica la vía de acceso al directorio del proyecto. Por ejemplo, mqsipackagebar -w c:/MyProject -a MyBar.bar -o Flow/a.msgflow Subflow/b.subflow especifica una UbicaciónRaíz de directorio MyProject con la VíaAccesoArchivo que especifica los archivos desplegables a y b en los directorios Flow y Subflow.

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

De forma predeterminada sólo se incluyen en el archivo BAR los archivos con las siguientes extensiones: .xsdzip, .tblxmi, .xsd, .wsdl, .dictionary, .xsl, .xslt, .xml, .jar, .inadapter, .outadapter, .insca, .outsca, .descriptor, .php, .idl, .map, .esql, .msgflow y .subflow. Puede especificar la opción -i para incluir archivos con cualquier extensión.

-k 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: -k NombreAplicación1 NombreAplicación2 .... NombreAplicación'n'

De forma predeterminada sólo se incluyen en el archivo BAR los archivos con las siguientes extensiones: .xsdzip, .tblxmi, .xsd, .wsdl, .dictionary, .xsl, .xslt, .xml, .jar, .inadapter, .outadapter, .insca, .outsca, .descriptor, .php, .idl, .map, .esql, .msgflow y .subflow. Puede especificar la opción -i para incluir archivos con cualquier extensión.

-y 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: -y NombreBiblioteca1 NombreBiblioteca2 .... NombreBiblioteca'n'

De forma predeterminada sólo se incluyen en el archivo BAR los archivos con las siguientes extensiones: .xsdzip, .tblxmi, .xsd, .wsdl, .dictionary, .xsl, .xslt, .xml, .jar, .inadapter, .outadapter, .insca, .outsca, .descriptor, .php, .idl, .map, .esql, .msgflow y .subflow. Puede especificar la opción -i para incluir archivos con cualquier extensión.

-n 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: -n NombreDominioAplicación1 NombreDominioAplicación2 .... NombreDominioAplicación'n'

Todos los archivos del dominio de aplicación especificado se incluyen en el archivo BAR.

-u
(Opcional) Incluir esta opción para actualizar los recursos en un archivo BAR existente.

Especifique los recursos que desea actualizar utilizando las opciones -o, -k, -y y -n. Si el archivo BAR no existe, se crea un nuevo archivo.

-d
(Opcional) Incluya esta opción para suprimir recursos de un archivo BAR existente.

Especifique los recursos que desea suprimir utilizando las opciones -o, -k, -y y -n.

-i
(Opcional) Incluya esta opción para añadir recursos desplegables y no desplegables al archivo BAR.

Si utiliza esta opción, todos los archivos especificados por las opciones -o, -k, -y y -n se incluyen en el archivo BAR. Si no utiliza esta opción, sólo se añaden al archivo BAR los archivos desplegables de las ubicaciones especificadas.

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

Autorización

Para obtener información sobre las autorizaciones específicas de cada plataforma, consulte los temas siguientes: Si ha habilitado la seguridad de administración del intermediario, también debe establecer la autorización que se detalla en Tareas y autorizaciones para la seguridad de administración.

Respuestas

Este mandato devuelve las siguientes respuestas:
  • BIP1838I Empaquete un archivo archivador de intermediario de origen.
  • BIP1839S 'Opción' no se ha especificado.
  • BIP1840S No se han encontrado recursos válidos para añadir al archivo BAR. Compruebe que UbicaciónRaíz es correcta y especifique al menos un recurso utilizando una o varias de las opciones que -k, -y, -n u -o.
  • BIP1841S 'víaAccesoArchivoRastreo' no es una vía de acceso de archivo de rastreo válida.
  • BIP1842S No se puede abrir el archivo de rastreo 'víaAccesoArchivoRastreo'. Error: 'error'.
  • BIP1843S El archivo de rastreo 'víaAccesoArchivoRastreo' es de sólo lectura.
  • BIP1844S Se ha alcanzado un final inesperado de argumento.
  • BIP1845I El mandato se ha completado satisfactoriamente.
  • BIP1846S La opción de actualización (-u) y la opción de supresión (-d) no se pueden utilizar simultáneamente.
  • BIP1847S El archivo archivador de intermediario 'archivo_BAR' no existe.
  • BIP1848S El archivo 'archivo_flujo_mensajes' contiene un nodo no soportado: 'Nombre_nodo'.
  • BIP1849W La aplicación 'Aplicación' hace referencia al proyecto 'Biblioteca' que no existe.
  • BIP1862W Se ignora el recurso no válido u omitido: 'Recurso'
  • BIP1863W El mandato se ha completado con avisos.
  • BIP1864W El archivo de archivado de intermediario generado no contiene archivos desplegables de Message Broker.
  • BIP1865W 'recurso_contenedor' no se añade al archivo BAR porque no contiene recursos desplegables. Para crear recursos desplegables para código Java o conjuntos de mensajes, utilice el mandato mqsicreatebar -compileOnly mqsicreate.
  • BIP1866W El proyecto de referencia 'proyecto_referencia' no contiene recursos desplegables. Para crear recursos desplegables para código Java o conjuntos de mensajes, utilice el mandato mqsicreatebar -compileOnly mqsicreate.
  • BIP1867W No se puede añadir 'Archivo_flujo_mensajes' al archivo BAR, porque este flujo ya está en el archivo BAR como un archivo (.cmf) compilado. Suprima 'Archivo_flujo_mensajes_compilado' del archivo BAR utilizando la opción -d e inténtelo de nuevo.
  • BIP1868W: Se ignora 'Nombre_recurso', que se encuentra en la aplicación 'Aplicación'. Utilice la opción -k para incluir la aplicación.
  • BIP1869W: Se ignora 'Nombre_recurso', que se encuentra en la biblioteca 'Biblioteca'. Utilice la opción -y para incluir la biblioteca.
  • BIP1870W: Se ignora 'Nombre_recurso', que se encuentra en el proyecto de dominio de aplicación .NET 'Dominio_aplicación'. Utilice la opción -n para incluir el proyecto de dominio de aplicación.

Ejemplos

El ejemplo siguiente crea un archivo BAR denominado myflow.bar en el espacio de trabajo en C:\Workspace. El flujo de mensajes Test.msgflow se añade al archivo BAR sin compilarse.
mqsipackagebar -w C:\Workspace -a myflow.bar -o TestFlowProject\TestFlow\Test.msgflow
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. Se activa la función de rastreo y se graba la información de rastreo en el archivo tracefile.
mqsipackagebar -w C:\Workspace -a myflow.bar -k Application1 -v tracefile
Puede ejecutar mqsipackagebar desde un script Ant, por ejemplo, si desea crear archivos BAR en una máquina de construcción. En el ejemplo siguiente MQSI_JARPATH es la ubicación de los archivos .jar dependientes de intermediario y ConfigMAnagerProxy:
<target name="run_mqsipackagebar" description="--> runs mqsipackagbar from an ant task">
   <java classname="com.ibm.broker.config.appdev.FlowRendererBAR"
      failonerror="true"
      fork="true">
         <arg line="-a MyBAR.bar"/>
         <arg line="-k MyApplication"/>
         <classpath>
            <fileset dir="${MQSI_JARPATH}">
                <include name="*.jar"/>
            </fileset>
         </classpath>
   </java>
</target>
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:01:00


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