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

[. . . ] Match/Consolidate Custom Programmer's Reference Match/Consolidate 7. 90c November 2008 Copyright information © 2008 Business Objects, an SAP company. Business Objects owns the following U. S. patents, which may cover products that are offered and licensed by Business Objects: 5, 295, 243; 5, 339, 390; 5, 555, 403; 5, 590, 250; 5, 619, 632; 5, 632, 009; 5, 857, 205; 5, 880, 742; 5, 883, 635; 6, 085, 202; 6, 108, 698; 6, 247, 008; 6, 289, 352; 6, 300, 957; 6, 377, 259; 6, 490, 593; 6, 578, 027; 6, 581, 068; 6, 628, 312; 6, 654, 761; 6, 768, 986; 6, 772, 409; 6, 831, 668; 6, 882, 998; 6, 892, 189; 6, 901, 555; 7, 089, 238; 7, 107, 266; 7, 139, 766; 7, 178, 099; 7, 181, 435; 7, 181, 440; 7, 194, 465; 7, 222, 130; 7, 299, 419; 7, 320, 122 and 7, 356, 779. Business Objects and its logos, BusinessObjects, Business Objects Crystal Vision, Business Process On Demand, BusinessQuery, Cartesis, Crystal Analysis, Crystal Applications, Crystal Decisions, Crystal Enterprise, Crystal Insider, Crystal Reports, Crystal Vision, Desktop Intelligence, Inxight and its logos , LinguistX, Star Tree, Table Lens, ThingFinder, Timewall, Let There Be Light, Metify, NSite, Rapid Marts, RapidMarts, the Spectrum Design, Web Intelligence, Workmail and Xcelsius are trademarks or registered trademarks in the United States and/or other countries of Business Objects and/or affiliated companies. [. . . ] No = You cannot call this support function. 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. [. . . ] 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. [. . . ]