Comando mqsimode

Use o comando mqsimode para configurar e recuperar informações do modo de operação.

Plataformas Suportadas

Propósito

Use o comando mqsimode para alterar o modo de operação de um broker ou para recuperar informações sobre o mode no qual o broker está trabalhando atualmente.

Sintaxe

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>-mqsimode--| brokerSpec |--+---------------------+------------>
                             '- -o --operationMode-'   

>--+-------------------+--+---------------------+--------------->
   '- -w --timeoutSecs-'  '- -v --traceFileName-'   

>--+----------------------+------------------------------------><
   '- -x --modeExtensions-'   

brokerSpec

|--+- brokerName ----------------+------------------------------|
   +- -n --brokerFileName--------+   
   | .-------------------------. |   
   | V                         | |   
   '-----+- -i --ipAddress-+---+-'   
         +- -p --port------+         
         '- -q --qMgr------'         

Parâmetros

brokerSpec
(Necessário) Você deve especificar pelo menos um parâmetro para identificar o broker de destino para esse comando, de uma das seguintes formas:
brokerName
Este parâmetro identifica o nome de um broker definido localmente. Você não poderá usar esta opção se o broker estiver em um computador remoto.
-n brokerFileName
Este parâmetro identifica o nome de um arquivo que contém os detalhes da conexão para um broker local ou remoto.

Use esta opção se múltiplos usuários desejarem se conectar ao mesmo broker ou se você estiver usando parâmetros de conexão avançada, como SSL.

Para criar este arquivo, clique com o botão direito do mouse no broker no WebSphere Message Broker Explorer e selecione Exportar Arquivo *.broker. Quando solicitado, navegue para o local no qual você deseja salvar o arquivo e insira o nome do arquivo; a extensão .broker é anexada automaticamente ao clicar em Salvar. Inclua o local (caminho) e o nome do arquivo quando especificar este parâmetro. Você deverá assegurar que o local seja acessível quando executar este comando.

Para executar um comando que use SSL para administrar um broker remoto através de um canal seguro, você deve especificar a senha de keystore e de truststore da conexão usando a variável de ambiente IBM_JAVA_OPTIONS. Consulte Resolvendo Problemas ao Executar Comandos para obter informações adicionais.

-i ipAddress, -p port, -q qMgr
Estes parâmetros identificam os detalhes de conexão do broker.

Use esta opção para conexões com brokers remotos que não requerem parâmetros de conexão avançada.

Se você escolher esta opção, deverá especificar pelo menos um destes três parâmetros; a ordem na qual eles são especificados é insignificante. Não é possível especificar cada parâmetro mais de uma vez.

Os parâmetros que forem omitidos assumirão valores-padrão:

  • -i ipAddress: O nome do host ou o endereço IP do computador no qual o broker está em execução. Se você não especificar este parâmetro, um valor que representa o computador local será usado.
  • -p port: A porta TCP na qual o gerenciador de filas do broker está atendendo. Se você não especificar este parâmetro, o valor 1414 será usado.
  • -q qMgr: O nome do gerenciador de filas do broker. Se você não especificar este parâmetro, um valor que representa o gerenciador de filas padrão no computador local será usado.
-o operationMode
(Opcional) Esse parâmetro configura o modo do broker de destino. Os valores válidos são advanced (a edição completa), standard (Standard Edition), express (Express Edition) e adapter (Remote Adapter Deployment mode). Se o parâmetro -o não for especificado, o comando exibirá o mode no qual o intermediário está em execução.
-x modeExtensions
(Opcional) Este parâmetro usa uma lista separada por vírgula para especificar as extensões de modo para as quais o broker é autorizado. Também é possível usar o parâmetro -x desativar todas as extensões de modo (Consulte Exemplos). Observe que essa funcionalidade não está disponível no WebSphere Message Broker Versão 7.0.0.2.
-w timeoutSecs
(Opcional) Este parâmetro especifica o tempo, em segundos, que o utilitário espera para assegurar que o comando foi concluído; o valor-padrão é 60.
-v traceFileName
(Opcional) Esse parâmetro envia informações de rastreio interno de depuração para o arquivo especificado.

Autorização

Em todas as plataformas suportadas, em brokers para os quais você ativou a segurança de administração, é necessário conceder a autoridade read na fila de segurança SYSTEM.BROKER.AUTH ao ID do usuário que executa este comando para consultar o modo.

Em todas as plataformas suportadas, é necessário conceder as autoridades read e write na fila de segurança SYSTEM.BROKER.AUTH ao ID do usuário que executa este comando para alterar o modo.

Respostas

Esse comando retorna as seguintes respostas:
0
O comando foi concluído com sucesso.
2
(Falha) O broker recebeu o pedido de implementação mas não conseguiu processá-lo com êxito. Consulte as mensagens emitidas a partir do utilitário (ou do Log de administração) para obter informações adicionais.
9
(Falha) O pedido foi enviado para o broker, mas não foi recebida nenhuma resposta antes da expiração do tempo limite.
10
(Falha) Outro usuário ou aplicativo cancelou a operação de pedido antes de ser processada pelo broker.
98
O broker não está em execução.
99
Um ou mais dos parâmetros especificados são inválidos.

Exemplos

Executando o comando mqsimode especificando o parâmetro -o

Ao executar o comando mqsimode para o intermediário BROKER1 e especificar o parâmetro -o, o mode é atualizado e você recebe um relatório sobre todos os erros. Por exemplo, se você executar o comando mqsimode a seguir para alterar seu intermediário no Remote Adapter Deployment mode e seu intermediário estiver no seguinte estado:
  • Broker_Name1 é o nome de seu intermediário.
  • Message_Flow é o nome de seu fluxo de mensagens.
  • Execution_Group é o nome de seu grupo de execução.
  • O comando altera Broker_Name1 para o Remote Adapter Deployment mode, mas contém um nó Node_Type que não é válido neste mode.
mqsimode BROKER1 –o adapter
Você recebe as seguintes mensagens:
BIP1044: Conectando-se ao gerenciador de filas do intermediário...
BIP1045: Conectando-se ao intermediário...
BIP1805: O modo para o intermediário 'Broker_Name1' foi alterado para 'adapter'.
BIP1823: AVISO: O intermediário 'Broker_Name1' possui um fluxo de mensagens chamado 'Message_Flow' 
 no grupo de execução 'Execution_Group', que contém um ou mais nós que não são 
 válidos neste modo: Node_Type.
BIP8229: O comando foi concluído com o seguinte número de avisos: 1.

Executando o comando mqsimode sem o parâmetro -o

Ao executar o comando mqsimode sem o parâmetro -o, você recebe um relatório sobre o mode que está sendo usado pelo broker, um relatório sobre todas as violações do mode e um relatório de todas as extensões de modo que são necessárias e não estão configurados. Por exemplo, se você executar o comando mqsimode a seguir, e seu intermediário estiver no seguinte estado:
  • Broker_Name é o nome de seu intermediário.
  • Seu intermediário está no mode Standard Edition.
  • Seu intermediário não possui violações.
mqsimode Broker_Name
Você recebe as seguintes mensagens:
BIP1044: Conectando-se ao gerenciador de filas do intermediário...
BIP1807: Descobrindo informações do modo do intermediário 'Broker_Name'...
BIP1802: O intermediário 'Broker_Name' está no modo 'standard'.
BIP8071: Conclusão de comando bem-sucedida.

Desativando todas as extensões de modo

Para desativar todas as extensões de modo, execute o comando mqsimode com o parâmetro -x. Observe que essa funcionalidade não está disponível no WebSphere Message Broker Versão 7.0.0.2:
mqsimode Broker_Name –x 
em que Broker_Name é o nome do broker.

Executando o comando mqsimode especificando o parâmetro -o em um intermediário que está executando uma versão anterior à V6.1

Ao executar o parâmetro -o em um intermediário que está executando uma versão anterior à V6.1, você recebe um relatório com uma mensagem apropriada. Por exemplo, em que Broker_Name é o nome de seu intermediário:
BIP1044: Conectando-se ao gerenciador de filas do intermediário...
BIP1045: Conectando-se ao intermediário...
BIP1808: O intermediário 'Broker_Name' não está no nível de software necessário
 para alterar o modo de operação.
 BIP8229: O comando foi concluído com o seguinte número de avisos: 1.
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        Última atualização
        
        Última atualização : 2012-07-17 10:04:39


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.1 | an67710_