Comando mqsideploy

Plataformas Suportadas

  • Plataformas 2000, XP

Finalidade

Utilize o comando mqsideploy para fazer um pedido de implementação para o Configuration Manager. Isso permite fazer os diversos tipos de pedidos de implementação a partir de um script de comandos em batch, sem a necessidade de interação manual.

A situação padrão é uma implementação delta ou incremental. Selecione -complete para substituir a operação padrão.

O código de retorno de mqsideploy será zero se o comando obtiver êxito. Se o comando falhar, o código de retorno será o número da mensagem BIP que descreve a falha, menos 1000 para mensagens no formato BIP1xxx, ou menos 8000 para mensagens no formato BIP8xxx. Por exemplo, se o comando falhar com a mensagem BIP1034, o código de retorno será 34.

Sintaxe

Parâmetros

-b Brokername
(Obrigatório) O nome do intermediário para o qual implementar. Se qualquer dos sinalizadores -topics, -topology ou -cancel for especificado a opção -b será ignorada. O motivo é que, ao implementar tópicos ou topologia ou ao cancelar uma implementação em andamento, todos os intermediários no domínio serão afetados. Sem os sinalizadores -e e -bar, uma implementação de configuração do intermediário será iniciada.
-e EGName
(Opcional) O nome do grupo de execução para o qual implementar. As opções -b e -bar também devem ser especificadas com essa opção.
-bar BARFile
(Opcional) O nome do arquivo BAR (Broker Archive) que deve ser utilizado para uma implementação de fluxo de mensagens ou de conjunto de mensagens. As opções -b e -e também devem ser especificadas com essa opção.
-topics
(Opcional) Implementar todas informações da configuração de tópicos. As informações são implementadas em todos os intermediários no domínio.
-topology
(Opcional) Esse sinalizador especifica que a configuração de Topologia deve ser implementada. As informações serão implementadas em todos os intermediários no domínio se o sinalizador -complete também for definido, caso contrário as informações serão implementadas somente em intermediários com uma configuração de topologia alterada.
-cancel
(Opcional) Cancelar todas as implementações pendentes, ou seja, intermediários que não responderam a pedidos de implementação anteriores (cancela implementação). Todos os outros sinalizadores exceto -w e -r serão ignorados quando essa opção for utilizada.
-r
(Opcional) Ler e exibir registros de log associados ao pedido de implementação anterior. Pode ser utilizada em conjunto com a opção -w para aguardar por um período de tempo especificado. Depois que um registro de log tiver sido lido a implementação será considerada concluída, e o registro ou registros de log associados a ela serão excluídos.
-w timeoutValue
(Opcional) O tempo em segundos que o utilitário aguarda que o intermediário responda antes de retornar o controle para a linha de comandos. O comando mqsideploy executa poll nos registros do log do Configuration Manager procurando os resultados do pedido de implementação que acabou de ser enviado. Os registros relevantes do log contêm informações indicando se a implementação obteve êxito. O timeoutValue é o número de segundos a aguardar antes do tempo limite, no intervalo de 1 a 999.999. Se nenhum timeoutValue for fornecido ou se um valor menor que 1 ou maior que 999.999 for especificado, será retornado um erro.
- connection connectionParametersFile
(Opcional) O nome de um arquivo .configmgr que descreve os parâmetros de conexão para o Configuration Manager. O arquivo é em XML, utilizando o formato .configmgr salvo pela GUI do Eclipse. Por exemplo:
<?xml version="1.0" encoding="UTF-8"?>
<configmgr host="localhost" listenerPort="1414" queueManager="LUCAS"
           securityExit="test.myExit"/>
Se a opção -connection for omitida, o comando obterá as informações de configuração de um arquivo no diretório de trabalho do utilitário denominado mqsicfgutil.ini. Esse arquivo tem o formato:
hostname = localhost
queueManager = QMNAME
port = 1414
securityExit = test.myExit

Especificar a opção -connection faz com que o arquivo mqsicfgutil.ini seja ignorado.

Esses arquivos precisam estar no diretório do qual o comando está sendo executado. Este não é necessariamente o mesmo diretório do arquivo mqsideploy.bat.

-rmMsgFlow name
(Opcional) Remove o fluxo de mensagens nomeado do grupo de execução fornecido. Essa alteração é implementada no intermediário imediatamente.
-rmMsgSet name
(Opcional) Remove o conjunto de mensagens nomeado do grupo de execução fornecido. Essa alteração é implementada no intermediário imediatamente.
-complete
(Opcional) Informações completas da implementação:
  • Para uma implementação de arquivo BAR, -complete remove todos os fluxos de mensagens e conjuntos de mensagens implementados atualmente do grupo de execução como parte da implementação. Se -complete não for definido, o conteúdo do arquivo BAR será implementado em adição ao que já está implementado no grupo de execução. Nesse caso, qualquer objeto implementado com o mesmo nome de um item dentro do BAR será substituído pela versão dentro do BAR.
  • Para uma implementação de configuração de topologia, -complete implementa informações completas de configuração entre intermediários em todos os intermediários. Se -complete não for definido, somente configurações entre intermediários alteradas serão implementadas em intermediários cuja configuração entre intermediários tenha sido alterada.
  • Para uma implementação de intermediário, -complete implementa todos os atributos disponíveis de configuração de intermediário no intermediário especificado, por exemplo, parâmetros de multicast. Se -complete não for definido, somente atributos de configuração alterados serão implementados.
  • Para uma implementação de árvore de tópicos, -complete implementa a árvore de tópicos inteira em todos os intermediários. Se -complete não for definido, somente alterações para a árvore de tópicos serão implementadas em todos os intermediários.
  • Para uma operação de remoção de fluxo de mensagens ou de remoção de conjunto de mensagens, o sinalizador será ignorado.

Exemplos

Execute uma implementação para o intermediário <nome_do_intermediário> e aguarde cinco minutos por uma resposta:

mqsideploy -b <nome_do_intermediário> -w 300

Leia quaisquer respostas (mensagens de log) recebidas de intermediários para os quais foi feita implementação anteriormente:

mqsideploy -r

Conceitos relacionados
Ambiente de Tempo de Execução

Tarefas relacionadas
Implementando Aplicativos de Fluxo de Mensagens

Referências relacionadas
Preferência de Sintaxe