Ansicht
Dokumentation

BAPI_XMI_LOGON - Log onto an external management tool

ABAP Short Reference   rdisp/max_wprun_time - Maximum work process run time  
This documentation is copyright by SAP AG.

Functionality

Using this method you can log onto one of the SAP CCMS system administration interfaces. This logon is a prerequisite for using the CCMS interface functions.

Logging onto the interface ensures that all accesses to the system administration functions are logged. Using the CCMS XMI session interface, you can also upload language-specific messages from external products.

You can also log onto the XMI interface without having to open a session with other CCMS system administration interfaces.

Background information: XMI sessions

External system administration tools can process their tasks using one or more CCMS interfaces. For this reason, the external tool sets up an RFC connection with the SAP system. Within this RFC connection, the tool must connect separately to each individual interface with which it is to work.

The RFC connection is responsible for authenticating and authorizing the SAP system, since a "normal" SAP logon process runs here. For the duration of the RFC connection, the external tool is therefore logged onto the SAP system as a user. During this time, the external program can connect with one or more interfaces, or break the connection. These system management API connections can be arranged in any order and may also overlap. This means that for the duration of an RFC connection there are multiple SMAPI connections.

The XMI controls these SMAPI connections and their lifespan. The tool authenticates itself with each interface again and receives an identification code in return. These session IDs are always the same for the duration of an RFC connection.

So that external tools do not have to know in advance which interfaces are implemented in a concrete SAP version in which API version, the XMI contains functions that inform you of the SAP version. The XMI is therefore the central contact for querying the current version and the available interfaces.

There is the special case that an XMI session is not opened for an API but is used exclusively to execute XMI functions. You can use this not only to query the version of an API but also to load the language-specific messages.

During a session, each interface contains global variables that characterize the status of the SMAPI connection between a tool and an interface. If multiple external tools log onto a CCMS interface, then status information is created for each interface "incarnation" (even for different RFC connections).

Example

Notes

Before you call this function module for the first time, the external management system must first log onto the SAP system with an SAP user name and password (C function RfcOpen).

Further information

XMI documentation (SAPnet/CCMS).

Parameters

EXTCOMPANY
EXTPRODUCT
INTERFACE
RETURN
SESSIONID
VERSION

Exceptions

Function Group

SXMI

Fill RESBD Structure from EBP Component Structure   General Data in Customer Master  
This documentation is copyright by SAP AG.

Length: 3614 Date: 20240523 Time: 163425     sap01-206 ( 90 ms )