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

GetIMSRBAByLevel

GetIMSRBAByLevel

Para registros de mapa de dados definidos para fontes de dados do IMS, obtém o valor RBA de um segmento do IMS no nível especificado do caminho do segmento atual.
Para adicionar o segmento RBA aos dados de segmentos em um mapa de dados IMS, a Informatica recomenda que você use a função GetIMSRBAByLevel em vez da função GetDatabaseKey. A função GetIMSRBAByLevel permite que você obtenha o RBA de um segmento pai sem chave ou com chave não exclusivo.
Use a função GetIMSRBAByLevel nos mapas de dados do IMS usados para operações de movimentação de dados em massa ou CDC síncrono do IMS.
Você não pode usar a função GetIMSRBAByLevel em registros nos seguintes tipos de mapas de dados do IMS:
  • Mapas de dados do IMS usados para CDC com base em logs do IMS.
  • Mapas de dados do IMS usados para acessar arquivos descarregados do IMS que contêm os seguintes tipos de registros:
    • Registros de descarregamento de qualquer formato para os conjuntos de dados HISAM
    • Registros de descarregamento com formato BMC SHORT ou BMC XSHORT para os conjuntos de dados HDAM e HIDAM
    • Registros de descarregamento que apresentam o formato IBM padrão para os conjuntos de dados de Caminho Rápido IMS
Para executar um teste de linha de banco de dados nos seguintes tipos de mapas de dados que usam a função GetIMSRBAByLevel, será necessário
autorizar por APF
as seguintes bibliotecas:
  • Se você usar os mapas de dados do batch IMS DL/1 com BMP para o trabalho netport, será necessário
    autorizar por APF
    de todas as bibliotecas na concatenação STEPLIB de BMP. Caso contrário, o PowerExchange emitirá a mensagem PWX-02204 com o código de retorno 12.
  • Se você usar mapas de dados IMS ODBA, será necessário
    autorizar por APF
    de todas as bibliotecas na concatenação STEPLIB do Ouvinte do PowerExchange. Caso contrário, o PowerExchange será encerrado de forma anormal.
Sintaxe:
result
=GetIMSRBAByLevel([
integer
])
A tabela a seguir descreve os parâmetros:
Parâmetro
Descrição
Tipo de dados
result
Retorna o valor binário de 8 bytes do RBA do segmento solicitado.
NUM64, NUM64U ou BIN com um tamanho de 8
inteiro
Opcional. O tipo de solicitação, que é um dos seguintes:
  • Sem valor. O RBA do segmento atual é retornado.
  • Inteiro positivo. O número do nível do inteiro de 4 bytes do segmento na hierarquia IMS para a qual obter o RBA. O número do nível é limitado ao número do nível do segmento atual na hierarquia ou quaisquer ancestrais do segmento. Por exemplo, para um segmento no nível 3 de uma hierarquia de 5 níveis, você pode solicitar o RBA do segmento no nível 1, 2 ou 3. Se você solicitar o RBA para segmentos na hierarquia abaixo do nível do segmento atual, ocorrerá um erro de tempo de execução.
  • Inteiro negativo. Indica uma solicitação relativa. Por exemplo, você pode solicitar o RBA do segmento dois níveis acima do nível do segmento atual especificando -2. Se você especificar um inteiro negativo com um valor absoluto que seja maior ou igual ao número do nível do segmento atual, ocorrerá um erro de tempo de execução.
NUM64
Embora um IMS RBA tenha quatro bytes, a função GetIMSRBAByLevel retorna uma representação binária de 8 bytes do valor RBA para o segmento solicitado. São necessários oito bytes para permitir a expansão futura e garantir a exclusividade para os bancos de dados FastPath e HALDB.