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

GetDatabaseKey

GetDatabaseKey

Gets the database key for a record or a segment.
Alternatively, you can return the extended relative byte address (XRBA) for a VSAM ESDS data set or the relative record number (RRN) for a VSAM RRDS data set by using the following methods:
  • To get the XRBA for ESDS data sets, select the
    Prefix record with XRBA
     option on the
    ESDS Access Method
     tab in the
    Data Map Properties
     dialog box for the ESDS data map.
  • To get the RRN for RRDS data sets, select the
    Prefix Record with RRN
     option on the
    RRDS Access Method
     tab in the
    Data Map Properties
     dialog box for the RSDS data map.
Syntax: 
GetDatabaseKey()
Or, use the following alias: 
GetDbKey()
Returns:
The following table describes the objects that are returned, based on the source type of the data map:
Access Method
Data Source
Database Key Object Returned
Datatype
ADABAS
Adabas
Internal sequence number (ISN)
NUM32
ESDS
VSAM entry-sequenced data set (ESDS) on z/OS
Extended relative byte address (XRBA)
BIN 8
IDMS
IDMS
Database key
NUM32
DL/1 BATCH
IMS ODBA
IMS
Relative byte address (RBA)
BIN 8
SEQ
i5/OS files that are accessed sequentially
Relative record number (RRN)
NUM32
RRDS
VSAM relative record data set (RRDS) on z/OS
Relative record number (RRN)
NUM32
Although an IMS RBA is 4 bytes long, the GetDatabaseKey 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.
  • 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
  • This function supports before-image buffering, which is required for adding before-image and change-indicator columns for the user-defined expression fields.
0 COMMENTS
We’d like to hear from you!