SAP-Schnittstellen

Die Agenten kommunizieren mit dem SAP-System über den SAP Java Connector, der auf RFC (Remote Function Call) basiert. In diesem Prozess werden SAP-Funktionsbausteine aufgerufen.

Der Agent verwendet folgende SAP-Standardschnittstellen:

  • BC-XMB (eXternal Monitoring Basics)
  • BC-XAL (eXternal ALerting)
  • BC-XBP (eXternal Batch Processing) *)
  • BC-XMW (eXternal Monitoring Write)
  • BW-STA (Business Warehouse – Data STAging)
  • SM-SE (Solution Manager Scheduling Enabler)
  • JXBP (eXternal Batch Processing für Java-Jobs)

*) Die Schnittstellenfähigkeiten sind abhängig von der Version, die mit dem SAP-ABAP-Programm INITXBP2 konfiguriert werden kann. Beispielsweise ist die Nutzung der Job-Interception und der Parent/Child-Beziehung von XBP 2.0 abhängig.

Hinweise:

  • Um alle SAP-Funktionen nutzen zu können, benötigen Sie XBP 3.0.

  • Alle Schnittstellen (außer BW-STA und JXBP) sind Teil der SAP ABAP-Stack-Komponenten SAP_BASIS und SAP_ABA. Daher unterstützt die Automation Engine ALLE SAP-Lösungen, die diese Komponenten benötigen. Dies sind z. B. alle SAP NetWeaver-Versionen, SAP ERP, SAP CRM usw.

  • Die Version der Schnittstelle BC-XBP ist für die Kernel-Version nicht relevant. SAP stellt die Kompatibilität sicher, indem es eine bestimmte Anzahl neuer Kernel-Versionen unterstützt, die auch nach der Veröffentlichung einer neuen Schnittstellenversion die alte Schnittstelle weiterhin unterstützen.

  • Die SAP-Standardschnittstellen verfügen über Funktionen, die für fast jeden Anwendungsfall ausreichend sind. Einige Anwendungsfälle können jedoch nicht abgedeckt werden. Beispielsweise ist die BC_XBP-Schnittstelle nicht in der Lage, eine Spool-Liste neu zu drucken, wenn ihr nur die Spool-ID übergeben wird. Deshalb kann der Funktionsumfang der SAP-Standardschnittstellen um SAP-Funktionsbausteine erweitert werden, die von CA Automic (/SBB/ Adressraum) geliefert werden. Die Verwendung dieser Erweiterung muss innerhalb des Verbindungsobjekts konfiguriert werden und erfordert den Import des /SBB/ ABAP-Codes in das entsprechende SAP-System.
    Es wird empfohlen, die CA Automic-Erweiterung nur dann zu aktivieren, wenn sie wirklich benötigt wird.

Folgende Funktionen erfordern die Aktivierung der CA Automic-Erweiterung:

  • R3_GET_APPLICATIONLOG: Lognummern aus dem Anwendungslog abrufen
  • R3_GET_SESSIONS Liste von Sessions aus APQI auswählen
  • R3_CALL_TRANSACTION: Transaktion aufrufen
  • R3_RAISE_EVENT Ereignis mit Zielserver-Spezifikation auslösen
  • R3_GET_JOBLOG Ein Joblog lesen
  • R3_SWITCH_OPMODE: Betriebsmodus ändern
  • R3_CREATE_OUTPUT_REQUEST Eine Ausgabeanfrage in einer Spool-Liste erstellen
  • R3_GET_JOB_SPOOL: Spool-Liste nach Spool-ID lesen
  • R3_GET_SPOOLREQUESTS: Spool-Listen auswählen
  • R3_SEND_SPOOL_REQUEST: Spool-Liste an einen SAP Office-Empfänger senden

Transportieren der CA Automic-Erweiterung

Um die Funktionen der AE-Schnittstelle nutzen zu können, müssen Funktionsbausteine in das SAP-System transportiert werden.

Funktionsbausteine werden als ABAP-Entwicklungsobjekte entwickelt. Diese Komponenten werden mit dem Paket "Correction & Transport System" des SAP-Systems ausgeliefert:

  • KNNNNNN.SID: Informationsdatei, z. B. K000043.EC2
  • RNNNNNN.SID: Datendatei, z. B. R000043.EC2
  • ENNNNNN.txt: Exportprotokoll, z. B. E000043.txt

Namensbereiche werden zusammen mit Funktionsbausteinen in separaten Transportaufträgen transportiert. Eine Liste aller aktuell gültigen Transportaufträge finden Sie in der Datei "TRANSPRT.TXT". Alle Transporte müssen bei einer Neuinstallation durchgeführt werden. Bei einer Aktualisierungsinstallation sind es nur die Funktionsbausteine (AE-Schnittstelle), da keine Änderung der Namensbereiche erfolgt.

Hinweis: In diesem Dokument werden die folgenden Codes verwendet:

  • NNNNNNNN für die Transportauftragsnummer des Liefersystems und
  • SID für die Systemnamen des Liefersystems.

Dateinamen

SAP kann in verschiedenen Umgebungen (UNIX, Windows usw.) installiert werden. Daher ist es wichtig, die spezifischen Eigenschaften des Systems zu berücksichtigen, wenn Sie die Dateien benennen.

Hinweis: In diesem Dokument sind die Dateinamen, die sich auf eine SAP-Umgebung beziehen, in UNIX-Sprache ("/") geschrieben. In Windows-Umgebungen sind die Namen identisch, mit der Ausnahme, dass sie ein "\"-Zeichen verwenden.

Importieren von Funktionsbausteinen in SAP

Bei Nutzung der Funktionen der AE-Schnittstelle müssen Funktionsbausteine in das SAP-System transportiert werden.

Voraussetzungen

Das Transportsystem muss ordnungsgemäß installiert und eingestellt werden. Dies geschieht während der Installation des SAP-Systems.

Ablauf

Importieren Sie die ausgelieferten Transportdateien in die SAP-Transportumgebung:

  1. Wechseln Sie auf dem SAP-Rechner in das entsprechende Unterverzeichnis (für die SAP-Version) in "IMAGE:Agents\sap\sap\_trans".
  2. Kopieren Sie die Dateien von dort in das folgende Verzeichnis:

    3. KNNNNNN.SID in "/usr/sap/trans/cofiles"

    RNNNNNN.SID in "/usr/sap/trans/data"

Importieren Sie die Lieferung in das SAP-System:

  1. Melden Sie sich mit einem SAP-Administratorbenutzer über die SAP-GUI bei Mandant 000 an.
  2. Gehen Sie zu Transaktion stms und öffnen Sie die Importübersicht.
  3. Öffnen Sie die Queue für das SAP-System.
  4. Wählen Sie "Extras" > "Other Requests" > "Add" aus.
  5. Geben Sie den Namen der Transportanforderung ein und klicken Sie auf "OK".
  6. Wählen Sie "Import Request" und wechseln Sie zur Registerkarte "Options".
  7. Wählen Sie "Ignore Invalid Component Version" und starten Sie den Import. Der Rückgabewert RC sollte nicht höher als 4 sein (Warnungen aufgetreten).

Testen der Erweiterung mit ABAP Workbench

Die Erweiterung kann in der Regel über die SAP-GUI mithilfe der Transaktion SE37 und der Funktionen "/SBB/UC4_JOB_READ_LOG" oder "/SBB/UC4_EVENT_RAISE" getestet werden. Dazu ist ein SAP-Administrator erforderlich, der ABAP Workbench versteht und über Entwicklungsberechtigungen innerhalb von SAP verfügt.