Mandato mqsichangeflowstats

Plataformas soportadas

Finalidad

Utilice el mandato mqsichangeflowstats para:
  • Activar o desactivar la publicación de instantáneas de contabilidad y estadísticas o el archivado de la salida de registros.
  • Especificar que el mandato se aplique a un flujo de mensajes específico o a todos los flujos de un grupo de ejecución, o a todos los grupos de ejecución que pertenezcan a un intermediario.
  • Modificar la granularidad de los datos recopilados además de las estadísticas y contabilidad de flujos de mensajes estándar. Estos datos adicionales pueden incluir datos relacionados con hebras, con nodos, con terminales de nodos o una mezcla de ellos.

Las opciones establecidas con este mandato permanecerán activas hasta que se modifiquen con otro mandato mqsichangeflowstats posterior.

Sintaxis

Plataformas Windows, y sistemas Linux y UNIX

z/OS

Sinónimo cs

Parámetros

nombreintermediario
(Necesario - Plataformas Windows y sistemas Linux y UNIX) Especifica la etiqueta del intermediario para el que se van a cambiar la contabilidad y las estadísticas.
-a
(Necesario) Especifica que el mandato modifica la recopilación de estadísticas y contabilidad del archivado.
Nota: Debe especificar -a o -s. Si no especifica uno de estos argumentos recibirá un mensaje de aviso.
-s
(Necesario) Especifica que el mandato modifica la recopilación de estadísticas y la contabilidad de instantáneas.
Nota: Debe especificar -a o -s. Si no especifica uno de estos argumentos recibirá un mensaje de aviso.
-e NombreGrupoEjecución
(Necesario) Especifica el nombre del grupo de ejecución para el que se van a cambiar las opciones de estadísticas y contabilidad.
Nota: Debe especificar -e o -g. Si no especifica uno de estos argumentos recibirá un mensaje de aviso.
-f FlujoMensajes
(Necesario) Especifica la etiqueta para el flujo de mensajes para el que se van a cambiar las opciones de estadísticas y contabilidad.
Nota: Debe especificar -f o -j. Si no especifica uno de estos argumentos recibirá un mensaje de aviso.
-g
(Necesario) Especifica que el mandato se aplica a todos los grupos de ejecución que pertenecen al intermediario.
Nota: Debe especificar -e o -g. Si no especifica uno de estos argumentos recibirá un mensaje de aviso.
-j
(Necesario) Especifica que el mandato se aplica a todos los flujos de mensajes que pertenecen al grupo de ejecución.
Nota:
  1. Debe especificar -f o -j. Si no especifica uno de estos argumentos recibirá un mensaje de aviso.
  2. Si establece la opción -g para todos los grupos de ejecución, debe utilizar -j en lugar de -f.
-c control
(Opcional) Especifica el valor de serie que controla el nivel de la acción que se debe aplicar a la recopilación de estadísticas y contabilidad para la instantánea y el archivado. Los valores posibles son:
  • active: activar instantánea o archivado
  • inactive: desactivar instantánea o archivado
-t DatosHebra
(Opcional) Especifica un valor de serie para modificar la recopilación de datos estadísticos de hebras para un flujo de mensajes. Los valores posibles son:
  • none: excluir de las estadísticas los datos relacionados con hebras
  • basic: incluir en las estadísticas los datos relacionados con hebras
-n DatosNodo
(Opcional) Especifica un valor de serie para modificar la recopilación de datos estadísticos de nodos para un flujo de mensajes. Los valores posibles son:
  • none: excluir de las estadísticas los datos relacionados con nodos
  • basic: incluir en las estadísticas los datos relacionados con nodos
  • advanced: incluir en las estadísticas datos relacionados con nodos y terminales
-r
(Opcional) Especifica que es necesario un restablecimiento de datos de archivado.
Nota: Esta acción sólo se lleva a cabo para los datos de archivado.
Esto genera el borrado de los datos de contabilidad y estadísticas acumulado hasta ahora para este intervalo y reinicia la recopilación a partir de este momento. Se restablecen todos los datos de archivado para todos los flujos del grupo de ejecución o de los grupos de ejecución.

El temporizador de intervalos de archivado sólo se restablece si la opción -v (intervalo de archivado de estadísticas) de mqsicreatebroker o mqsichangebroker no es cero. Es decir, el temporizador de intervalos sólo se restablece si se utiliza el mecanismo de notificación de intervalos internos, no un método externo, por ejemplo, ENF en z/OS.

-b OrigenContabilidad
(Opcional) Especifica que la vía de acceso del árbol de entorno Broker.Accounting.Origin se utiliza para particionar en distintas salidas las estadísticas recopiladas. Los valores posibles son:
  • none: no particionar las estadísticas según los datos de origen de contabilidad
  • basic: particionar las estadísticas según los datos de origen de contabilidad
-o FormatoSalida
(Opcional) Especifica el destino de salida para los informes de estadísticas. Los valores posibles son:
  • usertrace: es el valor por omisión y escribe mensajes "bip" en el rastreo de usuario que puede procesarse posteriormente con el método normal con los mandatos mqsireadlog y mqsiformatlog
  • xml: los informes de estadísticas se generan como documentos XML y los publica el intermediario que ejecuta el flujo de mensajes.
    El tema en el que se publican los datos tiene la siguiente estructura:
    $SYS/Broker/<nombreIntermediario>/StatisticsAccounting/<tipoRegistro>/<etiquetaGrupoEjecución>/<etiquetaFlujoMensajes>
    donde TipoRegistro se establece en Instantánea o Archivado, y los nombres de intermediarios, grupos de ejecución y flujos de mensajes se especifican según los requisitos del suscriptor.
  • smf - (sólo z/OS). Los informes estadísticos se generan en forma 117 registros de tipo SMF.

Autorización

ID de usuario utilizado para emitir el mandato debe tener la autorización mqbrkrs.

Respuestas

Este mandato devuelve las siguientes respuestas:
  • BIP2226 Se ha recibido una petición para modificar un atributo del nodo de flujo de mensajes ' ': el nodo no existe en el flujo de mensajes
  • BIP8004 Se han seleccionado indicadores y/o argumentos incorrectos
  • BIP8013 Este componente no existe
  • BIP8020 No se ha podido acceder a la base de datos
  • BIP8029 El intermediario no está configurado
  • BIP8033 No se ha podido enviar el mensaje XML
  • BIP8038 Opción de mandato no soportada
  • BIP8039 El grupo de ejecución no está disponible
  • BIP8040 No se ha podido efectuar la conexión con la base de datos

Ejemplos

Activar las estadísticas de instantáneas para el flujo de mensajes "myFlow1" en todos los grupos de ejecución de BrokerA y especificar que los datos deben recopilarse por origen de contabilidad:
mqsichangeflowstats BrokerA -s -g -j -b none   
Desactivar la recopilación de estadísticas de archivado para el flujo de mensajes "MyFlow1" en el grupo de ejecución "EGRP2" para BrokerA, a la vez que se modifica la granularidad de los datos que van a recopilarse (la próxima vez que se activa) para incluir los datos relacionados con hebras.
 mqsichangeflowstats BrokerA -a -e "EGRP2" -f MyFlow1 -c inactive -t basic   
Desactivar los datos de instantánea para todos los flujos de mensajes en todos los grupos de ejecución para Broker A.
mqsichangeflowstats BrokerA -s -g -j -c inactive  
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
an11770_