IBM Cloud Docs
Amministrazione di un gestore code mediante MQ Explorer e la riga comandi runmqsc

Amministrazione di un gestore code mediante MQ Explorer e la riga comandi runmqsc

Questa guida illustra come gestire un gestore code IBM MQ on Cloud utilizzando l'applicazione MQ Explorer e l'interfaccia della riga comandi runmqsc.

Explorer di MQ :

MQ Explorer è uno strumento basato su Eclipse per l'amministrazione di IBM MQ che installi su una macchina di tua scelta e che si connette in remoto a uno o più gestori code utilizzando una connessione client. Ci sono programmi di installazione nativi per ambienti Windows e Linux a 64 bit e può essere eseguito su Mac OS tramite un contenitore Docker come descritto nei prerequisiti di seguito.

Il plug-in Eclipse per MQ explorer su Mac OS non supporta, al momento della scrittura, la connessione TLS. Il canale di amministrazione per gestori code MQ on Cloud più recente della versione 9.2.1 revisione 1 avrà TLS abilitato. Questi devono essere gestiti da Linux o Windows.

runmqsc

Come parte del bundle di "client MQ", runqmsc è uno strumento CLI (command-line interface) che ti consente di automatizzare la configurazione dei gestori code MQ eseguendo una serie di passi predefiniti sulla riga di comando o in un file di script. È supportato su una vasta gamma di sistemi operativi, tra cui Windows e Linux (ma al momento non è supportato su Mac OS).

Esistono molte azioni che è possibile eseguire utilizzando MQ Explorer o runmqsc da un client MQ . Puoi:

  • Connetterti a un gestore code
  • Creare una nuova coda
  • Inserire un messaggio in una coda
  • Eliminare una coda

Inoltre, in MQ Explorer, è possibile browse a queue to view messages Nella riga comandi runmqsc, è possibile anche get messages from a queue

Prima di iniziare

  • Un'installazione esistente di IBM MQ Explorer. Le istruzioni per il download e l'installazione per Windows e Linux possono essere ottenute qui e per Mac OS da qui. oppure
  • Un'installazione esistente di IBM MQ Client sulla tua macchina.
  • Scarica il client da qui.
    • Facendo clic sul link HTTP accanto all'ultima versione disponibile dei Client CD verrai indirizzato a Fix Central. Da lì puoi cercare e selezionare il bundle del client Redist (ridistribuibile) per la piattaforma del tuo sistema operativo. Questo includerà le applicazioni di esempio e runmqsc.
    • Una volta scaricato, decomprimi il bundle in un'ubicazione di tua scelta.
    • Prendi nota del percorso completo della directory bin, la cui ubicazione dipenderà da dove hai scelto di decomprimere il bundle. Questo percorso verrà indicato come <PATH_TO_BIN_DIR> per il resto di questa attività.
    • Prendi nota del percorso completo della directory che contiene le applicazioni di esempio. Questo percorso verrà indicato come <PATH_TO_SAMPLE_BIN_DIR> per il resto di questa attività.
      • Per Windows, questa sarà la directory bin decompressa nel passo precedente, la cui ubicazione dipenderà da dove hai scelto di decomprimere il bundle.
      • Per Linux, sarà la directory samp/bin decompressa nel passo precedente, la cui ubicazione dipenderà da dove hai scelto di decomprimere il bundle.

Raccogli i dettagli di connessione richiesti

  1. Accedi alla console IBM Cloud.

  2. Fai clic sul menu a tre linee.

  3. Fai clic su Dashboard.

    • Assicurati che il GRUPPO DI RISORSE sia impostato su Tutte le risorse.

  4. Individua e fai clic sulla tua istanza del servizio IBM MQ, che si trova sotto l'intestazione 'Servizi'.

  5. Dall'elenco dei tuoi gestori code, fai clic su quello che vuoi amministrare.

  6. Prendi nota dei valori Nome gestore code, Nome host e Porta da utilizzare nei passi successivi.

  7. Se già conosci il tuo nome utente MQ e la tua chiave API IBM, puoi passare alla sezione successiva di questa attività. Altrimenti, fai clic sulla scheda Amministrazione.

    Immagine che mostra la scheda Amministrazione

  8. Prendi nota del tuo Nome utente MQ per un utilizzo futuro.

  9. Se non hai già una chiave API IBM Cloud esistente:

    • Fai clic su Crea chiave API IBM Cloud.
    • Fai clic su Mostra per visualizzare la chiave API per copiarla e salvarla per un secondo momento o fai clic su Scarica per memorizzare la chiave API in un file.
      • Nota che la chiave API generata in questi passi viene utilizzata per eseguire l'autenticazione con IBM Cloud come utente che l'ha creata. Pertanto, non deve essere condivisa con altri utenti e deve essere memorizzata in modo sicuro.
      • Una chiave API creata tramite il servizio IBM MQ può essere reimpostata dalla scheda Amministrazione del gestore code.
    • Fai clic su Close.

Connetti al tuo gestore code

Utilizzando MQ Explorer:

  1. Avvia IBM MQ Explorer.

  2. Nel pannello 'MQ Explorer - Navigator', espandi IBM MQ.

  3. Fai clic con il tasto destro del mouse su Gestori code.

  4. Fai clic su Aggiungi gestore code remoto....

    Immagine che mostra l'ubicazione del pulsante Aggiungi gestori code remoti

  5. Immetti il nome del gestore code che vuoi amministrare.

  6. Fai clic su Next.

  7. Immetti il nome host che hai annotato nel passo 2.

  8. Sovrascrivi il numero di porta con quello che hai annotato nel passo 2.

  9. Sovrascrivi il nome del canale di connessione del server con CLOUD.ADMIN.SVRCONN.

    Immagine che mostra i campi di connessione completi

  10. Fai clic su Next.

  11. Fai clic su Next.

  12. Seleziona la casella di spunta 'Abilita identificazione utente'.

  13. Deseleziona la casella di spunta 'Modalità compatibilità identificazione utente'.

  14. Immetti il tuo nome utente MQ come ID utente.

Immagine che mostra i campi nome utente completi

  1. Fai clic su Finish.
  2. Incolla la tua chiave API della piattaforma nella casella di testo 'Password'.
  3. Fai clic su OK.

La connessione del tuo gestore code viene ora visualizzata nella cartella Gestori code nel pannello 'MQ Explorer - Navigator'.

Utilizzo di runmqsc

  1. Apri una shell di comandi da utilizzare nei passi successivi.
  2. Esporta la variabile 'MQSERVER':
    • Linux: export MQSERVER="CLOUD.ADMIN.SVRCONN/TCP/<Hostname>(<Port>)"
    • Windows (prompt dei comandi): set MQSERVER=CLOUD.ADMIN.SVRCONN/TCP/<Hostname>(<Port>)
    • Windows (PowerShell): $env:MQSERVER="CLOUD.ADMIN.SVRCONN/TCP/<Hostname>(<Port>)"
  3. Esegui <PATH_TO_BIN_DIR>/runmqsc -c -u <your MQ username> -w60 <QUEUE_MANAGER_NAME>
  4. Immetti la tua chiave API della piattaforma quando viene richiesta una password.

Crea una nuova coda di test chiamata 'DEV.TEST.1'

Utilizzando MQ Explorer:

Nella vista 'MQ Explorer - Navigator > IBM MQ > Gestori code':

  1. Espandi la voce relativa al tuo gestore code.
  2. Fai clic con il tasto destro del mouse su Code.
  3. Selezionare 'Nuovo'> 'Coda locale ...'.
  4. Immetti 'DEV.TEST.1' nella casella di testo 'Nome'.
  5. Fai clic su Finish.
  6. Fai clic su OK.

La tua nuova coda viene visualizzata nell'elenco di code.

Utilizzo di runmqsc

I nomi coda devono iniziare con DEV.* (esempio: DEV.myQueue) poiché gli utenti dell'applicazione sono stati configurati solo con l'accesso a questo prefisso.

Nella stessa shell utilizzata nei passi precedenti:

  1. Esegui DEFINE QLOCAL(DEV.TEST.1)
  2. Esegui DISPLAY QLOCAL(DEV.TEST.1)
    • Vengono visualizzati i dettagli della coda 'DEV.TEST.1'.
  3. Esegui end
    • La sessione runmqsc viene chiusa.
    • Mantieni il prompt da utilizzare nei passi successivi.

Inserisci un messaggio nella coda di test

Utilizzando MQ Explorer:

  1. Fai clic con il tasto destro del mouse sulla coda 'DEV.TEST.1'.
  2. Fare clic su 'Inserisci messaggio di prova ...'.
  3. Immetti un messaggio di prova nella casella di testo 'Dati messaggio'.
  4. Fai clic su Inserisci messaggio.
  5. Fai clic su Close.
  6. Fai clic su Aggiorna nel pannello 'Code'.

Puoi vedere che la 'Profondità coda corrente' per 'DEV.TEST.1' è ora 1.

Utilizzo di runmqsc:

Utilizzeremo il programma di esempio amqsputc per assistere nell'inserimento dei messaggi nella coda di prova. Nella stessa shell utilizzata nei passi precedenti:

  1. Esporta la variabile 'MQSAMP_USER_ID':
    • Linux: export MQSAMP_USER_ID="<your MQ username>"
    • Windows (prompt dei comandi): set MQSAMP_USER_ID=<your MQ username>
    • Windows (PowerShell): $env:MQSAMP_USER_ID="<your MQ username>"
  2. Esegui <PATH_TO_SAMPLE_BIN_DIR>/amqsputc DEV.TEST.1 <your QMGR name>
  3. Immetti la tua chiave API della piattaforma quando viene richiesta una password.
  4. Immetti un messaggio di prova.
  5. Premi due volte Enter per uscire dall'esempio amqsputc.

Esamina un messaggio nella coda di test

Questa operazione è univoca per MQ Explorer e non può essere eseguita utilizzando la riga comandi.

  1. Fai clic con il tasto destro del mouse sulla coda 'DEV.TEST.1'.
  2. Fare clic su 'Sfoglia messaggi ...'.
  3. Conferma di poter vedere il messaggio di prova e fai clic su Chiudi.

Richiama un messaggio utilizzando il programma di esempio amqsgetc

Questo passo è univoco per runmqsc e non può essere raggiunto su MQ Explorer.

Nella stessa shell utilizzata nei passi precedenti:

  1. Esegui <PATH_TO_SAMPLE_BIN_DIR>/amqsgetc DEV.TEST.1 <your QMGR name>
  2. Immetti la tua chiave API della piattaforma quando viene richiesta una password.

Viene visualizzato il tuo messaggio di prova.

Dopo un breve periodo, il programma di esempio amqsputc dovrebbe terminare dopo non aver trovato altri messaggi.

Elimina la coda di test

Utilizzo di MQ Explorer

  1. Fai clic con il tasto destro del mouse sulla coda 'DEV.TEST.1'.
  2. Fai clic su 'Elimina'.
  3. Fai clic su 'Elimina'.
  4. Seleziona la casella 'Elimina tutti i messaggi dalla coda'.
  5. Fai clic su Delete.
  6. Fai clic su OK.

Puoi ora vedere che la coda 'DEV.TEST.1' è stata rimossa dall'elenco di code.

Utilizzo di runmqsc

Nella stessa shell utilizzata nei passi precedenti:

  1. Esegui <PATH_TO_BIN_DIR>/runmqsc -c -u <your MQ username> -w60 <QUEUE_MANAGER_NAME>
  2. Immetti la tua chiave API della piattaforma quando viene richiesta una password.
  3. Esegui DELETE QLOCAL(DEV.TEST.1)
    • Ricevi un messaggio che indica che la coda è stata eliminata.
  4. Esegui DISPLAY QLOCAL(DEV.TEST.1) per dimostrare che la coda è stata eliminata.
    • Ricevi un messaggio che indica che la coda non è stata trovata.
  5. Esegui end
    • La sessione runmqsc viene chiusa.

Conclusione

Hai correttamente:

  • Connesso a un gestore code utilizzando MQ Explorer o runmqsc e creato una nuova coda di verifica
  • Inserire un messaggio di verifica nella coda di verifica
  • Sfogliare la coda di verifica per visualizzare il messaggio di verifica oppure utilizzare amqsgetc per visualizzare il messaggio di verifica
  • Cancellato ed eliminato la coda di test da ripulire

Passi successivi

Ora che hai imparato correttamente come gestire il tuo gestore code utilizzando MQ explorer e runmqsc, prova quanto segue: