Funktionsunterschiede

Schnittstellen

AE-Schnittstelle testen

---

Transport der Automation Engine-Schnittstelle

Allgemein

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

Die Funktionsbausteine werden als ABAP-Entwicklungsobjekte entwickelt. Diese werden im Rahmen des "Korrektur- & Transportwesens" des SAP-Systems geliefert:

• KNNNNNN.SID Informationsfile, beispielsweise K000046.T45
• RNNNNNN.SID Datenfile, beispielsweise R000046.T45
• ENNNNNN.txt Exportprotokoll, beispielsweise E000046.txt

Neben den Funktionsbausteinen werden auch Namensräume transportiert. Dieser Transport erfolgt in eigenen Aufträgen. Eine Aufstellung der aktuell gültigen Transportaufträge finden Sie in der Datei TRANSPRT.TXT. Bei einer Neu-Installation sind alle Transportaufträge durchzuführen. Bei einer Update-Installation sind es nur die Funktionsbausteine (AE-Schnittstelle), da sich die Namensräume nicht ändern.

Die Namen der Entwicklungsobjekte sind in der Terminologie beschrieben.

In diesem Dokument werden dafür folgende Kürzel verwendet:

• NNNNNN für die Transportauftragsnummer des Ausliefersystems und
• SID für den Systemnamen des Ausliefersystems.
• TID wird für den Systemnamen des Zielsystems (in welchem die Funktionsbausteine importiert werden) verwendet.

Dateinamen

Da das SAP-System in verschiedenen Umgebungen (UNIX, Windows...) installiert werden kann, sind bei den Dateinamen die systemspezifischen Besonderheiten zu berücksichtigen.

In diesem Dokument schreiben wir Dateinamen, welche die SAP Umgebung betreffen, generell in der UNIX-Schreibweise (also mit "/"). In der Windows-Umgebung sind die Namen gleich, nur ist in diesem Fall "\" zu verwenden.

Importieren der Funktionsbausteine in SAP

Soll die Funktionalität der AE-Schnittstelle genutzt werden, so müssen Funktionsbausteine in das SAP-System transportiert werden.

Voraussetzungen:

Sämtliche Aktivitäten mit dem Transportsystem müssen unbedingt mit dem SAP-Adminstrationsbenutzer ausgeführt werden (SIDadm).

Das Transportsystem muss ordnungsgemäß eingerichtet und parametriert sein. Üblicherweise erfolgt dies im Zuge der Installation des SAP-Systems.

Für den Import müssen in dieser SAP-Instanz mindestens 2 Batch-Workprozesse (BTC) laufen.
Kontrolle: Werkzeuge - Administration - Monitor - Systemüberwachung - Prozessübersicht (Transaktion SM50).

Für den Import von Entwicklungsobjekten muss der Transportdämon im SAP-System (Hintergrundjob "RDDIMPDP") im Mandant 000 eingeplant und freigegeben sein. Kontrolle: siehe unten

Die Funktionalität kann wie folgt überprüft werden:
cd usr/sap/trans/bin........  Wechsel ins SAP-Transportverzeichnis
tp checkimpdp TID........... Prüfen, ob Transportdämon RDDIMDP im SAP aktiv ist
tp connect TID.............. Verbindung zum SAP-System testen

Das Transportsystem ist in der SAP-Onlinedoku im Kapitel BASIS - TRANSPORTSTEUERUNG beschrieben.

Beachten Sie, dass beim Import die Option "Nicht passende Komponentenversion ignorieren" zu setzen ist.

Ablauf:

Importieren Sie die gelieferten Transportdateien in die SAP-Transportumgebung:

• Auf dem SAP-Rechner:
• Wechseln in das zur SAP-Version passende Unterverzeichnis von IMAGE:AGENTS\SAP\_TRANS.
• Kopieren der Dateien von dort in folgende Verzeichnisse:

  KNNNNNN.SID by /usr/sap/trans/cofiles
  RNNNNNN.SID by /usr/sap/trans/data

Wenn SAP unter UNIX installiert ist, wird die Übertragung der Dateien üblicherweise mit FTP erfolgen. Geben Sie dabei unbedingt "bin" für binäre Übertragung an.

• Die Datei ENNNNNN.TXT auf der CD enthält das komplette Exportprotokoll und dient einer eventuellen Analyse.

Importieren der Lieferung ins SAP-System:

• Auf dem SAP-Rechner (Anmeldung mit dem SAP-Adminstrationsbenutzer (SIDadm)).
•  Die übernommenen Transportdateien (RNNNNNN.SID und KNNNNNN.SID) dürfen nicht schreibgeschützt sein (Achtung beim Kopieren der CD)!
• Auf Wunsch kann ein Verzeichnis der im Transportauftrag enthaltenen Objekte erstellt werden:

  cd usr/sap/trans/data....... Wechsel ins SAP-Transportverzeichnis
  r3trans -l RNNNNNN.SID...... erstellt eine Datei trans.log (Liste transportierte objekte).

• Erzeugen eines Buffereintrages für das Zielsystem.

  cd usr/sap/trans/bin........ Wechsel ins SAP-Transportverzeichnis
  tp addtobuffer SIDkNNNNNN TID [pf=<Profilname, Standard TPPARAM>

• Auf Wunsch kann der Buffereintrag geprüft werden:

  tp showbuffer TID [pf=<Profilname, Default TPPARAM>]

• Vor dem Import ist zu entscheiden, mit welchen Unconditional Modi (u) der Import erfolgen soll:
• 4....gilt nur für SAP-Release 3.x: vereinbart, dass der beim Export angegebene Zielsystemname nicht mit dem tatsächlichen Zielsystemnamen (TID) übereinstimmt. Da beim Export das tatsächliche Zielsystem in keinem Fall bekannt ist, muss dieser Modus immer angegeben werden!
• 1....ist anzugeben, wenn der Import wiederholt durchgeführt wird.

• Starten des Imports mit dem Kommando:

  tp import SIDkNNNNNNTID u4 [client123] [pf=<Profilname, Default TPPARAM>] bzw.
  tp import SIDkNNNNNNTID u14 [client123] [pf=<Profilname, Default TPPARAM>]

  Die Unconditional Modi sind je nach TP-Version unterschiedlich und eventuell in der SAP-Dokumentation nachzulesen.

•  Beachten Sie beim Import:
• Für Importe müssen mindestens 2 Batch-Tasks in der Instanz laufen!
• Obwohl im Transportauftrag keine mandantenspezifischen Daten enthalten sind, kann es vorkommen, dass beim Import ein Mandant verlangt wird. In diesem Fall ist mit dem Parameter client=nnn ein in Ihrer Umgebung gültiger Mandant anzugeben (der Export erfolgte mit Mandant 010).
• Der Import kann einige Minuten dauern, insbesondere dann, wenn der Transportdämon RDDIMPDP nicht event-getriggert, sondern zeitgesteuert eingeplant ist.
• Meldung "no profile used ":

  Bei internem Programmaufruf an "sapevt" wird kein Profil angegeben. Deshalb tritt diese Meldung bei jedem Aufruf von sapevt auf. Sie ist im Normalfall unbedenklich!

• Es können auch andere Meldungen auftreten, entscheidend ist aber der Rückgabewert (siehe unten - Kontrolle).

Kontrolle:

• Wegen der Komplexität des SAP-Transportsystems und der SAP-Umgebung kann eine umfassende Fehlerdiagnose und Beseitigung nur durch den Fachmann, welcher seine Installationsumgebung kennt, durchgeführt werden.
• Anhand folgender Ratschläge sollte auch für einen Nicht-Fachmann eine grundsätzliche Beurteilung, ob der Import gut ging, möglich sein:
• Beim Import werden Logging-Files erzeugt.
• Diese stehen im Verzeichnis /usr/sap/trans/log und heissen SIDsNNNNNN.TID
• Dabei bedeutet s Transportstep:

  G... Report und Screen-Generierung
  H... R3TRANS import Dictionary
  I... R3TRANS main import

• In diesen 3 Logdateien ist der exit code (=Rückgabewert) zu kontrollieren (er wird immer am Ende des Files ausgegeben). Er darf nicht größer als "4" sein!

• Für den Fachmann ist die Kontrolle dieser Log-Files im SAP System-System natürlich ebenfalls möglich.