Comando mqsicreatebroker

Utilize o comando mqsicreatebroker para criar um intermediário e seus recursos associados.

Plataformas Suportadas

Propósito

O comando mqsicreatebroker:
  1. Verifica se o gerenciador de filas especificado do WebSphere MQ já 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 definições de segurança são iguais às de outras filas do WebSphere MQ específicas do intermediário.

        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 intermediário 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 uma DLQ definida; se ela não for criada por este comando em um gerenciador de filas existente, o intermediário colocará mensagens que não poderão ser processadas para a 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 necessárias para o intermediário, se ainda não existirem.
  5. Início da mudançaCria tabelas de banco de dados para o intermediário no esquema relevante no banco de dados especificado. Se o esquema, determinado pelo ID do usuário, ou as tabelas, não existem, elas serão criadas. Se as tabelas já existirem, o comando incluirá as linhas específicas neste intermediário nas tabelas existentes.

    Se os parâmetros especificados neste comando resultarem neste intermediário compartilhando tabelas em um esquema do banco de dados com outros intermediários, você deverá assegurar que todos estes intermediários estejam na mesma versão do produto.

    Fim da mudança
  6. Apenas no Windows, instala um serviço em que o intermediário é executado.
  7. Cria um registro para o componente no registro.
Selecione o link apropriado para obter detalhes desse comando na plataforma, ou plataformas, que a sua empresa utiliza:

Autorização

Nos sistemas Windows, o ID do usuário utilizado para executar este comando deve ter autoridade de Administrador no sistema local.

Nos sistemas Linux e UNIX, o ID do usuário utilizado para executar este comando deve ser membro dos grupos mqbrkrs e mqm.

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.

Utilizando LDAP: assegure-se de que o registro esteja protegido apropriadamente para evitar acesso não autorizado. Você não precisa configurar as opções 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.ADMIN.QUEUE
  • SYSTEM.BROKER.AGGR.CONTROL
  • SYSTEM.BROKER.AGGR.REPLY
  • SYSTEM.BROKER.AGGR.REQUEST
  • SYSTEM.BROKER.AGGR.TIMEOUT
  • SYSTEM.BROKER.AGGR.UNKNOWN
  • SYSTEM.BROKER.CONTROL.QUEUE
  • SYSTEM.BROKER.EXECUTIONGROUP.QUEUE
  • SYSTEM.BROKER.EXECUTIONGROUP.REPLY
  • SYSTEM.BROKER.INTERBROKER.MODEL.QUEUE
  • SYSTEM.BROKER.INTERBROKER. QUEUE
  • 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 mqbrkrs do WebSphere Event Broker para todas estas filas. Se a DLQ estiver ativada, ela também terá a mesma autoridade.

Tabelas Criadas do Banco de Dados

As tabelas do banco de dados que esse comando cria ou inclui são descritas em Conteúdo do Banco de Dados.

Respostas

Em algumas circunstâncias, você poderá ver a seguinte mensagem de erro emitida pelo DB2:
    (51002)[IBM][CLI Driver][DB2/NT]SQL0805N
    Package "NULLID.SQLLF000" was not found.  SQLSTATE=51002.

Este erro ocorre quando a ligação com o banco de dados não é bem-sucedida.

  • Em plataformas Windows, a ligação não é necessária para bancos de dados do intermediário, mas é exigida para bancos de dados do usuário. Se você criar o banco de dados utilizando o Centro de Controle do DB2, a ligação será concluída para você. Se utilizar a interface de comando, a ligação não será concluída para você. Por exemplo, para criar ou recriar uma ligação para o banco de dados MYDB, digite os seguintes comandos no prompt de comandos:
    db2 connect to MYDB user db2admin using db2admin
    db2 bind X:\sqllib\bnd\@db2cli.lst grant public
    db2 connect reset
    em que X: é a unidade na qual o DB2 está instalado.
  • Em plataformas Linux e UNIX, a ligação é necessária para todos os bancos de dados. Por exemplo, para criar ligação para o banco de dados WBRKBKDB, você deve digitar os seguintes comandos no prompt de comandos (em que <nome_de_usuário> é o ID do usuário com o qual a instância de banco de dados foi criada):
    db2 connect to WBRKBKDB user db2admin using db2admin
    db2 bind ~<nome_do_usuário>/sqllib/bnd/@db2cli.lst grant public CLIPKG 5
    db2 connect reset

Se você não utilizar o ID do usuário e senha padrão do DB2 (db2admin), deverá substituir os valores no comando db2 connect pelos valores corretos.

Se você executar o comando mqsicreatebroker e ele falhar, resolva o problema que causou a falha: Ao executar o mesmo comando novamente, é provável que você receba uma série de mensagens indicando os itens que não podem ser criados. O recebimento dessas mensagens não indica um problema com o comando mqsicreatebroker propriamente dito.
Conceitos relacionados
Domínios de Intermediário
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009. Todos os Direitos Reservados.
Última atualização : 2009-02-13 15:33:35

an07080_