SAP Function BAPI_LAWENGINE_GETLIST - License Administration Workbench: Select Engines

Parameter Reference Type Length Default Optional Text
MAX_ROWS BAPILAWMISC-BAPIMAXROW I 4 0 X Maximum Number of Lines of Hits
PRETTY_PRINT BAPILAWMISC-BAPILAWPTPRINT C 1 ' ' X Formatting of an XML Document (Line Breaks)
WITH_TEXT BAPILAWMISC-BAPILAWTXFL C 1 ' ' X Add Texts to Engines

Parameter Reference Type Length Text
ROWS BAPILAWMISC-BAPIROWS I 4 Number of Selected Engines
SIZE BAPILAWMISC-BAPILAWXMLSIZE I 4 Size of an XML Document

Parameter Reference Length Optional Text
ENGINELIST BAPILAWENGINE 167 X BAPI Structure: Measurement Data About an Engine
ENGINELIST_XML BAPILAWXMLDOC 128 X License Administration Workbench: Structure for Output as XML Document
RETURN BAPIRET2 548 X Return Parameter
SELECTION_RANGE BAPILAWRGE_ENG 123 X BAPI Structure for Selection with the Range Table

Functionality
This BAPI allows the selection of engine data that has been stored bythe License Audit Workbench (LAW). The selected engine data istransferred using the EngineList table. The selection itself is madeusing the Selection_Range table. It is possible to select bysystems, engines, and units. The result can be created as a tablewith the structure EngineList or as an XMLdocument.

Example
Report RSLAW_TEST_BAPI

Description
Returns the number of selected engines.

Description
If an XML document was requested, this field contains the size of thisdocument.

Description
You can use this parameter to determine the maximum number of rows inthe set of hits. In this way, you can limit the size of the resulttable EngineList.

Value range
0 - 2 **32 -1

Default
0 , No limit

Description
Formatting of the XML document in accordance with the documentstructure. Very helpful in test cases.

Description
You can use this parameter to request the extension of the output listto include the texts for the engines and the units.

Value range
' ',,Output without text
'X',,Output with text

Default
' ',,Output without text

Description
Table containing the result of the selection. If you have restrictedthe number of rows, the result set may have been prematurely closed.

Description
Table containing the result of the selection in the form of an XMLdocument. If you have restricted the number of rows, the result setmay have been prematurely closed.

Description
Standard BAPI return table. Contains all error messages thatoccurred during processing.

Value range
The following error messages are possible:

  • You are not authorized to display LAW data

  • Selection criterion does not contain any parameters

  • Selection criterion <(>&<)>1-&2 is not supported

  • There is no conversion for database field &1

  • Internal error: The BAPI structure &1 does not exist

  • Internal error at &1, &2

    • Description
    Table containing the selection parameters. This is an extended RANGEtable. The name of a field from the structure BAPILAWENGINE is enteredin the PARAMETER field, if this attribute is to be used for theselection. All other fields are the usual fields for RANGE tables.The following fields can be used for selection:

    • SYSTEM_NO

    • INST_NO

    • SAP_SYSTEM

    • HW_KEY

    • CLIENT

    • APPLICATION

    • UNIT

      • Anmerkung: bei Systemen, denen noch keine eindeutige Systemnummer(SYSTEM_NO) zugeordnet wurde, wird ein System durch die drei FelderINST_NO, SAP_SYSTEM, HW_KEY identifiziert.