JCo 3 Listener-Konfiguration
Auf dieser Seite erfahren Sie, wie Sie eingehenden JCo 3-Verbindungen Properties und Methoden zuweisen.
Die Konfiguration eingehender JCo 3-Verbindungen von einem oder mehreren SAP-Systemen befindet sich in Datei saplistener.xml
in <X4>\X4DB\0
. Dort lässt sich pro SAP-System ein JCo 3-Listener definieren, der wiederum Server-Properties und Methodendefinitionen (in einem spezifischen XML-Dokument) referenziert.
XML-Struktur
Zur Beschreibung der Struktur von saplistener.xml
ist zudem ein XML-Schema-Definition saplistener.xsd
im selben Ordner verfügbar. Diese XSD ist im Wurzel-Element <listeners>
der Listener-Konfiguration angegeben.
<listener>
<serverPropertiesURL>Pfad zur Properties-Datei</serverPropertiesURL>
<methodDefinitionsURL>Pfad zur Methodendefinition</methodDefinitionsURL>
<replaceEscapedControlChars>false</replaceEscapedControlChars><!-- true | false -->
</listener>
Jedes Element <listener>
mit einer JCo 3-Listener enthält folgende Kindelemente:
<serverPropertiesURL>
: Gültige URL zu einer Properties-Textdatei, die sämtliche Verbindungseinstellungen zum SAP-Host enthält<methodDefinitionsURL>
: Gültige URL zu einem XML-Dokument, in dem sämtliche Methodendefinitionen bzw. Funktionsbausteinaufrufe und Transaktions-Handling-Prozesse definiert sind; siehe Funktionsbaustein-/Methodendefinitionen<replaceEscapedControlChars>
: Maskierte Steuerzeichen (z.B.:
) in den von der JCo-Bibliothek zurückgegebenen XML-Strings durch das Ersetzungszeichen austauschen:
Mögliche Werte sindtrue
oderfalse.
Beispiel
Im folgenden Beispiel werden zur Anbindung von zwei SAP-Hosts jeweils ein Listener mit den separaten Properties- und Methodendefinitionen bestimmt. Mit replaceEscapedControlChars true
werden zudem in den von der JCo-Bibliothek zurückgegebenen XML-Strings alle maskierten Steuerzeichen (z.B.: 
) durch das Ersetzungszeichen ausgetauscht.
<listeners xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="saplistener.xsd">
<listener>
<serverPropertiesURL>file:///C:/X4/X4DB/0/host1.prop</serverPropertiesURL>
<methodDefinitionsURL>file:///C:/X4/X4DB/0/host1_method_def.xml
</methodDefinitionsURL>
<replaceEscapedControlChars>true</replaceEscapedControlChars>
</listener>
<listener>
<serverPropertiesURL>file:///C:/X4/X4DB/0/host2.prop</serverPropertiesURL>
<methodDefinitionsURL>file:///C:/X4/X4DB/0/host2_method_def.xml
</methodDefinitionsURL>
<replaceEscapedControlChars>true</replaceEscapedControlChars>
</listener>
</listeners>
Weitere Informationen: