Comando mqsistartmsgflow

Utilize o comando mqsistartmsgflow para iniciar os fluxos de mensagens.

Plataformas Suportadas

Propósito

Inicie 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 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) 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 comando 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

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

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009. Todos os Direitos Reservados.
Última atualização : 2009-02-13 15:33:39

an26100_