Navigator User Guide

10.5.3
- 10.5.8
- 10.5.6
- 10.5.5
- 10.5.4
- 10.5.2
- 10.5.1
- 10.5
- 10.4.1
- 10.4.0 HotFix 1
- 10.4.0

Anterior Avançar

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.

Funções do PowerExchange

GetDatabaseKey

Baixar guia

Enviar comentários

Communities

Knowledge Base

Portal de Sucesso

Rename Saved Search

Sumário

Navigator User Guide

Navigator User Guide

GetIMSRBAByLevel

GetIMSRBAByLevel