WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

Mandato mqsichangeflowstats - z/OS

Utilice el mandato mqsichangeflowstats en z/OS para controlar la acumulación de estadísticas sobre la operación de flujo de mensajes.

Sintaxis

Mandato z/OS - BIPCHMS

Leer el esquema de sintaxisOmitir el esquema de sintaxis visual
>>-mqsichangeflowstats-- NombreIntermediario --+- -a +---------->
                                               '- -s-'   

                                                         (1)   
>--+- -e--nombreGrupoEjecución--+- -f--FlujoMensajes-+-+-------->
   |                            '- -j ---------------' |       
   '- -g-- -j------------------------------------------'       

>--+-------------------------+--+--------------+---------------->
   '- -b--OrigenContabilidad-'  '- -c--Control-'   

>--+-----------------------+--+----------------+---------------->
   '- -k -NombreAplicación-'  '- -n--DatosNodo-'   

>--+--------------------+--+-----+--+-----------------+--------->
   '- -o--FormatoSalida-'  '- -r '  '- -t--DatosHebra-'   

>--+-----------------------+-----------------------------------><
   '- -y -NombreBiblioteca-'   

Notas:
  1. Consulte las descripciones de parámetros para obtener información sobre combinaciones válidas de los parámetros e,f, g, y j .

Mandato de consola z/OS

Sinónimo: cs

Leer el esquema de sintaxisOmitir el esquema de sintaxis visual
>>-+-changeflowstats-+--+-a=yes-+------------------------------->
   '- cs ------------'  '-s=yes-'   

                                                   (1)   
>--+-e=NombreGrupoEjecución--+-f=FlujoMensajes-+-+-------------->
   |                         '-j=yes-----------' |       
   '-g=yes--j=yes--------------------------------'       

>--+-----------+--+--------------+--+-------------+------------->
   '-c=Control-'  '-t=DatosHebra-'  '-n=DatosNodo-'   

>--+-------+--+----------------------+--+-----------------+----><
   '-r=yes-'  '-b=OrigenContabilidad-'  '-o=FormatoSalida-'   

Notas:
  1. Consulte las descripciones de parámetros para obtener información sobre combinaciones válidas de los parámetros e,f, g, y j .

Parámetros

BrokerName
(Necesario) Especifique la etiqueta del intermediario para el que se van a cambiar las estadísticas y la contabilidad.

Este parámetro está implícito en el formato de consola del mandato.

-a
(Necesario) Especifica que el mandato modifica la recopilación de estadísticas y contabilidad de archivado.

Debe especificar -a o -s. Si no especifica uno de estos argumentos recibirá un mensaje de aviso.

-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
-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 instantánea y archivado. Los valores posibles son:
  • active: activar instantánea o archivado
  • inactive: desactivar instantánea o archivado
-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.

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.

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.

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.

Debe especificar -f o -j. Si no especifica uno de estos argumentos recibirá un mensaje de aviso.

Nota: Si establece la opción -g para todos los grupos de ejecución, debe utilizar -j en lugar de -f.
-k nombreAplicación
(Opcional) Este parámetro especifica el nombre de la aplicación que contiene el flujo de mensajes para el que se recopilan estadísticas.

Cuando establece este parámetro, también debe establecer el parámetro -f (flujo de mensajes) o el parámetro -j (todos los flujos de mensajes). Para recopilar estadísticas para un flujo de mensajes designado en una aplicación específica, establezca los parámetros -k y -f. Para recopilar estadísticas para todos los flujos de mensajes de una aplicación, establezca los parámetros -k y -j.

Puede utilizar este parámetro con el parámetro -y (nombre de biblioteca) para especificar que el flujo de mensajes se incluya en una biblioteca referenciada por la aplicación.

-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
-o FormatoSalida
(Opcional) Especifique el destino de salida de los informes estadísticos. Los valores posibles son:
  • usertrace: es el valor predeterminado 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 estadísticos 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 - los informes estadísticos se generan como registros SMF de tipo 117.
-r
(Opcional) Este parámetro sólo se aplica a datos de archivado y especifica que se van a restablecer datos de archivado.

Esto genera el borrado de los datos de contabilidad y estadísticos 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 establece si se está utilizando el mecanismo de notificación de intervalos interno, no un método externo.

-s
(Necesario) Especifica que el mandato modifica la recopilación de estadísticas y contabilidad de instantáneas.

Debe especificar -a o -s. Si no especifica uno de estos argumentos recibirá un mensaje de aviso.

-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
-y nombreBiblioteca
(Opcional) Este parámetro especifica el nombre de la biblioteca que contiene el flujo de mensajes para el que se recopilan estadísticas.

Cuando establece este parámetro, también debe establecer el parámetro -f (flujo de mensajes) o el parámetro -j (todos los flujos de mensajes). Para recopilar estadísticas para un flujo de mensajes designado en una biblioteca específica, establezca los parámetros -k y -f. Para recopilar estadísticas para todos los flujos de mensajes de una biblioteca, establezca los parámetros -k y -j.

Ejemplos

Utilización del mandato BIPCHMS:
  • Activar las estadísticas de instantáneas para el flujo de mensajes "myFlow1" en todos los grupos de ejecución y especificar que las estadísticas no deben particionarse por datos 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", a la vez que se modifica la granularidad de los datos que se van a recopilar (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   
El ejemplo siguiente utiliza el formato de consola del mandato. Activar la contabilidad de archivado para todos los flujos de mensajes en todos los grupos de ejecución que pertenecen al intermediario y generar el informe como registros SMF.
F VCP2BRK,CS A=YES,G=YES,J=YES,C=ACTIVE,O=SMF
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última actualización:
        
        Última actualización: 2015-02-28 17:00:12


Tema de referenciaTema de referencia | Versión 8.0.0.5 | an28430_