Comando mqsicreateconfigmgr

Plataformas Suportadas

  • Windows
  • Linux e Sistemas UNIX
  • z/OS

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, 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. 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 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.
  • 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

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, este deve ser o primeiro parâmetro especificado. Ele faz distinção entre maiúsculas e minúsculas em Linux e Sistemas UNIX.

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.

Ele 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). Esse ID de usuário também deve ser um membro (direto ou indireto) do grupo local mqm ou do grupo Administradores do Windows, onde aplicável.

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

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.

Para compatibilidade com sistemas existentes, você também 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. Isto é feito 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 for especificada, será assumido como padrão o ServicePassword especificado por -a.

Para compatibilidade com sistemas existentes, você também 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 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.
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: Isto pode ser desempenhado apenas se o registro do Configuration Manager existir.

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.

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.

A autoridade de acesso é concedida parar os grupos do WebSphere Message 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 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
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2005 Última Atualização: 04/11/2005
an23000_