Comando mqsicreateconfigmgr

Plataformas Suportadas

  • Plataformas 2000, XP

Finalidade

Este comando:
  • Cria um gerenciador de filas do , se ainda não existir um.
    Nota:
    1. Se um gerenciador de filas do for criado como resultado do uso do comando , a DLQ padrão fornecida pela (SYSTEM.DEAD.LETTER.QUEUE) será automaticamente ativada. As definições de segurança são iguais às de outras filas do 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 quando ocorrem erros no processamento de mensagens nos .

      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 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 , se ele ainda não estiver em execução. Observe que o sempre é executado como um aplicativo confiável do .
  • Cria as filas e canais do específicos do , se ainda não existirem.
  • Cria tabelas do banco de dados para o no repositório de configuração, se ainda não existirem.
  • Instala um serviço do Windows, sob o qual o é executado.
  • Cria um registro para o componente no registro do intermediário.

Se você instalou o VisualAge para Java e selecionou o 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 para a plataforma que está sendo utilizada (servidor ou cliente Java). Isso é para garantir que o acesse as classes corretas do (não as classes do VisualAge) quando for iniciado pelo Comando mqsistart. Se o detectar um erro nessa área, ele gravará a mensagem BIP1004 no log de Eventos do Sistema .

Sintaxe

Parâmetros

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

Isto pode ser especificado em qualquer sintaxe de nome de usuário do 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 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 .

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

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 .

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 .

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 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 que está associado ao . Se ele não for especificado, o assumirá que não existe nenhum definido e não tentará se comunicar com nenhum deles.
-w Workpath
(Opcional) O diretório no qual os arquivos de trabalho do 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 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 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 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 , 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


 -i  -a  -q 
-n  

Conceitos relacionados

Tarefas relacionadas
Criando um
Considerando a Segurança para o

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