Comando mqsicreateconfigmgr

Plataformas Suportadas

  • Plataformas Windows 2000, Windows XP

Finalidade

Este comando:
  • Cria um gerenciador de filas do WebSphere MQ, se ainda não existir um.
    Nota:
    1. Se um gerenciador de filas do WebSphere MQ for criado como resultado do uso do comando mqsicreateconfigmgr, a DLQ padrão fornecida pela WebSphere MQ (SYSTEM.DEAD.LETTER.QUEUE) será automaticamente ativada. As definições de segurança são iguais às de outras filas do WebSphere MQ específicas do intermediário.

      Se você optar por criar o gerenciador de filas separadamente, deverá configurar uma DLQ (Dead Letter Queue). A DLQ é referida pelo WebSphere Business Integration Event Broker quando ocorrem erros no processamento de mensagens nos fluxos de mensagens.

      Se uma mensagem em um fluxo de mensagens definido pelo usuário ou no modelo de publicação/assinatura não puder ser processada, ela será roteada para essa DLQ como um último recurso. Se você preferir que a mensagem seja recuperada para a fila de entrada, descontinuando efetivamente o fluxo de mensagens até que o problema seja resolvido, desative a DLQ.

      O comando mqsideleteconfigmgr não exclui essa fila (a menos que o gerenciador de filas seja excluído).

    2. Se estiver utilizando um gerenciador de filas do WebSphere MQ que foi criado independentemente do comando mqsicreateconfigmgr, será possível definir clusters, se você preferir. Isso simplifica a configuração.
  • Inicia o gerenciador de filas do WebSphere MQ, se ele ainda não estiver em execução. Observe que o Configuration Manager sempre é executado como um aplicativo confiável do WebSphere MQ.
  • Cria as filas e canais do WebSphere MQ específicos do Configuration Manager, se ainda não existirem.
  • Cria tabelas do banco de dados para o Configuration Manager no repositório de configuração, se ainda não existirem.
  • Instala um serviço do Windows, sob o qual o Configuration Manager é executado.
  • Cria um registro para o componente no registro do intermediário.

Se você instalou o VisualAge para Java e selecionou o WebSphere MQ Conector como parte dessa instalação, deverá assegurar que a entrada CLASSPATH para o VisualAge para Java aparece após as entradas de CLASSPATH para o WebSphere MQ para a plataforma Windows que está sendo utilizada (servidor ou cliente Java). Isso é para garantir que o Configuration Manager acesse as classes corretas do WebSphere MQ (não as classes do VisualAge) quando for iniciado pelo Comando mqsistart. Se o Configuration Manager detectar um erro nessa área, ele gravará a mensagem BIP1004 no log de Eventos do Sistema Windows.

Sintaxe

Parâmetros

-i ServiceUserID
(Obrigatório) ID do usuário sob o qual o serviço do Windows é executado.

Isto pode ser especificado em qualquer sintaxe de nome de usuário do Windows válida:

  • domain\username
  • \\server\username
  • .\username
  • username

O ServiceUserID especificado deve ser membro (direto ou indireto) do grupo local mqbrkrs e deve ter autorização para acessar o diretório home (no qual o WebSphere Business Integration Event Broker foi instalado), e o diretório de trabalho (se especificado pelo sinalizador -w). Esse ID de usuário também deve ser membro (direto ou indireto) do grupo local mqm ou do grupo local Administradores do Windows.

Os requisitos de segurança para ServiceUserID são detalhados em Requisitos de Segurança para Plataformas Windows.

Se você utilizar o formato não qualificado para este ID do usuário (username), o sistema operacional pesquisará o ID do usuário em todo o seu domínio, começando com o sistema local. Essa pesquisa pode levar algum tempo para concluir.

-a ServicePassword
(Obrigatório) A senha para o ServiceUserID.
-q QueueManagerName
(Obrigatório) O nome do gerenciador de filas associado ao Configuration Manager.

Se o gerenciador de filas ainda não existir, ele será criado por este comando. Ele não é criado como o gerenciador de filas padrão: se você desejar que ele seja o padrão neste sistema, crie-o antes de emitir esse comando.

O atributo do gerenciador de filas MAXMSGL (comprimento máximo de mensagens que podem ser colocadas em filas) é atualizado para 100 MB. Isto é feito independentemente de o gerenciador de filas ter sido criado por este comando.

-n DataBaseName
(Obrigatório) O nome do banco de dados criado para conter as tabelas do repositório de configuração. Esse banco de dados é o repositório de configuração para todo o domínio do intermediário e contém informações de configuração de todos os recursos, bem como dados internos do Configuration Manager.

Esse banco de dados já deve existir. Não é preciso criar uma conexão ODBC para esse banco de dados porque o acesso é fornecido pelo JDBC.

-u DataBaseUserID
(Opcional) O ID do usuário com o qual o banco de dados do repositório de configuração deve ser acessado. Se ele não for especificado, será utilizado o valor definido em ServiceUserID.

Este ID do usuário deve ter autoridade para criar tabelas no banco de dados identificado pelo DataBaseName e para leitura e gravação nesse banco de dados.

-p DataBasePassword
(Opcional) A senha do ID do usuário com a qual o banco de dados do repositório de configuração deve ser acessado. Se não for especificada, será assumido como padrão o ServicePassword especificado por -a.
-d SecurityDomainName
(Opcional) Este parâmetro deve ser definido como nulo. Ao criar o gerenciador de configuração, omita este parâmetro.

As opções -u e -g no comando mqsicreateaclgroup referem-se a usuários e grupos no domínio que o Configuration Manager utiliza para sua segurança. Esse domínio é por padrão a máquina na qual o Configuration Manager reside, mas ele será diferente se você utilizar essa opção.

-s UserNameServerQueueManagerName
(Opcional) O nome do gerenciador de filas do WebSphere MQ que está associado ao Servidor de Nome de Usuário. Se ele não for especificado, o Configuration Manager assumirá que não existe nenhum Servidor de Nome de Usuário definido e não tentará se comunicar com nenhum deles.
-w Workpath
(Opcional) O diretório no qual os arquivos de trabalho do Configuration Manager são armazenados. Se não for especificado, será utilizado o diretório padrão especificado durante a instalação do produto.
-l 2, 0 ou 1
(Opcional) Este parâmetro deve ser definido para 2. Ao criar o gerenciador de configuração, omita esse parâmetro. Consulte Considerando a Segurança para o workbench para obter informações adicionais sobre esta opção.

Autorização

Este comando altera os privilégios de segurança para o ServiceUserID; o ID de usuário utilizado para chamar este comando deve ser membro do grupo Administradores do Windows neste sistema local.

Filas do WebSphere MQ Criadas

  • SYSTEM.BROKER.CONFIG.QUEUE
  • SYSTEM.BROKER.CONFIG.REPLY
  • SYSTEM.BROKER.ADMIN.REPLY
  • SYSTEM.BROKER.SECURITY.REPLY
  • SYSTEM.BROKER.MODEL.QUEUE

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

A autoridade de acesso é concedida parar os grupos do WebSphere Business Integration Event Broker, mqbrdevt, mqbrasgn, mqbrops e mqbrtpic às filas SYSTEM.BROKER.CONFIG.QUEUE e SYSTEM.BROKER.CONFIG.REPLY.

Canais do WebSphere MQ Criados

  • SYSTEM.BKR.CONFIG

Tabelas Criadas do Banco de Dados

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

Respostas

Esse comando retorna as seguintes respostas:
  • BIP8011 Impossível criar dados de configuração
  • BIP8012 Impossível conectar aos componentes do sistema
  • BIP8014 O componente não pode ser criado
  • BIP8022 ID do usuário/senha inválidos
  • BIP8030 Incapaz de modificar os privilégios do ID do usuário
  • BIP8048 Incapaz de iniciar o gerenciador de filas
  • BIP8050 Impossível criar o gerenciador de filas
  • BIP8051 Impossível criar fila
  • BIP8053 Impossível definir segurança para o gerenciador de filas
  • BIP8054 Impossível definir segurança para a fila
  • BIP8055 Impossível carregar a classe Java
  • BIP8056 Gerenciador de filas desconhecido
  • BIP8074 Impossível criar JVM
  • BIP8075 Exceção Java
  • BIP8076 Impossível definir diretório atual
  • BIP8077 Erro ao inicializar dados de configuração
  • BIP8078 Erro ao inicializar dados de configuração
  • BIP8084 Impossível criar diretório
  • BIP8087 O componente já existe
  • BIP8093 Gerenciador de filas sendo criado
  • BIP8094 Gerenciador de filas parando
  • BIP8097 Impossível criar o objeto Java

Exemplos


mqsicreateconfigmgr -i wbrkuid -a wbrkpw -q WBRK_CONFIG_QM
-n WBRKCMDB 

Conceitos relacionados
Configuration Manager

Tarefas relacionadas
Criando um Configuration Manager
Considerando a Segurança para o workbench

Referências relacionadas
Conteúdo do Banco de Dados
Preferência de Sintaxe
Comando mqsichangeconfigmgr
Comando mqsideleteconfigmgr