Comando mqsistopmsgflow

Plataformas Suportadas

Finalidade

Utilize o comando mqsistopmsgflow para parar fluxos de mensagens.

Sintaxe

Parâmetros

-b BrokerName
(Obrigatório) O nome do intermediário no qual os fluxos de mensagens são parados.

Se você não especificar os sinalizadores -e e -m, todos os fluxos de mensagens no intermediário serão parados.

-e ExecutionGroupName
(Opcional) O nome do grupo de execução no qual os fluxos de mensagens são parados.
-m msgFlowName
(Opcional) O nome do fluxo de mensagens que está sendo parado.

Você pode especificar somente um fluxo de mensagens em um único comando. Entretanto, se você não especificar esse parâmetro, todos os fluxos de mensagens no grupo de execução ou no intermediário serão parados.

Se você especificar este sinalizador, também deverá especificar o sinalizador -e.

-n cfgParameterFileName
(Opcional) O nome de um arquivo .configmgr que descreve os parâmetros de conexão para Configuration Manager.
O arquivo é em XML, utilizando o formato .configmgr salvo pela GUI do Eclipse. Exemplo:
<?xml version="1.0" encoding="UTF-8"?>
<configmgr host="localhost" listenerPort="1414" queueManager="QNAME"
           securityExit="test.myExit"/>
Se você estiver utilizando este arquivo em z/OS, é preciso remover a instrução encoding="UTF-8" da primeira linha para deixar a instrução como:
<?xml version="1.0"?>
e remover o valor para o atributo do host para deixar a instrução como:
<configmgr host="" listenerPort="1414" queueManager="QNAME"
           securityExit="test.myExit"/>
Nota: Se este parâmetro não for fornecido, será necessário fornecer os parâmetros -i, -p e -q.
-i ipAddress
(Opcional) O nome do host ou endereço IP do Configuration Manager.

Se estiver utilizando este arquivo no z/OS e desejar conectar-se ao host local, será necessário configurar o valor para "".

-p Port
(Opcional) O número da porta do Configuration Manager.
-q qMgr
(Opcional) O nome do gerenciador de filas do WebSphere MQ que o Configuration Manager está utilizando.

Se você não fornecer os parâmetros -i, -p e -q, será necessário especificar o parâmetro -n.

-w timeoutValue
(Opcional) O tempo, em segundos, que o utilitário espera para assegurar que o comando de parada tenha sido concluído; o valor padrão é 60.
-v TraceFileName
(Opcional) Envia informações de rastreio interno de depuração para o arquivo especificado.

Autorização

Para parar os fluxos de mensagens, é necessário que você tenha autoridade suficiente definida na lista de controle de acesso do Configuration Manager.

As permissões requeridas são as mesmas que aquelas requeridas para executar a função equivalente no Message Brokers Toolkit; consulte Permissões de ACL para obter uma lista de permissões que podem ser definidas no Configuration Manager.

Respostas

Esse comando retorna as seguintes respostas:
0
(Sucesso) Indica que o pedido foi concluído com êxito e o estado de todos os fluxos de mensagens foi atualizado.
2
(Falha) Indica que pelo menos um fluxo de mensagens não pode ser colocado no estado correto por algum motivo.
98
Indica que o Configuration Manager não pode ser alcançado.
99
Indica que os argumentos fornecidos ao utilitário não são válidos.

Exemplos

Pára todos os fluxos de mensagens no grupo de execução default no intermediário B1, que é controlado pelo Configuration Manager cujos detalhes de conexão são descritos em cm1.configmgr. O controle será retornado ao responsável pela chamada quando todos os fluxos de mensagens no grupo de execução forem relatados como parados ou quando decorrer o tempo padrão de um minuto, aquele que acontecer primeiro.

   mqsistopmsgflow –n cm1.configmgr –b B1 -e default

Pára o fluxo de mensagens flow1 no grupo de execução default no intermediário B1, que é controlado pelo Configuration Manager cujos detalhes de conexão são descritos em cm1.configmgr. O controle será retornado ao responsável pela chamada quando o fluxo de mensagens for relatado como parado ou quando decorrer o tempo padrão de um minuto, aquele que acontecer primeiro.

   mqsistopmsgflow –n cm1.configmgr –b B1 -e default -m flow1

Digite mqsistopmsgflow para exibir informações de uso:

> mqsistopmsgflow
BIP1025I: Pára fluxos de mensagens.

> Sintaxe:
mqsistopmsgflow (-n cfgParameterFileName | (-i ipAddress -p port -q qMgr))
 -b brokerName [-e executionGroupName [-m flowName]] [-w timeoutValue]
[-v traceFileName]
Opções de Comandos:
'-n cfgParameterFileName' arquivo de conexão do Configuration Manager (.configmgr)
'-i ipAddress' Endereço IP ou nome do host do Configuration Manager
'-p port' número da porta do Configuration Manager
'-q qMgr' gerenciador de filas do Configuration Manager
'-b brokerName' nome do intermediário no qual serão parados os fluxos de mensagens
'-e executionGroupName' nome do grupo de execução no qual são parados os fluxos de mensagens.
Se ele não for especificado, todos os fluxos de mensagens no intermediário serão parados.
'-m flowName' nome do fluxo de mensagens a ser iniciado.
Se ele não for especificado, todos os fluxos de mensagens no grupo de execução serão parados.
'-w timeoutValue' tempo de espera (em segundos) para os fluxos de mensagens serem parados (Padrão=60)
'-v traceFileName' enviar rastreio interno detalhado para o arquivo especificado.
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
an26110_