Utilice el mandato mqsistopmsgflow para detener los grupos de ejecución, las aplicaciones y los flujos de mensajes.
Para utilizar este mandato, tiene que haber desplegado previamente flujos de mensajes, si se han especificado, en un archivo archivador de intermediario (BAR).
El intermediario procesa todos los mensajes en curso y las transacciones asociadas para cada flujo de mensajes antes de que el intermediario se detenga. Para obtener información sobre cómo se manejan las unidades de trabajo pendientes en esta situación, consulte Transacciones de flujo de mensajes.
>>-mqsistopmsgflow--| brokerSpec |------------------------------> >--+- -e --nombreGrupoEjecución-+--+-----------------+----------> '- -g -----------------------' +- -m nombreFlujo-+ '- -j ------------' >--+----------------------+--+----------------------------+-----> +- -k nombreAplicación-+ '- -v --nombreArchivoRastreo-' '- -z -----------------' >--+----------------------+--+------------------------+-------->< '- -w -tiempoEsperaSeg-' '- -y --nombreBiblioteca-' brokerSpec |--+- nombreIntermediario ------------+-------------------------| +- -n --nombreArchivoIntermediario-+ | .---------------------------. | | V | | '-----+- -i --direcciónIP-+---+----' +- -p --puerto------+ '- -q --GestorC-----'
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 desea ejecutar un mandato que utiliza SSL para administrar un intermediario remoto por un canal seguro, debe especificar la contraseña de almacén de claves y del almacén de confianza para la conexión que utiliza la variable de entorno IBM_JAVA_OPTIONS. Consulte Resolución de problemas al ejecutar mandatos para obtener más información.
Utilice esta opción para conexiones remotas a los intermediarios que no requieran parámetros de conexión avanzada.
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:
Si especifica -e sin -m o -j, se detendrá el grupo de ejecución. Se conserva el estado de cada flujo de mensajes (detenido o iniciado) y los flujos de mensajes iniciados se inician cuando se vuelve a iniciar el grupo de ejecución.
Si especifica -e con -m o -j, el grupo de ejecución debe estar en ejecución. Si se detiene el grupo de ejecución, se rechaza la solicitud.
Si especifica -g sin -m o -j, se detendrán todos los grupos de ejecución. Se conserva el estado de cada flujo de mensajes (detenido o iniciado) para cada grupo de ejecución y los flujos de mensajes iniciados se inician cuando se vuelve a iniciar el grupo de ejecución.
Si especifica -g con -m o -j, el flujo o los flujos de mensajes especificados se detendrán solamente si se está ejecutando el grupo de ejecución. La solicitud comprueba todos los grupos de ejecución y detiene los flujos de mensajes en los grupos de ejecución que se están ejecutando. Se informa del error BIP2851 para cada grupo de ejecución que no se esté ejecutando.
(Opcional) Todos los flujos de mensajes en el grupo de ejecución especificado se detienen; el grupo de ejecución no se detiene.
Si establece este parámetro, todos los flujos de mensajes en el grupo de ejecución se detienen, independientemente de si están en el nivel de grupo de ejecución, en una aplicación o en una biblioteca. No se detiene ninguna aplicación. Si establece el parámetro -j con el parámetro -z, todas las aplicaciones en el grupo de ejecución se detienen y los flujos de mensajes que están en el nivel del grupo de ejecución o en las bibliotecas en el nivel del grupo de ejecución se detienen. La combinación de los parámetros -j y -z no detiene los flujos de mensajes dentro de las aplicaciones o los flujos de mensajes dentro de bibliotecas dentro de aplicaciones.
Si no especifica -j o -m, el grupo de ejecución que esté identificado mediante -e (si se ha especificado) o todos los grupos de ejecución de este intermediario, se detienen.
Si establece el parámetro –k, también debe establecer el parámetro –e. Si establece el parámetro –k pero no establece el parámetro –m, se detiene la aplicación. Cuando se detiene una aplicación, los flujos de mensajes que contiene no se ejecutan. Si establece el parámetro -m, el flujo de mensajes con nombre en la aplicación se detiene.
Si establece el parámetro –j con el parámetro -k, se detienen todos los flujos de mensajes en la aplicación especificada, incluidos los flujos de mensajes en las bibliotecas referenciadas. Los Flujos de mensajes en otras aplicaciones en el nivel de grupo de ejecución no se detienen. La aplicación no se detiene.
Si establece el parámetro -k con los parámetros –m o –j, asegúrese de que la aplicación que se especifica mediante el parámetro -k se está ejecutando. No se pueden detener los flujos de mensajes en una aplicación que no se ha iniciado.
No puede establecer los dos parámetros, –k y –z.
Sólo se puede especificar un flujo de mensajes en un mandato. Si desea detener todos los flujos de mensajes desplegados en el intermediario o en el grupo de ejecución identificado por -e, especifique -j.
Si establece el parámetro –y, también debe establecer el parámetro –e. Si establece el parámetro -m, el flujo de mensajes en la biblioteca se detiene.
Si establece el parámetro -j con el parámetro -y, todos los flujos de mensajes en la biblioteca especificada se detienen. Los Flujos de mensajes en otras bibliotecas o en el nivel del grupo de ejecución no se detienen.
Para detener todos los flujos en una biblioteca específica de una aplicación, utilice el parámetro –y con el parámetro –k. Cuando utiliza una combinación de los parámetros -y y -k, sólo se detienen los flujos en la biblioteca con nombre de la aplicación con nombre. No se detiene ningún flujo a nivel de aplicación o de ninguna otra biblioteca de la aplicación. No se detiene ningún flujo de ninguna otra aplicación o a nivel de grupo de ejecución. La aplicación no se detiene.
Si establece el parámetro -j con el parámetro -z, todas las aplicaciones en el grupo de ejecución se detienen y los flujos de mensajes que están en el nivel del grupo de ejecución o en las bibliotecas en el nivel del grupo de ejecución se detienen. La combinación de los parámetros -j y -z no detiene los flujos de mensajes dentro de las aplicaciones o los flujos de mensajes dentro de bibliotecas dentro de aplicaciones.
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.
mqsistopmsgflow MB8BROKER -e eg2
mqsistopmsgflow MB8BROKER -g
Detener el flujo de mensajes myFlow1 en la aplicación myApplication en el grupo de ejecución predeterminado:
mqsistopmsgflow MB8BROKER -e default -k myApplication -m myFlow1
Detener el flujo de mensajes myFlow1 en la biblioteca myLibrary, que está referenciada por la aplicación myApplication, en el grupo de ejecución predeterminado:
mqsistopmsgflow MB8BROKER -e default -k myApplication -y myLibrary -m myFlow1
Detener todos los flujos de mensajes y detener todas las aplicaciones en el grupo de ejecución predeterminado:
mqsistopmsgflow MB8BROKER -e default -z -j