Comando mqsideploy - Sistemas Windows, Linux e UNIX

Use o comando mqsideploy nos sistemas Windows, Linux e UNIX para fazer uma solicitação de implementação para o broker.

Sintaxe

Formato do diagrama de sintaxe      Diagrama de trilha      Decimal com pontos

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.
-aBARFileName
(Opcional) Este parâmetro especifica o nome do arquivo broker archive (BAR) que deve ser usado para implementação do fluxo de mensagens e de outros recursos. Você também deve especificar o parâmetro -e com essa opção.
-ddeployedObjects
(Opcional) Esse parâmetro descreve o conjunto de objetos que você deseja remover do grupo de execução. É possível especificar vários arquivos para implementação, separando os nomes de arquivos com dois-pontos (:).

Objetos de todos os tipos podem ser especificados, mas se um nome de objeto ambíguo for especificado (por exemplo, "top", quando "top.dictionary" e "top.cmf" estão implementados no mesmo grupo de execução), todo o comando falhará com a mensagem BIP1089. Nessas circunstâncias, você deve especificar o nome completo dos objetos a serem removidos; por exemplo, "top.dictionary:top.cmf".

-e executionGroupName
(Opcional) Esse parâmetro especifica o nome do grupo de execução ao qual implementar. Você também deve especificar o parâmetro -a com essa opção.
-k applicationName
(Opcional) Esse parâmetro especifica o nome de um aplicativo a ser implementado no grupo de execução. Ao usar esse parâmetro, você também deve especificar um grupo de execução usando o parâmetro -e.

Se o arquivo BAR contiver recursos para outros aplicativos ou para o grupo de execução, esses recursos serão ignorados. Se existirem fluxos de mensagens, dependências de fluxos de mensagens ou bibliotecas, eles serão substituídos; se eles não existirem, serão criados. Se existirem fluxos de mensagens, dependências de fluxos de mensagens ou bibliotecas no componente do broker, mas não estiverem presentes no arquivo BAR, eles permanecerão no componente do broker.

-m
(Opcional) Esse parâmetro especifica a implementação de informações completas:
  • Para uma implementação de arquivo BAR, -m remove todos os fluxos de mensagens e conjuntos de mensagens implementados no momento do grupo de execução como parte da implementação. Se você não configurar -m, o conteúdo do arquivo BAR será implementado, além do que já está implementado no grupo de execução. Os objetos implementados com o mesmo nome que um item dentro do arquivo BAR são substituídos pela versão dentro do arquivo BAR.
  • Para uma operação remover fluxo de mensagens ou conjunto de mensagens, o parâmetro -m é ignorado.
-v traceFileName
(Opcional) Esse parâmetro envia informações de rastreio interno de depuração para o arquivo especificado.
-w timeoutSecs
(Opcional) Este parâmetro especifica o tempo máximo, em segundos, que o comando aguarda o broker completar o pedido antes de retornar.

Você pode configurar este parâmetro com um valor no intervalo de 1 - 2 145 336 164. Se você não fornecer um valor timeoutValue ou se configurar um valor menor que 1 ou maior que 2 145 336 164, um erro será retornado.

Configure este parâmetro para um valor maior que a soma dos parâmetros de tempo limite de configuração ConfigurationChangeTimeout e InternalConfigurationTimeout que você especificou para o broker, se desejar assegurar que uma resposta seja recebida dentro do período de timeoutValue. Se você configurar um valor menor, a resposta retornada poderá indicar que o estado do pedido de implementação é desconhecido.

-y libraryName
(Opcional) Esse parâmetro especifica o nome da biblioteca a ser implementada no grupo de execução. Ao usar esse parâmetro, você também deve especificar um grupo de execução usando o parâmetro -e. É possível usar esse parâmetro com o parâmetro -k para destinar uma biblioteca privada a um aplicativo.

Se o arquivo BAR contiver recursos para outros aplicativos ou bibliotecas, ou para o grupo de execução, esses recursos serão ignorados. Se existirem fluxos de mensagens ou dependências de fluxos de mensagens, eles serão substituídos; se eles não existirem, serão criados. Se existirem fluxos de mensagens ou dependências de fluxos de mensagens no componente do broker, mas eles não estiverem presentes no arquivo BAR, permanecerão no componente do broker.

Se você não usar os parâmetros -k e -y, a implementação atingirá o grupo de execução. Se o arquivo BAR contiver aplicativos ou bibliotecas existente no componente do broker, esses aplicativos ou bibliotecas serão reimplementados. Como parte dessa reimplementação, os fluxos de mensagens e os recursos do componente broker existentes contidos nos aplicativos e bibliotecas são excluídos e as novas versões são implementadas.

Exemplos

Os exemplos a seguir mostram o uso do parâmetro -n para definir os parâmetros de conexão para o broker; se preferir, é possível especificar os parâmetros i, p e q. Se o broker estiver no computador local, é possível especificá-lo pelo nome.

Implemente um arquivo BAR no broker identificado pelos parâmetros de conexão no arquivo b1.broker e remova todos os fluxos de mensagens e conjuntos de mensagens implementados atualmente do grupo de execução como parte da implementação. Permita 10 minutos para o broker responder.
mqsideploy -n b1.broker -e default -a mybar.bar -m -w 600 
Remova o fluxo de mensagens top e o dicionário bar do grupo de execução default no broker identificado pelos parâmetros de conexão no arquivo b1.broker.
mqsideploy –n b1.broker –e default –d top.cmf:bar.dictionary

Os exemplos a seguir mostram como especificar a implementação em aplicativos e bibliotecas.

Implemente o aplicativo myApplication no grupo de execução padrão.
mqsideploy MB8BROKER -e default -a myBar.bar -k myApplication
Implemente a biblioteca myAppLibrary que está contida no aplicativo myApplication:
mqsideploy MB8BROKER -e default -a myBar.bar -k myApplication -y myAppLibrary

Para obter informações sobre como usar esse comando com canais protegidos por SSL, consulte Você deseja executar um comando que usa SSL para administrar um broker remoto em um canal seguro

Avisos | Marcas | Este link é aberto em uma nova janela Downloads | Este link é aberto em uma nova janela Biblioteca | Este link é aberto em uma nova janela Suporte | Feedback

Copyright IBM Corporation 1999, 2011Copyright IBM Corporation 1999, 2011.

        
        Última atualização
        
        Última atualização : 2011-11-09 14:40:00


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.0 | an28520_