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.

HTML/XML

<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 sind true oder false.

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.

HTML/XML

<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: