Comando mqsistopmsgflow

Utilize o comando mqsistopmsgflow para parar os fluxos de mensagens.

Plataformas Suportadas

Propósito

Pare um único fluxo de mensagens ou todos os fluxos de mensagens em um grupo de execução em um intermediário especificado. Você deve ter implementado anteriormente os fluxos de mensagens para o intermediário em um arquivo BAR.

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) Esse parâmetro especifica 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 pelo ambiente de trabalho; por exemplo:
<?xml version="1.0" encoding="UTF-8"?>
<configmgr crlNameList="" domainName="" host="winmvsd0" listenerPort="2206" 
queueManager="mq06" securityExit="" securityExitJar="" sslCipherSuite="NONE" 
sslDistinguishedNames="" sslKeyStore="" sslTrustStore="" svrconn="SYSTEM.BKR.CONFIG"/>
Se você estiver utilizando esse arquivo no z/OS, será necessário remover a instrução encoding="UTF-8" da primeira linha e remover o valor do atributo host, para deixar a instrução como:
<?xml version="1.0"?> 
<configmgr crlNameList="" domainName="" host="" listenerPort="2206" 
queueManager="mq06" securityExit="" securityExitJar="" sslCipherSuite="NONE" 
sslDistinguishedNames="" sslKeyStore="" sslTrustStore="" svrconn="SYSTEM.BKR.CONFIG"/>

Se este parâmetro não for fornecido, será necessário fornecer os parâmetros -i, -p e -q.

-i IpAddress
(Opcional) Esse parâmetro especifica o nome do host ou endereço IP do Configuration Manager.

Se você estiver utilizando esse parâmetro no z/OS e desejar conectar-se ao host local, será necessário configurar o valor para "".

-p Port
(Opcional) O parâmetro é o número da porta do Configuration Manager.
-q QMgr
(Opcional) O parâmetro especifica 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) Esse parâmetro é o tempo, em segundos, que o utilitário espera para assegurar que o comando foi concluído; o valor padrão é 60.
-v TraceFileName
(Opcional) Esse parâmetro envia informações de rastreio interno de depuração para o arquivo especificado.

Autorização

Em todas as plataformas o ID do usuário utilizado para executar este comando deve ter autoridade suficiente definida na lista de controle de acesso especificada para o Configuration Manager. As permissões necessárias são as mesmas que a permissão necessária para executar a função equivalente no Message Brokers Toolkit

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

Insira o mqsistopmsgflow para exibir as 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.
Tarefas relacionadas
Implementando
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última atualização : 2009-02-13 16:12:54

an26110_