Functionality
You can use this method to display shareholding data for certainbusiness partner relationships.
Shareholding data for business partner relationships consists of thefollowing attributes defined in the structure BUT053 (BPrelationship: business shareholding), which can be analyzed forregulatory reporting purposes:

• Capital investment as a percentage


• Amount of capital investment


• Currency key


• Indicator: Shareholder controls the firm/company

There are several relationship categories that contain only the listedshareholding data. Possible business partner relationships withshareholding data are, for example, business partner relationshipsbelonging to the relationship category BURC01 (shareholderrelationship), FS0030 (borrower entity member), or user-definedrelationship categories.
For user-defined relationships that contain this shareholding data inparticular, the method offers the advantage that you do not need todefine a separate method for each individual relationship category. Theyenable you to use the global method for several relationship categoriesinstead.

Notes
A preprocessing run takes place before the data is read:


• A check is performed to determine whether the business partners are
available for processing.

• A check is performed to determine whether the business partner
relationship is available for processing.

• A check is performed to determine whether a relationship category with
shareholding data is available.
For further information about the relationship category check, see thedocumentation in the parameter Business Partner RelationshipCategory.

Return messages
Messages are returned in the Return parameter. You can find thereturn values and their meaning in the parameter documentation.

Description
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

Description
This parameter is a required (mandatory) parameter.
You can find information about the meaning of the parameter in thecorresponding documentation for the data element:Business Partner Number.

Value range
The value range for the parameter corresponds to the value range for thedomain of the data element.

Description
This parameter contains the validity date (valid from).
The validity date (valid from) indicates the start of thebusiness partner relationship with shareholding data as an identifyingcharacteristic.
You have to enter a value in this field if you want to delete thebusiness partner with shareholding data.

Default


• SY-DATLO (technical date)

Description
This parameter contains the validity date (valid to).
The validity date (valid to) indicates the end of the businesspartner relationship with shareholding data as an identifyingcharacteristic.
You have to enter a value in this field if you want to delete thebusiness partner with shareholding data.

Default


• 31.12.9999

Description
In this parameter you can state that the customer enhancements are to beexecuted for the Business Application Programming Interfaces (BAPIs).
If this indicator is not set, then the system ignores the customerenhancements.

Value range
'X' Execute customer enhancements
' ' Do not execute customer enhancements

Default
' ' Do not execute customer enhancements

Description
This parameter is a required (mandatory) parameter.
You can find information about the meaning of the parameter in thecorresponding documentation for the data element:Business Partner Relationship Category.

Value range
You can find the value range for this parameter in the Business DataToolset for the SAP Business Partner for Financial Servicesunder Business Partner Relationships-> Control-> RelationshipCategories.
The relationship category to be entered has to be a relationshipcategory that contains exactly those attributes that have been definedas shareholding data for the structure BUT053 (BP relationship:business shareholding). These are relationship categories that havethe relevant application BURC (BP relationship: businessshareholding) and both of the following views BURC01(Shareholding: percent, amount of capital investment) and BURC02Shareholding: control indicator) assigned to them.

Description
This parameter is a required (mandatory) parameter.
You can find information about the meaning of the parameter in thecorresponding documentation for the data element:Business Partner Number.
This business partner number is the number for the business partner thathas the shareholding that is, for example, the number of the shareholderor the head of the borrower entity.

Value range
The value range for the parameter corresponds to the value range for thedomain of the data element.

Description
You can find information on the meaning of the parameter in thecorresponding documentation for the Structure forBAPI-Parameter ExtensionIn / ExtensionOut.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.
This parameter serves as a data container. In the parameter you cantransfer additional data to the method that was not considered at theinterface.
The data is transferred in a table. The format for the individual datarecords for this table is determined by the structure BAPIPAREX. Thiscontains several data record fields (VALUEPART1, VALUEPART2, ..) as wellas a field for the name of an internal structure created by the customer(STRUCTURE). As the data for each data record is written piecewise, oneafter the other, in the available data record fields, an internalstructure is required in order to interpret the data.
In the event that a customer wants to add additional fields to an SAPdatabase table, BAPI table extensions are particularly well suited asinternal structures.
You will find more detailed information on the various customerenhancement options, and the internal structures to be used in eachcase, in the document "Customer Enhancement and Modification ofBAPIs" in the SAP Library under Enhancements,Modifications...(CA-BFA).
The data for the parameter is transferred to the methodTransferExtensionOut of the Business Add-Ins (BAdIs) for this method.

Description
This table contains the return messages from the method call.