Utilice el mandato mqsideploy en z/OS para realizar una solicitud de despliegue al intermediario local.
Utilice esta opción si varios usuarios quieren conectarse al mismo intermediario, o si utiliza parámetros de conexión avanzada como, por ejemplo, SSL.
Para crear este archivo,pulse el botón derecho del ratón en WebSphere Message Broker Explorer y seleccione Exportar archivo *.broker. Cuando se le solicite, vaya a la ubicación en la que desea guardar el archivo y escriba el nombre del mismo; la extensión .broker se añade automáticamente cuando se pulsa Guardar. Incluya la ubicación (vía de acceso) y el nombre de archivo cuando especifique este parámetro. Debe asegurarse de poder acceder a la ubicación cuando ejecute este mandato.
Si elige esta opción, debe especificar como mínimo uno de estos tres parámetros; el orden en que los especifique es irrelevante. No se puede especificar un parámetro más de una vez.
En los parámetros que se omiten, se presupone que se deben utilizar los valores predeterminados:
El archivo BAR puede estar en un sistema de archivos remoto o local, si el ID de usuario o el intermediario que está ejecutando el mandato puede acceder al archivo y leerlo.
Puede especificar objetos de todos los tipos, pero si especifica un nombre de objeto ambiguo (por ejemplo "top", cuando tanto "top.dictionary" como "top.cmf" se despliegan al mismo grupo de ejecución), el mandato entero falla con el mensaje BIP1089. En estos casos, debe especificar el nombre totalmente calificado de los objetos a eliminar, por ejemplo "top.dictionary:top.cmf".
Si el archivo BAR contiene recursos para otras aplicaciones o para el grupo de ejecución, estos recursos se ignoran. Si existen flujos de mensajes, dependencias de flujos de mensajes o bibliotecas, se sustituyen; si no existen, se crean. Si existen flujos de mensajes, dependencias de flujos de mensajes o bibliotecas en el componente de intermediario, pero no existen en el archivo BAR, permanecen en el componente de intermediario.
Puede establecer este parámetro a un valor en el rango 1 - 2 145 336 164. Si no se proporciona ningún valorTiempoEspera o establece un valor inferior a 1 o superior a 2 145 336 164, se devuelve un error.
Establezca este parámetro en un valor superior a la suma de los parámetros ConfigurationChangeTimeout e InternalConfigurationTimeout de tiempo de espera excedido que haya especificado para el intermediario, si desea asegurarse de que se haya recibido una respuesta dentro del periodo de valorTiempoEspera. Si establece un valor inferior, la respuesta devuelta puede indicar que el estado de la solicitud de despliegue es desconocido.
Si el archivo BAR contiene recursos para otras aplicaciones o bibliotecas o para el grupo de ejecución, estos recursos se ignoran. Si existen flujos de mensajes o dependencias de flujos de mensajes, se sustituyen; si no existen, se crean. Si existen flujos de mensajes o dependencias de flujos de mensajes en el componente de intermediario, pero no se encuentran en el archivo BAR, permanecen en el componente de intermediario.
Si no utiliza los parámetros -k e -y, el despliegue estará destinado al grupo de ejecución. Si el archivo BAR contiene aplicaciones o bibliotecas que existen en el componente de intermediario, estas aplicaciones o bibliotecas se vuelven a desplegar. Como parte de esta operación de redespliegue, los flujos de mensajes y recursos de componentes de intermediarios existentes contenidos en las aplicaciones o las bibliotecas se suprimen y se despliegan las versiones nuevas.
Si intenta conectarse a un intermediario remoto especificando los parámetros i, p yq, o utilizando un archivo de parámetros de conexión (.broker), el mandato intenta utilizar el código de cliente WebSphere MQ Java. Esta opción no está soportada en z/OS, y devuelve el siguiente error:
BIP1046E: No se puede conectar al intermediario (nombre)
El código de razón notificado es MQRC_ENVIRONMENT_ERROR. Debe especificar un gestor de colas local.
Los siguientes ejemplos muestran el uso del parámetro -n para definir los parámetros de conexión para el intermediario. Si el intermediario está en el sistema local, puede especificarlo por su nombre.
mqsideploy -n broker1.broker -e default -a mybar.bar -m -w 600
mqsideploy –n b1.broker –e default –d top.cmf:bar.dictionary
F MQ01BRK,dp e=default,a=flows.bar
En los ejemplos siguientes se muestra cómo especificar el despliegue en las aplicaciones y las bibliotecas.
mqsideploy MB8BROKER -e default -a myBar.bar -k myApplication
mqsideploy MB8BROKER -e default -a myBar.bar -k myApplication -y myAppLibrary