WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

Comando mqsichangeflowstats - z/OS

Use o comando mqsichangeflowstats no z/OS para controlar a acumulação de estatísticas sobre operações do fluxo de mensagens.

Sintaxe

Comando z/OS - BIPCHMS

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>-mqsichangeflowstats-- BrokerName --+- -a-+------------------->
                                      '- -s '   

                                                     (1)   
>--+- -e--ExecutionGroupName--+- -f--MessageFlow-+-+------------>
   |                          '- -j -------------' |       
   '- -g-- -j--------------------------------------'       

>--+-----------------------+--+--------------+------------------>
   '- -b -AccountingOrigin-'  '- -c--Control-'   

>--+----------------------+--+---------------+------------------>
   '- -k -ApplicationName-'  '- -n -NodeData-'   

>--+-------------------+--+-----+--+-----------------+---------->
   '- -o -OutputFormat-'  '- -r '  '- -t -ThreadData-'   

>--+------------------+----------------------------------------><
   '- -y -LibraryName-'   

Notas:
  1. Consulte as descrições do parâmetro para obter informações sobre combinações válidas dos parâmetros e,f, g e j .

Comando do Console do z/OS

Sinônimo: cs

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>-+-changeflowstats-+--+-a=yes-+------------------------------->
   '- cs ------------'  '-s=yes-'   

                                               (1)   
>--+-e=ExecutionGroupName--+-f=MessageFlow-+-+------------------>
   |                       '-j=yes---------' |       
   '-g=yes--j=yes----------------------------'       

>--+-----------+--+--------------+--+------------+--+-------+--->
   '-c=Control-'  '-t=ThreadData-'  '-n=NodeData-'  '-r=yes-'   

>--+--------------------+--+----------------+------------------><
   '-b=AccountingOrigin-'  '-o=OutputFormat-'   

Notas:
  1. Consulte as descrições do parâmetro para obter informações sobre combinações válidas dos parâmetros e,f, g e j .

Parâmetros

BrokerName
(Necessário) Especifique o rótulo do intermediário para o qual a contabilidade e as estatísticas devem ser alteradas.

Esse parâmetro é incluído na forma de console do comando.

-a
(Obrigatório) Especifica que o comando modifica a coleta de contabilidade e estatísticas do archive.

Você deve especificar -a ou -s. Se você não especificar um desses argumentos, receberá uma mensagem de aviso.

-b AccountingOrigin
(Opcional) Especifica que o caminho da árvore de ambiente Broker.Accounting.Origin é utilizado para particionar as estatísticas coletadas em saídas distintas. Os valores possíveis são:
  • nenhum - não particionar estatísticas de acordo com os dados de origem de contabilidade
  • básico - particionar estatísticas de acordo com os dados de origem de contabilidade
-c Controle
(Opcional) Especifique o valor da cadeia que controla o nível da ação a ser aplicada à coleta de contabilidade e estatísticas do instantâneo ou arquivamento. Os valores possíveis são:
  • active - ligar instantâneo ou arquivamento
  • inactive - desligar instantâneo ou arquivamento.
-e ExecutionGroupName
(Obrigatório) Especifique o nome do grupo de execução para o qual as opções de contabilidade e estatísticas devem ser alteradas.

Você deve especificar -e ou -g. Se você não especificar um desses argumentos, receberá uma mensagem de aviso.

-f MessageFlow
(Requerido) Especifique o rótulo do fluxo de mensagens cujas opções de contabilidade e estatísticas devem ser alteradas.

Você deve especificar -f ou -j. Se você não especificar um desses argumentos, receberá uma mensagem de aviso.

-g
(Obrigatório) Especifica que o comando se aplica a todos os grupos de execução que pertencem ao intermediário.

Você deve especificar -e ou -g. Se você não especificar um desses argumentos, receberá uma mensagem de aviso.

-j
(Obrigatório) Especifica que o comando se aplica a todos os fluxos de mensagens que pertencem ao grupo de execução.

Você deve especificar -f ou -j. Se você não especificar um desses argumentos, receberá uma mensagem de aviso.

Nota: Se você definir a opção -g para todos os grupos de execução, precisará utilizar -j em vez de -f .
-k applicationName
(Opcional) Esse parâmetro especifica o nome do aplicativo que contém o fluxo de mensagens para o qual as estatísticas estão sendo coletadas.

Ao configurar esse parâmetro, você também deve configurar o parâmetro -f (fluxo de mensagens) ou o parâmetro -j (todos os fluxos de mensagens). Para coletar estatísticas para um fluxo de mensagens nomeado em um aplicativo específico, configure os parâmetros -k e -f. Para coletar estatísticas para todos os fluxos de mensagens em um aplicativo, configure os parâmetros -k e -j.

É possível usar esse parâmetro com o parâmetro -y (nome da biblioteca) para especificar que o fluxo de mensagens está contido em uma biblioteca referenciada pelo aplicativo.

-n NodeData
(Opcional) Especifique um valor da cadeia para modificar a coleta de dados estatísticos de nó para um fluxo de mensagens. Os valores possíveis são:
  • none - excluir dados relacionados ao nó das estatísticas
  • basic - incluir dados relacionados ao nó nas estatísticas
  • advanced - incluir dados relacionados ao nó e dados relacionados ao terminal nas estatísticas
-o OutputFormat
(Opcional) Especifique o destino de saída para os relatórios de estatísticas. Os valores possíveis são:
  • usertrace - este é o padrão e grava mensagens "bip" em usertrace, que podem ser pós-processadas da maneira normal utilizando os comandos mqsireadlog e mqsiformatlog
  • xml - os relatórios estatísticos são gerados como documentos XML e publicados pelo intermediário que executa o fluxo de mensagens.
    O tópico no qual os dados são publicados possui a seguinte estrutura:
    $SYS/Broker/<brokerName>/StatisticsAccounting/<recordType>
    /<executionGroupLabel>/<messageFlowLabel>
    em que recordType está definido como Instantâneo ou Archive, e os nomes do intermediário, grupo de execução e fluxo de mensagens são especificados de acordo com os requisitos do assinante.
  • smf - os relatórios de estatísticas são gerados como registros SMF tipo 117.
-r
(Opcional) Esse parâmetro aplica-se apenas a dados de archive e especifica que os dados de archive devem ser reconfigurados.

Isso resulta na limpeza dos dados de contabilidade e estatísticas acumulados até agora para esse intervalo e inicia novamente a coleta a partir deste ponto. Todos os dados de archive para todos os fluxos no grupo ou grupos de execução são reinicializados.

O cronômetro de intervalo de archive somente é reinicializado se a opção -v (intervalo de archive de estatísticas) de mqsicreatebroker ou mqsichangebroker for diferente de zero.

Ou seja, o cronômetro do intervalo será configurado somente se o mecanismo de notificação do intervalo interno estiver sendo utilizado e não um método externo.

-s
(Obrigatório) Especifica que o comando modifica a coleta de contabilidade e estatísticas da captura instantânea.

Você deve especificar -a ou -s. Se você não especificar um desses argumentos, receberá uma mensagem de aviso.

-t ThreadData
(Opcional) Especifique um valor da cadeia para modificar a coleta de dados estatísticos de encadeamento para um fluxo de mensagens. Os valores possíveis são:
  • none - excluir dados relacionados ao encadeamento das estatísticas
  • basic - incluir dados relacionados ao encadeamento nas estatísticas
-y libraryName
(Opcional) Esse parâmetro especifica o nome da biblioteca que contém o fluxo de mensagens para o qual as estatísticas estão sendo coletadas.

Ao configurar esse parâmetro, você também deve configurar o parâmetro -f (fluxo de mensagens) ou o parâmetro -j (todos os fluxos de mensagens). Para coletar estatísticas para um fluxo de mensagens nomeado em uma biblioteca específica, configure os parâmetros -k e -f. Para coletar estatísticas para todos os fluxos de mensagens em uma biblioteca, configure os parâmetros -k e -j.

Exemplos

Utilizando o comando BIPCHMS:
  • Ative as estatísticas de captura instantânea para o fluxo de mensagens "myFlow1" em todos os grupos de execução e especifique que as estatísticas não sejam particionadas de acordo com os dados da origem de contabilidade:
    mqsichangeflowstats
    BrokerA -s -g -j -b none   
  • Desative a coleta de estatísticas de archive para o fluxo de mensagens "MyFlow1" no grupo de execução "EGRP2" e, ao mesmo tempo, modifique a granularidade dos dados que serão coletados (na próxima vez em que forem ativados) para incluir dados relacionados a encadeamento.
    mqsichangeflowstats BrokerA -a -e "EGRP2" -f MyFlow1 -c inactive -t basic   
O exemplo a seguir utiliza a forma de console do comando. Ative a contabilidade de archive para todos os fluxos de mensagens em todos os grupos de execução pertencentes ao broker e emita a saída do relatório como registros SMF.
F VCP2BRK,CS A=YES,G=YES,J=YES,C=ACTIVE,O=SMF
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

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

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:30:12


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | an28430_