Comando mqsideleteexecutiongroup

Utilize o comando mqsideleteexecutiongroup para remover um grupo de execução de um intermediário.

Plataformas Suportadas

Propósito

Você deve iniciar o Configuration Manager 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) 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"/>
Nota: 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

Nos sistemas Windows, Linux e UNIX, o ID do usuário utilizado para executar este comando deve ser membro do grupo mqm.

O comando obtém sucesso apenas se o ID deste usuário possuir a autoridade correta definida na lista de controle de acesso para o 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

O comando mqsideleteexecutiongroup 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 é denominado QMGR e está atendendo em fred.abc.com:1414, exclua um grupo de execução denominado 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, exclua um grupo de execução denominado EG2 no intermediário BROKER.

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

No domínio especificado pelo arquivo domain2.configmgr, exclua um grupo de execução EG3 no intermediário FRED. Aguarde cinco minutos para que o Configuration Manager arrume qualquer recurso e envie a saída para trace.txt.

  mqsideleteexecutiongroup –n domain2.configmgr –b FRED –e EG3 –w 300 –v trace.txt
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

an26010_