Inicio del cambio

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 WebSphere Message Broker instalado.

Plataformas soportadas

  • Windows
  • Sistemas Linux y UNIX
  • z/OS
Para configurar el entorno para que pueda ejecutar el mandato mqsipackagebar en máquinas que no tienen WebSphere Message Broker instalado, consulte Configuración de entornos que no tienen instalado el componente de intermediario.

Finalidad

Puede utilizar el mandato mqsipackagebar para crear archivos BAR en máquinas que no tienen WebSphere Message Broker instalado. Asimismo, si utiliza un repositorio para almacenar los flujos de mensajes y los diccionarios, puede escribir scripts para desplegar las aplicaciones de flujo de mensajes utilizando el mandato mqsipackagebar y las herramientas de línea de mandatos que están disponibles en el repositorio.

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.

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.

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

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 en los directorios -w (ubicación raíz), -a (ubicación de archivo BAR) y -v (ubicación de archivo de rastreo).

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.

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, 2012Copyright IBM Corporation 1999, 2012.

        
        Última actualización
        
        Última actualización : 2012-07-13 19:57:09


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


Fin del cambio