Comando sibDDLGenerator

O mecanismo do sistema de mensagens precisa de instruções de definição de dados (DDL) para criar os recursos Sistema de Gerenciamento de Banco de Dados (DBMS). Estes recursos do DBMS são gerados pelo comando sibDDLGenerator.

Sintaxe

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>-sibDDLGenerator--+---------------------+--------------------->
                    '- -system--DBMS name-'   

>--+-------------------------+--+---------------------------+--->
   '- -version--DBMS version-'  '- -platform--DBMS platform-'   

>--+-----------------------+--+-------------------+------------->
   '- -schema--schema name-'  '- -user--user name-'   

>--+----------+--+----------------------+----------------------->
   +- -create-+  '- -database--database-'   
   '- -drop---'                             

>--+-------------------------------+---------------------------->
   '- -storagegroup--storage group-'   

>--+---------------------------------+-------------------------->
   '- -catalog--high level qualifier-'   

>--+---------------------------+-------------------------------->
   '- -bufferpool--buffer pool-'   

>--+-------------------------------+--+----------------+-------->
   '- -statementend--statement end-'  '- -nolinebreaks-'   

>--+----------------+--+-------------------------+-------------->
   '- -noblanklines-'  '- -firstline--first line-'   

>--+-----------------------+--+---------------------+----------->
   '- -lastline--last line-'  '- -permanent--number-'   

>--+---------------------+-------------------------------------><
   '- -temporary--number-'   

Propósito

Um mecanismo do sistema de mensagens precisa de recursos DBMS, tais como tabelas do banco de dados, que ele cria ao iniciar. Se sua instalação tiver uma política que apenas um administrador do banco de dados tenha autoridade para criar tabelas do banco de dados, utilize o comando sibDDLGenerator para permitir que o administrador do banco de dados crie os recursos DBMS que o mecanismo do sistema de mensagens necessita. O comando sibDDLGenerator gera instruções DDL que o administrador do banco de dados pode salvar e, posteriormente, processar para criar os recursos DBMS listados em Tabelas de Armazenamento de Dados.

O comando também gera instruções DDL que concedem as autoridades apropriadas para permitir que um mecanismo do sistema de mensagens use essas tabelas.

[IBM i]Para acessar a linha de comando do IBM® i, use o comando STRQSH para iniciar uma sessão Qshell. [IBM i]Para obter informações adicionais, consulte Configurando o Qshell para Executar Scripts do WebSphere Usando o Script wsadmin.

Nota: O comando sibDDLGenerator pode gerar as instruções DDL para criar ou eliminar todas as tabelas do armazenamento de dados. É menos recomendável incluir mais tabelas de itens em um armazenamento de dados existente. No entanto, é possível emitir novamente as instruções DDL para criar tabelas existentes sem prejudicar o armazenamento de dados.

Parâmetros Opcionais

Dica: O comando sibDDLGenerator faz distinção entre maiúsculas e minúsculas. Por exemplo, o valor do parâmetro Oracle não é o mesmo que o valor do parâmetro oracle.

Alguns parâmetros se aplicam apenas a um DBMS específico, conforme indicado na lista de parâmetros; por exemplo: -database [Aplica-se apenas ao DB2 for z/OS]

-system
Identifica o tipo de DBMS no qual o administrador processará as instruções DDL. Os valores válidos são:
  • db2
  • oracle
  • sqlserver
  • sybase
  • informix
  • derby
Se não for fornecido um parâmetro -system, o valor padrão será derby.
-version
O número da versão do DBMS identificado pelo parâmetro -system. A seguinte tabela mostra o valor padrão que será usado se o parâmetro -version não for fornecido.

Se receber um erro CWSIS1595E ou CWSIS1503E quando executar a ferramenta, consulte as notas após a tabela para determinar se um valor de parâmetro -version alternativo pode ser usado para sua versão do banco de dados.

Tabela 1. Valores para o Parâmetro -version. A primeira coluna da tabela lista os valores do parâmetro -system. A segunda coluna da tabela lista os valores do parâmetro -platform. A terceira coluna da tabela lista os valores padrão dos parâmetros -version. A quarta coluna da tabela lista os demais valores aceitos dos parâmetros -version.
O valor do parâmetro -system O valor do parâmetro -platform Valor padrão para o parâmetro -version Outros valores aceitos do parâmetro -version
db2 zos 7.1 8.1, 9.1 (consulte a Nota 1)
db2 unix, windows 8.1 9.1 (consulte a Nota 1)
db2 iseries 5.2 (consulte a Nota 2) 5.3 (consulte a Nota 2)
oracle   8i 10g, 11g (consulte a Nota 3)
sqlserver   2000 2005
sybase   12.0 12.5, 15.0
informix   9.3 7.3, 9.4, 10.0, 11.0 (consulte a Nota 4)
derby   10.1  
Comunicados:
  1. O DDL gerado para o DB2 para UNIX ou Windows ao usar os valores de parâmetro -version 8.1 e 9.1 é idêntico. O DDL gerado para o DB2 for z/OS ao usar os valores de parâmetro -version 7.1, 8.1 e 9.1 é idêntico.
  2. No IBM i, o banco de dados DB2 faz parte do sistema operacional, por isso, o número da versão fornecido é para a versão do OS/400.
  3. A DDL gerada para o Oracle usando os valores do parâmetro -version 10g e 11g é idêntica.
  4. A DDL gerada para o Informix usando os valores do parâmetro -version 10.0 e 11.0 é idêntica.
-platform
A plataforma de sistema operacional na qual o DBMS é executado. Os valores válidos são:
  • iseries
  • unix
  • windows
  • zos
-schema
O nome do esquema que contém todos os objetos utilizados pelo mecanismo do sistema de mensagens. Se não for fornecido um parâmetro -schema, o valor padrão será IBMWSSIB.
-user
O nome do ID do usuário utilizado para interagir com o DBMS. Se não for fornecido um parâmetro -user, o valor padrão será IBMUSER.
-create | -drop
Indica se as instruções DDL criam os recursos DBMS ou se os exclui. Se não for fornecido nenhum parâmetro, o valor padrão será -create.
-database [Aplica-se apenas ao DB2 for z/OS]
O nome do banco de dados que está alocado para as tabelas do mecanismo do sistema de mensagens. Se não for fornecido um parâmetro -database, o valor padrão será SIBDB.
-storagegroup [Aplica-se apenas ao DB2 for z/OS]
O nome do grupo de armazenamento que está alocado para as tabelas do mecanismo do sistema de mensagens.
  • Se você fornecer os parâmetros -storagegroup e -catalog, o comando sibDDLGenerator incluirá os dois valores na instrução CREATE STOGROUP.
  • Se você fornecer apenas um parâmetro -storagegroup, o comando sibDDLGenerator utilizará o nome do grupo de armazenamento em outras instruções, mas não criará uma instrução CREATE STOGROUP.
  • Se você fornecer apenas um parâmetro -catalog, o comando sibDDLGenerator exibirá a instrução de uso e, em seguida, será encerrado.
  • Se você omitir os dois parâmetros, o comando sibDDLGenerator utilizará o valor padrão SIBSG para o nome do grupo de armazenamento em outras instruções, mas não criará uma instrução CREATE STOGROUP.
-catalog [Aplica-se apenas ao DB2 for z/OS]
O nome do qualificador de alto nível do grupo de armazenamento que está alocado para as tabelas do mecanismo do sistema de mensagens. Para obter informações sobre padrões, consulte o parâmetro -storagegroup.
-bufferpool [Aplica-se apenas ao DB2 for z/OS]
O nome do conjunto de buffers que está alocado para as tabelas do mecanismo do sistema de mensagens. Se não for fornecido um parâmetro -bufferpool, o valor padrão será BP1.
-statementend
Anexa statement_end a cada instrução DDL. Por exemplo, você pode utilizar ; para anexar um ponto e vírgula em cada instrução DDL. Por padrão, o comando sibDDLGenerator não anexa nada a cada instrução.
Dica: Nas plataformas UNIX, cancele o ponto-e-vírgula para evitar que o shell o interprete.
-nolinebreaks
Coloca cada instrução sobre uma linha individual, sem quebras de linha. Por padrão, o comando sibDDLGenerator quebra as instruções entre as linhas para melhor a capacidade de leitura.
-noblanklines
Omite linhas em branco entre cada instrução. Por padrão, o comando sibDDLGenerator insere uma linha em branco entre cada instrução para melhorar a capacidade de leitura.
-firstline
Gera first_line como a primeira linha da saída. Por exemplo, é possível usar a first_line para identificar o banco de dados de destino. Por padrão, o comando sibDDLGenerator não gera uma primeira linha.
-lastline
Gera last_line como a última linha da saída. Por exemplo, é possível usar a last_line para chamar um comando que execute os comandos no script. Por padrão, o comando sibDDLGenerator não gera uma última linha.
Dica: Os parâmetros opcionais que controlam o formato das instruções DDL, por exemplo, -statementend, permitem que você gere a saída adequada para determinadas ferramentas de script, por exemplo, o DB2 CLP. Por padrão, o comando sibDDLGenerator gera linhas em branco entre cada instrução DDL mas não anexa um ponto e vírgula no final de cada instrução DDL.

Os seguintes dois parâmetros opcionais são usados para propagar o armazenamento de dados entre diversas tabelas:

-permanent
O número de tabelas permanentes, com
  • Valor padrão: 1
  • Valor mínimo: 1
  • Valor máximo: consulte Nota
-temporary
O número de tabelas temporárias, com
  • Valor padrão: 1
  • Valor mínimo: 1
  • Valor máximo: consulte Nota
Nota: O número máximo de tabelas SIBnnn que podem ser usadas por um mecanismo do sistema de mensagens é 32. Isto inclui todas as tabelas de fluxos, permanentes e temporárias.

Exemplos

  • sibDDLGenerator -system db2 -version 8.1 -platform zos

    Gera instruções DDL para o DB2 8.1, em execução no z/OS, com um esquema padrão, ID do usuário, banco de dados, grupo de armazenamento e conjunto de buffer.

  • sibDDLGenerator -system db2 -version 8.1 -platform windows -statementend ;

    Gera instruções DDL para o DB2 8.1, em execução no Windows, com um esquema padrão, ID do usuário e banco de dados. Você pode inserir as instruções diretamente no DB2 CLP, que exige que cada instrução termine com ponto-e-vírgula.

  • sibDDLGenerator -system oracle -version 8i -schema SIB -user fred

    Gera instruções DDL para o Oracle 8i.

  • sibDDLGenerator -system oracle -schema SIB -user fred

    Uma versão concisa do exemplo anterior.


Ícone que indica o tipo de tópico Tópico de Referência



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjm0630_
Nome do arquivo: rjm0630_.html