Comando mqsicreatebroker

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

Plataformas Suportadas

Finalidade

O comando mqsicreatebroker conclui as tarefas a seguir.
  1. O comando verifica se o gerenciador de filas do WebSphere MQ especificado existe:
    • Se o gerenciador de filas não existir, ocorrerá o comportamento a seguir.
      • Se você executar esse comando no z/OS, a ação falhará e um erro será emitido.
      • Se você executar esse comando no Linux, UNIX ou Windows, um gerenciador de filas será criado.

        Início da mudançaSe o WebSphere MQ Versão 7.1 tiver sido selecionado para o gerenciador de filas, a segurança de autenticação do canal será desativada automaticamente.Fim da mudança

        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 não for possível voltá-la ou o fluxo de mensagens não estiver configurado para voltar mensagens ou para concluir um processamento de erro alternativo, o broker 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 o gerenciador de filas existir, verifique se ele tem uma DLQ definida; a fila não é criada por esse 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.

      Início da mudança
      • Se você executar esse comando no Linux, UNIX ou Windows e o gerenciador de filas existente for o WebSphere MQ Versão 7.1, será presumido que o usuário aplicou a configuração de segurança apropriada para atender seus requisitos e, portanto, a segurança de autenticação do canal não será desativada.
      Fim da mudança
  2. O comando inicia o gerenciador de filas do WebSphere MQ, se ainda não estiver em execução, exceto no z/OS.

    Se o comando criar o gerenciador de filas no Windows, o gerenciador de filas não será iniciado como um serviço. Se você efetuar logoff, o gerenciador de filas será parado. 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. O comando se conecta ao gerenciador de filas associado.
  4. O comando 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, o comando instala um serviço sob o qual o broker é executado.
  6. O comando 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 informações adicionais, consulte Modos de Operação.
  7. O comando cria um registro para o componente no registro.
  8. Em sistemas Windows, Linux e UNIX, o comando 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 da Versão 6.1, as restrições a seguir se aplicarão.

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.

Para obter detalhes desse comando no sistema operacional usado por sua empresa, consulte o tópico apropriado.

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ário utilizado 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 intermediário. 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.
Ao executar o mesmo comando novamente, você pode receber uma série de mensagens especificando itens que não podem ser criados. O recebimento dessas mensagens não indica um problema com o comando mqsicreatebroker propriamente dito.
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        Última atualização
        
        Última atualização : 2012-07-17 10:04:20


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