Comando mqsistartmsgflow

Plataformas Suportadas

Finalidade

Utilize o comando mqsistartmsgflow para iniciar fluxos de mensagens.

Sintaxe

Parâmetros

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

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

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

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 iniciados.

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 início 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 iniciar 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

Inicia todos os fluxos de mensagens 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 intermediário forem relatados como iniciados ou quando decorrer o tempo padrão de um minuto, aquele que acontecer primeiro.

   mqsistartmsgflow –n cm1.configmgr –b B1

Inicia todos os fluxos de mensagens 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 intermediário forem relatados como iniciados ou quando decorrerem dois minutos, aquele que acontecer primeiro.

   mqsistartmsgflow –n cm1.configmgr –b B1 –w 120

Inicie todos os fluxos de mensagens no Intermediário B1, controlado pelo Configuration Manager. O Configuration Manager é hospedado pelo gerenciador de filas QM1 que está no host local:1414.

 mqsistartmsgflow –q QM1 –i localhost –p 1414 –b B1

Digite mqsistartmsgflow para exibir informações de uso:

> mqsistartmsgflow
BIP1024I: Starts message flows.

> Sintaxe:
mqsistartmsgflow (-n cfgParameterFileName | (-i ipAddress -p port -q qMgr))
 -b brokerName [-e executionGroupName [-m flowName]] [-w timeoutValue]
[-v traceFileName]
Command Options:
'-n cfgParameterFileName' File containing Configuration Manager connection parameters (.configmgr)
'-i ipAddress' Endereço IP ou nome do host do Configuration Manager
'-p port' port number of the Configuration Manager
'-q qMgr' queue manager of the Configuration Manager
'-b brokerName' name of the broker on which to start message flows
'-e executionGroupName' name of the execution group on which to start message flows.
If this is not specified, all message flows on the broker will be started.
'-m flowName' name of the message flow to start.
If this is not specified, all message flows on the execution group will be started.
'-w timeoutValue' time to wait (in seconds) for message flows to start (Default=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
an26100_