Comando mqsichangeflowstats - z/OS

Sintaxe

Comando z/OS - BIPCHMS

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

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.

-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.

-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 .
-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.
-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
-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
-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.

-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
-o OutputFormat
(Opcional) Especifique o destino de saída para os relatórios estatísticos. 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.

Exemplos

Início da mudançaUtilizando o comando BIPCHMS:
  • Ative as estatísticas da captura instantânea para o fluxo de mensagens "myFlow1" em todos os grupos de execução e especifique que os dados devem ser reunidos pela 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
Fim da mudança
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 intermediário 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, 2009Copyright IBM Corporation 1999, 2009.
Última atualização : 2009-02-13 16:12:57

an28430_