Aktivierungsspezifikationseigenschaften für die Verarbeitung eingehender gültiger Zugriffslisteneinträge

Die Eigenschaften der Aktivierungsspezifikation enthalten die Verarbeitung eingehender Ereignisse von Konfigurationsdaten für einen Nachrichtenendpunkt. Mit dem Adapterverbindungsassistent können Sie Aktivierungsspezifikationseigenschaften festlegen.

Aktivierungsspezifikationseigenschaften werden während der Endpunktaktivierung verwendet, um den Adapter über in Frage kommende Ereignislistener zu benachrichtigen. Während der Verarbeitung eingehender Ereignisse verwendet der Adapter diese Ereignislistener, um Ereignisse zu empfangen, bevor er sie zum Endpunkt weiterleitet.

In der folgenden Tabelle werden die Aktivierungsspezifikationseigenschaften für die Verarbeitung eingehender gültiger Zugriffslisteneinträge (ALE) erläutert. Eine detailliertere Beschreibung von jeder Eigenschaft finden Sie in den Abschnitten nach der Tabelle.

Tabelle 1. Aktivierungsspezifikationseigenschaften für die Verarbeitung eingehender gültiger Zugriffslisteneinträge
Eigenschaftenname Beispiel
Fehlercode Der Statuscode für den Zustellungsfehler.
Fehlertext Der beschreibende Text für den Zustellungsfehler.
Selektive Aktualisierung Die IDocType- und MessageType-Kombinationen, die aktualisiert werden sollen, wenn der Adapter für die Aktualisierung eines standardmäßigen SAP-Statuscodes konfiguriert ist.
Statusnachrichtencode Falls erforderlich, ist dies Nachrichtencode, der verwendet werden soll, wenn der Adapter ALEAUD Message IDoc (ALEAUD01) sendet.
Erfolgscode Der Erfolgsstatuscode für 'Application Document Posted'.
Erfolgstext Der beschreibende Text für erfolgreiches 'Application Document Posted'.
ALE-Aktualisierungsstatus Gibt an, ob ein Prüfprotokoll für alle Nachrichtentypen erforderlich ist.

Gesicherte einmalige Zustellung

Gibt an, ob die gesicherte einmalige Zustellung für eingehende Ereignisse bereitgestellt werden soll.

Automatische Erstellung einer Ereignistabelle Gibt an, ob der Adapter die Ereigniswiederherstellungstabelle automatisch erstellen soll, wenn sie noch nicht vorhanden ist.

Client

Die Clientnummer des SAP-Systems, zu dem der Adapter eine Verbindung herstellt.

Codepage-Nummer

Zeigt die numerische ID der Codepage an.

Datenbankschemaname Das Schema, das für die automatische Erstellung der Ereigniswiederherstellungstabelle verwendet wird.

Sichere Netzverbindung aktivieren

Gibt an, ob der Modus für eine sichere Netzverbindung verwendet wird.

Ereigniswiederherstellungsdatenquellenname (JNDI) Der JNDI-Name der Datenquelle, die für die Ereigniserkennung konfiguriert wurde.
Ereigniswiederherstellungstabellenname Der Name der Ereigniswiederherstellungstabelle.

Ordner für RFC-Tracedateien

Legt den vollständig qualifizierten, lokalen Pfad des Ordners fest, in den die RFC-Tracedateien geschrieben werden.

Gateway-Host

Der Hostname des SAP-Gateways.

Gateway-Service

Der Bezeichner des Gateways beim Gateway-Host, der die RFC-Services durchführt.

Hostname

Gibt die IP-Adresse oder den Namen des Anwendungsserver-Hosts an, auf dem sich der Adapter anmeldet.

Ignorieren von IDoc-Paketfehlern Gibt an, wie der Adapter vorgeht, wenn er beim Verarbeiten des IDoc-Pakets auf einen Fehler stößt.

Sprachencode

Gibt den Sprachencode an, mit dem sich der Adapter bei SAP anmeldet.

Group

Eine ID für den Namen der Gruppe der Anwendungsserverinstanzen, die in Transaktions-SMLG definiert und für Anmeldelastausgleich verknüpft wurden.

retryLimit

Gibt an, wie oft der Adapter versucht, den Ereignislistener neu zu starten.

Nachrichtenserver-Host

Gibt den Namen des Hosts an, auf dem der Nachrichtenserver ausgeführt wird.

Anzahl der Listener

Gibt die Anzahl der Ereignislistener an, die gestartet werden sollen.

Partnerzeichensatz

Gibt die PartnerCharset-Verschlüsselung an.

Kennwort

Das Kennwort des Benutzerkontos des Adapters auf dem SAP-Anwendungsserver.

Kennwort, um Verbindung zur Ereignisdatenquelle herzustellen Das Benutzerkennwort für die Verbindung zur Datenbank.

RFC-Programm-ID

Die RFC-ID, mit der sich der Adapter im SAP-Gateway registriert.

RFC-Trace-Stufe

Gibt die globale Tracestufe an.

RFC-Trace

Gibt an, ob eine Textdatei generiert werden soll, welche Zusatzinformationen zu den RFC-Aktivitäten für jeden Ereignislistener zur Verfügung stellt.

SAP-System-ID

Gibt die System-ID des SAP-Systems an, für das ein Anmeldelastausgleich zulässig ist.

Pfad der Bibliothek für die sichere Netzverbindung

Gibt den Pfad zur Bibliothek an, die den Service für die sichere Netzverbindung bereitstellt.

Name der sicheren Netzverbindung

Gibt den Namen der sicheren Netzverbindung an.

Partner für die sichere Netzverbindung

Gibt den Namen des Partners für die sichere Netzverbindung an.

Sicherheitsstufe für sichere Netzverbindung

Gibt die Sicherheitsstufe für die sichere Netzverbindung an.

Systemnummer

Die Systemnummer des SAP-Anwendungsservers.

retryInterval

Gibt das Zeitintervall zwischen zwei Versuchen zum Neustart des Ereignislisteners an.

Benutzername

Das Benutzerkonto für den Adapter auf dem SAP-Server.

Benutzername, um Verbindung zur Ereignisdatenquelle herzustellen Der Benutzername für die Verbindung zur Datenbank.

X509-Zertifikat

Gibt das X509-Zertifikat an, das als Zugriffsberechtigung für die Anmeldung verwendet werden soll.

Fehlercode (aleFailureCode)

Diese Eigenschaft legt fest, wie der Adapter den SAP-Fehlerstatuscode aktualisiert, nachdem das ALE-Modul ein IDoc-Objekt für die Ereignisverarbeitung abgerufen hat.

Tabelle 2. Details zur Eigenschaft 'ALE-Fehlercode'
Erforderlich Ja, wenn 'AleUpdateStatus' auf True gesetzt wird; ansonsten nicht.
Mögliche Werte

68
58

Standardwert Kein Standardwert.
Eigenschaftentyp Ganzzahl
Verwendung Legen Sie für diese Eigenschaft nur dann einen Wert fest, wenn Sie den Wert für AleUpdateStatus auf True gesetzt haben.

Wenn Sie einen Wert von 68 für diese Eigenschaft angeben, veranlasst dies den Adapter, den SAP-Fehlerstatuscode zu aktualisieren, nachdem das ALE-Modul ein IDoc-Objekt für die Ereignisverarbeitung abgerufen hat. SAP konvertiert diesen Wert in 40 (Anwendungsdokument wird im empfangenden System nicht erstellt).

Wenn Sie die Eigenschaft 'AleUpdateStatus' auf True setzen, aktualisiert der Adapter einen standardmäßigen SAP-Statuscode, nachdem der Adapter ein IDoc-Objekt für die Ereignisverarbeitung abgefragt hat. Ein IDoc, das nicht erfolgreich an den Endpunkt gesendet wird, wird als Fehler angesehen. Mit der ALE-Fehlercode-Eigenschaft wird der Code angegeben, mit dem dieser Fehler bezeichnet wird.

Mehrsprachig Nein
Unterstützt für bidirektionale Sprachen Nein

Fehlertext (aleFailureText)

Die Eigenschaft gibt den Text an, der angezeigt wird, wenn ein IDoc nicht erfolgreich an den Endpunkt gesendet werden konnte.

Tabelle 3. Details zur Eigenschaft 'ALE-Fehlertext'
Erforderlich Ja, wenn 'AleUpdateStatus' auf True gesetzt wird; ansonsten nicht.
Standardwert Kein Standardwert.
Eigenschaftentyp Zeichenfolge
Verwendung Verwenden Sie diese Eigenschaft nur, wenn Sie die Eigenschaft AleUpdateStatus auf True setzen.

Die Länge der Zeichenfolge darf 70 Zeichen nicht überschreiten.

Wenn Sie die Eigenschaft 'AleUpdateStatus' auf True setzen, aktualisiert der Adapter einen standardmäßigen SAP-Statuscode, nachdem der Adapter ein IDoc-Objekt für die Ereignisverarbeitung abgefragt hat. Ein IDoc, das nicht erfolgreich an den Endpunkt gesendet wird, wird als Fehler angesehen. Mit der ALE-Fehlertexteigenschaft wird der beschreibende Text angegeben, mit dem dieser Fehler bezeichnet wird.

Beispiel ALE-Zustellung fehlgeschlagen
Mehrsprachig Ja
Unterstützt für bidirektionale Sprachen Nein

Selektive Aktualisierung (aleSelectiveUpdate)

Diese Eigenschaft gibt an, welche IDocType- und MessageType-Kombinationen aktualisiert werden sollen.

Tabelle 4. Details zur Eigenschaft 'Selektive ALE-Aktualisierung'
Erforderlich Nein
Standardwert Kein Standardwert
Eigenschaftentyp Zeichenfolge
Verwendung Für diese Eigenschaft können nur Werte festgelegt werden, wenn AleUpdateStatus auf True gesetzt wird.

Wenn Sie die Eigenschaft 'AleUpdateStatus' auf True setzen, aktualisiert der Adapter einen standardmäßigen SAP-Statuscode, nachdem der Adapter ein IDoc-Objekt für die Ereignisverarbeitung abgefragt hat. Mit der ALE-selektiven Aktualisierungseigenschaft wird angegeben, welche IDocType- und MessageType-Kombinationen aktualisiert werden sollen.

Die Syntax für diese Eigenschaft lautet folgendermaßen: IDocType: MessageType [;IDocType: MessageType [;...]]. Dabei trennt das Schrägstrich-Begrenzungszeichen (/) jeden 'IDocType' und 'MessageType' und ein Semikolon-Begrenzungszeichen (;) Einträge in einer Gruppe.

Beispiel Im folgenden Beispiel werden zwei Gruppen gezeigt. In dem Beispiel sind MATMAS03 und DEBMAS03 die IDocs und MATMAS und DEBMAS die Nachrichtentypen:

MATMAS03/MATMAS;DEBMAS03/DEBMAS

Mehrsprachig Nein
Unterstützt für bidirektionale Sprachen Nein

Statusnachrichtencode (aleStatusMsgCode)

Diese Eigenschaft gibt den Nachrichtencode an, der verwendet werden soll, wenn der Adapter das IDoc 'ALEAUD01' mit dem Nachrichtentyp 'ALEAUD' sendet.

Tabelle 5. Details zur Eigenschaft 'ALE-Statusnachrichtencode'
Erforderlich Nein
Mögliche Werte Eine Liste verfügbarer Codes erhalten Sie in der SAP-Tabelle TEDS1.
Standardwert Kein Standardwert.
Eigenschaftentyp Zeichenfolge
Verwendung Für diese Eigenschaft kann nur ein Wert festgelegt werden, wenn AleUpdateStatus auf True gesetzt wurde.

Sie müssen diesen Nachrichtencode im empfangenden Partnerprofil bei SAP konfigurieren.

Mehrsprachig Nein
Unterstützt für bidirektionale Sprachen Nein

Erfolgscode (aleSuccessCode)

Diese Eigenschaft gibt den ALE-Erfolgscode für das erfolgreiche Senden eines IDocs an.

Tabelle 6. Details zur Eigenschaft 'ALE-Erfolgscode'
Erforderlich Ja, wenn 'AleUpdateStatus' auf True gesetzt wird; ansonsten nicht.
Mögliche Werte

52
53

Standardwert Kein Standardwert.
Eigenschaftentyp Zeichenfolge
Verwendung Verwenden Sie diese Eigenschaft nur, wenn Sie die Eigenschaft AleUpdateStatus auf True setzen.

Wenn Sie die Eigenschaft 'AleUpdateStatus' auf True setzen, aktualisiert der Adapter einen standardmäßigen SAP-Statuscode, nachdem der Adapter ein IDoc-Objekt für die Ereignisverarbeitung abgefragt hat. Mit der ALE-Erfolgscode-Eigenschaft wird der Code für ein erfolgreich gesendetes IDoc als 53 angegeben.

Nachdem das IDoc an den Endpunkt gesendet wurde, bleibt der IDoc-Status in SAP bei 03 (IDoc an Port gesendet). Nach Senden des IDoc sendet der Adapter das Prüf-IDoc mit der aktuellen IDoc-Nummer und dem Status 53. SAP konvertiert den aktuellen IDoc-Status in 41 (Anwendungsdokument, das im empfangenden System erstellt wurde).

Mehrsprachig Nein
Unterstützt für bidirektionale Sprachen Nein

Erfolgstext (aleSuccessText)

Diese Eigenschaft gibt den Text an, der angezeigt wird, wenn ein Anwendungsdokument erfolgreich gesendet wurde.

Tabelle 7. Details zur Eigenschaft 'ALE-Erfolgstext'
Erforderlich Ja, wenn 'AleUpdateStatus' auf True gesetzt wird; ansonsten nicht.
Standardwert Kein Standardwert.
Eigenschaftentyp Zeichenfolge
Verwendung Verwenden Sie diese Eigenschaft nur, wenn Sie die Eigenschaft AleUpdateStatus auf True setzen.

Wenn Sie die Eigenschaft 'AleUpdateStatus' auf True setzen, aktualisiert der Adapter einen standardmäßigen SAP-Statuscode, nachdem der Adapter ein IDoc-Objekt für die Ereignisverarbeitung abgefragt hat. Mit der ALE-Erfolgstexteigenschaft wird der beschreibende Text angegeben, mit dem 'Application Document Posted' (Anwendungsdokument gesendet) bezeichnet wird.

Beispiel ALE-Zustellung OK
Mehrsprachig Ja
Unterstützt für bidirektionale Sprachen Nein

ALE-Aktualisierungsstatus (aleUpdateStatus)

Diese Eigenschaft gibt an, ob ein Prüfprotokoll für alle Nachrichtentypen erforderlich ist.

Tabelle 8. Details zur Eigenschaft 'ALE-Aktualisierungsstatus'
Erforderlich Ja
Mögliche Werte

True (wahr)
False

Standardwert False
Eigenschaftentyp Boolescher Wert
Verwendung Setzen Sie diese Eigenschaft auf True, wenn der Adapter einen standardmäßigen SAP-Statuscode aktualisieren soll, nachdem das ALE-Modul ein IDoc-Objekt für die Ereignisverarbeitung abgerufen hat.
Wenn Sie diesen Wert auf True setzen, müssen Sie folgende Eigenschaften ebenfalls festlegen:
Mehrsprachig Nein
Unterstützt für bidirektionale Sprachen Nein

Gesicherte einmalige Zustellung (AssuredOnceDelivery)

Diese Eigenschaft gibt an, ob die gesicherte einmalige Zustellung für eingehende Ereignisse bereitgestellt werden soll.

Tabelle 9. Details zur Eigenschaft 'Gesicherte einmalige Zustellung'
Erforderlich Nein
Standard False
Eigenschaftentyp Boolescher Wert
Verwendung

Wenn diese Eigenschaft auf den Wert True gesetzt ist, wird eine einmalige Ereigniszustellung vom Adapter garantiert. Dies bedeutet, dass jedes Ereignis einmalig zugestellt wird. Bei Angabe des Werts False wird die einmalige Ereigniszustellung nicht garantiert, die Leistung jedoch erhöht.

Wenn diese Eigenschaft auf True gesetzt ist, versucht der Adapter, die Austausch-ID-Informationen (XID-Informationen) im Ereignisspeicher zu speichern. Wird sie auf False gesetzt, versucht der Adapter nicht, die Informationen zu speichern.

Diese Eigenschaft wird nur verwendet, wenn die Exportkomponente transaktional ist. Wenn die Exportkomponente nicht transaktional ist, kann unabhängig vom Wert dieser Eigenschaft keine Transaktion verwendet werden.

Mehrsprachig Nein
Unterstützt für bidirektionale Sprachen Nein

Automatische Erstellung einer Ereignistabelle (EP_CreateTable)

Diese Eigenschaft gibt an, ob die Ereignistabelle automatisch erstellt wird.

Tabelle 10. Details zur Eigenschaft 'Automatische Erstellung einer Ereignistabelle'
Erforderlich Ja, wenn Gesicherte einmalige Zustellung auf True gesetzt wird; ansonsten nicht.
Mögliche Werte

True (wahr)
False

Standardwert True (Wahr)
Eigenschaftentyp Boolescher Wert
Verwendung Diese Eigenschaft gibt an, ob der Adapter die Ereigniswiederherstellungstabelle automatisch erstellen soll, wenn sie noch nicht vorhanden ist.

Wenn Sie den Wert True angeben, um die Tabelle automatisch zu erstellen, müssen Sie Informationen zur Ereignistabelle angeben (z. B. den Namen der Ereigniswiederherstellungstabelle).

Der in der Eigenschaft Ereigniswiederherstellungstabellenname angegebene Wert wird zur Erstellung der Tabelle verwendet.

Mehrsprachig Nein
Unterstützt für bidirektionale Sprachen Nein

Client

Diese Eigenschaft ist die Clientnummer des SAP-Systems, zu dem der Adapter eine Verbindung herstellt.

Tabelle 11. Details zur Eigenschaft 'Client'
Erforderlich Ja
Mögliche Werte Sie können Werte im Bereich zwischen 000 und 999 eingeben.
Standard 100
Eigenschaftentyp Ganzzahl
Verwendung

Wenn eine Anwendung versucht, sich beim SAP-Server anzumelden, muss der Anwendung eine Clientnummer zugeordnet sein. Der Wert der Eigenschaft 'Client' gibt den Client (d. h. den Adapter) an, der versucht, sich beim SAP-Server anzumelden.

Mehrsprachig Nein
Unterstützt für bidirektionale Sprachen Nein

Codepage-Nummer (Codepage)

Die numerische ID der Codepage.

Tabelle 12. Details zur Eigenschaft 'Codepage-Nummer'
Erforderlich Nein
Mögliche Werte Sie können Werte im Bereich zwischen 0000 und 9999 eingeben.

Eine vollständige Liste der von SAP unterstützten Sprachen und zugehörigen Codepage-Nummern finden Sie im SAP-Hinweis 7360.

Standard Der Standardwert für diese Eigenschaft wird in Abhängigkeit vom für die Eigenschaft Sprachencode festgelegten Wert bestimmt.
Eigenschaftentyp Ganzzahl
Verwendung

Der für die Codepage-Nummer festgelegte Wert definiert die zu verwendende Codepage und hat eine Eins-zu-eins-Beziehung zu dem für die Eigenschaft Sprachencode festgelegten Wert. Die Codepage-Nummer stellt eine Verbindung zur entsprechenden Sprache her.

Jedem Wert der Eigenschaft 'Sprachencode' ist ein Wert der Eigenschaft 'Codepage-Nummer' zugeordnet. Der Sprachencode für Englisch ist beispielsweise 'EN'. Wenn Sie 'EN (English)' als Sprachencode auswählen, wird die Codepage-Nummer automatisch auf den numerischen Wert gesetzt, der dem Sprachencode 'EN (English)' zugeordnet ist. Die SAP-Codepage-Nummer für 'EN (English)' ist 1100.

Beispiel

Wenn die Eigenschaft Sprachencode auf JA (Japanisch) gesetzt ist, wird die Codepage-Nummer auf 8000 gesetzt.

Mehrsprachig Nein
Unterstützt für bidirektionale Sprachen Nein

Datenbankschemaname (EP_SchemaName)

Diese Eigenschaft ist das Schema, das für die automatische Erstellung der Ereigniswiederherstellungstabelle verwendet wird.

Tabelle 13. Details zur Eigenschaft 'Datenbankschemaname'
Erforderlich Nein
Standardwert Kein Standardwert.
Eigenschaftentyp Zeichenfolge
Verwendung Gibt den Schemanamen für die Datenbank an, die für die Ereignisspeicherungsfunktion des Adapters verwendet wird.
Beispiel ALE_SCHEMA
Mehrsprachig Ja
Unterstützt für bidirektionale Sprachen Nein

Sichere Netzverbindung aktivieren

Diese Eigenschaft gibt an, ob der Modus für eine sichere Netzverbindung aktiviert ist.

Tabelle 14. Details zur Eigenschaft 'Sichere Netzverbindung aktivieren'
Erforderlich Nein
Mögliche Werte

0 (inaktiviert)
1 (aktiviert)

Standardwert 0
Eigenschaftentyp Zeichenfolge
Verwendung Setzen Sie den Wert auf 1 (aktiviert), wenn Sie eine sichere Netzverbindung verwenden möchten.
Mehrsprachig Nein
Unterstützt für bidirektionale Sprachen Nein

Ereigniswiederherstellungsdatenquellenname (JNDI) (EP_DataSource_JNDIName)

Diese Eigenschaft ist der JNDI-Name der Datenquelle, die für die Ereigniswiederherstellung konfiguriert wurde.

Tabelle 15. Details zur Eigenschaft 'Ereigniswiederherstellungsdatenquellenname (JNDI)'
Erforderlich Ja
Standardwert Kein Standardwert.
Eigenschaftentyp Zeichenfolge
Verwendung Wird bei der Verarbeitung zur Ereigniswiederherstellung verwendet. Die Datenquelle muss in WebSphere Message Broker erstellt werden. Der Adapter greift zum Beibehalten des Ereignisstatus auf die Datenquelle zurück.
Beispiel jdbc/DB2
Mehrsprachig Nein
Unterstützt für bidirektionale Sprachen Nein

Ereigniswiederherstellungstabellenname (EP_TableName)

Diese Eigenschaft ist der Name der Ereigniswiederherstellungstabelle.

Tabelle 16. Details zur Eigenschaft 'Ereigniswiederherstellungstabellenname'
Erforderlich Ja
Standardwert Kein Standardwert.
Eigenschaftentyp Zeichenfolge
Verwendung Wird bei der Verarbeitung zur Ereigniswiederherstellung verwendet. Informationen zu Namenskonventionen finden Sie in der Datenbankdokumentation.

Konfigurieren Sie eine eigene Ereigniswiederherstellungstabelle für jeden Endpunkt. Dabei kann für alle Ereigniswiederherstellungstabellen dieselbe Datenquelle verwendet werden.

Beispiel EVENT_TABLE
Mehrsprachig Nein
Unterstützt für bidirektionale Sprachen Nein

Ordner für RFC-Tracedateien (RfcTracePath)

Diese Eigenschaft legt den vollständig qualifizierten Pfad des Ordners fest, in den die RFC-Tracedateien geschrieben werden sollen.

Tabelle 17. Details zur Eigenschaft 'Ordner für RFC-Tracedateien'
Erforderlich Nein
Standard Kein Standardwert
Eigenschaftentyp Zeichenfolge
Verwendung Gibt den vollständig qualifizierten, lokalen Pfad des Ordners an, in den die RFC-Tracedateien geschrieben werden.

Wenn RFC-Trace auf 'False' (nicht ausgewählt) gesetzt ist, sind Sie nicht berechtigt, für die Eigenschaft Ordner für RFC-Tracedateien einen Wert festzulegen.

Beispiel c:\temp\rfcTraceDir
Mehrsprachig Ja
Unterstützt für bidirektionale Sprachen Nein

Gateway-Host (GatewayHost)

Diese Eigenschaft gibt den Namen des Gateway-Hosts an. Geben Sie entweder die IP-Adresse oder den Namen des Gateway-Hosts ein. Fragen Sie ggf. den SAP-Administrator nach dem Namen des Gateway-Hosts.

Tabelle 18. Details zur Eigenschaft 'Gateway-Host'
Erforderlich Ja
Standard Kein Standardwert
Eigenschaftentyp Zeichenfolge
Verwendung

Diese Eigenschaft ist der Hostname des SAP-Gateways. Das Gateway aktiviert die Kommunikation zwischen Arbeitsprozessen auf dem SAP-System und externen Programmen.

Der angegebene Host wird als Gateway für den Ressourcenadapter verwendet.

Maximale Länge von 20 Zeichen. Wenn der Computername länger als 20 Zeichen ist, definieren Sie einen symbolischen Namen in der THOSTS-Tabelle.

Mehrsprachig Nein
Unterstützt für bidirektionale Sprachen Nein

Gateway-Service (GatewayService)

Diese Eigenschaft ist der Bezeichner des Gateways beim Gateway-Host, der die RFC-Services durchführt.

Tabelle 19. Details zur Eigenschaft 'Gateway-Service'
Erforderlich Ja
Standard sapgw00
Eigenschaftentyp Zeichenfolge
Verwendung

Diese Services aktivieren die Kommunikation zwischen Arbeitsprozessen auf dem SAP-Server und externen Programmen. Der Service hat normalerweise das Format sapgw00, wobei '00' für die Systemnummer steht.

Maximum von 20 Zeichen.

Mehrsprachig Nein
Unterstützt für bidirektionale Sprachen Nein

Hostname (ApplicationServerHost)

Gibt die IP-Adresse oder den Namen des Anwendungsserver-Hosts an, auf dem sich der Adapter anmeldet.

Tabelle 20. Details zur Eigenschaft 'Hostname'
Erforderlich Ja (wenn Lastausgleich nicht verwendet wird)
Standard Kein Standardwert
Eigenschaftentyp Zeichenfolge
Verwendung

Wenn der Adapter für eine Ausführung ohne Lastausgleich konfiguriert ist, gibt diese Eigenschaft die IP-Adresse oder den Namen des Anwendungsservers an, auf dem sich der Adapter anmeldet.

Beispiel sapServer
Mehrsprachig Nein
Unterstützt für bidirektionale Sprachen Nein

Ignorieren von IDoc-Paketfehlern (IgnoreIDocPacketErrors)

Diese Eigenschaft gibt an, ob IDoc-Paketfehler ignoriert werden sollen.

Tabelle 21. Details zur Eigenschaft 'Ignorieren von IDoc-Paketfehlern'
Erforderlich Nein
Mögliche Werte

True (wahr)
False

Standardwert False
Eigenschaftentyp Boolescher Wert
Verwendung
Wenn der Adapter bei der Verarbeitung des IDoc-Pakets einen Fehler findet, kann er sich auf zwei verschiedene Arten verhalten.
  • Wenn diese Eigenschaft auf False gesetzt wird, stoppt der Adapter die Verarbeitung weiterer IDocs in diesem Paket und meldet dem SAP-System einen Fehler.
  • Wenn diese Eigenschaft auf True gesetzt wird, protokolliert der Adapter einen Fehler und fährt mit der Verarbeitung der restlichen IDocs in diesem Paket fort.

    Als Status der Transaktion wird INPROGRESS (In Bearbeitung) angegeben. Im Adapterprotokoll werden die fehlgeschlagenen IDoc-Nummern aufgeführt, die separat erneut übergeben werden müssen. Diese Datensätze müssen auch manuell in die Ereigniswiederherstellungstabelle eingepflegt werden.

Diese Eigenschaft wird für einzelne IDocs und ungeteilte IDoc-Pakete nicht verwendet.

Mehrsprachig Nein
Unterstützt für bidirektionale Sprachen Nein

Sprachencode

Diese Eigenschaft gibt den Sprachencode an, mit dem sich der Adapter anmeldet.

Tabelle 22. Details zur Eigenschaft 'Sprachencode'
Erforderlich Ja
Mögliche Werte

Eine vollständige Liste der von SAP unterstützten Sprachen und zugehörigen Codepage-Nummern finden Sie im SAP-Hinweis 7360.

Standard Der Standardwert für die Eigenschaft Sprachencode basiert auf der Ländereinstellung des Systems.
Eigenschaftentyp Zeichenfolge
Verwendung

Jeder der unterstützten Sprachen ist ein aus zwei Zeichen bestehender Sprachencode vorangestellt. Die Sprache selbst wird in Klammern angezeigt.

Wenn Sie den Sprachencode manuell eingeben, brauchen Sie nicht die Sprache in Klammern anzugeben.

Die aufgelisteten Sprachencodes entsprechen der SAP-Standardgruppe von 41 Sprachen für Nicht-Unicode-Systeme plus Arabisch.

Der von Ihnen ausgewählte Wert bestimmt gleichzeitig den Wert der Eigenschaft Codepage-Nummer.

Beispiel

Wenn die Ländereinstellung des Systems 'Englisch' ist, hat diese Eigenschaft den Wert EN (English).

Mehrsprachig Nein
Unterstützt für bidirektionale Sprachen Nein

Anmeldegruppe

Diese Eigenschaft ist eine ID für den Namen der Gruppe der Anwendungsserverinstanzen, die in Transaktions-SMLG definiert und für Anmeldelastausgleich verknüpft wurden.

Tabelle 23. Details zur Eigenschaft 'Anmeldegruppe'
Erforderlich Ja (wenn Lastausgleich verwendet wird)
Mögliche Werte Informationen zum Erstellen von Anmeldegruppen und Aufrufen von Transaktions-SMLG finden Sie in der SAP-Dokumentation.
Standard Kein Standardwert
Eigenschaftentyp Zeichenfolge
Verwendung

Wenn der Adapter für Lastausgleich konfiguriert wird, stellt diese Eigenschaft den Namen der Gruppe der Anwendungsserverinstanzen dar, die in Transaktions-SMLG definiert und für Anmeldelastausgleich verknüpft wurden.

Der Anmeldelastausgleich ermöglicht die dynamische Verteilung von Anmeldeverbindungen zu Anwendungsserverinstanzen.

Maximum von 20 Zeichen. Bei den meisten SAP-Systemen wird die Anmeldegruppe SPACE von SAP reserviert.

Mehrsprachig Nein
Unterstützt für bidirektionale Sprachen Nein

Maximale Anzahl der Wiederholungen bei Systemverbindungsfehler

Diese Eigenschaft gibt an, wie oft der Adapter versucht, den Ereignislistener neu zu starten.

Tabelle 24. Details zur Eigenschaft 'Maximale Anzahl der Wiederholungen bei Systemverbindungsfehler'
Erforderlich Ja
Standard 0
Eigenschaftentyp Ganzzahl
Verwendung
Wenn der Adapter einen Fehler feststellt, der mit der eingehenden Verbindung zusammenhängt (z. B. wenn die SAP-Anwendung inaktiv ist), gibt diese Eigenschaft an, wie oft der Adapter versucht, den Ereignislistener neu zu starten. Der Wert '0' gibt an, dass die Anzahl der Wiederholungen nicht beschränkt ist.
Anmerkung: Konfigurieren Sie im Falle einer unbeschränkten Anzahl von Wiederholungen den Wert Wartezeit zwischen Wiederholungsversuchen bei Systemverbindungsfehler (Millisekunden) entsprechend.

Bei jedem Wiederholungsversuch wartet der Adapter für die durch den Wert Wartezeit zwischen Wiederholungsversuchen bei Systemverbindungsfehler (Millisekunden) angegebene Dauer.

Anmerkung: Wenn alle Wiederholungsversuche fehlschlagen, protokolliert der Adapter relevante Nachrichten und CEI-Ereignisse (Common Event Infrastructure) und beendet seine Versuche, den Ereignislistener wiederherzustellen. Wenn dieser Fall eintritt, müssen Sie möglicherweise die Anwendung manuell erneut starten.
Mehrsprachig Nein
Unterstützt für bidirektionale Sprachen Nein

Nachrichtenserver-Host (MessageServerHost)

Diese Eigenschaft gibt den Namen des Hosts an, auf dem der Nachrichtenserver ausgeführt wird.

Tabelle 25. Details zur Eigenschaft 'Nachrichtenserver-Host'
Erforderlich Ja (wenn Lastausgleich verwendet wird)
Standard Kein Standardwert
Eigenschaftentyp Zeichenfolge
Verwendung

Diese Eigenschaft gibt den Namen des Hosts an, der alle Server (Instanzen), die zu diesem SAP-System gehören, über das Vorhandensein der anderen Server informiert, die für den Lastausgleich verwendet werden.

Der Nachrichtenserver-Host enthält die Informationen über Lastausgleich für RFC-Clients, damit solch ein Client zu einem geeigneten Anwendungsserver geleitet werden kann.

Beispiel SAPERP05
Mehrsprachig Nein
Unterstützt für bidirektionale Sprachen Nein

Anzahl der Listener

Diese Eigenschaft gibt die Anzahl der Listener an, die durch ein Ereignis gestartet wird.

Tabelle 26. Details zur Eigenschaft 'Anzahl der Listener'
Erforderlich Nein
Standard 1
Eigenschaftentyp Ganzzahl
Verwendung Diese Eigenschaft sollte für die Ereignis-Reihenfolgeplanung auf 1 gesetzt sein.

Zur Verbesserung der Adapterleistung können Sie die Anzahl der Empfangsprogramme erhöhen.

Mehrsprachig Nein
Unterstützt für bidirektionale Sprachen Nein

Partnerzeichensatz (PartnerCharset)

Diese Eigenschaft gibt die Partnerzeichensatzcodierung an.

Tabelle 27. Details zur Eigenschaft 'Partnerzeichensatz'
Erforderlich Nein
Standard

UTF-8

Eigenschaftentyp Zeichenfolge
Verwendung Wenn eine Verschlüsselung angegeben ist, wird sie verwendet; ansonsten wird die Standardverschlüsselung benutzt.
Mehrsprachig Nein
Unterstützt für bidirektionale Sprachen Nein

Kennwort

Diese Eigenschaft ist das Kennwort des Benutzerkontos des Adapters auf dem SAP-Anwendungsserver.

Tabelle 28. Details zur Eigenschaft 'Kennwort'
Erforderlich Ja
Standard Kein Standardwert
Eigenschaftentyp Zeichenfolge
Verwendung

Die Einschränkungen beim Kennwort hängen von der Version von SAP Web Application Server ab.

  • Für SAP Web Application Server Version 6.40 oder früher gilt Folgendes für das Kennwort:
    • Es muss in Großbuchstaben sein.
    • Es muss 8 Zeichen lang sein.
  • Für spätere Versionen als SAP Web Application Server 6.40 gilt Folgendes für das Kennwort:
    • Groß-/Kleinschreibung wird nicht beachtet.
    • Bis zu 40 Zeichen Länge möglich.
Mehrsprachig Nein
Unterstützt für bidirektionale Sprachen Ja

Kennwort, um Verbindung zur Ereignisdatenquelle herzustellen (EP_Password)

Diese Eigenschaft ist das Benutzerkennwort für die Verbindung zur Datenbank.

Tabelle 29. Details zur Eigenschaft 'Kennwort, um Verbindung zur Ereignisdatenquelle herzustellen'
Erforderlich Ja
Standardwert Kein Standardwert.
Eigenschaftentyp Zeichenfolge
Verwendung Diese Eigenschaft gibt das Kennwort an, das von der Verarbeitung zur Ereignisspeicherung beim Abrufen der Datenbankverbindung aus der Datenquelle verwendet wird.
Mehrsprachig Ja
Unterstützt für bidirektionale Sprachen Nein

RFC-Programm-ID

Diese Eigenschaft ist die Programmkennung, mit der sich der Adapter im SAP-Gateway registriert.

Tabelle 30. Details zur Eigenschaft 'RFC-Programm-ID'
Erforderlich Ja
Mögliche Werte Verwenden Sie die SAP-Transaktion SM59 (RFC-Ziele anzeigen und verwalten), um eine Liste der verfügbaren RFC-Programm-IDs anzuzeigen.
Standard Kein Standardwert.
Eigenschaftentyp Zeichenfolge
Verwendung

Der Adapter registriert sich beim Gateway, damit Empfangsthreads Ereignisse von RFC-aktivierten Funktionen verarbeiten können. Dieser Wert muss mit der Programm-ID übereinstimmen, die in der SAP-Anwendung registriert ist.

Die maximale Länge beträgt 64 Zeichen.

Mehrsprachig Nein
Unterstützt für bidirektionale Sprachen Nein

RFC-Tracestufe (RcfTraceLevel)

Diese Eigenschaft gibt die globale Tracestufe an.

Tabelle 31. Details zur Eigenschaft 'RFC-Tracestufe'
Erforderlich Nein
Mögliche Werte

1 - Dies ist die RFC-Standard-Tracestufe. Wenn diese Stufe angegeben ist, erfolgt eine Protokollierung der SAP JCo Java API.
3 - Wenn diese Stufe angegeben ist, erfolgt eine Protokollierung der SAP JCo JNI API.
5 - Wenn diese Stufe angegeben ist, erfolgt eine Protokollierung der Fehlerdiagnose.

Standard 1
Eigenschaftentyp Ganzzahl
Verwendung Wenn RFC-Trace auf False (nicht ausgewählt) gesetzt ist, können Sie für die Eigenschaft RFC-Trace-Stufe keinen Wert festlegen.
Mehrsprachig Nein
Unterstützt für bidirektionale Sprachen Nein

RFC-Trace ein (RcfTraceOn)

Diese Eigenschaft gibt an, ob eine Textdatei generiert werden soll, in der die RFC-Aktivitäten für jeden Ereignislistener beschrieben werden.

Tabelle 32. Details zur Eigenschaft 'RFC-Trace ein'
Erforderlich Nein
Mögliche Werte

True (wahr)
False

Standard False
Eigenschaftentyp Boolescher Wert
Verwendung Der Wert True aktiviert die Tracefunktion, die eine Textdatei generiert.

Diese Datei wird im Verzeichnis erstellt, in dem der Adapterprozess gestartet wurde. Die Datei hat das Präfix rfx und den Dateityp TRC (z. B. rfc03912_02220.trc).

Verwenden Sie diese Textdateien ausschließlich in einer Entwicklungsumgebung, da die Dateien schnell größer werden können.

Wenn RFC-Trace auf False (nicht ausgewählt) gesetzt ist, können Sie für die Eigenschaften Ordner für RFC-Tracedateien oder RFC-Trace-Stufe keine Werte festlegen.

Beispiel

Beispiele der Informationen in der Datei sind 'RfcCall FUNCTION BAPI_CUSTOMER_GETLIST', gefolgt von den Informationen für die Parameter in der Schnittstelle, oder 'RFC Info rfctable', gefolgt von den Daten von einer der Schnittstellentabellen.

Die Tracedatei wird in dem Verzeichnis erstellt, in dem der Adapterprozess gestartet wurde. Der Name der Tracedatei hat die Dateierweiterung TRC und der Dateiname beginnt mit den Buchstaben rfc, gefolgt von einer eindeutigen ID. Beispiel: rfc03912_02220.trc.

Mehrsprachig Nein
Unterstützt für bidirektionale Sprachen Nein

SAP-System-ID (SAPSystemID)

Diese Eigenschaft gibt die System-ID des SAP-Systems an, für das ein Anmeldelastausgleich zulässig ist.

Tabelle 33. Details zur Eigenschaft 'SAP-System-ID'
Erforderlich Ja (wenn Lastausgleich verwendet wird)
Standard Kein Standardwert
Eigenschaftentyp Zeichenfolge
Verwendung Der Wert muss drei Zeichen aufweisen.
Beispiel DYL
Mehrsprachig Nein
Unterstützt für bidirektionale Sprachen Nein

Pfad der Bibliothek für sichere Netzverbindung (SncLib)

Diese Eigenschaft gibt den Pfad zur Bibliothek an, die den Service für die sichere Netzverbindung bereitstellt.

Tabelle 34. Details zur Eigenschaft 'Pfad der Bibliothek für die sichere Netzverbindung'
Erforderlich Ja, sofern die Eigenschaft 'Sichere Netzverbindung aktivieren' (SncMode) auf 1 gesetzt ist; andernfalls nein.
Standard Kein Standardwert
Eigenschaftentyp Zeichenfolge
Verwendung Wenn die Eigenschaft 'Sichere Netzverbindung aktivieren' (SncMode) auf 1 gesetzt wird (um anzugeben, dass Sie eine sichere Netzverbindung verwenden möchten), müssen Sie hier den Pfad zur Bibliothek angeben, die den Service bereitstellt.
Beispiel /WINDOWS/system32/gssapi32.dll
Mehrsprachig Nein
Unterstützt für bidirektionale Sprachen Nein

Name der sicheren Netzverbindung (SncMyname)

Diese Eigenschaft gibt den Namen der sicheren Netzverbindung an.

Tabelle 35. Details zur Eigenschaft 'Name der sicheren Netzverbindung'
Erforderlich Ja, sofern die Eigenschaft 'Sichere Netzverbindung aktivieren' (SncMode) auf 1 gesetzt ist; andernfalls nein.
Standard Kein Standardwert
Eigenschaftentyp Zeichenfolge
Verwendung Wenn die Eigenschaft 'Sichere Netzverbindung aktivieren' (SncMode) auf 1 gesetzt wird (um anzugeben, dass Sie eine sichere Netzverbindung verwenden möchten), müssen Sie hier einen Namen für die Verbindung angeben.
Beispiel DOMÄNENNAME/BENUTZERNAME
Mehrsprachig Nein
Unterstützt für bidirektionale Sprachen Nein

Partner für die sichere Netzverbindung (SncPartnername)

Diese Eigenschaft gibt den Namen des Partners für die sichere Netzverbindung an.

Tabelle 36. Details zur Eigenschaft 'Partner für die sichere Netzverbindung'
Erforderlich Ja, sofern die Eigenschaft 'Sichere Netzverbindung aktivieren' (SncMode) auf 1 gesetzt ist; andernfalls nein.
Standard Kein Standardwert
Eigenschaftentyp Zeichenfolge
Verwendung Wenn die Eigenschaft 'Sichere Netzverbindung aktivieren' (SncMode) auf 1 gesetzt wird (um anzugeben, dass Sie eine sichere Netzverbindung verwenden möchten), müssen Sie hier einen Namen für den Verbindungspartner angeben.
Beispiel CN=sap00.saperpdev, OU=Adapter, O=IBM, C=US
Mehrsprachig Nein
Unterstützt für bidirektionale Sprachen Nein

Sicherheitsstufe für sichere Netzverbindung (SncQop)

Diese Eigenschaft gibt die Sicherheitsstufe für die sichere Netzverbindung an.

Tabelle 37. Details zur Eigenschaft 'Sicherheitsstufe für sichere Netzverbindung'
Erforderlich Ja, sofern die Eigenschaft 'Sichere Netzverbindung aktivieren' (SncMode) auf 1 gesetzt ist; andernfalls nein.
Mögliche Werte
  • 1 (Nur Authentifizierung)
  • 2 (Integritätsschutz)
  • 3 (Datenschutz)
  • 8 (Den auf dem Anwendungsserver unter snc/data_protection/use angegebenen Wert verwenden)
  • 9 (Den auf dem Anwendungsserver unter snc/data_protection/max angegebenen Wert verwenden)
Standard 3 (Datenschutz)
Eigenschaftentyp Zeichenfolge
Verwendung Wenn die Eigenschaft 'Sichere Netzverbindung aktivieren' (SncMode) auf 1 gesetzt wird (um anzugeben, dass Sie eine sichere Netzverbindung verwenden möchten), müssen Sie hier den Wert der Sicherheitsstufe für die Verbindung angeben.
Mehrsprachig Nein
Unterstützt für bidirektionale Sprachen Nein

Systemnummer (SystemNumber)

Diese Eigenschaft ist die Systemnummer des SAP-Anwendungsservers.

Tabelle 38. Details zur Eigenschaft 'Systemnummer'
Erforderlich Ja
Mögliche Werte Sie können Werte im Bereich zwischen 00 und 99 eingeben.
Standard 00
Eigenschaftentyp Ganzzahl
Verwendung

Außerdem gibt die Systemnummer den Gateway-Service an.

Mehrsprachig Nein
Unterstützt für bidirektionale Sprachen Nein

Wartezeit zwischen Wiederholungsversuchen bei Systemverbindungsfehler (Millisekunden) (ConnectionRetryInterval)

Diese Eigenschaft gibt das Zeitintervall zwischen zwei Versuchen zum Neustart des Ereignislisteners an.

Tabelle 39. Details zur Eigenschaft 'Wartezeit zwischen Wiederholungsversuchen bei Systemverbindungsfehler'
Erforderlich Ja
Standard 60000
Maßeinheit Millisekunden
Eigenschaftentyp Ganzzahl
Verwendung Wenn der Adapter einen Fehler feststellt, der mit der eingehenden Verbindung zusammenhängt, gibt diese Eigenschaft den Zeitraum an, den der Adapter bis zum nächsten Versuch eines Neustarts des Ereignislisteners verstreichen lässt.
Mehrsprachig Nein
Unterstützt für bidirektionale Sprachen Nein

Benutzername (userName)

Diese Eigenschaft ist das Benutzerkonto für den Adapter auf dem SAP-Server.

Tabelle 40. Details zur Eigenschaft 'Benutzername'
Erforderlich Ja
Standard Kein Standardwert
Eigenschaftentyp Zeichenfolge
Verwendung Maximale Länge von 12 Zeichen. Beim Benutzernamen wird die Groß-/Kleinschreibung nicht beachtet.

Es wird empfohlen, in der SAP-Anwendung ein CPIC-Benutzerkonto anzulegen und diesem Konto die Berechtigungen zu erteilen, die zum Bearbeiten der Daten benötigt werden, welche für die vom Adapter unterstützten Geschäftsobjekte erforderlich sind. Wenn der Adapter beispielsweise bestimmte SAP-Geschäftstransaktionen in der SAP-Anwendung ausführen soll, muss er über die Berechtigungen verfügen, mit denen das Ausführen der Transaktionen zulässig ist.

Beispiel SapUser
Mehrsprachig Ja
Unterstützt für bidirektionale Sprachen Ja

Benutzername, um Verbindung zur Ereignisdatenquelle herzustellen (EP_UserName)

Diese Eigenschaft ist der Benutzername für die Verbindung zur Datenbank.

Tabelle 41. Details zur Eigenschaft 'Benutzername, um Verbindung zur Ereignisdatenquelle herzustellen'
Erforderlich Ja
Standardwert Kein Standardwert.
Eigenschaftentyp Zeichenfolge
Verwendung Der Benutzername, der von der Ereignisspeicherung beim Abrufen der Datenbankverbindung aus der Datenquelle verwendet wird. Informationen zu Namenskonventionen finden Sie in der Datenbankdokumentation.
Mehrsprachig Ja
Unterstützt für bidirektionale Sprachen Nein

X509-Zertifikat (X509cert)

Diese Eigenschaft gibt das X509-Zertifikat an, das als Zugriffsberechtigung für die Anmeldung verwendet werden soll.

Tabelle 42. Details zur Eigenschaft 'X509-Zertifikat'
Erforderlich Nein
Standard Kein Standardwert
Eigenschaftentyp Zeichenfolge
Verwendung Wenn die Eigenschaft 'Sichere Netzverbindung aktivieren' (SncMode) auf 1 gesetzt wird (um anzugeben, dass Sie eine sichere Netzverbindung verwenden möchten), können Sie hier einen Wert für das X509-Zertifikat angeben.
Mehrsprachig Nein
Unterstützt für bidirektionale Sprachen Nein
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        Letzte Aktualisierung
        
        Letzte Aktualisierung : 2012-07-16 12:24:27


ReferenzthemaReferenzthema | Version 8.0.0.1 | rbp_sap_activationspec_props