Mandato mqsistopmsgflow

Plataformas soportadas

Finalidad

Utilice el mandato mqsistopmsgflow para detener los flujos de mensajes.

Sintaxis

Parámetros

-b NombreIntermediario
(Necesario) El nombre del intermediario en el que detener los flujos de mensajes.

Si no especifica los indicadores -e y -m, se detienen todos los flujos de mensajes en el intermediario.

-e NombreGrupoEjecución
(Opcional) El nombre del grupo de ejecución en el que se detienen los flujos de mensajes.
-m NombreFlujoMsj
(Opcional) El nombre del flujo de mensajes que se está deteniendo.

Sólo puede especificar un flujo de mensajes en un único mandato. Sin embargo, si no especifica este parámetro, se detienen todos los flujos de mensajes en el grupo de ejecución o intermediario.

Si especifica este indicador, también debe especificar el indicador -e.

-n NombreArchParámetrosCfg
(Opcional) El nombre de un archivo .configmgr que describe los parámetros de conexión para el Gestor de configuración.
El archivo está en XML y utiliza el formato .configmgr que ha guardado la GUI de Eclipse. Por ejemplo:
<?xml version="1.0"  encoding="UTF-8"?>
<configmgr host="localhost" listenerPort="1414" queueManager="QNAME"
           securityExit="test.myExit"/>
Si utiliza este archivo en z/OS, debe eliminar la sentencia encoding="UTF-8" de la primera línea, para que la sentencia quede así:
<?xml version="1.0"?>
y eliminar la sentencia del atributo de sistema principal, para que la sentencia quede así:
<configmgr host="" listenerPort="1414" queueManager="QNAME"
           securityExit="test.myExit"/>
Nota: Si no proporciona este parámetro, debe proporcionar los parámetros -i, -p y -q.
-i direcciónIP
(Opcional) El nombre de sistema principal o la dirección IP del Gestor de configuración.

Si utiliza este archivo en z/OS y desea conectar con el sistema principal local, debe establecer el valor en "".

-p Puerto
(Opcional) El número de puerto del Gestor de configuración.
-q gestC
(Opcional) El nombre del gestor de colas de WebSphere MQ que está utilizando el Gestor de configuración.

Si no proporciona los parámetros -i, -p y -q, debe especificar el parámetro -n.

-w ValorTiempoEspera
(Opcional) Tiempo, en segundos, que el programa de utilidad espera para asegurarse de que se ha completado el mandato de detención; el valor por omisión es 60.
-v NombreArchRastreo
(Opcional) Envía la información de rastreo de depuración interna al archivo especificado.

Autorización

Para detener flujos de mensajes, debe tener la autorización necesaria definida en la lista de control de accesos del Gestor de configuración.

Los permisos necesarios son los mismos que los que se necesitan para realizar la función equivalente en el Kit de herramientas de Message Brokers; consulte el tema Permisos de ACL para ver una lista de los permisos que se pueden definir en el Gestor de configuración.

Respuestas

Este mandato devuelve las siguientes respuestas:
0
(Success) Indica que la petición se ha completado satisfactoriamente y que se ha actualizado el estado de todos los flujos de mensajes.
2
(Failure) Indica que, por alguna razón, al menos un flujo de mensajes no se puede poner en el estado correcto.
98
Indica que no se puede alcanzar el Gestor de configuración.
99
Indica que los argumentos proporcionados al programa de utilidad no son válidos.

Ejemplos

Detiene todos los flujos de mensajes en el grupo de ejecución default en el intermediario B1, que está controlado por el Gestor de configuración cuyos detalles de conexión se describen en cm1.configmgr. El control se devuelve al canal de llamada cuando se informa que se han detenido todos los flujos de mensajes en el grupo de ejecución, o transcurre el tiempo por omisión de un minuto, lo que suceda primero.

   mqsistopmsgflow –n cm1.configmgr –b B1 -e default

Detiene el flujo de mensajes flow1 en el grupo de ejecución default en el intermediario B1, que está controlado por el Gestor de configuración cuyos detalles de conexión se describen en cm1.configmgr. El control se devuelve al canal de llamada cuando se informa que se ha detenido el flujo de mensajes, o transcurre el tiempo por omisión de un minuto, lo que suceda primero.

   mqsistopmsgflow –n cm1.configmgr –b B1 -e default -m flow1

Entre mqsistopmsgflow para mostrar la información de utilización:

> mqsistopmsgflow
BIP1025I: Detiene los flujos de mensajes.

> Sintaxis:
mqsistopmsgflow (-n NombreArchParámetrosCfg | (-i direcciónIP -p puerto -q gestC))
 -b NombreIntermediario [-e NombreGrupoEjecución [-m NombreFlujoMsj]] [-w ValorTiempoEspera]
[-v NombreArchRastreo]
Opciones del mandato:
'-n NombreArchParámetrosCfg' Archivo de conexión del Gestor de configuración (.configmgr)
'-i direcciónIP' Dirección IP o nombre de sistema principal del Gestor de configuración
'-p puerto' Número de puerto del Gestor de configuración
'-q gestC' Gestor de colas del Gestor de configuración
'-b NombreIntermediario' Nombre del intermediario en el que se deben detener los flujos de mensajes.
'-e NombreGrupoEjecución' Nombre del grupo de ejecución en el que se deben detener los flujos de mensajes. 
Si no se especifica, se detendrán todos los flujos de mensajes en el intermediario.
'-m NombreFlujoMsj' Nombre del flujo de mensajes a detener. 
Si no se especifica, se detendrán todos los flujos de mensajes en el grupo de ejecución.
'-w ValorTiempoEspera' Tiempo de espera (en segundos) para que se detengan los flujos de mensajes (Por omisión=60)
'-v NombreArchRastreo' Envía un rastreo interno detallado al archivo especificado.
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
an26110_