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 mqsistartmsgflow

Use o comando mqsistartmsgflow para iniciar grupos de execução, aplicativos e fluxos de mensagens.

Sistemas Operacionais Suportados

Finalidade

É possível usar o comando mqsistartmsgflow com os seguintes propósitos:
  • Iniciar um fluxo de mensagens específico em um grupo de execução
  • Iniciar todos os fluxos de mensagens no grupo de execução
  • Iniciar um grupo de execução específico
  • Iniciar todos os grupos de execução
  • Iniciar um fluxo de mensagens em um aplicativo ou biblioteca específica ou em ambos
  • Iniciar todos os fluxos de mensagens em um aplicativo ou biblioteca específica ou em ambos
  • Iniciar um aplicativo específico
  • Iniciar todos os aplicativos

Para usar esse comando, você já deverá ter implementado os fluxos de mensagens, se especificados, no broker, em um arquivo BAR. É possível iniciar fluxos de mensagens apenas se o grupo de execução para o qual o fluxo de mensagens for implementado estiver em execução.

Sintaxe

Read syntax diagramSkip visual syntax diagram
>>-mqsistartmsgflow--| brokerSpec |----------------------------->

>--+- -e --executionGroupName-+--+--------------+--------------->
   '- -g ---------------------'  +- -m flowName-+   
                                 '- -j ---------'   

>--+---------------------+--+---------------------+------------->
   +- -k applicationName-+  '- -v --traceFileName-'   
   '- -z ----------------'                            

>--+-------------------+--+-------------------+----------------><
   '- -w --timeoutSecs-'  '- -y --libraryName-'   

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.
-e executionGroupName
(Opcional) O nome do grupo de execução para o qual os fluxos de mensagens serão iniciados. É necessário especificar -e ou -g.

Se você especificar -e sem -m ou -j, o grupo de execução é iniciado. Os fluxos de mensagens são iniciados apenas se eles estavam em execução quando ao grupo de execução foi parado.

Se você especificar -e com -m ou -j, o grupo de execução deve estar executando. Se o grupo de execução for parado, o pedido é rejeitado.

-g
(Opcional) O fluxo ou fluxos de mensagens especificados são iniciados em todos os grupos de execução no broker especificado. Você deve especificar -e ou -g.

Se você especificar -g sem -m ou -j, todos os grupos de execução serão iniciados, mas os fluxos de mensagens serão iniciados apenas se eles estivessem executando quando o grupo de execução foi parado.

Se você especificar -g com -m ou -j, o fluxo ou fluxos de mensagens especificado(s) são iniciados apenas se o grupo de execução estiver executando. O pedido verifica todos os grupos de execução e inicia os fluxos de mensagens nos grupos de execução que estão executando atualmente. O erro BIP2851 é relatado para cada grupo de execução que não está executando.

-j

(Opcional) Todos os fluxos de mensagens no grupo de execução especificado são iniciados.

Se você configurar esse parâmetro, todos os fluxos de mensagens do grupo de execução serão iniciados, independentemente de estarem no nível do grupo de execução, em um aplicativo ou em uma biblioteca. Nenhum aplicativo é iniciado. Se você configurar o parâmetro -j com o parâmetro -z, todos os aplicativos do grupo de execução serão iniciados e os fluxos de mensagens que estiverem no nível do grupo de execução ou nas bibliotecas no nível do grupo de execução serão iniciados. A combinação dos parâmetros -j e -z não inicia fluxos de mensagens dentro dos aplicativos, ou fluxos de mensagens dentro das bibliotecas nos aplicativos.

Se você não especificar -j ou -m, o grupo de execução identificado por -e (se especificado), ou todos os grupos de execução neste broker, serão iniciados. Os fluxos de mensagens que estavam em execução quando o grupo de execução foi interrompido pela última vez também são reiniciados.

-k applicationName
(Opcional) O nome de um aplicativo que será o destino de uma solicitação inicial.

Se você configurar o parâmetro –k, também deverá configurar o parâmetro –e. Se configurar o parâmetro –k, mas não configurar o parâmetro –m, o aplicativo será iniciado. Se configurar o parâmetro –m, o fluxo de mensagens nomeado no aplicativo será iniciado.

Se configurar o parâmetro –j com o parâmetro -k, todos os fluxos de mensagens no aplicativo serão iniciados, incluindo aqueles nas bibliotecas referenciadas. Os fluxos de mensagens em outros aplicativos ou no nível do grupo de execução não serão iniciados. O aplicativo não é iniciado.

Se você configurar o parâmetro -k com o parâmetro -m ou -j, assegure-se de que o aplicativo especificado pelo parâmetro -k esteja em execução. Não é possível iniciar fluxos de mensagens em um aplicativo que não foi iniciado.

Não é possível configurar os parâmetros –k e –z.

-m flowName
(Opcional) O nome do fluxo de mensagens que está sendo iniciado.
Se você não especificar -m ou -j, o grupo de execução identificado por -e (se especificado), ou todos os grupos de execução neste broker, serão iniciados. Os fluxos de mensagens que estavam em execução quando o grupo de execução foi interrompido pela última vez também são reiniciados.
-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, em segundos, que o utilitário espera para assegurar que o comando foi concluído; o valor-padrão é 60.
-y libraryName
(Opcional) O nome de uma biblioteca que será o destino de uma solicitação de início.

Se você configurar o parâmetro –y, também deverá configurar o parâmetro –e. Se configurar o parâmetro –m, o fluxo de mensagens nomeado na biblioteca será iniciado.

Se você configurar o parâmetro –j com o parâmetro –y, todos os fluxos de mensagens na biblioteca serão iniciados. Os fluxos de mensagens em outras bibliotecas ou no nível do grupo de execução não serão iniciados.

Para iniciar todos os fluxos em uma biblioteca específica em um aplicativo, use o parâmetro –y com o parâmetro –k. Quando você usa uma combinação dos parâmetros –y e –k, apenas os fluxos da biblioteca nomeada no aplicativo nomeado são iniciados. Nenhum fluxo é iniciado no nível do aplicativo, ou em outras bibliotecas no aplicativo. Nenhum fluxo é iniciado em nenhum outro aplicativo ou no nível do grupo de execução. O aplicativo não é iniciado.

-z
(Opcional) O parâmetro -z indica que todos os aplicativos em um grupo de execução devem ser iniciados.

Se você configurar o parâmetro -j com o parâmetro -z, todos os aplicativos do grupo de execução serão iniciados e os fluxos de mensagens que estiverem no nível do grupo de execução ou nas bibliotecas no nível do grupo de execução serão iniciados. A combinação dos parâmetros -j e -z não inicia fluxos de mensagens dentro dos aplicativos, ou fluxos de mensagens dentro das bibliotecas nos aplicativos.

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

Inicie o fluxo de mensagens nomeado que você implementou no grupo de execução eg1 no broker MB8BROKER:

mqsistartmsgflow MB8BROKER -e eg1 -m simpleflow

Assegure que todos os fluxos de mensagens estejam em execução no broker local MB8BROKER:

mqsistartmsgflow MB8BROKER -g -j

Iniciar o fluxo de mensagens myFlow1 no aplicativo myApplication no grupo de execução padrão:

mqsistartmsgflow MB8BROKER -e default -k myApplication -m myFlow1

Iniciar o fluxo de mensagens myFlow1 na biblioteca myLibrary, que é referenciada pelo aplicativo myApplication no grupo de execução padrão:

mqsistartmsgflow MB8BROKER -e default -k myApplication -y myLibrary -m myFlow1

Iniciar todos os fluxos de mensagens e iniciar todos os aplicativos no grupo de execução padrão:

mqsistartmsgflow MB8BROKER -e default -z -j
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:08


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