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

GetCurrentFileName

GetCurrentFileName

For a data map record defined for a nonrelational data source, gets the name of the source data file.
Use the GetCurrentFileName function to determine the data file from which data for a record is read. You might use this information to complete the following tasks:
  • For a data map that is associated with a single data file, verify that all records from the data file were processed.
  • For a data map that is associated with a file-list file, verify that all records from all data files listed in the file-list file were processed.
  • Trace a row back to its original data file.
This function runs on all operating systems and runs in read mode.
result
=GetCurrentFileName()
The following table describes the parameters:
Result
Description
Datatype
result
Returns the name of the the data file from which data for a record is read.
If the data map is associated with a file-list file, records might be read from multiple data files.
VARCHAR. Maximum length is 512 bytes plus a null termination character.
  • On i5/OS, the GetCurrentFileName function does not attempt to return the actual member name when a file is comprised of multiple members and *FIRST and *LAST are specified in the file name. The GetCurrentFileName function returns the file name that was passed to the open function.
  • On Linux, UNIX, and Windows, the GetCurrentFileName function does not attempt to get the full file name if it is qualified by relative directory paths, such as:
    ../../myfile.dat
    . Instead, the GetCurrentFileName function returns the following value:
    ../../myfile.dat
    .
  • In the following situations on z/OS, the GetCurrentFileName function might return file names that are more precise than the names listed in a file-list file:
    • Generation data group (GDG) file name in a data map or file-list file
    • DD name in a data map or file-list file

0 COMMENTS

We’d like to hear from you!