Comando mqsicreatedb

Plataformas Suportadas

  • Windows

Finalidade

O comando mqsicreatedb cria um banco de dados e o disponibiliza para o intermediário. O comando cria o banco de dados, cria um nome de origem de dados ODBC e, se necessário, dependendo do tipo de banco de dados, cria e inicia um Serviço do Windows. O comando cria, no máximo, uma única instância do Serviço do Windows para cada instalação de uma versão de produto principal. Esse comando suporta somente os mecanismos de banco de dados DB2 e Derby instalados.

Sintaxe

Parâmetros

DatabaseName
(Obrigatório) O nome do banco de dados que você deseja criar. Deve ser o primeiro parâmetro e faz distinção entre maiúsculas e minúsculas. Restrições sobre o comprimento permitido do nome do banco de dados podem ser impostas pelo mecanismo de banco de dados. Para saber quais restrições do conjunto de caracteres podem ser utilizadas, consulte Caracteres Permitidos em Comandos.
-i ServiceUserID
(Opcional, apenas Derby) O ID do usuário sob o qual o serviço DatabaseInstanceMgr é executado.

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

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

Se você utilizar o formato não qualificado para este ID do usuário (nome do usuário), o sistema operacional procurará 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.

O ServiceUserID especificado deve ser um membro do grupo local mqbrkrs. O ID pode ser um membro direto ou indireto do grupo. O ServiceUserID também deve ser autorizado para acessar o diretório home (em que WebSphere Message Broker está instalado).

Este parâmetro será ignorado se o mecanismo de banco de dados especificado ou padronizado para o comando for DB2. Um ServiceUserID é requerido para o Derby, mas apenas para a primeira chamada deste comando. As chamadas seguintes estão associadas ao serviço do Windows DatabaseInstanceMgr existente que é executado sob o ServiceUserID especificado no comando anterior

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

-a ServicePassword
(Opcional, apenas Derby) A senha para o ServiceUserID. Especifique esta opção apenas se especificar ServiceUserID.
-p PortNumber
(Opcional) O número da porta TCP/IP que esse componente utilizará na máquina local. Se não for especificado, o valor padrão 1527 será utilizado.
-e dbType
(Opcional) O mecanismo de banco de dados a ser utilizado para criar e executar o banco de dados. No momento, os valores suportados são DB2 e Derby. Se esta opção não for especificada e apenas o mecanismo de banco de dados estiver disponível, esse mecanismo será utilizado. Se ambos estiverem disponíveis, o mecanismo padrão será DB2.
-u dbUserID
(Opcional, apenas DB2) Um nome do usuário adicional que requer acesso ao banco de dados criado por este comando.

Autorização

O ID do usuário utilizado para invocar esse comando deve ter autoridade do Administrador no sistema local e fazer parte do grupo mqbrkrs.

Respostas

Esse comando retorna as seguintes respostas:

  • BIP9801 Nenhum produto de banco de dados suportado foi localizado.
  • BIP9802 Já existe um banco de dados com o nome xxxx.
  • BIP9803 O mecanismo de banco de dados solicitado, xxxx, não pôde ser localizado.
  • BIP9805 Um Cloudscape Network Server já está em execução no número da porta.
  • BIP9809 Criando o banco de dados, isso pode levar algum tempo.
  • BIP9811 O serviço IBM MQSeries Brokers DatabaseInstanceMgr já existe.
  • BIP9812 Falha ao iniciar o IBM Cloudscape Network Server.
  • BIP9813 Tempo limite de processo externo.
  • BIP9815 O nome do banco de dados fornecido xxxx possui muitos caracteres.
  • BIP9816 Vários mecanismos de banco de dados está instalados. Assumindo como padrão o mecanismo de banco de dados DB2.
  • BIP9817 O mecanismo de banco de dados DB2 foi utilizado para criar o banco de dados xxxx.
  • BIP9818 O mecanismo de banco de dados IBM Cloudscape/Apache Derby foi utilizado para criar o banco de dados xxxx.

Exemplos

O exemplo a seguir configura um banco de dados com o nome brokerdb na porta 1600:
mqsicreatedb brokerdb -p 1600
O exemplo a seguir configura um banco de dados Derby com o nome derbydb, utilizando o número de porta 1527:
mqsicreatedb derbydb -i wbrkuid -a wbrkpw -e Derby -p 1527 
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
an35001_