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 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 modo 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.
Não é possível conectar-se a um gerenciador de filas remotas no z/OS; consulte Nota sobre o Uso.
-o operationMode
(Opcional) Esse parâmetro configura o modo do broker de destino. Os valores válidos são avançado (a edição integral), standard (Standard Edition), express (Express Edition), escala (Escala modo) e adapter (Remote Adapter Deployment modo). O valor padrão é avançado, a menos que você tenha a Developer Edition, em cujo caso o valor padrão é desenvolvedor. Se o parâmetro -o não for especificado, o comando exibirá o modo no qual o broker está em execução.

Se tiver adquirido uma licença para o Standard Edition, você estará autorizado a executar seus brokers no modo standard ou escala.

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

Nota sobre o Uso

Se você tentar se conectar a um broker remoto especificando os parâmetros i, p e q ou usando 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 se conectar ao broker (name)

O código de razão relatado é MQRC_ENVIRONMENT_ERROR. É necessário especificar um gerenciador de filas locais.

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.

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 modo é atualizado e você recebe um relatório sobre todos os erros. Por exemplo, se você executar o comando mqsimode a seguir para alterar seu broker no Remote Adapter Deployment modo e seu broker estiver no seguinte estado:
  • Broker_Name1 é o nome de seu broker.
  • 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 modo, mas contém um nó Node_Type que não é válido neste modo.
mqsimode BROKER1 –o adapter
Você recebe as seguintes mensagens:
BIP1044: Conectando-se ao gerenciador de filas do broker...
BIP1045: Conectando-se ao broker...
BIP1805: O modo para o broker 'Broker_Name1' foi alterado para 'adapter'.
BIP1823: AVISO: O broker '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 modo que está sendo usado pelo broker, um relatório sobre todas as violações do modo 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 broker estiver no seguinte estado:
  • Broker_Name é o nome de seu broker.
  • Seu broker está no modo Standard Edition.
  • Seu broker não possui violações.
mqsimode Broker_Name
Você recebe as seguintes mensagens:
BIP1044: Conectando-se ao gerenciador de filas do broker...
BIP1807: Descobrindo informações do modo do broker 'Broker_Name'...
BIP1802: O broker '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:
mqsimode Broker_Name –x 
em que Broker_Name é o nome do broker.
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:14


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