Konfigurations-Properties für Inbound-Kommunikation in ejb-jar.xml definieren

Die folgenden Properties müssen im Deployment Descriptor (ejb-jar.xml) der OLTP Message-Driven Bean eingestellt werden:

• Die Property messaging-type gibt das Message-Listener-Interface an, das von der OLTP Message-Driven Bean verwendet wird.

• Die activation-config Properties beziehen sich auf das spezifizierte MessageListener-Interface. Jede dieser Properties ist in einem eigenen activation-config-property-Element innerhalb des activation-config-Elements in der Datei ejb-jar.xml definiert.

  Folgende activation-config Properties sind verfügbar:

  
  

  messageEndpoint
  encoding
  encodingActive
  redeliveryThreshold
  

  Die Properties für die Datei ejb-jar.xml sind nachfolgend ausführlich beschrieben.

messaging-type

Die Property messaging-type gibt das Message-Listener-Interface an, das von der OLTP Message-Driven Bean verwendet wird.

Definition:	Message-Listener-Interface, das von der OLTP Message-Driven Bean verwendet wird
Standard:	–
Beispiel:	<messaging-type> net.fsc.jca.communication.AsyncOltpMessageListener </messaging-type>

messageEndpoint

Die Property messageEndpoint gibt den Namen des Message Endpoints an. Der hier angegebene Name des Message Endpoints muss mit dem Namen des Inbound Message Endpoints übereinstimmen, der beim Konfigurieren des Proxys mit der Management Console angegeben wurde (siehe Inbound Message Endpoints konfigurieren).

Definition:	Name des Message Endpoints.
Standard:	–
Beispiel:	<activation-config-property> <activation-config-property-name>messageEndpoint </activation-config-property-name> <activation-config-property-value>SampleAsynOltpMdb </activation-config-property-value> </activation-config-property>

encoding

Die Property encoding definiert eine Code-Tabelle für die Konvertierung von Byte-Code (zum Beispiel EBCDIC) in Unicode.

Die hier angegebene Property wird überschrieben, wenn die Message-Driven Bean durch einen Inbound Service aufgerufen wird, dem in der Management Console bei der Konfiguration des Proxy ein Partner Encoding zugeordnet wurde.

Definition:	[<builtin_encoding_table> | builtin:<builtin_encoding_table>| jdk:<jdk_encoding_table> | custom:<encoding_table>]
Erklärung:	Name einer Code-Tabelle, die für die Code-Konvertierung verwendet wird. Ist kein Präfix oder ist das Präfix builtin: angegeben, müssen Sie den Namen einer integrierten Code-Tabelle angeben, die von BeanConnect bereitgestellt wird. Folgende Code-Tabellen stehen zur Verfügung: OSD_EBCDIC_DF03_IRV, OSD_EBCDIC_DF04_1, OSD_EBCDIC_DF04_15, OSD_EBCDIC_DF04_DRV Mit dem Präfix jdk: geben Sie eine Code-Tabelle an, die im JDK enthalten ist. Mit dem Präfix custom: weisen Sie Ihre eigene Code-Tabelle zu. Dabei müssen Sie den vollständigen Klassennamen der Code-Tabelle angeben. Weitere Einzelheiten zur Verwendung von eigenen Code-Tabellen finden Sie in der JavaDoc zu BeanConnect.
Standard:	OSD_EBCDIC_DF04_DRV
Beispiel:	für UTM-Partner: <activation-config-property> <activation-config-property-name>encoding </activation-config-property-name> <activation-config-property-value>OSD_EBCDIC_DF04_15 </activation-config-property-value> </activation-config-property> für CICS-Partner: <activation-config-property> <activation-config-property-name>encoding </activation-config-property-name> <activation-config-property-value>jdk:Cp1047 </activation-config-property-value> </activation-config-property>

encodingActive

Die Property encodingActive gibt an, ob die Code-Konvertierung aktiviert werden soll oder nicht.

Die Property wird unabhängig vom hier angegebenen Wert auf true gesetzt, wenn die Message-Driven Bean durch einen Inbound Service aufgerufen wird, dem in der Management Console bei der Konfiguration des Proxy ein Partner Encoding zugeordnet wurde.

Definition:	[true | false]
Erklärung:	Gibt an, ob die Code-Konvertierung aktiviert wird oder nicht.
	true	Die Code-Konvertierung gemäß der Einstellungen der activationconfig-Property encoding ist aktiviert.
	false	Die Standard-Code-Tabelle des JDK wird für die Konvertierung von Byte-Streams in Strings verwendet.
Standard:	false
Beispiel:	<activation-config-property> <activation-config-property-name>encodingActive </activation-config-property-name> <activation-config-property-value>true </activation-config-property-value> </activation-config-property>

redeliveryThreshold

Die Property redeliveryThreshold definiert die Anzahl der zusätzlichen Versuche, die Nachricht zuzustellen, wenn die Transaktion zurückgesetzt wird. Diese Property kann nur für asynchrone OLTP Message-Driven Beans eingestellt werden, d.h. für OLTP Message-Driven Beans, die das Message-Listener-Interface net.fsc.jca.communication.AsyncOltpMessageListener implementieren. Das Message-Listener-Interface wird in der Property messaging-type angegeben.

Diese Property wird nur wirksam, wenn die OLTP Message-Driven Bean mit dem Transaktionsattribut Required deployt wurde. In diesem Fall wird die Methode onMessage innerhalb einer Transaktion aufgerufen, die vom Proxy gestartet wurde (niemals vom EIS). Wird die Transaktion zurückgesetzt, so wird die Nachricht noch einmal zugestellt, es sei denn, der generierte Schwellwert wurde überschritten.

Definition:	Anzahl der zusätzlichen Zustellversuche im Fehlerfall. Minimalwert: 0 Maximalwert: 254
Standard:	0, d.h. die Nachricht wird nicht noch einmal zugestellt.
Beispiel:	<activation-config-property> <activation-config-property-name>redeliveryThreshold </activation-config-property-name> <activation-config-property-value>1 </activation-config-property-value> </activation-config-property>