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 mqsicacheadmin

Use o comando mqsicacheadmin para fornecer informações sobre o cache global e concluir a administração básica.

Plataformas Suportadas

  • Sistemas Windows.
  • Sistemas Linux e UNIX.
  • z/OS. Execute esse comando customizando e enviando o BIPCCAD; consulte Conteúdo do PDSE do Broker

Propósito

O comando mqsicacheadmin fornece informações sobre o cache global que está integrado a um broker. Por exemplo, é possível descobrir o tamanho de um mapa, listar os hosts que estão participando do cache e limpar dados de um mapa.

Esse comando fornece um subconjunto dos comandos disponíveis no utilitário xscmd que é fornecido com o WebSphere eXtreme Scale. Para obter informações adicionais sobre esses comandos e as informações que são retornadas, consulte Centro de informações do WebSphere eXtreme Scale.

Observações de Uso

  • Antes de executar o comando mqsicacheadmin, assegure-se de que o broker esteja em execução e que o cache global esteja disponível. Para fornecer as informações necessárias, o comando se conecta aos componentes do cache.
  • Antes de executar esse comando, assegure-se de que para todos os grupos de execução que hospedam componentes do cache, o parâmetro enableJMX esteja configurado como true. Esse parâmetro deve estar ativado para que os grupos de execução possam fornecer informações de administração sobre o cache global. (Para obter informações adicionais, consulte Valores de Parâmetro para o Componente Cachemanager.) Quando você usa a topologia de cache cache padrão, ou um arquivo de políticas XML, esse parâmetro é configurado como true automaticamente.
  • Não é necessário reiniciar o broker para que esse comando entre em vigor. Por exemplo, o comando clearGrid fica efetivo imediatamente e limpa todos os dados do mapa especificado.
  • Se você tentar conectar-se a um broker remoto especificando um arquivo de parâmetro de conexão (.broker), o comando tentará usar o código do cliente WebSphere MQ Java™. Esta opção não é suportada no z/OS e retorna o seguinte erro:
    BIP1046E: Não é possível conectar ao broker (nome)
    
    O código de razão relatado é MQRC_ENVIRONMENT_ERROR. 
    É necessário especificar um gerenciador de filas locais.

Sintaxe

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>-mqsicacheadmin--+------------+------------------------------->
                   '-BrokerName-'   

>--+-----------------------------+-- -c --command--------------->
   +- -cep --connectionEndPoints-+                  
   '- -n --brokerFileName--------'                  

>--+---------------+-------------------------------------------><
   '- -m --mapName-'   

Parâmetros

BrokerName
(Opcional) O nome do broker local a ser modificado. Se você não especificar esse parâmetro, deverá especificar então o parâmetro connectionEndPoints ou brokerFileName .

 

-cep connectionEndPoints
(Opcional) Os detalhes da conexão para o servidor de catálogos do cache que está em execução no broker. O formato desse parâmetro é hostName:listenerPort. Se você não especificar esse parâmetro, deverá especificar então o parâmetro brokerName ou brokerFileName.

 

-n brokerFileName
(Opcional) O arquivo que contém os parâmetros de conexão do broker remoto (*.broker). Se você não especificar esse parâmetro, deverá especificar então o parâmetro brokerName ou connectionEndPoints.

 

-c command
(Obrigatório) O comando a ser executado com relação ao cache integrado. Os valores a seguir são válidos para esse comando.
clearGrid
Limpa todos os dados do mapa especificado no cache integrado. Esse comando tem efeito imediato e não requer um reinício do broker.
showMapSizes
Exibe os tamanhos de todos os mapas no cache integrado.
placementServiceStatus
Exibe o status da operação de colocação do ObjectGrid.
routetable
Exibe a tabela de roteamento atual para todos os shards e partições do WebSphere eXtreme Scale no cache integrado.
showPlacement
Lista todos os servidores de contêiner e seus shards no cache integrado.
listHosts
Lista todos os hosts participantes do cache integrado.

 

-m mapName
(Opcional) O nome do mapa no qual executar o comando. Esse parâmetro será necessário se o comando for clearGrid. Para todos os outros comandos, esse parâmetro será ignorado.

 

Respostas

Além das respostas de comandos padrão, as respostas a seguir são retornadas por esse comando.
  • BIP7186 Informações de uso para o comando mqsicacheadmin
  • BIP7187 Saída do comando mqsicacheadmin
  • BIP7188 Impossível determinar parâmetros de conexão para os servidores de catálogos no cache global

Autorização

Para obter informações sobre autorizações específicas da plataforma, consulte os tópicos a seguir: Se você tiver ativado a segurança de administração do broker, também deverá configurar a autoridade detalhada em Tarefas e Autorizações para Segurança de Administração.

Exemplos

Sempre insira o comando em uma única linha; em alguns exemplos, as quebras de linhas foram incluídas para melhorar a capacidade de leitura.

O seguinte exemplo exibe os tamanhos de todos os mapas do cache integrado:
mqsicacheadmin brokerName -c showMapSizes
O seguinte exemplo usa o parâmetro -cep para se conectar a um servidor de catálogos e exibe a tabela de roteamento para cada shard do WebSphere eXtreme Scale:
mqsicacheadmin -cep server.company.com:2800 -c routetable
O seguinte exemplo limpa todos os dados do mapa chamado "myMap":
mqsicacheadmin brokerName -c clearGrid -m myMap
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:31:35


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