Sumário

Search

  1. Prefácio
  2. Introdução ao Navegador do PowerExchange
  3. Mapas de Dados
  4. Mapas de Dados para Fontes de Dados Específicas
  5. Copybooks
  6. Grupos de Registro e Registros de Captura
  7. Grupos de Extração e Mapas de Extração
  8. Metadados Pessoais
  9. Teste de Linha de Banco de Dados
  10. Exemplos do Navegador do PowerExchange
  11. Apêndice A: Funções do PowerExchange para Campos Definidos pelo Usuário
  12. Apêndice B: Programas de Método de Acesso do Usuário
  13. Apêndice C: Grupos de Aplicativos e Aplicativos
  14. Apêndice D: Propriedades do Mapa de Dados
  15. Apêndice E: Propriedades do Registro, Campo e Tabela
  16. Apêndice F: Carimbos de Data/Hora DTL__CAPXTIMESTAMP
  17. Apêndice G: Rastreamento para criar um mapa de memória ao importar um copybook COBOL

Guia do Usuário do Navegador

Guia do Usuário do Navegador

Visão Geral dos Programas de Método de Acesso do Usuário

Visão Geral dos Programas de Método de Acesso do Usuário

Crie um programa de método de acesso do usuário gravado em Assembler, C ou PL/I para processar dados em um mapa de dados.
Você chama o programa de método de acesso do usuário definindo um mapa de dados com o método de acesso USER e especificando os atributos do programa de método de acesso do usuário, incluindo o nome do DLL ou da biblioteca compartilhada do método de acesso do usuário compilado, parâmetros a serem passados para o programa e o caminho e nome completos do arquivo de dados associado.
Um programa de método de acesso do usuário possui um único ponto de entrada. O PowerExchange chama o programa de método de acesso do usuário repetidamente para processar os dados no arquivo de dados associado até que todos os dados sejam processados.
A tabela a seguir lista as chamadas que o PowerExchange faz para um programa de método de acesso do usuário e descreve as ações que o programa pode executar em resposta a uma chamada:
Chamada
Ações Possíveis do Programa de Método de Acesso do Usuário
OPEN
Abrir o arquivo de dados e executar a inicialização, como a seguir:
  • Aloque o armazenamento.
  • Valide e salve os parâmetros passados.
  • Inicialize contadores.
  • Verifique se o arquivo de dados existe.
  • Abra o arquivo de dados.
  • Se o destino tiver que ser substituído, exclua o arquivo de saída.
  • Retorne um código de sucesso ou de erro ao Navegador do PowerExchange.
READ
Iniciar ou continuar a leitura sequencial, como a seguir:
  • Leia o arquivo de dados para obter o próximo registro, usando qualquer instrução SQL passada do Navegador do PowerExchange para obter o registro apropriado.
  • Passe os dados de volta para o Navegador do PowerExchange definindo o ponteiro do registro para apontar para os dados e definindo o valor no campo record_len para o tamanho dos dados que estão sendo retornados.
  • Retorne um código de sucesso, de fim-de-arquivo ou de erro para o PowerExchange.
WRITE
Iniciar ou continuar a gravação sequencial, como a seguir:
  • Obtenha os dados a serem gravados usando o ponteiro do registro e o tamanho definido no campo record_len.
  • Grave os dados especificados.
  • Retorne um código de sucesso ou de erro ao Navegador do PowerExchange.
CLOSE
Executar operações de limpeza, como a seguir:
  • Feche o arquivo de dados.
  • Libere o armazenamento alocado.
  • Confirme o banco de dados.
  • Retorne um código de sucesso ou de erro ao Navegador do PowerExchange.
  • Se ocorrer um erro, coloque o texto da mensagem no buffer de mensagens. O buffer de mensagens suporta uma mensagem de 79 caracteres.
  • Passe o controle de volta para o programa de chamada.
O PowerExchange passa para o programa de método de acesso do usuário uma estrutura de parâmetros com cada chamada. A estrutura de parâmetros inclui os parâmetros que você define no mapa de dados do método de acesso do usuário.
O método de acesso do usuário passa um código de retorno de volta para o Navegador do PowerExchange para indicar o sucesso ou a falha da chamada ou para indicar que o fim do arquivo de dados foi atingido.