Comando mqsicreateconfigmgr

Plataformas Suportadas

Finalidade

Esse comando concluiu as seguintes ações:
  • Cria um gerenciador de filas do WebSphere MQ, se ainda não existir um.
    Notes:
    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, configure uma DLQ (Dead Letter Queue). A DLQ é referida pelo WebSphere Message 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 ú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. Essa opção simplifica a sua configuração.
  • Inicia o gerenciador de filas do WebSphere MQ, se ele ainda não estiver em execução.
  • Cria o canal e as filas de WebSphere MQ que são específicos para o Configuration Manager, se eles ainda não existirem.
  • Cria tabelas de banco de dados para o Configuration Manager em seu repositório interno. Se você precisar transferir dados do repositório de configuração de um release anterior, você pode utilizar os parâmetros db2DatabaseToMigrate, migrationDatabaseUserId e migrationDatabasePassword.
  • Se você executar esse comando utilizando o parâmetro -n e, em seguida, excluir o Configuration Manager utilizando o mqsideleteconfigmgr , sem especificar o parâmetro -n nesse comando, o novo banco de dados que contém o repositório de configuração não será excluído.

    Se você executar esse comando novamente nessa situação e especificar o parâmetro -n, o parâmetro será ignorado porque o novo banco de dados ainda existe.

  • (Apenas Windows) - 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). Esse requisito assegura que o Configuration Manager acessa as classes WebSphere MQ corretas (não as classes VisualAge) quando iniciadas pelo Comando mqsistart. Se o Configuration Manager detectar um erro nessa área, ele gravará a mensagem BIP1004 no registro de Eventos do Sistema Windows.

Sintaxe

Windows

Linux e Sistemas UNIX

z/OS

Parâmetros

configmgrName
(Opcional - Windows. Obrigatório - Linux, Sistemas UNIX e z/OS) O nome do Configuration Manager que você deseja criar.

No Linux, Sistemas UNIX e z/OS, esse parâmetro deve ser o primeiro especificado. Faz distinção entre maiúsculas e minúsculas no Linux, Sistemas UNIX e z/OS.

O nome padrão no Windows, se esse parâmetro não for especificado, será 'ConfigMgr'.

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

Esse parâmetro pode ser especificado em qualquer sintaxe válida de nome do usuário para a plataforma.

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 Message Broker foi instalado), e o diretório de trabalho (se especificado pelo sinalizador -w).

Início da mudançaOs requisitos de segurança para ServiceUserID estão detalhados em Requisitos de Segurança para Plataformas Windows para Windows, Requisitos de Segurança para Plataformas Linux e UNIX para plataformas UNIX e Requisitos de Segurança para z/OS para z/OS.Fim da mudança

Se você utilizar o formato não-qualificado para o ID do usuário de serviço (username), Início da mudançano WindowsFim da mudança, o sistema operacional procura o ID do usuário em seu domínio, iniciando com o sistema local. Essa pesquisa pode levar algum tempo para concluir.

-a ServicePassword
(Obrigatório) A senha para o ServiceUserID.

Para compatibilidade com os sistemas existentes, você ainda pode especificar <password>. Entretanto, se não especificar uma senha com este parâmetro ao executar o comando, será solicitado que você digite uma senha durante sua chamada e digite a senha uma segunda vez para verificar se ela foi digitada corretamente.

-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. Essa atualização é feita independentemente de o gerenciador de filas ter sido criado por este comando.

-n db2DatabaseToMigrate
(Opcional) O nome do banco de dados criado em um release anterior para conter as tabelas do repositório de configuração.

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 migrationDataBaseUserID
(Opcional) O ID do usuário com o qual o banco de dados do repositório de configuração (criado em um release anterior) será acessado.
-p migrationDataBasePassword
(Opcional) A senha do ID do usuário com o qual o banco de dados do repositório de configuração (criado em um release anterior) será acessado. Se não estiver especificado, esse parâmetro assumirá como padrão o ServicePassword especificado por -a.

Para compatibilidade com os sistemas existentes, você ainda pode especificar <password>. Entretanto, se não especificar uma senha com este parâmetro ao executar o comando, será solicitado que você digite uma senha durante sua chamada e digite a senha uma segunda vez para verificar se ela foi digitada corretamente.

-s UserNameServerQueueManagerName
(Opcional) O nome do gerenciador de filas do WebSphere MQ que está associado ao Servidor de Nome de Usuário.Se esse parâmetro não estiver especificado, o Configuration Manager assumirá que não há Servidor de Nome de Usuário definido e não tentará se comunicar com um.
-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.
1
(Opcional - Apenas z/OS) A transmissão do registro que cria apenas o registro do Configuration Manager.
2
(Opcional - Apenas z/OS) A transmissão do WebSphere MQ que cria apenas filas do Configuration Manager WebSphere MQ.
Nota: Essa ação pode ser executada apenas se existir o registro do Configuration Manager.

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 Windows Administradores neste sistema local.

Início da mudançaNos sistemas UNIX, o ID do usuário utilizado para chamar esse comando deve ser um membro do grupo mqbrkrs. Fim da mudança

Início da mudançaNos sistemas z/OS, o ID do usuário para chamar este comando deve ser um membro de um grupo que tem acesso READ e WRITE para o diretório do componente.Fim da mudança

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 Message Broker grupo mqbrkrs a todas estas filas. Se a DLQ estiver ativada, ela também terá a mesma autoridade.

Canais do WebSphere MQ Criados

  • SYSTEM.BKR.CONFIG

Tabelas Criadas do Banco de Dados

As tabelas de banco de dados criadas por esse comando são administradas pelo Gerenciador de Configuração.

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 Impossível 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 CMGR01 -i wbrkuid -a wbrkpw -q WBRK_CONFIG_QM
Conceitos relacionados
Configuration Manager
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
an23000_