+

Search Tips   |   Advanced Search

JMS binding settings for SCA composites

Use this page to view property settings for a Java Message Service (JMS) binding that connects Service Component Architecture (SCA) composite references or services. Also use this page to edit resources of the JMS binding. The settings shown on this page define a binding.jms element. To view this console page, the composition unit must support a JMS binding reference or service. In the console, do the following:

  1. Click Applications > Application Types > Business-level applications > application_name > deployed_asset_composition_unit_name.

  2. From the composition unit settings page for SCA composites, select to view references or services:

    • For an SCA component reference, click SCA Composite Components > SCA_component_reference_name > SCA Component References > reference_name > Bindings > JMS binding.

    • For an SCA component service, click SCA Composite Components > SCA_component_service_name > SCA Component Services > service_name > Bindings > JMS binding.

Use a JMS binding to identify existing JMS resources using JNDI names.


General properties

Specifies property settings that apply to all binding.jms elements. The settings pertain to both services and references. We cannot edit the settings.

JMS binding URI

Uniform resource identifier (URI) that identifies properties such as the destination, connection factory and activation specification to be used to send or receive the JMS message.

The URI has the following format: 

jms: jms_destination?
connectionFactoryName=connection_factory_name &
destinationType={queue|topic} &
deliveryMode=delivery_mode &
timeToLive=time_to_live &
priority=priority &
user_property=user_property_value & ...

Correlation schema

Correlation scheme used when sending reply or callback messages.

Valid values are requestmsgidtocorrelid (the default), requestcorrelidtocorrelid, and none.

Initial context factory

Name of the initial context factory used to obtain a JNDI initial context.

This setting is optional. If no factory is specified, the WAS initial context factory is used.

JNDI URL

Uniform resource locator (URL) for the JNDI provider.

Request connection

Specifies a binding.jms element that is present in a composite definition file.

A request is a message sent to an SCA service or sent by an SCA reference.

Response connection

Specifies a binding.jms element that is present in a composite definition file.

A response is a message received by a reference (that is, a reply from an invoked service) or a message sent by a service in response to a previous request message. A response in SCA is always a reply to a previous request.

Request wire format

Component definition element name of a wire that connects SCA composites.

For example, wireFormat.jmsObject.

A request is a message sent to an SCA service or sent by an SCA reference.

Response wire format

Component definition element name of a wire that connects SCA composites.

For example, wireFormat.jmsObject.

A response is a message received by a reference (that is, a reply from an invoked service) or a message sent by a service in response to a previous request message. A response in SCA is always a reply to a previous request.


Resources

Specifies resources for the JMS binding. We can both read and edit resource settings for Destination JNDI name, Activation specification JNDI name, and Connection factory JNDI name. All other resource settings are read-only.

Destination type

Type of the request destination. Permitted values are queue (the default value) and topic. When topic is specified, then all the operations in the interface that correspond to the binding must be one-way.

This setting is for both services and references and is read-only.

@type is the destination type.

Destination JNDI name

Specifies an optional parameter that gives the JNDI name of a destination to which the binding is connected. For example, jms/InvokeService_Callback.

We can set a destination name for both services and references.

@name is the JNDI name of the destination.

Destination create

Whether to create a destination for the binding.

Valid values are ifnotexist (the default), always, and never. When the value is ifnotexist, the product dynamically creates destination resources necessary for the SCA composite, if those resources do not exist and relate to the default messaging provider. The product creates the resources when adding the SCA composite to a business-level application.

The product validates a composite definition when adding an SCA asset to a business-level application. If the validation results in an error, the product does not add the asset to the application. If the value is always and the destination exists, deployment stops with an error.

Activation specification JNDI name

Activation specification that the binding uses to connect to a JMS destination to process request messages. The value must be a JNDI name.

We can set an activation specification for services only.

The attributes of this element follow those defined for the destination element.

Activation specification create

Whether to create an activation specification for the binding. We can create an activation specification for services only.

Valid values are ifnotexist (the default), always, and never. When the value is ifnotexist, the product dynamically creates activation specification resources necessary for the SCA composite, if those resources do not exist and relate to the default messaging provider. If the value is always and the activation specification exists when the SCA composite is added to a business-level application, deployment stops with an error.

Connection factory JNDI name

Connection factory that the binding uses to process request messages. The value must be a JNDI name.

We can set a connection factory JNDI name for references only.

The attributes of this property follow those defined for the destination element. This property is mutually exclusive with the activationSpec property.

Connection factory create

Whether to create a connection factory for the binding. We can create a connection factory for references only.

Valid values are ifnotexist (the default), always, and never. When the value is ifnotexist, the product dynamically creates connection factory resources necessary for the SCA composite, if those resources do not exist and relate to the default messaging provider. If the value is always and the connection factory exists when the SCA composite is added to a business-level application, deployment stops with an error.


Response resources

Resources used for handling response messages, receiving responses for a reference, and for sending responses from a service. A response element defines the destination and either the connection factory or activation specification elements for handling response messages.

Response resources pertain to both services and references. We can both read and edit resource settings for Response destination JNDI name and Response connection factory JNDI name. All other resource settings are read-only.

Response destination type

Type of the response destination. Permitted values are queue (the default value) and topic. When topic is specified, then all the operations in the interface that corresponds to the binding must be one-way.

This setting is for both services and references and is read-only.

Response destination JNDI name

Destination that is to be used to process responses by this binding. Attributes are the same as for the parent destination element. For example, jms/InvokeService_Response.

We can set a destination name for both services and references.

Response destination create

Whether to create a response destination for the binding.

Valid values are ifnotexist (the default), always, and never. When the value is ifnotexist, the product dynamically creates response destination resources necessary for the SCA composite, if those resources do not exist and relate to the default messaging provider. If the value is always and the response destination exists when the SCA composite is added to a business-level application, deployment stops with an error.

Response connection factory JNDI name

Connection factory that the binding uses to process response messages. The value must be a JNDI name.

We can set a response connection factory for both services and references.

The attributes of this element follow those defined for the destination element. This element is mutually exclusive with the activationSpec element.

Response connection factory create

Whether to create a response connection factory that the binding can use to process response messages.

Valid values are ifnotexist (the default), always, and never. When the value is ifnotexist, the product dynamically creates response connection factory resources necessary for the SCA composite, if those resources do not exist and relate to the default messaging provider. If the value is always and the response connection factory exists when the SCA composite is added to a business-level application, deployment stops with an error.


Request header properties

Specifies JMS header properties that apply to requests from a reference. We cannot edit the header properties.

If a JMS header property is specified, the property must not appear in the URI.

JMS type

Specifies a JMS type to use in the JMS header property using @JMSType.

JMS correlation ID

Specifies a JMS correlation identification to use in the JMS header property using @JMSCorrelationID.

JMS delivery mode

Specifies a JMS delivery mode to use in the JMS header property using @JMSDeliveryMode.

JMS time to live

Specifies a JMS time to live to use in the JMS header property using @JMSTimeToLive.

JMS priority

Specifies a JMS priority to use in the JMS header property using @JMSPriority.

Header property

Specifies a value to use for the specified JMS user property.


Response header properties

Specifies JMS header properties that apply to responses from a service for outbound messages. We cannot edit the header properties.

If a JMS header property is specified, the property must not appear in the URI.

JMS type

Specifies a JMS type to use in the JMS header property using @JMSType.

JMS correlation ID

Specifies a JMS correlation identification to use in the JMS header property using @JMSCorrelationID.

JMS delivery mode

Specifies a JMS delivery mode to use in the JMS header property using @JMSDeliveryMode.

JMS time to live

Specifies a JMS time to live to use in the JMS header property using @JMSTimeToLive.

JMS priority

Specifies a JMS priority to use in the JMS header property using @JMSPriority.

Header property

Specifies a value to use for the specified JMS user property.


Related tasks

  • Configure the SCA JMS binding
  • View and editing JMS bindings on references and services of SCA composites
  • Create SCA business-level applications with the console

  • Composition unit settings