Use o comando mqsistopmsgflow para parar grupos de execução 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.
O broker processa todas as mensagens em andamento e as transações associadas de cada fluxo de mensagens antes de interrompê-lo. Para obter informações sobre como unidades de trabalho pendentes são tratadas nesta situação, consulte Transações de Fluxos de Mensagens.
>>-mqsistopmsgflow--| brokerSpec |------------------------------> >--+- -e --executionGroupName-+--+--------------+---------------> '- -g ---------------------' +- -m flowName-+ '- -j ---------' >--+---------------------+--+-------------------+-------------->< '- -v --traceFileName-' '- -w --timeoutSecs-' brokerSpec |--+- brokerName ----------------+------------------------------| +- -n --brokerFileName--------+ | .-------------------------. | | V | | '-----+- -i --ipAddress-+---+-' +- -p --port------+ '- -q --qMgr------'
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 é parado. O estado de cada fluxo de mensagens (parado ou iniciado) é retido e fluxos de mensagens iniciados são iniciados quando o grupo de execução for iniciado novamente.
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 parados. O estado de cada fluxo de mensagens (iniciado ou parado) é retido para cada grupo de execução e os fluxos de mensagens iniciados serão iniciados quando o grupo de execução for iniciado novamente.
Se você especificar -g com -m ou -j, o fluxo ou fluxos de mensagens especificado(s) são parados apenas se o grupo de execução estiver executando. O pedido verifica todos os grupos de execução e para os fluxos de mensagens nos grupos de execução que estão em execução atualmente. O erro BIP2851 é relatado para cada grupo de execução que não está executando.
(Opcional) Todos os fluxos de mensagens no grupo de execução especificado são interrompidos; o grupo de execução não é interrompido.
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 interrompidos.
Você pode especificar somente um fluxo de mensagens em um único comando. Para parar todos os fluxos de mensagens implementados no broker, ou no grupo de execução identificado por -e, especifique -j.
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 |
|---|---|---|
| Parar todos os grupos de execução em um broker | mqsistopmsgflow MB7BROKER -g |
|
| Parar todos os fluxos de mensagens em um broker | mqsistopmsgflow MB7BROKER -g -j |
|
| Parar um grupo de execução específico | mqsistopmsgflow MB7BROKER -e EG1 |
|
| Parar todos os fluxos de mensagens implementados em um grupo de execução específico | mqsistopmsgflow MB7BROKER -e EG1 -j |
|
| Parar um fluxo de mensagens específico | mqsistopmsgflow MB7BROKER -e EG1 -m Flow1 |
|
mqsistopmsgflow MB7BROKER -e eg2
mqsistopmsgflow MB7BROKER -g