Comando mqsicreateexecutiongroup

Plataformas Suportadas

Finalidade

Utilize o comando mqsicreateexecutiongroup para incluir um novo grupo de execução em um intermediário.

Você deve iniciar o Configuration Manager, utilizando mqsistart em plataformas Windows e sistemas Linux e UNIX ou startcomponent no z/OS, (consulte Comando mqsistart) antes de emitir esse comando.

O intermediário deve ser definido no Configuration Manager antes desse comando ser utilizado.

Sintaxe

Parâmetros

-b BrokerName
(Requerido) O nome do intermediário no qual o grupo de execução será criado.
-e ExecutionGroupName
(Requerido) O nome do novo grupo de execução.
-l
(Opcional) Crie um grupo de execução de 64 bits.
-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 pelo workbench. 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 não forem fornecidos os parâmetros -i, -p e -q, será necessário especificar o parâmetro -connection.

-w timeoutValue
(Opcional) O tempo, em segundos, de espera antes da criação do grupo de execução; o valor padrão é 60.
-v TraceFileName
(Opcional) Envia o rastreio interno detalhado para o arquivo especificado.

Autorização

Você precisa ser um membro do grupo 'mqm' e o comando somente será bem-sucedido se o ID do usuário que estiver executando o comando tiver a autoridade correta definida na lista de controle de acesso do Configuration Manager.

Para criar um grupo de execução, é necessário ter autoridade de controle completa sobre o objeto do intermediário; 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 grupo de execução foi criado com êxito no repositório do Configuration Manager. Na próxima vez em que o intermediário for implementado, a nova lista de grupos de execução será inicializada no intermediário.
2
(Falha) Indica que o grupo de execução não pôde ser criado 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

No domínio controlado pelo Configuration Manager, cujo gerenciador de filas é chamado QMGR e está atendendo em fred.abc.com:1414, crie um grupo de execução chamado 'EG1' no intermediário 'BROKER'.

   mqsicreateexecutiongroup -i fred.abc.com -p 1414 -q QMGR -b BROKER –e EG1

No domínio especificado pelo arquivo domain1.configmgr, crie um grupo de execução chamado 'EG2' no intermediário 'BROKER'.

   mqsicreateexecutiongroup –n domain1.configmgr –b BROKER –e EG2 

No domínio especificado pelo arquivo domain2.configmgr, crie um grupo de execução 'EG3' no intermediário 'FRED'. Aguarde cinco minutos para o Configuration Manager responder e enviar a saída para o trace.txt.

  mqsicreateexecutiongroup –n domain2.configmgr –b FRED –e EG3 –w 300 –v trace.txt
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
an26000_