Comando mqsideleteexecutiongroup

Piattaforme supportate

Scopo

Utilizzare il comando mqsideleteexecutiongroup per eliminare un gruppo di esecuzione da un broker.

Prima di poter immettere questo comando, è necessario avviare Gestione configurazione, utilizzando mqsistart sulle piattaforme Windows e sui sistemi Linux e UNIX oppure startcomponent su z/OS (fare riferimento a Comando mqsistart).

Se si sta eliminando un gruppo di esecuzione a cui è stata eseguita in precedenza una distribuzione, è necessario inoltre avviare il broker prima di immettere questo comando.

Sintassi

Parametri

-b BrokerName
(Obbligatorio) Il nome del broker su cui risiede il gruppo di esecuzione.
-e ExecutionGroupName
(Obbligatorio) Il nome del gruppo di esecuzione da eliminare.
-n cfgParameterFileName
(Facoltativo) Il nome di un file .configmgr che descrive i parametri di connessione a Gestione configurazione.
Il file è un XML, che utilizza il formato .configmgr salvato dalla GUI di Eclipse. Ad esempio:
<?xml version="1.0" encoding="UTF-8"?>
<configmgr host="localhost" listenerPort="1414" queueManager="QNAME"
           securityExit="test.myExit"/>
Se si sta utilizzando tale file su z/OS è necessario eliminare l'istruzione encoding="UTF-8" dalla prima riga, in modo da lasciare l'istruzione:
<?xml version="1.0"?>
ed eliminare il valore dell'attributo host, in modo da lasciare l'istruzione:
<configmgr host="" listenerPort="1414" queueManager="QNAME"
           securityExit="test.myExit"/>
Nota: Se questo parametro non viene fornito, è necessario fornire i parametri -i, -p e -q.
-i ipAddress
(Facoltativo) Il nome host o l'indirizzo IP di Gestione configurazione.

Se si sta utilizzando questo file su z/OS e si desidera collegarsi all'host locale, è necessario impostare il valore su "".

-p Port
(Facoltativo) Il numero porta di Gestione configurazione.
-q qMgr
(Facoltativo) Il nome del gestore code WebSphere MQ in uso da Gestione configurazione.

Se non vengono forniti i parametri -i, -p e -q, è necessario specificare il parametro -n.

-w timeoutValue
(Facoltativo) Il tempo di attesa, espresso in secondi, prima dell'eliminazione del gruppo di esecuzione; il valore predefinito è 60.
-v TraceFileName
(Facoltativo) Invia la traccia interna verbose al file specificato.

Autorizzazione

E' necessario essere un membro del gruppo 'mqm' e il comando ha esito positivo solo se l'ID utente che esegue il comando dispone della corretta autorizzazione definita nell'ACL (Access Control List) di Gestione configurazione.

Al fine di eliminare un gruppo di esecuzione, è necessario disporre dell'autorizzazione completa sull'oggetto broker; fare riferimento a Autorizzazioni ACL per un elenco delle autorizzazioni che possono essere definite in Gestione configurazione.

Risposte

Questo comando restituisce le seguenti risposte:
0
(Esito positivo) Indica che la richiesta è stata completata con esito positivo e che il gruppo di esecuzione è stato eliminato. Se il comando riguardava l'eliminazione di un gruppo di esecuzione a cui era stata eseguita in precedenza una distribuzione, questo codice di ritorno indica che il broker si è interrotto e che ha liberato tutte le risorse associate a tale gruppo di esecuzione; ad esempio, flussi di messaggi.
2
(Esito negativo) Indica che non è stato possibile eliminare il gruppo di esecuzione per un qualsiasi motivo.
98
Indica che Gestione configurazione non può essere raggiunto.
99
Indica che gli argomenti forniti al programma di utilità non sono validi.

Esempi

Sul dominio controllato da Gestione configurazione il cui gestore code denominato QMGR è in ascolto su fred.abc.com:1414, eliminare un gruppo di esecuzione denominato ‘EG1’ sul broker 'BROKER’.

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

Sul dominio specificato dal file domain1.configmgr, eliminare un gruppo di esecuzione denominato ‘EG2’ sul broker 'BROKER’.

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

Sul dominio specificato dal file domain2.configmgr, eliminare un gruppo di esecuzione ‘EG3’ sul broker ‘FRED’. Attendere cinque minuti affinché Gestione configurazione riordini le eventuali risorse e inviare l'output a trace.txt.

  mqsideleteexecutiongroup –n domain2.configmgr –b FRED –e EG3 –w 300 –v trace.txt
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
an26010_