Comando mqsicacheadmin

• Windows
• Linux®
• AIX®
• IBM® z/OS® Extensões de contêineres ( zCX ). Execute esse comando modificando e enviando o JCL fornecido ou usando um comando de console IBM z/OS.

O comando mqsicacheadmin fornece informações sobre a grade WXS incorporada.

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 de comandos que estão disponíveis no utilitário xscmd fornecido com o WebSphere eXtreme Scale. Para obter mais informações sobre esses comandos e as informações que são retornadas, consulte a documentação on-line do produto WebSphere Extreme Scale.

• Antes de executar o comando mqsicacheadmin , certifica-se de que o servidor de integração está em execução e que o cache global está disponível. Para fornecer as informações necessárias, o comando se conecta aos componentes do cache.
• Antes de executar esse comando, certifique-se de que o parâmetro enableJMX no arquivo server.conf.yaml esteja configurado como true para todos os servidores de integração que hospedam componentes de cache. Esse parâmetro deve estar ativado para que os servidores de integração podem fornecer informações de administração sobre o cache global.

  Para obter mais informações sobre como definir as propriedades do cache global para um servidor de integração, consulte Configuração do cache global incorporado.

• Não é necessário reiniciar o servidor de integração para que esse comando entre em vigor. Por exemplo, o comando clearGrid entra em vigor imediatamente e limpa todos os dados do mapa especificado.
• Se você tentar se conectar a um nó de integração remoto especificando um arquivo de parâmetros de conexão (.broker), o comando tentará usar um código de client IBM MQ e Java™.
• É necessário especificar um gerenciador de filas locais.

integrationNodeName

Esse parâmetro identifica o nome de um nó de integração específico. Para se conectar a um nó de integração remota por nome, você também deve especificar os parâmetros --admin-host e (opcionalmente) --admin-port .

--integration-node-file integrationNodeFileName | -n integrationNodeFileName

Esse parâmetro identifica o nome de um arquivo .broker que contém os detalhes da conexão para um nó de integração ou servidor de integração independente. Inclua o local (caminho) e o nome do arquivo quando especificar este parâmetro. Deve-será assegurar que o local seja acessível quando executar este comando.

O arquivo pode ser usado para se conectar a um servidor de integração independente. Os detalhes da conexão não devem incluir um nome de nó (integrationNodeName) e o host e a porta devem destinar-se a um servidor de integração independente.

Use essa opção se múltiplos usuários desejarem se conectar ao mesmo nó de integração ou servidor de integração ou se você estiver usando parâmetros de conexão avançada, como SSL. Para saber mais sobre como criar e usar um arquivo .broker , consulte Conexão a um nó de integração criando um arquivo.broker.

É possível executar um comando que usa SSL para administrar um nó de integração remoto ou um servidor de integração por meio de um canal seguro. Deve-se especificar a senha do keystore e a senha do armazenamento confiável para a conexão que está usando a variável de ambiente IBM_JAVA_OPTIONS. Para obter mais informações, consulte Resolução de problemas ao executar comandos.

--admin-host host --admin-port port | -i ipAddress -p porto

Esses parâmetros identificam um host e uma porta para um nó de integração ou servidor de integração independente, para conexões que não requerem parâmetros de conexão avançados.

Para se conectar a um nó de integração remota específico por nome, você pode adicionar o prefixo integrationNodeName. Não é possível usar o parâmetro --integration-node-file (-n) integrationNodeFileName no mesmo comando.

Para um nó de integração, quaisquer parâmetros que você omite assumem valores padrão.

• --admin-host host (ou -i ipAddress ). O nome do host ou endereço IP do computador no qual o nó de integração ou servidor está em execução. Se você não especificar este parâmetro, um valor que representa o computador local será usado.

  Para se conectar a um servidor de integração independente, o valor será o host especificado na propriedade adminRestApiHost do arquivo de configuração server.conf.yaml do servidor de integração.

  Se você desejar se conectar a um nó de integração ou servidor protegido como um usuário específico, forneça as credenciais de segurança como um URI no formato a seguir: tcp://user:password@hostname. Se sua senha contiver caracteres reservados do URI, esses caracteres deverão ser convertidos no formato de codificação percentual. Para obter mais informações, consulte Um URL e uma senha corretos retornam o erro BIP1939 quando você tenta se conectar a um nome de host remoto em Resolvendo problemas ao executar comandos.

• --admin-port porta (ou -p porta ). A porta na qual o listener de conexão HTTP da interface com o usuário da web está atendendo. Se você não especificar este parâmetro, o valor 4414 será usado.

  Para estabelecer uma conexão com um servidor de integração independente, o valor é a porta que foi configurada para a propriedade adminRestApiPort no arquivo de configuração server.conf.yaml. Por padrão, adminRestApiPort é configurado como 7600.

Outros parâmetros:

-e catalogServiceEndPoints

(Opcional) Os detalhes da conexão para o servidor de catálogo em cache em execução no servidor de integração. O formato desse parâmetro é hostName:listenerPort. Se você não especificar esse parâmetro, deverá especificar o integrationNodeName ou integrationNodeFileName parâmetro ou o-i e-p parâmetros em vez disso.

 

-c comando

(Obrigatório) O comando a ser executado na grade WXS incorporada. Os valores a seguir são válidos para esse comando.

clearGrid

Limpa todos os dados do mapa especificado na grade WXS incorporada. Este comando entra em vigor imediatamente e não requer uma reinicialização do servidor de integração.

showMapSizes

Exibe os tamanhos de todos os mapas na grade WXS incorporada.

placementServiceStatus

Exibe o status da operação de colocation ObjectGrid® .

triggerPlacement

Aciona uma operação de colocation para o ObjectGrid.

routetable

Exibe a tabela de roteamento atual para todos os WebSphere eXtreme Scale shards e partições na grade WXS incorporada.

showPlacement

Lista todos os servidores de contêineres e seus fragmentos na grade WXS incorporada.

listHosts

Lista todos os hosts que participam da grade WXS incorporada.

"setTraceSpec -especificação WebSphere eXtreme Scale _componente "

Configura a especificação de rastreio. Este comando entra em vigor imediatamente e não requer uma reinicialização do servidor de integração.

Use essa opção de comando apenas de acordo com as instruções do Suporte IBM.

Aspas duplas devem ser usadas conforme mostrado.

"setCatTraceSpec -especificação WebSphere eXtreme Scale _componente "

Configura a especificação de rastreio para todos os servidores de catálogos que forem conhecidos por este processo. Este comando entra em vigor imediatamente e não requer uma reinicialização do servidor de integração.

Use essa opção de comando apenas de acordo com as instruções do Suporte IBM.

Aspas duplas devem ser usadas conforme mostrado.

getTraceSpec

Exibe a especificação de rastreio.

Nota:

É possível executar as opções de comando xscmd que não estão disponíveis com o comando mqsicacheadmin , usando um comando Java Um exemplo do comando Java que pode ser usado para executar a opção xscmd teardown para parar os servidores de catálogos e de contêiner a seguir:

java -classpath "[App Connect Enterprise installationPath]/cachesupport/lib/objectgrid.jar" -Dcom.ibm.CORBA.ThreadPool.MinimumSize=32 -Djava.util.logging.manager=com.ibm.ws.bootstrap.WsLogManager 
-Djava.util.logging.configureByServer=true com.ibm.ws.xs.admin.wxscli.WXSAdminCLI -c teardown -ics -f -hf HostName -cep catalogEndPoints

em que:

• -c especifica a opção de comando xscmd a ser executada
• -ics inclui os nomes dos servidores de catálogo na lista filtrada de servidores para parar.
• -hf especifica o nome do host no qual os servidores de catálogos estão em execução
• -cep especifica um ou mais terminais em serviço de catálogos no formato [:][,[: ]] Por exemplo: localhost:2800 ou myhost1.mycompany.com:2800,myhost2.mycompany.com:2804 .
• -f força a ação de comando e desativa quaisquer prompts de preempção

 

-m mapName

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

 

-w timeoutSecs

(Opcional) O número máximo de segundos de espera pela resposta do servidor de cache de catálogo em execução no servidor de integração (o padrão é 60).

 

• 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

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