Este provavelmente deve ser meu primeiro post sobre MQ, mas confesso: eu estava muito animado para começar a escrever.

Ultimamente tenho tido pouco tempo para postar coisas novas. Isso provavelmente é apenas uma desculpa para escrever algo novamente.

Nas linhas a seguir, darei uma introdução aos comandos MQ mais usados.

Existem diferentes tipos de comandos MQ:

  • Comandos informativos — Estes são comandos para obter informações sobre a instalação do IBM MQ e gerenciadores de filas
  • Comandos de controle — Comandos para parar, iniciar e configurar o MQ
  • Comandos de exemplo — Comandos que são fornecidos com o código-fonte como exemplos de programação, mas são um pouco úteis para o não programador

Comandos de informação

Comandos informativos são comandos que são usados para exibir vários tipos de informações sobre o funcionamento do MQ. A lista que se segue não é exaustiva; apenas os comandos mais comuns são mostrados.

  • dspmq
    Exibir informações de status sobre gerenciadores de filas
  • dspmqaut
    Exibe as autorizações (permissões) de um objeto IBM MQ específico.
  • dspmqinf
    Exibir informações de configuração do IBM MQ (somente AIX, Linux e Windows).
  • dspmqinst
    Exibe entradas de instalação do mqinst.ini no AIX, Linux e Windows e exibe informações de direitos de licença.
  • dspmqver
    Exibir informações de versão e construção do IBM MQ.

DSPMQ

Analogamente ao comando ls UNIX e Linux, dspmq é provavelmente o comando MQ mais usado. Ele exibe o status de todos os gerenciadores de filas configurados em uma máquina das instâncias de um gerenciador de filas de várias instâncias (se você usar a opção de linha de comando -x).

Veja um exemplo:

mqm@ubuntuvm1:~$ dspmq
QMNAME(MQ01) STATUS(Running)
QMNAME(mqcl1n01) STATUS(Running)

Como você pode ver, tenho dois gerenciadores de filas em execução.

DSPMQAUT

O comando dspmqaut será abordado em um artigo futuro sobre autorizações de objeto. Basicamente é um comando que pode ser substituído por comandos MQSC e só existe para compatibilidade com versões anteriores (7.x e mais antigas) do MQ.

DSPMQINF

O comando dspmqinf é usado para exibir informações sobre um gerenciador de filas. Ele é usado em conjunto com o comando addmqinf, que é uma etapa necessária para configurações de alta disponibilidade de várias instâncias e failover.

DSPMQINST

Este comando mostra informações sobre as instalações MQ presentes em uma máquina.

mqm@ubuntuvm1:~$ dspmqinst
InstName: Installation1
InstDesc:
Identifier: 1
InstPath: /opt/mqm
Version: 9.2.0.0
Primary: Yes
State: Available
LicenseType: Production
Entitlement: IBM MQ Advanced
Fixes:

Como você pode ver acima, há apenas uma instalação MQ do MQ versão 9.2.0.0 no diretório /opt/mqm.

DSPMQVER

Finalmente, o dspmqver exibe informações sobre a(s) versão(ões) do MQ instalada(s) no sistema.

mqm@ubuntuvm1:~$ dspmqver
Name: IBM MQ
Version: 9.2.0.0
Level: p920-L200709
BuildType: IKAP — (Production)
Platform: IBM MQ for Linux (x86-64 platform)
Mode: 64-bit
O/S: Linux 5.4.0–72-generic
O/S Details: Ubuntu 20.04.2 LTS (Focal Fossa)
InstName: Installation1
InstDesc:
Primary: Yes
InstPath: /opt/mqm
DataPath: /var/mqm
MaxCmdLevel: 920
LicenseType: Production

Embora algumas dessas informações também sejam exibidas na saída do comando dspmqinst, esta é ligeiramente diferente.

Comandos de controle

Os comandos de controle são aqueles que você pode usar para parar, iniciar e configurar o MQ.

Os mais utilizados são:

  • strmqm
    Iniciar um gerenciador de filas
  • endmqm
    Parar um gerenciador de filas
  • strmqweb
    Inicie o console da Web MQ e a interface de administração REST
  • endmqweb
    Pare o console da Web MQ e a interface de administração REST
  • addmqinf
    Adicionar informações de configuração MQ
  • amqfsck
    Verifique sistemas de arquivos para suporte MQ
  • crtmqm
    Criar um gerenciador de filas
  • dltmqm
    Excluir um gerenciador de filas

StrmqM

Esse comando é usado para iniciar um gerenciador de filas.

strmqm MQ1

O comando acima inicia o gerenciador de filas MQ1.

ENDMQM

Esse comando é usado para parar um gerenciador de filas. Como o comando strmqm, sua sintaxe é muito simples:

endmqm MQ1

O comando endmqm tem outras opções, mas elas devem ser usadas apenas se absolutamente necessário.

StrmqWeb

O comando strmqweb é usado para iniciar o IBM MQ Web Console e o serviço de Administração REST. Ele não tem opções de linha de comando.

DSPMQWEB

Esse comando é usado para exibir o status do IBM MQ Web Console.

EndMQWEB

Isso, como o próprio nome sugere, é usado para parar o IBM MQ Web Console e o serviço de Administração REST.

addmqinf

Esse comando é usado ao instalar gerenciadores de filas altamente disponíveis ou de várias instâncias.

Ele é usado em conjunto com o comando dspmqinf.

AMQFSCK

Esse comando é útil quando você deseja testar a compatibilidade do sistema de arquivos com o recurso de várias instâncias MQ.

CTRMQM

Este é um dos comandos MQ mais importantes. Ele é usado para criar um gerenciador de filas. Esse comando leva pelo menos o nome do gerenciador de filas a ser criado.

DLTMQM

Esse comando é usado para remover um gerenciador de filas do sistema.

ATENÇÃO: seus efeitos são irreversíveis. Depois de excluir um gerenciador de filas, para usá-lo novamente, você precisa recriá-lo.

Comandos de exemplo

Existem alguns comandos de exemplo que são úteis, especialmente para solução de problemas e testes.

  • amqsput
    Colocar mensagens em filas
  • amqsget
    Obter mensagens de filas
  • amqsrua
    Exibir métricas e informações de monitoramento geradas pelo MQ
  • amqsmon
    Obter estatísticas ou informações contábeis geradas pelo MQ

AMQSPUT

Esse comando permite gravar mensagens em uma fila. Ele é invocado da seguinte maneira:

/usr/mqm/samp/bin/amqsput \[\]

no AIX.

No Linux, use o seguinte:

/opt/mqm/samp/bin/amqsput \[\]

O parâmetro é opcional.

As mensagens a serem enviadas são lidas de padrão em, uma mensagem por linha.

Este utilitário é fornecido com o código-fonte em C, no arquivo /usr/mqm/samp/amqsput0.c (no local de instalação padrão do AIX) ou /opt/mqm/samp/amqsput0.c (no local de instalação padrão do Linux).

AMQSGET

Este utilitário de exemplo é a contraparte do amqsput.

Ele é usado para ler mensagens de uma fila.

Sua invocação é tão amqsput:

/opt/mqm/samp/bin/amqsget \[\]

O parâmetro é opcional.

Este utilitário é fornecido com o código-fonte em C, no arquivo /usr/mqm/samp/amqsget0.c (no local de instalação padrão do AIX) ou /opt/mqm/samp/amqsget0.c (no local de instalação padrão do Linux).

AMQSRUA

Este utilitário permite que você colete informações de desempenho dos tópicos de desempenho do sistema MQ.

Ele será descrito em um post futuro sobre o desempenho do MQ.

Aqmsmon

Esta é uma ferramenta que permite obter estatísticas e dados contábeis do MQ.

Ele será detalhado em um post futuro sobre estatísticas e contabilidade MQ.

Artigo Original