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:

Klicken Sie auf Anwendungen > Anwendungstypen > Geschäftsanwendungen > Anwendungsname > Name_der_Kompositionseinheit_des_implementierten_Assets.
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 (schreibgeschützt)
Ressourcen
Antwortressourcen
Anforderungsheadereigenschaften für eine Referenz (schreibgeschützt)
Eigenschaften des Antwortheaders für einen Service (schreibgeschützt)

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 das Ziel, die Verbindungsfactory und die Aktivierungsspezifikation identifizieren, die zum Senden oder Empfangen der JMS-Nachricht verwendet werden sollen.

Der URI hat das folgende Format:

jms: JMS-Ziel?
connectionFactoryName=Name_der_Verbindungsfactory &
destinationType={queue|topic} &
deliveryMode=Zustellungsmodus &
timeToLive=Lebensdauer &
priority=Priorität &
Benutzereigenschaft=Wert_der_Benutzereigenschaft & ...

Korrelationsschema

Gibt das Korrelationsschema an, das beim Senden von Antwort- oder Callback-Nachrichten verwendet werden soll.

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

Ausgangskontextfactory

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

Diese Einstellung ist optional. Wenn keine Factory angegeben ist, wird die Ausgangskontextfactory 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.

Ressourcen

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

Zieltyp

Gibt den Typ des Anforderungsziels 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 Zieltyp.

JNDI-Name des Ziels

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

Sie können einen Zielnamen für Services und Referenzen festlegen.

@name ist der JNDI-Name des Ziels.

Ziel erstellen

Gibt an, ob ein Ziel für die Bindung erstellt werden soll.

Die gültigen Werte sind ifnotexist (Standardwert), always und never. Wenn der Wert ifnotexist festgelegt wird, erstellt das Produkt dynamisch die erforderlichen Zielressourcen für den SCA-Verbund, wenn diese Ressourcen nicht vorhanden sind und zum Standard-Messaging-Provider gehören. 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 der Wert always festgelegt ist und das Ziel 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 einem JMS-Ziel 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 Zielelement definiert sind.

Activation specification create

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

Die gültigen Werte sind ifnotexist (Standardwert), always und never. Wenn der Wert ifnotexist festgelegt wird, erstellt das Produkt dynamisch die erforderlichen Aktivierungsspezifikationsressourcen für den SCA-Verbund, wenn diese Ressourcen nicht vorhanden sind und zum Standard-Messaging-Provider gehören. Wenn der Wert always festgelegt ist und die Aktivierungsspezifikation vorhanden ist, wenn der SCA-Verbund einer Geschäftsanwendung hinzufügt wird, wird die Implementierung mit einem Fehler gestoppt.

JNDI-Name der Verbindungsfactory

Gibt die Verbindungsfactory 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 Verbindungsfactory nur für Referenzen festlegen.

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

Connection factory create

Gibt an, ob eine Verbindungsfactory für die Bindung erstellt werden soll. Sie können eine Verbindungsfactory nur für Referenzen erstellen.

Die gültigen Werte sind ifnotexist (Standardwert), always und never. Wenn der Wert ifnotexist festgelegt wird, erstellt das Produkt dynamisch die erforderlichen Verbindungsfactoryressourcen für den SCA-Verbund, wenn diese Ressourcen nicht vorhanden sind und zum Standard-Messaging-Provider gehören. Wenn der Wert always festgelegt ist und die Verbindungsfactory vorhanden ist, wenn der SCA-Verbund einer Geschäftsanwendung hinzufü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 das Ziel und die Verbindungsfactory- bzw. Aktivierungsspezifikationselemente für die Behandlung von Antwortnachrichten.

Antwortressourcen betreffen Services und Referenzen. Sie können Ressourceneinstellungen für JNDI-Name des Antwortziels und JNDI-Name der Antwortverbindungsfactory lesen und bearbeiten. Alle anderen Ressourceneinstellungen sind schreibgeschützt.

Typ des Antwortziels

Gibt den Typ des Antwortziels 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 des Antwortziels

Gibt das Ziel an, das für die Verarbeitung von Antworten dieser Bindung verwendet wird. Die Attribute sind dieselben wie beim übergeordneten Zielelement, z. B. jms/InvokeService_Response.

Sie können einen Zielnamen für Services und Referenzen festlegen.

Antwortziel erstellen

Gibt an, ob ein Antwortziel für die Bindung erstellt werden soll.

Die gültigen Werte sind ifnotexist (Standardwert), always und never. Wenn der Wert ifnotexist festgelegt wird, erstellt das Produkt dynamisch die erforderlichen Antwortzielressourcen für den SCA-Verbund, wenn diese Ressourcen nicht vorhanden sind und zum Standard-Messaging-Provider gehören. Wenn der Wert always festgelegt ist und das Antwortziel vorhanden ist, wenn der SCA-Verbund einer Geschäftsanwendung hinzufügt wird, wird die Implementierung mit einem Fehler gestoppt.

JNDI-Name der Antwortverbindungsfactory

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

Sie können eine Antwortverbindungsfactory für Services und Referenzen festlegen.

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

Response connection factory create

Gibt an, ob eine Antwortverbindungsfactory erstellt werden soll, die die Bindung für die Verarbeitung von Antwortnachrichten verwenden kann.

Die gültigen Werte sind ifnotexist (Standardwert), always und never. Wenn der Wert ifnotexist festgelegt wird, erstellt das Produkt dynamisch die erforderlichen Antwortverbindungsfactoryressourcen für den SCA-Verbund, wenn diese Ressourcen nicht vorhanden sind und zum Standard-Messaging-Provider gehören. Wenn der Wert always festgelegt ist und die Antwortverbindungsfactory vorhanden ist, wenn der SCA-Verbund einer Geschäftsanwendung hinzufügt wird, wird die Implementierung mit einem Fehler gestoppt.

Eigenschaften des Anforderungsheaders

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

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

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

Eigenschaften des Antwortheaders

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

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

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

Dateiname: usca_jms_bindings.html