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

Instrução CAPI_CONNECTION - UOWC

Instrução CAPI_CONNECTION - UOWC

A instrução UOWC CAPI_CONNECTION especifica um conjunto denominado de parâmetros que a API (CAPI) de Consumo usa no UOW Cleanser.
No fluxo de mudança de algumas fontes de dados, as alterações de vários UOWs são mescladas entre si. O UOW Cleanser reconstrói as alterações entremescladas lidas no fluxo de mudança nos UOWs concluídos, em ordem cronológica baseada na hora de término.
i5/OS, Linux, UNIX, Windows e z/OS
DB2 para iOrigens de CDC do 5/OS e do z/OS
CAPI_CONNECTION - AS4J e CAPI_CONNECTION - LRAP
Sim, no CDC das fontes especificadas
CAPI_CONNECTION=([DLLTRACE=
trace_id
]   ,NAME=
capi_connection_name
  [,TRACE=
trace_name
]   ,TYPE=(UOWC     ,CAPINAME=
source_capi_name
    [,BLKSIZE=
block_size
] [,CUOWS={
number_of_concurrent_UOWs
|
34
}]     [,DATACLASS=
data_class
]     [,LARGEOPS=
number_of_operations
]     [,MEMCACHE={
cache_size
|
1024
}]     [,MONITORINT={
minutes
|
5
}]    [,RSTRADV=
seconds
]     [,SPACEPRI={
primary_space
|
50
}]     [,SPACETYP={
BLK
|TRK|CYL}]     [,SPILLKEEP=
number_of_spill_files
]     [,STORCLASS=
storage_class
]     [,TIMESTAMP={
LOG
|COMMIT}]    [,UNIT=
unit
]      ) )
DLLTRACE=
trace_id
Opcional. Um nome definido pelo usuário para a instrução TRACE que ativa o rastreamento de DLL interno para essa CAPI.
Especifique esse parâmetro apenas sob a orientação do Suporte Global a Clientes da Informatica.
NAME=
capi_connection_name
Obrigatório. Um nome exclusivo definido pelo usuário para essa instrução CAPI_CONNECTION.
O tamanho máximo é de oito caracteres alfanuméricos.
TRACE=
trace_name
Opcional. Um nome definido pelo usuário para a instrução TRACE que ativa o rastreamento de CAPI comum.
Especifique esse parâmetro apenas sob a orientação do Suporte Global a Clientes da Informatica.
TYPE=(UOWC, ... )
Obrigatório. O tipo de instrução CAPI_CONNECTION. Para o UOW Cleanser, esse valor deve ser UOWC.
CAPINAME=
capi_name
Obrigatório. O valor de parâmetro NAME na instrução CAPI_CONNECTION específica da fonte relacionada, que pode ser um dos seguintes tipos de instrução:
  • Instrução AS4J CAPI_CONNECTION para origens DB2 para i (i5/OS)
  • Instrução LRAP CAPI_CONNECTION para fontes de dados z/OS
BLKSIZE=
block_size
Opcional. O tamanho do bloco, em bytes, para os arquivos spill UOW sequenciais que o UOW Cleanser cria quando o cache de memória não pode manter todas as alterações de um UOW.
A tabela a seguir mostra os valores válidos por tipo de origem do CDC:
Tipo de Fonte de Dados
Valores Válidos
Valor Padrão
DB2 para i (i5/OS)
Um número de 8 a 32760
32760
Fontes de dados z/OS
Um número de 8 a 32760
18452
CUOWS=
number_of_concurrent_UOWs
O número esperado de UOWs concorrentes que contêm dados de interesse do CDC. Se você especificou um valor MEMCACHE, terá alocações de arquivo spill em excesso e perceberá um grande número de UOWs simultâneos relatados nas mensagens PWX-10742 ou PWX-10782. Aumente esse valor de parâmetro para fazer com que menos cache de memória seja usado por UOW. Ao reduzir o uso do cache de memória por UOW, mais UOWs simultâneos podem ser acomodados sem alocar arquivos spill. Esse parâmetro não restringe o número máximo de UOWs simultâneos que o UOW Cleanser pode processar.
Os valores válidos vão de 1 a 65535. O padrão é 34.
DATACLASS=
data_class
Opcional. No z/OS, a classe de dados SMS que o UOW Cleanser usa quando aloca os arquivos spill UOW sequenciais. Se você não especificar esse parâmetro, as rotinas SMS ACS poderão atribuir a classe de dados.
LARGEOPS=
número de operações
Opcional. Substitui o valor padrão que o PowerExchange usa para identificar as transações como transações grandes para fins de relatório. Digite o número de operações de DML (inserções, atualizações e exclusões), em milhares, que uma transação deve conter para ser considerada uma transação grande.
O PowerExchange emite mensagens de status para transações grandes que cumpram esses critérios. Se o PowerExchange emitir mensagens em excesso, pode-se aumentar esse valor para limitar o número de mensagens.
Os valores válidos são de 1 a 2147483 (1.000 a 2.147.483.000 de operações). O valor padrão é metade do valor arredondado do parâmetro MEMCACHE para o milhar mais próximo. Com base no valor padrão 1024 KB de MEMCACHE, o valor padrão de LARGEOPS é de 1000 (1.000.000 de operações).
MEMCACHE={
cache_size
|
1024
}
Opcional. O tamanho máximo do cache de memória, em quilobytes, que o PowerExchange aloca para reconstruir UOWs concluídos.
Digite um número de 0 a 2147483647. O padrão é 1024 KB. Se você inserir 0, o tamanho do cache de memória será limitado somente pela memória disponível no sistema.
Para cada sessão de extração, o PowerExchange mantém todas as alterações de cada UOW no cache de memória até que ele processe o registro end-UOW. O PowerExchange aloca o cache de memória incrementalmente até o limite que esse parâmetro especifica. Se o cache de memória for muito pequeno para manter todas as alterações em um UOW, o PowerExchange eliminará as alterações nos arquivos sequenciais em disco, chamados arquivos spill UOW.
Cada arquivo spill UOW contém um UOW. Um UOW poderá exigir vários arquivos spill UOW para manter todas as alterações desse UOW. Se o fluxo de mudança contiver vários UOWs grandes e o cache de memória for insuficiente, o PowerExchange poderá criar inúmeros arquivos spill UOW.
O PowerExchange processará o fluxo de mudança de modo mais eficiente se ele não precisar usar arquivos spill UOW. Um grande número de arquivos spill UOW pode diminuir o desempenho de extração e causar falta de espaço em disco.
Se o fluxo de mudança contiver UOWs pequenos, o valor padrão poderá ser suficiente. No entanto, a Informatica recomenda especificar um valor mais alto porque o valor padrão geralmente é muito baixo.
A localização em que o PowerExchange aloca os arquivos spill UOW varia conforme o sistema operacional da seguinte forma:
  • No i5/OS, o PowerExchange usa o comando CRTPF para criar um arquivo físico para arquivos spill UOW.
    O PowerExchange nomeia os arquivos spill UOW usando a função C/C++ tmpnam().
  • No Linux e UNIX, o PowerExchange usa o diretório atual por padrão para arquivos spill UOW. Para usar um diretório diferente, especifique a variável de ambiente TMPDIR.
    O PowerExchange nomeia os arquivos spill UOW usando o prefixo "dtlq" e a função tempnam do sistema operacional.
    Os arquivos spill UOW são arquivos temporários que são excluídos quando fechados pelo PowerExchange. Esses arquivos não são visíveis no diretório enquanto estão abertos.
  • No Windows, o PowerExchange usa o diretório atual por padrão para arquivos spill UOW. Para usar um diretório diferente, especifique a variável de ambiente TMP.
    O PowerExchange nomeia os arquivos spill UOW usando o prefixo "dtlq" e a função _tempnam do Windows.
  • No z/OS, o PowerExchange usa alocação dinâmica para alocar conjuntos de dados temporários para os arquivos spill UOW. Em geral, o SMS controla a localização de conjuntos de dados temporários. Se você não usar o SMS para controlar conjuntos de dados temporários, o parâmetro UNIT controlará a localização dos arquivos spill UOW.
    Como o PowerExchange aloca conjuntos de dados temporários para os arquivos spill UOW, o z/OS atribui a esses arquivos nomes de conjunto de dados gerados pelo sistema, que começam com SYS
    yyddd
    .T
    hhmmss
    .RA000.
    jobname
    .
  • Para z/OS, MEMCACHE não pode exceder 25600 em uma tarefa de listener ou 1024000 em uma trabalho netport.
    Se muitos arquivos auxiliares estiverem sendo criados, a Informatica recomenda que você especifique um valor maior no intervalo de 1024 a 25600.
O PowerExchange aloca o tamanho do cache para cada operação de extração. Se você usar uma grande valor de MEMCACHE e executar muitas sessões de extração simultâneas, poderão ocorrer restrições de memória.
MONITORINT=
minutos
Opcional. Período em minutos no qual o PowerExchange verifica a atividade de transação para transações pendentes e transações grandes. Transação pendente longa é a que permanece ativa por dois intervalos de monitoramento e transação grande é a que atende aos critérios de LARGEOPS. Quando o período termina, o PowerExchange emite mensagens que identificam as transações grandes e pendentes longas e informa sua atividade de processamento. O PowerExchange também emite mensagens que identificam a posição atual no fluxo de mudança. Os valores válidos vão de 0 a 720. O valor 0 desativa o monitoramento. O padrão é 5.
RSTRADV=
seconds
O intervalo de tempo, em segundos, que o PowerExchange aguarda antes de antecipar os tokens de reinicialização e sequência para uma fonte de dados registrada, durante os períodos em que os UOWs não incluem alterações de interesse da fonte de dados. Quando o intervalo de espera termina, o PowerExchange retorna o próximo "UOW vazio" confirmado, que inclui apenas informações atualizadas de reinicialização.
Digite um número de 0 a 86400. Nenhum padrão é especificado.
O PowerExchange zera o intervalo de espera quando um dos seguintes eventos ocorre:
  • O PowerExchange conclui o processamento de um UOW que inclui alterações de interesse.
  • O PowerExchange retorna um UOW vazio porque o intervalo de espera terminou sem que o PowerExchange recebesse nenhuma alteração de interesse.
Por exemplo, se você especificar 5, o PowerExchange aguardará cinco segundos depois de concluir o processamento do último UOW ou após o término do intervalo de espera anterior. Em seguida, o PowerExchange retorna o próximo UOW vazio confirmado que inclui informações atualizadas de reinicialização e zera o intervalo de espera.
Se você não especificar RSTRADV, o PowerExchange não antecipará os tokens de reinicialização e sequência para uma fonte registrada, durante os períodos em que ele não receber alterações de interesse. Quando o PowerExchange for inicializado a quente, ele lerá todas as alterações, incluindo aquelas que não são de interesse do CDC, do ponto de reinicialização.
Nas origens DB2 para i5/OS, a Informatica recomenda que você use esse parâmetro se os registros de alterações lidos pelo PowerExchange dos destinatários do diário do i5/OS forem criados sob controle de confirmação. Se os registros de alterações forem criados sem controle de confirmação, não especifique esse parâmetro.
Um valor 0 pode diminuir o desempenho. Além dos UOWs que contêm alterações das origens registradas de interesse, o PowerExchange retorna um UOW vazio para cada UOW que não contém alterações das origens registradas de interesse.
SPACEPRI={
primary_space
|
50
}
Opcional. No z/OS, a quantidade de espaço primário que o UOW Cleanser usa para alocar arquivos spill UOW. O parâmetro SPACETYP indica o tipo de unidades de espaço.
Digite um número de 1 a 16777215. O padrão é 50 blocos.
O UOW Cleanser não usa espaço secundário. Em vez disso, quando um arquivo spill torna-se cheio, o UOW Cleanser aloca outro do mesmo tamanho.
As rotinas SMS ACS podem substituir o tamanho do arquivo spill UOW.
No i5/OS, o UOW Cleanser aloca arquivos spill UOW como arquivos físicos com SIZE(*NOMAX), o que significa que o tamanho máximo do arquivo spill é controlado pelo tamanho máximo de arquivo do sistema. No Linux, UNIX e Windows, o PowerExchange aloca arquivos spill UOW como arquivos temporários de 2 GB.
SPACETYP={
BLK
|TRK|CYL}
Opcional. No z/OS, o tipo de unidades em que é expresso o espaço primário para alocação de arquivos spill do UOW Cleanser.
As opções são:
  • BLK
    . Blocos.
  • CYL
    . Cilindros.
  • TRK
    . Rastreia.
O padrão é BLK.
SPILLKEEP=
número_de_arquivos_spill
Opcional. O número de arquivos spill que o UOW Cleanser retém para reatribuição. O UOW Cleanser retém os arquivos spill em vez de desalocá-los de forma que estejam disponíveis para serem reatribuídos para novas transações. Esse recurso foi projetado para evitar a desalocação de arquivos e a atividade de alocação excessivas.
Os valores válidos vão de 0 a 999. Em z/OS e i5/OS, o padrão é 3. Em Linux, UNIX e Windows, o padrão é 0.
STORCLASS=
storage_class
Opcional. No z/OS, o nome da classe de armazenamento SMS que o UOW Cleanser usa para alocar arquivos spill UOW.
TIMESTAMP={
LOG
|COMMIT}
Opcional. O tipo de registro de data/hora que o PowerExchange registra na coluna DTL_CAPXTIMESTAMP gerada de cada registro de alteração de uma transação. Especifique esse parâmetro somente se você quiser exibir o registro de data/hora de confirmação, em vez do registro de data/hora dos logs de origem ou dos conjuntos de dados.
As opções são:
  • LOG
    . O registro de data/hora de uma alteração no banco de dados de origem, conforme registrado pelo DBMS nos logs do banco de dados de origem ou conjuntos de dados próximos ao momento em que a alteração é feita. Para obter mais informações, consulte DTL__CAPXTIMESTAMP Time Stamps.
  • COMMIT
    . O carimbo de data/hora de confirmação da transação no banco de dados de origem. Especifique essa opção se você usar o carimbo de data/hora para calcular a latência.
O padrão é LOG.
UNIT=
unit
Opcional. No z/OS, o nome de unidade genérico ou exclusivo que o UOW Cleanser usa para alocar arquivos spill UOW.