Comando mqsideleteexecutiongroup

Plataformas Suportadas

Finalidade

Utilize o comando mqsideleteexecutiongroup para excluir um grupo de execução de 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.

Se você estiver excluindo um grupo de execução para o qual uma implementação foi feita anteriormente, também deverá iniciar o intermediário antes de emitir esse comando.

Sintaxe

Parâmetros

-b BrokerName
(Requerido) O nome do intermediário no qual o grupo de execução reside.
-e ExecutionGroupName
(Requerido) O nome do grupo de execução a ser excluído.
-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, de espera antes do grupo de execução ser excluído; 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 excluir 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 a conclusão do pedido e a exclusão do grupo de execução obtiverem êxito. Se o comando era para excluir um grupo de execução para o qual uma implementação foi feita anteriormente, esse código de retorno significa que o intermediário parou e liberou todos os recursos associados a esse grupo de execução, por exemplo, fluxos de mensagens.
2
(Falha) Indica que o grupo de execução não pôde ser excluído 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'.

   mqsideleteexecutiongroup -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'.

   mqsideleteexecutiongroup –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 limpar quaisquer recursos e enviar a saída para o trace.txt.

  mqsideleteexecutiongroup –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
an26010_