JMS-Bindungseinstellungen für SCA-Verbünde

Verwenden Sie diese Seite, um Eigenschafteneinstellungen für eine JMS-Bindung (Java Message Service) anzuzeigen, die SCA-Verbundreferenzen (Service Component Architecture) oder -Services miteinander verbindet. Auf dieser Seite können Sie auch Ressourcen der JMS-Bindung bearbeiten. Die auf dieser Seite angezeigten Einstellungen definieren ein Element binding.jms.

Zum Anzeigen dieser Seite der Administrationskonsole muss Ihre Kompositionseinheit eine JMS-Bindungsreferenz oder einen JMS-Service unterstützen. Führen Sie in der Administrationskonsole die folgenden Schritte aus:

  1. Klicken Sie auf Anwendungen > Anwendungstypen > Geschäftsanwendungen > Anwendungsname > Name_der_Kompositionseinheit_des_implementierten_Assets.
  2. Wählen Sie auf der Seite mit den Kompositionseinheiteneinstellungen für SCA-Verbünde die Option zum Anzeigen von Referenzen bzw. Services aus:
    • Für eine SCA-Komponentenreferenz klicken Sie auf SCA-Verbundkomponenten > Name_der_SCA-Komponentenreferenz > SCA-Komponentenreferenzen > Referenzname > Bindungen > JMS-Bindung.
    • Für einen SCA-Komponentenservice klicken Sie auf SCA-Verbundkomponenten > Name_des_SCA-Komponentenservice > SCA-Komponentenservices > Servicename > Bindungen > JMS-Bindung.

Sie können eine JMS-Bindung verwenden, um vorhandene JMS-Ressourcen über JNDI-Namen (Java Naming and Directory Interface) zu identifizieren.

Allgemeine Eigenschaften

Gibt Eigenschafteneinstellungen an, die für alle Elemente binding.jms gelten. Die Einstellungen beziehen sich auf Services und Referenzen. Die Einstellungen können nicht bearbeitet werden.

URI der JMS-Bindung
Gibt einen URI (Uniform Resource Identifier) an, der Eigenschaften wie die Destination, die Verbindungs-Factory und die Aktivierungsspezifikation identifizieren, die zum Senden oder Empfangen der JMS-Nachricht verwendet werden sollen.

Der URI hat das folgende Format:

jms: JMS-Destination?
connectionFactoryName=Name_der_Verbindungs-Factory &
destinationType={queue|topic} &
deliveryMode=Zustellungsmodus &
timeToLive=Lebensdauer &
priority=Priorität &
Benutzereigenschaft=Wert_der_Benutzereigenschaft & ...
Korrelationsschema
Gibt das beim Senden von Antwort- oder Callback-Nachrichten zu verwendende Korrelationsschema an.

Die gültigen Werte sind requestmsgidtocorrelid (Standardeinstellung), requestcorrelidtocorrelid und none.

Ausgangskontext-Factory
Gibt den Namen der Ausgangskontext-Factory an, die zum Abrufen eines JNDI-Ausgangskontext verwendet wird.

Diese Einstellung ist optional. Wenn keine Factory angegeben ist, wird die Ausgangskontext-Factory von WebSphere Application Server verwendet.

JNDI-URL
Gibt den URL (Uniform Resource Locator) für den JNDI-Provider an.
Anforderungsverbindung
Gibt ein Element binding.jms in einer Verbunddefinitionsdatei an.

Eine Anforderung ist eine Nachricht, die an einen SCA-Service oder von einer SCA-Referenz gesendet wird.

Antwortverbindung
Gibt ein Element binding.jms in einer Verbunddefinitionsdatei an.

Eine Antwort ist eine Nachricht, die von einer Referenz empfangen wird (d. h. eine Antwort eines aufgerufenen Service), oder eine Nachricht, die von einem Service als Reaktion auf eine vorherige Anforderungsnachricht gesendet wird. Eine Antwort in SCA ist immer eine Antwort auf eine vorherige Anforderung.

Format der Anforderungsbeziehung
Gibt den Namen des Komponentendefinitionselement einer Beziehung zwischen SCA-Verbünden an.

Beispiel: wireFormat.jmsObject.

Eine Anforderung ist eine Nachricht, die an einen SCA-Service oder von einer SCA-Referenz gesendet wird.

Format der Antwortbeziehung
Gibt den Namen des Komponentendefinitionselement einer Beziehung zwischen SCA-Verbünden an.

Beispiel: wireFormat.jmsObject.

Eine Antwort ist eine Nachricht, die von einer Referenz empfangen wird (d. h. eine Antwort eines aufgerufenen Service), oder eine Nachricht, die von einem Service als Reaktion auf eine vorherige Anforderungsnachricht gesendet wird. Eine Antwort in SCA ist immer eine Antwort auf eine vorherige Anforderung.

Ressourcen

Gibt Ressourcen für die JMS-Verbindung an. Sie können Ressourceneinstellungen für JNDI-Name der Destination, JNDI-Name der Aktivierungsspezifikation und JNDI-Name der Verbindungs-Factory lesen und bearbeiten. Alle anderen Ressourceneinstellungen sind schreibgeschützt.

Destination-Typ
Gibt den Typ der Anforderungs-Destination an. Die zulässigen Werte sind Warteschlange (der Standardwert) und Topic. Wenn Sie Topic angeben, müssen alle Operationen in der Schnittstelle, die der Bindung entspricht, unidirektional sein.

Diese Einstellung ist für Services und Referenzen bestimmt und schreibgeschützt.

@type ist der Destination-Typ.

JNDI-Namen der Destination
Ein optionaler Parameter, der den JNDI-Namen einer Destination angibt, der die Bindung zugeordnet ist, z. B. jms/InvokeService_Callback.

Sie können einen Destination-Namen für Services und Referenzen festlegen.

@name ist der JNDI-Name der Destination.

Destination erstellen
Gibt an, ob eine Destination für die Bindung erstellt werden soll.

Die gültigen Werte sind ifnotexist (Standardeinstellung), always und never. Wenn Sie den Wert ifnotexist festlegen, erstellt das Produkt dynamisch die Destination-Ressourcen, die für den SCA-Verbund erforderlich sind, falls diese Ressourcen noch nicht vorhanden sind, und ordnet sie dem Standard-Messaging-Provider zu. Das Produkt erstellt die Ressourcen, wenn der SCA-Verbund einer Geschäftsanwendung hinzugefügt wird.

Das Produkt validiert eine Verbunddefinition, wenn ein SCA-Asset einer Geschäftsanwendung hinzugefügt wird. Tritt bei der Validierung ein Fehler auf, fügt das Produkt das Asset der Anwendung nicht hinzu. Wenn Sie den Wert always festlegen und die Destination vorhanden ist, wird die Implementierung mit einem Fehler gestoppt.

JNDI-Name der Aktivierungsspezifikation
Gibt die Aktivierungsspezifikation an, die die Bindung verwendet, um für die Verarbeitung von Anforderungsnachrichten eine Verbindung zu einer JMS-Destination herzustellen. Der Wert muss ein JNDI-Name sein.

Sie können eine Aktivierungsspezifikation nur für Services festlegen.

Die Attribute dieses Elements folgen denen, die für das Destination-Element definiert sind.

Aktivierungsspezifikation erstellen
Gibt an, ob eine Aktivierungsspezifikation für die Bindung erstellt werden soll. Aktivierungsspezifikationen können nur für Services erstellt werden.

Die gültigen Werte sind ifnotexist (Standardeinstellung), always und never. Wenn Sie den Wert ifnotexist festlegen, erstellt das Produkt dynamisch die Aktivierungsspezifikationsressourcen, die für den SCA-Verbund erforderlich sind, falls diese Ressourcen noch nicht vorhanden sind, und ordnet sie dem Standard-Messaging-Provider zu. Wenn Sie den Wert always festlegen und die Aktivierungsspezifikation vorhanden ist, wenn der SCA-Verbund einer Geschäftsanwendung hinzugefügt wird, wird die Implementierung mit einem Fehler gestoppt.

JNDI-Name der Verbindungs-Factory
Gibt die Verbindungs-Factory an, die die Bindung für die Verarbeitung von Anforderungsnachrichten verwendet. Der Wert muss ein JNDI-Name sein.

Sie können den JNDI-Namen einer Verbindungs-Factory nur für Referenzen festlegen.

Die Attribute dieser Eigenschaft folgen denen, die für das Destination-Element definiert sind. Diese Eigenschaft und die Eigenschaft "activationSpec" schließen sich gegenseitig aus.

Verbindungs-Factory erstellen
Gibt an, ob eine Verbindungs-Factory für die Bindung erstellt werden soll. Verbindungs-Factorys können nur für Referenzen erstellt werden.

Die gültigen Werte sind ifnotexist (Standardeinstellung), always und never. Wenn Sie den Wert ifnotexist festlegen, erstellt das Produkt dynamisch die Verbindungs-Factory-Ressourcen, die für den SCA-Verbund erforderlich sind, falls diese Ressourcen noch nicht vorhanden sind, und ordnet sie dem Standard-Messaging-Provider zu. Wenn Sie den Wert always festlegen und die Verbindungs-Factory vorhanden ist, wenn der SCA-Verbund einer Geschäftsanwendung hinzugefügt wird, wird die Implementierung mit einem Fehler gestoppt.

Antwortressourcen

Gibt die Ressourcen an, die für die Behandlung von Antwortnachrichten, den Empfang von Antworten für eine Referenz und für das Senden von Antworten von einem Service verwendet werden. Ein Antwortelement definiert die Destination und die Verbindungs-Factory- bzw. Aktivierungsspezifikationselemente für die Behandlung von Antwortnachrichten.

Antwortressourcen betreffen Services und Referenzen. Sie können Ressourceneinstellungen für JNDI-Name der Antwort-Destination und JNDI-Name der Antwortverbindungs-Factory lesen und bearbeiten. Alle anderen Ressourceneinstellungen sind schreibgeschützt.

Typ der Antwort-Destination
Gibt den Typ der Antwort-Destination an. Die zulässigen Werte sind Warteschlange (der Standardwert) und Topic. Wenn Sie Topic angeben, müssen alle Operationen in der Schnittstelle, die der Bindung entspricht, unidirektional sein.

Diese Einstellung ist für Services und Referenzen bestimmt und schreibgeschützt.

JNDI-Name der Antwort-Destination
Gibt die Destination an, die für die Verarbeitung von Antworten dieser Bindung verwendet wird. Die Attribute sind dieselben wie beim übergeordneten Destination-Element, z. B. jms/InvokeService_Response.

Sie können einen Destination-Namen für Services und Referenzen festlegen.

Antwort-Destination erstellen
Gibt an, ob eine Antwort-Destination für die Bindung erstellt werden soll.

Die gültigen Werte sind ifnotexist (Standardeinstellung), always und never. Wenn Sie den Wert ifnotexist festlegen, erstellt das Produkt dynamisch die Antwort-Destination-Ressourcen, die für den SCA-Verbund erforderlich sind, falls diese Ressourcen noch nicht vorhanden sind, und ordnet sie dem Standard-Messaging-Provider zu. Wenn Sie den Wert always festlegen und die Antwort-Destination vorhanden ist, wenn der SCA-Verbund einer Geschäftsanwendung hinzugefügt wird, wird die Implementierung mit einem Fehler gestoppt.

JNDI-Name der Antwortverbindungs-Factory
Gibt die Verbindungs-Factory an, die die Bindung für die Verarbeitung von Antwortnachrichten verwendet. Der Wert muss ein JNDI-Name sein.

Sie können eine Antwortverbindungs-Factory für Services und Referenzen festlegen.

Die Attribute dieses Elements folgen denen, die für das Destination-Element definiert sind. Dieses Element und das Element "activationSpec" schließen sich gegenseitig aus.

Antwort-Verbindungs-Factory erstellen
Gibt an, ob eine Antwort-Verbindungs-Factory erstellt werden soll, die die Bindung für die Verarbeitung von Antwortnachrichten verwenden kann.

Die gültigen Werte sind ifnotexist (Standardeinstellung), always und never. Wenn Sie den Wert ifnotexist festlegen, erstellt das Produkt dynamisch die Antwort-Verbindungs-Factory-Ressourcen, die für den SCA-Verbund erforderlich sind, falls diese Ressourcen noch nicht vorhanden sind, und ordnet sie dem Standard-Messaging-Provider zu. Wenn Sie den Wert always festlegen und die Antwort-Verbindungs-Factory vorhanden ist, wenn der SCA-Verbund einer Geschäftsanwendung hinzugefügt wird, wird die Implementierung mit einem Fehler gestoppt.

Eigenschaften des Anforderungs-Headers

Gibt die JMS-Header-Eigenschaften an, die für Anforderungen einer Referenz gelten. Sie können die Header-Eigenschaften nicht bearbeiten.

Wenn eine JMS-Header-Eigenschaft angegeben ist, darf die Eigenschaft nicht im URI erscheinen.

JMS-Typ
Gibt einen in der JMS-Header-Eigenschaft zu verwendenden JMS-Typ mit @JMSType an.
JMS-Korrelations-ID
Gibt eine in der JMS-Header-Eigenschaft zu verwendende JMS-Korrelations-ID mit @JMSCorrelationID an.
JMS-Zustellmodus
Gibt einen in der JMS-Header-Eigenschaft zu verwendenden JMS-Zustellmodus mit @JMSDeliveryMode an.
JMS-Lebensdauer
Gibt eine in der JMS-Header-Eigenschaft zu verwendende JMS-Lebensdauer mit @JMSTimeToLive an.
JMS-Priorität
Gibt eine in der JMS-Header-Eigenschaft zu verwendende JMS-Priorität mit @JMSPriority an.
Header-Eigenschaft
Gibt einen für die angegebene JMS-Benutzereigenschaft zu verwendenden Wert an.
Eigenschaften des Antwort-Headers

Gibt die JMS-Header-Eigenschaften an, die für Antworten eines Service für abgehende Nachrichten gelten. Sie können die Header-Eigenschaften nicht bearbeiten.

Wenn eine JMS-Header-Eigenschaft angegeben ist, darf die Eigenschaft nicht im URI erscheinen.

JMS-Typ
Gibt einen in der JMS-Header-Eigenschaft zu verwendenden JMS-Typ mit @JMSType an.
JMS-Korrelations-ID
Gibt eine in der JMS-Header-Eigenschaft zu verwendende JMS-Korrelations-ID mit @JMSCorrelationID an.
JMS-Zustellmodus
Gibt einen in der JMS-Header-Eigenschaft zu verwendenden JMS-Zustellmodus mit @JMSDeliveryMode an.
JMS-Lebensdauer
Gibt eine in der JMS-Header-Eigenschaft zu verwendende JMS-Lebensdauer mit @JMSTimeToLive an.
JMS-Priorität
Gibt eine in der JMS-Header-Eigenschaft zu verwendende JMS-Priorität mit @JMSPriority an.
Header-Eigenschaft
Gibt einen für die angegebene JMS-Benutzereigenschaft zu verwendenden Wert an.



Mit (online) gekennzeichnete Links setzen einen Internet-Zugang voraus.

Zugehörige Tasks
Zugehörige Verweise


Dateiname: usca_jms_bindings.html