Mandato mqsistopmsgflow

Utilice el mandato mqsistopmsgflow para detener grupos de ejecución, aplicaciones y flujos de mensajes.

Sistemas operativos soportados

Finalidad

Puede utilizar el mandato mqsistopmsgflow con las siguientes finalidades:
  • Para detener un flujo de mensajes específico en un grupo de ejecución
  • Para detener todos los flujos de mensajes del grupo de ejecución
  • Para detener un grupo de ejecución específico
  • Para detener todos los grupos de ejecución
  • Para detener un flujo de mensajes en una aplicación o biblioteca específica, o en ambas
  • Para detener todos los flujos de mensajes en una aplicación o biblioteca específica, o en ambas
  • Para detener una aplicación específica
  • Para detener todas las aplicaciones

Para utilizar este mandato, ya debe haber desplegado flujos de mensajes, si se especifican, en el intermediario de un archivo de archivador de intermediario (BAR).

El intermediario procesa todos los mensajes en curso y las transacciones asociadas para cada flujo de mensaje antes de detenerlos. Para obtener información sobre cómo se manejan las unidades de trabajo pendientes en esta situación, consulte Transacciones de flujo de mensajes.

Sintaxis

Leer el esquema de sintaxisOmitir el esquema de sintaxis visual
>>-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-----'            

Parámetros

brokerSpec
(Obligatorio) Debe especificar un parámetro, como mínimo, para identificar el intermediario de destino para este mandato, en una de las siguientes formas:
nombreIntermediario
Este parámetro identifica el nombre de un intermediario definido localmente. No puede utilizar esta opción si el intermediario está en un sistema remoto.
-n nombreArchivoIntermediario
Este parámetro identifica el nombre de un archivo que contiene los detalles de conexión para un intermediario local o remoto.

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.

-i direcciónIP, -p puerto, -q GestorC
Estos parámetros identificar los detalles de la conexión del intermediario.

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:

  • -i direcciónIP: El nombre de host o la dirección IP del sistema en el que se ejecuta el intermediario. Si no especifica este parámetro, se utiliza un valor que representa el sistema local.
  • -p puerto: El puerto TCP en el que escucha el gestor de colas del intermediario. Si no especifica este parámetro, se utiliza el valor 1414.
  • -q GestorC: El nombre del gestor de colas del intermediario. Si no especifica este parámetro, se utiliza un valor que representa el gestor de colas predeterminado del sistema local.
No se puede conectar con un gestor de colas remoto en z/OS; consulte Notas de uso.
-e nombreGrupoEjecución
(Opcional) El nombre del grupo de ejecución para el que se deben detener los flujos de mensajes. Debe especificar -e o -g.

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.

-g
(Opcional) El flujo o los flujos de mensajes especificados se detienen en todos los grupos de ejecución del intermediario especificado. Debe especificar -e o -g.

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

-j

(Opcional) Se detienen todos los flujos de mensajes del grupo de ejecución especificado; el grupo de ejecución no se detiene.

Si establece este parámetro, se detienen todos los flujos de mensajes del grupo de ejecución, 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, se detienen todas las aplicaciones del grupo de ejecución, y se detienen los flujos de mensajes que se encuentren en el nivel del grupo de ejecución o en bibliotecas que se encuentren en el nivel del grupo de ejecución. La combinación de los parámetros -j y -z no detiene los flujos de mensajes que aparezcan dentro de las aplicaciones, o los flujos de mensajes que se encuentren dentro de las bibliotecas de las aplicaciones.

Si no se especifica -j o -m, se detiene el grupo de ejecución identificado mediante -e (si se ha especificado), o todos los grupos de ejecución de este intermediario.

-k nombreAplicación
(Opcional) El nombre de una aplicación a la que dirigir una solicitud de detención.

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, se detiene el flujo de mensajes designado en la aplicación.

Si establece el parámetro –j con el parámetro -k, se detienen todos los flujos de mensajes de la aplicación especificada, incluidos los de las bibliotecas referenciadas. Los flujos de mensajes en otras aplicaciones o a nivel de grupo de ejecución no se detienen. La aplicación no se detiene.

No puede establecer los dos parámetros, –k y –z.

-m nombreFlujo
(Opcional) El nombre del flujo de mensajes que se está deteniendo.

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 no se especifica -m o -j, se detiene el grupo de ejecución identificado mediante -e (si se ha especificado), o todos los grupos de ejecución de este intermediario.
-v nombreArchRastreo
(Opcional) Este parámetro envía la información de rastreo de depuración interna al archivo especificado.
-w tiempoEsperaSeg
(Opcional) Este parámetro especifica el tiempo, en segundos, que el programa de utilidad espera para asegurarse de que el mandato se ha completado; el valor predeterminado es 60.
-y nombreBiblioteca
(Opcional) El nombre de una biblioteca a la que dirigir una solicitud de detención.

Si establece el parámetro –y, también debe establecer el parámetro –e. Si establece el parámetro –m, se detiene el flujo de mensajes designado en la biblioteca.

Si establece el parámetro –j con el parámetro –y, se detienen todos los flujos de mensajes de la biblioteca especificada. Los flujos de mensajes en otras bibliotecas o a nivel de 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 especificada de la aplicación especificada. 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.

-z
(Opcional) El parámetro -z indica que se deben detener todas las aplicaciones del grupo de ejecución.

Si establece el parámetro -j con el parámetro -z, se detienen todas las aplicaciones del grupo de ejecución, y se detienen los flujos de mensajes que se encuentren en el nivel del grupo de ejecución o en bibliotecas que se encuentren en el nivel del grupo de ejecución. La combinación de los parámetros -j y -z no detiene los flujos de mensajes que aparezcan dentro de las aplicaciones, o los flujos de mensajes que se encuentren dentro de las bibliotecas de las aplicaciones.

Notas de uso

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.

Autorización

En todas las plataformas soportadas, en los intermediarios para los que ha habilitado seguridad de administración, debe otorgar los permisos adecuados; los requisitos exactos dependen de los parámetros que especifique.
Tarea Ejemplo de formato de mandato Permiso necesario
Detener todos los grupos de ejecución en un intermediario mqsistopmsgflow MB8BROKER -g
  • Permiso de lectura sobre SYSTEM.BROKER.AUTH
  • Permiso de ejecución sobre SYSTEM.BROKER.AUTH O permiso de ejecución sobre SYSTEM.BROKER.AUTH.EG para cada grupo de ejecución
Detener todos los flujos de mensajes en un intermediario mqsistopmsgflow MB8BROKER -g -j
  • Permiso de lectura sobre SYSTEM.BROKER.AUTH
  • Permiso de ejecución sobre SYSTEM.BROKER.AUTH.EG para cada grupo de ejecución
Detener un grupo de ejecución específico mqsistopmsgflow MB8BROKER -e EG1
  • Permiso de lectura sobre SYSTEM.BROKER.AUTH
  • Permiso de ejecución sobre SYSTEM.BROKER.AUTH O permiso de ejecución sobre SYSTEM.BROKER.AUTH.EG para el grupo de ejecución especificado
Detener todos los flujos de mensajes desplegados en un grupo de ejecución específico mqsistopmsgflow MB8BROKER -e EG1 -j
  • Permiso de lectura sobre SYSTEM.BROKER.AUTH
  • Permiso de ejecución sobre SYSTEM.BROKER.AUTH.EG para el grupo de ejecución especificado
Detener un flujo de mensajes específico mqsistopmsgflow MB8BROKER -e EG1 -m Flow1
  • Permiso de lectura sobre SYSTEM.BROKER.AUTH
  • Permiso de lectura sobre SYSTEM.BROKER.AUTH.EG para el grupo de ejecución especificado
  • Permiso de ejecución sobre SYSTEM.BROKER.AUTH.EG para el grupo de ejecución especificado

Respuestas

Este mandato devuelve las siguientes respuestas:
0
El mandato se ha completado correctamente.
2
(Anomalía) El intermediario ha recibido la solicitud de despliegue pero no ha podido procesarla correctamente. Consulte los mensajes emitidos desde el programa de utilidad (o el Registro de administración) para obtener más información.
9
(Anomalía) Se ha sometido la solicitud al intermediario, pero no se ha recibido ninguna respuesta antes de superar el tiempo de espera.
10
(Anomalía) Otro usuario u otra aplicación ha cancelado la operación de solicitud antes de que el intermediario pudiera procesarla.
98
No está ejecutando el intermediario.
99
Uno o más de los parámetros que ha especificado no es válido.

Ejemplos

Detener un grupo de ejecución específico en el intermediario MB8BROKER
mqsistopmsgflow MB8BROKER -e eg2
Detener todos los procesos de grupo de ejecución en el intermediario local MB8BROKER:
mqsistopmsgflow MB8BROKER -g

Detener el flujo de mensajes myFlow1 en la aplicación myApplication en el grupo de ejecución default:

mqsistopmsgflow MB8BROKER -e default -k myApplication -m myFlow1

Detener el flujo de mensajes myFlow1 en la biblioteca myLibrary, a la que hace referencia la aplicación myApplication, en el grupo de ejecución default.

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 default:

mqsistopmsgflow MB8BROKER -e default -z -j
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:55:39


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