Comando mqsistopmsgflow

Piattaforme supportate

Scopo

Utilizzare il comando mqsistopmsgflow per arrestare i flussi di messaggi.

Sintassi

Parametri

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

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

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

Su un singolo comando è possibile specificare un unico flusso di messaggi. Tuttavia, se non si specifica questo parametro, vengono arrestati 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 arresto è stato completato; il valore predefinito è 60.
-v TraceFileName
(Facoltativo) Invia le informazioni della traccia di debug interna al file specificato.

Autorizzazione

Per arrestare 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 non è possibile raggiungere Gestione configurazione.
99
Indica che gli argomenti forniti al programma di utilità non sono validi.

Esempi

Arresta tutti i flussi di messaggi sul gruppo di esecuzione default 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 gruppo di esecuzione sono riportati come arrestati oppure all'esaurimento del tempo predefinito di un minuto.

   mqsistopmsgflow –n cm1.configmgr –b B1 -e default

Arresta il flusso di messaggi flow1 sul gruppo di esecuzione default 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 il flusso di messaggi è riportato come arrestato oppure all'esaurimento del tempo predefinito di un minuto.

   mqsistopmsgflow –n cm1.configmgr –b B1 -e default -m flow1

Immettere mqsistopmsgflow per visualizzare informazioni relative all'uso:

> mqsistopmsgflow 
BIP1025I: Arresta i flussi di messaggi.

> Sintassi:
mqsistopmsgflow (-n cfgParameterFileName | (-i ipAddress -p port -q qMgr))
 -b brokerName [-e executionGroupName [-m flowName]] [-w timeoutValue]
[-v traceFileName]
Opzioni comando:
'-n cfgParameterFileName' File 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 arrestare i flussi di messaggi
'-e executionGroupName' Nome del gruppo di esecuzione su cui arrestare i flussi di messaggi. 
Se non viene specificato, tutti i flussi di messaggi del broker saranno arrestati.
'-m flowName' Nome del flusso di messaggi da avviare. 
Se non è specificato, verranno arrestati tutti i flussi di messaggi sul gruppo di esecuzione.
'-w timeoutValue' Tempo di attesa (in secondi) per l'arresto 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
an26110_