Mandato mqsistopmsgflow

Utilice el mandato mqsistopmsgflow para detener los flujos de mensajes.

Plataformas soportadas

Finalidad

Detenga un flujo de mensajes único o todos los flujos de mensajes en un grupo de ejecución, en un intermediario especificado. Debe haber desplegado previamente los flujos de mensajes en el intermediario en un archivo BAR.

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) Este parámetro especifica 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 el entorno de trabajo; por ejemplo:
<?xml version="1.0"  encoding="UTF-8"?>
<configmgr crlNameList="" domainName="" host="winmvsd0" listenerPort="2206" 
queueManager="mq06" securityExit="" securityExitJar="" sslCipherSuite="NONE" 
sslDistinguishedNames="" sslKeyStore="" sslTrustStore="" svrconn="SYSTEM.BKR.CONFIG"/>
Si está utilizando este archivo en z/OS, debe eliminar la sentencia encoding="UTF-8" de la primera línea, y eliminar el valor del atributo host, para que la sentencia quede así:
<?xml version="1.0"?>
<configmgr crlNameList="" domainName="" host="" listenerPort="2206" 
queueManager="mq06" securityExit="" securityExitJar="" sslCipherSuite="NONE" 
sslDistinguishedNames="" sslKeyStore="" sslTrustStore="" svrconn="SYSTEM.BKR.CONFIG"/>

Si no proporciona este parámetro, debe proporcionar los parámetros -i, -p y -q.

-i DirecciónIP
(Opcional) Este parámetro especifica el nombre de host o la dirección IP del Gestor de configuración.

Si utiliza este parámetro en z/OS y desea conectar con el host local, debe establecer el valor en "".

-p Puerto
(Opcional) Este parámetro es el número de puerto del Gestor de configuración.
-q GstC
(Opcional) Este parámetro especifica 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) Este parámetro es el tiempo, en segundos, que el programa de utilidad espera para asegurarse de que el mandato se ha completado; el valor predeterminado es 60.
-v NombreArchRastreo
(Opcional) Este parámetro envía la información de rastreo de depuración interna al archivo especificado.

Autorización

El ID de usuario utilizado para ejecutar este mandato debe tener autorización suficiente definida en la lista de control de acceso del Gestor de configuración. Los permisos requeridos son los mismos que se necesitan para efectuar la función equivalente en el Kit de herramientas de Message Brokers

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 predeterminado 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 predeterminado 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 GstC]))
 -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.
Tareas relacionadas
Despliegue
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última actualización : 2009-02-16 13:55:48

an26110_