IBM Cloud Docs
Administrando um gerenciador de filas usando o MQ Explorer e a linha de comandos runmqsc

Administrando um gerenciador de filas usando o MQ Explorer e a linha de comandos runmqsc

Este guia documenta como administrar um gerenciador de filas do IBM MQ on Cloud usando o aplicativo MQ Explorer e a interface de linha de comandos runmqsc.

MQ Explorer:

O MQ Explorer é uma ferramenta baseada no Eclipse para administrar o IBM MQ que você instalará em uma máquina de sua preferência e que se conecta remotamente a um ou mais gerenciadores de filas usando uma conexão do cliente. Existem instaladores nativos para ambientes Windows e Linux de 64 bits e eles podem ser executados no Mac OS por meio de um contêiner do Docker conforme descrito nos pré-requisitos abaixo.

O plug-in do Eclipse para o MQ Explorer no Mac OS não suporta, no momento da elaboração deste documento, a conexão TLS. O canal de administração para os gerenciadores de filas do MQ on Cloud mais recentes do que a versão 9.2.1 revisão 1 terá o TLS ativado. Eles devem ser administrados por meio do Linux ou Windows.

runmqsc

Parte do pacote configurável dos "clientes MQ", runqmsc é uma ferramenta da interface da linha de comandos (CLI) que permite automatizar a configuração de gerenciadores de filas do MQ executando uma série de etapas predefinidas na linha de comandos ou em um arquivo de script. Ele é suportado em uma gama de sistemas operacionais, incluindo o Windows e o Linux (mas não é suportado atualmente no Mac OS).

Existem muitas ações que podem ser executadas usando o MQ Explorer ou o runmqsc por meio de um cliente MQ. É possível

  • Conectar-se a um gerenciador de filas
  • Criar uma nova fila
  • Colocar uma mensagem em uma fila
  • Excluir uma fila

Além disso, no MQ Explorer, é possível browse a queue to view messages Na linha de comando runmqsc, você também pode get messages from a queue

Antes de iniciar

  • Uma instalação existente do IBM MQ Explorer. As instruções de download e de instalação podem ser obtidas aqui para Windows e Linux e aqui para Mac OS. ou
  • Uma instalação existente do IBM MQ Client em sua própria máquina.
  • Faça download do cliente aqui.
    • Clicar no link HTTP ao lado da versão disponível mais recente dos Clientes do CD o levará para a Fix Central. Daí, é possível procurar e selecionar o pacote configurável do cliente Redist (redistribuível) apropriado de sua plataforma do sistema operacional. Isso incluirá os aplicativos de amostra e runmqsc.
    • Depois de transferido por download, descompacte o pacote configurável em um local de sua preferência.
    • Anote o caminho completo para o diretório bin, cujo local dependerá de onde você escolheu descompactar o pacote configurável. Esse caminho será referenciado como <PATH_TO_BIN_DIR> no restante desta tarefa.
    • Anote o caminho completo para o diretório que contém os aplicativos de amostra. Esse caminho será referenciado como <PATH_TO_SAMPLE_BIN_DIR> no restante desta tarefa.
      • Para Windows, esse será o diretório bin descompactado na etapa anterior, cujo local dependerá de onde você escolheu descompactar o pacote configurável.
      • Para Linux, esse será o diretório samp/bin descompactado na etapa anterior, cujo local dependerá de onde você escolheu descompactar o pacote configurável.

Reunir detalhes de conexão necessários

  1. Efetue login no console do IBM Cloud.

  2. Clique no 'menu hambúrguer'.

  3. Clique em Painel.

    • Assegure-se de que RESOURCE GROUP esteja configurado como Todos os recursos.

  4. Localize e clique em sua instância de serviço do IBM MQ, localizada sob o título 'Serviços'.

  5. Na lista de gerenciadores de filas, clique naquele que você deseja administrar.

  6. Anote os valores de Nome do gerenciador de filas, Nome do host e Porta para usar nas próximas etapas.

  7. Se você já souber o Nome do usuário do MQ e a Chave de API do IBM Cloud, será possível ir para a próxima seção desta tarefa. Caso contrário, clique na guia Administração.

    Imagem mostrando a guia Administração

  8. Anote o Nome do usuário do MQ para uso futuro.

  9. Se você ainda não tiver uma chave de API existente do IBM Cloud:

    • Clique em Criar chave de API do IBM Cloud.
    • Clique em Mostrar para exibir a chave de API a ser copiada e salve-a para mais tarde ou clique em Fazer download para armazenar a chave de API em um arquivo.
      • Observe que a chave de API gerada nessas etapas é usada para autenticação no IBM Cloud como o usuário que a criou. Portanto, ela não deve ser compartilhada com nenhum outro usuário e deve ser armazenada com segurança.
      • Uma chave de API criada por meio do serviço IBM MQ pode ser reconfigurada por meio da guia Administração do gerenciador de filas.
    • Clique em Fechar.

Conectar-se ao seu gerenciador de filas

Usando o MQ Explorer:

  1. Inicie o IBM MQ Explorer.

  2. No painel 'MQ Explorer - Navegador', expanda IBM MQ.

  3. Clique com o botão direito em Gerenciadores de filas.

  4. Clique em Incluir gerenciador de filas remotas...

    Imagem mostrando o local do botão de inclusão de gerenciadores de filas remotas

  5. Insira o nome do gerenciador de filas que você deseja administrar.

  6. Clique em Avançar.

  7. Insira o Nome do host anotado na etapa 2.

  8. Sobrescreva o Número da porta com aquele anotado na etapa 2.

  9. Sobrescreva o nome do canal de conexão do servidor com CLOUD.ADMIN.SVRCONN.

    Imagem mostrando os campos de conexão completos

  10. Clique em Avançar.

  11. Clique em Avançar.

  12. Marque a caixa de seleção para 'Ativar identificação do usuário'.

  13. Desmarque a caixa de seleção para 'Modo de compatibilidade de identificação do usuário'.

  14. Digite seu Nome do usuário do MQ como o ID do usuário.

Imagem mostrando os campos de nome do usuário completos

  1. Clique em Finish.
  2. Cole a chave de API da plataforma na caixa de texto 'Senha'.
  3. Clique em OK.

Sua conexão do gerenciador de filas agora aparece sob a pasta Gerenciadores de filas no painel 'MQ Explorer - Navegador'.

Usando runmqsc

  1. Abra um shell de comando para usar nas próximas etapas.
  2. Exporte a variável 'MQSERVER':
    • Linux: export MQSERVER="CLOUD.ADMIN.SVRCONN/TCP/<Hostname>(<Port>)"
    • Windows (prompt de comandos): set MQSERVER=CLOUD.ADMIN.SVRCONN/TCP/<Hostname>(<Port>)
    • Windows (PowerShell): $env:MQSERVER="CLOUD.ADMIN.SVRCONN/TCP/<Hostname>(<Port>)"
  3. Executar o <PATH_TO_BIN_DIR>/runmqsc -c -u <your MQ username> -w60 <QUEUE_MANAGER_NAME>
  4. Insira sua chave de API da plataforma quando uma senha for solicitada.

Criar uma nova fila de teste chamada 'DEV.TEST.1'

Usando o MQ Explorer:

Na visualização do 'MQ Explorer - Navegador > IBM MQ > Gerenciadores de filas':

  1. Expanda a entrada para o gerenciador de filas.
  2. Clique com o botão direito em Filas.
  3. Select 'New' > 'Fila local...'.
  4. Digite 'DEV.TEST.1' na caixa de texto 'Nome'.
  5. Clique em Finish.
  6. Clique em OK.

Sua nova fila aparece na lista de filas.

Usando runmqsc

Os nomes de filas devem começar com DEV.* (exemplo: DEV.myQueue), pois os usuários do aplicativo foram configurados com acesso somente a esse prefixo.

No mesmo shell usado nas etapas anteriores:

  1. Executar o DEFINE QLOCAL(DEV.TEST.1)
  2. Executar o DISPLAY QLOCAL(DEV.TEST.1)
    • Os detalhes da fila 'DEV.TEST.1' são exibidos.
  3. Executar o end
    • A sessão runmqsc é fechada.
    • Retenha o prompt para usar nas próximas etapas.

Colocar uma mensagem na fila de teste

Usando o MQ Explorer:

  1. Clique com o botão direito na fila 'DEV.TEST.1'.
  2. Clique em 'Colocar mensagem de teste...'.
  3. Digite uma mensagem de teste na caixa de texto 'Dados da mensagem'.
  4. Clique em Colocar mensagem.
  5. Clique em Fechar.
  6. Clique em Atualizar no painel 'Filas'.

É possível ver que a 'Profundidade da fila atual' para 'DEV.TEST.1' agora é 1.

Usando o runmqsc:

Vamos fazer uso do programa de amostra amqsputc para ajudar na colocação de mensagens na fila de teste. No mesmo shell usado nas etapas anteriores:

  1. Exporte a variável 'MQSAMP_USER_ID':
    • Linux: export MQSAMP_USER_ID="<your MQ username>"
    • Windows (prompt de comandos): set MQSAMP_USER_ID=<your MQ username>
    • Windows (PowerShell): $env:MQSAMP_USER_ID="<your MQ username>"
  2. Executar o <PATH_TO_SAMPLE_BIN_DIR>/amqsputc DEV.TEST.1 <your QMGR name>
  3. Insira sua chave de API da plataforma quando uma senha for solicitada.
  4. Digite uma mensagem de teste.
  5. Pressione Enter duas vezes para sair da amostra amqsputc.

Procurar uma mensagem na fila de teste

Esta etapa é exclusiva para o MQ Explorer e não pode ser realizada usando a linha de comandos.

  1. Clique com o botão direito na fila 'DEV.TEST.1'.
  2. Clique em 'Procurar mensagens...'.
  3. Confirme que pode ver sua mensagem de teste e, em seguida, clique em Fechar.

Obter uma mensagem usando o programa de amostra amqsgetc

Esta etapa é exclusiva para o runmqsc e não pode ser realizada no MQ Explorer.

No mesmo shell usado nas etapas anteriores:

  1. Executar o <PATH_TO_SAMPLE_BIN_DIR>/amqsgetc DEV.TEST.1 <your QMGR name>
  2. Insira sua chave de API da plataforma quando uma senha for solicitada.

Sua mensagem de teste é exibida.

Após um curto período, o programa de amostra amqsputc deve terminar depois de não localizar mais mensagens.

Excluir a fila de teste

Usando o MQ Explorer

  1. Clique com o botão direito na fila 'DEV.TEST.1'.
  2. Clique em 'Excluir'.
  3. Clique em 'Excluir'.
  4. Marque a caixa 'Limpar todas as mensagens da fila'.
  5. Clique em Excluir.
  6. Clique em OK.

É possível ver que a fila 'DEV.TEST.1' foi removida da lista de filas.

Usando runmqsc

No mesmo shell usado nas etapas anteriores:

  1. Executar o <PATH_TO_BIN_DIR>/runmqsc -c -u <your MQ username> -w60 <QUEUE_MANAGER_NAME>
  2. Insira sua chave de API da plataforma quando uma senha for solicitada.
  3. Executar o DELETE QLOCAL(DEV.TEST.1)
    • Você recebe uma mensagem informando que a fila foi excluída.
  4. Execute DISPLAY QLOCAL(DEV.TEST.1) para provar que a fila foi excluída.
    • Você recebe uma mensagem informando que a fila não foi localizada.
  5. Executar o end
    • A sessão runmqsc é fechada.

Conclusão

Você foi bem-sucedido quando:

  • Conectou-se a um gerenciador de filas usando o MQ Explorer ou o runmqsc e criou uma nova fila de teste
  • Colocou uma mensagem de teste na fila de teste
  • Navegou na fila de teste para visualizar a mensagem de teste ou usou amqsgetc para visualizá-la
  • Limpou e excluiu a fila de teste a ser limpa

Próximas etapas

Agora que você aprendeu com sucesso como administrar seu gerenciador de filas usando o MQ Explorer e o runmqsc, experimente o seguinte: