Mandato mqsistartmsgflow

Utilice el mandato mqsistartmsgflow para iniciar flujos de mensajes.

Plataformas soportadas

Finalidad

Inicie 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 iniciar los flujos de mensajes.

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

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

Sólo puede especificar un flujo de mensajes en un único mandato. Sin embargo, si no especifica este parámetro, se inician 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 suministrados al programa de utilidad no son válidos.

Ejemplos

Inicia todos los flujos de mensajes 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 iniciado todos los flujos de mensajes en el intermediario, o transcurre el tiempo predeterminado de un minuto, lo que suceda primero.

   mqsistartmsgflow –n cm1.configmgr –b B1

Inicia todos los flujos de mensajes 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 iniciado todos los flujos de mensajes en el intermediario, o transcurren dos minutos, lo que suceda primero.

   mqsistartmsgflow –n cm1.configmgr –b B1 –w 120

Inicia todos los flujos de mensajes en el intermediario B1, que está controlado por el Gestor de configuración. El Gestor de configuración está alojado en el gestor de colas QM1, que se encuentra en el host local:1414.

 mqsistartmsgflow –q QM1 –i localhost –p 1414 –b B1

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

> mqsistartmsgflow 
BIP1024I: Inicia los flujos de mensajes.

> Sintaxis:
mqsistartmsgflow (-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 que contiene los parámetros 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 iniciar los flujos de mensajes.
'-e NombreGrupoEjecución' Nombre del grupo de ejecución en el que se deben iniciar los flujos de mensajes. 
Si no se especifica, se iniciarán todos los flujos de mensajes en el intermediario.
'-m NombreFlujoMsj' Nombre del flujo de mensajes a iniciar. 
Si no se especifica, se iniciarán todos los flujos de mensajes en el grupo de ejecución.
'-w ValorTiempoEspera' Tiempo de espera (en segundos) para que se inicien 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

an26100_