LAW Interface

Use

The LAW data is available to you through the LAW interface for additional, automated processing, such as additional internal allocation of the licenses.

The LAW interface is a collection of function modules with which you can access the information stored in the LAW with read accesses.

Seven objects and the corresponding BAPIs have been defined for this read-only access. The BAPIs return either one or more tables or an XML document as a result.

Object	Additional Notes	Function Module
LAWUser	Users in the LAW. The object contains all relevant data for an SAP user in the LAW.	BAPI_LAWUSER_GETLIST
LAWSystem	Systems in the LAW. The object contains all relevant data for an SAP system in the LAW.	BAPI_LAWSYSTEM_GETLIST
LAWEngine	Engines in the LAW. The object contains all relevant data for an engine in the LAW.	BAPI_LAWENGINE_GETLIST
LAWUserType	User types in the LAW. The object contains all relevant data for an SAP user type (license type) in the LAW.	BAPI_LAWUTYPE_GETLIST
LAWConsUser	Consolidated users in the LAW. The object contains all relevant data for a consolidated SAP user in the LAW.	BAPI_LAWCONSUSR_GETLIST
LAWConsEngine	Consolidated engines in the LAW. The object contains all relevant data for a consolidated engine in the LAW.	BAPI_LAWCONSENG_GETLIST
LAWConsUserType	Consolidated user types in the LAW. The object contains all relevant data for a consolidated SAP user type in the LAW. User types with their special versions and surcharges are, if possible, consolidated to a common user type.	BAPI_LAWCONSUSR_GETLIST

All BAPIs have similar IMPORTING and EXPORTING interfaces. The following parameters exist for all modules.

Interface	Parameter	Additional Notes
IMPORTING	MAX_ROWS	Maximum number of rows in the set of hits. You can use this parameter to determine the maximum number of rows of the set of hits. In this way, you can limit the size of the relevant results table or of the result document.
	PRETTY_PRINT	Formatting of an XML document in accordance with the document structure.
	SELECTION_RANGE	Table with selection parameters This is an extended RANGE table. The name of a field from the relevant BAPI object is entered in the PARAMETER field, if selections are to be made using this attribute. All other fields are the usual fields for RANGE tables. With a small number of exceptions, all fields of the relevant object can be used for making selections. This table offers a very flexible option for specifying selection conditions. For information about which fields can be used for selection, see the documentation for the individual function modules. If a field is not permitted for selection and is used anyway, an error message is generated. The first three BAPIs, which allow access to the data that has not yet been consolidated, have fields for identifying a component system, either using the unique SYSTEM_NO (system number), or, if this does not yet exit, using the three fields INST_NO (installation number), SAP_SYSTEM (System ID), and HW_KEY (Hardware key). Exception: BAPI_LAW_CONSUTY_GETLIST does not know this table.
EXPORTING	ROWS	Number of selected rows. This parameter provides you with an overview of the result set to be expected.
	SIZE	Size of the XML document generated. If an XML document is requested as a result, this parameter contains the size of the document generated. In come cases, this size is required for the additional processing of the document.
	RETURN	Returns the usual table of (error) messages for BAPIs.
	USERLIST, USERLIST_XML	Results table or XML document for the BAPI LAWUSER.
	ENGINELIST, ENGINELIST_XML	Results table or XML document for the BAPI LAWENGINE.
	USERTYPELIST, USERTYPELIST_XML	Results table or XML document for the BAPI LAWUTYPE.
	CONSUSERLIST, CONSUSERLIST_XML	Results table or XML document for the BAPI LAWCONSUSER.
	CONSENGINELIST, CONSENGINELIST_XML	Results table or XML document for the BAPI LAWCONSENG.
	CONSUTYPELIST, CONSUTYPELIST_XML	Results table or XML document for the BAPI LAWCONSUTY.
	SYSTEMLIST, CLIENTLIST, COMPONENTLIST, RESULTLIST_XML	Results table or XML document for the BAPI LAWSYSTEM.

For more information, refer to the documentation for the function modules in the BAPI Explorer (transaction BAPI), on the Hierarchy tab page under Start of the navigation path Basis Next navigation step Security End of the navigation path .