Comando mqsistartmsgflow

Piattaforme supportate

Scopo

Utilizzare il comando mqsistartmsgflow per avviare i flussi di messaggi.

Sintassi

Parametri

-b BrokerName
(Obbligatorio) Il nome del broker su cui avviare il flusso di messaggi.

Se non si specificano gli indicatori -e e -m, vengono avviati tutti i flussi di messaggi sul broker.

-e ExecutionGroupName
(Facoltativo) Il nome del gruppo di esecuzione su cui vengono avviati i flussi di messaggi.
-m msgFlowName
(Facoltativo) Il nome del flusso di messaggi avviato.

Su un singolo comando è possibile specificare un unico flusso di messaggi. Tuttavia, se non si specifica questo parametro, vengono avviati tutti i flussi di messaggi sul gruppo di esecuzione o broker.

Se si specifica questo indicatore è necessario inoltre specificare l'indicatore -e.

-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, espresso in secondi, che il programma di utilità attende per accertarsi che il comando di avvio è stato completato; il valore predefinito è 60.
-v TraceFileName
(Facoltativo) Invia le informazioni della traccia di debug interna al file specificato.

Autorizzazione

Per avviare il flusso di messaggi è necessario disporre delle autorizzazioni sufficienti definite nell'ACL (Access Control List) di Gestione configurazione.

Le autorizzazioni richieste sono le stesse di quelle richieste per effettuare analoghe funzioni in Message Brokers Toolkit; 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 lo stato di tutti i flussi di messaggi è stato aggiornato.
2
(Esito negativo) Indica che, per una qualsiasi ragione, per almeno un flusso di messaggi non è possibile inserire lo stato corretto.
98
Indica che Gestione configurazione non può essere raggiunto.
99
Indica che gli argomenti forniti al programma di utilità non sono validi.

Esempi

Avvia tutti i flussi di messaggi sul broker B1, che è gestito da Gestione configurazione i cui dettagli di connessione sono descritti in cm1.configmgr. Il controllo viene restituito al caller quando tutti i flussi di messaggi nel broker sono riportati come avviati oppure all'esaurimento del tempo predefinito di un minuto.

   mqsistartmsgflow –n cm1.configmgr –b B1

Avvia tutti i flussi di messaggi sul broker B1, che è gestito da Gestione configurazione i cui dettagli di connessione sono descritti in cm1.configmgr. Il controllo viene restituito al caller quando tutti i flussi di messaggi nel broker sono riportati come avviati oppure dopo due minuti di tempo.

   mqsistartmsgflow –n cm1.configmgr –b B1 –w 120

Avvia tutti i flussi di messaggi sul broker B1 che è gestito da Gestione configurazione. Gestione configurazione si trova sul gestore code QM1 presente sull'host locale: 1414.

 mqsistartmsgflow –q QM1 –i localhost –p 1414 –b B1

Immettere mqsistartmsgflow per visualizzare informazioni relative all'uso:

> mqsistartmsgflow 
BIP1024I: Avvia i flussi di messaggi.

> Sintassi:
mqsistartmsgflow (-n cfgParameterFileName | (-i ipAddress -p port -q qMgr))
 -b brokerName [-e executionGroupName [-m flowName]] [-w timeoutValue]
[-v traceFileName]
Opzioni comando:
'-n cfgParameterFileName' File contenente i parametri di connessione Gestione configurazione(.configmgr)
'-i ipAddress' Indirizzo IP o nome host di Gestione configurazione
'-p port' Numero di porta di Gestione configurazione
'-q qMgr' Gestore code di Gestione configurazione
'-b brokerName' Nome del broker su cui avviare i flussi di messaggi
'-e executionGroupName' Nome del gruppo di esecuzione su cui avviare i flussi di messaggi. 
Se non è specificato, verranno avviati tutti i flussi di messaggi sul broker.
'-m flowName' Nome del flusso di messaggi da avviare. 
Se non è specificato, verranno avviati tutti i flussi di messaggi sul gruppo di esecuzione.
'-w timeoutValue' Tempo di attesa (in secondi) per l'avvio dei flussi di messaggi (valore predefinito=60)
'-v traceFileName' Invio della traccia interna verbose al file specificato.
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
an26100_