Comando mqsicreatebroker

Utilize o comando mqsicreatebroker para criar um broker e seus recursos associados.

Plataformas Suportadas

Finalidade

O comando mqsicreatebroker:
  1. Verifica se o gerenciador de filas especificado do WebSphere MQ existe:
    • Se ele não existir:
      • Se este comando for executado no z/OS, ele relatará um erro e falhará.
      • Se este comando for executado no Linux, no UNIX ou no Windows, ele criará um gerenciador de filas.

        As filas criadas incluem uma DLQ (dead letter queue), SYSTEM.DEAD.LETTER.QUEUE. As configurações de segurança são iguais às de outras filas do WebSphere MQ específicas do broker.

        Se uma mensagem recebida por um fluxo de mensagens não puder ser processada, geralmente ela é restaurada para a fila de entrada. Se ela não puder ser restaurada ou o fluxo de mensagens não estiver configurado para restaurar mensagens ou para executar um processamento de erro alternativo, o broker irá colocar a mensagem na DLQ.

        O comando mqsideletebroker não exclui a DLQ padrão (a menos que o gerenciador de filas seja excluído).

    • Se não existir, verifique se o gerenciador de filas tem a DLQ definida; ela não é criada por este comando em um gerenciador de filas existente, mas é necessária porque o broker coloca mensagens que não podem ser processadas na DLQ.

      Se você utilizar clusters WebSphere MQ em seu domínio, defina o gerenciador de filas antes de executar esse comando e configure o gerenciador de filas no cluster para benefício da administração reduzida e disponibilidade melhorada.

  2. Inicia o gerenciador de filas do WebSphere MQ se ainda não estiver sendo executado, exceto no z/OS.

    Se o gerenciador de filas for criado no Windows por este comando, ele não será iniciado como um serviço. O gerenciador de filas parará se você efetuar logoff. Portanto, você deve permanecer conectado ou alterar o status de inicialização do serviço do gerenciador de filas. Se você bloquear sua estação de trabalho, o gerenciador de filas do WebSphere MQ não será parado.

  3. Conecta-se ao gerenciador de filas associado.
  4. Cria as filas do WebSphere MQ que são necessárias ao broker, se elas não existirem.

    Se você ativar a segurança administrativa, as filas necessárias para este suporte também serão criadas por este comando.

  5. Apenas no Windows, instala um serviço em que o broker é executado.
  6. Cria o broker em um dos modos disponíveis. Se o pacote completo estiver instalado, o padrão do mode será advanced. Se o pacote de avaliação estiver instalado, o mode padrão é trial. Para obter mais informações, consulte Modos de Operação.
  7. Cria um registro para o componente no registro.
  8. Nas plataformas Windows, Linux e UNIX, permite especificar, quando o broker é criado, se o broker pode ser iniciado e parado como um serviço do WebSphere MQ.

Os brokers podem acessar apenas gerenciadores de filas locais, assim, não é possível criar um broker em um gerenciador de filas que esteja em um sistema remoto.

Notas sobre a utilização

Se você migrou do Versão 6.1:

Em versões anteriores do WebSphere Message Broker, parâmetros que você especificou neste comando eram usados pelo broker para fornecer autorização padrão para acesso ao banco de dados: o ID do usuário do banco de dados e a senha (se especificados) ou o ID do usuário do serviço e a senha. Como o broker do Versão 8.0 não usa um banco de dados para seus próprios propósitos, os parâmetro do ID do usuário do banco de dados e da senha foram reprovados. Os parâmetros de ID de serviço do broker e da senha também foram reprovados, exceto no Windows.

Se você migrar um broker a partir de um release anterior, os valores associados serão armazenados e usados para acesso ao banco de dados do usuário padrão como se você tivesse inserido estes valores usando o comando mqsisetdbparms.

Quando você cria um broker do Versão 8.0, é necessário usar o comando mqsisetdbparms para configurar a autorização de acesso ao banco de dados.

Selecione o link apropriado para obter detalhes deste comando no sistema operacional, ou sistemas, que sua empresa utiliza:

Autorização

Nos sistemas Windows XP e Windows Server 2003, o ID do usuário utilizado para executar este comando deve ser membro do grupo Administrators no sistema local.

Nos sistemas Windows 7 e Windows Server 2008, o ID de usuário usado para executar esse comando deve estar executando com privilégios elevados no sistema local:
  • O ID do usuário deve ser membro do grupo Administrators.
  • O comando deve ser executado a partir de um prompt de comandos elevado. Para obter um prompt de comandos elevado, execute o comando mqsicommandconsole e siga o prompt Windows para ativar um novo console do comando elevado.

    Esse console começa com o ambiente mqsiprofile correto a partir do qual os comandos que exigem elevação podem ser executados.

Se você não executar o comando a partir de um console de comandos privilegiado, o comando não será processado com êxito.

Nos sistemas Linux e UNIX, o ID do usuárioutilizado para executar este comando deve ser membro do grupo mqbrkrs.

Nos sistemas z/OS, o Id do usuário utilizado para executar este comando deve ser membro de um grupo que tenha acesso de LEITURA e GRAVAÇÃO ao diretório de componente. O ID do usuário também deve ter acesso a recursos do WebSphere MQ e ao DB2.

Em todos os sistemas, o ID do usuário usado para executar este comando deve ser membro do grupo mqm, porque várias filas são criadas para serem usadas pelo broker.

Utilizando LDAP: assegure-se de que o registro esteja protegido apropriadamente para evitar acesso não autorizado. Não é necessário configurar os parâmetros LdapPrincipal e LdapCredentials no mqsicreatebroker para corrigir a operação do broker. A senha não é armazenada em texto sem formatação no sistema de arquivo.

Filas do WebSphere MQ Criadas

  • SYSTEM.BROKER.ADAPTER.FAILED
  • SYSTEM.BROKER.ADAPTER.INPROGRESS
  • SYSTEM.BROKER.ADAPTER.NEW
  • SYSTEM.BROKER.ADAPTER.PROCESSED
  • SYSTEM.BROKER.ADAPTER.UNKNOWN
  • SYSTEM.BROKER.ADMIN.QUEUE
  • SYSTEM.BROKER.ADMIN.REPLYTODM
  • SYSTEM.BROKER.AGGR.CONTROL
  • SYSTEM.BROKER.AGGR.REPLY
  • SYSTEM.BROKER.AGGR.REQUEST
  • SYSTEM.BROKER.AGGR.TIMEOUT
  • SYSTEM.BROKER.AGGR.UNKNOWN
  • SYSTEM.BROKER.AUTH
  • SYSTEM.BROKER.CONTROL.QUEUE
  • SYSTEM.BROKER.DEPLOY.QUEUE
  • SYSTEM.BROKER.DEPLOY.REPLY
  • SYSTEM.BROKER.EDA.COLLECTIONS
  • SYSTEM.BROKER.EDA.EVENTS
  • SYSTEM.BROKER.EXECUTIONGROUP.QUEUE
  • SYSTEM.BROKER.EXECUTIONGROUP.REPLY
  • SYSTEM.BROKER.INTER.BROKER.COMMUNICATIONS
  • SYSTEM.BROKER.MODEL.QUEUE
  • SYSTEM.BROKER.TIMEOUT.QUEUE
  • SYSTEM.BROKER.WS.ACK
  • SYSTEM.BROKER.WS.INPUT
  • SYSTEM.BROKER.WS.REPLY

A autoridade de acesso é concedida para o grupo WebSphere Message Broker grupo mqbrkrs a todas estas filas. Se a DLQ estiver ativada, ela também terá a mesma autoridade.

Respostas

Se você executar o comando mqsicreatebroker e ele falhar, resolva o problema que causou a falha:
  • Verifique as respostas; consulte Respostas a Comandos.
  • Verifique os logs de erros; consulte Registro de Erros Local.
  • Verifique as mensagens de erro no log de erros; você pode procurar por mensagens de erro no centro de informações.
Quando você executar o mesmo comando novamente, poderá receber uma série de mensagens indicando itens que não podem ser criados. O recebimento dessas mensagens não indica um problema com o comando mqsicreatebroker propriamente dito.
Avisos | Marcas | Este link é aberto em uma nova janela Downloads | Este link é aberto em uma nova janela Biblioteca | Este link é aberto em uma nova janela Suporte | Feedback

Copyright IBM Corporation 1999, 2011Copyright IBM Corporation 1999, 2011.

        
        Última atualização
        
        Última atualização : 2011-11-09 14:39:44


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.0 | an07080_