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. Funções do PowerExchange para Campos Definidos pelo Usuário
  12. Programas de Método de Acesso do Usuário
  13. Grupos de Aplicativos e Aplicativos
  14. Propriedades do Mapa de Dados
  15. Propriedades do Registro, Campo e Tabela
  16. Carimbos de Data/Hora DTL__CAPXTIMESTAMP
  17. 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

CallProg

CallProg

Chama uma subrotina ou um programa definido pelo usuário para processar os dados de origem em um registro.
Sintaxe:
[
result
=]CallProg('
program
','
subroutine
','
linkage
'[,
arg1
][,
arg2
][,
...
])
Os parâmetros são:
  • result
    . Opcional. NUM32. Esse argumento contém o valor de retorno do programa chamado pela função CallProg, que é um dos seguintes valores:
    • 0
      . Sucesso.
    • Não zero
      . Falha.
      Se você não especificar um argumento de resultado e um código de retorno diferente de zero for retornado do programa externo, CallProg executará as seguintes respostas de erro de nível de mapa padrão:
    • Encerra a extração.
    • Ignora essa subrotina.
  • programa
    . O nome do programa que contém a subrotina. Dependendo do sistema operacional, o programa é um dos seguintes:
    • i5/OS
      . Um programa de serviço.
    • Linux ou UNIX
      . Um objeto compartilhado.
    • Windows
      . Um DLL.
    • z/OS
      . Um módulo de carregamento.
      Coloque o nome do programa entre aspas simples.
  • subrotina
    . O nome do ponto de entrada no programa. Dependendo do sistema operacional, a subrotina é uma das seguintes:
    • i5/OS
      . O nome da subrotina.
    • Linux, UNIX ou Windows
      . O nome da subrotina.
    • z/OS para Assembler, C ou COBOL
      programas
      . Você deve apresentar um valor, mas ele é ignorado e é usado o ponto de entrada padrão para o módulo de carregamento. Especifique o mesmo nome que o programa.
    • programas z/OS para PL/I
      . Se várias subrotinas que podem ser obtidas residirem no mesmo módulo de carregamento, especifique o nome da subrotina.
      Coloque o nome da subrotina entre aspas simples.
  • vínculo
    . O tipo de vínculo, que determina a maneira que os argumentos são passados e os códigos de retorno são retornados do programa ou da subrotina.
    A tabela a seguir descreve cada tipo de vínculo:
    Tipo de Vínculo
    Sistemas Operacionais Suportados
    Argumentos
    Retornos
    C
    • i5/OS
    • Linux, UNIX e Windows
    • z/OS
    Passado por meio da pilha
    Código de retorno de programa
    COBOL
    z/OS
    Passado como uma lista de endereços
    Endereço de número inteiro do código de falha
    SO
    z/OS
    Passado como uma lista de endereços
    Código de retorno de programa
    OS400
    i5/OS
    Passado como uma lista de endereços
    Endereço de número inteiro do código de falha
    PLI
    z/OS
    Passado como uma lista de endereços
    Endereço de número inteiro do código de falha
    Coloque o tipo de vínculo entre aspas simples.
  • [,
    arg1
    ][,
    arg2
    ][,
    ...
    ]. Um ou mais argumentos opcionais passados para o programa ou subrotina.