Creacin de un archivo archivador de

intermediario (BAR)
Cree un archivo BAR (Broker Archive) para cada configuracin que desee desplegar en los servidores de
integracin de sus intermediarios.
Antes de empezar:
Cuando crea un archivo BAR, de forma predeterminada se crea en un proyecto de integracin denominado
BARfiles. Puede elegir una ubicacin alternativa cuando utilice el asistente Nuevo archivo BAR, pero
tambin puede personalizar la ubicacin predeterminada para los archivos BAR que cree.
1. Pulse Ventana > Preferencias.
2. Expanda Desarrollo de integracin y luego seleccione Compilar archivador de intermediario.
El comportamiento predeterminado es crear archivos BAR en el proyecto llamado BARfiles. Puede cambiar
el nombre del proyecto predeterminado. De forma alternativa, puede elegir crear archivos BAR en cualquier
aplicacin, biblioteca o proyecto de integracin que est seleccionado en la vista Desarrollo de aplicacin
cuando abra el asistente Nuevo archivo BAR.
Puede crear un archivo BAR de tres maneras:

Utilizacin de IBM Integration Toolkit

Utilizacin del mandato mqsipackagebar

Utilizacin del mandato mqsicreatebar

Utilizacin de IBM Integration Toolkit

Siga estos pasos para crear un archivo BAR utilizando IBM Integration Toolkit:
1. Pulse Archivo > Nuevo > Archivo BAR.
2. Seleccione la ubicacin para el archivo BAR.
La ubicacin predeterminada depende de las preferencias que haya establecido; para obtener ms
informacin, consulte la seccin Antes de empezar de este tema. Puede seleccionar una
aplicacin, biblioteca o proyecto de integracin existente, o puede crear un nuevo proyecto de
integracin pulsando Nuevo.
3. Entre un nombre para el archivo BAR que est creando.
4. Pulse Finalizar.
Se crea un archivo con una extensin .bar, que se muestra bajo la aplicacin, biblioteca o proyecto de
integracin, en una carpeta llamada BARs. Se abre el editor de archivos BAR. Todos los archivos BAR
tambin se muestran en una categora aparte en la vista Desarrollo de aplicacin llamada BARs. Cada
archivo BAR listado muestra informacin sobre el proyecto en el que est almacenado el archivo BAR.

Utilizacin del mandato mqsipackagebar

Antes de empezar:
Si desea utilizar el mandato mqsipackagebar para crear el archivo BAR, debe compilar los conjuntos de
mensajes o el cdigo Java antes de crear el archivo BAR..
Puede crear archivos archivador intermediario (BAR) en mquinas que no tienen IBM Integration Bus
instalado, utilizando el mandato mqsipackagebar..
Cuando cree archivos BAR utilizando el mandato mqsipackagebar, aada recursos desplegables para
asegurarse de que el archivo BAR se puede desplegar.
Para crear un archivo BAR utilizando el mandato mqsipackagebar, realice los pasos siguientes:
1. Abra una ventana de mandatos configurada para su entorno.
2. Entre el mandato, escrito en una sola lnea. Por ejemplo:
mqsipackagebar -a nombreBar -k nombresAplicaciones -v archivoRastreo
Debe especificar el parmetro -a (nombre de archivo BAR). El parmetro -k (nombres de aplicacin)
es opcional. Tambin puede utilizar el parmetro -o para especificar la va de acceso para un
archivo especfico o el parmetro -y para especificar una biblioteca..
Para ver informacin de rastreo para el despliegue de archivo BAR, aada el parmetro -v.
Se crea un archivo con la extensin .bar.

Utilizacin del mandato mqsicreatebar

Siga estos pasos para crear un archivo BAR utilizando el mandato mqsicreatebar:
1. Abra una ventana de mandatos configurada para su entorno.
2. Entre el mandato, escrito en una sola lnea. Por ejemplo:
mqsicreatebar -b integrador -a Integrador -trace
Debe especificar el parmetro -b (nombre de archivo BAR). El parmetro -a (nombres de
aplicaciones) es opcional. Tambin puede utilizar el parmetro -o para especificar la ruta para un
archivo especfico, o el parmetro -l para especificar una biblioteca.
Si ha realizado cambios en recursos del archivo BAR utilizando herramientas externas, aada el
parmetro -cleanBuild para renovar todos los proyectos e invocar una compilacin limpia.
Para ver informacin de rastreo para el despliegue de archivo BAR, aada el parmetro -trace. Para
forzar la compilacin del archivo BAR si hay errores en el espacio de trabajo, aada el parmetro
-skipWSErrorCheck.
Se crea un archivo con la extensin .bar.

Adicin de archivos a un archivador de intermediario

Paradesplegararchivosaunservidordeintegracin,primerodebeincluirlosenunarchivoarchivadordeintermediario
(BAR).
Lossubflujosquesedefinenenarchivos.msgflownosevisualizanenelarchivoBARcomoelementosseparados,yse
aadenautomticamente.Paraincluirestossubflujos,deberaadirnicamenteelflujopadre.Lossubflujosquese
definenenarchivos.subflowsevisualizanenelarchivoBARcomoelementosseparadosypuedendesplegarsecomo
recursosindividuales.Siseaadeunflujopadrequecontieneestossubflujos,lossubflujosseaadenalarchivoBAR
automticamentecuandosecreaelarchivoBAR.
Puedeaadirarchivosdeflujo,DLL,ESQL,JavaJAR,PHP,MAP,XML,XSLTyconjuntosdemensajes
manualmentesiguiendoestospasos.Sinembargo,losarchivosJARolosensamblados.NET(archivosDLL)necesarios
paralosnodosJavaComputeolosnodos.NETComputedelosflujosdemensajesseaadenautomticamentedesdeel
proyectoJavaoelproyectodeintegracincuandoseaadeelflujodemensajes.LosarchivosXMLyXSLtambinse
aadenautomticamentesilosnecesitaelflujo.
Cuando se aade un flujo de mensajes (definido en un archivo .msgflow) a un archivo BAR, puede aadir el flujo como
un archivo .msgflow o aadirlo como un flujo de mensajes compilado (definidos en un archivo .cmf). Seleccione
Compilar e incorporar recursos para aadir flujos como archivos .cmf. No puede aadir el mismo flujo de mensajes a un
archivo BAR como archivo .cmf y como archivo .msgflow. Si el flujo contiene uno de los nodos siguientes, no puede
aadir el flujo como un archivo .msgflow:

Un nodo definido por el usuario que se crea a partir de un subflujo

Un nodo de subflujo que representa un subflujo definido en un archivo .msgflow

Un nodo WebSphere Message Broker versin 7.0 Mapping

Un nodo MQOptimizedFlow

SiseleccionaCompilareincorporarrecursos,seincorporacdigoESQLenelarchivo.cmfquehacereferenciaal.Si
noseleccionaCompilareincorporarrecursos,seaadenarchivosESQLalarchivoBARcomorecursosindividuales.
TengaencuentaquesielarchivoBARcontieneunacombinacinderecursoscompiladosyrecursosnocompilados,es
posiblequeseproduzcanresultadosinesperados.Porejemplo,siseleccionalaopcinCompilareincorporarrecursos
paracrearunarchivoBARquecontieneunarchivoESQLyunflujodemensajes,seincorporaelESQLenelarchivo
deflujodemensajescompilado(.cmf).SiacontinuacinactualizaelESQLyloaadealarchivoBARconlaopcin
Compilareincorporarrecursosdeseleccionada,elarchivo.cmfutilizaelESQLoriginalporqueelESQLoriginal
continaincorporadoenelarchivo.cmf.Paraasegurarsedequetodoslosrecursosestncompiladosonocompilados,
alcambiarlaopcinCompilareincorporarrecursosseleccionetambinEliminarcontenidodelarchivadorde
intermediarioantesdelacompilacinyvuelvaacompilarelarchivoBAR.
NoesnecesariovolveradesplegarlosarchivosJAR,amenosqueloshayaactualizado.SiunoomsarchivosJARdel
archivoBARestnpresentesenelsistemaenelqueseejecutaelintermediario,puedeeliminarlosdelarchivoBAR
antesdevolveraefectuareldespliegue.LosarchivosJARdisponiblesparaelintermediarioincluyenarchivosJARque
hadesplegadoyarchivosJARqueexistenenlosdirectoriosdeclasescompartidasoelsubdirectorioclassesdel
directoriodeinstalacin.Porejemplo,losarchivoscom.ibm.mq.jar,ConfigManagerProxy.jar,jplugin2.jary
javacompute.jarsonsiemprevisiblesparaelintermediarioynotienenquedesplegarseporseparado.
Nosepuedenvolveraleerlosarchivosdesplegadosdesdelosservidoresdeintegracindelintermediario.Porlotanto,
guardeunacopiadelarchivoBARdesplegadoodelosarchivosindividualesquecontiene.
ParaaadirarchivosaunarchivoBARutilizandoIBMIntegrationToolkit,realicelospasossiguientes.
1.

Abra el archivo BAR pulsando dos veces sobre l. El contenido del archivo BAR aparece en el Editor de
archivador de intermediario. (Si el archivo BAR es nuevo, esta vista estar vaca.)

2.

En la pgina Preparar del Editor de archivador de intermediario, seleccione recursos de espacio de trabajo
desplegables para aadirlos al archivo BAR.
SeleccioneAplicacionesparaverunalistadeaplicacionesquepuedendesplegarse.Siseleccionauna
aplicacin,todoslosrecursosincluidossedesplieganconesaaplicacin.Losrecursosquesedesplieganen
unaaplicacinestnaisladosdelosrecursosdeotrasaplicaciones.Paradesplegarlosrecursosdirectamenteal
servidordeintegracin,pulseFlujosdemensajes,bibliotecasyotrasdependenciasdeflujosdemensajes.Una
vezdesplegadosestosrecursos,sevisualizanparatodoslosotrosrecursosdesplegadosenelmismoservidor
deintegracin.
Puedeseleccionarunrecursoindividual(aplicacin,biblioteca,dominiodeaplicacin.NET,orecursode
proyecto)paraaadirloalarchivoBAR,opuedeaadirtodaslasaplicaciones,bibliotecas,dominiosde
aplicacin.NETorecursosdeproyectoenelespaciodetrabajoseleccionandoelelementorazapropiado.Sila
aplicacinqueseleccionahacereferenciaaunaomsbibliotecas,esasbibliotecasseaadenalarchivode
aplicacin.appzipcomoarchivos.libzipanidados.Estasbibliotecasreferenciadassonprivadasynoestn
disponiblespararecursosexternosalaaplicacin.Porlotanto,dichasbibliotecasnoseseleccionandeforma
predeterminadaenlapginaPreparar.Sideseadesplegarunabibliotecacomounabibliotecadelnivelde
servidordeintegracin,alaquepuedenaccederotrosrecursos,seleccionelabibliotecaparadesplegarlapor
separado.Secreaunarchivo.libzipparaesabibliotecayseaadealarchivoBARanivelraz.
Siseleccionaunabibliotecaquehacereferenciaaotrasbibliotecas,esasbibliotecasreferenciadastambinse
aadenalarchivoBARcomoarchivos.libzip.
Silaaplicacinqueseleccionahacereferenciaaunoomsdominiosdeaplicacin.NET,dichosdominiosde
aplicacinseaadenalarchivoBARanivelderazcomounarchivo.appdomainzip.

3.

Opcional: para incluir archivos de origen, seleccione Aadir archivos de origen de proyecto de espacio de
trabajo.
SiseleccionaAadirarchivosdeorigendeproyectodeespaciodetrabajo,seaadenproyectosdeorigenpara
todaslasaplicaciones,bibliotecasyotrosrecursoscompiladosalacarpetasrcdelarchivoBAR.

4.

Opcional: para quitar contenido existente del archivo BAR antes de crear un nuevo archivo BAR, seleccione
Quitar contenido del archivo de archivador de intermediario antes de crear.

5.

Opcional: si est aadiendo un flujo de mensajes a un archivador de intermediario por segunda vez y ha
utilizado la pgina Gestionar para cambiar parmetros de flujo, seleccione Alterar valores de propiedades
configurables para restablecer los valores de la configuracin. Si este control se deselecciona, los valores
existentes permanecen cuando se sustituye el flujo.

6.

Opcional: Para incluir flujos de mensajes como archivos de flujo de mensajes compilados .cmf y para incluir
cdigo ESQL directamente en el archivo .cmf de cada flujo de mensajes que haga referencia a un archivo
ESQL, seleccione la opcin Compilar e incorporar recursos. De forma predeterminada, cuando se aade un
flujo de mensajes a un archivo BAR, se aade como un archivo .msgflow. De forma predeterminada, cada
archivo ESQL al que hace referencia uno o ms flujos de mensajes se despliega como un recurso individual y
pueden acceder a l varios archivos .msgflow. Si alguno de los flujos que aade al archivo BAR contiene un
subflujo que se define en un archivo .msgflow, debe seleccionar la opcin Compilar e incorporar recursos.

7.

Pulse Compilar y guardar.

LapginaGestionarlistalosarchivosqueahoraestnenelarchivoBAR.Amplesusaplicacionesybibliotecaspara
visualizarsucontenido.LosrecursoscompiladosdelarchivoBARsemuestranenordenalfabticoenelrbol.Slo
puedeeditarelementosraz;porejemplo,sihaaadidounaaplicacinalarchivoBAR,puedecambiarelnombredel
archivo.appzipoaadirlecomentarios.Noestpermitidoeditarrecursosdentrodelarchivo.appzip,peropuedeeditar
laspropiedadesconfigurablesdedichosrecursos.
Nopuedeeliminarrecursosindividualesdelosarchivos.appzip,.appdomainzipo.libzip;paraeliminarestosrecursos,
debeeliminarlaaplicacin,dominiodeaplicacin.NETobiblioteca.

Puedeelegirquelosarchivosdeorigennosevisualicen,seleccionandoRecursoscompiladosoPropiedades
configurablesdelalistadelmenFiltrarpor.

Servicios configurables
Losserviciosconfigurablessuelenserpropiedadesentiempodeejecucin.Puedeutilizarlosparadefinirpropiedades
queestnrelacionadasconserviciosexternosenlosquesebasaelintermediario;porejemplo,unservidorSMTPoun
proveedorJMS.
Enlugardedefinirpropiedadesenelnodooflujodemensajes,puedecrearserviciosconfigurablesparaquelosnodosy
flujosdemensajespuedanreferirseastosparabuscarpropiedadesentiempodeejecucin.Siutilizaestemtodo,
puedecambiarlosvaloresdelosatributosparaunservicioconfigurableenelintermediario,queasuvezafectaal
comportamientodeunnodooflujodemensajessinlanecesidadderealizarunredespliegue.
Paralamayoradetiposdeservicioconfigurables,loscambiosqueseefectenentrarnenvigorlaprximavezquese
llameaunflujodemensajesqueutiliceelservicioconfigurable.Paraalgunostiposdeserviciosconfigurables,
indicadosexplcitamenteenladocumentacin,debedetenereiniciarelservidordeintegracinparaqueelcambioentre
envigor.
Como alternativa, utilice los siguientes mandatos para trabajar con servicios configurables:

Utilice el mandato mqsicreateconfigurableservice para crear servicios configurables.

Utilice el mandato mqsideleteconfigurableservice para suprimir servicios configurables.

Utilice el mandato mqsichangeproperties para establecer los atributos despus de crear los servicios
configurables.

Utilice el mandato mqsireportproperties para notificar atributos.

ParafacilitareldesplieguedelaplicativodeVTA,sehacreadounosscriptsquedebensercopiadosalservidorde
produccinyejecutadosenlasesindelusuariomqserver