Use o comando mqsistartmsgflow para iniciar grupos de execução, aplicativos e fluxos de mensagens.
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.
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.
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:
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.
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.
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.
Não é possível configurar os parâmetros –k e –z.
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 configurar o parâmetro –j com o parâmetro –y, todos os fluxos de mensagens na biblioteca serão iniciados.
Para direcionar a solicitação para uma biblioteca específica em um aplicativo, é possível usar o parâmetro –y com o parâmetro –k.
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.
| Tarefa | Exemplo de Formato de Comando | Autoridade Necessária |
|---|---|---|
| Iniciar todos os grupos de execução em um broker | mqsistartmsgflow MB8BROKER -g |
|
| Iniciar todos os fluxos de mensagens em um broker | mqsistartmsgflow MB8BROKER -g -j |
|
| Iniciar um grupo de execução específico | mqsistartmsgflow MB8BROKER -e EG1 |
|
| Iniciar todos os fluxos de mensagens implementados em um grupo de execução específico | mqsistartmsgflow MB8BROKER -e EG1 -j |
|
| Iniciar um fluxo de mensagens específico | mqsistartmsgflow MB8BROKER -e EG1 -m Flow1 |
|
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