User manual BUSINESS OBJECTS MATCH-CONSOLIDATE 8.00C CUSTOM PROGRAMMERS REFERENCE

[. . . ] Match/Consolidate Custom Programmer's Reference Match/Consolidate 8. 00c April 2009 Copyright information © 2009 SAP® BusinessObjectsTM. SAP BusinessObjects and its logos, BusinessObjects, Crystal Reports®, SAP BusinessObjects Rapid MartTM, SAP BusinessObjects Data InsightTM, SAP BusinessObjects Desktop IntelligenceTM, SAP BusinessObjects Rapid Marts®, SAP BusinessObjects Watchlist SecurityTM, SAP BusinessObjects Web Intelligence®, and Xcelsius® are trademarks or registered trademarks of Business Objects, an SAP company and/or affiliated companies in the United States and/or other countries. SAP® is a registered trademark of SAP AG in Germany and/or other countries. All other names mentioned herein may be trademarks of their respective owners. 2 Match/Consolidate Custom Programmer's Reference Contents Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Chapter 1: Introduction to Match/Consolidate Custom . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . [. . . ] P = You can call this support function only when the exit function is in the process state. 1 = You can call this support function, but it will always return a 1. 2 = You can call this support function, but it will always return a 2. 26 Match/Consolidate Custom Programmer's Reference Chapter 3: Group posting This chapter explains the available options for performing group posting in Match/Consolidate Custom. Chapter 3: Group posting 27 Group posting options You may perform group posting by any of three methods: Method Description Internal You may perform group posting entirely within the normal Match/Consolidate job, by using Group Posting blocks in your job file. We will call this an internal group-posting operation. You may perform group posting entirely outside of normal Match/Consolidate processing. We will call this an external group-posting operation. You may perform group posting both internally and externally. That is, the user may set up operations through the job file, and then your exit function may perform postprocessing or additional operations. External Both 28 Match/Consolidate Custom Programmer's Reference Setting up external operations You may perform group posting entirely outside of normal Match/Consolidate processing. We will call this an external group-posting operation. Job file Under this method, no Group Posting blocks are used in the job file. However, the job file should include a block for the group-posting report. And in the blocks for output file or purge, the Do Group Posting parameter must be set to Yes. To set up external operations, your main program (not an exit function) should call three functions in the Match/Consolidate Custom library: Call mpc_set_gpst_num_ops() to set the number of external operations to be performed. Call mpc_set_gpst_name() to name your external operation(s). This call has the same effect as the parameter Group Post Name in the Group Posting block. The name that you set is used on the group-posting report, simply to identify each operation. Operations will be listed in the order that you set their names. Call mpc_set_exit() to set up your exit function. Make sure that your exit function will be called at least in the process state, and perhaps in the init and term states as well. To repeat, your exit function will be called only if the user has set the Do Group Posting parameter in the Execution block of the job file to Yes. In the process state, the entire dupe group will be presented to your exit function for processing. In the master dupe, you may perform any transfer or manipulation of data that you desire. Remember that the format of the source and destination records (subordinate and master dupes) are their format from the input file. [. . . ] After mpc_set_group_pos() returns, the same record is still the current record, but it has a new position in the dupe group, so mpc_get_num_current_rec() would yield a different result. Returns Returns MPC_OK if successful. A return value of MPC_ERROR indicates an error, and mpc_errno is set to one of the following values: Value Description MPC_ERR_UNINIT MPC_ERR_IGNORED mpc_init() was not called. Function was called from other than an exit function, or was called from an exit function of an invalid type or state. For more information, see the "Table of exitsupport functions by exit point" on page 26. [. . . ]