Mandato mqsichangeflowstats

Plataformas soportadas

  • Windows 2000, Windows XP
  • Plataformas UNIX
  • z/OS

Finalidad

Utilice el mandato mqsichangeflowstats para:
  • Activar o desactivar la publicación de Snapshot de la contabilidad y las estadísticas o archivar la salida del registro.
  • Especificar si el mandato ha de aplicarse 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 la contabilidad y las estadísticas del flujo de mensajes. Estos datos adicionales pueden incluir datos relacionados con hebras, datos relacionados con nodos, datos relacionados con terminales de nodos o una combinación de estos datos.

Las opciones establecidas utilizando este mandato permanecen activas hasta que se modifican mediante un mandato mqsichangeflowstats subsiguiente.

Sintaxis

Plataformas Windows y plataformas UNIX

z/OS

Cs sinónimo

Parámetros

brokername
(Necesario en plataformas Windows y plataformas UNIX) Especificar la etiqueta del intermediario para el que van a modificarse las estadísticas y la contabilidad.
-a
(Necesario) Especificar que el mandato modifica la recopilación de contabilidad y estadísticas del archivo.
Nota: Ha de especificar -a o -s. Si no indica alguno de estos argumentos, recibirá un mensaje de aviso.
-s
(Necesario) Especificar que el mandato modifica la recopilación de la contabilidad y las estadísticas del Snapshot.
Nota: Ha de especificar -a o -s. Si no indica alguno de estos argumentos, recibirá un mensaje de aviso.
-e EtiquetaGrupoEjecución
(Necesario) Especificar la etiqueta del grupo de ejecución para el que van a modificarse las opciones de contabilidad y estadísticas.
Nota: Ha de especificar -e o -g. Si no indica alguno de estos argumentos, recibirá un mensaje de aviso.
-f FlujoMensajes
(Necesario) Especificar la etiqueta del flujo de mensajes para el que van a modificarse las opciones de contabilidad y estadísticas.
Nota: Ha de especificar -f o -j. Si no indica alguno de estos argumentos, recibirá un mensaje de aviso.
-g
(Necesario) Especificar que el mandato se aplica a todos los grupos de ejecución que pertenecen al intermediario.
Nota: Ha de especificar -e o -g. Si no indica alguno de estos argumentos, recibirá un mensaje de aviso.
-j
(Necesario) Especificar que el mandato se aplica a todos los grupos de ejecución que pertenecen al grupo de ejecución.
Nota:
  1. Ha de especificar -f o -j. Si no indica alguno de estos argumentos, recibirá un mensaje de aviso.
  2. Si establece la opción -g para todos los grupos de ejecución, ha de utilizar -j en vez de -f.
-c control
(Opcional) Especificar el valor de la serie de caracteres que controla el nivel de la acción que va a aplicare a la recopilación de contabilidad y estadísticas para el Snapshot o el archivado. Los valores posibles son:
  • activo - activar el Snapshot o el archivado
  • inactivo - desactivar el Snapshot o el archivado.
-t DatosHebra
(Opcional) Especificar un valor de serien de caracteres para modificar la recopilación de datos de estadísticas de hebra para un flujo de mensajes. Los valores posibles son:
  • ninguno - excluir de las estadísticas los datos relacionados con hebras
  • básico - incluir en las estadísticas los datos relacionados con hebras
-n DatosNodo
(Opcional) Especificar un valor de serien de caracteres para modificar la recopilación de datos de estadísticas para un flujo de mensajes. Los valores posibles son:
  • ninguno - excluir de las estadísticas los datos relacionados con nodos
  • básico - incluir en las estadísticas los datos relacionados con nodos
  • avanzado - incluir en las estadísticas datos relacionados con nodos y datos relacionados con terminales
-r
(Opcional) Especificar que se requiere restablecer los datos de un archivo.
Nota: Esta acción sólo es válida para datos de archivos.
El resultado de esto es el borrado de los datos de contabilidad y estadísticas acumulados hasta el momento para ese intervalo, y el reinicio de la recopilación a partir de ese punto. Se restablecen todos los datos del archivo para todos los flujos del o los grupos de ejecución.

El temporizador del intervalo 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, que el temporizador del intervalo sólo se establece si se está utilizando el mecanismo de notificación de intervalo interno y no un método externo, por ejemplo, ENF en z/OS.

-b OrigenContable
Este parámetro no tiene efecto.
-o FormatoSalida
(Opcional) Especificar el destino de la salida para los informes de estadísticas. Los valores posibles son:
  • rastreo de usuario - es el valor por omisión y escribe mensajes "bip" correspondientes al rastreo de usuario que puede procesarse posteriormente de forma normal utilizando los mandatos mqsireadlog y mqsiformatlog
  • xml - los informes de las estadísticas se generan como documentos XML y los publica el intermediario que ejecuta el flujo de mensajes.
    El tema sobre el que se publican los datos tiene la siguiente estructura:
    $SYS/Broker/<brokerName>/StatisticsAccounting/<recordType>
    /<executionGroupLabel>/<messageFlowLabel>
    donde recordType se establece en Snapshot o Archivado, y los nombres del intermediario, el grupo de ejecución y el flujo de mensajes se especifican según los requisitos del suscriptor.
  • smf - (sólo z/OS). La salida de los informes de estadísticas se efectúa como registros SMF de tipo 117.

Autorización

El Id de usuario utilizado para emitir el mandato ha tener autorización de mqbrkrs.

Respuestas

Este mandato devuelve las siguientes respuestas:
  • BIP2226 Petición para cambiar el atributo del nodo de flujo de mensajes ' ': el flujo de mensajes no existe
  • BIP8004 Se han seleccionado distintivos y argumentos no válidos
  • BIP8013 El componente no existe
  • BIP8020 No se ha podido acceder a la base de datos
  • BIP8029 Intermediario no configurado
  • BIP8033 No se ha podido enviar un mensaje XML
  • BIP8038 Opción de mandato no soportada
  • BIP8039 Grupo de ejecución no disponible
  • BIP8040 No se ha podido conectar con la base de datos

Ejemplos

Active las estadísticas de Snapshot para el flujo de mensajes "myFlow1" en todos los grupos de ejecución de BrokerA y especifique que los datos han de recopilarse por origen contable:

mqsichangeflowstats BrokerA -s -g -j -b none
Desactive la recopilación de estadísticas de archivado para el flujo de mensajes "MyFlow1" del grupo de ejecución "EGRP2" correspondiente a BrokerA y, al mismo tiempo, modifique la granularidad de los datos que han de recopilarse (la próxima vez que se activen) para que incluyan los datos relacionados con la hebra.
 mqsichangeflowstats BrokerA -a -e "EGRP2" -f MyFlow1 -c inactive -t basic   
Desactive los datos de Snapshot para todos los flujos de mensajes de todos los grupos de ejecución del intermediario Broker A.

mqsichangeflowstats BrokerA -s -g -j -c inactive

Conceptos relacionados
Flujos de mensajes

Tareas relacionadas
Optimización de la productividad de los flujos de mensajes
Optimización de los tiempos de respuesta de los flujos de mensajes

Referencia relacionada
Preferencia de sintaxis
Mandato mqsichangebroker
Mandato mqsicreatebroker
Mandato mqsireportflowstats