Sumário

Search

  1. Prefácio
  2. Introdução ao PowerExchange
  3. Arquivo de Configuração DBMOVER
  4. Trabalhos Netport
  5. Logs de Mensagens do PowerExchange e Substituições de Destinos
  6. Log de estatísticas do SMF e Relatórios
  7. Segurança do PowerExchange
  8. Suporte a Secure Sockets Layer
  9. Segurança de Rede Alternativa do PowerExchange
  10. SQL Não Relacional do PowerExchange
  11. Metadados DTLDESCRIBE
  12. Globalização do PowerExchange
  13. Usando os Drivers ODBC do PowerExchange
  14. Tipos de Dados e Matriz de Conversão do PowerExchange
  15. Apêndice A: Carimbos de Data/Hora DTL__CAPXTIMESTAMP
  16. Apêndice B: Glossário do PowerExchange

Manual de Referência

Manual de Referência

Parâmetros Gerais do Driver ODBC do PowerExchange

Parâmetros Gerais do Driver ODBC do PowerExchange

Insira parâmetros gerais do driver ODBC do PowerExchange no arquivo odbc.ini no Linux ou UNIX.
A tabela a seguir descreve esses parâmetros gerais:
Parâmetro
Padrão
Tokens
Uso
CAPXIMAGETYPE
Nenhum
BA, AI ou TU
O tipo de imagem de captura para acessar o CDC do PowerExchange ou os dados ativos. As opções são:
  • BA. Captura os dados da pré-imagem, antes da última alteração, e os dados da pós-imagem, após a última alteração. Os dados da pré-imagem são enviados com um caractere de ação que força a exclusão do registro. Os dados da pós-imagem, que incluem os dados alterados, estão no formato de uma operação de inserção.
  • AI. Captura somente os dados da pós-imagem.
  • TU. Captura os dados da pré-imagem e pós-imagem, à medida que eles ocorrem. Os dados da pré-imagem permitem ao aplicativo assegurar que nenhuma alteração ocorreu no registro após a solicitação. Os dados da pós-imagem são exibidos como uma operação de atualização. A atualização é uma imagem completa, mas o aplicativo que captura essa alteração pode alterar o registro de destino em vez de excluí-lo e inserir um novo registro, como ocorre com um BA.
CAPXTYPE
Nenhum
SL ou RS
O tipo de extração. As opções são:
  • SL. Inicia a extração do ponto em que terminou a última extração, por tokens de reinicialização no z/OS ou por carimbos de data/hora de pontos de verificação no i5/OS.
  • RS. Reinicia a extração do ponto de início da última extração. Essa opção permite executar a mesma extração várias vezes.
COMPATIBILITY
Nenhum
-
A máscara de integração. Inclui as seguintes opções:
  • CPOOL. Inicializa o pool de conexões.
  • DFN. Se você especificar DFN, o tipo de fonte de dados do PowerExchange será retornado da seguinte forma:
    PWX:
    dbtype
    Se você não especificar DFN, a seguinte cadeia será retornada:
    PWX
    A Informatica recomenda o uso do valor padrão.
  • ILMBRIDGE. Especifique essa opção se o produto Informatica Data Archive acessar dados por meio de uma conexão de ponte JDBC-ODBC com o driver ODBC do PowerExchange. A opção ILMBRIDGE habilita as seguintes opções: BINASCHAR, CLOSEDSTMREUSE, NOFKEYS, NOUNDERSCORE, SQLLEN4BYTES e V3COLNAMES.
  • OWB. Define várias validações SQL e propriedades de reutilização da instrução. Usado pelo Oracle Warehouse Builder.
  • V30. Faz com que a chamada ODBC SQLColumns() retorne nomes de coluna V3. Usado pelo Information Integrator (II) do IBM DB2.
  • VERBOSE. Faz com que mensagens adicionais sejam geradas em relação a opções de Compatibilidade.
Além disso, você pode ativar as seguintes opções de COMPATIBILITY definindo a opção específica ou a opção ILMBRIDGE:
  • BINASCHAR. Faz com que a chamada ODBC SQLColAttributes() altere as colunas BIN ou VARBIN para colunas CHAR ou VARCHAR e dobra a capacidade.
  • CLOSEDSTMREUSE. Faz com que uma instrução aberta no modo de leitura ou de seleção seja mantida após uma chamada ODBC SQLFreeStmt() do tipo SQL_CLOSE. Subconjunto de StmtKeepAlive.
  • NOFKEYS. Faz com que a chamada SQLForeignKeys() do ODBC retorne um resultado vazio sem uma chamada ao Ouvinte do PowerExchange.
  • NOUNDERSCORE. Impede que caracteres de sublinhado (_) sejam substituídos pelo sinal de porcentagem (%) no processamento de DTLDescribe. Essa opção permite que o PowerExchange processe uma única tabela NRDB2.
  • SQLLEN4BYTES. Especifica que a ligação entre JDBC e ODBC chama SQLGetData com um buffer de número inteiro de 4 bytes para retornar o tamanho dos dados de destino.
  • V3COLNAMES. Faz com que os nomes do ODBC V3 sejam retornados para todos os conjuntos de resultados de metadados, como SQLTables(), SQLColumns() e SQLPrimaryKeys(). Superconjunto do sinalizador do V30.
COMPRESS
N
Y, N
Defina esse parâmetro para compactar dados.
O padrão é N.
CONFIRMWRITE
Y
Y, N ou T
Somente para os tipos de fonte de dados DB2, DB2UDB, DB2400C, MSSQL, NRDB, NRDB2, ODBC ou ORACLE.
O modo de gravação.
As opções são:
  • Y. Permite confirmar a gravação. Assegura que os dados enviados ao driver ODBC do PowerExchange sejam enviados imediatamente ao Ouvinte do PowerExchange, em vez de armazenados em buffer. Além disso, uma mensagem de êxito ou não êxito é enviada, o que melhora a recuperação de erro. Entretanto, o envio de uma resposta pode diminuir as taxas de transferência de dados.
  • T. Permite gravação assíncrona com tolerância a falha. Para obter mais informações sobre gravação assíncrona, consulte o
    Guia de Movimentação de Dados em Massa do PowerExchange
    .
  • N. Somente para fontes de dados DB2, DB2 UDB e Oracle. Desabilita a confirmação de gravação. Antes de usar essa definição, entre em contato com o Suporte Global a Clientes da Informatica.
O padrão é Y.
DATABASE
-
-
Somente no DB2 para Linux, UNIX e Windows. Substitui o valor de conexão do banco de dados especificado no mapa de extração do PowerExchange.
DB2DEGREE
Nenhum
Qualquer cadeia de texto com até 30 caracteres
Somente no DB2 para i5/OS e DB2 para z/OS. Envia o seguinte comando SQL para o DB2, especificando se o DB2 deve ou não usar o processamento paralelo entre partições:
SET CURRENT DEGREE
Para obter mais informações sobre o efeito de cada valor no comando SQL, consulte os comandos "SET CURRENT DEGREE" e "CHGQRYA DEGREE" na documentação relacionada do IBM DB2.
Somente no z/OS:
Qualquer texto após o sinal de igual é considerado texto que se segue a um
'SET CURRENT DEGREE ='
.
Por exemplo, especificar
DB2DEGREE=ANY
executa a instrução
"SET CURRENT DEGREE = 'ANY'"
e definiria o DB2 para usar o processamento paralelo.
Somente no i5/OS:
Qualquer texto após o sinal de igual é considerado texto que se segue a uma instrução
'CHGQRYA DEGREE'
.
Por exemplo, a especificação de
DB2DEGREE=SYSTEM
executa a instrução
"CHGQRYA DEGREE(*SYSTEM)"
.
Para manter a compatibilidade com versões anteriores, se o parâmetro começar com um dígito, ele será anexado a uma instrução
"CHGQRYA DEGREE(*NBRTASKS)"
. Portanto, uma instrução
"CHGQRYA DEGREE(*NBRTASKS 1)"
pode ser gerada com uma instrução
DB2DEGREE=1
ou
DB2DEGREE="*NBRTASKS 1"
.
DBQUAL1
Nenhum
Consulte a tabela subsequente.
Consulte a tabela subsequente.
DBQUAL2
Nenhum
Consulte a tabela subsequente.
Consulte a tabela subsequente.
DESCRIPTION
Nenhum
Texto
Texto descritivo.
DRIVER
Nenhum
Caminho/Arquivo
O caminho e o nome do arquivo do driver ODBC do PowerExchange. O nome do arquivo pode ter o sufixo .so ou .sl, de acordo com a versão do UNIX que está em execução. Consulte os sufixos nas bibliotecas compartilhadas existentes do PowerExchange para escolher o correto.
DTLAPP
-
-
Nome do aplicativo. Especificar o nome do aplicativo que identifica extrações aumenta a capacidade de identificar cada uso de uma única conexão. Essa informação fica disponível para o controle de tarefa.
DTLCONN_OVR
Nenhum
Não aplicável
O nome na instrução CAP_CONNECTION do arquivo de configuração DBMOVER que aponta para a fonte de dados relacionada.
DTLIMGOV
N
Y ou N
Somente para DB2390IMG.
Se o conjunto de dados de cópia de imagem for especificado, o PowerExchange verificará se o arquivo de cópia de imagem existe e se uma cópia de imagem consistente foi selecionada. Se nenhuma dessas duas condições for verdadeira, por exemplo, quando o arquivo de cópia de imagem não existir ou for inconsistente, a solicitação será rejeitada e uma mensagem será exibida.
Você pode substituir esse comportamento definindo o parâmetro DTLIMGOV como Y. Essa definição permite a leitura de cópias de imagem inconsistentes.
ENCRYPT
N
N, Y, AES
A opção de criptografia. As opções são:
  • N. Nenhuma criptografia é usada ao mover dados.
  • Y. Os dados serão criptografados usando um algoritmo especial desenvolvido pela Informatica se estiverem sendo acessados por meio de um Ouvinte do PowerExchange.
  • AES. Os dados são criptografados usando o algoritmo Data Encryption Standard (DES).
Se você especificar uma ação de criptografia, especifique também um nível de criptografia no parâmetro ENCRYPTLEVEL.
Os valores de DES e RC2 foram preteridos. O PowerExchange converte um valor de DES ou RC2 em AES.
ENCRYPTLEVEL
-
1, 2 ou 3
O nível de criptografia. Obrigatório, se o parâmetro ENCRYPT estiver definido como DES ou RC2.
As opções são:
  • 1
    . Use uma chave de criptografia de 128 bits.
  • 2
    . Use uma chave de criptografia de 192 bits.
  • 3
    . Use uma chave de criptografia de 256 bits.
INTERPRETASROWS
N
Y, N
Indica se a definição de velocidade em linhas ou quilobytes é interpretada. As opções são:
  • Y. Interpretar a definição de velocidade em linhas.
  • N. Interpretar a definição de velocidade em kilobytes.
O padrão é Y.
ISOLATION
NONE
ALL, CHG, CS, NONE ou RR
Somente no DB2 para i5/OS. O escopo de confirmação da transação. Esse parâmetro normalmente é definido como CS.
JRNL
-
LIBRARY/JOURNAL
Somente no i5/OS. O nome totalmente qualificado da biblioteca e do diário que será usado no lugar daquele especificado no registro de captura do PowerExchange.
Por exemplo:
STQA/NEWJOURNAL
LIBRARYLIST
Máximo de 34 bibliotecas.
Cada nome de biblioteca tem no máximo dez caracteres.
Uma lista de bibliotecas delimitada por espaços que o PowerExchange pesquisará para qualificar o primeiro nome de tabela, se o nome de tabela não for qualificado, em uma instrução de seleção, inserção, exclusão ou atualização.
Se você especificar uma lista de bibliotecas nos parâmetros LIBRARYLIST e OVRDBF, e uma tabela for encontrada nas duas listas, a que for encontrada no parâmetro OVRDBF terá precedência.
LOCALCODEPAGE
Nenhum
-
Um número que identifica a página de código a ser usada. Por exemplo, 41 representa UTF-8.
Especifique NONE para usar o valor da página de código especificado no arquivo de configuração DBMOVER no tempo de execução.
Você pode usar o utilitário de linha de comando icucheck.exe para gerar uma lista de consulta de números com os nomes das páginas de código correspondentes. Você pode enviar os resultados do utilitário para um arquivo da seguinte forma:
icucheck.exe > iculist.txt
LOCATION
Nenhum
Nenhum
A localização da fonte de dados.
A localização é definida por uma instrução NODE no arquivo de configuração dbmover.cfg do sistema local.
MAXROWS
0
0 a 2147483647
O número máximo de linhas para recuperação.
O padrão é 0, que indica linhas ilimitadas.
MQGETOPT
R
B ou R
O tipo de operação de leitura a ser executada em uma fila do MQSeries.
As opções são:
  • B. Procurar. Lê uma cópia dos dados na fila.
  • R. Ler. Lê os dados e os remove da fila.
O padrão é R.
NOUPDATECDEP
N
Y ou N
Indica se a saída do teste de linha do banco de dados será adicionada à trilha de auditoria do CDC do PowerExchange.
As opções são:
  • Y. Omitir a saída do teste de linha do banco de dados da trilha de auditoria do CDC do PowerExchange do aplicativo.
  • N. Incluir a saída do teste de linha do banco de dados na trilha de auditoria do CDC do PowerExchange do aplicativo.
ORACOLL
-
-
Substitui o valor especificado no parâmetro ORACOLL da instrução ORAD CAPI_CONNECTION no arquivo de configuração DBMOVER.
Permite o uso de um único conjunto de registros de captura para capturar dados de até dez instâncias do Oracle ao mesmo tempo.
ORACONN
-
-
Substitui o valor da cadeia de conexão Oracle no terceiro parâmetro posicional na instrução ORACLEID no arquivo de configuração dbmover.cfg. Por exemplo:
ORACLEID=(
coll_id
,
oracle_sid
,
connect_string
,
cap_connect_string
)
Usado em conjunto com o valor ORAINST para permitir o uso de um único conjunto de registros de captura para capturar dados de várias instâncias do Oracle.
Se você especificar um valor ORACONN sem um valor ORAINST, a captura Oracle usará o valor da string de conexão Oracle especificado na instrução ORACLEID no arquivo dbmover.cfg.
ORAINST
-
-
Substitui o valor da instância do Oracle no segundo parâmetro posicional da instrução ORACLEID no arquivo de configuração dbmover.cfg.
Por exemplo:
ORACLEID=(
coll_id
,
oracle_sid
,
connect_string
,
cap_connect_string
)
Usado em conjunto com o valor ORACONN para permitir o uso de um único conjunto de registros de captura para capturar dados de várias instâncias do Oracle.
Se você especificar um valor ORAINST, mas nenhum valor ORACONN, a captura do Oracle usará o valor da sequência de caracteres de conexão do Oracle especificado na instrução ORACLEID do arquivo dbmover.cfg.
ORASCHEMA
-
-
Substitui o valor do esquema do Oracle em um grupo de registro do PowerExchange para permitir o uso de um único conjunto de registros de captura para capturar dados de vários esquemas que possam existir em uma instância do Oracle.
OVRDBF
-
Máximo de oito arquivos. Cada especificação de arquivo tem no máximo 43 caracteres, conforme o seguinte:
  • Dez caracteres para o valor
    filename
  • Dez caracteres para o valor
    newlibrary
  • Dez caracteres para o valor
    newfilename
  • Dez caracteres para o valor
    newmember
    , se especificado
  • Três caracteres para os separadores de barra (/)
A lista delimitada por espaços das substituições de arquivo no seguinte formato:
filename
/
newlibrary
/
newfilename
/
newmembername
Como alternativa, você pode usar o seguinte formato:
filename
/
newlibrary
/
newfilename
/
Nesse formato, o membro assume *FIRST como padrão.
Quando você usa essa substituição, todas as ocorrências do nome do arquivo especificado em uma instrução SQL são substituídas pela combinação
newlibrary/newfilename/newmembername
, quer o arquivo esteja ou não qualificado. Isso inclui qualquer arquivo especificado na substituição LIBRARYLIST.
Se você especificar uma lista de bibliotecas nos parâmetros LIBRARYLIST e OVRDBF, e uma tabela for encontrada nas duas listas, a que for encontrada no parâmetro OVRDBF terá precedência.
PACESIZE
O valor do parâmetro rows_requested da API.
Numérico
O número de linhas ou quilobytes. Defina esse parâmetro quando, por exemplo, um aplicativo interativo não puder acompanhar o fluxo de dados do Ouvinte do PowerExchange.
Para obter desempenho máximo, defina esse parâmetro como 0.
PWXOVERRIDES
Nenhum
-
Substituições que se aplicam a conexões ODBC do PowerExchange para movimentação de dados em massa e sessões do CDC:
  • ARRAYSIZE. O tamanho do array de busca do DB2, em número de linhas, para operações de movimentação de dados em massa do DB2 que usam o método de acesso DB2. O tamanho da matriz pertence a instruções FETCH de várias linhas do DB2 que o PowerExchange usa para ler os dados das tabelas de origem do DB2. Os valores válidos vão de 1 a 5000. O padrão é 25.
    O PowerExchange reduz dinamicamente o tamanho da matriz quando todas as seguintes condições são verdadeiras:
    • O tipo de banco de dados é DB2.
    • A tabela contém colunas LOB.
    • O valor ARRAYSIZE é maior que 1.
    • O tamanho da linha * ARRAYSIZE é maior que 16000000 bytes.
  • LOWVALUES. Se você tiver definido anteriormente a instrução LOWVALUES no arquivo de configuração DBMOVER como Y para sessões do PowerExchange Client for PowerCenter (PWXPC), poderá usar esse parâmetro ODBC para especificar uma substituição de LOWVALUES=N para sessões que usam conexões ODBC do PowerExchange. Você deve usar o PWXPC em vez de ODBC para preservar os valores hexadecimais '0', chamados de
    valores baixos
    , na campos de caracteres de origem ao transferir esses valores para uma sessão do PowerCenter para entrega para um destino VSAM no
    z/OS
    ou um destino de arquivo sequencial no Linux, no UNIX, no Windows ou no z/OS.
  • TCPIP_OP_TIMEOUT. Especifica um tempo limite, em segundos, para uma operação de rede. Quando o segmento do aplicativo do lado do cliente detecta que a operação de rede excede esse intervalo de tempo limite, o PowerExchange encerra a conexão e emite uma mensagem de erro de tempo limite.
  • TCPIP_CON_TIMEOUT. Especifica um tempo de espera, em segundos, para uma tentativa de conexão. Se o PowerExchange não conseguir estabelecer uma conexão ODBC dentro desse intervalo de tempo, o PowerExchange emite uma mensagem de erro.
  • TCPIP_HB_INTERVAL. Especifica um intervalo de pulsação, em segundos, que substitui o intervalo de pulsação de 507 segundos padrão de
    TCP/IP
    . Se o PowerExchange não receber dados antes do intervalo de pulsação de TCP/IP expirar, o PowerExchange encerrará a conexão ODBC e o fluxo de trabalho associado a um erro de tempo limite de pulsação. Use essa substituição para evitar conexões perdidas de erros de tempo limite de pulsação de TCP/IP.
  • USE_CATALOG_METADATA. Especifique USE_CATALOG_METADATA = Y para ler metadados do catálogo durante uma sessão de carregamento em massa do DB2, em vez de emitir uma instrução SELECT. Em seguida, quando o PowerExchange ler os metadados do catálogo, não será necessário conceder privilégios SELECT do PowerExchange na tabela.
Use a seguinte sintaxe:
PWXOVERRIDES=ARRAYSIZE=
array_size
PWXOVERRIDES=LOWVALUES=N
PWXOVERRIDES=TCPIP_OP_TIMEOUT=
network_operation_timeout
PWXOVERRIDES=TCPIP_CON_TIMEOUT=
connection_timeout
PWXOVERRIDES=TCPIP_HB_INTERVAL=
nnnnn
PWXOVERRIDES=USE_CATALOG_METADATA=Y
Se você especificar várias substituições, use uma vírgula (,) como separador, por exemplo:
PWXOVERRIDES=TCPIP_OP_TIMEOUT=
nnn
,TCPIP_CON_TIMEOUT=
nnn
PWXOVERRIDES=LOWVALUES=N
REJECTFILE
Nenhum
Até 384 caracteres
Disponível somente se o parâmetro CONFIRMWRITE estiver definido como T, o que ativa o modo assíncrono com tolerância a falhas.
A localização e o nome do arquivo rejeitado usado durante as operações de gravação assíncrona.
Insira um valor de PWXDISABLE para desativar o log de arquivos rejeitados.
Para obter mais informações, consulte o
Guia de Movimentação de Dados em Massa do PowerExchange
.
STOPONERRORS
0
0 a 2147483647
Disponível somente se o parâmetro CONFIRMWRITE estiver definido como T, o que ativa o modo assíncrono com tolerância a falhas.
O número de erros não fatais permitido na fase de gravação antes do término do processamento.
Para obter mais informações, consulte o
Guia de Movimentação de Dados em Massa do PowerExchange
.
UAP
Nenhum
-
Somente para fontes de dados do DB2 para i5/OS. Substitui o nome totalmente qualificado da biblioteca e do diário especificado no registro de captura do PowerExchange.
Por exemplo:
STQA/NEWJOURNAL
WAITTIME
-
0
2 a 86399
86400
O tempo máximo aproximado, em segundos, a aguardar os dados antes de retornar o fim do arquivo (EOF). As opções são:
  • 0. O EOF é retornado quando o fim do log atual é atingido. O fim do log é determinado no início do processo de extração, porque o ponto final real muda constantemente.
  • 2 a 86399. O número de segundos a aguardar os dados antes de retornar o EOF.
  • 86400. O EOF nunca é retornado. O trabalho aguarda indefinidamente.
XTRASCHEMA
-
Até 128 caracteres, sem espaços.
Substitui o esquema definido no mapa de extração.
A tabela a seguir descreve o parâmetro DBQUAL1:
Tokens
DBType
Biblioteca/Nome do Arquivo do i5/OS
CAPX e CAPX/RT
SSID ou DBName
DB2, DB2400C e DB2UDB
Não aplicável
DB2390IMG
Não aplicável
IMSUNLD
DSN
MSSQL
Não aplicável
NRDB e NRDB2
*Nome de Rede do SQL
ORACLE
A tabela a seguir descreve o parâmetro DBQUAL2:
Tokens
DBType
Nome do aplicativo
CAPX e CAPX/RT
Não aplicável
DB2, DB2400C e DB2UDB
SSID
DB2390IMG
Não aplicável
IMSUNLD
Banco de Dados
MSSQL
Não aplicável
NRDB e NRDB2
Não aplicável
ORACLE
Qualquer fonte de dados compatível, como DB2
O método de acesso de arquivo ou banco de dados.