Comando mqsilist (elenco risorse)

Piattaforme supportate

Scopo

Sulle piattaforme Windows e sui sistemi Linux e UNIX, utilizzare il comando mqsilist per ottenere un elenco di tutti i componenti installati sul sistema, tutti i gruppi di esecuzione definiti in uno specifico broker o tutti i flussi di messaggi contenuti in un gruppo di esecuzione denominato in un determinato broker.

Sulle piattaforme Windows e sui sistemi Linux e UNIX, l'output è indirizzato su stdout.

Da una console z/OS, utilizzare il comando list per ottenere un elenco di tutti i gruppi di esecuzione definiti in uno specifico broker o tutti i flussi di messaggi contenuti in un gruppo di esecuzione denominato in un determinato broker.

Sintassi

Piattaforme Windows e sistemi Linux e UNIX

Se non si specifica alcun parametro quando si immette questo comando, viene visualizzato un elenco di nomi di gestori code e componenti per ciascun componente creato in questo sistema, nel formato:
BIP8099I: Broker: brokername - queuemanagername
BIP8099I: ConfigMgr: configmgrname - queuemanagername
BIP8099I: UserNameServer: UserNameServer - queuemanagername
BIP8071I: Comando completato con esito positivo

z/OS

Sinonimo: l

Se non si specifica alcun parametro quando si immette questo comando, viene visualizzato un elenco di gruppi di esecuzione.

Il comando list viene emesso solo sul nome di attività del broker. Ad esempio:
F MQP1BRK,list
L'output è l'elenco di gruppi di esecuzione e di ID di elaborazione nel formato:
BIP8130I: Execution Group: <name> -<process ID> 
BIP8071I: Comando completato con esito positivo
Se si specifica un gruppo di esecuzione, ad esempio:
F MQP1BRK, list e='exgrp1'		
l'output è un elenco di flussi di messaggi nel formato:
BIP8131I: Messageflow: <MessageFlowName> 
BIP8071I: Comando completato con esito positivo

Parametri

Piattaforme Windows e sistemi Linux e UNIX

-a
(Facoltativo) Elenca tutti i componenti installati nel sistema.
Se si utilizza questa opzione sui broker da un precedente rilascio del prodotto, si ottiene il seguente messaggio:
BIP8221I: <Component>: <ComponentName> (<Version>) - <Queue Manager>  
brokername
(Facoltativo) Il nome del broker per il quale si desidera ottenere l'elenco di risorse. Questo deve essere un broker distribuito. Viene visualizzato un elenco di gruppi di esecuzione configurati su questo broker e il relativo ID di elaborazione (pid).

Tutte le piattaforme

-e egroup
(Facoltativo) Seleziona un gruppo di esecuzione all'interno di un broker. Specificare l'etichetta del gruppo di esecuzione per il quale si desidera ottenere l'elenco di flussi di messaggi. Il comando restituisce un elenco di flussi di messaggi assegnati al gruppo di esecuzione specificato all'interno del broker.

Il broker specificato deve essere attivo affinché vengano restituite eventuali informazioni del flusso di messaggi.

Autorizzazione

Sui sistemi Linux e UNIX, l'ID utente deve essere un membro del gruppo mqbrkrs.

Sulle piattaforme Windows, se è stato specificato un nome di broker e l'indicatore -e, l'ID utente utilizzato per richiamare questo comando deve appartenere al gruppo mqbrkrs.

Risposte

  • BIP8013 Il componente non esiste
  • BIP8020 Impossibile accedere al database
  • BIP8029 Broker non configurato
  • BIP8038 Opzione di comando non supportata
  • BIP8039 Gruppo di esecuzione non disponibile
  • BIP8040 Impossibile collegarsi al database
  • BIP8158 Formato non valido per il comando (solo per z/OS)
  • BIP8159 Parametro sconosciuto "..." (solo per z/OS)

Esempi

Piattaforme Windows e sistemi Linux e UNIX:
mqsilist WBRK_BROKER -e DefaultEG
mqsilist DatabaseInstanceMgr
z/OS
F MQP1BRK,list e='exgrp1'
Attività correlate
Verifica dei componenti
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
an07250_