Ereignisse aus externen Programmen auslösen (SAP-Bibliothek - Basis-Programmierschnittstellen (BC-DWB))

Ereignisse aus externen Programmen auslösen

Möchten Sie ein Ereignis aus einem externen Programm auslösen, verwenden Sie das R/3-Programm SAPEVT.

SAPEVT hat folgende Syntax:

sapevt <EVENTID> [-p <EVENTPARM>] [-t]
pf=<Profilname>|name=<R/3-Systemname> nr=<R/3-Systemnummer>

sapevt END_OF_FI_DATATRANS name=C11 nr=11 löst das Ereignis END_OF_FI_DATATRANS ohne einen Parameter im R/3-System C11, Instanzennummer 11 aus. Alle auf dieses Ereignis wartenden Jobs werden gestartet.

Für SAPEVT gibt es folgende Parameter:

< EVENTID> : Der Name des Ereignisses, wie im R/3-System mit Transaktion SM62 angegeben.

-p <EVENTPARM> : Ein optionales Argument für EVENTID , das das Ereignis spezifiziert. EVENTPARM ist nicht im R/3-System definiert.

-t : Bewirkt, daß SAPEVT seine Aktionen in einer kleinen Trace-Datei aufzeichnet. Sie finden die Trace-Datei im aktuellen Verzeichnis des Benutzers, der SAPEVT aufgerufen hat.

pf=<Profilname> oder name=<R/3-Systemname> nr=<R/3-Systemnummer> : Entweder pf oder name und nr identifizieren das R/3-System, in dem das Ereignis ausgelöst werden soll.

Mindestens eine Instanz des R/3-Systems muß aktiv sein, wenn SAPEVT läuft. Ansonsten erfährt das System nicht, daß das Ereignis eingetreten ist. Die Instanz muß die im SAPEVT-Aufruf angegebene Nummer haben.

Sie können das R/3-System mit den folgenden Parametern identifizieren:

pf <Profilname> : Geben Sie den Namen des Profils ein, mit dem die Instanzen der Hintergrundsteuerung gestartet werden. SAPEVT identifiziert das R/3-System anhand der Angaben im Profil.

R/3-Systemprofile finden Sie im globalen R/3-Verzeichnis SYS\profile (Windows NT) oder SYS/profile (UNIX).

name=<R/3-Systemname> nr=<R/3-Systemnummer> : der Name des R/3-Systems (SID) und die R/3-Systemnummer.

Voraussetzungen für SAPEVT

Die folgenden Bedingungen müssen erfüllt sein, damit ein Ereignis mit SAPEVT ausgelöst werden kann:

Eine R/3-Instanz, die Hintergrundverarbeitung anbietet, muß aktiv sein, da der Start von Jobs, die auf das Ereignis warten, ansonsten verzögert wird.

Löst ein externes Programm ein Ereignis aus und ist in einem R/3-System keine Instanz aktiv, wird das Ereignis ignoriert. Das R/3-System kann nicht wissen, daß das Ereignis ausgelöst wurde.

Kann ein Job, der zu einem bestimmten Ereignis eingeplant wurde, nicht sofort gestartet werden, wird er als Sofort-Start-Job neu eingeplant und dann bei der nächsten Gelegenheit ausgeführt.

Wenn SAPEVT mit einem Profilnamen als Argument gestartet wird, muß das Programm auf das allgemeine Verzeichnis profile des R/3-Systems zugreifen können. SAPEVT muß das Profil des Systems lesen, an das er das Ereignis sendet.

Ist der Zugriff auf das Verzeichnis nicht möglich, können Sie ein lokales Profil für SAPEVT anlegen. Dieses Profil braucht nur Werte für die Parameter rdisp/mshost und rdisp/msserv zu enthalten. Nehmen Sie die Werte aus den Profilen des Ziel-R/3-Systems. Geben Sie das lokale Profil in der SAPEVT-Befehlszeile an.

Netzwerkverbindung: SAPEVT muß eine TCP-Verbindung zur R/3-Instanz aufbauen können.

SAPEVT zeichnet Probleme beim Verbindungsaufbau zum R/3-System in der Protokolldatei auf.

Benutzersuchpfad: Die R/3-Executables (ausführbare Dateien) und Profilverzeichnisse müssen im Suchpfad des Benutzers liegen, der das SAPEVT aufrufende Programm startet.

UNIX: /usr/sap/<R/3-Systemname>/SYS/exe/run und SYS/profile

Windows NT: \\<Hostname>\sapmnt\<R/3-Systemname>\SYS\exe\run und SYS\profile