Communities
A collaborative platform to connect and grow with like-minded Informaticans across the globe
Product Communities
Connect and collaborate with Informatica experts and champions
Discussions
Have a question? Start a Discussion and get immediate answers you are looking for
User Groups
Customer-organized groups that meet online and in-person. Join today to network, share ideas, and get tips on how to get the most out of Informatica
Get Started
Community Guidelines
Knowledge Center
Troubleshooting documents, product guides, how to videos, best practices, and more
Knowledge Base
One-stop self-service portal for solutions, FAQs, Whitepapers, How Tos, Videos, and more
Support TV
Video channel for step-by-step instructions to use our products, best practices, troubleshooting tips, and much more
Documentation
Information library of the latest product documents
Velocity (Best Practices)
Best practices and use cases from the Implementation team
Learn
Rich resources to help you leverage full capabilities of our products
Trainings
Role-based training programs for the best ROI
Certifications
Get certified on Informatica products. Free, Foundation, or Professional
Product Learning Paths
Free and unlimited modules based on your expertise level and journey
Resources
Library of content to help you leverage the best of Informatica products
Tech Tuesdays Webinars
Most popular webinars on product architecture, best practices, and more
Product Availability Matrix
Product Availability Matrix statements of Informatica products
SupportFlash
Monthly support newsletter
Support Documents
Informatica Support Guide and Statements, Quick Start Guides, and Cloud Product Description Schedule
Product Lifecycle
End of Life statements of Informatica products
Ideas
Events
Change Request Tracking
Marketplace
English
  • PowerExchange for CDC and Mainframe 10.5.1
  • All Products

Table of Contents

Search

  1. Preface
  2. PowerExchange Navigator Introduction
  3. Data Maps
  4. Data Maps for Specific Data Sources
  5. Copybooks
  6. Registration Groups and Capture Registrations
  7. Extraction Groups and Extraction Maps
  8. Personal Metadata
  9. Database Row Test
  10. PowerExchange Navigator Examples
  11. Appendix A: PowerExchange Functions for User-Defined Fields
  12. Appendix B: User Access Method Programs
  13. Appendix C: Application Groups and Applications
  14. Appendix D: Data Map Properties
  15. Appendix E: Record, Field, and Table Properties
  16. Appendix F: DTL__CAPXTIMESTAMP Time Stamps
  17. Appendix G: Trace for Creating a Memory Map When Importing a COBOL Copybook

Navigator User Guide

Navigator User Guide

Back Next

GetIMSRBAByLevel

GetIMSRBAByLevel

For data map records defined for IMS data sources, gets the RBA value of an IMS segment at the specified level of the path of the current segment.
To add the segment RBA to segment data in an IMS data map, Informatica recommends that you use the GetIMSRBAByLevel function rather than the GetDatabaseKey function. The GetIMSRBAByLevel function enables you to get the RBA of an unkeyed or non-unique keyed parent segment.
Use the GetIMSRBAByLevel function in IMS data maps used for bulk data movement operations or IMS synchronous CDC.
You cannot use the GetIMSRBAByLevel function in records in the following types of IMS data maps:
  • IMS data maps used for IMS log-based CDC.
  • IMS data maps used to access IMS unload files that contain the following types of records:
    • Unload records of any format for HISAM data sets
    • Unload records that have the format BMC SHORT or BMC XSHORT for HDAM and HIDAM data sets
    • Unload records that have the standard IBM format for IMS Fast Path data sets
To run a database row test on the following types of data maps that use the GetIMSRBAByLevel function, you must
APF-authorize
 the following libraries:
  • If you use IMS DL/1 batch data maps with BMP for the netport job, you must
    APF-authorize
     all libraries in the BMP STEPLIB concatenation. Otherwise, PowerExchange issues message PWX-02204 with return code 12.
  • If you use IMS ODBA data maps, you must
    APF-authorize
     all libraries in the STEPLIB concatenation of the PowerExchange Listener. Otherwise, PowerExchange abends.
Syntax:
 
result
=GetIMSRBAByLevel([
integer
])
The following table describes the parameters:
Parameter
Description
Datatype
result
Returns the 8-byte binary value of the RBA of the requested segment.
NUM64, NUM64U, or BIN with a length of 8
integer
Optional. The type of request , which is one of the following:
  • No value. The RBA of the current segment is returned.
  • Positive integer. The 4-byte integer level number of the segment in the IMS hierarchy for which to get the RBA. The level number is limited to the level number of the current segment in the hierarchy or any ancestors of the segment. For example, for a segment at level 3 of a 5-level hierarchy, you can request the RBA of the segment at level 1, 2, or 3. If you request the RBA for segments in the hierarchy below the level of the current segment, a run-time error occurs.
  • Negative integer. Indicates a relative request. For example, you can request the RBA of the segment two levels above the level of the current segment by specifying -2. If you specify a negative integer with an absolute value that is greater than or equal to the level number of the current segment, a run time error occurs.
NUM64
Although an IMS RBA is four bytes long, the GetIMSRBAByLevel function returns an 8-byte binary representation of the RBA value for the requested segment. Eight bytes are required to allow for future expansion and to guarantee uniqueness for FastPath and HALDB databases.
0 COMMENTS
We’d like to hear from you!