Comando mqsicreateexecutiongroup

Piattaforme supportate

Scopo

Utilizzare il comando mqsicreateexecutiongroup per aggiungere un nuovo gruppo di esecuzione ad 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).

Prima di poter utilizzare questo comando, è necessario definire il broker in Gestione configurazione.

Sintassi

Parametri

-b BrokerName
(Obbligatorio) Il nome del broker su cui creare il gruppo di esecuzione.
-e ExecutionGroupName
(Obbligatorio) Il nome del nuovo gruppo di esecuzione.
-l
(Facoltativo) Creare un gruppo di esecuzione a 64 bit.
-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 da workbench. 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 -connection.

-w timeoutValue
(Facoltativo) Il tempo di attesa, espresso in secondi, prima della creazione 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 creare 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 nell'archivio di Gestione configurazione è stato creato il gruppo di esecuzione. La volta successiva in cui il broker viene distribuito, il nuovo elenco del gruppo di esecuzione viene inizializzato sul broker.
2
(Esito negativo) Indica che non è stato possibile creare 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, creare un gruppo di esecuzione denominato ‘EG1’ sul broker 'BROKER’.

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

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

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

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

  mqsicreateexecutiongroup –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
an26000_